@authup/server-core 1.0.0-beta.51 → 1.0.0-beta.53

package/dist/core/oauth2/authorization/module.mjs

@@ -1,65 +1,128 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-import { buildOAuth2TokenHash } from "./helpers.mjs";
-import { ScopeName } from "@authup/core-kit";
-import { OAuth2AuthorizationResponseType, OAuth2GrantError, OAuth2RequestError, OAuth2ResponseTypeError, hasOAuth2Scopes } from "@authup/specs";
+import { toIdentityPolicyData } from "../../identity/permission/identity-policy-data.mjs";
+import { EventName, EventRefType, EventScope, IdentityType } from "@authup/core-kit";
+import { hasInstanceof } from "@authup/errors";
+import { OAUTH2_ACCESS_DENIED_ERROR_INSTANCE, OAUTH2_LOGIN_REQUIRED_ERROR_INSTANCE, OAUTH2_MFA_REQUIRED_ERROR_INSTANCE, OAuth2AccessDeniedError, OAuth2AuthenticationContextClass, OAuth2AuthorizationPrompt, OAuth2AuthorizationResponseType, OAuth2GrantError, OAuth2LoginRequiredError, OAuth2MfaRequiredError, OAuth2RequestError, OAuth2ResponseTypeError } from "@authup/specs";
 //#region src/core/oauth2/authorization/module.ts
