@technomoron/apicore-server 1.0.0-beta.1

package/dist/esm/oauth/memory.js

@@ -0,0 +1,128 @@
+import bcrypt from 'bcryptjs';
+import { normalizeComparableUserId } from '../auth-api/user-id.js';
+import { OAuthStore } from './base.js';
+function cloneClient(client) {
+    if (!client) {
+        return null;
+    }
+    return {
+        clientId: client.clientId,
+        hasSecret: Boolean(client.clientSecret),
+        name: client.name,
+        redirectUris: [...client.redirectUris],
+        scope: client.scope ? [...client.scope] : undefined,
+        metadata: client.metadata ? JSON.parse(JSON.stringify(client.metadata)) : undefined,
+        firstParty: client.firstParty
+    };
+}
+function cloneCode(code) {
+    return {
+        ...code,
+        userId: normalizeComparableUserId(code.userId),
+        scope: code.scope ? [...code.scope] : undefined,
+        expiresAt: new Date(code.expiresAt),
+        metadata: code.metadata ? { ...code.metadata } : undefined
+    };
+}
+export class MemoryOAuthStore extends OAuthStore {
+    constructor(options = {}) {
+        super();
+        this.clients = new Map();
+        this.codes = new Map();
+        this.bcryptRounds = options.bcryptRounds ?? 12;
+        this.maxClients =
+            typeof options.maxClients === 'number' && Number.isFinite(options.maxClients) && options.maxClients > 0
+                ? Math.floor(options.maxClients)
+                : undefined;
+        this.maxAuthCodes =
+            typeof options.maxAuthCodes === 'number' &&
+                Number.isFinite(options.maxAuthCodes) &&
+                options.maxAuthCodes > 0
+                ? Math.floor(options.maxAuthCodes)
+                : undefined;
+    }
+    async getClient(clientId) {
+        return cloneClient(this.clients.get(clientId));
+    }
+    async createClient(input) {
+        const clientSecret = input.clientSecret ? await bcrypt.hash(input.clientSecret, this.bcryptRounds) : '';
+        const stored = {
+            clientId: input.clientId,
+            clientSecret,
+            name: input.name,
+            redirectUris: [...input.redirectUris],
+            scope: input.scope ? [...input.scope] : undefined,
+            metadata: input.metadata ? { ...input.metadata } : undefined,
+            firstParty: input.firstParty
+        };
+        this.clients.set(stored.clientId, stored);
+        this.enforceClientCapacity();
+        return cloneClient(stored);
+    }
+    async verifyClientSecret(clientId, secret) {
+        const client = this.clients.get(clientId);
+        if (!client) {
+            return false;
+        }
+        if (!client.clientSecret) {
+            return !secret || secret.length === 0;
+        }
+        if (!secret) {
+            return false;
+        }
+        return bcrypt.compare(secret, client.clientSecret);
+    }
+    async createAuthCode(code) {
+        const record = {
+            ...code,
+            userId: normalizeComparableUserId(code.userId),
+            scope: code.scope ? [...code.scope] : undefined,
+            expiresAt: code.expiresAt,
+            metadata: code.metadata ? { ...code.metadata } : undefined
+        };
+        this.codes.set(record.code, record);
+        this.enforceCodeCapacity();
+    }
+    async consumeAuthCode(code, clientId) {
+        const record = this.codes.get(code);
+        if (!record) {
+            return null;
+        }
+        if (clientId && record.clientId !== clientId) {
+            return null;
+        }
+        if (record.expiresAt.getTime() <= Date.now()) {
+            this.codes.delete(code);
+            return null;
+        }
+        this.codes.delete(code);
+        return cloneCode(record);
+    }
+    async close() {
+        return;
+    }
+    enforceClientCapacity() {
+        if (!this.maxClients) {
+            return;
+        }
+        while (this.clients.size > this.maxClients) {
+            const oldest = this.clients.keys().next().value;
+            if (!oldest) {
+                return;
+            }
+            this.clients.delete(oldest);
+        }
+    }
+    enforceCodeCapacity() {
+        if (!this.maxAuthCodes) {
+            return;
+        }
+        while (this.codes.size > this.maxAuthCodes) {
+            const oldest = this.codes.keys().next().value;
+            if (!oldest) {
+                return;
+            }
+            this.codes.delete(oldest);
+        }
+    }
+}

