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

package/dist/core/entities/key/service.mjs

@@ -1,6 +1,9 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { keySchema } from "./schema.mjs";
+import { appendQueryConditions, decodeQuery } from "../../query/module.mjs";
+import "../../query/index.mjs";
 import { buildEntityDiff } from "../event/diff.mjs";
 import "../event/index.mjs";
 import { assertCertificateMatchesKey, parseCertificateChain } from "../../key/certificate.mjs";
@@ -12,6 +15,7 @@ import { AbstractEntityService, AsymmetricKey, createAsymmetricKeyPair } from "@
 import { BuiltInPolicyType, definePolicyData } from "@authup/access";
 import { EntityConflictError, EntityNotFoundError, ValidationError, isError } from "@authup/errors";
 import { JWKType, JWKUse, JWTAlgorithm } from "@authup/specs";
+import { eq, inArray } from "@rapiq/core";
 import { getRandomValues } from "uncrypto";
 //#region src/core/entities/key/service.ts
 const PERMISSION_NAMES = [
@@ -31,9 +35,24 @@ var KeyService = class extends AbstractEntityService {
 		this.eventService = ctx.eventService;
 		this.requestContext = ctx.requestContext;
 	}
-	async getMany(query, actor) {
+	async getMany(query, actor, options = {}) {
 		await actor.permissionEvaluator.preEvaluateOneOf({ name: PERMISSION_NAMES });
-		const { data: entities, meta } = await this.repository.findMany(query);
+		let parsed = await decodeQuery(query, {
+			schema: keySchema,
+			actor
+		});
+		if (options.realmId) parsed = appendQueryConditions(parsed, eq("realmId", options.realmId));
+		const compiled = await actor.permissionEvaluator.compile({ name: PERMISSION_NAMES });
+		if (compiled.verdict === "deny") parsed = appendQueryConditions(parsed, inArray("id", []));
+		else if (compiled.verdict === "conditional") parsed = appendQueryConditions(parsed, compiled.condition);
+		const { data: entities, meta } = await this.repository.findMany(parsed);
+		if (compiled.verdict !== "post") {
+			for (const entity of entities) entity.decryptionKey = null;
+			return {
+				data: entities,
+				meta
+			};
+		}
 		const data = [];
 		let { total } = meta;
 		for (const entity of entities) try {
@@ -44,7 +63,7 @@ var KeyService = class extends AbstractEntityService {
 					...this.resourceRealmMatch(entity)
 				})
 			});
-			entity.decryption_key = null;
+			entity.decryptionKey = null;
 			data.push(entity);
 		} catch {
 			total -= 1;
@@ -68,7 +87,7 @@ var KeyService = class extends AbstractEntityService {
 				...this.resourceRealmMatch(entity)
 			})
 		});
