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

package/dist/adapters/http/middleware/built-in/authorization/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../../../src/adapters/http/middleware/built-in/authorization/module.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAO5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAEH,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAEjC,MAAM,OAAO,CAAC;AAOf,OAAO,KAAK,EACR,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EAClB,MAAM,8BAA8B,CAAC;AAQtC,OAAO,KAAK,EAAE,kCAAkC,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAEzG,qBAAa,uBAAuB;IAChC,SAAS,CAAC,OAAO,EAAE,kCAAkC,CAAC;IAItD,SAAS,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IAEpD,SAAS,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IAIpD,SAAS,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAE9C,SAAS,CAAC,cAAc,EAAG,eAAe,CAAC;IAI3C,SAAS,CAAC,mBAAmB,EAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAElE,SAAS,CAAC,kBAAkB,EAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAEhE,SAAS,CAAC,iBAAiB,EAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;gBAIlD,GAAG,EAAE,kCAAkC;IAsB7C,GAAG,CAAC,KAAK,EAAE,SAAS;IA2B1B;;OAEG;cACa,+BAA+B,CAC3C,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,yBAAyB;cAwDrB,8BAA8B,CAC1C,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,wBAAwB;CA+CvC"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../../../src/adapters/http/middleware/built-in/authorization/module.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAM5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAOxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAEH,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAEjC,MAAM,OAAO,CAAC;AAQf,OAAO,KAAK,EACR,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EAClB,MAAM,8BAA8B,CAAC;AAYtC,OAAO,KAAK,EAAE,kCAAkC,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAEzG,qBAAa,uBAAuB;IAChC,SAAS,CAAC,OAAO,EAAE,kCAAkC,CAAC;IAItD,SAAS,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IAEpD,SAAS,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IAIpD,SAAS,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAE9C,SAAS,CAAC,cAAc,EAAG,eAAe,CAAC;IAI3C,SAAS,CAAC,mBAAmB,EAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAElE,SAAS,CAAC,kBAAkB,EAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAEhE,SAAS,CAAC,iBAAiB,EAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;gBAIlD,GAAG,EAAE,kCAAkC;IAsB7C,GAAG,CAAC,KAAK,EAAE,SAAS;IA2B1B;;OAEG;cACa,+BAA+B,CAC3C,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,yBAAyB;cAgErB,wBAAwB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBtG;;;;;;;;;OASG;cACa,oBAAoB,CAChC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,kBAAkB;cAsDf,8BAA8B,CAC1C,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,wBAAwB;CA+CvC"}

package/dist/adapters/http/middleware/built-in/authorization/module.mjs

@@ -4,18 +4,22 @@ import.meta.url;
 import { ClientAuthenticator } from "../../../../../core/authentication/entities/client/module.mjs";
 import { RobotAuthenticator } from "../../../../../core/authentication/entities/robot/module.mjs";
 import { UserAuthenticator } from "../../../../../core/authentication/entities/user/module.mjs";
+import { assertClientCertificateEvidenceValidForBinding } from "../../../../../core/client-certificate/module.mjs";
 import { PolicyEngine as PolicyEngine$1 } from "../../../../../core/security/policy/engine.mjs";
 import "../../../../../core/index.mjs";
+import { extractClientCertificateEvidence } from "../../../request/client-certificate.mjs";
 import { setRequestPermissionEvaluator } from "../../../request/permission/helper.mjs";
-import { setRequestIdentity } from "../../../request/helpers/identity.mjs";
+import { RequestIdentity, setRequestIdentity } from "../../../request/helpers/identity.mjs";
+import { setRequestMfaLoginTicket } from "../../../request/helpers/mfa-login-ticket.mjs";
 import { setRequestScopes } from "../../../request/helpers/scopes.mjs";
+import { setRequestSessionId } from "../../../request/helpers/session-id.mjs";
 import { setRequestToken } from "../../../request/helpers/token.mjs";
 import { RequestPermissionEvaluator } from "../../../request/permission/module.mjs";
 import "../../../request/index.mjs";
 import { IdentityType, ScopeName } from "@authup/core-kit";
 import { PermissionEvaluator } from "@authup/access";
 import { AuthHeaderError } from "@authup/errors";
