@api-client/core 0.5.20 → 0.5.21

package/build/src/authorization/lib/PopupAuthorization.js

@@ -0,0 +1,73 @@
+export const observePopupState = Symbol('observePopupState');
+export const popupInterval = Symbol('popupInterval');
+export const popupObserver = Symbol('popupObserver');
+export const intervalValue = Symbol('intervalValue');
+/**
+ * Adds support for the popup window authorization.
+ *
+ * The set timeout hack is used because I can't see other way of doing this
+ * as load/unload events are called only once (even with redirects)
+ * and there's no way of knowing what is happening in the popup (so no timeouts).
+ * The user may need more time to authorize themselves and then the application.
+ *
+ * This class dispatches the `close` event when the popup was closed.
+ *
+ * Call the `cleanUp()` function when the authorization data is received.
+ */
+export class PopupAuthorization extends EventTarget {
+    [intervalValue];
+    popup;
+    [popupInterval];
+    /**
+     * @param interval The popup state check interval
+     */
+    constructor(interval = 50) {
+        super();
+        this[intervalValue] = interval;
+        this[popupObserver] = this[popupObserver].bind(this);
+    }
+    /**
+     * Removes any existing frame and removes any remaining listeners.
+     */
+    cleanUp() {
+        if (this[popupInterval]) {
+            clearInterval(this[popupInterval]);
+            this[popupInterval] = undefined;
+        }
+        const { popup } = this;
+        if (popup && !popup.closed) {
+            popup.close();
+        }
+        this.popup = undefined;
+    }
+    /**
+     * Opens a popup to request authorization from the user.
+     * @param url The URL to open.
+     */
+    load(url) {
+        const op = 'menubar=no,location=no,resizable=yes,scrollbars=yes,status=no,width=800,height=600';
+        const popup = window.open(url, 'oauth-window', op);
+        if (!popup) {
+            throw new Error('Authorization popup is being blocked.');
+        }
+        popup.window.focus();
+        this.popup = popup;
+        this[observePopupState]();
+    }
+    /**
+     * Initializes an interval to check whether the popup window is still present.
+     * The web security model does not allow pages to read the URL for the cross domain
+     * connections.
+     */
+    [observePopupState]() {
+        this[popupInterval] = setInterval(this[popupObserver], this[intervalValue]);
+    }
+    [popupObserver]() {
+        const { popup } = this;
+        if (!popup || popup.closed) {
+            this.cleanUp();
+            this.dispatchEvent(new Event('close'));
+        }
+    }
+}
+//# sourceMappingURL=PopupAuthorization.js.map

package/build/src/authorization/lib/PopupAuthorization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PopupAuthorization.js","sourceRoot":"","sources":["../../../../src/authorization/lib/PopupAuthorization.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjD,CAAC,aAAa,CAAC,CAAS;IAExB,KAAK,CAAU;IAEf,CAAC,aAAa,CAAC,CAAM;IAErB;;OAEG;IACH,YAAY,QAAQ,GAAG,EAAE;QACvB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,aAAa,CAAC,EAAE;YACvB,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;SACjC;QACD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAC1B,KAAK,CAAC,KAAK,EAAE,CAAC;SACf;QACD,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,GAAW;QACd,MAAM,EAAE,GAAG,oFAAoF,CAAC;QAChG,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,EAAE;YACV,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;SAC1D;QACD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,CAAC,iBAAiB,CAAC;QACjB,IAAI,CAAC,aAAa,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,CAAC,aAAa,CAAC;QACb,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE;YAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;SACxC;IACH,CAAC;CACF"}

package/build/src/authorization/lib/Tokens.d.ts

