@textrp/briij-js-sdk 41.0.0

package/lib/oidc/authorize.js

@@ -0,0 +1,282 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/*
+Copyright 2023 The Matrix.org Foundation C.I.C.
+
+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 { Log, OidcClient, SigninResponse, SigninState, WebStorageStateStore } from "oidc-client-ts";
+import { logger } from "../logger.js";
+import { secureRandomString } from "../randomstring.js";
+import { OidcError } from "./error.js";
+import { validateBearerTokenResponse, validateIdToken, validateStoredUserState } from "./validate.js";
+import { sha256 } from "../digest.js";
+import { encodeUnpaddedBase64Url } from "../base64.js";
+
+// reexport for backwards compatibility
+
+/**
+ * Authorization parameters which are used in the authentication request of an OIDC auth code flow.
+ *
+ * See https://openid.net/specs/openid-connect-basic-1_0.html#RequestParameters.
+ */
+
+/**
+ * @experimental
+ * Generate the scope used in authorization request with OIDC OP
+ * @returns scope
+ */
+export var generateScope = deviceId => {
+  var safeDeviceId = deviceId !== null && deviceId !== void 0 ? deviceId : secureRandomString(10);
+  return "openid urn:matrix:org.matrix.msc2967.client:api:* urn:matrix:org.matrix.msc2967.client:device:".concat(safeDeviceId);
+};
+
+// https://www.rfc-editor.org/rfc/rfc7636
+var generateCodeChallenge = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator(function* (codeVerifier) {
+    if (!globalThis.crypto.subtle) {
+      // @TODO(kerrya) should this be allowed? configurable?
+      logger.warn("A secure context is required to generate code challenge. Using plain text code challenge");
+      return codeVerifier;
+    }
+    var hashBuffer = yield sha256(codeVerifier);
+    return encodeUnpaddedBase64Url(hashBuffer);
+  });
+  return function generateCodeChallenge(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();
+
+/**
+ * Generate authorization params to pass to {@link generateAuthorizationUrl}.
+ *
+ * Used as part of an authorization code OIDC flow: see https://openid.net/specs/openid-connect-basic-1_0.html#CodeFlow.
+ *
+ * @param redirectUri - absolute url for OP to redirect to after authorization
+ * @returns AuthorizationParams
+ */
+export var generateAuthorizationParams = _ref2 => {
+  var {
+    redirectUri
+  } = _ref2;
+  return {
+    scope: generateScope(),
+    redirectUri,
+    state: secureRandomString(8),
+    nonce: secureRandomString(8),
+    codeVerifier: secureRandomString(64) // https://tools.ietf.org/html/rfc7636#section-4.1 length needs to be 43-128 characters
+  };
+};
+
+/**
+ * @deprecated use generateOidcAuthorizationUrl
+ * Generate a URL to attempt authorization with the OP
+ * See https://openid.net/specs/openid-connect-basic-1_0.html#CodeRequest
+ * @param authorizationUrl - endpoint to attempt authorization with the OP
+ * @param clientId - id of this client as registered with the OP
+ * @param authorizationParams - params to be used in the url
+ * @returns a Promise with the url as a string
+ */
+export var generateAuthorizationUrl = /*#__PURE__*/function () {
+  var _ref4 = _asyncToGenerator(function* (authorizationUrl, clientId, _ref3) {
+    var {
+      scope,
+      redirectUri,
+      state,
+      nonce,
+      codeVerifier
+    } = _ref3;
+    var url = new URL(authorizationUrl);
+    url.searchParams.append("response_mode", "query");
+    url.searchParams.append("response_type", "code");
+    url.searchParams.append("redirect_uri", redirectUri);
+    url.searchParams.append("client_id", clientId);
+    url.searchParams.append("state", state);
+    url.searchParams.append("scope", scope);
+    url.searchParams.append("nonce", nonce);
+    url.searchParams.append("code_challenge_method", "S256");
+    url.searchParams.append("code_challenge", yield generateCodeChallenge(codeVerifier));
+    return url.toString();
+  });
+  return function generateAuthorizationUrl(_x2, _x3, _x4) {
+    return _ref4.apply(this, arguments);
+  };
+}();
+
+/**
+ * @experimental
+ * Generate a URL to attempt authorization with the OP
+ * See https://openid.net/specs/openid-connect-basic-1_0.html#CodeRequest
+ * @param metadata - validated metadata from OP discovery
+ * @param clientId - this client's id as registered with the OP
+ * @param homeserverUrl - used to establish the session on return from the OP
+ * @param identityServerUrl - used to establish the session on return from the OP
+ * @param nonce - state
+ * @param prompt - indicates to the OP which flow the user should see - eg login or registration
+ *          See https://openid.net/specs/openid-connect-prompt-create-1_0.html#name-prompt-parameter
+ * @param urlState - value to append to the opaque state identifier to uniquely identify the callback
+ * @param loginHint - value to send as the `login_hint` to the OP, giving a hint about the login identifier the user might use to log in.
+ *          See {@link https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest OIDC core 3.1.2.1}.
+ * @returns a Promise with the url as a string
+ */
+export var generateOidcAuthorizationUrl = /*#__PURE__*/function () {
+  var _ref6 = _asyncToGenerator(function* (_ref5) {
+    var {
+      metadata,
+      redirectUri,
+      clientId,
+      homeserverUrl,
+      identityServerUrl,
+      nonce,
+      prompt,
+      urlState,
+      loginHint
+    } = _ref5;
+    var scope = generateScope();
+    var oidcClient = new OidcClient(_objectSpread(_objectSpread({}, metadata), {}, {
+      client_id: clientId,
+      redirect_uri: redirectUri,
+      authority: metadata.issuer,
+      response_mode: "query",
+      response_type: "code",
+      scope,
+      stateStore: new WebStorageStateStore({
+        prefix: "mx_oidc_",
+        store: window.sessionStorage
+      })
+    }));
+    var userState = {
+      homeserverUrl,
+      nonce,
+      identityServerUrl
+    };
+    var request = yield oidcClient.createSigninRequest({
+      state: userState,
+      nonce,
+      prompt,
+      url_state: urlState,
+      login_hint: loginHint
+    });
+    return request.url;
+  });
+  return function generateOidcAuthorizationUrl(_x5) {
+    return _ref6.apply(this, arguments);
+  };
+}();
+
+/**
+ * Normalize token_type to use capital case to make consuming the token response easier
+ * token_type is case insensitive, and it is spec-compliant for OPs to return token_type: "bearer"
+ * Later, when used in auth headers it is case sensitive and must be Bearer
+ * See: https://datatracker.ietf.org/doc/html/rfc6749#section-4.1.4
+ *
+ * @param response - validated token response
+ * @returns response with token_type set to 'Bearer'
+ */
+var normalizeBearerTokenResponseTokenType = response => ({
+  id_token: response.id_token,
+  scope: response.scope,
+  expires_at: response.expires_at,
+  refresh_token: response.refresh_token,
+  access_token: response.access_token,
+  token_type: "Bearer"
+});
+
+/**
+ * @experimental
+ * Attempt to exchange authorization code for bearer token.
+ *
+ * Takes the authorization code returned by the OpenID Provider via the authorization URL, and makes a
+ * request to the Token Endpoint, to obtain the access token, refresh token, etc.
+ *
+ * @param code - authorization code as returned by OP during authorization
+ * @param storedAuthorizationParams - stored params from start of oidc login flow
+ * @returns valid bearer token response
+ * @throws An `Error` with `message` set to an entry in {@link OidcError},
+ *      when the request fails, or the returned token response is invalid.
+ */
+export var completeAuthorizationCodeGrant = /*#__PURE__*/function () {
+  var _ref7 = _asyncToGenerator(function* (code, state) {
+    /**
+     * Element Web strips and changes the url on starting the app
+     * Use the code and state from query params to rebuild a url
+     * so that oidc-client can parse it
+     */
+    var reconstructedUrl = new URL(window.location.origin);
+    reconstructedUrl.searchParams.append("code", code);
+    reconstructedUrl.searchParams.append("state", state);
+
+    // set oidc-client to use our logger
+    Log.setLogger(logger);
+    try {
+      var response = new SigninResponse(reconstructedUrl.searchParams);
+      var stateStore = new WebStorageStateStore({
+        prefix: "mx_oidc_",
+        store: window.sessionStorage
+      });
+
+      // retrieve the state we put in storage at the start of oidc auth flow
+      var stateString = yield stateStore.get(response.state);
+      if (!stateString) {
+        throw new Error(OidcError.MissingOrInvalidStoredState);
+      }
+
+      // hydrate the sign in state and create a client
+      // the stored sign in state includes oidc configuration we set at the start of the oidc login flow
+      var signInState = yield SigninState.fromStorageString(stateString);
+      var client = new OidcClient(_objectSpread(_objectSpread({}, signInState), {}, {
+        stateStore
+      }));
+
+      // validate the code and state, and attempt to swap the code for tokens
+      var signinResponse = yield client.processSigninResponse(reconstructedUrl.href);
+
+      // extra values we stored at the start of the login flow
+      // used to complete login in the client
+      var userState = signinResponse.userState;
+      validateStoredUserState(userState);
+
+      // throws when response is invalid
+      validateBearerTokenResponse(signinResponse);
+      // throws when token is invalid
+      validateIdToken(signinResponse.id_token, client.settings.authority, client.settings.client_id, userState.nonce);
+      var normalizedTokenResponse = normalizeBearerTokenResponseTokenType(signinResponse);
+      return {
+        oidcClientSettings: {
+          clientId: client.settings.client_id,
+          issuer: client.settings.authority
+        },
+        tokenResponse: normalizedTokenResponse,
+        homeserverUrl: userState.homeserverUrl,
+        identityServerUrl: userState.identityServerUrl,
+        idTokenClaims: signinResponse.profile
+      };
+    } catch (error) {
+      logger.error("Oidc login failed", error);
+      var errorType = error.message;
+
+      // rethrow errors that we recognise
+      if (Object.values(OidcError).includes(errorType)) {
+        throw error;
+      }
+      throw new Error(OidcError.CodeExchangeFailed);
+    }
+  });
+  return function completeAuthorizationCodeGrant(_x6, _x7) {
+    return _ref7.apply(this, arguments);
+  };
+}();
+//# sourceMappingURL=authorize.js.map

package/lib/oidc/authorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorize.js","names":["Log","OidcClient","SigninResponse","SigninState","WebStorageStateStore","logger","secureRandomString","OidcError","validateBearerTokenResponse","validateIdToken","validateStoredUserState","sha256","encodeUnpaddedBase64Url","generateScope","deviceId","safeDeviceId","concat","generateCodeChallenge","_ref","_asyncToGenerator","codeVerifier","globalThis","crypto","subtle","warn","hashBuffer","_x","apply","arguments","generateAuthorizationParams","_ref2","redirectUri","scope","state","nonce","generateAuthorizationUrl","_ref4","authorizationUrl","clientId","_ref3","url","URL","searchParams","append","toString","_x2","_x3","_x4","generateOidcAuthorizationUrl","_ref6","_ref5","metadata","homeserverUrl","identityServerUrl","prompt","urlState","loginHint","oidcClient","_objectSpread","client_id","redirect_uri","authority","issuer","response_mode","response_type","stateStore","prefix","store","window","sessionStorage","userState","request","createSigninRequest","url_state","login_hint","_x5","normalizeBearerTokenResponseTokenType","response","id_token","expires_at","refresh_token","access_token","token_type","completeAuthorizationCodeGrant","_ref7","code","reconstructedUrl","location","origin","setLogger","stateString","get","Error","MissingOrInvalidStoredState","signInState","fromStorageString","client","signinResponse","processSigninResponse","href","settings","normalizedTokenResponse","oidcClientSettings","tokenResponse","idTokenClaims","profile","error","errorType","message","Object","values","includes","CodeExchangeFailed","_x6","_x7"],"sources":["../../src/oidc/authorize.ts"],"sourcesContent":["/*\r\nCopyright 2023 The Matrix.org Foundation C.I.C.\r\n\r\nLicensed under the Apache License, Version 2.0 (the \"License\");\r\nyou may not use this file except in compliance with the License.\r\nYou may obtain a copy of the License at\r\n\r\n    http://www.apache.org/licenses/LICENSE-2.0\r\n\r\nUnless required by applicable law or agreed to in writing, software\r\ndistributed under the License is distributed on an \"AS IS\" BASIS,\r\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\nSee the License for the specific language governing permissions and\r\nlimitations under the License.\r\n*/\r\n\r\nimport { type IdTokenClaims, Log, OidcClient, SigninResponse, SigninState, WebStorageStateStore } from \"oidc-client-ts\";\r\n\r\nimport { logger } from \"../logger.ts\";\r\nimport { secureRandomString } from \"../randomstring.ts\";\r\nimport { OidcError } from \"./error.ts\";\r\nimport {\r\n    type BearerTokenResponse,\r\n    type UserState,\r\n    validateBearerTokenResponse,\r\n    type ValidatedAuthMetadata,\r\n    validateIdToken,\r\n    validateStoredUserState,\r\n} from \"./validate.ts\";\r\nimport { sha256 } from \"../digest.ts\";\r\nimport { encodeUnpaddedBase64Url } from \"../base64.ts\";\r\n\r\n// reexport for backwards compatibility\r\nexport type { BearerTokenResponse };\r\n\r\n/**\r\n * Authorization parameters which are used in the authentication request of an OIDC auth code flow.\r\n *\r\n * See https://openid.net/specs/openid-connect-basic-1_0.html#RequestParameters.\r\n */\r\nexport type AuthorizationParams = {\r\n    state: string;\r\n    scope: string;\r\n    redirectUri: string;\r\n    codeVerifier: string;\r\n    nonce: string;\r\n};\r\n\r\n/**\r\n * @experimental\r\n * Generate the scope used in authorization request with OIDC OP\r\n * @returns scope\r\n */\r\nexport const generateScope = (deviceId?: string): string => {\r\n    const safeDeviceId = deviceId ?? secureRandomString(10);\r\n    return `openid urn:matrix:org.matrix.msc2967.client:api:* urn:matrix:org.matrix.msc2967.client:device:${safeDeviceId}`;\r\n};\r\n\r\n// https://www.rfc-editor.org/rfc/rfc7636\r\nconst generateCodeChallenge = async (codeVerifier: string): Promise<string> => {\r\n    if (!globalThis.crypto.subtle) {\r\n        // @TODO(kerrya) should this be allowed? configurable?\r\n        logger.warn(\"A secure context is required to generate code challenge. Using plain text code challenge\");\r\n        return codeVerifier;\r\n    }\r\n\r\n    const hashBuffer = await sha256(codeVerifier);\r\n    return encodeUnpaddedBase64Url(hashBuffer);\r\n};\r\n\r\n/**\r\n * Generate authorization params to pass to {@link generateAuthorizationUrl}.\r\n *\r\n * Used as part of an authorization code OIDC flow: see https://openid.net/specs/openid-connect-basic-1_0.html#CodeFlow.\r\n *\r\n * @param redirectUri - absolute url for OP to redirect to after authorization\r\n * @returns AuthorizationParams\r\n */\r\nexport const generateAuthorizationParams = ({ redirectUri }: { redirectUri: string }): AuthorizationParams => ({\r\n    scope: generateScope(),\r\n    redirectUri,\r\n    state: secureRandomString(8),\r\n    nonce: secureRandomString(8),\r\n    codeVerifier: secureRandomString(64), // https://tools.ietf.org/html/rfc7636#section-4.1 length needs to be 43-128 characters\r\n});\r\n\r\n/**\r\n * @deprecated use generateOidcAuthorizationUrl\r\n * Generate a URL to attempt authorization with the OP\r\n * See https://openid.net/specs/openid-connect-basic-1_0.html#CodeRequest\r\n * @param authorizationUrl - endpoint to attempt authorization with the OP\r\n * @param clientId - id of this client as registered with the OP\r\n * @param authorizationParams - params to be used in the url\r\n * @returns a Promise with the url as a string\r\n */\r\nexport const generateAuthorizationUrl = async (\r\n    authorizationUrl: string,\r\n    clientId: string,\r\n    { scope, redirectUri, state, nonce, codeVerifier }: AuthorizationParams,\r\n): Promise<string> => {\r\n    const url = new URL(authorizationUrl);\r\n    url.searchParams.append(\"response_mode\", \"query\");\r\n    url.searchParams.append(\"response_type\", \"code\");\r\n    url.searchParams.append(\"redirect_uri\", redirectUri);\r\n    url.searchParams.append(\"client_id\", clientId);\r\n    url.searchParams.append(\"state\", state);\r\n    url.searchParams.append(\"scope\", scope);\r\n    url.searchParams.append(\"nonce\", nonce);\r\n\r\n    url.searchParams.append(\"code_challenge_method\", \"S256\");\r\n    url.searchParams.append(\"code_challenge\", await generateCodeChallenge(codeVerifier));\r\n\r\n    return url.toString();\r\n};\r\n\r\n/**\r\n * @experimental\r\n * Generate a URL to attempt authorization with the OP\r\n * See https://openid.net/specs/openid-connect-basic-1_0.html#CodeRequest\r\n * @param metadata - validated metadata from OP discovery\r\n * @param clientId - this client's id as registered with the OP\r\n * @param homeserverUrl - used to establish the session on return from the OP\r\n * @param identityServerUrl - used to establish the session on return from the OP\r\n * @param nonce - state\r\n * @param prompt - indicates to the OP which flow the user should see - eg login or registration\r\n *          See https://openid.net/specs/openid-connect-prompt-create-1_0.html#name-prompt-parameter\r\n * @param urlState - value to append to the opaque state identifier to uniquely identify the callback\r\n * @param loginHint - value to send as the `login_hint` to the OP, giving a hint about the login identifier the user might use to log in.\r\n *          See {@link https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest OIDC core 3.1.2.1}.\r\n * @returns a Promise with the url as a string\r\n */\r\nexport const generateOidcAuthorizationUrl = async ({\r\n    metadata,\r\n    redirectUri,\r\n    clientId,\r\n    homeserverUrl,\r\n    identityServerUrl,\r\n    nonce,\r\n    prompt,\r\n    urlState,\r\n    loginHint,\r\n}: {\r\n    clientId: string;\r\n    metadata: ValidatedAuthMetadata;\r\n    homeserverUrl: string;\r\n    identityServerUrl?: string;\r\n    redirectUri: string;\r\n    nonce: string;\r\n    prompt?: string;\r\n    urlState?: string;\r\n    loginHint?: string;\r\n}): Promise<string> => {\r\n    const scope = generateScope();\r\n    const oidcClient = new OidcClient({\r\n        ...metadata,\r\n        client_id: clientId,\r\n        redirect_uri: redirectUri,\r\n        authority: metadata.issuer,\r\n        response_mode: \"query\",\r\n        response_type: \"code\",\r\n        scope,\r\n        stateStore: new WebStorageStateStore({ prefix: \"mx_oidc_\", store: window.sessionStorage }),\r\n    });\r\n    const userState: UserState = { homeserverUrl, nonce, identityServerUrl };\r\n    const request = await oidcClient.createSigninRequest({\r\n        state: userState,\r\n        nonce,\r\n        prompt,\r\n        url_state: urlState,\r\n        login_hint: loginHint,\r\n    });\r\n\r\n    return request.url;\r\n};\r\n\r\n/**\r\n * Normalize token_type to use capital case to make consuming the token response easier\r\n * token_type is case insensitive, and it is spec-compliant for OPs to return token_type: \"bearer\"\r\n * Later, when used in auth headers it is case sensitive and must be Bearer\r\n * See: https://datatracker.ietf.org/doc/html/rfc6749#section-4.1.4\r\n *\r\n * @param response - validated token response\r\n * @returns response with token_type set to 'Bearer'\r\n */\r\nconst normalizeBearerTokenResponseTokenType = (response: SigninResponse): BearerTokenResponse =>\r\n    ({\r\n        id_token: response.id_token,\r\n        scope: response.scope,\r\n        expires_at: response.expires_at,\r\n        refresh_token: response.refresh_token,\r\n        access_token: response.access_token,\r\n        token_type: \"Bearer\",\r\n    }) as BearerTokenResponse;\r\n\r\n/**\r\n * @experimental\r\n * Attempt to exchange authorization code for bearer token.\r\n *\r\n * Takes the authorization code returned by the OpenID Provider via the authorization URL, and makes a\r\n * request to the Token Endpoint, to obtain the access token, refresh token, etc.\r\n *\r\n * @param code - authorization code as returned by OP during authorization\r\n * @param storedAuthorizationParams - stored params from start of oidc login flow\r\n * @returns valid bearer token response\r\n * @throws An `Error` with `message` set to an entry in {@link OidcError},\r\n *      when the request fails, or the returned token response is invalid.\r\n */\r\nexport const completeAuthorizationCodeGrant = async (\r\n    code: string,\r\n    state: string,\r\n): Promise<{\r\n    oidcClientSettings: { clientId: string; issuer: string };\r\n    tokenResponse: BearerTokenResponse;\r\n    homeserverUrl: string;\r\n    idTokenClaims: IdTokenClaims;\r\n    identityServerUrl?: string;\r\n}> => {\r\n    /**\r\n     * Element Web strips and changes the url on starting the app\r\n     * Use the code and state from query params to rebuild a url\r\n     * so that oidc-client can parse it\r\n     */\r\n    const reconstructedUrl = new URL(window.location.origin);\r\n    reconstructedUrl.searchParams.append(\"code\", code);\r\n    reconstructedUrl.searchParams.append(\"state\", state);\r\n\r\n    // set oidc-client to use our logger\r\n    Log.setLogger(logger);\r\n    try {\r\n        const response = new SigninResponse(reconstructedUrl.searchParams);\r\n\r\n        const stateStore = new WebStorageStateStore({ prefix: \"mx_oidc_\", store: window.sessionStorage });\r\n\r\n        // retrieve the state we put in storage at the start of oidc auth flow\r\n        const stateString = await stateStore.get(response.state!);\r\n        if (!stateString) {\r\n            throw new Error(OidcError.MissingOrInvalidStoredState);\r\n        }\r\n\r\n        // hydrate the sign in state and create a client\r\n        // the stored sign in state includes oidc configuration we set at the start of the oidc login flow\r\n        const signInState = await SigninState.fromStorageString(stateString);\r\n        const client = new OidcClient({ ...signInState, stateStore });\r\n\r\n        // validate the code and state, and attempt to swap the code for tokens\r\n        const signinResponse = await client.processSigninResponse(reconstructedUrl.href);\r\n\r\n        // extra values we stored at the start of the login flow\r\n        // used to complete login in the client\r\n        const userState = signinResponse.userState;\r\n        validateStoredUserState(userState);\r\n\r\n        // throws when response is invalid\r\n        validateBearerTokenResponse(signinResponse);\r\n        // throws when token is invalid\r\n        validateIdToken(signinResponse.id_token, client.settings.authority, client.settings.client_id, userState.nonce);\r\n        const normalizedTokenResponse = normalizeBearerTokenResponseTokenType(signinResponse);\r\n\r\n        return {\r\n            oidcClientSettings: {\r\n                clientId: client.settings.client_id,\r\n                issuer: client.settings.authority,\r\n            },\r\n            tokenResponse: normalizedTokenResponse,\r\n            homeserverUrl: userState.homeserverUrl,\r\n            identityServerUrl: userState.identityServerUrl,\r\n            idTokenClaims: signinResponse.profile,\r\n        };\r\n    } catch (error) {\r\n        logger.error(\"Oidc login failed\", error);\r\n        const errorType = (error as Error).message;\r\n\r\n        // rethrow errors that we recognise\r\n        if (Object.values(OidcError).includes(errorType as any)) {\r\n            throw error;\r\n        }\r\n        throw new Error(OidcError.CodeExchangeFailed);\r\n    }\r\n};\r\n"],"mappings":"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","ignoreList":[]}