-import { JWTError, OAuth2TokenKind, deserializeOAuth2Scope } from "@authup/specs";
+import { JWTError, OAuth2SubKind, OAuth2TokenKind, deserializeOAuth2Scope } from "@authup/specs";
 import { AuthorizationHeaderType, parseAuthorizationHeader } from "hapic";
 //#region src/adapters/http/middleware/built-in/authorization/module.ts
 var AuthorizationMiddleware = class {
@@ -61,6 +65,11 @@ var AuthorizationMiddleware = class {
 	* @throws JWTError
 	*/ async verifyBearerAuthorizationHeader(event, header) {
 		const payload = await this.oauth2TokenVerifier.verify(header.token);
+		await this.verifyCertificateBinding(event, payload);
+		if (payload.kind === OAuth2TokenKind.MFA) {
+			await this.verifyMfaLoginTicket(event, payload);
+			return;
+		}
 		if (payload.kind !== OAuth2TokenKind.ACCESS) throw JWTError.payloadPropertyInvalid("kind");
 		if (!payload.realm_id) throw JWTError.payloadPropertyInvalid("realm_id");
 		setRequestToken(event, header.token);
@@ -74,11 +83,54 @@ var AuthorizationMiddleware = class {
 			throw JWTError.expired();
 		}
 		await this.sessionManager.ping(session);
+		setRequestSessionId(event, payload.session_id);
 		if (!payload.sub_kind) throw JWTError.payloadPropertyInvalid("sub_kind");
 		if (!payload.sub) throw JWTError.payloadPropertyInvalid("sub");
 		const identity = await this.identityResolver.resolve(payload.sub_kind, payload.sub);
 		if (identity) setRequestIdentity(event, identity);
 	}
+	async verifyCertificateBinding(event, payload) {
+		if (!payload.cnf) return;
+		const expectedThumbprint = payload.cnf["x5t#S256"];
+		if (typeof expectedThumbprint !== "string" || expectedThumbprint.length === 0) throw JWTError.invalid();
+		try {
+			const evidence = await extractClientCertificateEvidence(event, this.options.certificateSource ?? "disabled");
+			if (!evidence || evidence.thumbprint !== expectedThumbprint) throw JWTError.invalid();
+			assertClientCertificateEvidenceValidForBinding(evidence);
+		} catch {
+			throw JWTError.invalid();
+		}
+	}
+	/**
+	* An "MFA-pending" login ticket (issue #3242). Verified with the same
+	* rigor as an access token (session existence + subject match), but
+	* stashed on a DEDICATED request slot — the main identity / scope /
+	* session slots stay empty, so every identity-gated route rejects a
+	* ticket bearer (default-deny); only the challenge routes opt in via
+	* useRequestMfaLoginTicket.
+	*
+	* @throws JWTError
+	*/ async verifyMfaLoginTicket(event, payload) {
+		if (payload.sub_kind !== OAuth2SubKind.USER) throw JWTError.payloadPropertyInvalid("sub_kind");
+		if (!payload.sub) throw JWTError.payloadPropertyInvalid("sub");
+		if (!payload.realm_id) throw JWTError.payloadPropertyInvalid("realm_id");
+		if (!payload.session_id) throw JWTError.payloadPropertyInvalid("session_id");
+		const session = await this.sessionManager.findOneById(payload.session_id);
+		if (!session) throw JWTError.expired();
+		try {
+			await this.sessionManager.verify(session);
+		} catch {
+			throw JWTError.expired();
+		}
+		if (session.sub !== payload.sub || session.sub_kind !== IdentityType.USER) throw JWTError.expired();
+		await this.sessionManager.ping(session);
+		const identity = await this.identityResolver.resolve(payload.sub_kind, payload.sub);
+		if (!identity) throw JWTError.expired();
+		setRequestMfaLoginTicket(event, {
+			identity: new RequestIdentity(identity),
+			payload
+		});
+	}
 	async verifyBasicAuthorizationHeader(event, header) {
 		if (this.options.clientAuthBasic) {
 			const authenticator = await this.clientAuthenticator.safeAuthenticate(header.username, header.password);

package/dist/adapters/http/middleware/built-in/authorization/module.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"module.mjs","names":["PermissionEvaluator","IdentityType","ScopeName","AuthHeaderError","JWTError","OAuth2TokenKind","deserializeOAuth2Scope","AuthorizationHeaderType","parseAuthorizationHeader","ClientAuthenticator","PolicyEngine","RobotAuthenticator","UserAuthenticator","RequestPermissionEvaluator","setRequestIdentity","setRequestPermissionEvaluator","setRequestScopes","setRequestToken","AuthorizationMiddleware","options","oauth2TokenVerifier","permissionEvaluator","identityResolver","sessionManager","clientAuthenticator","robotAuthenticator","userAuthenticator","ctx","provider","permissionProvider","policyEngine","identityPermissionProvider","realmId","clientId","run","event","requestAccessContext","headerValue","headers","get","header","type","BEARER","verifyBearerAuthorizationHeader","BASIC","verifyBasicAuthorizationHeader","unsupportedType","payload","verify","token","kind","ACCESS","payloadPropertyInvalid","realm_id","scope","session_id","session","findOneById","expired","ping","sub_kind","sub","identity","resolve","clientAuthBasic","authenticator","safeAuthenticate","username","password","success","GLOBAL","CLIENT","data","userAuthBasic","authenticated","USER","robotAuthBasic","ROBOT"],"sources":["../../../../../../src/adapters/http/middleware/built-in/authorization/module.ts"],"sourcesContent":["/*\n * Copyright (c) 2025.\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 { IPermissionEvaluator } from '@authup/access';\nimport { PermissionEvaluator } from '@authup/access';\nimport type { Client, Robot, User } from '@authup/core-kit';\nimport {\n    IdentityType,\n    ScopeName,\n} from '@authup/core-kit';\nimport { AuthHeaderError } from '@authup/errors';\nimport { JWTError, OAuth2TokenKind, deserializeOAuth2Scope } from '@authup/specs';\nimport type { IAppEvent } from 'routup';\nimport {\n    AuthorizationHeaderType,\n    type BasicAuthorizationHeader,\n    type BearerAuthorizationHeader,\n    parseAuthorizationHeader,\n} from 'hapic';\nimport {\n    ClientAuthenticator,\n    PolicyEngine,\n    RobotAuthenticator,\n    UserAuthenticator, \n} from '../../../../../core/index.ts';\nimport type {\n    ICredentialsAuthenticator, \n    IIdentityResolver,\n    IOAuth2TokenVerifier, \n    ISessionManager,\n} from '../../../../../core/index.ts';\nimport {\n    RequestPermissionEvaluator,\n    setRequestIdentity,\n    setRequestPermissionEvaluator,\n    setRequestScopes,\n    setRequestToken,\n} from '../../../request/index.ts';\nimport type { HTTPAuthorizationMiddlewareContext, HTTPAuthorizationMiddlewareOptions } from './types.ts';\n\nexport class AuthorizationMiddleware {\n    protected options: HTTPAuthorizationMiddlewareOptions;\n\n    // --------------------------------------\n\n    protected oauth2TokenVerifier: IOAuth2TokenVerifier;\n\n    protected permissionEvaluator: IPermissionEvaluator;\n\n    // --------------------------------------\n\n    protected identityResolver: IIdentityResolver;\n\n    protected sessionManager : ISessionManager;\n\n    // --------------------------------------\n\n    protected clientAuthenticator : ICredentialsAuthenticator<Client>;\n\n    protected robotAuthenticator : ICredentialsAuthenticator<Robot>;\n\n    protected userAuthenticator : ICredentialsAuthenticator<User>;\n\n    // --------------------------------------\n\n    constructor(ctx: HTTPAuthorizationMiddlewareContext) {\n        this.options = ctx.options || {};\n\n        this.identityResolver = ctx.identityResolver;\n        this.sessionManager = ctx.sessionManager;\n\n        this.clientAuthenticator = new ClientAuthenticator(ctx.identityResolver);\n        this.robotAuthenticator = new RobotAuthenticator(ctx.identityResolver);\n        this.userAuthenticator = new UserAuthenticator(ctx.identityResolver);\n\n        this.oauth2TokenVerifier = ctx.oauth2TokenVerifier;\n\n        this.permissionEvaluator = new PermissionEvaluator({\n            provider: ctx.permissionProvider,\n            policyEngine: new PolicyEngine(ctx.identityPermissionProvider),\n            realmId: null,\n            clientId: null,\n        });\n    }\n\n    // --------------------------------------\n\n    async run(event: IAppEvent) {\n        const requestAccessContext = new RequestPermissionEvaluator(\n            event,\n            this.permissionEvaluator,\n        );\n        setRequestPermissionEvaluator(event, requestAccessContext);\n\n        const headerValue = event.headers.get('authorization');\n        if (!headerValue) {\n            return;\n        }\n\n        const header = parseAuthorizationHeader(headerValue);\n\n        if (header.type === AuthorizationHeaderType.BEARER) {\n            await this.verifyBearerAuthorizationHeader(event, header);\n            return;\n        }\n\n        if (header.type === AuthorizationHeaderType.BASIC) {\n            await this.verifyBasicAuthorizationHeader(event, header);\n            return;\n        }\n\n        throw AuthHeaderError.unsupportedType(header.type);\n    }\n\n    /**\n     * @throws JWTError\n     */\n    protected async verifyBearerAuthorizationHeader(\n        event: IAppEvent,\n        header: BearerAuthorizationHeader,\n    ) {\n        const payload = await this.oauth2TokenVerifier.verify(header.token);\n        if (payload.kind !== OAuth2TokenKind.ACCESS) {\n            throw JWTError.payloadPropertyInvalid('kind');\n        }\n\n        if (!payload.realm_id) {\n            throw JWTError.payloadPropertyInvalid('realm_id');\n        }\n\n        setRequestToken(event, header.token);\n\n        if (payload.scope) {\n            setRequestScopes(event, deserializeOAuth2Scope(payload.scope));\n        }\n\n        // -------------------------------------------------------\n\n        if (!payload.session_id) {\n            throw JWTError.payloadPropertyInvalid('session_id');\n        }\n\n        const session = await this.sessionManager.findOneById(payload.session_id);\n        if (!session) {\n            throw JWTError.expired();\n        }\n\n        try {\n            await this.sessionManager.verify(session);\n        } catch {\n            throw JWTError.expired();\n        }\n\n        await this.sessionManager.ping(session);\n\n        // -------------------------------------------------------\n\n        if (!payload.sub_kind) {\n            throw JWTError.payloadPropertyInvalid('sub_kind');\n        }\n\n        if (!payload.sub) {\n            throw JWTError.payloadPropertyInvalid('sub');\n        }\n\n        const identity = await this.identityResolver.resolve(\n            payload.sub_kind,\n            payload.sub,\n        );\n\n        if (identity) {\n            setRequestIdentity(event, identity);\n        }\n    }\n\n    protected async verifyBasicAuthorizationHeader(\n        event: IAppEvent,\n        header: BasicAuthorizationHeader,\n    ) {\n        if (this.options.clientAuthBasic) {\n            const authenticator = await this.clientAuthenticator.safeAuthenticate(\n                header.username,\n                header.password,\n            );\n            if (authenticator.success) {\n                setRequestScopes(event, [ScopeName.GLOBAL]);\n                setRequestIdentity(event, {\n                    type: IdentityType.CLIENT,\n                    data: authenticator.data,\n                });\n            }\n        }\n\n        if (this.options.userAuthBasic) {\n            const authenticated = await this.userAuthenticator.safeAuthenticate(\n                header.username,\n                header.password,\n            );\n\n            if (authenticated.success) {\n                setRequestScopes(event, [ScopeName.GLOBAL]);\n                setRequestIdentity(event, {\n                    type: IdentityType.USER,\n                    data: authenticated.data,\n                });\n\n                return;\n            }\n        }\n\n        if (this.options.robotAuthBasic) {\n            const authenticated = await this.robotAuthenticator.safeAuthenticate(\n                header.username,\n                header.password,\n            );\n            if (authenticated.success) {\n                setRequestScopes(event, [ScopeName.GLOBAL]);\n                setRequestIdentity(event, {\n                    type: IdentityType.ROBOT,\n                    data: authenticated.data,\n                });\n            }\n        }\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA4CA,IAAakB,0BAAb,MAAaA;CACCC;CAIAC;CAEAC;CAIAC;CAEAC;CAIAC;CAEAC;CAEAC;CAIV,YAAYC,KAAyC;EACjD,KAAKR,UAAUQ,IAAIR,WAAW,CAAC;EAE/B,KAAKG,mBAAmBK,IAAIL;EAC5B,KAAKC,iBAAiBI,IAAIJ;EAE1B,KAAKC,sBAAsB,IAAIf,oBAAoBkB,IAAIL,gBAAgB;EACvE,KAAKG,qBAAqB,IAAId,mBAAmBgB,IAAIL,gBAAgB;EACrE,KAAKI,oBAAoB,IAAId,kBAAkBe,IAAIL,gBAAgB;EAEnE,KAAKF,sBAAsBO,IAAIP;EAE/B,KAAKC,sBAAsB,IAAIrB,oBAAoB;GAC/C4B,UAAUD,IAAIE;GACdC,cAAc,IAAIpB,eAAaiB,IAAII,0BAA0B;GAC7DC,SAAS;GACTC,UAAU;EACd,CAAA;CACJ;CAIA,MAAMC,IAAIC,OAAkB;EAKxBpB,8BAA8BoB,OAAOC,IAJJvB,2BAC7BsB,OACA,KAAKd,mBAE4Be,CAAAA;EAErC,MAAMC,cAAcF,MAAMG,QAAQC,IAAI,eAAA;EACtC,IAAI,CAACF,aACD;EAGJ,MAAMG,SAAShC,yBAAyB6B,WAAAA;EAExC,IAAIG,OAAOC,SAASlC,wBAAwBmC,QAAQ;GAChD,MAAM,KAAKC,gCAAgCR,OAAOK,MAAAA;GAClD;EACJ;EAEA,IAAIA,OAAOC,SAASlC,wBAAwBqC,OAAO;GAC/C,MAAM,KAAKC,+BAA+BV,OAAOK,MAAAA;GACjD;EACJ;EAEA,MAAMrC,gBAAgB2C,gBAAgBN,OAAOC,IAAI;CACrD;;;IAKA,MAAgBE,gCACZR,OACAK,QACF;EACE,MAAMO,UAAU,MAAM,KAAK3B,oBAAoB4B,OAAOR,OAAOS,KAAK;EAClE,IAAIF,QAAQG,SAAS7C,gBAAgB8C,QACjC,MAAM/C,SAASgD,uBAAuB,MAAA;EAG1C,IAAI,CAACL,QAAQM,UACT,MAAMjD,SAASgD,uBAAuB,UAAA;EAG1CnC,gBAAgBkB,OAAOK,OAAOS,KAAK;EAEnC,IAAIF,QAAQO,OACRtC,iBAAiBmB,OAAO7B,uBAAuByC,QAAQO,KAAK,CAAA;EAKhE,IAAI,CAACP,QAAQQ,YACT,MAAMnD,SAASgD,uBAAuB,YAAA;EAG1C,MAAMI,UAAU,MAAM,KAAKjC,eAAekC,YAAYV,QAAQQ,UAAU;EACxE,IAAI,CAACC,SACD,MAAMpD,SAASsD,QAAO;EAG1B,IAAI;GACA,MAAM,KAAKnC,eAAeyB,OAAOQ,OAAAA;EACrC,QAAQ;GACJ,MAAMpD,SAASsD,QAAO;EAC1B;EAEA,MAAM,KAAKnC,eAAeoC,KAAKH,OAAAA;EAI/B,IAAI,CAACT,QAAQa,UACT,MAAMxD,SAASgD,uBAAuB,UAAA;EAG1C,IAAI,CAACL,QAAQc,KACT,MAAMzD,SAASgD,uBAAuB,KAAA;EAG1C,MAAMU,WAAW,MAAM,KAAKxC,iBAAiByC,QACzChB,QAAQa,UACRb,QAAQc,GAAG;EAGf,IAAIC,UACAhD,mBAAmBqB,OAAO2B,QAAAA;CAElC;CAEA,MAAgBjB,+BACZV,OACAK,QACF;EACE,IAAI,KAAKrB,QAAQ6C,iBAAiB;GAC9B,MAAMC,gBAAgB,MAAM,KAAKzC,oBAAoB0C,iBACjD1B,OAAO2B,UACP3B,OAAO4B,QAAQ;GAEnB,IAAIH,cAAcI,SAAS;IACvBrD,iBAAiBmB,OAAO,CAACjC,UAAUoE,MAAAA,CAAO;IAC1CxD,mBAAmBqB,OAAO;KACtBM,MAAMxC,aAAasE;KACnBC,MAAMP,cAAcO;IACxB,CAAA;GACJ;EACJ;EAEA,IAAI,KAAKrD,QAAQsD,eAAe;GAC5B,MAAMC,gBAAgB,MAAM,KAAKhD,kBAAkBwC,iBAC/C1B,OAAO2B,UACP3B,OAAO4B,QAAQ;GAGnB,IAAIM,cAAcL,SAAS;IACvBrD,iBAAiBmB,OAAO,CAACjC,UAAUoE,MAAAA,CAAO;IAC1CxD,mBAAmBqB,OAAO;KACtBM,MAAMxC,aAAa0E;KACnBH,MAAME,cAAcF;IACxB,CAAA;IAEA;GACJ;EACJ;EAEA,IAAI,KAAKrD,QAAQyD,gBAAgB;GAC7B,MAAMF,gBAAgB,MAAM,KAAKjD,mBAAmByC,iBAChD1B,OAAO2B,UACP3B,OAAO4B,QAAQ;GAEnB,IAAIM,cAAcL,SAAS;IACvBrD,iBAAiBmB,OAAO,CAACjC,UAAUoE,MAAAA,CAAO;IAC1CxD,mBAAmBqB,OAAO;KACtBM,MAAMxC,aAAa4E;KACnBL,MAAME,cAAcF;IACxB,CAAA;GACJ;EACJ;CACJ;AACJ"}
+{"version":3,"file":"module.mjs","names":["PermissionEvaluator","IdentityType","ScopeName","AuthHeaderError","JWTError","OAuth2SubKind","OAuth2TokenKind","deserializeOAuth2Scope","AuthorizationHeaderType","parseAuthorizationHeader","ClientAuthenticator","PolicyEngine","RobotAuthenticator","UserAuthenticator","assertClientCertificateEvidenceValidForBinding","RequestIdentity","RequestPermissionEvaluator","extractClientCertificateEvidence","setRequestIdentity","setRequestMfaLoginTicket","setRequestPermissionEvaluator","setRequestScopes","setRequestSessionId","setRequestToken","AuthorizationMiddleware","options","oauth2TokenVerifier","permissionEvaluator","identityResolver","sessionManager","clientAuthenticator","robotAuthenticator","userAuthenticator","ctx","provider","permissionProvider","policyEngine","identityPermissionProvider","realmId","clientId","run","event","requestAccessContext","headerValue","headers","get","header","type","BEARER","verifyBearerAuthorizationHeader","BASIC","verifyBasicAuthorizationHeader","unsupportedType","payload","verify","token","verifyCertificateBinding","kind","MFA","verifyMfaLoginTicket","ACCESS","payloadPropertyInvalid","realm_id","scope","session_id","session","findOneById","expired","ping","sub_kind","sub","identity","resolve","cnf","expectedThumbprint","length","invalid","evidence","certificateSource","thumbprint","USER","clientAuthBasic","authenticator","safeAuthenticate","username","password","success","GLOBAL","CLIENT","data","userAuthBasic","authenticated","robotAuthBasic","ROBOT"],"sources":["../../../../../../src/adapters/http/middleware/built-in/authorization/module.ts"],"sourcesContent":["/*\n * Copyright (c) 2025.\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 { IPermissionEvaluator } from '@authup/access';\nimport { PermissionEvaluator } from '@authup/access';\nimport type { Client, Robot, User } from '@authup/core-kit';\nimport {\n    IdentityType,\n    ScopeName,\n} from '@authup/core-kit';\nimport { AuthHeaderError } from '@authup/errors';\nimport type { OAuth2TokenPayload } from '@authup/specs';\nimport {\n    JWTError,\n    OAuth2SubKind,\n    OAuth2TokenKind,\n    deserializeOAuth2Scope,\n} from '@authup/specs';\nimport type { IAppEvent } from 'routup';\nimport {\n    AuthorizationHeaderType,\n    type BasicAuthorizationHeader,\n    type BearerAuthorizationHeader,\n    parseAuthorizationHeader,\n} from 'hapic';\nimport {\n    ClientAuthenticator,\n    PolicyEngine,\n    RobotAuthenticator,\n    UserAuthenticator,\n    assertClientCertificateEvidenceValidForBinding,\n} from '../../../../../core/index.ts';\nimport type {\n    ICredentialsAuthenticator,\n    IIdentityResolver,\n    IOAuth2TokenVerifier,\n    ISessionManager,\n} from '../../../../../core/index.ts';\nimport {\n    RequestIdentity,\n    RequestPermissionEvaluator,\n    extractClientCertificateEvidence,\n    setRequestIdentity,\n    setRequestMfaLoginTicket,\n    setRequestPermissionEvaluator,\n    setRequestScopes,\n    setRequestSessionId,\n    setRequestToken,\n} from '../../../request/index.ts';\nimport type { HTTPAuthorizationMiddlewareContext, HTTPAuthorizationMiddlewareOptions } from './types.ts';\n\nexport class AuthorizationMiddleware {\n    protected options: HTTPAuthorizationMiddlewareOptions;\n\n    // --------------------------------------\n\n    protected oauth2TokenVerifier: IOAuth2TokenVerifier;\n\n    protected permissionEvaluator: IPermissionEvaluator;\n\n    // --------------------------------------\n\n    protected identityResolver: IIdentityResolver;\n\n    protected sessionManager : ISessionManager;\n\n    // --------------------------------------\n\n    protected clientAuthenticator : ICredentialsAuthenticator<Client>;\n\n    protected robotAuthenticator : ICredentialsAuthenticator<Robot>;\n\n    protected userAuthenticator : ICredentialsAuthenticator<User>;\n\n    // --------------------------------------\n\n    constructor(ctx: HTTPAuthorizationMiddlewareContext) {\n        this.options = ctx.options || {};\n\n        this.identityResolver = ctx.identityResolver;\n        this.sessionManager = ctx.sessionManager;\n\n        this.clientAuthenticator = new ClientAuthenticator(ctx.identityResolver);\n        this.robotAuthenticator = new RobotAuthenticator(ctx.identityResolver);\n        this.userAuthenticator = new UserAuthenticator(ctx.identityResolver);\n\n        this.oauth2TokenVerifier = ctx.oauth2TokenVerifier;\n\n        this.permissionEvaluator = new PermissionEvaluator({\n            provider: ctx.permissionProvider,\n            policyEngine: new PolicyEngine(ctx.identityPermissionProvider),\n            realmId: null,\n            clientId: null,\n        });\n    }\n\n    // --------------------------------------\n\n    async run(event: IAppEvent) {\n        const requestAccessContext = new RequestPermissionEvaluator(\n            event,\n            this.permissionEvaluator,\n        );\n        setRequestPermissionEvaluator(event, requestAccessContext);\n\n        const headerValue = event.headers.get('authorization');\n        if (!headerValue) {\n            return;\n        }\n\n        const header = parseAuthorizationHeader(headerValue);\n\n        if (header.type === AuthorizationHeaderType.BEARER) {\n            await this.verifyBearerAuthorizationHeader(event, header);\n            return;\n        }\n\n        if (header.type === AuthorizationHeaderType.BASIC) {\n            await this.verifyBasicAuthorizationHeader(event, header);\n            return;\n        }\n\n        throw AuthHeaderError.unsupportedType(header.type);\n    }\n\n    /**\n     * @throws JWTError\n     */\n    protected async verifyBearerAuthorizationHeader(\n        event: IAppEvent,\n        header: BearerAuthorizationHeader,\n    ) {\n        const payload = await this.oauth2TokenVerifier.verify(header.token);\n        await this.verifyCertificateBinding(event, payload);\n        if (payload.kind === OAuth2TokenKind.MFA) {\n            await this.verifyMfaLoginTicket(event, payload);\n            return;\n        }\n\n        if (payload.kind !== OAuth2TokenKind.ACCESS) {\n            throw JWTError.payloadPropertyInvalid('kind');\n        }\n\n        if (!payload.realm_id) {\n            throw JWTError.payloadPropertyInvalid('realm_id');\n        }\n\n        setRequestToken(event, header.token);\n\n        if (payload.scope) {\n            setRequestScopes(event, deserializeOAuth2Scope(payload.scope));\n        }\n\n        // -------------------------------------------------------\n\n        if (!payload.session_id) {\n            throw JWTError.payloadPropertyInvalid('session_id');\n        }\n\n        const session = await this.sessionManager.findOneById(payload.session_id);\n        if (!session) {\n            throw JWTError.expired();\n        }\n\n        try {\n            await this.sessionManager.verify(session);\n        } catch {\n            throw JWTError.expired();\n        }\n\n        await this.sessionManager.ping(session);\n\n        setRequestSessionId(event, payload.session_id);\n\n        // -------------------------------------------------------\n\n        if (!payload.sub_kind) {\n            throw JWTError.payloadPropertyInvalid('sub_kind');\n        }\n\n        if (!payload.sub) {\n            throw JWTError.payloadPropertyInvalid('sub');\n        }\n\n        const identity = await this.identityResolver.resolve(\n            payload.sub_kind,\n            payload.sub,\n        );\n\n        if (identity) {\n            setRequestIdentity(event, identity);\n        }\n    }\n\n    protected async verifyCertificateBinding(event: IAppEvent, payload: OAuth2TokenPayload): Promise<void> {\n        if (!payload.cnf) {\n            return;\n        }\n\n        const expectedThumbprint = payload.cnf['x5t#S256'];\n        if (typeof expectedThumbprint !== 'string' || expectedThumbprint.length === 0) {\n            throw JWTError.invalid();\n        }\n\n        try {\n            const evidence = await extractClientCertificateEvidence(\n                event,\n                this.options.certificateSource ?? 'disabled',\n            );\n            if (!evidence || evidence.thumbprint !== expectedThumbprint) {\n                throw JWTError.invalid();\n            }\n\n            assertClientCertificateEvidenceValidForBinding(evidence);\n        } catch {\n            throw JWTError.invalid();\n        }\n    }\n\n    /**\n     * An \"MFA-pending\" login ticket (issue #3242). Verified with the same\n     * rigor as an access token (session existence + subject match), but\n     * stashed on a DEDICATED request slot — the main identity / scope /\n     * session slots stay empty, so every identity-gated route rejects a\n     * ticket bearer (default-deny); only the challenge routes opt in via\n     * useRequestMfaLoginTicket.\n     *\n     * @throws JWTError\n     */\n    protected async verifyMfaLoginTicket(\n        event: IAppEvent,\n        payload: OAuth2TokenPayload,\n    ) {\n        if (payload.sub_kind !== OAuth2SubKind.USER) {\n            throw JWTError.payloadPropertyInvalid('sub_kind');\n        }\n\n        if (!payload.sub) {\n            throw JWTError.payloadPropertyInvalid('sub');\n        }\n\n        if (!payload.realm_id) {\n            throw JWTError.payloadPropertyInvalid('realm_id');\n        }\n\n        if (!payload.session_id) {\n            throw JWTError.payloadPropertyInvalid('session_id');\n        }\n\n        const session = await this.sessionManager.findOneById(payload.session_id);\n        if (!session) {\n            throw JWTError.expired();\n        }\n\n        try {\n            await this.sessionManager.verify(session);\n        } catch {\n            throw JWTError.expired();\n        }\n\n        // defense in depth — the pending session must still belong to the\n        // ticket subject.\n        if (\n            session.sub !== payload.sub ||\n            session.sub_kind !== IdentityType.USER\n        ) {\n            throw JWTError.expired();\n        }\n\n        await this.sessionManager.ping(session);\n\n        const identity = await this.identityResolver.resolve(\n            payload.sub_kind,\n            payload.sub,\n        );\n        if (!identity) {\n            throw JWTError.expired();\n        }\n\n        setRequestMfaLoginTicket(event, {\n            identity: new RequestIdentity(identity),\n            payload,\n        });\n    }\n\n    protected async verifyBasicAuthorizationHeader(\n        event: IAppEvent,\n        header: BasicAuthorizationHeader,\n    ) {\n        if (this.options.clientAuthBasic) {\n            const authenticator = await this.clientAuthenticator.safeAuthenticate(\n                header.username,\n                header.password,\n            );\n            if (authenticator.success) {\n                setRequestScopes(event, [ScopeName.GLOBAL]);\n                setRequestIdentity(event, {\n                    type: IdentityType.CLIENT,\n                    data: authenticator.data,\n                });\n            }\n        }\n\n        if (this.options.userAuthBasic) {\n            const authenticated = await this.userAuthenticator.safeAuthenticate(\n                header.username,\n                header.password,\n            );\n\n            if (authenticated.success) {\n                setRequestScopes(event, [ScopeName.GLOBAL]);\n                setRequestIdentity(event, {\n                    type: IdentityType.USER,\n                    data: authenticated.data,\n                });\n\n                return;\n            }\n        }\n\n        if (this.options.robotAuthBasic) {\n            const authenticated = await this.robotAuthenticator.safeAuthenticate(\n                header.username,\n                header.password,\n            );\n            if (authenticated.success) {\n                setRequestScopes(event, [ScopeName.GLOBAL]);\n                setRequestIdentity(event, {\n                    type: IdentityType.ROBOT,\n                    data: authenticated.data,\n                });\n            }\n        }\n    }\n}\n"],"mappings":"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"}

package/dist/adapters/http/middleware/built-in/authorization/types.d.ts

@@ -1,9 +1,11 @@
 import type { IPermissionProvider } from '@authup/access';
 import type { IIdentityPermissionProvider, IIdentityResolver, IOAuth2TokenVerifier, ISessionManager } from '../../../../../core/index.ts';
+import type { CertificateSource } from '../../../request/index.ts';
 export type HTTPAuthorizationMiddlewareOptions = {
     clientAuthBasic?: boolean;
     robotAuthBasic?: boolean;
     userAuthBasic?: boolean;
+    certificateSource?: CertificateSource;
 };
 export type HTTPAuthorizationMiddlewareContext = {
     identityResolver: IIdentityResolver;

package/dist/adapters/http/middleware/built-in/authorization/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/adapters/http/middleware/built-in/authorization/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAER,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EAClB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,kCAAkC,GAAG;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC7C,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,0BAA0B,EAAE,2BAA2B,CAAC;IACxD,cAAc,EAAE,eAAe,CAAC;IAChC,mBAAmB,EAAE,oBAAoB,CAAC;IAC1C,kBAAkB,EAAE,mBAAmB,CAAC;IAExC,OAAO,CAAC,EAAE,kCAAkC,CAAA;CAC/C,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/adapters/http/middleware/built-in/authorization/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAER,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,MAAM,kCAAkC,GAAG;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC7C,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,0BAA0B,EAAE,2BAA2B,CAAC;IACxD,cAAc,EAAE,eAAe,CAAC;IAChC,mBAAmB,EAAE,oBAAoB,CAAC;IAC1C,kBAAkB,EAAE,mBAAmB,CAAC;IAExC,OAAO,CAAC,EAAE,kCAAkC,CAAA;CAC/C,CAAC"}

package/dist/adapters/http/middleware/built-in/index.mjs

@@ -14,9 +14,9 @@ import { VITE_SERVER_STORE_KEY, registerAssetsMiddleware } from "./assets.mjs";
 import { registerBasicMiddleware } from "./basic.mjs";
 import { registerCorsMiddleware } from "./cors.mjs";
 import { registerErrorMiddleware } from "./error.mjs";
-import { createLoggerMiddleware } from "./logger.mjs";
-import { registerPrometheusMiddleware } from "./prometheus.mjs";
+import { createLoggerMiddleware, redactSensitiveURLParams } from "./logger.mjs";
+import { createRouteTemplateNormalizePath, registerPrometheusMiddleware } from "./prometheus.mjs";
 import { registerRateLimitMiddleware } from "./rate-limit.mjs";
 import { createSwaggerMiddleware } from "./swagger.mjs";
 import { UI_HTTP_CLIENT_FACTORY_STORE_KEY, registerUIHttpClientMiddleware } from "./ui-http-client.mjs";
-export { AuthorizationMiddleware, ForceLoggedInMiddleware, ForceUserLoggedInMiddleware, RealmResolverMiddleware, UI_HTTP_CLIENT_FACTORY_STORE_KEY, VITE_SERVER_STORE_KEY, createAuthorizationMiddleware, createLoggerMiddleware, createRealmResolverMiddleware, createSwaggerMiddleware, registerAssetsMiddleware, registerBasicMiddleware, registerCorsMiddleware, registerErrorMiddleware, registerPrometheusMiddleware, registerRateLimitMiddleware, registerUIHttpClientMiddleware };
+export { AuthorizationMiddleware, ForceLoggedInMiddleware, ForceUserLoggedInMiddleware, RealmResolverMiddleware, UI_HTTP_CLIENT_FACTORY_STORE_KEY, VITE_SERVER_STORE_KEY, createAuthorizationMiddleware, createLoggerMiddleware, createRealmResolverMiddleware, createRouteTemplateNormalizePath, createSwaggerMiddleware, redactSensitiveURLParams, registerAssetsMiddleware, registerBasicMiddleware, registerCorsMiddleware, registerErrorMiddleware, registerPrometheusMiddleware, registerRateLimitMiddleware, registerUIHttpClientMiddleware };

package/dist/adapters/http/middleware/built-in/logger.d.ts

@@ -4,6 +4,7 @@ type LoggerMiddlewareOptions = {
     env: string;
     logger: Logger;
 };
+export declare function redactSensitiveURLParams(url: string): string;
 export declare function createLoggerMiddleware(options: LoggerMiddlewareOptions): Handler;
 export {};
 //# sourceMappingURL=logger.d.ts.map

package/dist/adapters/http/middleware/built-in/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/http/middleware/built-in/logger.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,KAAK,uBAAuB,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAA;CACjB,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAI,OAAO,CA6BjF"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/http/middleware/built-in/logger.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,KAAK,uBAAuB,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAA;CACjB,CAAC;AAeF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoB5D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAI,OAAO,CA6BjF"}

package/dist/adapters/http/middleware/built-in/logger.mjs

@@ -5,13 +5,34 @@ import { EnvironmentName } from "@authup/kit";
 import { getRequestIP } from "routup";
 import { logger } from "@routup/logger";
 //#region src/adapters/http/middleware/built-in/logger.ts
+const SENSITIVE_QUERY_PARAMS = [
+	"id_token_hint",
+	"id_token",
+	"access_token",
+	"refresh_token",
+	"token",
+	"code",
+	"client_secret"
+];
+function redactSensitiveURLParams(url) {
+	const queryIndex = url.indexOf("?");
+	if (queryIndex === -1) return url;
+	const params = new URLSearchParams(url.substring(queryIndex + 1));
+	let redacted = false;
+	for (const name of SENSITIVE_QUERY_PARAMS) if (params.has(name)) {
+		params.set(name, "***");
+		redacted = true;
+	}
+	if (!redacted) return url;
+	return `${url.substring(0, queryIndex)}?${params.toString()}`;
+}
 function createLoggerMiddleware(options) {
 	return logger({
 		format: (tokens, event, response) => [
 			getRequestIP(event) || "-",
 			"-",
 			tokens.method(event, response) ?? "-",
-			tokens.url(event, response) ?? "-",
+			redactSensitiveURLParams(tokens.url(event, response) ?? "-"),
 			tokens.status(event, response) ?? "-",
 			"-",
 			tokens["response-time"](event, response) ?? "-"
@@ -28,6 +49,6 @@ function createLoggerMiddleware(options) {
 	});
 }
 //#endregion
-export { createLoggerMiddleware };
+export { createLoggerMiddleware, redactSensitiveURLParams };
 
 //# sourceMappingURL=logger.mjs.map

package/dist/adapters/http/middleware/built-in/logger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"logger.mjs","names":["logger","getRequestIP","EnvironmentName","createLoggerMiddleware","options","format","tokens","event","response","method","url","status","join","write","line","env","TEST","http","skip","path","length","PRODUCTION"],"sources":["../../../../../src/adapters/http/middleware/built-in/logger.ts"],"sourcesContent":["/*\n * Copyright (c) 2023.\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 { logger } from '@routup/logger';\nimport type { Handler } from 'routup';\nimport { getRequestIP } from 'routup';\nimport type { Logger } from '@authup/server-kit';\nimport { EnvironmentName } from '@authup/kit';\n\ntype LoggerMiddlewareOptions = {\n    env: string,\n    logger: Logger\n};\n\nexport function createLoggerMiddleware(options: LoggerMiddlewareOptions) : Handler {\n    return logger({\n        format: (tokens, event, response) => [\n            getRequestIP(event) || '-',\n            '-',\n            tokens.method(event, response) ?? '-',\n            tokens.url(event, response) ?? '-',\n            tokens.status(event, response) ?? '-',\n            '-',\n            tokens['response-time'](event, response) ?? '-',\n        ].join(' '),\n        write(line) {\n            if (options.env !== EnvironmentName.TEST) {\n                options.logger.http(line);\n            }\n        },\n        skip(event, response): boolean {\n            const path = event.path || '';\n            if (path.length === 0 || path === '/') {\n                return true;\n            }\n\n            if (options.env === EnvironmentName.PRODUCTION) {\n                return (response?.status ?? 0) < 400;\n            }\n\n            return false;\n        },\n    });\n}\n"],"mappings":";;;;;;;AAkBA,SAAgBG,uBAAuBC,SAAgC;CACnE,OAAOJ,OAAO;EACVK,SAASC,QAAQC,OAAOC,aAAa;GACjCP,aAAaM,KAAAA,KAAU;GACvB;GACAD,OAAOG,OAAOF,OAAOC,QAAAA,KAAa;GAClCF,OAAOI,IAAIH,OAAOC,QAAAA,KAAa;GAC/BF,OAAOK,OAAOJ,OAAOC,QAAAA,KAAa;GAClC;GACAF,OAAO,gBAAgB,CAACC,OAAOC,QAAAA,KAAa;GAC/C,CAACI,KAAK,GAAA;EACPC,MAAMC,MAAI;GACN,IAAIV,QAAQW,QAAQb,gBAAgBc,MAChCZ,QAAQJ,OAAOiB,KAAKH,IAAAA;EAE5B;EACAI,KAAKX,OAAOC,UAAQ;GAChB,MAAMW,OAAOZ,MAAMY,QAAQ;GAC3B,IAAIA,KAAKC,WAAW,KAAKD,SAAS,KAC9B,OAAO;GAGX,IAAIf,QAAQW,QAAQb,gBAAgBmB,YAChC,QAAQb,UAAUG,UAAU,KAAK;GAGrC,OAAO;EACX;CACJ,CAAA;AACJ"}
+{"version":3,"file":"logger.mjs","names":["logger","getRequestIP","EnvironmentName","SENSITIVE_QUERY_PARAMS","redactSensitiveURLParams","url","queryIndex","indexOf","params","URLSearchParams","substring","redacted","name","has","set","toString","createLoggerMiddleware","options","format","tokens","event","response","method","status","join","write","line","env","TEST","http","skip","path","length","PRODUCTION"],"sources":["../../../../../src/adapters/http/middleware/built-in/logger.ts"],"sourcesContent":["/*\n * Copyright (c) 2023.\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 { logger } from '@routup/logger';\nimport type { Handler } from 'routup';\nimport { getRequestIP } from 'routup';\nimport type { Logger } from '@authup/server-kit';\nimport { EnvironmentName } from '@authup/kit';\n\ntype LoggerMiddlewareOptions = {\n    env: string,\n    logger: Logger\n};\n\n// Query params whose values are credentials/tokens — the access log must never\n// persist them (a GET /logout?id_token_hint=<jwt> would otherwise write a\n// signature-valid token into the log).\nconst SENSITIVE_QUERY_PARAMS = [\n    'id_token_hint',\n    'id_token',\n    'access_token',\n    'refresh_token',\n    'token',\n    'code',\n    'client_secret',\n];\n\nexport function redactSensitiveURLParams(url: string): string {\n    const queryIndex = url.indexOf('?');\n    if (queryIndex === -1) {\n        return url;\n    }\n\n    const params = new URLSearchParams(url.substring(queryIndex + 1));\n    let redacted = false;\n    for (const name of SENSITIVE_QUERY_PARAMS) {\n        if (params.has(name)) {\n            params.set(name, '***');\n            redacted = true;\n        }\n    }\n\n    if (!redacted) {\n        return url;\n    }\n\n    return `${url.substring(0, queryIndex)}?${params.toString()}`;\n}\n\nexport function createLoggerMiddleware(options: LoggerMiddlewareOptions) : Handler {\n    return logger({\n        format: (tokens, event, response) => [\n            getRequestIP(event) || '-',\n            '-',\n            tokens.method(event, response) ?? '-',\n            redactSensitiveURLParams(tokens.url(event, response) ?? '-'),\n            tokens.status(event, response) ?? '-',\n            '-',\n            tokens['response-time'](event, response) ?? '-',\n        ].join(' '),\n        write(line) {\n            if (options.env !== EnvironmentName.TEST) {\n                options.logger.http(line);\n            }\n        },\n        skip(event, response): boolean {\n            const path = event.path || '';\n            if (path.length === 0 || path === '/') {\n                return true;\n            }\n\n            if (options.env === EnvironmentName.PRODUCTION) {\n                return (response?.status ?? 0) < 400;\n            }\n\n            return false;\n        },\n    });\n}\n"],"mappings":";;;;;;;AAqBA,MAAMG,yBAAyB;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;;AAGJ,SAAgBC,yBAAyBC,KAAW;CAChD,MAAMC,aAAaD,IAAIE,QAAQ,GAAA;CAC/B,IAAID,eAAe,IACf,OAAOD;CAGX,MAAMG,SAAS,IAAIC,gBAAgBJ,IAAIK,UAAUJ,aAAa,CAAA,CAAA;CAC9D,IAAIK,WAAW;CACf,KAAK,MAAMC,QAAQT,wBACf,IAAIK,OAAOK,IAAID,IAAAA,GAAO;EAClBJ,OAAOM,IAAIF,MAAM,KAAA;EACjBD,WAAW;CACf;CAGJ,IAAI,CAACA,UACD,OAAON;CAGX,OAAO,GAAGA,IAAIK,UAAU,GAAGJ,UAAAA,EAAY,GAAGE,OAAOO,SAAQ;AAC7D;AAEA,SAAgBC,uBAAuBC,SAAgC;CACnE,OAAOjB,OAAO;EACVkB,SAASC,QAAQC,OAAOC,aAAa;GACjCpB,aAAamB,KAAAA,KAAU;GACvB;GACAD,OAAOG,OAAOF,OAAOC,QAAAA,KAAa;GAClCjB,yBAAyBe,OAAOd,IAAIe,OAAOC,QAAAA,KAAa,GAAA;GACxDF,OAAOI,OAAOH,OAAOC,QAAAA,KAAa;GAClC;GACAF,OAAO,gBAAgB,CAACC,OAAOC,QAAAA,KAAa;GAC/C,CAACG,KAAK,GAAA;EACPC,MAAMC,MAAI;GACN,IAAIT,QAAQU,QAAQzB,gBAAgB0B,MAChCX,QAAQjB,OAAO6B,KAAKH,IAAAA;EAE5B;EACAI,KAAKV,OAAOC,UAAQ;GAChB,MAAMU,OAAOX,MAAMW,QAAQ;GAC3B,IAAIA,KAAKC,WAAW,KAAKD,SAAS,KAC9B,OAAO;GAGX,IAAId,QAAQU,QAAQzB,gBAAgB+B,YAChC,QAAQZ,UAAUE,UAAU,KAAK;GAGrC,OAAO;EACX;CACJ,CAAA;AACJ"}

package/dist/adapters/http/middleware/built-in/prometheus.d.ts

@@ -1,4 +1,15 @@
 import type { OptionsInput } from '@routup/prometheus';
-import type { App } from 'routup';
+import type { App, IAppEvent } from 'routup';
+/**
+ * The `path` label must stay bounded: labeling by the raw request path lets
+ * every probed id (`/users/<random-uuid>`, even on 401/404) mint a new
+ * prom-client time-series — unbounded registry growth. Requests are instead
+ * labeled by the registered route template (`/users/:id`), read from the
+ * router's own route table (child apps are flattened into the root with full
+ * patterns, and all routes are registered before `listen`, so a snapshot at
+ * first request is complete). Method-agnostic mounts (`/docs`, `/public`)
+ * label as `<mount>/**`; anything else collapses into one unmatched bucket.
+ */
+export declare function createRouteTemplateNormalizePath(router: App): (path: string, event: IAppEvent) => string;
 export declare function registerPrometheusMiddleware(router: App, input?: OptionsInput): void;
 //# sourceMappingURL=prometheus.d.ts.map

package/dist/adapters/http/middleware/built-in/prometheus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prometheus.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/http/middleware/built-in/prometheus.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElC,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,YAAY,QAuB7E"}
+{"version":3,"file":"prometheus.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/http/middleware/built-in/prometheus.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAmF7C;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC5C,MAAM,EAAE,GAAG,GACZ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,MAAM,CAsC5C;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,YAAY,QAsB7E"}

package/dist/adapters/http/middleware/built-in/prometheus.mjs

@@ -3,12 +3,81 @@ import "node:url";
 import.meta.url;
 import { prometheus } from "@routup/prometheus";
 //#region src/adapters/http/middleware/built-in/prometheus.ts
+const PATH_LABEL_UNMATCHED = "/{unmatched}";
+function toPathSegments(path) {
+	return path.split("/").filter((segment) => segment.length > 0);
+}
+function isParameterSegment(segment) {
+	return segment.startsWith(":") || segment === "*";
+}
+function matchSegments(templateSegments, segments, prefix) {
+	if (prefix ? segments.length < templateSegments.length : segments.length !== templateSegments.length) return false;
+	for (const [i, templateSegment] of templateSegments.entries()) {
+		if (isParameterSegment(templateSegment)) continue;
+		if (templateSegment !== segments[i]) return false;
+	}
+	return true;
+}
+function buildRouteTemplates(router) {
+	const exact = [];
+	const prefix = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const route of router.routes) {
+		if (typeof route.path !== "string") continue;
+		const segments = toPathSegments(route.path);
+		const label = `/${segments.join("/")}`;
+		const key = `${route.method || ""} ${label}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		if (route.method) exact.push({
+			method: route.method,
+			segments,
+			label
+		});
+		else if (segments.length > 0) prefix.push({
+			segments,
+			label
+		});
+	}
+	prefix.sort((a, b) => b.segments.length - a.segments.length);
+	return {
+		exact,
+		prefix
+	};
+}
+/**
+* The `path` label must stay bounded: labeling by the raw request path lets
+* every probed id (`/users/<random-uuid>`, even on 401/404) mint a new
+* prom-client time-series — unbounded registry growth. Requests are instead
+* labeled by the registered route template (`/users/:id`), read from the
+* router's own route table (child apps are flattened into the root with full
+* patterns, and all routes are registered before `listen`, so a snapshot at
+* first request is complete). Method-agnostic mounts (`/docs`, `/public`)
+* label as `<mount>/**`; anything else collapses into one unmatched bucket.
+*/ function createRouteTemplateNormalizePath(router) {
+	let templates;
+	return (path, event) => {
+		if (!templates) templates = buildRouteTemplates(router);
+		const segments = toPathSegments(path);
+		const method = `${event.method}`.toUpperCase();
+		for (const template of templates.exact) {
+			if (template.method !== method && !(method === "HEAD" && template.method === "GET")) continue;
+			if (matchSegments(template.segments, segments, false)) return template.label;
+		}
+		for (const template of templates.exact) if (matchSegments(template.segments, segments, false)) return template.label;
+		for (const template of templates.prefix) if (matchSegments(template.segments, segments, true)) return `${template.label}/**`;
+		return PATH_LABEL_UNMATCHED;
+	};
+}
 function registerPrometheusMiddleware(router, input) {
-	let options = { skip(event) {
-		let { path } = event;
-		if (!path.startsWith("/")) path = `/${path}`;
-		return path.startsWith("/authorize") || path.startsWith("/token") || path.startsWith("/metrics") || path === "/";
-	} };
+	let options = {
+		normalizePath: createRouteTemplateNormalizePath(router),
+		skip(event) {
+			let { path } = event;
+			if (!path.startsWith("/")) path = `/${path}`;
+			return path.startsWith("/metrics") || path === "/";
+		}
+	};
 	if (input) options = {
 		...options,
 		...input
@@ -16,6 +85,6 @@ function registerPrometheusMiddleware(router, input) {
 	router.use(prometheus(options));
 }
 //#endregion
-export { registerPrometheusMiddleware };
+export { createRouteTemplateNormalizePath, registerPrometheusMiddleware };
 
 //# sourceMappingURL=prometheus.mjs.map

package/dist/adapters/http/middleware/built-in/prometheus.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prometheus.mjs","names":["prometheus","registerPrometheusMiddleware","router","input","options","skip","event","path","startsWith","use"],"sources":["../../../../../src/adapters/http/middleware/built-in/prometheus.ts"],"sourcesContent":["/*\n * Copyright (c) 2023.\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 { OptionsInput } from '@routup/prometheus';\nimport { prometheus } from '@routup/prometheus';\nimport type { App } from 'routup';\n\nexport function registerPrometheusMiddleware(router: App, input?: OptionsInput) {\n    let options : OptionsInput = {\n        skip(event) {\n            let { path } = event;\n            if (!path.startsWith('/')) {\n                path = `/${path}`;\n            }\n\n            return path.startsWith('/authorize') ||\n                path.startsWith('/token') ||\n                path.startsWith('/metrics') ||\n                path === '/';\n        },\n    };\n\n    if (input) {\n        options = {\n            ...options,\n            ...input,\n        };\n    }\n\n    router.use(prometheus(options));\n}\n"],"mappings":";;;;;AAWA,SAAgBC,6BAA6BC,QAAaC,OAAoB;CAC1E,IAAIC,UAAyB,EACzBC,KAAKC,OAAK;EACN,IAAI,EAAEC,SAASD;EACf,IAAI,CAACC,KAAKC,WAAW,GAAA,GACjBD,OAAO,IAAIA;EAGf,OAAOA,KAAKC,WAAW,YAAA,KACnBD,KAAKC,WAAW,QAAA,KAChBD,KAAKC,WAAW,UAAA,KAChBD,SAAS;CACjB,EACJ;CAEA,IAAIJ,OACAC,UAAU;EACN,GAAGA;EACH,GAAGD;CACP;CAGJD,OAAOO,IAAIT,WAAWI,OAAAA,CAAAA;AAC1B"}
+{"version":3,"file":"prometheus.mjs","names":["prometheus","PATH_LABEL_UNMATCHED","toPathSegments","path","split","filter","segment","length","isParameterSegment","startsWith","matchSegments","templateSegments","segments","prefix","i","templateSegment","entries","buildRouteTemplates","router","exact","seen","Set","route","routes","label","join","key","method","has","add","push","sort","a","b","createRouteTemplateNormalizePath","templates","event","toUpperCase","template","registerPrometheusMiddleware","input","options","normalizePath","skip","use"],"sources":["../../../../../src/adapters/http/middleware/built-in/prometheus.ts"],"sourcesContent":["/*\n * Copyright (c) 2023.\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 { OptionsInput } from '@routup/prometheus';\nimport { prometheus } from '@routup/prometheus';\nimport type { App, IAppEvent } from 'routup';\n\nconst PATH_LABEL_UNMATCHED = '/{unmatched}';\n\ntype RouteTemplate = {\n    method?: string,\n    segments: string[],\n    label: string,\n};\n\ntype RouteTemplates = {\n    exact: RouteTemplate[],\n    prefix: RouteTemplate[],\n};\n\nfunction toPathSegments(path: string): string[] {\n    return path.split('/').filter((segment) => segment.length > 0);\n}\n\nfunction isParameterSegment(segment: string): boolean {\n    return segment.startsWith(':') || segment === '*';\n}\n\nfunction matchSegments(\n    templateSegments: string[],\n    segments: string[],\n    prefix: boolean,\n): boolean {\n    if (\n        prefix ?\n            segments.length < templateSegments.length :\n            segments.length !== templateSegments.length\n    ) {\n        return false;\n    }\n\n    for (const [i, templateSegment] of templateSegments.entries()) {\n        if (isParameterSegment(templateSegment)) {\n            continue;\n        }\n\n        if (templateSegment !== segments[i]) {\n            return false;\n        }\n    }\n\n    return true;\n}\n\nfunction buildRouteTemplates(router: App): RouteTemplates {\n    const exact: RouteTemplate[] = [];\n    const prefix: RouteTemplate[] = [];\n    const seen = new Set<string>();\n\n    for (const route of router.routes) {\n        if (typeof route.path !== 'string') {\n            continue;\n        }\n\n        const segments = toPathSegments(route.path);\n        const label = `/${segments.join('/')}`;\n        const key = `${route.method || ''} ${label}`;\n        if (seen.has(key)) {\n            continue;\n        }\n        seen.add(key);\n\n        if (route.method) {\n            exact.push({\n                method: route.method, \n                segments, \n                label, \n            });\n        } else if (segments.length > 0) {\n            prefix.push({ segments, label });\n        }\n    }\n\n    prefix.sort((a, b) => b.segments.length - a.segments.length);\n\n    return { exact, prefix };\n}\n\n/**\n * The `path` label must stay bounded: labeling by the raw request path lets\n * every probed id (`/users/<random-uuid>`, even on 401/404) mint a new\n * prom-client time-series — unbounded registry growth. Requests are instead\n * labeled by the registered route template (`/users/:id`), read from the\n * router's own route table (child apps are flattened into the root with full\n * patterns, and all routes are registered before `listen`, so a snapshot at\n * first request is complete). Method-agnostic mounts (`/docs`, `/public`)\n * label as `<mount>/**`; anything else collapses into one unmatched bucket.\n */\nexport function createRouteTemplateNormalizePath(\n    router: App,\n): (path: string, event: IAppEvent) => string {\n    let templates : RouteTemplates | undefined;\n\n    return (path, event) => {\n        if (!templates) {\n            templates = buildRouteTemplates(router);\n        }\n\n        const segments = toPathSegments(path);\n        const method = `${event.method}`.toUpperCase();\n\n        for (const template of templates.exact) {\n            if (\n                template.method !== method &&\n                !(method === 'HEAD' && template.method === 'GET')\n            ) {\n                continue;\n            }\n\n            if (matchSegments(template.segments, segments, false)) {\n                return template.label;\n            }\n        }\n\n        for (const template of templates.exact) {\n            if (matchSegments(template.segments, segments, false)) {\n                return template.label;\n            }\n        }\n\n        for (const template of templates.prefix) {\n            if (matchSegments(template.segments, segments, true)) {\n                return `${template.label}/**`;\n            }\n        }\n\n        return PATH_LABEL_UNMATCHED;\n    };\n}\n\nexport function registerPrometheusMiddleware(router: App, input?: OptionsInput) {\n    let options : OptionsInput = {\n        normalizePath: createRouteTemplateNormalizePath(router),\n        skip(event) {\n            let { path } = event;\n            if (!path.startsWith('/')) {\n                path = `/${path}`;\n            }\n\n            return path.startsWith('/metrics') ||\n                path === '/';\n        },\n    };\n\n    if (input) {\n        options = {\n            ...options,\n            ...input,\n        };\n    }\n\n    router.use(prometheus(options));\n}\n"],"mappings":";;;;;AAWA,MAAMC,uBAAuB;AAa7B,SAASC,eAAeC,MAAY;CAChC,OAAOA,KAAKC,MAAM,GAAA,CAAA,CAAKC,QAAQC,YAAYA,QAAQC,SAAS,CAAA;AAChE;AAEA,SAASC,mBAAmBF,SAAe;CACvC,OAAOA,QAAQG,WAAW,GAAA,KAAQH,YAAY;AAClD;AAEA,SAASI,cACLC,kBACAC,UACAC,QAAe;CAEf,IACIA,SACID,SAASL,SAASI,iBAAiBJ,SACnCK,SAASL,WAAWI,iBAAiBJ,QAEzC,OAAO;CAGX,KAAK,MAAM,CAACO,GAAGC,oBAAoBJ,iBAAiBK,QAAO,GAAI;EAC3D,IAAIR,mBAAmBO,eAAAA,GACnB;EAGJ,IAAIA,oBAAoBH,SAASE,IAC7B,OAAO;CAEf;CAEA,OAAO;AACX;AAEA,SAASG,oBAAoBC,QAAW;CACpC,MAAMC,QAAyB,CAAA;CAC/B,MAAMN,SAA0B,CAAA;CAChC,MAAMO,uBAAO,IAAIC,IAAAA;CAEjB,KAAK,MAAMC,SAASJ,OAAOK,QAAQ;EAC/B,IAAI,OAAOD,MAAMnB,SAAS,UACtB;EAGJ,MAAMS,WAAWV,eAAeoB,MAAMnB,IAAI;EAC1C,MAAMqB,QAAQ,IAAIZ,SAASa,KAAK,GAAA;EAChC,MAAMC,MAAM,GAAGJ,MAAMK,UAAU,GAAG,GAAGH;EACrC,IAAIJ,KAAKQ,IAAIF,GAAAA,GACT;EAEJN,KAAKS,IAAIH,GAAAA;EAET,IAAIJ,MAAMK,QACNR,MAAMW,KAAK;GACPH,QAAQL,MAAMK;GACdf;GACAY;EACJ,CAAA;OACG,IAAIZ,SAASL,SAAS,GACzBM,OAAOiB,KAAK;GAAElB;GAAUY;EAAM,CAAA;CAEtC;CAEAX,OAAOkB,MAAMC,GAAGC,MAAMA,EAAErB,SAASL,SAASyB,EAAEpB,SAASL,MAAM;CAE3D,OAAO;EAAEY;EAAON;CAAO;AAC3B;;;;;;;;;;GAYA,SAAgBqB,iCACZhB,QAAW;CAEX,IAAIiB;CAEJ,QAAQhC,MAAMiC,UAAAA;EACV,IAAI,CAACD,WACDA,YAAYlB,oBAAoBC,MAAAA;EAGpC,MAAMN,WAAWV,eAAeC,IAAAA;EAChC,MAAMwB,SAAS,GAAGS,MAAMT,SAASU,YAAW;EAE5C,KAAK,MAAMC,YAAYH,UAAUhB,OAAO;GACpC,IACImB,SAASX,WAAWA,UACpB,EAAEA,WAAW,UAAUW,SAASX,WAAW,QAE3C;GAGJ,IAAIjB,cAAc4B,SAAS1B,UAAUA,UAAU,KAAA,GAC3C,OAAO0B,SAASd;EAExB;EAEA,KAAK,MAAMc,YAAYH,UAAUhB,OAC7B,IAAIT,cAAc4B,SAAS1B,UAAUA,UAAU,KAAA,GAC3C,OAAO0B,SAASd;EAIxB,KAAK,MAAMc,YAAYH,UAAUtB,QAC7B,IAAIH,cAAc4B,SAAS1B,UAAUA,UAAU,IAAA,GAC3C,OAAO,GAAG0B,SAASd,MAAM;EAIjC,OAAOvB;CACX;AACJ;AAEA,SAAgBsC,6BAA6BrB,QAAasB,OAAoB;CAC1E,IAAIC,UAAyB;EACzBC,eAAeR,iCAAiChB,MAAAA;EAChDyB,KAAKP,OAAK;GACN,IAAI,EAAEjC,SAASiC;GACf,IAAI,CAACjC,KAAKM,WAAW,GAAA,GACjBN,OAAO,IAAIA;GAGf,OAAOA,KAAKM,WAAW,UAAA,KACnBN,SAAS;EACjB;CACJ;CAEA,IAAIqC,OACAC,UAAU;EACN,GAAGA;EACH,GAAGD;CACP;CAGJtB,OAAO0B,IAAI5C,WAAWyC,OAAAA,CAAAA;AAC1B"}

package/dist/adapters/http/middleware/built-in/realm-resolver/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../../../src/adapters/http/middleware/built-in/realm-resolver/module.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAEjE,qBAAa,uBAAuB;IAChC,SAAS,CAAC,eAAe,EAAE,gBAAgB,CAAC;gBAEhC,GAAG,EAAE,8BAA8B;IAIzC,GAAG,CAAC,KAAK,EAAE,SAAS;CAkB7B"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../../../src/adapters/http/middleware/built-in/realm-resolver/module.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAEjE,qBAAa,uBAAuB;IAChC,SAAS,CAAC,eAAe,EAAE,gBAAgB,CAAC;gBAEhC,GAAG,EAAE,8BAA8B;IAIzC,GAAG,CAAC,KAAK,EAAE,SAAS;CAa7B"}

package/dist/adapters/http/middleware/built-in/realm-resolver/module.mjs

@@ -3,7 +3,6 @@ import "node:url";
 import.meta.url;
 import { setRequestRealmID } from "../../../request/helpers/realm-id.mjs";
 import "../../../request/index.mjs";
-import { isUUID } from "@authup/kit";
 import { EntityNotFoundError } from "@authup/errors";
 //#region src/adapters/http/middleware/built-in/realm-resolver/module.ts
 var RealmResolverMiddleware = class {
@@ -14,13 +13,9 @@ var RealmResolverMiddleware = class {
 	async run(event) {
 		const value = event.params.realmId;
 		if (typeof value !== "string" || !value) return;
-		if (isUUID(value)) {
-			setRequestRealmID(event, value);
-			return;
-		}
-		const realm = await this.realmRepository.resolve(value);
-		if (!realm) throw new EntityNotFoundError(`realm '${value}' not found`);
-		setRequestRealmID(event, realm.id);
+		const realmId = await this.realmRepository.resolveId(value);
+		if (!realmId) throw new EntityNotFoundError(`realm '${value}' not found`);
+		setRequestRealmID(event, realmId);
 	}
 };
 //#endregion

package/dist/adapters/http/middleware/built-in/realm-resolver/module.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"module.mjs","names":["isUUID","EntityNotFoundError","setRequestRealmID","RealmResolverMiddleware","realmRepository","ctx","run","event","value","params","realmId","realm","resolve","id"],"sources":["../../../../../../src/adapters/http/middleware/built-in/realm-resolver/module.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 { isUUID } from '@authup/kit';\nimport { EntityNotFoundError } from '@authup/errors';\nimport type { IAppEvent } from 'routup';\nimport type { IRealmRepository } from '../../../../../core/index.ts';\nimport { setRequestRealmID } from '../../../request/index.ts';\nimport type { RealmResolverMiddlewareContext } from './types.ts';\n\nexport class RealmResolverMiddleware {\n    protected realmRepository: IRealmRepository;\n\n    constructor(ctx: RealmResolverMiddlewareContext) {\n        this.realmRepository = ctx.realmRepository;\n    }\n\n    async run(event: IAppEvent) {\n        const value = event.params.realmId;\n        if (typeof value !== 'string' || !value) {\n            return;\n        }\n\n        if (isUUID(value)) {\n            setRequestRealmID(event, value);\n            return;\n        }\n\n        const realm = await this.realmRepository.resolve(value);\n        if (!realm) {\n            throw new EntityNotFoundError(`realm '${value}' not found`);\n        }\n\n        setRequestRealmID(event, realm.id);\n    }\n}\n"],"mappings":";;;;;;;;AAcA,IAAaG,0BAAb,MAAaA;CACCC;CAEV,YAAYC,KAAqC;EAC7C,KAAKD,kBAAkBC,IAAID;CAC/B;CAEA,MAAME,IAAIC,OAAkB;EACxB,MAAMC,QAAQD,MAAME,OAAOC;EAC3B,IAAI,OAAOF,UAAU,YAAY,CAACA,OAC9B;EAGJ,IAAIR,OAAOQ,KAAAA,GAAQ;GACfN,kBAAkBK,OAAOC,KAAAA;GACzB;EACJ;EAEA,MAAMG,QAAQ,MAAM,KAAKP,gBAAgBQ,QAAQJ,KAAAA;EACjD,IAAI,CAACG,OACD,MAAM,IAAIV,oBAAoB,UAAUO,MAAM,YAAY;EAG9DN,kBAAkBK,OAAOI,MAAME,EAAE;CACrC;AACJ"}
+{"version":3,"file":"module.mjs","names":["EntityNotFoundError","setRequestRealmID","RealmResolverMiddleware","realmRepository","ctx","run","event","value","params","realmId","resolveId"],"sources":["../../../../../../src/adapters/http/middleware/built-in/realm-resolver/module.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 { EntityNotFoundError } from '@authup/errors';\nimport type { IAppEvent } from 'routup';\nimport type { IRealmRepository } from '../../../../../core/index.ts';\nimport { setRequestRealmID } from '../../../request/index.ts';\nimport type { RealmResolverMiddlewareContext } from './types.ts';\n\nexport class RealmResolverMiddleware {\n    protected realmRepository: IRealmRepository;\n\n    constructor(ctx: RealmResolverMiddlewareContext) {\n        this.realmRepository = ctx.realmRepository;\n    }\n\n    async run(event: IAppEvent) {\n        const value = event.params.realmId;\n        if (typeof value !== 'string' || !value) {\n            return;\n        }\n\n        const realmId = await this.realmRepository.resolveId(value);\n        if (!realmId) {\n            throw new EntityNotFoundError(`realm '${value}' not found`);\n        }\n\n        setRequestRealmID(event, realmId);\n    }\n}\n"],"mappings":";;;;;;;AAaA,IAAaE,0BAAb,MAAaA;CACCC;CAEV,YAAYC,KAAqC;EAC7C,KAAKD,kBAAkBC,IAAID;CAC/B;CAEA,MAAME,IAAIC,OAAkB;EACxB,MAAMC,QAAQD,MAAME,OAAOC;EAC3B,IAAI,OAAOF,UAAU,YAAY,CAACA,OAC9B;EAGJ,MAAME,UAAU,MAAM,KAAKN,gBAAgBO,UAAUH,KAAAA;EACrD,IAAI,CAACE,SACD,MAAM,IAAIT,oBAAoB,UAAUO,MAAM,YAAY;EAG9DN,kBAAkBK,OAAOG,OAAAA;CAC7B;AACJ"}

package/dist/adapters/http/middleware/built-in/ui-http-client.d.ts

@@ -7,8 +7,8 @@ import type { App } from 'routup';
  * whose registration carries `lifetime: 'transient'`, so every SSR
  * render resolves a fresh client — never share one client instance
  * across renders (the authentication hook writes per-user state onto
- * it). Mounted only when the token is bound (test injection);
- * production mounts nothing.
+ * it). Production binds the internal loopback client by default
+ * (`HTTPModule.registerUIHttpClient`); tests may pre-register a fake.
  */
 export declare const UI_HTTP_CLIENT_FACTORY_STORE_KEY: unique symbol;
 export declare function registerUIHttpClientMiddleware(router: App, httpClientFactory: () => IClient): void;

package/dist/adapters/http/middleware/built-in/ui-http-client.mjs

@@ -10,8 +10,8 @@ import { defineCoreHandler } from "routup";
 * whose registration carries `lifetime: 'transient'`, so every SSR
 * render resolves a fresh client — never share one client instance
 * across renders (the authentication hook writes per-user state onto
-* it). Mounted only when the token is bound (test injection);
-* production mounts nothing.
+* it). Production binds the internal loopback client by default
+* (`HTTPModule.registerUIHttpClient`); tests may pre-register a fake.
 */ const UI_HTTP_CLIENT_FACTORY_STORE_KEY = Symbol("UIHttpClientFactory");
 function registerUIHttpClientMiddleware(router, httpClientFactory) {
 	router.use(defineCoreHandler((event) => {

package/dist/adapters/http/middleware/built-in/ui-http-client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ui-http-client.mjs","names":["defineCoreHandler","UI_HTTP_CLIENT_FACTORY_STORE_KEY","Symbol","registerUIHttpClientMiddleware","router","httpClientFactory","use","event","store","next"],"sources":["../../../../../src/adapters/http/middleware/built-in/ui-http-client.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 { IClient } from '@authup/core-http-kit';\nimport type { App } from 'routup';\nimport { defineCoreHandler } from 'routup';\n\n/**\n * Per-request handoff of an HTTP-client factory into renderUIPage —\n * same mechanism as VITE_SERVER_STORE_KEY. The wiring passes a thunk\n * over the DI container (`() => container.resolve(UIHttpClient)`)\n * whose registration carries `lifetime: 'transient'`, so every SSR\n * render resolves a fresh client — never share one client instance\n * across renders (the authentication hook writes per-user state onto\n * it). Mounted only when the token is bound (test injection);\n * production mounts nothing.\n */\nexport const UI_HTTP_CLIENT_FACTORY_STORE_KEY = Symbol('UIHttpClientFactory');\n\nexport function registerUIHttpClientMiddleware(router: App, httpClientFactory: () => IClient) {\n    router.use(defineCoreHandler((event) => {\n        event.store[UI_HTTP_CLIENT_FACTORY_STORE_KEY] = httpClientFactory;\n        return event.next();\n    }));\n}\n"],"mappings":";;;;;;;;;;;;;;GAqBA,MAAaC,mCAAmCC,OAAO,qBAAA;AAEvD,SAAgBC,+BAA+BC,QAAaC,mBAAgC;CACxFD,OAAOE,IAAIN,mBAAmBO,UAAAA;EAC1BA,MAAMC,MAAMP,oCAAoCI;EAChD,OAAOE,MAAME,KAAI;CACrB,CAAA,CAAA;AACJ"}
+{"version":3,"file":"ui-http-client.mjs","names":["defineCoreHandler","UI_HTTP_CLIENT_FACTORY_STORE_KEY","Symbol","registerUIHttpClientMiddleware","router","httpClientFactory","use","event","store","next"],"sources":["../../../../../src/adapters/http/middleware/built-in/ui-http-client.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 { IClient } from '@authup/core-http-kit';\nimport type { App } from 'routup';\nimport { defineCoreHandler } from 'routup';\n\n/**\n * Per-request handoff of an HTTP-client factory into renderUIPage —\n * same mechanism as VITE_SERVER_STORE_KEY. The wiring passes a thunk\n * over the DI container (`() => container.resolve(UIHttpClient)`)\n * whose registration carries `lifetime: 'transient'`, so every SSR\n * render resolves a fresh client — never share one client instance\n * across renders (the authentication hook writes per-user state onto\n * it). Production binds the internal loopback client by default\n * (`HTTPModule.registerUIHttpClient`); tests may pre-register a fake.\n */\nexport const UI_HTTP_CLIENT_FACTORY_STORE_KEY = Symbol('UIHttpClientFactory');\n\nexport function registerUIHttpClientMiddleware(router: App, httpClientFactory: () => IClient) {\n    router.use(defineCoreHandler((event) => {\n        event.store[UI_HTTP_CLIENT_FACTORY_STORE_KEY] = httpClientFactory;\n        return event.next();\n    }));\n}\n"],"mappings":";;;;;;;;;;;;;;GAqBA,MAAaC,mCAAmCC,OAAO,qBAAA;AAEvD,SAAgBC,+BAA+BC,QAAaC,mBAAgC;CACxFD,OAAOE,IAAIN,mBAAmBO,UAAAA;EAC1BA,MAAMC,MAAMP,oCAAoCI;EAChD,OAAOE,MAAME,KAAI;CACrB,CAAA,CAAA;AACJ"}

package/dist/adapters/http/middleware/index.mjs

@@ -11,10 +11,10 @@ import { VITE_SERVER_STORE_KEY, registerAssetsMiddleware } from "./built-in/asse
 import { registerBasicMiddleware } from "./built-in/basic.mjs";
 import { registerCorsMiddleware } from "./built-in/cors.mjs";
 import { registerErrorMiddleware } from "./built-in/error.mjs";
-import { createLoggerMiddleware } from "./built-in/logger.mjs";
-import { registerPrometheusMiddleware } from "./built-in/prometheus.mjs";
+import { createLoggerMiddleware, redactSensitiveURLParams } from "./built-in/logger.mjs";
+import { createRouteTemplateNormalizePath, registerPrometheusMiddleware } from "./built-in/prometheus.mjs";
 import { registerRateLimitMiddleware } from "./built-in/rate-limit.mjs";
 import { createSwaggerMiddleware } from "./built-in/swagger.mjs";
 import { UI_HTTP_CLIENT_FACTORY_STORE_KEY, registerUIHttpClientMiddleware } from "./built-in/ui-http-client.mjs";
 import "./built-in/index.mjs";
-export { AuthorizationMiddleware, ForceLoggedInMiddleware, ForceUserLoggedInMiddleware, RealmResolverMiddleware, UI_HTTP_CLIENT_FACTORY_STORE_KEY, VITE_SERVER_STORE_KEY, createAuthorizationMiddleware, createLoggerMiddleware, createRealmResolverMiddleware, createSwaggerMiddleware, registerAssetsMiddleware, registerBasicMiddleware, registerCorsMiddleware, registerErrorMiddleware, registerPrometheusMiddleware, registerRateLimitMiddleware, registerUIHttpClientMiddleware };
+export { AuthorizationMiddleware, ForceLoggedInMiddleware, ForceUserLoggedInMiddleware, RealmResolverMiddleware, UI_HTTP_CLIENT_FACTORY_STORE_KEY, VITE_SERVER_STORE_KEY, createAuthorizationMiddleware, createLoggerMiddleware, createRealmResolverMiddleware, createRouteTemplateNormalizePath, createSwaggerMiddleware, redactSensitiveURLParams, registerAssetsMiddleware, registerBasicMiddleware, registerCorsMiddleware, registerErrorMiddleware, registerPrometheusMiddleware, registerRateLimitMiddleware, registerUIHttpClientMiddleware };

package/dist/adapters/http/request/client-certificate.d.ts

@@ -0,0 +1,5 @@
+import type { IAppEvent } from 'routup';
+import type { ClientCertificateEvidence } from '../../../core/index.ts';
+import type { CertificateSource } from './types.ts';
+export declare function extractClientCertificateEvidence(event: IAppEvent, source: CertificateSource): Promise<ClientCertificateEvidence | undefined>;
+//# sourceMappingURL=client-certificate.d.ts.map

package/dist/adapters/http/request/client-certificate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-certificate.d.ts","sourceRoot":"","sources":["../../../../src/adapters/http/request/client-certificate.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAKxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD,wBAAsB,gCAAgC,CAClD,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,iBAAiB,GAC1B,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAqBhD"}