package/dist/esm/oauth/models.d.ts

@@ -0,0 +1,50 @@
+import { Model, type Optional, type Sequelize } from 'sequelize';
+export { integerIdType, tableOptions } from '../sequelize-utils.js';
+export interface OAuthClientAttributes {
+    client_id: string;
+    client_secret: string;
+    name: string | null;
+    redirect_uris: string;
+    scope: string;
+    metadata: string | null;
+    first_party: boolean;
+}
+export type OAuthClientCreationAttributes = Optional<OAuthClientAttributes, 'client_secret' | 'name' | 'scope' | 'metadata' | 'first_party'>;
+export declare class OAuthClientModel extends Model<OAuthClientAttributes, OAuthClientCreationAttributes> implements OAuthClientAttributes {
+    client_id: string;
+    client_secret: string;
+    name: string | null;
+    redirect_uris: string;
+    scope: string;
+    metadata: string | null;
+    first_party: boolean;
+}
+export declare function initOAuthClientModel(sequelize: Sequelize, options?: {
+    tablePrefix?: string;
+}): typeof OAuthClientModel;
+export interface OAuthCodeAttributes {
+    code: string;
+    client_id: string;
+    user_id: number;
+    redirect_uri: string;
+    scope: string;
+    code_challenge: string | null;
+    code_challenge_method: 'plain' | 'S256' | null;
+    expires: Date;
+    metadata: string | null;
+}
+export type OAuthCodeCreationAttributes = Optional<OAuthCodeAttributes, 'code_challenge' | 'code_challenge_method' | 'metadata'>;
+export declare class OAuthCodeModel extends Model<OAuthCodeAttributes, OAuthCodeCreationAttributes> implements OAuthCodeAttributes {
+    code: string;
+    client_id: string;
+    user_id: number;
+    redirect_uri: string;
+    scope: string;
+    code_challenge: string | null;
+    code_challenge_method: 'plain' | 'S256' | null;
+    expires: Date;
+    metadata: string | null;
+}
+export declare function initOAuthCodeModel(sequelize: Sequelize, options?: {
+    tablePrefix?: string;
+}): typeof OAuthCodeModel;

package/dist/esm/oauth/models.js

@@ -0,0 +1,38 @@
+import { DataTypes, Model } from 'sequelize';
+import { integerIdType, tableOptions } from '../sequelize-utils.js';
+export { integerIdType, tableOptions } from '../sequelize-utils.js';
+export class OAuthClientModel extends Model {
+}
+export function initOAuthClientModel(sequelize, options = {}) {
+    OAuthClientModel.init({
+        client_id: { type: DataTypes.STRING(128), allowNull: false, primaryKey: true },
+        client_secret: { type: DataTypes.STRING(255), allowNull: false, defaultValue: '' },
+        name: { type: DataTypes.STRING(128), allowNull: true, defaultValue: null },
+        redirect_uris: { type: DataTypes.TEXT, allowNull: false, defaultValue: '[]' },
+        scope: { type: DataTypes.TEXT, allowNull: false, defaultValue: '[]' },
+        metadata: { type: DataTypes.TEXT, allowNull: true, defaultValue: null },
+        first_party: { type: DataTypes.BOOLEAN, allowNull: false, defaultValue: false }
+    }, {
+        ...tableOptions(sequelize, 'oauth_clients', options.tablePrefix, { timestamps: false })
+    });
+    return OAuthClientModel;
+}
+export class OAuthCodeModel extends Model {
+}
+export function initOAuthCodeModel(sequelize, options = {}) {
+    const idType = integerIdType(sequelize);
+    OAuthCodeModel.init({
+        code: { type: DataTypes.STRING(128), allowNull: false, primaryKey: true },
+        client_id: { type: DataTypes.STRING(128), allowNull: false },
+        user_id: { type: idType, allowNull: false },
+        redirect_uri: { type: DataTypes.TEXT, allowNull: false },
+        scope: { type: DataTypes.TEXT, allowNull: false, defaultValue: '[]' },
+        code_challenge: { type: DataTypes.STRING(255), allowNull: true, defaultValue: null },
+        code_challenge_method: { type: DataTypes.STRING(10), allowNull: true, defaultValue: null },
+        expires: { type: DataTypes.DATE, allowNull: false },
+        metadata: { type: DataTypes.TEXT, allowNull: true, defaultValue: null }
+    }, {
+        ...tableOptions(sequelize, 'oauth_codes', options.tablePrefix, { timestamps: false })
+    });
+    return OAuthCodeModel;
+}