package/lib/oidc/discovery.d.ts

@@ -0,0 +1,22 @@
+import { type OidcClientConfig } from "./index.ts";
+/**
+ * @experimental
+ * Discover and validate delegated auth configuration
+ * - delegated auth issuer openid-configuration is reachable
+ * - delegated auth issuer openid-configuration is configured correctly for us
+ * Fetches https://oidc-issuer.example.com/.well-known/openid-configuration and other files linked therein.
+ * When successful, validated metadata is returned
+ * @param issuer - the OIDC issuer as returned by the /auth_issuer API
+ * @returns validated authentication metadata and optionally signing keys
+ * @throws when delegated auth config is invalid or unreachable
+ * @deprecated in favour of {@link BriijClient#getAuthMetadata}
+ */
+export declare const discoverAndValidateOIDCIssuerWellKnown: (issuer: string) => Promise<OidcClientConfig>;
+/**
+ * @experimental
+ * Validate the authentication metadata and fetch the signing keys from the jwks_uri in the metadata
+ * @param authMetadata - the authentication metadata to validate
+ * @returns validated authentication metadata and signing keys
+ */
+export declare const validateAuthMetadataAndKeys: (authMetadata: unknown) => Promise<OidcClientConfig>;
+//# sourceMappingURL=discovery.d.ts.map