@@ -0,0 +1,55 @@
+import { IOidcTokenInfo, ITokenInfo } from "../../models/Authorization.js";
+export declare class Tokens {
+    /**
+     * Creates a OidcTokenInfo object for the corresponding response type.
+     *
+     * @param responseType The response type of the token to prepare the info for.
+     * @param params params received from the authorization endpoint.
+     * @param time Timestamp when the tokens were created
+     * @param requestedScopes The list of requested scopes. Optional.
+     * @returns
+     */
+    static createTokenInfo(responseType: string, params: URLSearchParams, time: number, requestedScopes?: string[]): IOidcTokenInfo | null;
+    /**
+     * Creates a "code" response type token info.
+     * @param params
+     * @param time Timestamp when the tokens were created
+     * @param requestedScopes The list of requested scopes. Optional.
+     * @returns
+     */
+    static createBaseToken(params: URLSearchParams, time: number, requestedScopes?: string[]): IOidcTokenInfo;
+    /**
+     * Creates a "code" response type token info.
+     * @param params
+     * @param time Timestamp when the tokens were created
+     * @param requestedScopes The list of requested scopes. Optional.
+     * @returns
+     */
+    static createCodeToken(params: URLSearchParams, time: number, requestedScopes?: string[]): IOidcTokenInfo;
+    /**
+     * Creates a "token" response type token info.
+     * @param params
+     * @param time Timestamp when the tokens were created
+     * @param requestedScopes The list of requested scopes. Optional.
+     * @returns
+     */
+    static createTokenToken(params: URLSearchParams, time: number, requestedScopes?: string[]): IOidcTokenInfo;
+    /**
+     * Creates a "id_token" response type token info.
+     * @param time Timestamp when the tokens were created
+     * @param requestedScopes The list of requested scopes. Optional.
+     */
+    static createIdTokenToken(params: URLSearchParams, time: number, requestedScopes?: string[]): IOidcTokenInfo;
+    /**
+     * Computes the final list of granted scopes.
+     * It is a list of scopes received in the response or the list of requested scopes.
+     * Because the user may change the list of scopes during the authorization process
+     * the received list of scopes can be different than the one requested by the user.
+     *
+     * @param requestedScopes The list of requested scopes. Optional.
+     * @param tokenScopes The `scope` parameter received with the response. It's null safe.
+     * @returns The list of scopes for the token.
+     */
+    static computeTokenInfoScopes(requestedScopes?: string[], tokenScopes?: string): string[];
+    static fromTokenInfo(info: ITokenInfo): IOidcTokenInfo;
+}

package/build/src/authorization/lib/Tokens.js