package/dist/esm/oauth/sequelize.d.ts

@@ -0,0 +1,30 @@
+import { OAuthStore, type AuthCode, type OAuthClient } from './base.js';
+import { OAuthClientModel, OAuthCodeModel } from './models.js';
+export interface SequelizeOAuthStoreOptions {
+    sequelize: import('sequelize').Sequelize;
+    tablePrefix?: string;
+    clientModel?: typeof OAuthClientModel;
+    codeModel?: typeof OAuthCodeModel;
+    clientModelFactory?: (sequelize: import('sequelize').Sequelize, options?: {
+        tablePrefix?: string;
+    }) => typeof OAuthClientModel;
+    codeModelFactory?: (sequelize: import('sequelize').Sequelize, options?: {
+        tablePrefix?: string;
+    }) => typeof OAuthCodeModel;
+    bcryptRounds?: number;
+}
+export { OAuthClientModel, OAuthCodeModel, initOAuthClientModel, initOAuthCodeModel, type OAuthClientAttributes, type OAuthClientCreationAttributes, type OAuthCodeAttributes, type OAuthCodeCreationAttributes } from './models.js';
+export declare class SequelizeOAuthStore extends OAuthStore {
+    private readonly clients;
+    private readonly codes;
+    private readonly bcryptRounds;
+    constructor(options: SequelizeOAuthStoreOptions);
+    getClient(clientId: string): Promise<OAuthClient | null>;
+    createClient(input: OAuthClient): Promise<OAuthClient>;
+    verifyClientSecret(clientId: string, clientSecret: string | null): Promise<boolean>;
+    createAuthCode(code: AuthCode): Promise<void>;
+    consumeAuthCode(code: string, clientId?: string): Promise<AuthCode | null>;
+    close(): Promise<void>;
+    private toOAuthClient;
+    private toAuthCode;
+}

package/dist/esm/oauth/sequelize.js