package/lib/oidc/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/oidc/discovery.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sCAAsC,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAQrG,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GAAU,cAAc,OAAO,KAAG,OAAO,CAAC,gBAAgB,CAgBjG,CAAC"}

package/lib/oidc/discovery.js

@@ -0,0 +1,78 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/*
+Copyright 2023 The Matrix.org Foundation C.I.C.
+
+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 { MetadataService, OidcClientSettingsStore } from "oidc-client-ts";
+import { validateAuthMetadata } from "./validate.js";
+import { Method, timeoutSignal } from "../http-api/index.js";
+/**
+ * @experimental
+ * Discover and validate delegated auth configuration
+ * - delegated auth issuer openid-configuration is reachable
+ * - delegated auth issuer openid-configuration is configured correctly for us
+ * Fetches https://oidc-issuer.example.com/.well-known/openid-configuration and other files linked therein.
+ * When successful, validated metadata is returned
+ * @param issuer - the OIDC issuer as returned by the /auth_issuer API
+ * @returns validated authentication metadata and optionally signing keys
+ * @throws when delegated auth config is invalid or unreachable
+ * @deprecated in favour of {@link BriijClient#getAuthMetadata}
+ */
+export var discoverAndValidateOIDCIssuerWellKnown = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator(function* (issuer) {
+    var issuerOpenIdConfigUrl = new URL(".well-known/openid-configuration", issuer);
+    var issuerWellKnownResponse = yield fetch(issuerOpenIdConfigUrl, {
+      method: Method.Get,
+      signal: timeoutSignal(5000)
+    });
+    var issuerWellKnown = yield issuerWellKnownResponse.json();
+    return validateAuthMetadataAndKeys(issuerWellKnown);
+  });
+  return function discoverAndValidateOIDCIssuerWellKnown(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();
+
+/**
+ * @experimental
+ * Validate the authentication metadata and fetch the signing keys from the jwks_uri in the metadata
+ * @param authMetadata - the authentication metadata to validate
+ * @returns validated authentication metadata and signing keys
+ */
+export var validateAuthMetadataAndKeys = /*#__PURE__*/function () {
+  var _ref2 = _asyncToGenerator(function* (authMetadata) {
+    var validatedIssuerConfig = validateAuthMetadata(authMetadata);
+
+    // create a temporary settings store, so we can use metadata service for discovery
+    var settings = new OidcClientSettingsStore({
+      authority: validatedIssuerConfig.issuer,
+      metadata: validatedIssuerConfig,
+      redirect_uri: "",
+      // Not known yet, this is here to make the type checker happy
+      client_id: "" // Not known yet, this is here to make the type checker happy
+    });
+    var metadataService = new MetadataService(settings);
+    return _objectSpread(_objectSpread({}, validatedIssuerConfig), {}, {
+      signingKeys: yield metadataService.getSigningKeys()
+    });
+  });
+  return function validateAuthMetadataAndKeys(_x2) {
+    return _ref2.apply(this, arguments);
+  };
+}();
+//# sourceMappingURL=discovery.js.map

package/lib/oidc/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","names":["MetadataService","OidcClientSettingsStore","validateAuthMetadata","Method","timeoutSignal","discoverAndValidateOIDCIssuerWellKnown","_ref","_asyncToGenerator","issuer","issuerOpenIdConfigUrl","URL","issuerWellKnownResponse","fetch","method","Get","signal","issuerWellKnown","json","validateAuthMetadataAndKeys","_x","apply","arguments","_ref2","authMetadata","validatedIssuerConfig","settings","authority","metadata","redirect_uri","client_id","metadataService","_objectSpread","signingKeys","getSigningKeys","_x2"],"sources":["../../src/oidc/discovery.ts"],"sourcesContent":["/*\nCopyright 2023 The Matrix.org Foundation C.I.C.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n*/\n\nimport { MetadataService, OidcClientSettingsStore } from \"oidc-client-ts\";\n\nimport { validateAuthMetadata } from \"./validate.ts\";\nimport { Method, timeoutSignal } from \"../http-api/index.ts\";\nimport { type OidcClientConfig } from \"./index.ts\";\n\n/**\n * @experimental\n * Discover and validate delegated auth configuration\n * - delegated auth issuer openid-configuration is reachable\n * - delegated auth issuer openid-configuration is configured correctly for us\n * Fetches https://oidc-issuer.example.com/.well-known/openid-configuration and other files linked therein.\n * When successful, validated metadata is returned\n * @param issuer - the OIDC issuer as returned by the /auth_issuer API\n * @returns validated authentication metadata and optionally signing keys\n * @throws when delegated auth config is invalid or unreachable\n * @deprecated in favour of {@link BriijClient#getAuthMetadata}\n */\nexport const discoverAndValidateOIDCIssuerWellKnown = async (issuer: string): Promise<OidcClientConfig> => {\n    const issuerOpenIdConfigUrl = new URL(\".well-known/openid-configuration\", issuer);\n    const issuerWellKnownResponse = await fetch(issuerOpenIdConfigUrl, {\n        method: Method.Get,\n        signal: timeoutSignal(5000),\n    });\n    const issuerWellKnown = await issuerWellKnownResponse.json();\n    return validateAuthMetadataAndKeys(issuerWellKnown);\n};\n\n/**\n * @experimental\n * Validate the authentication metadata and fetch the signing keys from the jwks_uri in the metadata\n * @param authMetadata - the authentication metadata to validate\n * @returns validated authentication metadata and signing keys\n */\nexport const validateAuthMetadataAndKeys = async (authMetadata: unknown): Promise<OidcClientConfig> => {\n    const validatedIssuerConfig = validateAuthMetadata(authMetadata);\n\n    // create a temporary settings store, so we can use metadata service for discovery\n    const settings = new OidcClientSettingsStore({\n        authority: validatedIssuerConfig.issuer,\n        metadata: validatedIssuerConfig,\n        redirect_uri: \"\", // Not known yet, this is here to make the type checker happy\n        client_id: \"\", // Not known yet, this is here to make the type checker happy\n    });\n    const metadataService = new MetadataService(settings);\n\n    return {\n        ...validatedIssuerConfig,\n        signingKeys: await metadataService.getSigningKeys(),\n    };\n};\n"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,eAAe,EAAEC,uBAAuB,QAAQ,gBAAgB;AAEzE,SAASC,oBAAoB,QAAQ,eAAe;AACpD,SAASC,MAAM,EAAEC,aAAa,QAAQ,sBAAsB;AAG5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMC,sCAAsC;EAAA,IAAAC,IAAA,GAAAC,iBAAA,CAAG,WAAOC,MAAc,EAAgC;IACvG,IAAMC,qBAAqB,GAAG,IAAIC,GAAG,CAAC,kCAAkC,EAAEF,MAAM,CAAC;IACjF,IAAMG,uBAAuB,SAASC,KAAK,CAACH,qBAAqB,EAAE;MAC/DI,MAAM,EAAEV,MAAM,CAACW,GAAG;MAClBC,MAAM,EAAEX,aAAa,CAAC,IAAI;IAC9B,CAAC,CAAC;IACF,IAAMY,eAAe,SAASL,uBAAuB,CAACM,IAAI,CAAC,CAAC;IAC5D,OAAOC,2BAA2B,CAACF,eAAe,CAAC;EACvD,CAAC;EAAA,gBARYX,sCAAsCA,CAAAc,EAAA;IAAA,OAAAb,IAAA,CAAAc,KAAA,OAAAC,SAAA;EAAA;AAAA,GAQlD;;AAED;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMH,2BAA2B;EAAA,IAAAI,KAAA,GAAAf,iBAAA,CAAG,WAAOgB,YAAqB,EAAgC;IACnG,IAAMC,qBAAqB,GAAGtB,oBAAoB,CAACqB,YAAY,CAAC;;IAEhE;IACA,IAAME,QAAQ,GAAG,IAAIxB,uBAAuB,CAAC;MACzCyB,SAAS,EAAEF,qBAAqB,CAAChB,MAAM;MACvCmB,QAAQ,EAAEH,qBAAqB;MAC/BI,YAAY,EAAE,EAAE;MAAE;MAClBC,SAAS,EAAE,EAAE,CAAE;IACnB,CAAC,CAAC;IACF,IAAMC,eAAe,GAAG,IAAI9B,eAAe,CAACyB,QAAQ,CAAC;IAErD,OAAAM,aAAA,CAAAA,aAAA,KACOP,qBAAqB;MACxBQ,WAAW,QAAQF,eAAe,CAACG,cAAc,CAAC;IAAC;EAE3D,CAAC;EAAA,gBAhBYf,2BAA2BA,CAAAgB,GAAA;IAAA,OAAAZ,KAAA,CAAAF,KAAA,OAAAC,SAAA;EAAA;AAAA,GAgBvC","ignoreList":[]}

package/lib/oidc/error.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Errors expected to be encountered during OIDC discovery, client registration, and authentication.
+ * Not intended to be displayed directly to the user.
+ */
+export declare enum OidcError {
+    NotSupported = "OIDC authentication not supported",
+    Misconfigured = "OIDC is misconfigured",
+    General = "Something went wrong with OIDC discovery",
+    OpSupport = "Configured OIDC OP does not support required functions",
+    DynamicRegistrationNotSupported = "Dynamic registration not supported",
+    DynamicRegistrationFailed = "Dynamic registration failed",
+    DynamicRegistrationInvalid = "Dynamic registration invalid response",
+    CodeExchangeFailed = "Failed to exchange code for token",
+    InvalidBearerTokenResponse = "Invalid bearer token response",
+    InvalidIdToken = "Invalid ID token",
+    MissingOrInvalidStoredState = "State required to finish logging in is not found in storage."
+}
+//# sourceMappingURL=error.d.ts.map

package/lib/oidc/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/oidc/error.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,oBAAY,SAAS;IACjB,YAAY,sCAAsC;IAClD,aAAa,0BAA0B;IACvC,OAAO,6CAA6C;IACpD,SAAS,2DAA2D;IACpE,+BAA+B,uCAAuC;IACtE,yBAAyB,gCAAgC;IACzD,0BAA0B,0CAA0C;IACpE,kBAAkB,sCAAsC;IACxD,0BAA0B,kCAAkC;IAC5D,cAAc,qBAAqB;IACnC,2BAA2B,iEAAiE;CAC/F"}

package/lib/oidc/error.js

@@ -0,0 +1,35 @@
+/*
+Copyright 2023 The Matrix.org Foundation C.I.C.
+
+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.
+*/
+
+/**
+ * Errors expected to be encountered during OIDC discovery, client registration, and authentication.
+ * Not intended to be displayed directly to the user.
+ */
+export var OidcError = /*#__PURE__*/function (OidcError) {
+  OidcError["NotSupported"] = "OIDC authentication not supported";
+  OidcError["Misconfigured"] = "OIDC is misconfigured";
+  OidcError["General"] = "Something went wrong with OIDC discovery";
+  OidcError["OpSupport"] = "Configured OIDC OP does not support required functions";
+  OidcError["DynamicRegistrationNotSupported"] = "Dynamic registration not supported";
+  OidcError["DynamicRegistrationFailed"] = "Dynamic registration failed";
+  OidcError["DynamicRegistrationInvalid"] = "Dynamic registration invalid response";
+  OidcError["CodeExchangeFailed"] = "Failed to exchange code for token";
+  OidcError["InvalidBearerTokenResponse"] = "Invalid bearer token response";
+  OidcError["InvalidIdToken"] = "Invalid ID token";
+  OidcError["MissingOrInvalidStoredState"] = "State required to finish logging in is not found in storage.";
+  return OidcError;
+}({});
+//# sourceMappingURL=error.js.map

package/lib/oidc/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","names":["OidcError"],"sources":["../../src/oidc/error.ts"],"sourcesContent":["/*\r\nCopyright 2023 The Matrix.org Foundation C.I.C.\r\n\r\nLicensed under the Apache License, Version 2.0 (the \"License\");\r\nyou may not use this file except in compliance with the License.\r\nYou may obtain a copy of the License at\r\n\r\n    http://www.apache.org/licenses/LICENSE-2.0\r\n\r\nUnless required by applicable law or agreed to in writing, software\r\ndistributed under the License is distributed on an \"AS IS\" BASIS,\r\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\nSee the License for the specific language governing permissions and\r\nlimitations under the License.\r\n*/\r\n\r\n/**\r\n * Errors expected to be encountered during OIDC discovery, client registration, and authentication.\r\n * Not intended to be displayed directly to the user.\r\n */\r\nexport enum OidcError {\r\n    NotSupported = \"OIDC authentication not supported\",\r\n    Misconfigured = \"OIDC is misconfigured\",\r\n    General = \"Something went wrong with OIDC discovery\",\r\n    OpSupport = \"Configured OIDC OP does not support required functions\",\r\n    DynamicRegistrationNotSupported = \"Dynamic registration not supported\",\r\n    DynamicRegistrationFailed = \"Dynamic registration failed\",\r\n    DynamicRegistrationInvalid = \"Dynamic registration invalid response\",\r\n    CodeExchangeFailed = \"Failed to exchange code for token\",\r\n    InvalidBearerTokenResponse = \"Invalid bearer token response\",\r\n    InvalidIdToken = \"Invalid ID token\",\r\n    MissingOrInvalidStoredState = \"State required to finish logging in is not found in storage.\",\r\n}\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA,WAAYA,SAAS,0BAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAAA,OAATA,SAAS;AAAA","ignoreList":[]}

package/lib/oidc/index.d.ts

@@ -0,0 +1,16 @@
+import type { SigningKey } from "oidc-client-ts";
+import { type ValidatedAuthMetadata } from "./validate.ts";
+export * from "./authorize.ts";
+export * from "./discovery.ts";
+export * from "./error.ts";
+export * from "./register.ts";
+export * from "./tokenRefresher.ts";
+export * from "./validate.ts";
+/**
+ * Validated config for native OIDC authentication, as returned by {@link discoverAndValidateOIDCIssuerWellKnown}.
+ * Contains metadata and signing keys from the issuer's well-known (https://oidc-issuer.example.com/.well-known/openid-configuration).
+ */
+export interface OidcClientConfig extends ValidatedAuthMetadata {
+    signingKeys: SigningKey[] | null;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/oidc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/oidc/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAE9B;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB;IAC3D,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;CACpC"}

package/lib/oidc/index.js

@@ -0,0 +1,29 @@
+/*
+Copyright 2023 The Matrix.org Foundation C.I.C.
+
+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.
+*/
+
+export * from "./authorize.js";
+export * from "./discovery.js";
+export * from "./error.js";
+export * from "./register.js";
+export * from "./tokenRefresher.js";
+export * from "./validate.js";
+
+/**
+ * Validated config for native OIDC authentication, as returned by {@link discoverAndValidateOIDCIssuerWellKnown}.
+ * Contains metadata and signing keys from the issuer's well-known (https://oidc-issuer.example.com/.well-known/openid-configuration).
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/lib/oidc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/oidc/index.ts"],"sourcesContent":["/*\r\nCopyright 2023 The Matrix.org Foundation C.I.C.\r\n\r\nLicensed under the Apache License, Version 2.0 (the \"License\");\r\nyou may not use this file except in compliance with the License.\r\nYou may obtain a copy of the License at\r\n\r\n    http://www.apache.org/licenses/LICENSE-2.0\r\n\r\nUnless required by applicable law or agreed to in writing, software\r\ndistributed under the License is distributed on an \"AS IS\" BASIS,\r\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\nSee the License for the specific language governing permissions and\r\nlimitations under the License.\r\n*/\r\n\r\nimport type { SigningKey } from \"oidc-client-ts\";\r\nimport { type ValidatedAuthMetadata } from \"./validate.ts\";\r\n\r\nexport * from \"./authorize.ts\";\r\nexport * from \"./discovery.ts\";\r\nexport * from \"./error.ts\";\r\nexport * from \"./register.ts\";\r\nexport * from \"./tokenRefresher.ts\";\r\nexport * from \"./validate.ts\";\r\n\r\n/**\r\n * Validated config for native OIDC authentication, as returned by {@link discoverAndValidateOIDCIssuerWellKnown}.\r\n * Contains metadata and signing keys from the issuer's well-known (https://oidc-issuer.example.com/.well-known/openid-configuration).\r\n */\r\nexport interface OidcClientConfig extends ValidatedAuthMetadata {\r\n    signingKeys: SigningKey[] | null;\r\n}\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,cAAc,gBAAgB;AAC9B,cAAc,gBAAgB;AAC9B,cAAc,YAAY;AAC1B,cAAc,eAAe;AAC7B,cAAc,qBAAqB;AACnC,cAAc,eAAe;;AAE7B;AACA;AACA;AACA;AAHA","ignoreList":[]}

package/lib/oidc/register.d.ts

@@ -0,0 +1,70 @@
+import { type OidcClientConfig } from "./index.ts";
+import { type NonEmptyArray } from "../@types/common.ts";
+/**
+ * Client metadata passed to registration endpoint
+ */
+export type OidcRegistrationClientMetadata = {
+    clientName: OidcRegistrationRequestBody["client_name"];
+    clientUri: OidcRegistrationRequestBody["client_uri"];
+    logoUri?: OidcRegistrationRequestBody["logo_uri"];
+    applicationType: OidcRegistrationRequestBody["application_type"];
+    redirectUris: OidcRegistrationRequestBody["redirect_uris"];
+    contacts: OidcRegistrationRequestBody["contacts"];
+    tosUri: OidcRegistrationRequestBody["tos_uri"];
+    policyUri: OidcRegistrationRequestBody["policy_uri"];
+};
+/**
+ * Request body for dynamic registration as defined by https://github.com/matrix-org/matrix-spec-proposals/pull/2966
+ */
+interface OidcRegistrationRequestBody {
+    client_name?: string;
+    client_uri: string;
+    logo_uri?: string;
+    contacts?: string[];
+    tos_uri?: string;
+    policy_uri?: string;
+    redirect_uris?: NonEmptyArray<string>;
+    response_types?: NonEmptyArray<string>;
+    grant_types?: NonEmptyArray<string>;
+    id_token_signed_response_alg?: string;
+    token_endpoint_auth_method: string;
+    application_type: "web" | "native";
+}
+/**
+ * The OAuth 2.0 grant types that are defined for Matrix in https://spec.matrix.org/v1.17/client-server-api/#grant-types
+ */
+export declare enum OAuthGrantType {
+    /**
+     * See https://spec.matrix.org/v1.17/client-server-api/#authorization-code-grant
+     */
+    AuthorizationCode = "authorization_code",
+    /**
+     * https://spec.matrix.org/v1.17/client-server-api/#refresh-token-grant
+     */
+    RefreshToken = "refresh_token",
+    /**
+     * The OAuth 2.0 Device Authorization Grant type identifier as per
+     * https://www.rfc-editor.org/rfc/rfc8628.html#section-7.2 from
+     * [MSC4341](https://github.com/matrix-org/matrix-spec-proposals/pull/4341).
+     *
+     * @experimental Note that this is UNSTABLE and may have breaking changes without notice.
+     */
+    DeviceAuthorization = "urn:ietf:params:oauth:grant-type:device_code"
+}
+/**
+ * The name "scope" is a misnomer here as it is actually a "grant type".
+ *
+ * @deprecated use `OAuthGrantType.DeviceAuthorization` instead
+ */
+export declare const DEVICE_CODE_SCOPE: string;
+/**
+ * Attempts dynamic registration against the configured registration endpoint.
+ * Will ignore any URIs that do not use client_uri as a common base as per the spec.
+ * @param delegatedAuthConfig - Auth config from {@link discoverAndValidateOIDCIssuerWellKnown}
+ * @param clientMetadata - The metadata for the client which to register
+ * @returns Promise<string> resolved with registered clientId
+ * @throws when registration is not supported, on failed request or invalid response
+ */
+export declare const registerOidcClient: (delegatedAuthConfig: OidcClientConfig, clientMetadata: OidcRegistrationClientMetadata) => Promise<string>;
+export {};
+//# sourceMappingURL=register.d.ts.map

package/lib/oidc/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/oidc/register.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IACzC,UAAU,EAAE,2BAA2B,CAAC,aAAa,CAAC,CAAC;IACvD,SAAS,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAClD,eAAe,EAAE,2BAA2B,CAAC,kBAAkB,CAAC,CAAC;IACjE,YAAY,EAAE,2BAA2B,CAAC,eAAe,CAAC,CAAC;IAC3D,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAC/C,SAAS,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAC;CACxD,CAAC;AAEF;;GAEG;AACH,UAAU,2BAA2B;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,0BAA0B,EAAE,MAAM,CAAC;IACnC,gBAAgB,EAAE,KAAK,GAAG,QAAQ,CAAC;CACtC;AAED;;GAEG;AACH,oBAAY,cAAc;IACtB;;OAEG;IACH,iBAAiB,uBAAuB;IACxC;;OAEG;IACH,YAAY,kBAAkB;IAC9B;;;;;;OAMG;IACH,mBAAmB,iDAAiD;CACvE;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAA2C,CAAC;AAW5E;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC3B,qBAAqB,gBAAgB,EACrC,gBAAgB,8BAA8B,KAC/C,OAAO,CAAC,MAAM,CA2DhB,CAAC"}