@@ -0,0 +1,117 @@
+export class Tokens {
+    /**
+     * Creates a OidcTokenInfo object for the corresponding response type.
+     *
+     * @param responseType The response type of the token to prepare the info for.
+     * @param params params received from the authorization endpoint.
+     * @param time Timestamp when the tokens were created
+     * @param requestedScopes The list of requested scopes. Optional.
+     * @returns
+     */
+    static createTokenInfo(responseType, params, time, requestedScopes) {
+        switch (responseType) {
+            case 'code': return Tokens.createCodeToken(params, time, requestedScopes);
+            case 'token': return Tokens.createTokenToken(params, time, requestedScopes);
+            case 'id_token': return Tokens.createIdTokenToken(params, time, requestedScopes);
+            default: return null;
+        }
+    }
+    /**
+     * Creates a "code" response type token info.
+     * @param params
+     * @param time Timestamp when the tokens were created
+     * @param requestedScopes The list of requested scopes. Optional.
+     * @returns
+     */
+    static createBaseToken(params, time, requestedScopes) {
+        const scope = Tokens.computeTokenInfoScopes(requestedScopes, params.get('scope'));
+        const tokenInfo = {
+            state: params.get('state'),
+            expiresIn: Number(params.get('expires_in')),
+            tokenType: params.get('token_type'),
+            scope,
+            time,
+            responseType: '',
+        };
+        return tokenInfo;
+    }
+    /**
+     * Creates a "code" response type token info.
+     * @param params
+     * @param time Timestamp when the tokens were created
+     * @param requestedScopes The list of requested scopes. Optional.
+     * @returns
+     */
+    static createCodeToken(params, time, requestedScopes) {
+        const token = Tokens.createBaseToken(params, time, requestedScopes);
+        token.responseType = 'code';
+        token.code = params.get('code');
+        return token;
+    }
+    /**
+     * Creates a "token" response type token info.
+     * @param params
+     * @param time Timestamp when the tokens were created
+     * @param requestedScopes The list of requested scopes. Optional.
+     * @returns
+     */
+    static createTokenToken(params, time, requestedScopes) {
+        const token = Tokens.createBaseToken(params, time, requestedScopes);
+        token.responseType = 'token';
+        token.accessToken = params.get('access_token');
+        token.refreshToken = params.get('refresh_token');
+        return token;
+    }
+    /**
+     * Creates a "id_token" response type token info.
+     * @param time Timestamp when the tokens were created
+     * @param requestedScopes The list of requested scopes. Optional.
+     */
+    static createIdTokenToken(params, time, requestedScopes) {
+        const token = Tokens.createBaseToken(params, time, requestedScopes);
+        token.responseType = 'id_token';
+        token.accessToken = params.get('access_token');
+        token.refreshToken = params.get('refresh_token');
+        token.idToken = params.get('id_token');
+        return token;
+    }
+    /**
+     * Computes the final list of granted scopes.
+     * It is a list of scopes received in the response or the list of requested scopes.
+     * Because the user may change the list of scopes during the authorization process
+     * the received list of scopes can be different than the one requested by the user.
+     *
+     * @param requestedScopes The list of requested scopes. Optional.
+     * @param tokenScopes The `scope` parameter received with the response. It's null safe.
+     * @returns The list of scopes for the token.
+     */
+    static computeTokenInfoScopes(requestedScopes, tokenScopes) {
+        if (!tokenScopes && requestedScopes) {
+            return requestedScopes;
+        }
+        let listScopes = [];
+        if (typeof tokenScopes === 'string') {
+            listScopes = tokenScopes.split(' ');
+        }
+        return listScopes;
+    }
+    static fromTokenInfo(info) {
+        const result = {
+            responseType: '',
+            state: info.state,
+            accessToken: info.accessToken,
+            time: Date.now(),
+        };
+        if (info.scope) {
+            result.scope = info.scope;
+        }
+        if (info.tokenType) {
+            result.tokenType = info.tokenType;
+        }
+        if (info.expiresIn) {
+            result.expiresIn = info.expiresIn;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=Tokens.js.map

package/build/src/authorization/lib/Tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tokens.js","sourceRoot":"","sources":["../../../../src/authorization/lib/Tokens.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,MAAM;IACjB;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CAAC,YAAoB,EAAE,MAAuB,EAAE,IAAY,EAAE,eAA0B;QAC5G,QAAQ,YAAY,EAAE;YACpB,KAAK,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;YAC1E,KAAK,OAAO,CAAC,CAAC,OAAO,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;YAC5E,KAAK,UAAU,CAAC,CAAC,OAAO,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;YACjF,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;SACtB;IACH,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,MAAuB,EAAE,IAAY,EAAE,eAA0B;QACtF,MAAM,KAAK,GAAG,MAAM,CAAC,sBAAsB,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,CAAC;QACnF,MAAM,SAAS,GAAmB;YAChC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAE;YAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC3C,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAE;YACpC,KAAK;YACL,IAAI;YACJ,YAAY,EAAE,EAAE;SACjB,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,MAAuB,EAAE,IAAY,EAAE,eAA0B;QACtF,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QACpE,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC;QAC5B,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAuB,EAAE,IAAY,EAAE,eAA0B;QACvF,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QACpE,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC;QAC7B,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAE,CAAC;QAChD,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,MAAuB,EAAE,IAAY,EAAE,eAA0B;QACzF,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QACpE,KAAK,CAAC,YAAY,GAAG,UAAU,CAAC;QAChC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAE,CAAC;QAChD,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAE,CAAC;QAClD,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,sBAAsB,CAAC,eAA0B,EAAE,WAAoB;QAC5E,IAAI,CAAC,WAAW,IAAI,eAAe,EAAE;YACnC,OAAO,eAAe,CAAC;SACxB;QACD,IAAI,UAAU,GAAa,EAAE,CAAC;QAC9B,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;YACnC,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACrC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,IAAgB;QACnC,MAAM,MAAM,GAAmB;YAC7B,YAAY,EAAE,EAAE;YAChB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;SACjB,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,EAAE;YACd,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;SAC3B;QACD,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;SACnC;QACD,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;SACnC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/build/src/authorization/types.d.ts

@@ -0,0 +1,174 @@
+export interface OauthProcessingOptions {
+    /**
+     * The number of milliseconds of an interval to check the popup state.
+     * Default to 250 ms.
+     */
+    popupPullTimeout?: number;
+    /**
+     * The event target on which to listen to the redirect page `message` event.
+     * This event should contain a list of authorization parameters returned by the authorization server.
+     *
+     * The library contains `oauth-popup.html` page that reads the data from the URL and posts it back to the opener.
+     * However, you can create `tokenInfoTranslation` to map returned by the popup parameters to the onces used by the library.
+     */
+    messageTarget?: EventTarget;
+    /**
+     * A number of milliseconds after which the iframe triggers a timeout if the response is not present.
+     * Defaults to `1020`.
+     */
+    iframeTimeout?: number;
+    /**
+     * When set it uses this value to prefix the call to the
+     * OAuth 2 token endpoint. This is to support use cases when
+     * the requests should be proxied through a server to avoid CORS problems.
+     */
+    tokenProxy?: string;
+    /**
+     * When set it encodes the token URI value before adding it to the
+     * `tokenProxy`. This is to be used when the proxy takes the target
+     * URL as a query parameter.
+     */
+    tokenProxyEncode?: boolean;
+}
+export interface IOpenIdProviderMetadata {
+    /**
+     * URL using the https scheme with no query or fragment component that the OP asserts as its Issuer Identifier. If Issuer discovery is supported (see Section 2), this value MUST be identical to the issuer value returned by WebFinger. This also MUST be identical to the iss Claim value in ID Tokens issued from this Issuer.
+     */
+    issuer: string;
+    /**
+     * URL of the OP's OAuth 2.0 Authorization Endpoint [OpenID.Core].
+     */
+    authorization_endpoint: string;
+    /**
+     * URL of the OP's OAuth 2.0 Token Endpoint [OpenID.Core]. This is REQUIRED unless only the Implicit Flow is used.
+     */
+    token_endpoint?: string;
+    /**
+     * URL of the OP's UserInfo Endpoint [OpenID.Core]. This URL MUST use the https scheme and MAY contain port, path, and query parameter components.
+     */
+    userinfo_endpoint?: string;
+    /**
+     * URL of the OP's JSON Web Key Set [JWK] document. This contains the signing key(s) the RP uses to validate signatures from the OP. The JWK Set MAY also contain the Server's encryption key(s), which are used by RPs to encrypt requests to the Server. When both signing and encryption keys are made available, a use (Key Use) parameter value is REQUIRED for all keys in the referenced JWK Set to indicate each key's intended usage. Although some algorithms allow the same key to be used for both signatures and encryption, doing so is NOT RECOMMENDED, as it is less secure. The JWK x5c parameter MAY be used to provide X.509 representations of keys provided. When used, the bare key values MUST still be present and MUST match those in the certificate.
+     */
+    jwks_uri: string;
+    /**
+     * URL of the OP's Dynamic Client Registration Endpoint.
+     */
+    registration_endpoint?: string;
+    /**
+     * JSON array containing a list of the OAuth 2.0 [RFC6749] scope values that this server supports. The server MUST support the openid scope value. Servers MAY choose not to advertise some supported scope values even when this parameter is used, although those defined in [OpenID.Core] SHOULD be listed, if supported.
+     */
+    scopes_supported?: string[];
+    /**
+     * JSON array containing a list of the OAuth 2.0 response_type values that this OP supports. Dynamic OpenID Providers MUST support the code, id_token, and the token id_token Response Type values.
+     */
+    response_types_supported: string[];
+    /**
+     * JSON array containing a list of the OAuth 2.0 response_mode values that this OP supports, as specified in OAuth 2.0 Multiple Response Type Encoding Practices [OAuth.Responses]. If omitted, the default for Dynamic OpenID Providers is ["query", "fragment"].
+     */
+    response_modes_supported?: string[];
+    /**
+     * JSON array containing a list of the OAuth 2.0 Grant Type values that this OP supports. Dynamic OpenID Providers MUST support the authorization_code and implicit Grant Type values and MAY support other Grant Types. If omitted, the default value is ["authorization_code", "implicit"].
+     */
+    grant_types_supported?: string[];
+    /**
+     * JSON array containing a list of the Authentication Context Class References that this OP supports.
+     */
+    acr_values_supported?: string[];
+    /**
+     * JSON array containing a list of the Subject Identifier types that this OP supports. Valid types include pairwise and public.
+     */
+    subject_types_supported: string[];
+    /**
+     * JSON array containing a list of the JWS signing algorithms (alg values) supported by the OP for the ID Token to encode the Claims in a JWT [JWT]. The algorithm RS256 MUST be included. The value none MAY be supported, but MUST NOT be used unless the Response Type used returns no ID Token from the Authorization Endpoint (such as when using the Authorization Code Flow).
+     */
+    id_token_signing_alg_values_supported: string[];
+    /**
+     * JSON array containing a list of the JWE encryption algorithms (alg values) supported by the OP for the ID Token to encode the Claims in a JWT [JWT].
+     */
+    id_token_encryption_alg_values_supported?: string[];
+    /**
+     * JSON array containing a list of the JWE encryption algorithms (enc values) supported by the OP for the ID Token to encode the Claims in a JWT [JWT].
+     */
+    id_token_encryption_enc_values_supported?: string[];
+    /**
+     * JSON array containing a list of the JWS [JWS] signing algorithms (alg values) [JWA] supported by the UserInfo Endpoint to encode the Claims in a JWT [JWT]. The value none MAY be included.
+     */
+    userinfo_signing_alg_values_supported?: string[];
+    /**
+     * JSON array containing a list of the JWE [JWE] encryption algorithms (alg values) [JWA] supported by the UserInfo Endpoint to encode the Claims in a JWT [JWT].
+     */
+    userinfo_encryption_alg_values_supported?: string[];
+    /**
+     * JSON array containing a list of the JWE encryption algorithms (enc values) [JWA] supported by the UserInfo Endpoint to encode the Claims in a JWT [JWT].
+     */
+    userinfo_encryption_enc_values_supported?: string[];
+    /**
+     * JSON array containing a list of the JWS signing algorithms (alg values) supported by the OP for Request Objects, which are described in Section 6.1 of OpenID Connect Core 1.0 [OpenID.Core]. These algorithms are used both when the Request Object is passed by value (using the request parameter) and when it is passed by reference (using the request_uri parameter). Servers SHOULD support none and RS256.
+     */
+    request_object_signing_alg_values_supported?: string[];
+    /**
+     * JSON array containing a list of the JWE encryption algorithms (alg values) supported by the OP for Request Objects. These algorithms are used both when the Request Object is passed by value and when it is passed by reference.
+     */
+    request_object_encryption_alg_values_supported?: string[];
+    /**
+     * JSON array containing a list of the JWE encryption algorithms (enc values) supported by the OP for Request Objects. These algorithms are used both when the Request Object is passed by value and when it is passed by reference.
+     */
+    request_object_encryption_enc_values_supported?: string[];
+    /**
+     * JSON array containing a list of Client Authentication methods supported by this Token Endpoint. The options are client_secret_post, client_secret_basic, client_secret_jwt, and private_key_jwt, as described in Section 9 of OpenID Connect Core 1.0 [OpenID.Core]. Other authentication methods MAY be defined by extensions. If omitted, the default is client_secret_basic -- the HTTP Basic Authentication Scheme specified in Section 2.3.1 of OAuth 2.0 [RFC6749].
+     */
+    token_endpoint_auth_methods_supported?: string[];
+    /**
+     * JSON array containing a list of the JWS signing algorithms (alg values) supported by the Token Endpoint for the signature on the JWT [JWT] used to authenticate the Client at the Token Endpoint for the private_key_jwt and client_secret_jwt authentication methods. Servers SHOULD support RS256. The value none MUST NOT be used.
+     */
+    token_endpoint_auth_signing_alg_values_supported?: string[];
+    /**
+     * JSON array containing a list of the display parameter values that the OpenID Provider supports. These values are described in Section 3.1.2.1 of OpenID Connect Core 1.0 [OpenID.Core].
+     */
+    display_values_supported?: string[];
+    /**
+     * JSON array containing a list of the Claim Types that the OpenID Provider supports. These Claim Types are described in Section 5.6 of OpenID Connect Core 1.0 [OpenID.Core]. Values defined by this specification are normal, aggregated, and distributed. If omitted, the implementation supports only normal Claims.
+     */
+    claim_types_supported?: string[];
+    /**
+     * JSON array containing a list of the Claim Names of the Claims that the OpenID Provider MAY be able to supply values for. Note that for privacy or other reasons, this might not be an exhaustive list.
+     */
+    claims_supported?: string[];
+    /**
+     * URL of a page containing human-readable information that developers might want or need to know when using the OpenID Provider. In particular, if the OpenID Provider does not support Dynamic Client Registration, then information on how to register Clients needs to be provided in this documentation.
+     */
+    service_documentation?: string;
+    /**
+     * Languages and scripts supported for values in Claims being returned, represented as a JSON array of BCP47 [RFC5646] language tag values. Not all languages and scripts are necessarily supported for all Claim values.
+     */
+    claims_locales_supported?: string[];
+    /**
+     * Languages and scripts supported for the user interface, represented as a JSON array of BCP47 [RFC5646] language tag values.
+     */
+    ui_locales_supported?: string[];
+    /**
+     * Boolean value specifying whether the OP supports use of the claims parameter, with true indicating support. If omitted, the default value is false.
+     */
+    claims_parameter_supported?: boolean;
+    /**
+     * Boolean value specifying whether the OP supports use of the request parameter, with true indicating support. If omitted, the default value is false.
+     */
+    request_parameter_supported?: boolean;
+    /**
+     * Boolean value specifying whether the OP supports use of the request_uri parameter, with true indicating support. If omitted, the default value is true.
+     */
+    request_uri_parameter_supported?: boolean;
+    /**
+     * Boolean value specifying whether the OP requires any request_uri values used to be pre-registered using the request_uris registration parameter. Pre-registration is REQUIRED when the value is true. If omitted, the default value is false.
+     */
+    require_request_uri_registration?: boolean;
+    /**
+     * URL that the OpenID Provider provides to the person registering the Client to read about the OP's requirements on how the Relying Party can use the data provided by the OP. The registration process SHOULD display this URL to the person registering the Client if it is given.
+     */
+    op_policy_uri?: string;
+    /**
+     * URL that the OpenID Provider provides to the person registering the Client to read about OpenID Provider's terms of service. The registration process SHOULD display this URL to the person registering the Client if it is given.
+     */
+    op_tos_uri?: string;
+}

package/build/src/authorization/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/src/authorization/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/authorization/types.ts"],"names":[],"mappings":""}

package/oauth-popup.html

@@ -0,0 +1,29 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+    <title>Oauth2 callback window</title>
+    <style>*[hidden] { display: none; } </style>
+  </head>
+  <body>
+    <h1>Sending the authorization data to the application</h1>
+    <p id="general-error" hidden>
+      The window wasn't opened as a popup and therefore it can't pass the authorization information.<br/>
+      This is an error.
+    </p>
+    <script>
+    const messageTarget = (window.opener || window.parent || window.top);
+    if (!messageTarget || messageTarget === window || !messageTarget.postMessage) {
+      const elm = document.getElementById('general-error');
+      elm.removeAttribute('hidden');
+    } else {
+      const search = window.location.search.substr(1);
+      if (search) {
+        messageTarget.postMessage(search, '*');
+      } else {
+        messageTarget.postMessage(window.location.hash.substr(1), '*');
+      }
+    }
+    </script>
+  </body>
+</html>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@api-client/core",
   "description": "The API Client's core client library. Works in NodeJS and in a ES enabled browser.",
-  "version": "0.5.20",
+  "version": "0.5.21",
   "license": "Apache-2.0",
   "main": "build/index.js",
   "module": "build/index.js",
@@ -50,9 +50,11 @@
     "eslint-plugin-unused-imports": "^2.0.0",
     "express": "^4.17.1",
     "express-ntlm": "^2.6.1",
+    "get-port": "^6.1.2",
     "husky": "^7.0.4",
     "lint-staged": "^12.3.4",
     "mocha": "^9.1.3",
+    "oauth2-mock-server": "^4.3.1",
     "shrink-ray-current": "^4.1.3",
     "sinon": "^13.0.1",
     "source-map-support": "^0.5.21",

package/src/authorization/AuthorizationError.ts

@@ -0,0 +1,25 @@
+/* eslint-disable max-classes-per-file */
+/**
+ * An object describing an error during the authorization process.
+ */
+export class AuthorizationError extends Error {
+  /**
+   * @param message The human readable message.
+   * @param code The error code
+   * @param state Used state parameter
+   * @param interactive Whether the request was interactive.
+   */
+  constructor(message: string, public code: string, public state: string, public interactive: boolean) {
+    super(message);
+  }
+}
+
+export class CodeError extends Error {
+  /**
+   * @param message The human readable message.
+   * @param code The error code
+   */
+  constructor(message: string, public code: string) {
+    super(message);
+  }
+}

package/src/authorization/CustomParameters.ts

@@ -0,0 +1,61 @@
+import { IOAuth2AuthorizationRequestCustomData, IOAuth2CustomData } from "../models/Authorization.js";
+
+/**
+ * Applies custom properties defined in the OAuth settings object to the URL.
+ *
+ * @param url The instance of the URL class to use
+ * @param data `customData.[type]` property from the settings object. The type is either `auth` or `token`.
+ */
+export function applyCustomSettingsQuery(url: URL, data: IOAuth2AuthorizationRequestCustomData): void {
+  if (!data || !data.parameters) {
+    return;
+  }
+  data.parameters.forEach((item) => {
+    const { name, value='' } = item;
+    if (!name) {
+      return;
+    }
+    url.searchParams.set(name, value);
+  });
+}
+
+/**
+ * Applies custom body properties from the settings to the body value.
+ *
+ * @param body Already computed body for OAuth request. Custom properties are appended at the end of OAuth string.
+ * @param data Value of settings' `customData` property
+ * @returns Request body
+ */
+export function applyCustomSettingsBody(body: string, data: IOAuth2CustomData): string {
+  if (!data || !data.token || !data.token.body) {
+    return body;
+  }
+  const params = data.token.body.map((item) => {
+    let { value } = item;
+    if (value) {
+      value = encodeURIComponent(value);
+    } else {
+      value = '';
+    }
+    return `${encodeURIComponent(item.name)}=${value}`;
+  }).join('&');
+  return `${body}&${params}`;
+}
+
+/**
+ * Applies custom headers from the settings object
+ *
+ * @param headers A regular JS map with headers definition
+ * @param data Value of settings' `customData` property
+ * @returns The copy of the headers object, if it was altered. Otherwise the same object.
+ */
+export function applyCustomSettingsHeaders(headers: Record<string, string>, data: IOAuth2CustomData): Record<string, string> {
+  if (!data || !data.token || !data.token.headers) {
+    return headers;
+  }
+  const copy = { ...headers };
+  data.token.headers.forEach((item) => {
+    copy[item.name] = item.value;
+  });
+  return copy;
+}