@@ -0,0 +1,148 @@
+import bcrypt from 'bcryptjs';
+import { Transaction } from 'sequelize';
+import { normalizeNumericUserId } from '../auth-api/user-id.js';
+import { decodeStringArray, encodeStringArray } from '../sequelize-utils.js';
+import { OAuthStore } from './base.js';
+import { initOAuthClientModel, initOAuthCodeModel } from './models.js';
+export { OAuthClientModel, OAuthCodeModel, initOAuthClientModel, initOAuthCodeModel } from './models.js';
+function serializeMetadata(metadata) {
+    if (!metadata) {
+        return null;
+    }
+    return JSON.stringify(metadata);
+}
+function parseMetadata(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object') {
+            return parsed;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return undefined;
+}
+export class SequelizeOAuthStore extends OAuthStore {
+    constructor(options) {
+        super();
+        if (!options?.sequelize) {
+            throw new Error('SequelizeOAuthStore requires an initialised Sequelize instance');
+        }
+        this.clients =
+            options.clientModel ??
+                (options.clientModelFactory ?? initOAuthClientModel)(options.sequelize, {
+                    tablePrefix: options.tablePrefix
+                });
+        this.codes =
+            options.codeModel ??
+                (options.codeModelFactory ?? initOAuthCodeModel)(options.sequelize, {
+                    tablePrefix: options.tablePrefix
+                });
+        this.bcryptRounds = options.bcryptRounds ?? 12;
+    }
+    async getClient(clientId) {
+        const model = await this.clients.findByPk(clientId);
+        return model ? this.toOAuthClient(model) : null;
+    }
+    async createClient(input) {
+        const existing = await this.clients.findByPk(input.clientId);
+        const hashedSecret = input.clientSecret !== undefined && input.clientSecret !== null
+            ? await bcrypt.hash(input.clientSecret, this.bcryptRounds)
+            : (existing?.client_secret ?? '');
+        const redirectUris = input.redirectUris ?? (existing ? decodeStringArray(existing.redirect_uris) : undefined);
+        const scope = input.scope ?? (existing ? decodeStringArray(existing.scope) : undefined);
+        const metadata = input.metadata ?? (existing ? parseMetadata(existing.metadata) : undefined);
+        await this.clients.upsert({
+            client_id: input.clientId,
+            client_secret: hashedSecret,
+            name: input.name ?? existing?.name ?? null,
+            redirect_uris: encodeStringArray(redirectUris),
+            scope: encodeStringArray(scope),
+            metadata: serializeMetadata(metadata),
+            first_party: input.firstParty ?? existing?.first_party ?? false
+        });
+        const model = await this.clients.findByPk(input.clientId);
+        if (!model) {
+            throw new Error(`Unable to persist OAuth client ${input.clientId}`);
+        }
+        return this.toOAuthClient(model);
+    }
+    async verifyClientSecret(clientId, clientSecret) {
+        const model = await this.clients.findByPk(clientId);
+        if (!model) {
+            return false;
+        }
+        if (!model.client_secret) {
+            return !clientSecret || clientSecret.length === 0;
+        }
+        if (!clientSecret) {
+            return false;
+        }
+        return bcrypt.compare(clientSecret, model.client_secret);
+    }
+    async createAuthCode(code) {
+        await this.codes.create({
+            code: code.code,
+            client_id: code.clientId,
+            user_id: normalizeNumericUserId(code.userId),
+            redirect_uri: code.redirectUri ?? '',
+            scope: encodeStringArray(code.scope),
+            code_challenge: code.codeChallenge ?? null,
+            code_challenge_method: code.codeChallengeMethod ?? null,
+            expires: code.expiresAt,
+            metadata: serializeMetadata(code.metadata)
+        });
+    }
+    async consumeAuthCode(code, clientId) {
+        const sequelize = this.codes.sequelize;
+        if (!sequelize) {
+            throw new Error('Code model is not bound to a Sequelize instance');
+        }
+        return sequelize.transaction({ isolationLevel: Transaction.ISOLATION_LEVELS.READ_COMMITTED }, async (transaction) => {
+            const where = { code };
+            if (clientId) {
+                where.client_id = clientId;
+            }
+            const model = await this.codes.findOne({ where, transaction, lock: true });
+            if (!model) {
+                return null;
+            }
+            await model.destroy({ transaction });
+            if (model.expires.getTime() <= Date.now()) {
+                return null;
+            }
+            return this.toAuthCode(model);
+        });
+    }
+    async close() {
+        return;
+    }
+    toOAuthClient(model) {
+        return {
+            clientId: model.client_id,
+            hasSecret: Boolean(model.client_secret),
+            name: model.name ?? undefined,
+            redirectUris: decodeStringArray(model.redirect_uris),
+            scope: decodeStringArray(model.scope),
+            metadata: parseMetadata(model.metadata),
+            firstParty: model.first_party ?? false
+        };
+    }
+    toAuthCode(model) {
+        return {
+            code: model.code,
+            clientId: model.client_id,
+            userId: String(model.user_id),
+            redirectUri: model.redirect_uri,
+            scope: decodeStringArray(model.scope),
+            codeChallenge: model.code_challenge ?? undefined,
+            codeChallengeMethod: model.code_challenge_method ?? undefined,
+            expiresAt: model.expires,
+            metadata: parseMetadata(model.metadata)
+        };
+    }
+}