-		entity.decryption_key = null;
+		entity.decryptionKey = null;
 		return entity;
 	}
 	async create(data, actor) {
@@ -77,11 +96,11 @@ var KeyService = class extends AbstractEntityService {
 		const { use } = validated;
 		if (!use) throw new ValidationError("A key use must be specified.");
 		await this.repository.validateJoinColumns(validated);
-		if (!validated.realm_id && actor.identity) {
+		if (!validated.realmId && actor.identity) {
 			const actorRealmId = this.getActorRealmId(actor);
-			if (actorRealmId) validated.realm_id = actorRealmId;
+			if (actorRealmId) validated.realmId = actorRealmId;
 		}
-		if (!validated.realm_id) throw new ValidationError("A realm must be specified.");
+		if (!validated.realmId) throw new ValidationError("A realm must be specified.");
 		await actor.permissionEvaluator.evaluate({
 			name: PermissionName.KEY_CREATE,
 			data: definePolicyData({
@@ -92,13 +111,13 @@ var KeyService = class extends AbstractEntityService {
 		if (!validated.name) validated.name = `${use}-${createNanoID(10)}`;
 		await this.repository.checkUniqueness(validated);
 		if (typeof validated.priority !== "number") {
-			const highest = await this.repository.findHighestPriority(validated.realm_id, use);
+			const highest = await this.repository.findHighestPriority(validated.realmId, use);
 			validated.priority = typeof highest === "number" ? highest + 1 : 0;
 		}
 		if (!validated.status) validated.status = KeyStatus.ACTIVE;
 		const certificate = typeof validated.certificate === "string" ? validated.certificate : null;
-		if (certificate && (!validated.decryption_key || use !== JWKUse.SIGNATURE)) throw new ValidationError("A certificate requires imported signature key material.");
-		const material = validated.decryption_key ? await this.importMaterial(validated, use) : await this.generateMaterial(validated, use);
+		if (certificate && (!validated.decryptionKey || use !== JWKUse.SIGNATURE)) throw new ValidationError("A certificate requires imported signature key material.");
+		const material = validated.decryptionKey ? await this.importMaterial(validated, use) : await this.generateMaterial(validated, use);
 		if (certificate) {
 			if (!material.encryptionKey) throw new ValidationError("A certificate requires imported signature key material.");
 			try {
@@ -110,12 +129,12 @@ var KeyService = class extends AbstractEntityService {
 		let entity = this.repository.create({
 			...validated,
 			type: material.type,
-			signature_algorithm: material.signatureAlgorithm,
-			decryption_key: material.decryptionKey,
-			encryption_key: material.encryptionKey
+			signatureAlgorithm: material.signatureAlgorithm,
+			decryptionKey: material.decryptionKey,
+			encryptionKey: material.encryptionKey
 		});
 		entity = await this.repository.save(entity);
-		entity.decryption_key = null;
+		entity.decryptionKey = null;
 		await this.recordEvent(EventName.CREATED, entity, actor);
 		return entity;
 	}
@@ -136,12 +155,12 @@ var KeyService = class extends AbstractEntityService {
 		});
 		if (validated.name && validated.name !== entity.name) await this.repository.checkUniqueness({
 			name: validated.name,
-			realm_id: entity.realm_id
+			realmId: entity.realmId
 		}, entity);
 		const previous = this.pickAuditFields(entity);
 		entity = this.repository.merge(entity, validated);
 		await this.repository.save(entity);
-		entity.decryption_key = null;
+		entity.decryptionKey = null;
 		const diff = buildEntityDiff(this.pickAuditFields(entity), previous);
 		await this.recordEvent(EventName.UPDATED, entity, actor, { ...Object.keys(diff).length > 0 ? { diff } : {} });
 		return entity;
@@ -167,7 +186,7 @@ var KeyService = class extends AbstractEntityService {
 		const { id: entityId } = entity;
 		await this.repository.remove(entity);
 		entity.id = entityId;
-		entity.decryption_key = null;
+		entity.decryptionKey = null;
 		const forcedCryptoShred = entity.use === JWKUse.ENCRYPTION && !!options.force;
 		await this.recordEvent(EventName.DELETED, entity, actor, { ...forcedCryptoShred ? { force: true } : {} });
 		return entity;
@@ -184,7 +203,7 @@ var KeyService = class extends AbstractEntityService {
 			name,
 			refType: EntityType.KEY,
 			refId: entity.id,
-			realmId: entity.realm_id ?? null,
+			realmId: entity.realmId ?? null,
 			actorType: actor.identity?.type ?? null,
 			actorId: actor.identity?.data.id ?? null,
 			actorName: actor.identity?.data.name ?? null,
@@ -209,7 +228,7 @@ var KeyService = class extends AbstractEntityService {
 	}
 	async generateMaterial(validated, use) {
 		if (use === JWKUse.ENCRYPTION) {
-			if (validated.signature_algorithm) throw new ValidationError("An encryption key can not carry a signature algorithm.");
+			if (validated.signatureAlgorithm) throw new ValidationError("An encryption key can not carry a signature algorithm.");
 			const raw = /* @__PURE__ */ new Uint8Array(32);
 			getRandomValues(raw);
 			return {
@@ -219,7 +238,7 @@ var KeyService = class extends AbstractEntityService {
 				encryptionKey: null
 			};
 		}
-		const algorithm = validated.signature_algorithm ?? JWTAlgorithm.RS256;
+		const algorithm = validated.signatureAlgorithm ?? JWTAlgorithm.RS256;
 		const keyPair = await createAsymmetricKeyPair(this.buildAsymmetricOptions(algorithm));
 		return {
 			type: algorithm.startsWith("ES") ? JWKType.EC : JWKType.RSA,
@@ -229,12 +248,12 @@ var KeyService = class extends AbstractEntityService {
 		};
 	}
 	async importMaterial(validated, use) {
-		if (!validated.decryption_key) throw new ValidationError("Importing key material requires its private part (decryption_key).");
-		if (isWrappedKeyMaterial(validated.decryption_key.trim())) throw new ValidationError("The imported key material is not valid.");
-		const decryptionKey = this.normalizeMaterial(validated.decryption_key);
+		if (!validated.decryptionKey) throw new ValidationError("Importing key material requires its private part (decryptionKey).");
+		if (isWrappedKeyMaterial(validated.decryptionKey.trim())) throw new ValidationError("The imported key material is not valid.");
+		const decryptionKey = this.normalizeMaterial(validated.decryptionKey);
 		if (use === JWKUse.ENCRYPTION) {
-			if (validated.signature_algorithm) throw new ValidationError("An encryption key can not carry a signature algorithm.");
-			if (validated.encryption_key) throw new ValidationError("An encryption key holds no public part.");
+			if (validated.signatureAlgorithm) throw new ValidationError("An encryption key can not carry a signature algorithm.");
+			if (validated.encryptionKey) throw new ValidationError("An encryption key holds no public part.");
 			let byteLength;
 			try {
 				byteLength = base64ToArrayBuffer(decryptionKey).byteLength;
@@ -249,9 +268,9 @@ var KeyService = class extends AbstractEntityService {
 				encryptionKey: null
 			};
 		}
-		if (!validated.encryption_key) throw new ValidationError("Importing a signature key requires its public part (encryption_key, SPKI).");
-		const encryptionKey = this.normalizeMaterial(validated.encryption_key);
-		const algorithm = validated.signature_algorithm ?? JWTAlgorithm.RS256;
+		if (!validated.encryptionKey) throw new ValidationError("Importing a signature key requires its public part (encryptionKey, SPKI).");
+		const encryptionKey = this.normalizeMaterial(validated.encryptionKey);
+		const algorithm = validated.signatureAlgorithm ?? JWTAlgorithm.RS256;
 		const options = this.buildAsymmetricOptions(algorithm);
 		let privateJwk;
 		let publicJwk;

package/dist/core/entities/key/service.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"service.mjs","names":["BuiltInPolicyType","definePolicyData","EntityConflictError","EntityNotFoundError","ValidationError","isError","isRawError","EntityType","EventName","EventScope","KeyStatus","KeyValidator","PermissionName","ValidatorGroup","arrayBufferToBase64","base64ToArrayBuffer","createNanoID","AbstractEntityService","AsymmetricKey","createAsymmetricKeyPair","JWKType","JWKUse","JWTAlgorithm","getRandomValues","buildEntityDiff","assertCertificateMatchesKey","isWrappedKeyMaterial","parseCertificateChain","PERMISSION_NAMES","KEY_READ","KEY_UPDATE","KEY_DELETE","KeyService","repository","validator","eventService","requestContext","ctx","getMany","query","actor","permissionEvaluator","preEvaluateOneOf","name","data","entities","meta","findMany","total","entity","evaluateOneOf","ATTRIBUTES","resourceRealmMatch","decryption_key","push","getOne","idOrName","realmId","findOneByIdOrName","create","preEvaluate","KEY_CREATE","validated","run","group","CREATE","use","validateJoinColumns","realm_id","identity","actorRealmId","getActorRealmId","evaluate","checkUniqueness","priority","highest","findHighestPriority","status","ACTIVE","certificate","SIGNATURE","material","importMaterial","generateMaterial","encryptionKey","chain","e","message","type","signature_algorithm","signatureAlgorithm","decryptionKey","encryption_key","save","recordEvent","CREATED","update","UPDATE","previous","pickAuditFields","merge","diff","UPDATED","Object","keys","length","delete","id","options","findOneBy","ENCRYPTION","force","references","countBlobReferences","entityId","remove","forcedCryptoShred","DELETED","undefined","record","scope","ENTITY","refType","KEY","refId","actorType","actorId","actorName","requestPath","requestMethod","requestIpAddress","requestUserAgent","raw","Uint8Array","OCT","buffer","algorithm","RS256","buildAsymmetricOptions","keyPair","startsWith","EC","RSA","privateKey","toBase64","publicKey","trim","normalizeMaterial","byteLength","privateJwk","publicJwk","fromBase64","format","key","toJWK","components","mismatch","some","component","test","buildImportOptionsForJWTAlgorithm","value","includes","replace"],"sources":["../../../../src/core/entities/key/service.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 { BuiltInPolicyType, definePolicyData } from '@authup/access';\nimport {\n    EntityConflictError,\n    EntityNotFoundError,\n    ValidationError,\n    isError as isRawError,\n} from '@authup/errors';\nimport type { Key } from '@authup/core-kit';\nimport {\n    EntityType,\n    EventName,\n    EventScope,\n    KeyStatus,\n    KeyValidator,\n    PermissionName,\n} from '@authup/core-kit';\nimport {\n    ValidatorGroup,\n    arrayBufferToBase64,\n    base64ToArrayBuffer,\n    createNanoID,\n} from '@authup/kit';\nimport type { ActorContext, EntityRepositoryFindManyResult } from '@authup/server-kit';\nimport { AbstractEntityService, AsymmetricKey, createAsymmetricKeyPair } from '@authup/server-kit';\nimport { JWKType, JWKUse, JWTAlgorithm } from '@authup/specs';\nimport { getRandomValues } from 'uncrypto';\nimport { buildEntityDiff } from '../event/index.ts';\nimport type { EventRequestContext, IEventService } from '../event/index.ts';\nimport { assertCertificateMatchesKey, isWrappedKeyMaterial, parseCertificateChain } from '../../key/index.ts';\nimport type { IKeyRepository, IKeyService, KeyDeleteOptions } from './types.ts';\n\nexport type KeyServiceContext = {\n    repository: IKeyRepository;\n    eventService?: IEventService;\n    requestContext?: () => EventRequestContext | undefined;\n};\n\nconst PERMISSION_NAMES = [\n    PermissionName.KEY_READ,\n    PermissionName.KEY_UPDATE,\n    PermissionName.KEY_DELETE,\n];\n\nexport class KeyService extends AbstractEntityService implements IKeyService {\n    protected repository: IKeyRepository;\n\n    protected validator: KeyValidator;\n\n    protected eventService?: IEventService;\n\n    protected requestContext?: () => EventRequestContext | undefined;\n\n    constructor(ctx: KeyServiceContext) {\n        super();\n        this.repository = ctx.repository;\n        this.validator = new KeyValidator();\n        this.eventService = ctx.eventService;\n        this.requestContext = ctx.requestContext;\n    }\n\n    async getMany(\n        query: Record<string, any>,\n        actor: ActorContext,\n    ): Promise<EntityRepositoryFindManyResult<Key>> {\n        await actor.permissionEvaluator.preEvaluateOneOf({ name: PERMISSION_NAMES });\n\n        const { data: entities, meta } = await this.repository.findMany(query);\n\n        const data: Key[] = [];\n        let { total } = meta;\n\n        for (const entity of entities) {\n            try {\n                await actor.permissionEvaluator.evaluateOneOf({\n                    name: PERMISSION_NAMES,\n                    data: definePolicyData({\n                        [BuiltInPolicyType.ATTRIBUTES]: entity,\n                        ...this.resourceRealmMatch(entity),\n                    }),\n                });\n                // Belt-and-braces: the read projection never selects private\n                // material, but null it explicitly so no future adapter change\n                // can leak it onto a read surface (cf. authentik CVE-2024-42490).\n                entity.decryption_key = null;\n                data.push(entity);\n            } catch {\n                total -= 1;\n            }\n        }\n\n        return {\n            data,\n            meta: {\n                ...meta,\n                total,\n            },\n        };\n    }\n\n    async getOne(\n        idOrName: string,\n        actor: ActorContext,\n        realmId?: string,\n    ): Promise<Key> {\n        await actor.permissionEvaluator.preEvaluateOneOf({ name: PERMISSION_NAMES });\n\n        const entity = await this.repository.findOneByIdOrName(idOrName, realmId);\n        if (!entity) {\n            throw new EntityNotFoundError();\n        }\n\n        await actor.permissionEvaluator.evaluateOneOf({\n            name: PERMISSION_NAMES,\n            data: definePolicyData({\n                [BuiltInPolicyType.ATTRIBUTES]: entity,\n                ...this.resourceRealmMatch(entity),\n            }),\n        });\n\n        // Belt-and-braces null of private material (see getMany).\n        entity.decryption_key = null;\n\n        return entity;\n    }\n\n    async create(\n        data: Record<string, any>,\n        actor: ActorContext,\n    ): Promise<Key> {\n        await actor.permissionEvaluator.preEvaluate({ name: PermissionName.KEY_CREATE });\n\n        const validated = await this.validator.run(data, { group: ValidatorGroup.CREATE });\n        const { use } = validated;\n        if (!use) {\n            throw new ValidationError('A key use must be specified.');\n        }\n\n        await this.repository.validateJoinColumns(validated);\n\n        if (!validated.realm_id && actor.identity) {\n            const actorRealmId = this.getActorRealmId(actor);\n            if (actorRealmId) {\n                validated.realm_id = actorRealmId;\n            }\n        }\n\n        // keys are realm-bound infrastructure — no global (null realm) keys\n        // via the API.\n        if (!validated.realm_id) {\n            throw new ValidationError('A realm must be specified.');\n        }\n\n        await actor.permissionEvaluator.evaluate({\n            name: PermissionName.KEY_CREATE,\n            data: definePolicyData({\n                [BuiltInPolicyType.ATTRIBUTES]: validated,\n                ...this.resourceRealmMatch(validated),\n            }),\n        });\n\n        if (!validated.name) {\n            validated.name = `${use}-${createNanoID(10)}`;\n        }\n\n        await this.repository.checkUniqueness(validated);\n\n        if (typeof validated.priority !== 'number') {\n            const highest = await this.repository.findHighestPriority(validated.realm_id, use);\n            // generate doubles as rotate: a new key outranks the current one.\n            validated.priority = typeof highest === 'number' ? highest + 1 : 0;\n        }\n\n        if (!validated.status) {\n            validated.status = KeyStatus.ACTIVE;\n        }\n\n        const certificate = typeof validated.certificate === 'string' ? validated.certificate : null;\n        if (certificate && (!validated.decryption_key || use !== JWKUse.SIGNATURE)) {\n            throw new ValidationError('A certificate requires imported signature key material.');\n        }\n\n        const material = validated.decryption_key ?\n            await this.importMaterial(validated, use) :\n            await this.generateMaterial(validated, use);\n\n        if (certificate) {\n            if (!material.encryptionKey) {\n                throw new ValidationError('A certificate requires imported signature key material.');\n            }\n\n            try {\n                const chain = parseCertificateChain(certificate);\n                assertCertificateMatchesKey(chain, material.encryptionKey);\n            } catch (e) {\n                throw new ValidationError(\n                    isRawError(e) ?\n                        e.message :\n                        'The certificate could not be matched against the imported key material.',\n                );\n            }\n        }\n\n        let entity = this.repository.create({\n            ...validated,\n            type: material.type,\n            signature_algorithm: material.signatureAlgorithm,\n            decryption_key: material.decryptionKey,\n            encryption_key: material.encryptionKey,\n        });\n\n        entity = await this.repository.save(entity);\n\n        // private material never leaves the server — the response carries\n        // metadata + public part only (authentik CVE-2024-42490).\n        entity.decryption_key = null;\n\n        await this.recordEvent(EventName.CREATED, entity, actor);\n\n        return entity;\n    }\n\n    async update(\n        idOrName: string,\n        data: Record<string, any>,\n        actor: ActorContext,\n        realmId?: string,\n    ): Promise<Key> {\n        await actor.permissionEvaluator.preEvaluate({ name: PermissionName.KEY_UPDATE });\n\n        let entity = await this.repository.findOneByIdOrName(idOrName, realmId);\n        if (!entity) {\n            throw new EntityNotFoundError();\n        }\n\n        // only name / priority / status are mounted for UPDATE — material,\n        // use, type and realm are immutable.\n        const validated = await this.validator.run(data, { group: ValidatorGroup.UPDATE });\n\n        await actor.permissionEvaluator.evaluate({\n            name: PermissionName.KEY_UPDATE,\n            data: definePolicyData({\n                [BuiltInPolicyType.ATTRIBUTES]: {\n                    ...entity,\n                    ...validated,\n                },\n                ...this.resourceRealmMatch(entity),\n            }),\n        });\n\n        if (validated.name && validated.name !== entity.name) {\n            await this.repository.checkUniqueness({\n                name: validated.name,\n                realm_id: entity.realm_id,\n            }, entity);\n        }\n\n        const previous = this.pickAuditFields(entity);\n\n        entity = this.repository.merge(entity, validated);\n        await this.repository.save(entity);\n\n        entity.decryption_key = null;\n\n        const diff = buildEntityDiff(this.pickAuditFields(entity), previous);\n        await this.recordEvent(EventName.UPDATED, entity, actor, { ...(Object.keys(diff).length > 0 ? { diff } : {}) });\n\n        return entity;\n    }\n\n    async delete(\n        id: string,\n        actor: ActorContext,\n        options: KeyDeleteOptions = {},\n    ): Promise<Key> {\n        await actor.permissionEvaluator.preEvaluate({ name: PermissionName.KEY_DELETE });\n\n        const entity = await this.repository.findOneBy({ id });\n        if (!entity) {\n            throw new EntityNotFoundError();\n        }\n\n        await actor.permissionEvaluator.evaluate({\n            name: PermissionName.KEY_DELETE,\n            data: definePolicyData({\n                [BuiltInPolicyType.ATTRIBUTES]: entity,\n                ...this.resourceRealmMatch(entity),\n            }),\n        });\n\n        if (entity.use === JWKUse.ENCRYPTION && !options.force) {\n            const references = await this.repository.countBlobReferences(entity.id);\n            if (references > 0) {\n                throw new EntityConflictError({\n                    message: `The encryption key is still referenced by ${references} encrypted secret(s) — ` +\n                        'deleting it makes them unrecoverable. Repeat with force to crypto-shred them.',\n                    data: { references },\n                });\n            }\n        }\n\n        const { id: entityId } = entity;\n        await this.repository.remove(entity);\n        entity.id = entityId;\n        entity.decryption_key = null;\n\n        // force only carries crypto-shred semantics for encryption keys — a\n        // sig-key delete with a stray force flag must not read as a shred.\n        const forcedCryptoShred = entity.use === JWKUse.ENCRYPTION && !!options.force;\n        await this.recordEvent(EventName.DELETED, entity, actor, { ...(forcedCryptoShred ? { force: true } : {}) });\n\n        return entity;\n    }\n\n    // ------------------------------------------------------------------\n\n    /**\n     * Metadata-only audit trail for key lifecycle operations (issue #3269) —\n     * keys deliberately have no entity subscriber (private material must stay\n     * off the realtime/audit bus), so the security-relevant mutations are\n     * recorded explicitly. The payload never carries key material.\n     */\n    protected async recordEvent(\n        name: `${EventName}`,\n        entity: Key,\n        actor: ActorContext,\n        data: Record<string, any> = {},\n    ): Promise<void> {\n        const requestContext = this.requestContext ?\n            this.requestContext() :\n            undefined;\n\n        await this.eventService?.record({\n            scope: EventScope.ENTITY,\n            name,\n            refType: EntityType.KEY,\n            refId: entity.id,\n            realmId: entity.realm_id ?? null,\n            actorType: actor.identity?.type ?? null,\n            actorId: actor.identity?.data.id ?? null,\n            actorName: actor.identity?.data.name ?? null,\n            requestPath: requestContext?.requestPath ?? null,\n            requestMethod: requestContext?.requestMethod ?? null,\n            requestIpAddress: requestContext?.requestIpAddress ?? null,\n            requestUserAgent: requestContext?.requestUserAgent ?? null,\n            data: {\n                name: entity.name,\n                use: entity.use,\n                status: entity.status,\n                ...data,\n            },\n        });\n    }\n\n    protected pickAuditFields(entity: Key): Record<string, any> {\n        return {\n            name: entity.name,\n            priority: entity.priority,\n            status: entity.status,\n        };\n    }\n\n    protected async generateMaterial(\n        validated: Partial<Key>,\n        use: `${JWKUse}`,\n    ) : Promise<{\n        type: `${JWKType}`,\n        signatureAlgorithm: `${JWTAlgorithm}` | null,\n        decryptionKey: string,\n        encryptionKey: string | null,\n    }> {\n        if (use === JWKUse.ENCRYPTION) {\n            if (validated.signature_algorithm) {\n                throw new ValidationError('An encryption key can not carry a signature algorithm.');\n            }\n\n            const raw = new Uint8Array(32);\n            getRandomValues(raw);\n\n            return {\n                type: JWKType.OCT,\n                signatureAlgorithm: null,\n                decryptionKey: arrayBufferToBase64(raw.buffer),\n                encryptionKey: null,\n            };\n        }\n\n        const algorithm = validated.signature_algorithm ?? JWTAlgorithm.RS256;\n        const options = this.buildAsymmetricOptions(algorithm);\n\n        const keyPair = await createAsymmetricKeyPair(options);\n\n        return {\n            type: algorithm.startsWith('ES') ? JWKType.EC : JWKType.RSA,\n            signatureAlgorithm: algorithm,\n            decryptionKey: await new AsymmetricKey(keyPair.privateKey).toBase64(),\n            encryptionKey: await new AsymmetricKey(keyPair.publicKey).toBase64(),\n        };\n    }\n\n    protected async importMaterial(\n        validated: Partial<Key>,\n        use: `${JWKUse}`,\n    ) : Promise<{\n        type: `${JWKType}`,\n        signatureAlgorithm: `${JWTAlgorithm}` | null,\n        decryptionKey: string,\n        encryptionKey: string | null,\n    }> {\n        if (!validated.decryption_key) {\n            throw new ValidationError('Importing key material requires its private part (decryption_key).');\n        }\n\n        // Reject material masquerading as an at-rest KEK-wrapped blob — it\n        // would be treated as wrapped on the next read (and, with a KEK,\n        // fail GCM authentication).\n        if (isWrappedKeyMaterial(validated.decryption_key.trim())) {\n            throw new ValidationError('The imported key material is not valid.');\n        }\n\n        const decryptionKey = this.normalizeMaterial(validated.decryption_key);\n\n        if (use === JWKUse.ENCRYPTION) {\n            if (validated.signature_algorithm) {\n                throw new ValidationError('An encryption key can not carry a signature algorithm.');\n            }\n\n            if (validated.encryption_key) {\n                throw new ValidationError('An encryption key holds no public part.');\n            }\n\n            let byteLength : number;\n            try {\n                byteLength = base64ToArrayBuffer(decryptionKey).byteLength;\n            } catch {\n                throw new ValidationError('The key material is not valid base64.');\n            }\n\n            if (byteLength !== 32) {\n                throw new ValidationError('The key material must be 32 base64-encoded bytes.');\n            }\n\n            return {\n                type: JWKType.OCT,\n                signatureAlgorithm: null,\n                decryptionKey,\n                encryptionKey: null,\n            };\n        }\n\n        if (!validated.encryption_key) {\n            throw new ValidationError('Importing a signature key requires its public part (encryption_key, SPKI).');\n        }\n\n        const encryptionKey = this.normalizeMaterial(validated.encryption_key);\n        const algorithm = validated.signature_algorithm ?? JWTAlgorithm.RS256;\n        const options = this.buildAsymmetricOptions(algorithm);\n\n        let privateJwk : JsonWebKey;\n        let publicJwk : JsonWebKey;\n\n        try {\n            const privateKey = await AsymmetricKey.fromBase64({\n                format: 'pkcs8',\n                key: decryptionKey,\n                options,\n            });\n            const publicKey = await AsymmetricKey.fromBase64({\n                format: 'spki',\n                key: encryptionKey,\n                options,\n            });\n\n            privateJwk = await privateKey.toJWK();\n            publicJwk = await publicKey.toJWK();\n        } catch {\n            throw new ValidationError(`The key material could not be imported for ${algorithm}.`);\n        }\n\n        // the public components (RSA: n/e, EC: crv/x/y) must agree — a\n        // private key paired with a foreign public part would publish a\n        // wrong JWKS entry and break verification of every token it signs.\n        const components : (keyof JsonWebKey)[] = ['kty', 'n', 'e', 'crv', 'x', 'y'];\n        const mismatch = components.some(\n            (component) => publicJwk[component] !== undefined &&\n                publicJwk[component] !== privateJwk[component],\n        );\n        if (mismatch) {\n            throw new ValidationError('The private and public key material do not form a pair.');\n        }\n\n        return {\n            type: algorithm.startsWith('ES') ? JWKType.EC : JWKType.RSA,\n            signatureAlgorithm: algorithm,\n            decryptionKey,\n            encryptionKey,\n        };\n    }\n\n    protected buildAsymmetricOptions(algorithm: `${JWTAlgorithm}`) {\n        if (!/^(RS|ES)(256|384|512)$/.test(algorithm)) {\n            throw new ValidationError(`The signature algorithm ${algorithm} is not supported for stored keys.`);\n        }\n\n        return AsymmetricKey.buildImportOptionsForJWTAlgorithm(algorithm);\n    }\n\n    protected normalizeMaterial(value: string) : string {\n        if (value.includes('-----BEGIN')) {\n            // PEM body IS base64 DER — strip armor + whitespace.\n            return value\n                .replace(/-----(BEGIN|END)[^-]+-----/g, '')\n                .replace(/\\s+/g, '');\n        }\n\n        return value.trim();\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"service.mjs","names":["BuiltInPolicyType","definePolicyData","eq","inArray","EntityConflictError","EntityNotFoundError","ValidationError","isError","isRawError","EntityType","EventName","EventScope","KeyStatus","KeyValidator","PermissionName","ValidatorGroup","arrayBufferToBase64","base64ToArrayBuffer","createNanoID","AbstractEntityService","AsymmetricKey","createAsymmetricKeyPair","JWKType","JWKUse","JWTAlgorithm","getRandomValues","buildEntityDiff","assertCertificateMatchesKey","isWrappedKeyMaterial","parseCertificateChain","appendQueryConditions","decodeQuery","keySchema","PERMISSION_NAMES","KEY_READ","KEY_UPDATE","KEY_DELETE","KeyService","repository","validator","eventService","requestContext","ctx","getMany","query","actor","options","permissionEvaluator","preEvaluateOneOf","name","parsed","schema","realmId","compiled","compile","verdict","condition","data","entities","meta","findMany","entity","decryptionKey","total","evaluateOneOf","ATTRIBUTES","resourceRealmMatch","push","getOne","idOrName","findOneByIdOrName","create","preEvaluate","KEY_CREATE","validated","run","group","CREATE","use","validateJoinColumns","identity","actorRealmId","getActorRealmId","evaluate","checkUniqueness","priority","highest","findHighestPriority","status","ACTIVE","certificate","SIGNATURE","material","importMaterial","generateMaterial","encryptionKey","chain","e","message","type","signatureAlgorithm","save","recordEvent","CREATED","update","UPDATE","previous","pickAuditFields","merge","diff","UPDATED","Object","keys","length","delete","id","findOneBy","ENCRYPTION","force","references","countBlobReferences","entityId","remove","forcedCryptoShred","DELETED","undefined","record","scope","ENTITY","refType","KEY","refId","actorType","actorId","actorName","requestPath","requestMethod","requestIpAddress","requestUserAgent","raw","Uint8Array","OCT","buffer","algorithm","RS256","buildAsymmetricOptions","keyPair","startsWith","EC","RSA","privateKey","toBase64","publicKey","trim","normalizeMaterial","byteLength","privateJwk","publicJwk","fromBase64","format","key","toJWK","components","mismatch","some","component","test","buildImportOptionsForJWTAlgorithm","value","includes","replace"],"sources":["../../../../src/core/entities/key/service.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 { BuiltInPolicyType, definePolicyData } from '@authup/access';\nimport { eq, inArray } from '@rapiq/core';\nimport {\n    EntityConflictError,\n    EntityNotFoundError,\n    ValidationError,\n    isError as isRawError,\n} from '@authup/errors';\nimport type { Key } from '@authup/core-kit';\nimport {\n    EntityType,\n    EventName,\n    EventScope,\n    KeyStatus,\n    KeyValidator,\n    PermissionName,\n} from '@authup/core-kit';\nimport {\n    ValidatorGroup,\n    arrayBufferToBase64,\n    base64ToArrayBuffer,\n    createNanoID,\n} from '@authup/kit';\nimport type { ActorContext, EntityRepositoryFindManyResult } from '@authup/server-kit';\nimport { AbstractEntityService, AsymmetricKey, createAsymmetricKeyPair } from '@authup/server-kit';\nimport { JWKType, JWKUse, JWTAlgorithm } from '@authup/specs';\nimport { getRandomValues } from 'uncrypto';\nimport { buildEntityDiff } from '../event/index.ts';\nimport type { EventRequestContext, IEventService } from '../event/index.ts';\nimport { assertCertificateMatchesKey, isWrappedKeyMaterial, parseCertificateChain } from '../../key/index.ts';\nimport type {\n    IKeyRepository, \n    IKeyService, \n    KeyDeleteOptions, \n    KeyServiceReadOptions,\n} from './types.ts';\nimport { appendQueryConditions, decodeQuery } from '../../query/index.ts';\nimport { keySchema } from './schema.ts';\n\nexport type KeyServiceContext = {\n    repository: IKeyRepository;\n    eventService?: IEventService;\n    requestContext?: () => EventRequestContext | undefined;\n};\n\nconst PERMISSION_NAMES = [\n    PermissionName.KEY_READ,\n    PermissionName.KEY_UPDATE,\n    PermissionName.KEY_DELETE,\n];\n\nexport class KeyService extends AbstractEntityService implements IKeyService {\n    protected repository: IKeyRepository;\n\n    protected validator: KeyValidator;\n\n    protected eventService?: IEventService;\n\n    protected requestContext?: () => EventRequestContext | undefined;\n\n    constructor(ctx: KeyServiceContext) {\n        super();\n        this.repository = ctx.repository;\n        this.validator = new KeyValidator();\n        this.eventService = ctx.eventService;\n        this.requestContext = ctx.requestContext;\n    }\n\n    async getMany(\n        query: Record<string, any>,\n        actor: ActorContext,\n        options: KeyServiceReadOptions = {},\n    ): Promise<EntityRepositoryFindManyResult<Key>> {\n        await actor.permissionEvaluator.preEvaluateOneOf({ name: PERMISSION_NAMES });\n\n        let parsed = await decodeQuery(query, { schema: keySchema, actor });\n        if (options.realmId) {\n            parsed = appendQueryConditions(parsed, eq('realmId', options.realmId));\n        }\n\n        // Compile the read permissions against the knowns (actor identity) into a\n        // row condition (issue #3286 phase 3): the authorization runs as WHERE, so\n        // pagination and totals stay exact. Non-expressible policies fall back to\n        // the per-row post-evaluation below.\n        const compiled = await actor.permissionEvaluator.compile({ name: PERMISSION_NAMES });\n        if (compiled.verdict === 'deny') {\n            // no row can pass — a constant-false condition keeps the meta shape\n            parsed = appendQueryConditions(parsed, inArray('id', []));\n        } else if (compiled.verdict === 'conditional') {\n            parsed = appendQueryConditions(parsed, compiled.condition);\n        }\n\n        const { data: entities, meta } = await this.repository.findMany(parsed);\n\n        if (compiled.verdict !== 'post') {\n            for (const entity of entities) {\n                // Belt-and-braces: the read projection never selects private\n                // material, but null it explicitly so no future adapter change\n                // can leak it onto a read surface (cf. authentik CVE-2024-42490).\n                entity.decryptionKey = null;\n            }\n\n            return { data: entities, meta };\n        }\n\n        const data: Key[] = [];\n        let { total } = meta;\n\n        for (const entity of entities) {\n            try {\n                await actor.permissionEvaluator.evaluateOneOf({\n                    name: PERMISSION_NAMES,\n                    data: definePolicyData({\n                        [BuiltInPolicyType.ATTRIBUTES]: entity,\n                        ...this.resourceRealmMatch(entity),\n                    }),\n                });\n                entity.decryptionKey = null;\n                data.push(entity);\n            } catch {\n                total -= 1;\n            }\n        }\n\n        return {\n            data,\n            meta: {\n                ...meta,\n                total,\n            },\n        };\n    }\n\n    async getOne(\n        idOrName: string,\n        actor: ActorContext,\n        realmId?: string,\n    ): Promise<Key> {\n        await actor.permissionEvaluator.preEvaluateOneOf({ name: PERMISSION_NAMES });\n\n        const entity = await this.repository.findOneByIdOrName(idOrName, realmId);\n        if (!entity) {\n            throw new EntityNotFoundError();\n        }\n\n        await actor.permissionEvaluator.evaluateOneOf({\n            name: PERMISSION_NAMES,\n            data: definePolicyData({\n                [BuiltInPolicyType.ATTRIBUTES]: entity,\n                ...this.resourceRealmMatch(entity),\n            }),\n        });\n\n        // Belt-and-braces null of private material (see getMany).\n        entity.decryptionKey = null;\n\n        return entity;\n    }\n\n    async create(\n        data: Record<string, any>,\n        actor: ActorContext,\n    ): Promise<Key> {\n        await actor.permissionEvaluator.preEvaluate({ name: PermissionName.KEY_CREATE });\n\n        const validated = await this.validator.run(data, { group: ValidatorGroup.CREATE });\n        const { use } = validated;\n        if (!use) {\n            throw new ValidationError('A key use must be specified.');\n        }\n\n        await this.repository.validateJoinColumns(validated);\n\n        if (!validated.realmId && actor.identity) {\n            const actorRealmId = this.getActorRealmId(actor);\n            if (actorRealmId) {\n                validated.realmId = actorRealmId;\n            }\n        }\n\n        // keys are realm-bound infrastructure — no global (null realm) keys\n        // via the API.\n        if (!validated.realmId) {\n            throw new ValidationError('A realm must be specified.');\n        }\n\n        await actor.permissionEvaluator.evaluate({\n            name: PermissionName.KEY_CREATE,\n            data: definePolicyData({\n                [BuiltInPolicyType.ATTRIBUTES]: validated,\n                ...this.resourceRealmMatch(validated),\n            }),\n        });\n\n        if (!validated.name) {\n            validated.name = `${use}-${createNanoID(10)}`;\n        }\n\n        await this.repository.checkUniqueness(validated);\n\n        if (typeof validated.priority !== 'number') {\n            const highest = await this.repository.findHighestPriority(validated.realmId, use);\n            // generate doubles as rotate: a new key outranks the current one.\n            validated.priority = typeof highest === 'number' ? highest + 1 : 0;\n        }\n\n        if (!validated.status) {\n            validated.status = KeyStatus.ACTIVE;\n        }\n\n        const certificate = typeof validated.certificate === 'string' ? validated.certificate : null;\n        if (certificate && (!validated.decryptionKey || use !== JWKUse.SIGNATURE)) {\n            throw new ValidationError('A certificate requires imported signature key material.');\n        }\n\n        const material = validated.decryptionKey ?\n            await this.importMaterial(validated, use) :\n            await this.generateMaterial(validated, use);\n\n        if (certificate) {\n            if (!material.encryptionKey) {\n                throw new ValidationError('A certificate requires imported signature key material.');\n            }\n\n            try {\n                const chain = parseCertificateChain(certificate);\n                assertCertificateMatchesKey(chain, material.encryptionKey);\n            } catch (e) {\n                throw new ValidationError(\n                    isRawError(e) ?\n                        e.message :\n                        'The certificate could not be matched against the imported key material.',\n                );\n            }\n        }\n\n        let entity = this.repository.create({\n            ...validated,\n            type: material.type,\n            signatureAlgorithm: material.signatureAlgorithm,\n            decryptionKey: material.decryptionKey,\n            encryptionKey: material.encryptionKey,\n        });\n\n        entity = await this.repository.save(entity);\n\n        // private material never leaves the server — the response carries\n        // metadata + public part only (authentik CVE-2024-42490).\n        entity.decryptionKey = null;\n\n        await this.recordEvent(EventName.CREATED, entity, actor);\n\n        return entity;\n    }\n\n    async update(\n        idOrName: string,\n        data: Record<string, any>,\n        actor: ActorContext,\n        realmId?: string,\n    ): Promise<Key> {\n        await actor.permissionEvaluator.preEvaluate({ name: PermissionName.KEY_UPDATE });\n\n        let entity = await this.repository.findOneByIdOrName(idOrName, realmId);\n        if (!entity) {\n            throw new EntityNotFoundError();\n        }\n\n        // only name / priority / status are mounted for UPDATE — material,\n        // use, type and realm are immutable.\n        const validated = await this.validator.run(data, { group: ValidatorGroup.UPDATE });\n\n        await actor.permissionEvaluator.evaluate({\n            name: PermissionName.KEY_UPDATE,\n            data: definePolicyData({\n                [BuiltInPolicyType.ATTRIBUTES]: {\n                    ...entity,\n                    ...validated,\n                },\n                ...this.resourceRealmMatch(entity),\n            }),\n        });\n\n        if (validated.name && validated.name !== entity.name) {\n            await this.repository.checkUniqueness({\n                name: validated.name,\n                realmId: entity.realmId,\n            }, entity);\n        }\n\n        const previous = this.pickAuditFields(entity);\n\n        entity = this.repository.merge(entity, validated);\n        await this.repository.save(entity);\n\n        entity.decryptionKey = null;\n\n        const diff = buildEntityDiff(this.pickAuditFields(entity), previous);\n        await this.recordEvent(EventName.UPDATED, entity, actor, { ...(Object.keys(diff).length > 0 ? { diff } : {}) });\n\n        return entity;\n    }\n\n    async delete(\n        id: string,\n        actor: ActorContext,\n        options: KeyDeleteOptions = {},\n    ): Promise<Key> {\n        await actor.permissionEvaluator.preEvaluate({ name: PermissionName.KEY_DELETE });\n\n        const entity = await this.repository.findOneBy({ id });\n        if (!entity) {\n            throw new EntityNotFoundError();\n        }\n\n        await actor.permissionEvaluator.evaluate({\n            name: PermissionName.KEY_DELETE,\n            data: definePolicyData({\n                [BuiltInPolicyType.ATTRIBUTES]: entity,\n                ...this.resourceRealmMatch(entity),\n            }),\n        });\n\n        if (entity.use === JWKUse.ENCRYPTION && !options.force) {\n            const references = await this.repository.countBlobReferences(entity.id);\n            if (references > 0) {\n                throw new EntityConflictError({\n                    message: `The encryption key is still referenced by ${references} encrypted secret(s) — ` +\n                        'deleting it makes them unrecoverable. Repeat with force to crypto-shred them.',\n                    data: { references },\n                });\n            }\n        }\n\n        const { id: entityId } = entity;\n        await this.repository.remove(entity);\n        entity.id = entityId;\n        entity.decryptionKey = null;\n\n        // force only carries crypto-shred semantics for encryption keys — a\n        // sig-key delete with a stray force flag must not read as a shred.\n        const forcedCryptoShred = entity.use === JWKUse.ENCRYPTION && !!options.force;\n        await this.recordEvent(EventName.DELETED, entity, actor, { ...(forcedCryptoShred ? { force: true } : {}) });\n\n        return entity;\n    }\n\n    // ------------------------------------------------------------------\n\n    /**\n     * Metadata-only audit trail for key lifecycle operations (issue #3269) —\n     * keys deliberately have no entity subscriber (private material must stay\n     * off the realtime/audit bus), so the security-relevant mutations are\n     * recorded explicitly. The payload never carries key material.\n     */\n    protected async recordEvent(\n        name: `${EventName}`,\n        entity: Key,\n        actor: ActorContext,\n        data: Record<string, any> = {},\n    ): Promise<void> {\n        const requestContext = this.requestContext ?\n            this.requestContext() :\n            undefined;\n\n        await this.eventService?.record({\n            scope: EventScope.ENTITY,\n            name,\n            refType: EntityType.KEY,\n            refId: entity.id,\n            realmId: entity.realmId ?? null,\n            actorType: actor.identity?.type ?? null,\n            actorId: actor.identity?.data.id ?? null,\n            actorName: actor.identity?.data.name ?? null,\n            requestPath: requestContext?.requestPath ?? null,\n            requestMethod: requestContext?.requestMethod ?? null,\n            requestIpAddress: requestContext?.requestIpAddress ?? null,\n            requestUserAgent: requestContext?.requestUserAgent ?? null,\n            data: {\n                name: entity.name,\n                use: entity.use,\n                status: entity.status,\n                ...data,\n            },\n        });\n    }\n\n    protected pickAuditFields(entity: Key): Record<string, any> {\n        return {\n            name: entity.name,\n            priority: entity.priority,\n            status: entity.status,\n        };\n    }\n\n    protected async generateMaterial(\n        validated: Partial<Key>,\n        use: `${JWKUse}`,\n    ) : Promise<{\n        type: `${JWKType}`,\n        signatureAlgorithm: `${JWTAlgorithm}` | null,\n        decryptionKey: string,\n        encryptionKey: string | null,\n    }> {\n        if (use === JWKUse.ENCRYPTION) {\n            if (validated.signatureAlgorithm) {\n                throw new ValidationError('An encryption key can not carry a signature algorithm.');\n            }\n\n            const raw = new Uint8Array(32);\n            getRandomValues(raw);\n\n            return {\n                type: JWKType.OCT,\n                signatureAlgorithm: null,\n                decryptionKey: arrayBufferToBase64(raw.buffer),\n                encryptionKey: null,\n            };\n        }\n\n        const algorithm = validated.signatureAlgorithm ?? JWTAlgorithm.RS256;\n        const options = this.buildAsymmetricOptions(algorithm);\n\n        const keyPair = await createAsymmetricKeyPair(options);\n\n        return {\n            type: algorithm.startsWith('ES') ? JWKType.EC : JWKType.RSA,\n            signatureAlgorithm: algorithm,\n            decryptionKey: await new AsymmetricKey(keyPair.privateKey).toBase64(),\n            encryptionKey: await new AsymmetricKey(keyPair.publicKey).toBase64(),\n        };\n    }\n\n    protected async importMaterial(\n        validated: Partial<Key>,\n        use: `${JWKUse}`,\n    ) : Promise<{\n        type: `${JWKType}`,\n        signatureAlgorithm: `${JWTAlgorithm}` | null,\n        decryptionKey: string,\n        encryptionKey: string | null,\n    }> {\n        if (!validated.decryptionKey) {\n            throw new ValidationError('Importing key material requires its private part (decryptionKey).');\n        }\n\n        // Reject material masquerading as an at-rest KEK-wrapped blob — it\n        // would be treated as wrapped on the next read (and, with a KEK,\n        // fail GCM authentication).\n        if (isWrappedKeyMaterial(validated.decryptionKey.trim())) {\n            throw new ValidationError('The imported key material is not valid.');\n        }\n\n        const decryptionKey = this.normalizeMaterial(validated.decryptionKey);\n\n        if (use === JWKUse.ENCRYPTION) {\n            if (validated.signatureAlgorithm) {\n                throw new ValidationError('An encryption key can not carry a signature algorithm.');\n            }\n\n            if (validated.encryptionKey) {\n                throw new ValidationError('An encryption key holds no public part.');\n            }\n\n            let byteLength : number;\n            try {\n                byteLength = base64ToArrayBuffer(decryptionKey).byteLength;\n            } catch {\n                throw new ValidationError('The key material is not valid base64.');\n            }\n\n            if (byteLength !== 32) {\n                throw new ValidationError('The key material must be 32 base64-encoded bytes.');\n            }\n\n            return {\n                type: JWKType.OCT,\n                signatureAlgorithm: null,\n                decryptionKey,\n                encryptionKey: null,\n            };\n        }\n\n        if (!validated.encryptionKey) {\n            throw new ValidationError('Importing a signature key requires its public part (encryptionKey, SPKI).');\n        }\n\n        const encryptionKey = this.normalizeMaterial(validated.encryptionKey);\n        const algorithm = validated.signatureAlgorithm ?? JWTAlgorithm.RS256;\n        const options = this.buildAsymmetricOptions(algorithm);\n\n        let privateJwk : JsonWebKey;\n        let publicJwk : JsonWebKey;\n\n        try {\n            const privateKey = await AsymmetricKey.fromBase64({\n                format: 'pkcs8',\n                key: decryptionKey,\n                options,\n            });\n            const publicKey = await AsymmetricKey.fromBase64({\n                format: 'spki',\n                key: encryptionKey,\n                options,\n            });\n\n            privateJwk = await privateKey.toJWK();\n            publicJwk = await publicKey.toJWK();\n        } catch {\n            throw new ValidationError(`The key material could not be imported for ${algorithm}.`);\n        }\n\n        // the public components (RSA: n/e, EC: crv/x/y) must agree — a\n        // private key paired with a foreign public part would publish a\n        // wrong JWKS entry and break verification of every token it signs.\n        const components : (keyof JsonWebKey)[] = ['kty', 'n', 'e', 'crv', 'x', 'y'];\n        const mismatch = components.some(\n            (component) => publicJwk[component] !== undefined &&\n                publicJwk[component] !== privateJwk[component],\n        );\n        if (mismatch) {\n            throw new ValidationError('The private and public key material do not form a pair.');\n        }\n\n        return {\n            type: algorithm.startsWith('ES') ? JWKType.EC : JWKType.RSA,\n            signatureAlgorithm: algorithm,\n            decryptionKey,\n            encryptionKey,\n        };\n    }\n\n    protected buildAsymmetricOptions(algorithm: `${JWTAlgorithm}`) {\n        if (!/^(RS|ES)(256|384|512)$/.test(algorithm)) {\n            throw new ValidationError(`The signature algorithm ${algorithm} is not supported for stored keys.`);\n        }\n\n        return AsymmetricKey.buildImportOptionsForJWTAlgorithm(algorithm);\n    }\n\n    protected normalizeMaterial(value: string) : string {\n        if (value.includes('-----BEGIN')) {\n            // PEM body IS base64 DER — strip armor + whitespace.\n            return value\n                .replace(/-----(BEGIN|END)[^-]+-----/g, '')\n                .replace(/\\s+/g, '');\n        }\n\n        return value.trim();\n    }\n}\n"],"mappings":"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"}

package/dist/core/entities/key/types.d.ts

@@ -16,6 +16,14 @@ export interface IKeyRepository extends IEntityRepository<Key> {
      */
     findHighestPriority(realmId: string, use: string): Promise<number | null>;
 }
+export type KeyServiceReadOptions = {
+    /**
+     * Route-scoped realm (nested `/realms/:realmId/keys` mount) —
+     * appended onto the decoded query IR as a non-displaceable
+     * `realmId` condition.
+     */
+    realmId?: string;
+};
 export type KeyDeleteOptions = {
     /**
      * Delete an enc key even while cipher blobs still reference it
@@ -24,7 +32,7 @@ export type KeyDeleteOptions = {
     force?: boolean;
 };
 export interface IKeyService {
-    getMany(query: Record<string, any>, actor: ActorContext): Promise<EntityRepositoryFindManyResult<Key>>;
+    getMany(query: Record<string, any>, actor: ActorContext, options?: KeyServiceReadOptions): Promise<EntityRepositoryFindManyResult<Key>>;
     getOne(idOrName: string, actor: ActorContext, realmId?: string): Promise<Key>;
     create(data: Record<string, any>, actor: ActorContext): Promise<Key>;
     update(idOrName: string, data: Record<string, any>, actor: ActorContext, realmId?: string): Promise<Key>;

package/dist/core/entities/key/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/key/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1G,MAAM,WAAW,cAAe,SAAQ,iBAAiB,CAAC,GAAG,CAAC;IAC1D,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;;;;OAMG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpD;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7E;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,WAAW;IACxB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,8BAA8B,CAAC,GAAG,CAAC,CAAC,CAAC;IACvG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9E,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACrF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/key/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1G,MAAM,WAAW,cAAe,SAAQ,iBAAiB,CAAC,GAAG,CAAC;IAC1D,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;;;;OAMG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpD;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7E;AAED,MAAM,MAAM,qBAAqB,GAAG;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,WAAW;IACxB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,8BAA8B,CAAC,GAAG,CAAC,CAAC,CAAC;IACxI,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9E,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACrF"}

package/dist/core/entities/permission/index.d.ts

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

package/dist/core/entities/permission/index.d.ts.map

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

package/dist/core/entities/permission/index.mjs

@@ -1,5 +1,6 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { permissionSchema } from "./schema.mjs";
 import { PermissionService } from "./service.mjs";
-export { PermissionService };
+export { PermissionService, permissionSchema };

package/dist/core/entities/permission/schema.d.ts

@@ -0,0 +1,3 @@
+import type { Permission } from '@authup/core-kit';
+export declare const permissionSchema: import("@rapiq/core").Schema<Permission, any>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/entities/permission/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/permission/schema.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,eAAO,MAAM,gBAAgB,+CAM3B,CAAC"}

package/dist/core/entities/permission/schema.mjs

@@ -0,0 +1,28 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { EntityType } from "@authup/core-kit";
+import { defineSchema } from "@rapiq/core";
+//#region src/core/entities/permission/schema.ts
+const permissionSchema = defineSchema({
+	name: EntityType.PERMISSION,
+	filters: { allowed: [
+		"id",
+		"displayName",
+		"name",
+		"builtIn",
+		"realmId"
+	] },
+	relations: { allowed: [] },
+	sort: { allowed: [
+		"id",
+		"name",
+		"createdAt",
+		"updatedAt"
+	] },
+	pagination: { maxLimit: 50 }
+});
+//#endregion
+export { permissionSchema };
+
+//# sourceMappingURL=schema.mjs.map

package/dist/core/entities/permission/schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.mjs","names":["defineSchema","EntityType","permissionSchema","name","PERMISSION","filters","allowed","relations","sort","pagination","maxLimit"],"sources":["../../../../src/core/entities/permission/schema.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 { defineSchema } from '@rapiq/core';\nimport type { Permission } from '@authup/core-kit';\nimport { EntityType } from '@authup/core-kit';\n\nexport const permissionSchema = defineSchema<Permission>({\n    name: EntityType.PERMISSION,\n    filters: { allowed: ['id', 'displayName', 'name', 'builtIn', 'realmId'] },\n    relations: { allowed: [] },\n    sort: { allowed: ['id', 'name', 'createdAt', 'updatedAt'] },\n    pagination: { maxLimit: 50 },\n});\n"],"mappings":";;;;;;AAWA,MAAaE,mBAAmBF,aAAyB;CACrDG,MAAMF,WAAWG;CACjBC,SAAS,EAAEC,SAAS;EAAC;EAAM;EAAe;EAAQ;EAAW;GAAW;CACxEC,WAAW,EAAED,SAAS,CAAA,EAAG;CACzBE,MAAM,EAAEF,SAAS;EAAC;EAAM;EAAQ;EAAa;GAAa;CAC1DG,YAAY,EAAEC,UAAU,GAAG;AAC/B,CAAA"}

package/dist/core/entities/permission/service.d.ts

@@ -45,12 +45,17 @@ export declare class PermissionService extends AbstractEntityService implements
     /**
      * Assign a newly created permission to the global admin role.
      * The admin role receives every permission without policy restrictions.
+     *
+     * Throws when the admin role is not provisioned: without an admin grant the
+     * permission is bound by `system.default` yet held by nobody, and the uniform
+     * member gate on junction creation makes it permanently un-grantable (even by
+     * admin). Fail loud so the stranded state is surfaced instead of swallowed.
      */
     private assignToAdminRole;
     /**
      * Assign a newly created permission to all matching realm_admin roles.
      *
-     * Uses differentiated realm_scope on the junction:
+     * Uses differentiated realmScope on the junction:
      * - CUD on global-capable entity types → own (strictly own realm)
      * - Everything else → ownOrNull (own realm + null/global resources)
      *
@@ -60,7 +65,7 @@ export declare class PermissionService extends AbstractEntityService implements
      *
      * Excluded:
      * - Realm CRUD permissions (realm_create, realm_update, realm_delete)
-     * - Custom global permissions (non-built-in with realm_id: null)
+     * - Custom global permissions (non-built-in with realmId: null)
      */
     private assignToRealmAdminRoles;
 }

package/dist/core/entities/permission/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/permission/service.ts"],"names":[],"mappings":"AAeA,OAAO,EAEH,mBAAmB,EAGtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B,EAAG,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA0C5E,MAAM,MAAM,wBAAwB,GAAG;IACnC,UAAU,EAAE,qBAAqB,CAAC;IAClC,eAAe,EAAE,gBAAgB,CAAC;IAClC,cAAc,EAAE,eAAe,CAAC;IAChC,wBAAwB,EAAE,yBAAyB,CAAC;IACpD,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,0BAA0B,EAAE,2BAA2B,CAAC;CAC3D,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,qBAAsB,YAAW,kBAAkB;IACtF,SAAS,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAE5C,SAAS,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE5C,SAAS,CAAC,cAAc,EAAE,eAAe,CAAC;IAE1C,SAAS,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;IAE9D,SAAS,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAE9C,SAAS,CAAC,0BAA0B,EAAE,2BAA2B,CAAC;IAElE,SAAS,CAAC,SAAS,EAAE,mBAAmB,CAAC;gBAE7B,GAAG,EAAE,wBAAwB;IAWnC,OAAO,CACT,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,8BAA8B,CAAC,UAAU,CAAC,CAAC;IAYhD,MAAM,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC;IAiBhB,MAAM,CACR,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,UAAU,CAAC;IAKhB,MAAM,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,UAAU,CAAC;IAKhB,IAAI,CACN,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACvC,OAAO,CAAC;QACP,MAAM,EAAE,UAAU,CAAC;QACnB,OAAO,EAAE,OAAO,CAAA;KACnB,CAAC;IAgGI,MAAM,CACR,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,UAAU,CAAC;IAwBtB;;;;OAIG;YACW,mBAAmB;IAuBjC;;;OAGG;YACW,iBAAiB;IAyB/B;;;;;;;;;;;;;;OAcG;YACW,uBAAuB;CAuCxC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/permission/service.ts"],"names":[],"mappings":"AAeA,OAAO,EAEH,mBAAmB,EAGtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B,EAAG,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAyC5E,MAAM,MAAM,wBAAwB,GAAG;IACnC,UAAU,EAAE,qBAAqB,CAAC;IAClC,eAAe,EAAE,gBAAgB,CAAC;IAClC,cAAc,EAAE,eAAe,CAAC;IAChC,wBAAwB,EAAE,yBAAyB,CAAC;IACpD,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,0BAA0B,EAAE,2BAA2B,CAAC;CAC3D,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,qBAAsB,YAAW,kBAAkB;IACtF,SAAS,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAE5C,SAAS,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE5C,SAAS,CAAC,cAAc,EAAE,eAAe,CAAC;IAE1C,SAAS,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;IAE9D,SAAS,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAE9C,SAAS,CAAC,0BAA0B,EAAE,2BAA2B,CAAC;IAElE,SAAS,CAAC,SAAS,EAAE,mBAAmB,CAAC;gBAE7B,GAAG,EAAE,wBAAwB;IAWnC,OAAO,CACT,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,8BAA8B,CAAC,UAAU,CAAC,CAAC;IAYhD,MAAM,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC;IAiBhB,MAAM,CACR,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,UAAU,CAAC;IAKhB,MAAM,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,UAAU,CAAC;IAKhB,IAAI,CACN,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACvC,OAAO,CAAC;QACP,MAAM,EAAE,UAAU,CAAC;QACnB,OAAO,EAAE,OAAO,CAAA;KACnB,CAAC;IAmHI,MAAM,CACR,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,UAAU,CAAC;IAwBtB;;;;OAIG;YACW,mBAAmB;IAuBjC;;;;;;;;OAQG;YACW,iBAAiB;IAyB/B;;;;;;;;;;;;;;OAcG;YACW,uBAAuB;CAuCxC"}