+const DEFAULT_PROMPT_LOGIN_MAX_AGE = 60;
+const DEFAULT_MFA_FRESHNESS_MAX_AGE = 60;
 var OAuth2Authorization = class {
-	accessTokenIssuer;
-	openIdTokenIssuer;
 	codeIssuer;
-	identityResolver;
+	sessionManager;
+	eventService;
+	metrics;
+	promptLoginMaxAge;
+	mfaFreshnessMaxAge;
+	mfaChallengeProvider;
+	accessPolicyEvaluator;
 	constructor(ctx) {
-		this.accessTokenIssuer = ctx.accessTokenIssuer;
-		this.openIdTokenIssuer = ctx.openIdTokenIssuer;
 		this.codeIssuer = ctx.codeIssuer;
-		this.identityResolver = ctx.identityResolver;
+		this.sessionManager = ctx.sessionManager;
+		this.eventService = ctx.eventService;
+		this.metrics = ctx.metrics;
+		this.accessPolicyEvaluator = ctx.accessPolicyEvaluator;
+		this.promptLoginMaxAge = ctx.promptLoginMaxAge ?? DEFAULT_PROMPT_LOGIN_MAX_AGE;
+		this.mfaFreshnessMaxAge = ctx.mfaFreshnessMaxAge ?? DEFAULT_MFA_FRESHNESS_MAX_AGE;
+		this.mfaChallengeProvider = ctx.mfaChallengeProvider;
 	}
 	/**
 	* Authorize with validated codeRequest.
 	*
 	* @param data
 	* @param identity
-	*/ async authorize(data, identity) {
-		const availableResponseTypes = Object.values(OAuth2AuthorizationResponseType);
+	* @param options
+	*/ async authorize(data, identity, options = {}) {
+		try {
+			const result = await this.authorizeInner(data, identity, options);
+			await this.eventService?.record({
+				scope: EventScope.OAUTH2,
+				name: EventName.AUTHORIZE,
+				refType: EventRefType.CLIENT,
+				refId: options.client?.id ?? data.client_id ?? null,
+				clientId: options.client?.id ?? data.client_id ?? null,
+				actorType: identity.type,
+				actorId: identity.data.id,
+				actorName: identity.data.name,
+				realmId: data.realm_id ?? null,
+				data: {
+					reason: options.client?.built_in ? "autoConsent" : "consent",
+					...data.scope ? { scope: data.scope } : {}
+				}
+			});
+			this.metrics?.recordAuthorize("issued");
+			return result;
+		} catch (e) {
+			if (hasInstanceof(e, OAUTH2_ACCESS_DENIED_ERROR_INSTANCE)) {
+				await this.eventService?.record({
+					scope: EventScope.OAUTH2,
+					name: EventName.AUTHORIZE_FAILED,
+					refType: EventRefType.CLIENT,
+					refId: options.client?.id ?? data.client_id ?? null,
+					clientId: options.client?.id ?? data.client_id ?? null,
+					actorType: identity.type,
+					actorId: identity.data.id,
+					actorName: identity.data.name,
+					realmId: data.realm_id ?? null,
+					data: { reason: "accessPolicy" }
+				});
+				this.metrics?.recordAuthorize("denied");
+			} else if (hasInstanceof(e, OAUTH2_LOGIN_REQUIRED_ERROR_INSTANCE)) this.metrics?.recordAuthorize("login_required");
+			else if (hasInstanceof(e, OAUTH2_MFA_REQUIRED_ERROR_INSTANCE)) this.metrics?.recordAuthorize("mfa_required");
+			else this.metrics?.recordAuthorize("error");
+			throw e;
+		}
+	}
+	async authorizeInner(data, identity, options = {}) {
 		let responseTypes = [];
 		if (data.response_type) responseTypes = Array.isArray(data.response_type) ? data.response_type : data.response_type.split(" ");
-		const enabledResponseTypes = {};
-		for (const responseType of responseTypes) if (!availableResponseTypes.includes(responseType)) throw OAuth2ResponseTypeError.unsupported();
-		else enabledResponseTypes[responseType] = true;
+		for (const responseType of responseTypes) if (responseType !== OAuth2AuthorizationResponseType.CODE) throw OAuth2ResponseTypeError.unsupported();
+		if (!responseTypes.includes(OAuth2AuthorizationResponseType.CODE)) throw OAuth2ResponseTypeError.unsupported();
 		if (!data.redirect_uri) throw OAuth2GrantError.redirectUriMismatch();
 		const output = {
 			redirectUri: data.redirect_uri,
 			...data.state ? { state: data.state } : {}
 		};
 		if (!identity) throw OAuth2RequestError.identityInvalid();
-		const payloadBaseNormalized = {
-			sub: identity.data.id,
-			sub_kind: identity.type,
-			realm_id: identity.data.realm.id,
-			realm_name: identity.data.realm.name,
-			client_id: data.client_id,
-			...data.scope ? { scope: data.scope } : {},
-			...data.nonce ? { nonce: data.nonce } : {}
-		};
-		let codeEntity;
-		if (enabledResponseTypes[OAuth2AuthorizationResponseType.TOKEN]) {
-			const [token] = await this.accessTokenIssuer.issue(payloadBaseNormalized);
-			output.accessToken = token;
+		if (data.realm_id && identity.data.realm_id !== data.realm_id) throw OAuth2LoginRequiredError.realmMismatch();
+		const nowSeconds = Math.floor(Date.now() / 1e3);
+		let authTime = nowSeconds;
+		let session = null;
+		if (options.sessionId) {
+			session = await this.sessionManager.findOneById(options.sessionId);
+			if (session && session.created_at) authTime = Math.floor(new Date(session.created_at).getTime() / 1e3);
+		}
+		if (this.mfaChallengeProvider && identity.type === IdentityType.USER) {
+			const challenge = await this.mfaChallengeProvider.challenge(identity.data.id, { issueMaterial: false });
+			if (challenge.required && !session?.mfa_at) throw OAuth2MfaRequiredError.challengeRequired();
+			if (challenge.enrollmentRequired) throw OAuth2MfaRequiredError.enrollmentRequired();
+			if (challenge.required && data.acr_values) {
+				if (data.acr_values.split(" ").includes(OAuth2AuthenticationContextClass.MFA)) {
+					const mfaAtSeconds = session?.mfa_at ? Math.floor(new Date(session.mfa_at).getTime() / 1e3) : null;
+					if (mfaAtSeconds === null || nowSeconds - mfaAtSeconds > this.mfaFreshnessMaxAge) throw OAuth2MfaRequiredError.stepUpRequired();
+				}
+			}
 		}
-		if (enabledResponseTypes[OAuth2AuthorizationResponseType.CODE]) {
-			codeEntity = await this.codeIssuer.issue(data, identity);
-			output.authorizationCode = codeEntity.id;
+		if ((data.prompt ? data.prompt.split(" ") : []).includes(OAuth2AuthorizationPrompt.LOGIN) && nowSeconds - authTime > this.promptLoginMaxAge) throw OAuth2LoginRequiredError.reauthenticationRequired();
+		if (typeof data.max_age !== "undefined" && data.max_age !== null) {
+			const maxAge = Number(data.max_age);
+			if (Number.isFinite(maxAge) && nowSeconds - authTime > maxAge) throw OAuth2LoginRequiredError.reauthenticationRequired();
 		}
-		if (enabledResponseTypes[OAuth2AuthorizationResponseType.ID_TOKEN] || data.scope && hasOAuth2Scopes(data.scope, ScopeName.OPEN_ID)) {
-			const idTokenPayload = { ...payloadBaseNormalized };
-			if (output.accessToken) idTokenPayload.at_hash = await buildOAuth2TokenHash(output.accessToken);
-			if (output.authorizationCode) idTokenPayload.c_hash = await buildOAuth2TokenHash(output.authorizationCode);
-			const [token] = await this.openIdTokenIssuer.issueWithIdentity(idTokenPayload, identity);
-			if (enabledResponseTypes[OAuth2AuthorizationResponseType.ID_TOKEN]) output.idToken = token;
-			if (codeEntity) await this.codeIssuer.updateIdToken(codeEntity, token);
+		if (options.client?.access_policy_id) {
+			let allowed = false;
+			const subject = toIdentityPolicyData(identity);
+			if (this.accessPolicyEvaluator && subject) allowed = await this.accessPolicyEvaluator.evaluate(options.client.access_policy_id, subject);
+			if (!allowed) throw OAuth2AccessDeniedError.forClient(options.redirectUriVerified && data.redirect_uri ? {
+				redirectUri: data.redirect_uri,
+				state: data.state ?? null
+			} : void 0);
 		}
+		output.authorizationCode = (await this.codeIssuer.issue(data, identity, {
+			sessionId: options.sessionId,
+			authTime,
+			authMethod: session?.auth_method ?? null
+		})).id;
 		return output;
 	}
 };

package/dist/core/oauth2/authorization/module.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"module.mjs","names":["ScopeName","OAuth2AuthorizationResponseType","OAuth2GrantError","OAuth2RequestError","OAuth2ResponseTypeError","hasOAuth2Scopes","buildOAuth2TokenHash","OAuth2Authorization","accessTokenIssuer","openIdTokenIssuer","codeIssuer","identityResolver","ctx","authorize","data","identity","availableResponseTypes","Object","values","responseTypes","response_type","Array","isArray","split","enabledResponseTypes","responseType","includes","unsupported","redirect_uri","redirectUriMismatch","output","redirectUri","state","identityInvalid","payloadBaseNormalized","sub","id","sub_kind","type","realm_id","realm","realm_name","name","client_id","scope","nonce","codeEntity","TOKEN","token","issue","accessToken","CODE","authorizationCode","needsIdToken","ID_TOKEN","OPEN_ID","idTokenPayload","at_hash","c_hash","issueWithIdentity","idToken","updateIdToken"],"sources":["../../../../src/core/oauth2/authorization/module.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { Identity, OAuth2AuthorizationCode, OAuth2AuthorizationCodeRequest } from '@authup/core-kit';\nimport { ScopeName } from '@authup/core-kit';\nimport type { OAuth2TokenPayload } from '@authup/specs';\nimport {\n    OAuth2AuthorizationResponseType,\n    OAuth2GrantError,\n    OAuth2RequestError,\n    OAuth2ResponseTypeError,\n    hasOAuth2Scopes,\n} from '@authup/specs';\nimport type { IOAuth2OpenIDTokenIssuer, IOAuth2TokenIssuer } from '../token/index.ts';\nimport type { IOAuth2AuthorizationCodeIssuer } from './code/index.ts';\nimport { buildOAuth2TokenHash } from './helpers.ts';\nimport type {\n    OAuth2AuthorizationManagerContext,\n    OAuth2AuthorizationResult,\n} from './types.ts';\nimport type { IIdentityResolver } from '../../identity/index.ts';\n\nexport class OAuth2Authorization {\n    protected accessTokenIssuer : IOAuth2TokenIssuer;\n\n    protected openIdTokenIssuer : IOAuth2OpenIDTokenIssuer;\n\n    protected codeIssuer : IOAuth2AuthorizationCodeIssuer;\n\n    protected identityResolver : IIdentityResolver;\n\n    constructor(ctx: OAuth2AuthorizationManagerContext) {\n        this.accessTokenIssuer = ctx.accessTokenIssuer;\n        this.openIdTokenIssuer = ctx.openIdTokenIssuer;\n        this.codeIssuer = ctx.codeIssuer;\n        this.identityResolver = ctx.identityResolver;\n    }\n\n    /**\n     * Authorize with validated codeRequest.\n     *\n     * @param data\n     * @param identity\n     */\n    async authorize(\n        data: OAuth2AuthorizationCodeRequest,\n        identity: Identity,\n    ) : Promise<OAuth2AuthorizationResult> {\n        const availableResponseTypes : string[] = Object.values(OAuth2AuthorizationResponseType);\n\n        let responseTypes : string[] = [];\n        if (data.response_type) {\n            responseTypes = Array.isArray(data.response_type) ?\n                data.response_type :\n                data.response_type.split(' ');\n        }\n\n        const enabledResponseTypes : Record<string, boolean> = {};\n\n        for (const responseType of responseTypes) {\n            if (!availableResponseTypes.includes(responseType)) {\n                throw OAuth2ResponseTypeError.unsupported();\n            } else {\n                enabledResponseTypes[responseType] = true;\n            }\n        }\n\n        if (!data.redirect_uri) {\n            throw OAuth2GrantError.redirectUriMismatch();\n        }\n\n        const output : OAuth2AuthorizationResult = {\n            redirectUri: data.redirect_uri,\n            ...(data.state ? { state: data.state } : {}),\n        };\n\n        if (!identity) {\n            throw OAuth2RequestError.identityInvalid();\n        }\n\n        const payloadBaseNormalized : OAuth2TokenPayload = {\n\n            sub: identity.data.id,\n            sub_kind: identity.type,\n            realm_id: identity.data.realm.id,\n            realm_name: identity.data.realm.name,\n\n            client_id: data.client_id,\n            ...(data.scope ? { scope: data.scope } : {}),\n            ...(data.nonce ? { nonce: data.nonce } : {}),\n        };\n\n        let codeEntity : OAuth2AuthorizationCode | undefined;\n\n        if (enabledResponseTypes[OAuth2AuthorizationResponseType.TOKEN]) {\n            const [token] = await this.accessTokenIssuer.issue(payloadBaseNormalized);\n\n            output.accessToken = token;\n        }\n\n        if (enabledResponseTypes[OAuth2AuthorizationResponseType.CODE]) {\n            codeEntity = await this.codeIssuer.issue(\n                data,\n                identity,\n            );\n\n            output.authorizationCode = codeEntity.id;\n        }\n\n        const needsIdToken = enabledResponseTypes[OAuth2AuthorizationResponseType.ID_TOKEN] ||\n            (data.scope && hasOAuth2Scopes(data.scope, ScopeName.OPEN_ID));\n\n        if (needsIdToken) {\n            const idTokenPayload = { ...payloadBaseNormalized };\n\n            if (output.accessToken) {\n                idTokenPayload.at_hash = await buildOAuth2TokenHash(output.accessToken);\n            }\n            if (output.authorizationCode) {\n                idTokenPayload.c_hash = await buildOAuth2TokenHash(output.authorizationCode);\n            }\n\n            const [token] = await this.openIdTokenIssuer.issueWithIdentity(\n                idTokenPayload,\n                identity,\n            );\n\n            if (enabledResponseTypes[OAuth2AuthorizationResponseType.ID_TOKEN]) {\n                output.idToken = token;\n            }\n\n            if (codeEntity) {\n                await this.codeIssuer.updateIdToken(codeEntity, token);\n            }\n        }\n\n        return output;\n    }\n}\n"],"mappings":";;;;;;;AA0BA,IAAaO,sBAAb,MAAaA;CACCC;CAEAC;CAEAC;CAEAC;CAEV,YAAYC,KAAwC;EAChD,KAAKJ,oBAAoBI,IAAIJ;EAC7B,KAAKC,oBAAoBG,IAAIH;EAC7B,KAAKC,aAAaE,IAAIF;EACtB,KAAKC,mBAAmBC,IAAID;CAChC;;;;;;IAQA,MAAME,UACFC,MACAC,UACmC;EACnC,MAAMC,yBAAoCC,OAAOC,OAAOjB,+BAAAA;EAExD,IAAIkB,gBAA2B,CAAA;EAC/B,IAAIL,KAAKM,eACLD,gBAAgBE,MAAMC,QAAQR,KAAKM,aAAa,IAC5CN,KAAKM,gBACLN,KAAKM,cAAcG,MAAM,GAAA;EAGjC,MAAMC,uBAAiD,CAAC;EAExD,KAAK,MAAMC,gBAAgBN,eACvB,IAAI,CAACH,uBAAuBU,SAASD,YAAAA,GACjC,MAAMrB,wBAAwBuB,YAAW;OAEzCH,qBAAqBC,gBAAgB;EAI7C,IAAI,CAACX,KAAKc,cACN,MAAM1B,iBAAiB2B,oBAAmB;EAG9C,MAAMC,SAAqC;GACvCC,aAAajB,KAAKc;GAClB,GAAId,KAAKkB,QAAQ,EAAEA,OAAOlB,KAAKkB,MAAM,IAAI,CAAC;EAC9C;EAEA,IAAI,CAACjB,UACD,MAAMZ,mBAAmB8B,gBAAe;EAG5C,MAAMC,wBAA6C;GAE/CC,KAAKpB,SAASD,KAAKsB;GACnBC,UAAUtB,SAASuB;GACnBC,UAAUxB,SAASD,KAAK0B,MAAMJ;GAC9BK,YAAY1B,SAASD,KAAK0B,MAAME;GAEhCC,WAAW7B,KAAK6B;GAChB,GAAI7B,KAAK8B,QAAQ,EAAEA,OAAO9B,KAAK8B,MAAM,IAAI,CAAC;GAC1C,GAAI9B,KAAK+B,QAAQ,EAAEA,OAAO/B,KAAK+B,MAAM,IAAI,CAAC;EAC9C;EAEA,IAAIC;EAEJ,IAAItB,qBAAqBvB,gCAAgC8C,QAAQ;GAC7D,MAAM,CAACC,SAAS,MAAM,KAAKxC,kBAAkByC,MAAMf,qBAAAA;GAEnDJ,OAAOoB,cAAcF;EACzB;EAEA,IAAIxB,qBAAqBvB,gCAAgCkD,OAAO;GAC5DL,aAAa,MAAM,KAAKpC,WAAWuC,MAC/BnC,MACAC,QAAAA;GAGJe,OAAOsB,oBAAoBN,WAAWV;EAC1C;EAKA,IAHqBZ,qBAAqBvB,gCAAgCqD,aACrExC,KAAK8B,SAASvC,gBAAgBS,KAAK8B,OAAO5C,UAAUuD,OAAO,GAE9C;GACd,MAAMC,iBAAiB,EAAE,GAAGtB,sBAAsB;GAElD,IAAIJ,OAAOoB,aACPM,eAAeC,UAAU,MAAMnD,qBAAqBwB,OAAOoB,WAAW;GAE1E,IAAIpB,OAAOsB,mBACPI,eAAeE,SAAS,MAAMpD,qBAAqBwB,OAAOsB,iBAAiB;GAG/E,MAAM,CAACJ,SAAS,MAAM,KAAKvC,kBAAkBkD,kBACzCH,gBACAzC,QAAAA;GAGJ,IAAIS,qBAAqBvB,gCAAgCqD,WACrDxB,OAAO8B,UAAUZ;GAGrB,IAAIF,YACA,MAAM,KAAKpC,WAAWmD,cAAcf,YAAYE,KAAAA;EAExD;EAEA,OAAOlB;CACX;AACJ"}
+{"version":3,"file":"module.mjs","names":["EventName","EventRefType","EventScope","IdentityType","hasInstanceof","OAUTH2_ACCESS_DENIED_ERROR_INSTANCE","OAUTH2_LOGIN_REQUIRED_ERROR_INSTANCE","OAUTH2_MFA_REQUIRED_ERROR_INSTANCE","OAuth2AccessDeniedError","OAuth2AuthenticationContextClass","OAuth2AuthorizationPrompt","OAuth2AuthorizationResponseType","OAuth2GrantError","OAuth2LoginRequiredError","OAuth2MfaRequiredError","OAuth2RequestError","OAuth2ResponseTypeError","toIdentityPolicyData","DEFAULT_PROMPT_LOGIN_MAX_AGE","DEFAULT_MFA_FRESHNESS_MAX_AGE","OAuth2Authorization","codeIssuer","sessionManager","eventService","metrics","promptLoginMaxAge","mfaFreshnessMaxAge","mfaChallengeProvider","accessPolicyEvaluator","ctx","authorize","data","identity","options","result","authorizeInner","record","scope","OAUTH2","name","AUTHORIZE","refType","CLIENT","refId","client","id","client_id","clientId","actorType","type","actorId","actorName","realmId","realm_id","reason","built_in","recordAuthorize","e","AUTHORIZE_FAILED","responseTypes","response_type","Array","isArray","split","responseType","CODE","unsupported","includes","redirect_uri","redirectUriMismatch","output","redirectUri","state","identityInvalid","realmMismatch","nowSeconds","Math","floor","Date","now","authTime","session","sessionId","findOneById","created_at","getTime","USER","challenge","issueMaterial","required","mfa_at","challengeRequired","enrollmentRequired","acr_values","acrValues","MFA","mfaAtSeconds","stepUpRequired","prompts","prompt","LOGIN","reauthenticationRequired","max_age","maxAge","Number","isFinite","access_policy_id","allowed","subject","evaluate","forClient","redirectUriVerified","undefined","codeEntity","issue","authMethod","auth_method","authorizationCode"],"sources":["../../../../src/core/oauth2/authorization/module.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type {\n    Identity, \n    OAuth2AuthorizationCode, \n    OAuth2AuthorizationCodeRequest, \n    Session,\n} from '@authup/core-kit';\nimport {\n    EventName, \n    EventRefType, \n    EventScope, \n    IdentityType,\n} from '@authup/core-kit';\nimport { hasInstanceof } from '@authup/errors';\nimport {\n    OAUTH2_ACCESS_DENIED_ERROR_INSTANCE,\n    OAUTH2_LOGIN_REQUIRED_ERROR_INSTANCE,\n    OAUTH2_MFA_REQUIRED_ERROR_INSTANCE,\n    OAuth2AccessDeniedError,\n    OAuth2AuthenticationContextClass,\n    OAuth2AuthorizationPrompt,\n    OAuth2AuthorizationResponseType,\n    OAuth2GrantError,\n    OAuth2LoginRequiredError,\n    OAuth2MfaRequiredError,\n    OAuth2RequestError,\n    OAuth2ResponseTypeError,\n} from '@authup/specs';\nimport type { IOAuth2AuthorizationCodeIssuer } from './code/index.ts';\nimport type { IOAuth2AccessPolicyEvaluator } from '../access-policy/index.ts';\nimport { toIdentityPolicyData } from '../../identity/permission/identity-policy-data.ts';\nimport type {\n    OAuth2AuthorizationManagerContext,\n    OAuth2AuthorizationOptions,\n    OAuth2AuthorizationResult,\n} from './types.ts';\nimport type { ISessionManager } from '../../authentication/index.ts';\nimport type { IEventService, IUserAuthenticatorChallengeProvider } from '../../entities/index.ts';\nimport type { IAuthFlowMetrics } from '../../metrics/index.ts';\n\nconst DEFAULT_PROMPT_LOGIN_MAX_AGE = 60;\n\n// Deliberately 60 (not 0, deviating from the plan-050 sketch): the hosted\n// challenge round-trip (stamp mfa_at → retry POST /authorize) takes seconds,\n// so a 0-window step-up could never be satisfied and would loop the ladder.\nconst DEFAULT_MFA_FRESHNESS_MAX_AGE = 60;\n\nexport class OAuth2Authorization {\n    protected codeIssuer : IOAuth2AuthorizationCodeIssuer;\n\n    protected sessionManager : ISessionManager;\n\n    protected eventService? : IEventService;\n\n    protected metrics? : IAuthFlowMetrics;\n\n    protected promptLoginMaxAge : number;\n\n    protected mfaFreshnessMaxAge : number;\n\n    protected mfaChallengeProvider? : IUserAuthenticatorChallengeProvider;\n\n    protected accessPolicyEvaluator? : IOAuth2AccessPolicyEvaluator;\n\n    constructor(ctx: OAuth2AuthorizationManagerContext) {\n        this.codeIssuer = ctx.codeIssuer;\n        this.sessionManager = ctx.sessionManager;\n        this.eventService = ctx.eventService;\n        this.metrics = ctx.metrics;\n        this.accessPolicyEvaluator = ctx.accessPolicyEvaluator;\n        this.promptLoginMaxAge = ctx.promptLoginMaxAge ?? DEFAULT_PROMPT_LOGIN_MAX_AGE;\n        this.mfaFreshnessMaxAge = ctx.mfaFreshnessMaxAge ?? DEFAULT_MFA_FRESHNESS_MAX_AGE;\n        this.mfaChallengeProvider = ctx.mfaChallengeProvider;\n    }\n\n    /**\n     * Authorize with validated codeRequest.\n     *\n     * @param data\n     * @param identity\n     * @param options\n     */\n    async authorize(\n        data: OAuth2AuthorizationCodeRequest,\n        identity: Identity,\n        options: OAuth2AuthorizationOptions = {},\n    ) : Promise<OAuth2AuthorizationResult> {\n        try {\n            const result = await this.authorizeInner(data, identity, options);\n\n            await this.eventService?.record({\n                scope: EventScope.OAUTH2,\n                name: EventName.AUTHORIZE,\n                refType: EventRefType.CLIENT,\n                refId: options.client?.id ?? data.client_id ?? null,\n                clientId: options.client?.id ?? data.client_id ?? null,\n                actorType: identity.type,\n                actorId: identity.data.id,\n                actorName: identity.data.name,\n                realmId: data.realm_id ?? null,\n                data: {\n                    reason: options.client?.built_in ? 'autoConsent' : 'consent',\n                    ...(data.scope ? { scope: data.scope } : {}),\n                },\n            });\n            this.metrics?.recordAuthorize('issued');\n\n            return result;\n        } catch (e) {\n            if (hasInstanceof(e, OAUTH2_ACCESS_DENIED_ERROR_INSTANCE)) {\n                await this.eventService?.record({\n                    scope: EventScope.OAUTH2,\n                    name: EventName.AUTHORIZE_FAILED,\n                    refType: EventRefType.CLIENT,\n                    refId: options.client?.id ?? data.client_id ?? null,\n                    clientId: options.client?.id ?? data.client_id ?? null,\n                    actorType: identity.type,\n                    actorId: identity.data.id,\n                    actorName: identity.data.name,\n                    realmId: data.realm_id ?? null,\n                    data: { reason: 'accessPolicy' },\n                });\n                this.metrics?.recordAuthorize('denied');\n            } else if (hasInstanceof(e, OAUTH2_LOGIN_REQUIRED_ERROR_INSTANCE)) {\n                this.metrics?.recordAuthorize('login_required');\n            } else if (hasInstanceof(e, OAUTH2_MFA_REQUIRED_ERROR_INSTANCE)) {\n                this.metrics?.recordAuthorize('mfa_required');\n            } else {\n                this.metrics?.recordAuthorize('error');\n            }\n\n            throw e;\n        }\n    }\n\n    protected async authorizeInner(\n        data: OAuth2AuthorizationCodeRequest,\n        identity: Identity,\n        options: OAuth2AuthorizationOptions = {},\n    ) : Promise<OAuth2AuthorizationResult> {\n        // OAuth 2.1 posture: only the authorization-code response type is\n        // supported — implicit/hybrid (token, id_token, none) were dropped\n        // (plan 042 item 3). Defense in depth behind the request validator.\n        let responseTypes : string[] = [];\n        if (data.response_type) {\n            responseTypes = Array.isArray(data.response_type) ?\n                data.response_type :\n                data.response_type.split(' ');\n        }\n\n        for (const responseType of responseTypes) {\n            if (responseType !== OAuth2AuthorizationResponseType.CODE) {\n                throw OAuth2ResponseTypeError.unsupported();\n            }\n        }\n\n        if (!responseTypes.includes(OAuth2AuthorizationResponseType.CODE)) {\n            throw OAuth2ResponseTypeError.unsupported();\n        }\n\n        if (!data.redirect_uri) {\n            throw OAuth2GrantError.redirectUriMismatch();\n        }\n\n        const output : OAuth2AuthorizationResult = {\n            redirectUri: data.redirect_uri,\n            ...(data.state ? { state: data.state } : {}),\n        };\n\n        if (!identity) {\n            throw OAuth2RequestError.identityInvalid();\n        }\n\n        // Realm binding: the code-request verifier stamped data.realm_id with the\n        // resolved client's realm. The authenticated identity must belong to that\n        // same realm — otherwise a lingering session for realm A could silently\n        // mint a code/token for realm B's client (confused deputy). The error body\n        // deliberately carries no identity data (no realm-enumeration oracle).\n        // The comparison reads the scalar realm_id column, NOT the realm\n        // relation — the relation may simply not be loaded on the resolved\n        // identity. An identity without a realm_id fails closed the same way —\n        // clean login_required, never a TypeError.\n        if (\n            data.realm_id &&\n            identity.data.realm_id !== data.realm_id\n        ) {\n            throw OAuth2LoginRequiredError.realmMismatch();\n        }\n\n        // Authentication time = the backing session's creation instant (NOT\n        // refreshed_at — a token refresh must not reset it). Session-less flows\n        // (e.g. HTTP Basic authorize) present live credentials on this request,\n        // so the authentication time is \"now\".\n        const nowSeconds = Math.floor(Date.now() / 1000);\n        let authTime = nowSeconds;\n        let session : Session | null = null;\n        if (options.sessionId) {\n            session = await this.sessionManager.findOneById(options.sessionId);\n            if (session && session.created_at) {\n                authTime = Math.floor(new Date(session.created_at).getTime() / 1000);\n            }\n        }\n\n        // MFA backstop (plan 049) — the authoritative server-side gate; the\n        // hosted UI's challenge step is convenience. The proof is session-bound\n        // (mfa_at — stamped by the challenge endpoint or the password grant's\n        // otp param), so a session-less flow (HTTP Basic) cannot carry one and\n        // fails closed while the user holds a confirmed device. A user without\n        // a device under mfaRequired is routed to inline enrollment.\n        if (this.mfaChallengeProvider && identity.type === IdentityType.USER) {\n            // requirement flags only — the interactive challenge material (the\n            // webauthn nonce) is issued by the status endpoint, not this backstop.\n            const challenge = await this.mfaChallengeProvider.challenge(\n                identity.data.id,\n                { issueMaterial: false },\n            );\n            if (challenge.required && !session?.mfa_at) {\n                throw OAuth2MfaRequiredError.challengeRequired();\n            }\n\n            if (challenge.enrollmentRequired) {\n                throw OAuth2MfaRequiredError.enrollmentRequired();\n            }\n\n            // Step-up (plan 050 stage 3): a requested `acr_values` containing\n            // urn:authup:mfa is a TRIGGER (Auth0/Keycloak stance) — the proof\n            // must additionally be FRESH (mfaFreshnessMaxAge window, mirroring\n            // promptLoginMaxAge's absorb-the-round-trip semantics). Enforced\n            // only while the user actually holds a factor — per OIDC Core\n            // §5.5.1.1 acr is voluntary, so an unsatisfiable request degrades\n            // to the achieved acr instead of bricking the RP.\n            if (challenge.required && data.acr_values) {\n                const acrValues = data.acr_values.split(' ');\n                if (acrValues.includes(OAuth2AuthenticationContextClass.MFA)) {\n                    const mfaAtSeconds = session?.mfa_at ?\n                        Math.floor(new Date(session.mfa_at).getTime() / 1000) :\n                        null;\n                    if (mfaAtSeconds === null || nowSeconds - mfaAtSeconds > this.mfaFreshnessMaxAge) {\n                        throw OAuth2MfaRequiredError.stepUpRequired();\n                    }\n                }\n            }\n        }\n\n        // OIDC §3.1.2.1 prompt=login / max_age freshness (enforced only when\n        // requested — a plain authorize never throws here). The hosted page\n        // renders the login form for prompt=login; this is the server backstop.\n        const prompts = data.prompt ? data.prompt.split(' ') : [];\n        if (\n            prompts.includes(OAuth2AuthorizationPrompt.LOGIN) &&\n            nowSeconds - authTime > this.promptLoginMaxAge\n        ) {\n            throw OAuth2LoginRequiredError.reauthenticationRequired();\n        }\n\n        if (\n            typeof data.max_age !== 'undefined' &&\n            data.max_age !== null\n        ) {\n            const maxAge = Number(data.max_age);\n            if (\n                Number.isFinite(maxAge) &&\n                nowSeconds - authTime > maxAge\n            ) {\n                throw OAuth2LoginRequiredError.reauthenticationRequired();\n            }\n        }\n\n        // Application access policy (plan 052) — the last gate before\n        // issuance: a denial is only revealed to a fully-authenticated\n        // (incl. second-factor) identity. A client carrying a policy id with\n        // no wired evaluator denies too (never silently allow a configured\n        // gate). The redirect target rides the error only when the\n        // redirect_uri was pattern-verified (RFC 6749 §4.1.2.1).\n        if (options.client?.access_policy_id) {\n            let allowed = false;\n\n            const subject = toIdentityPolicyData(identity);\n            if (this.accessPolicyEvaluator && subject) {\n                allowed = await this.accessPolicyEvaluator.evaluate(\n                    options.client.access_policy_id,\n                    subject,\n                );\n            }\n\n            if (!allowed) {\n                throw OAuth2AccessDeniedError.forClient(\n                    options.redirectUriVerified && data.redirect_uri ?\n                        { redirectUri: data.redirect_uri, state: data.state ?? null } :\n                        undefined,\n                );\n            }\n        }\n\n        // The id_token is NOT minted here — the /token exchange mints it after\n        // resolving the real backing session, so its `sid` is authoritative\n        // (plan 042 item 6). The code carries the authentication instant.\n        const codeEntity : OAuth2AuthorizationCode = await this.codeIssuer.issue(\n            data,\n            identity,\n            {\n                sessionId: options.sessionId,\n                authTime,\n                authMethod: session?.auth_method ?? null,\n            },\n        );\n\n        output.authorizationCode = codeEntity.id;\n\n        return output;\n    }\n}\n"],"mappings":"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"}

package/dist/core/oauth2/authorization/types.d.ts

@@ -1,17 +1,61 @@
-import type { IOAuth2OpenIDTokenIssuer, IOAuth2TokenIssuer } from '../token/index.ts';
+import type { Client } from '@authup/core-kit';
 import type { IOAuth2AuthorizationCodeIssuer } from './code/index.ts';
-import type { IIdentityResolver } from '../../identity/index.ts';
+import type { IOAuth2AccessPolicyEvaluator } from '../access-policy/index.ts';
+import type { ISessionManager } from '../../authentication/index.ts';
+import type { IEventService, IUserAuthenticatorChallengeProvider } from '../../entities/index.ts';
+import type { IAuthFlowMetrics } from '../../metrics/index.ts';
 export type OAuth2AuthorizationManagerContext = {
-    accessTokenIssuer: IOAuth2TokenIssuer;
-    openIdTokenIssuer: IOAuth2OpenIDTokenIssuer;
     codeIssuer: IOAuth2AuthorizationCodeIssuer;
-    identityResolver: IIdentityResolver;
+    sessionManager: ISessionManager;
+    eventService?: IEventService;
+    metrics?: IAuthFlowMetrics;
+    /**
+     * Application access policy gate (plan 052): evaluates a client's
+     * access_policy_id against the authenticated identity before a code is
+     * issued. Absent = feature inert — but a client carrying a policy id
+     * with no wired evaluator still denies (fail closed).
+     */
+    accessPolicyEvaluator?: IOAuth2AccessPolicyEvaluator;
+    /**
+     * Max age (seconds) of the authentication a `prompt=login` request accepts
+     * before forcing re-auth (config `promptLoginMaxAge`). Default 60.
+     */
+    promptLoginMaxAge?: number;
+    /**
+     * Max age (seconds) of the session's mfa_at an `acr_values=urn:authup:mfa`
+     * step-up request accepts before forcing a fresh challenge
+     * (config `mfaFreshnessMaxAge`). Default 60.
+     */
+    mfaFreshnessMaxAge?: number;
+    /**
+     * MFA backstop (plan 049): decides whether the authenticated user must
+     * hold a session-bound second-factor proof (mfa_at) before a code is
+     * issued. Absent = MFA disabled.
+     */
+    mfaChallengeProvider?: IUserAuthenticatorChallengeProvider;
 };
 export type OAuth2AuthorizationResult = {
     authorizationCode?: string;
-    accessToken?: string;
-    idToken?: string;
     redirectUri: string;
     state?: string;
 };
+export type OAuth2AuthorizationOptions = {
+    /**
+     * The id of the session the authorizing bearer belongs to. Persisted on the
+     * issued authorization code so the token exchange can reuse that session
+     * instead of creating a second one.
+     */
+    sessionId?: string | null;
+    /**
+     * The verified client entity (from the code-request verifier) — consumed by
+     * the audit record to distinguish built_in auto-consent from manual consent.
+     */
+    client?: Client;
+    /**
+     * Whether the request's redirect_uri was pattern-verified by the
+     * code-request verifier. Gates whether a denial may be answered with an
+     * error redirect (RFC 6749 §4.1.2.1) instead of an interactive error.
+     */
+    redirectUriVerified?: boolean;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/core/oauth2/authorization/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/oauth2/authorization/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,MAAM,iCAAiC,GAAG;IAC5C,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,UAAU,EAAE,8BAA8B,CAAC;IAC3C,gBAAgB,EAAE,iBAAiB,CAAA;CACtC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/oauth2/authorization/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,MAAM,iCAAiC,GAAG;IAC5C,UAAU,EAAE,8BAA8B,CAAC;IAC3C,cAAc,EAAE,eAAe,CAAC;IAChC,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,4BAA4B,CAAC;IACrD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,mCAAmC,CAAC;CAC9D,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACrC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC"}

package/dist/core/oauth2/client/authenticator.d.ts

@@ -1,17 +1,26 @@
-import type { Client } from '@authup/core-kit';
+import { type Client } from '@authup/core-kit';
+import type { OAuth2TokenConfirmation } from '@authup/specs';
 import { ClientCredentialsService } from '../../authentication/credential/index.ts';
+import type { ClientCertificateEvidence, IClientCertificateValidator } from '../../client-certificate/index.ts';
 import type { IIdentityResolver } from '../../identity/index.ts';
+export type OAuth2ClientAuthenticatorContext = {
+    identityResolver: IIdentityResolver;
+    certificateValidator: IClientCertificateValidator;
+};
 /**
- * Authenticates a client at the OAuth2 token endpoint. Confidential clients
- * MUST present a valid client_secret (RFC 6749 §3.2.1, §4.1.3, §4.3.2, §6);
- * public clients identify via client_id only.
+ * Authenticates a client at the OAuth2 token endpoint according to its
+ * exclusive method: public id only, shared secret, or trusted TLS evidence.
  *
- * Used by authorization_code, refresh_token, and password grants.
+ * Used by every standard client-resolving grant.
  */
 export declare class OAuth2ClientAuthenticator {
     protected identityResolver: IIdentityResolver;
     protected credentialsService: ClientCredentialsService;
-    constructor(identityResolver: IIdentityResolver);
-    authenticate(clientId: string | undefined, clientSecret?: string, realmId?: string): Promise<Client>;
+    protected certificateValidator?: IClientCertificateValidator;
+    constructor(ctx: IIdentityResolver | OAuth2ClientAuthenticatorContext);
+    authenticate(clientId: string | undefined, clientSecret?: string, realmId?: string, certificateEvidence?: ClientCertificateEvidence): Promise<Client>;
+    resolve(clientId: string, realmId?: string): Promise<Client>;
+    resolveTokenBinding(client: Pick<Client, 'token_binding_method'>, certificateEvidence?: ClientCertificateEvidence): OAuth2TokenConfirmation | undefined;
+    validateCertificateEvidenceForBinding(certificateEvidence?: ClientCertificateEvidence): OAuth2TokenConfirmation;
 }
 //# sourceMappingURL=authenticator.d.ts.map

package/dist/core/oauth2/client/authenticator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authenticator.d.ts","sourceRoot":"","sources":["../../../../src/core/oauth2/client/authenticator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;GAMG;AACH,qBAAa,yBAAyB;IAClC,SAAS,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAE9C,SAAS,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;gBAE3C,gBAAgB,EAAE,iBAAiB;IAKzC,YAAY,CACd,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;CA2BrB"}
+{"version":3,"file":"authenticator.d.ts","sourceRoot":"","sources":["../../../../src/core/oauth2/client/authenticator.ts"],"names":[],"mappings":"AAOA,OAAO,EACH,KAAK,MAAM,EAId,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EACR,yBAAyB,EACzB,2BAA2B,EAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,MAAM,gCAAgC,GAAG;IAC3C,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,oBAAoB,EAAE,2BAA2B,CAAC;CACrD,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,yBAAyB;IAClC,SAAS,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAE9C,SAAS,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;IAEvD,SAAS,CAAC,oBAAoB,CAAC,EAAE,2BAA2B,CAAC;gBAEjD,GAAG,EAAE,iBAAiB,GAAG,gCAAgC;IAY/D,YAAY,CACd,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,EAChB,mBAAmB,CAAC,EAAE,yBAAyB,GAChD,OAAO,CAAC,MAAM,CAAC;IAsDZ,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAalE,mBAAmB,CACf,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAC5C,mBAAmB,CAAC,EAAE,yBAAyB,GAChD,uBAAuB,GAAG,SAAS;IAYtC,qCAAqC,CACjC,mBAAmB,CAAC,EAAE,yBAAyB,GAChD,uBAAuB;CAa7B"}

package/dist/core/oauth2/client/authenticator.mjs

@@ -3,33 +3,70 @@ import "node:url";
 import.meta.url;
 import { ClientCredentialsService } from "../../authentication/credential/entities/client/module.mjs";
 import "../../authentication/credential/index.mjs";
-import { IdentityType } from "@authup/core-kit";
+import { ClientAuthMethod, ClientTokenBindingMethod, IdentityType } from "@authup/core-kit";
+import { isValidationError } from "@authup/errors";
 import { OAuth2ClientError } from "@authup/specs";
 //#region src/core/oauth2/client/authenticator.ts
 /**
-* Authenticates a client at the OAuth2 token endpoint. Confidential clients
-* MUST present a valid client_secret (RFC 6749 §3.2.1, §4.1.3, §4.3.2, §6);
-* public clients identify via client_id only.
+* Authenticates a client at the OAuth2 token endpoint according to its
+* exclusive method: public id only, shared secret, or trusted TLS evidence.
 *
-* Used by authorization_code, refresh_token, and password grants.
+* Used by every standard client-resolving grant.
 */ var OAuth2ClientAuthenticator = class {
 	identityResolver;
 	credentialsService;
-	constructor(identityResolver) {
-		this.identityResolver = identityResolver;
+	certificateValidator;
+	constructor(ctx) {
+		if ("identityResolver" in ctx) {
+			this.identityResolver = ctx.identityResolver;
+			this.certificateValidator = ctx.certificateValidator;
+		} else this.identityResolver = ctx;
 		this.credentialsService = new ClientCredentialsService();
 	}
-	async authenticate(clientId, clientSecret, realmId) {
+	async authenticate(clientId, clientSecret, realmId, certificateEvidence) {
 		if (!clientId) throw OAuth2ClientError.invalid();
+		const client = await this.resolve(clientId, realmId);
+		switch (client.auth_method) {
+			case ClientAuthMethod.NONE:
+				if (typeof clientSecret === "string") throw OAuth2ClientError.invalid();
+				break;
+			case ClientAuthMethod.SECRET:
+				if (!clientSecret) throw OAuth2ClientError.invalid();
+				if (!await this.credentialsService.verify(clientSecret, client)) throw OAuth2ClientError.invalid();
+				break;
+			case ClientAuthMethod.TLS:
+				if (typeof clientSecret === "string" || !certificateEvidence || !this.certificateValidator) throw OAuth2ClientError.invalid();
+				try {
+					await this.certificateValidator.validateForAuthentication(client, certificateEvidence);
+				} catch (e) {
+					if (isValidationError(e)) throw OAuth2ClientError.invalid();
+					throw e;
+				}
+				break;
+			default: throw OAuth2ClientError.invalid();
+		}
+		return client;
+	}
+	async resolve(clientId, realmId) {
 		const identity = await this.identityResolver.resolve(IdentityType.CLIENT, clientId, realmId);
 		if (!identity || identity.type !== IdentityType.CLIENT) throw OAuth2ClientError.invalid();
 		if (!identity.data.active) throw OAuth2ClientError.inactive();
-		if (identity.data.is_confidential) {
-			if (!clientSecret) throw OAuth2ClientError.invalid();
-			if (!await this.credentialsService.verify(clientSecret, identity.data)) throw OAuth2ClientError.invalid();
-		}
 		return identity.data;
 	}
+	resolveTokenBinding(client, certificateEvidence) {
+		if (client.token_binding_method === ClientTokenBindingMethod.NONE) return;
+		if (client.token_binding_method !== ClientTokenBindingMethod.TLS) throw OAuth2ClientError.invalid();
+		return this.validateCertificateEvidenceForBinding(certificateEvidence);
+	}
+	validateCertificateEvidenceForBinding(certificateEvidence) {
+		if (!certificateEvidence || !this.certificateValidator) throw OAuth2ClientError.invalid();
+		try {
+			this.certificateValidator.validateForBinding(certificateEvidence);
+		} catch {
+			throw OAuth2ClientError.invalid();
+		}
+		return { "x5t#S256": certificateEvidence.thumbprint };
+	}
 };
 //#endregion
 export { OAuth2ClientAuthenticator };

package/dist/core/oauth2/client/authenticator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"authenticator.mjs","names":["IdentityType","OAuth2ClientError","ClientCredentialsService","OAuth2ClientAuthenticator","identityResolver","credentialsService","authenticate","clientId","clientSecret","realmId","invalid","identity","resolve","CLIENT","type","data","active","inactive","is_confidential","verified","verify"],"sources":["../../../../src/core/oauth2/client/authenticator.ts"],"sourcesContent":["/*\n * Copyright (c) 2025-2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { Client } from '@authup/core-kit';\nimport { IdentityType } from '@authup/core-kit';\nimport { OAuth2ClientError } from '@authup/specs';\nimport { ClientCredentialsService } from '../../authentication/credential/index.ts';\nimport type { IIdentityResolver } from '../../identity/index.ts';\n\n/**\n * Authenticates a client at the OAuth2 token endpoint. Confidential clients\n * MUST present a valid client_secret (RFC 6749 §3.2.1, §4.1.3, §4.3.2, §6);\n * public clients identify via client_id only.\n *\n * Used by authorization_code, refresh_token, and password grants.\n */\nexport class OAuth2ClientAuthenticator {\n    protected identityResolver: IIdentityResolver;\n\n    protected credentialsService: ClientCredentialsService;\n\n    constructor(identityResolver: IIdentityResolver) {\n        this.identityResolver = identityResolver;\n        this.credentialsService = new ClientCredentialsService();\n    }\n\n    async authenticate(\n        clientId: string | undefined,\n        clientSecret?: string,\n        realmId?: string,\n    ): Promise<Client> {\n        if (!clientId) {\n            throw OAuth2ClientError.invalid();\n        }\n\n        const identity = await this.identityResolver.resolve(IdentityType.CLIENT, clientId, realmId);\n        if (!identity || identity.type !== IdentityType.CLIENT) {\n            throw OAuth2ClientError.invalid();\n        }\n\n        if (!identity.data.active) {\n            throw OAuth2ClientError.inactive();\n        }\n\n        if (identity.data.is_confidential) {\n            if (!clientSecret) {\n                throw OAuth2ClientError.invalid();\n            }\n\n            const verified = await this.credentialsService.verify(clientSecret, identity.data);\n            if (!verified) {\n                throw OAuth2ClientError.invalid();\n            }\n        }\n\n        return identity.data;\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;GAoBA,IAAaG,4BAAb,MAAaA;CACCC;CAEAC;CAEV,YAAYD,kBAAqC;EAC7C,KAAKA,mBAAmBA;EACxB,KAAKC,qBAAqB,IAAIH,yBAAAA;CAClC;CAEA,MAAMI,aACFC,UACAC,cACAC,SACe;EACf,IAAI,CAACF,UACD,MAAMN,kBAAkBS,QAAO;EAGnC,MAAMC,WAAW,MAAM,KAAKP,iBAAiBQ,QAAQZ,aAAaa,QAAQN,UAAUE,OAAAA;EACpF,IAAI,CAACE,YAAYA,SAASG,SAASd,aAAaa,QAC5C,MAAMZ,kBAAkBS,QAAO;EAGnC,IAAI,CAACC,SAASI,KAAKC,QACf,MAAMf,kBAAkBgB,SAAQ;EAGpC,IAAIN,SAASI,KAAKG,iBAAiB;GAC/B,IAAI,CAACV,cACD,MAAMP,kBAAkBS,QAAO;GAInC,IAAI,CAACS,MADkB,KAAKd,mBAAmBe,OAAOZ,cAAcG,SAASI,IAAI,GAE7E,MAAMd,kBAAkBS,QAAO;EAEvC;EAEA,OAAOC,SAASI;CACpB;AACJ"}
+{"version":3,"file":"authenticator.mjs","names":["ClientAuthMethod","ClientTokenBindingMethod","IdentityType","OAuth2ClientError","isValidationError","ClientCredentialsService","OAuth2ClientAuthenticator","identityResolver","credentialsService","certificateValidator","ctx","authenticate","clientId","clientSecret","realmId","certificateEvidence","invalid","client","resolve","auth_method","NONE","SECRET","verified","verify","TLS","validateForAuthentication","e","identity","CLIENT","type","data","active","inactive","resolveTokenBinding","token_binding_method","undefined","validateCertificateEvidenceForBinding","validateForBinding","thumbprint"],"sources":["../../../../src/core/oauth2/client/authenticator.ts"],"sourcesContent":["/*\n * Copyright (c) 2025-2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport {\n    type Client,\n    ClientAuthMethod,\n    ClientTokenBindingMethod,\n    IdentityType,\n} from '@authup/core-kit';\nimport type { OAuth2TokenConfirmation } from '@authup/specs';\nimport { OAuth2ClientError } from '@authup/specs';\nimport { isValidationError } from '@authup/errors';\nimport { ClientCredentialsService } from '../../authentication/credential/index.ts';\nimport type {\n    ClientCertificateEvidence,\n    IClientCertificateValidator,\n} from '../../client-certificate/index.ts';\nimport type { IIdentityResolver } from '../../identity/index.ts';\n\nexport type OAuth2ClientAuthenticatorContext = {\n    identityResolver: IIdentityResolver,\n    certificateValidator: IClientCertificateValidator,\n};\n\n/**\n * Authenticates a client at the OAuth2 token endpoint according to its\n * exclusive method: public id only, shared secret, or trusted TLS evidence.\n *\n * Used by every standard client-resolving grant.\n */\nexport class OAuth2ClientAuthenticator {\n    protected identityResolver: IIdentityResolver;\n\n    protected credentialsService: ClientCredentialsService;\n\n    protected certificateValidator?: IClientCertificateValidator;\n\n    constructor(ctx: IIdentityResolver | OAuth2ClientAuthenticatorContext) {\n        if ('identityResolver' in ctx) {\n            this.identityResolver = ctx.identityResolver;\n            this.certificateValidator = ctx.certificateValidator;\n        } else {\n            // Kept as a compatibility seam for focused secret/public-client\n            // unit tests. Production wiring always supplies the validator.\n            this.identityResolver = ctx;\n        }\n        this.credentialsService = new ClientCredentialsService();\n    }\n\n    async authenticate(\n        clientId: string | undefined,\n        clientSecret?: string,\n        realmId?: string,\n        certificateEvidence?: ClientCertificateEvidence,\n    ): Promise<Client> {\n        if (!clientId) {\n            throw OAuth2ClientError.invalid();\n        }\n\n        const client = await this.resolve(clientId, realmId);\n\n        switch (client.auth_method) {\n            case ClientAuthMethod.NONE:\n                if (typeof clientSecret === 'string') {\n                    throw OAuth2ClientError.invalid();\n                }\n                break;\n            case ClientAuthMethod.SECRET: {\n                if (!clientSecret) {\n                    throw OAuth2ClientError.invalid();\n                }\n\n                const verified = await this.credentialsService.verify(clientSecret, client);\n                if (!verified) {\n                    throw OAuth2ClientError.invalid();\n                }\n                break;\n            }\n            case ClientAuthMethod.TLS:\n                if (\n                    typeof clientSecret === 'string' ||\n                    !certificateEvidence ||\n                    !this.certificateValidator\n                ) {\n                    throw OAuth2ClientError.invalid();\n                }\n\n                try {\n                    await this.certificateValidator.validateForAuthentication(client, certificateEvidence);\n                } catch (e) {\n                    // A validation failure deliberately reveals neither the\n                    // certificate identity nor which realm anchor failed. An\n                    // infrastructure fault (e.g. the trust-anchor store being\n                    // unreachable) must NOT masquerade as a bad certificate —\n                    // let it surface as a server error instead.\n                    if (isValidationError(e)) {\n                        throw OAuth2ClientError.invalid();\n                    }\n                    throw e;\n                }\n                break;\n            default:\n                throw OAuth2ClientError.invalid();\n        }\n\n        return client;\n    }\n\n    async resolve(clientId: string, realmId?: string): Promise<Client> {\n        const identity = await this.identityResolver.resolve(IdentityType.CLIENT, clientId, realmId);\n        if (!identity || identity.type !== IdentityType.CLIENT) {\n            throw OAuth2ClientError.invalid();\n        }\n\n        if (!identity.data.active) {\n            throw OAuth2ClientError.inactive();\n        }\n\n        return identity.data;\n    }\n\n    resolveTokenBinding(\n        client: Pick<Client, 'token_binding_method'>,\n        certificateEvidence?: ClientCertificateEvidence,\n    ): OAuth2TokenConfirmation | undefined {\n        if (client.token_binding_method === ClientTokenBindingMethod.NONE) {\n            return undefined;\n        }\n\n        if (client.token_binding_method !== ClientTokenBindingMethod.TLS) {\n            throw OAuth2ClientError.invalid();\n        }\n\n        return this.validateCertificateEvidenceForBinding(certificateEvidence);\n    }\n\n    validateCertificateEvidenceForBinding(\n        certificateEvidence?: ClientCertificateEvidence,\n    ): OAuth2TokenConfirmation {\n        if (!certificateEvidence || !this.certificateValidator) {\n            throw OAuth2ClientError.invalid();\n        }\n\n        try {\n            this.certificateValidator.validateForBinding(certificateEvidence);\n        } catch {\n            throw OAuth2ClientError.invalid();\n        }\n\n        return { 'x5t#S256': certificateEvidence.thumbprint };\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;GAkCA,IAAaM,4BAAb,MAAaA;CACCC;CAEAC;CAEAC;CAEV,YAAYC,KAA2D;EACnE,IAAI,sBAAsBA,KAAK;GAC3B,KAAKH,mBAAmBG,IAAIH;GAC5B,KAAKE,uBAAuBC,IAAID;EACpC,OAGI,KAAKF,mBAAmBG;EAE5B,KAAKF,qBAAqB,IAAIH,yBAAAA;CAClC;CAEA,MAAMM,aACFC,UACAC,cACAC,SACAC,qBACe;EACf,IAAI,CAACH,UACD,MAAMT,kBAAkBa,QAAO;EAGnC,MAAMC,SAAS,MAAM,KAAKC,QAAQN,UAAUE,OAAAA;EAE5C,QAAQG,OAAOE,aAAf;GACI,KAAKnB,iBAAiBoB;IAClB,IAAI,OAAOP,iBAAiB,UACxB,MAAMV,kBAAkBa,QAAO;IAEnC;GACJ,KAAKhB,iBAAiBqB;IAClB,IAAI,CAACR,cACD,MAAMV,kBAAkBa,QAAO;IAInC,IAAI,CAACM,MADkB,KAAKd,mBAAmBe,OAAOV,cAAcI,MAAAA,GAEhE,MAAMd,kBAAkBa,QAAO;IAEnC;GAEJ,KAAKhB,iBAAiBwB;IAClB,IACI,OAAOX,iBAAiB,YACxB,CAACE,uBACD,CAAC,KAAKN,sBAEN,MAAMN,kBAAkBa,QAAO;IAGnC,IAAI;KACA,MAAM,KAAKP,qBAAqBgB,0BAA0BR,QAAQF,mBAAAA;IACtE,SAASW,GAAG;KAMR,IAAItB,kBAAkBsB,CAAAA,GAClB,MAAMvB,kBAAkBa,QAAO;KAEnC,MAAMU;IACV;IACA;GACJ,SACI,MAAMvB,kBAAkBa,QAAO;EACvC;EAEA,OAAOC;CACX;CAEA,MAAMC,QAAQN,UAAkBE,SAAmC;EAC/D,MAAMa,WAAW,MAAM,KAAKpB,iBAAiBW,QAAQhB,aAAa0B,QAAQhB,UAAUE,OAAAA;EACpF,IAAI,CAACa,YAAYA,SAASE,SAAS3B,aAAa0B,QAC5C,MAAMzB,kBAAkBa,QAAO;EAGnC,IAAI,CAACW,SAASG,KAAKC,QACf,MAAM5B,kBAAkB6B,SAAQ;EAGpC,OAAOL,SAASG;CACpB;CAEAG,oBACIhB,QACAF,qBACmC;EACnC,IAAIE,OAAOiB,yBAAyBjC,yBAAyBmB,MACzD;EAGJ,IAAIH,OAAOiB,yBAAyBjC,yBAAyBuB,KACzD,MAAMrB,kBAAkBa,QAAO;EAGnC,OAAO,KAAKoB,sCAAsCrB,mBAAAA;CACtD;CAEAqB,sCACIrB,qBACuB;EACvB,IAAI,CAACA,uBAAuB,CAAC,KAAKN,sBAC9B,MAAMN,kBAAkBa,QAAO;EAGnC,IAAI;GACA,KAAKP,qBAAqB4B,mBAAmBtB,mBAAAA;EACjD,QAAQ;GACJ,MAAMZ,kBAAkBa,QAAO;EACnC;EAEA,OAAO,EAAE,YAAYD,oBAAoBuB,WAAW;CACxD;AACJ"}

package/dist/core/oauth2/client/grant-type.d.ts

@@ -0,0 +1,9 @@
+import type { Client } from '@authup/core-kit';
+/**
+ * Enforce the client's grant_types allowlist (RFC 6749 §5.2
+ * unauthorized_client). A null/empty column means allow-all, so
+ * enforcement is opt-in per client; unknown values in the list are
+ * inert — they can only narrow, never widen.
+ */
+export declare function assertClientGrantAllowed(client: Pick<Client, 'grant_types'>, grantType: string): void;
+//# sourceMappingURL=grant-type.d.ts.map

package/dist/core/oauth2/client/grant-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant-type.d.ts","sourceRoot":"","sources":["../../../../src/core/oauth2/client/grant-type.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CASrG"}

package/dist/core/oauth2/client/grant-type.mjs

@@ -0,0 +1,18 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { OAuth2ClientUnauthorizedError } from "@authup/specs";
+//#region src/core/oauth2/client/grant-type.ts
+/**
+* Enforce the client's grant_types allowlist (RFC 6749 §5.2
+* unauthorized_client). A null/empty column means allow-all, so
+* enforcement is opt-in per client; unknown values in the list are
+* inert — they can only narrow, never widen.
+*/ function assertClientGrantAllowed(client, grantType) {
+	if (!client.grant_types) return;
+	if (!client.grant_types.split(/[\s,]+/).includes(grantType)) throw OAuth2ClientUnauthorizedError.grantType(grantType);
+}
+//#endregion
+export { assertClientGrantAllowed };
+
+//# sourceMappingURL=grant-type.mjs.map

package/dist/core/oauth2/client/grant-type.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant-type.mjs","names":["OAuth2ClientUnauthorizedError","assertClientGrantAllowed","client","grantType","grant_types","allowed","split","includes"],"sources":["../../../../src/core/oauth2/client/grant-type.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { Client } from '@authup/core-kit';\nimport { OAuth2ClientUnauthorizedError } from '@authup/specs';\n\n/**\n * Enforce the client's grant_types allowlist (RFC 6749 §5.2\n * unauthorized_client). A null/empty column means allow-all, so\n * enforcement is opt-in per client; unknown values in the list are\n * inert — they can only narrow, never widen.\n */\nexport function assertClientGrantAllowed(client: Pick<Client, 'grant_types'>, grantType: string): void {\n    if (!client.grant_types) {\n        return;\n    }\n\n    const allowed = client.grant_types.split(/[\\s,]+/);\n    if (!allowed.includes(grantType)) {\n        throw OAuth2ClientUnauthorizedError.grantType(grantType);\n    }\n}\n"],"mappings":";;;;;;;;;;GAgBA,SAAgBC,yBAAyBC,QAAqCC,WAAiB;CAC3F,IAAI,CAACD,OAAOE,aACR;CAIJ,IAAI,CADYF,OAAOE,YAAYE,MAAM,QACpCD,CAAAA,CAAQE,SAASJ,SAAAA,GAClB,MAAMH,8BAA8BG,UAAUA,SAAAA;AAEtD"}

package/dist/core/oauth2/client/index.d.ts

@@ -1,3 +1,4 @@
 export * from './authenticator.ts';
+export * from './grant-type.ts';
 export * from './types.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/oauth2/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/oauth2/client/index.ts"],"names":[],"mappings":"AAOA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/oauth2/client/index.ts"],"names":[],"mappings":"AAOA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/core/oauth2/client/index.mjs

@@ -2,4 +2,5 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { OAuth2ClientAuthenticator } from "./authenticator.mjs";
-export { OAuth2ClientAuthenticator };
+import { assertClientGrantAllowed } from "./grant-type.mjs";
+export { OAuth2ClientAuthenticator, assertClientGrantAllowed };

package/dist/core/oauth2/end-session/index.d.ts

@@ -0,0 +1,4 @@
+export * from './service.ts';
+export * from './types.ts';
+export * from './validator.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/oauth2/end-session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/oauth2/end-session/index.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/core/oauth2/end-session/index.mjs

@@ -0,0 +1,6 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { OAuth2EndSessionService } from "./service.mjs";
+import { OAuth2EndSessionRequestValidator } from "./validator.mjs";
+export { OAuth2EndSessionRequestValidator, OAuth2EndSessionService };

package/dist/core/oauth2/end-session/service.d.ts

@@ -0,0 +1,31 @@
+import type { OAuth2TokenPayload } from '@authup/specs';
+import type { IEventService, IRealmRepository } from '../../entities/index.ts';
+import type { ISessionManager } from '../../authentication/index.ts';
+import type { IOAuth2ClientRepository } from '../client/index.ts';
+import type { IOAuth2TokenVerifier } from '../token/index.ts';
+import type { IOAuth2EndSessionService, OAuth2EndSessionRequest, OAuth2EndSessionResult, OAuth2EndSessionServiceContext } from './types.ts';
+export declare class OAuth2EndSessionService implements IOAuth2EndSessionService {
+    protected tokenVerifier: IOAuth2TokenVerifier;
+    protected sessionManager: ISessionManager;
+    protected clientRepository: IOAuth2ClientRepository;
+    protected realmRepository: IRealmRepository;
+    protected eventService?: IEventService;
+    protected hintGracePeriod: number;
+    constructor(ctx: OAuth2EndSessionServiceContext);
+    verify(data: OAuth2EndSessionRequest): Promise<OAuth2EndSessionResult>;
+    revoke(sessionId: string, sub: string, subKind: string): Promise<boolean>;
+    /**
+     * With a positive `hintGracePeriod`, an expired hint is honored only within
+     * the window past `exp` — beyond it a leaked id_token stops being a
+     * replayable remote logout (the hint counts as unverified; the click-gated
+     * confirm page still works). 0 keeps spec/Keycloak parity: any expired hint.
+     */
+    protected isWithinHintGraceWindow(payload: OAuth2TokenPayload): boolean;
+    /**
+     * A post-logout redirect is honored only when it is an absolute http(s) URL
+     * that matches a registered client redirect pattern (defense against open
+     * redirects to attacker-controlled URLs).
+     */
+    protected isValidPostLogoutRedirect(registered: string | null | undefined, candidate: string): boolean;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/core/oauth2/end-session/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/core/oauth2/end-session/service.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EACR,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EACjC,MAAM,YAAY,CAAC;AAEpB,qBAAa,uBAAwB,YAAW,wBAAwB;IACpE,SAAS,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAE9C,SAAS,CAAC,cAAc,EAAE,eAAe,CAAC;IAE1C,SAAS,CAAC,gBAAgB,EAAE,uBAAuB,CAAC;IAEpD,SAAS,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE5C,SAAS,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;IAEvC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;gBAEtB,GAAG,EAAE,8BAA8B;IASzC,MAAM,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA+GtE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2B/E;;;;;OAKG;IACH,SAAS,CAAC,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO;IAcvE;;;;OAIG;IACH,SAAS,CAAC,yBAAyB,CAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,SAAS,EAAE,MAAM,GAClB,OAAO;CAkBb"}