package/dist/esm/oauth/types.d.ts

@@ -0,0 +1,51 @@
+import type { AuthIdentifier } from '../auth-api/types.js';
+export interface OAuthClient {
+    clientId: string;
+    clientSecret?: string;
+    hasSecret?: boolean;
+    firstParty?: boolean;
+    metadata?: Record<string, unknown>;
+    name?: string;
+    redirectUris: string[];
+    scope?: string[];
+}
+export interface AuthCodeData {
+    code: string;
+    clientId: string;
+    codeChallenge?: string;
+    codeChallengeMethod?: 'plain' | 'S256';
+    expiresAt: Date;
+    metadata?: Record<string, unknown>;
+    redirectUri?: string;
+    scope?: string[];
+    userId: AuthIdentifier;
+}
+export type AuthCode = AuthCodeData;
+export type AuthCodeRequest = Omit<AuthCodeData, 'code' | 'expiresAt'> & {
+    code?: string;
+    expiresInSeconds?: number;
+};
+export interface OAuthStartParams {
+    provider: string;
+    redirectUri?: string;
+    scope?: string | string[];
+    state?: string;
+    extras?: Record<string, unknown>;
+}
+export interface OAuthStartResult extends Record<string, unknown> {
+    url: string;
+    state?: string;
+    codeVerifier?: string;
+}
+export interface OAuthCallbackParams {
+    provider: string;
+    query: Record<string, string | string[]>;
+    body: Record<string, unknown>;
+}
+export interface OAuthCallbackResult<PublicUser> extends Record<string, unknown> {
+    user: PublicUser;
+    tokens?: {
+        accessToken: string;
+        refreshToken: string;
+    };
+}

package/dist/esm/oauth/types.js

@@ -0,0 +1,2 @@
+// OAuth-specific contracts kept alongside the OAuth module.
+export {};

package/dist/esm/passkey/base.d.ts

@@ -0,0 +1,28 @@
+import type { PasskeyChallengeRecord, PasskeyStorageAdapter, PasskeyUserDescriptor, StoredPasskeyCredential } from './types.js';
+import type { AuthIdentifier } from '../auth-api/types.js';
+/** Base contract for passkey credential/challenge persistence backends. */
+export declare abstract class PasskeyStore implements PasskeyStorageAdapter {
+    /** Resolve a passkey user descriptor by id/login. */
+    abstract resolveUser(params: {
+        userId?: AuthIdentifier;
+        login?: string;
+    }): Promise<PasskeyUserDescriptor | null>;
+    /** List passkey credentials for a user. */
+    abstract listUserCredentials(userId: AuthIdentifier): Promise<StoredPasskeyCredential[]>;
+    /** Delete a credential by binary/base64url id. */
+    abstract deleteCredential(credentialId: Buffer | string): Promise<boolean>;
+    /** Find a credential by binary id. */
+    abstract findCredentialById(credentialId: Buffer): Promise<StoredPasskeyCredential | null>;
+    /** Save a credential record. */
+    abstract saveCredential(record: StoredPasskeyCredential): Promise<void>;
+    /** Update signature counter for a credential. */
+    abstract updateCredentialCounter(credentialId: Buffer, counter: number): Promise<void>;
+    /** Save a challenge record. */
+    abstract saveChallenge(record: PasskeyChallengeRecord): Promise<void>;
+    /** Read a challenge without consuming it. */
+    abstract getChallenge(challenge: string): Promise<PasskeyChallengeRecord | null>;
+    /** Consume and return a challenge. */
+    abstract consumeChallenge(challenge: string): Promise<PasskeyChallengeRecord | null>;
+    /** Cleanup expired challenges. */
+    abstract cleanupChallenges(now: Date): Promise<void>;
+}

package/dist/esm/passkey/base.js

@@ -0,0 +1,3 @@
+/** Base contract for passkey credential/challenge persistence backends. */
+export class PasskeyStore {
+}

package/dist/esm/passkey/config.d.ts

@@ -0,0 +1,2 @@
+import type { PasskeyServiceConfig } from './types.js';
+export declare function normalizePasskeyConfig(config?: Partial<PasskeyServiceConfig>): PasskeyServiceConfig;

package/dist/esm/passkey/config.js

@@ -0,0 +1,23 @@
+const DEFAULT_PASSKEY_CONFIG = {
+    rpId: 'localhost',
+    rpName: 'API Server',
+    origins: ['http://localhost:5173'],
+    timeoutMs: 5 * 60 * 1000,
+    userVerification: 'preferred'
+};
+function isOriginString(origin) {
+    return typeof origin === 'string' && origin.trim().length > 0;
+}
+export function normalizePasskeyConfig(config = {}) {
+    const candidateOrigins = Array.isArray(config.origins) && config.origins.length > 0 ? config.origins.filter(isOriginString) : null;
+    return {
+        rpId: config.rpId?.trim() || DEFAULT_PASSKEY_CONFIG.rpId,
+        rpName: config.rpName?.trim() || DEFAULT_PASSKEY_CONFIG.rpName,
+        origins: candidateOrigins ? candidateOrigins.map((origin) => origin.trim()) : DEFAULT_PASSKEY_CONFIG.origins,
+        timeoutMs: typeof config.timeoutMs === 'number' && config.timeoutMs > 0
+            ? config.timeoutMs
+            : DEFAULT_PASSKEY_CONFIG.timeoutMs,
+        userVerification: config.userVerification ?? DEFAULT_PASSKEY_CONFIG.userVerification,
+        debug: Boolean(config.debug)
+    };
+}

package/dist/esm/passkey/memory.d.ts

@@ -0,0 +1,34 @@
+import { PasskeyStore } from './base.js';
+import type { PasskeyChallengeRecord, PasskeyUserDescriptor, StoredPasskeyCredential } from './types.js';
+import type { AuthIdentifier } from '../auth-api/types.js';
+export interface MemoryPasskeyStoreOptions {
+    resolveUser: (params: {
+        userId?: AuthIdentifier;
+        login?: string;
+    }) => Promise<PasskeyUserDescriptor | null>;
+    maxCredentials?: number;
+    maxChallenges?: number;
+}
+export declare class MemoryPasskeyStore extends PasskeyStore {
+    private readonly resolveUserFn;
+    private readonly credentials;
+    private readonly challenges;
+    private readonly maxCredentials?;
+    private readonly maxChallenges?;
+    constructor(options: MemoryPasskeyStoreOptions);
+    resolveUser(params: {
+        userId?: AuthIdentifier;
+        login?: string;
+    }): Promise<PasskeyUserDescriptor | null>;
+    listUserCredentials(userId: AuthIdentifier): Promise<StoredPasskeyCredential[]>;
+    deleteCredential(credentialId: Buffer | string): Promise<boolean>;
+    findCredentialById(credentialId: Buffer): Promise<StoredPasskeyCredential | null>;
+    saveCredential(record: StoredPasskeyCredential): Promise<void>;
+    updateCredentialCounter(credentialId: Buffer, counter: number): Promise<void>;
+    saveChallenge(record: PasskeyChallengeRecord): Promise<void>;
+    getChallenge(challenge: string): Promise<PasskeyChallengeRecord | null>;
+    consumeChallenge(challenge: string): Promise<PasskeyChallengeRecord | null>;
+    cleanupChallenges(now: Date): Promise<void>;
+    private enforceCredentialCapacity;
+    private enforceChallengeCapacity;
+}

package/dist/esm/passkey/memory.js

@@ -0,0 +1,119 @@
+import { normalizeComparableUserId } from '../auth-api/user-id.js';
+import { PasskeyStore } from './base.js';
+function encodeCredentialId(value) {
+    return Buffer.isBuffer(value) ? value.toString('base64') : value;
+}
+function cloneCredential(record) {
+    return {
+        ...record,
+        credentialId: Buffer.isBuffer(record.credentialId) ? Buffer.from(record.credentialId) : record.credentialId,
+        publicKey: Buffer.from(record.publicKey),
+        transports: record.transports ? [...record.transports] : undefined
+    };
+}
+export class MemoryPasskeyStore extends PasskeyStore {
+    constructor(options) {
+        super();
+        this.credentials = new Map();
+        this.challenges = new Map();
+        this.resolveUserFn = options.resolveUser;
+        this.maxCredentials =
+            typeof options.maxCredentials === 'number' &&
+                Number.isFinite(options.maxCredentials) &&
+                options.maxCredentials > 0
+                ? Math.floor(options.maxCredentials)
+                : undefined;
+        this.maxChallenges =
+            typeof options.maxChallenges === 'number' &&
+                Number.isFinite(options.maxChallenges) &&
+                options.maxChallenges > 0
+                ? Math.floor(options.maxChallenges)
+                : undefined;
+    }
+    async resolveUser(params) {
+        return this.resolveUserFn(params);
+    }
+    async listUserCredentials(userId) {
+        const normalizedUserId = normalizeComparableUserId(userId);
+        return [...this.credentials.values()]
+            .filter((record) => normalizeComparableUserId(record.userId) === normalizedUserId)
+            .map((record) => cloneCredential(record));
+    }
+    async deleteCredential(credentialId) {
+        const key = encodeCredentialId(credentialId);
+        return this.credentials.delete(key);
+    }
+    async findCredentialById(credentialId) {
+        const record = this.credentials.get(encodeCredentialId(credentialId));
+        return record ? cloneCredential(record) : null;
+    }
+    async saveCredential(record) {
+        this.credentials.set(encodeCredentialId(record.credentialId), {
+            ...record,
+            userId: normalizeComparableUserId(record.userId),
+            credentialId: Buffer.isBuffer(record.credentialId) ? Buffer.from(record.credentialId) : record.credentialId,
+            transports: record.transports ? [...record.transports] : undefined
+        });
+        this.enforceCredentialCapacity();
+    }
+    async updateCredentialCounter(credentialId, counter) {
+        const key = encodeCredentialId(credentialId);
+        const existing = this.credentials.get(key);
+        if (existing) {
+            existing.counter = counter;
+        }
+    }
+    async saveChallenge(record) {
+        this.challenges.set(record.challenge, {
+            challenge: record.challenge,
+            action: record.action,
+            userId: record.userId !== undefined ? normalizeComparableUserId(record.userId) : undefined,
+            login: record.login ?? undefined,
+            expiresAt: record.expiresAt
+        });
+        this.enforceChallengeCapacity();
+    }
+    async getChallenge(challenge) {
+        const record = this.challenges.get(challenge);
+        return record ? { ...record } : null;
+    }
+    async consumeChallenge(challenge) {
+        const record = this.challenges.get(challenge);
+        if (!record) {
+            return null;
+        }
+        this.challenges.delete(challenge);
+        return { ...record };
+    }
+    async cleanupChallenges(now) {
+        for (const [challenge, record] of this.challenges.entries()) {
+            if (record.expiresAt && new Date(record.expiresAt) <= now) {
+                this.challenges.delete(challenge);
+            }
+        }
+    }
+    enforceCredentialCapacity() {
+        if (!this.maxCredentials) {
+            return;
+        }
+        while (this.credentials.size > this.maxCredentials) {
+            const oldest = this.credentials.keys().next().value;
+            if (!oldest) {
+                return;
+            }
+            this.credentials.delete(oldest);
+        }
+    }
+    enforceChallengeCapacity() {
+        if (!this.maxChallenges) {
+            return;
+        }
+        while (this.challenges.size > this.maxChallenges) {
+            const oldest = this.challenges.keys().next().value;
+            if (!oldest) {
+                return;
+            }
+            this.challenges.delete(oldest);
+        }
+    }
+}