@technomoron/api-server-base 1.1.13 → 2.0.0-beta.10

package/dist/esm/passkey/sequelize.js

@@ -0,0 +1,216 @@
+import { DataTypes, Model, Op } from 'sequelize';
+import { PasskeyStore } from './base.js';
+const DIALECTS_SUPPORTING_UNSIGNED = new Set(['mysql', 'mariadb']);
+function integerIdType(sequelize) {
+    return DIALECTS_SUPPORTING_UNSIGNED.has(sequelize.getDialect()) ? DataTypes.INTEGER.UNSIGNED : DataTypes.INTEGER;
+}
+function encodeCredentialId(value) {
+    return Buffer.isBuffer(value) ? value.toString('base64') : value;
+}
+function normalizeUserId(identifier) {
+    if (typeof identifier === 'number' && Number.isFinite(identifier)) {
+        return identifier;
+    }
+    if (typeof identifier === 'string' && /^\d+$/.test(identifier)) {
+        return Number(identifier);
+    }
+    throw new Error(`Unable to normalise user identifier: ${identifier}`);
+}
+class PasskeyCredentialModel extends Model {
+}
+class PasskeyChallengeModel extends Model {
+}
+function initPasskeyCredentialModel(sequelize) {
+    const idType = integerIdType(sequelize);
+    return PasskeyCredentialModel.init({
+        credentialId: {
+            field: 'credential_id',
+            type: DataTypes.STRING(768),
+            primaryKey: true,
+            allowNull: false,
+            get() {
+                const raw = this.getDataValue('credentialId');
+                if (!raw) {
+                    return raw;
+                }
+                if (Buffer.isBuffer(raw)) {
+                    return raw;
+                }
+                return Buffer.from(raw, 'base64');
+            },
+            set(value) {
+                const encoded = typeof value === 'string' ? value : value.toString('base64');
+                this.setDataValue('credentialId', encoded);
+            }
+        },
+        userId: {
+            field: 'user_id',
+            type: idType,
+            allowNull: false
+        },
+        publicKey: {
+            field: 'public_key',
+            type: DataTypes.BLOB,
+            allowNull: false
+        },
+        counter: {
+            type: DataTypes.INTEGER,
+            allowNull: false,
+            defaultValue: 0
+        },
+        transports: {
+            type: DataTypes.JSON,
+            allowNull: true
+        },
+        backedUp: {
+            field: 'backed_up',
+            type: DataTypes.BOOLEAN,
+            allowNull: false,
+            defaultValue: false
+        },
+        deviceType: {
+            field: 'device_type',
+            type: DataTypes.STRING(32),
+            allowNull: false,
+            defaultValue: 'multiDevice'
+        }
+    }, {
+        sequelize,
+        tableName: 'passkey_credentials',
+        timestamps: true,
+        underscored: true
+    });
+}
+function initPasskeyChallengeModel(sequelize) {
+    const idType = integerIdType(sequelize);
+    return PasskeyChallengeModel.init({
+        challenge: {
+            type: DataTypes.STRING(255),
+            primaryKey: true,
+            allowNull: false
+        },
+        action: {
+            type: DataTypes.STRING(16),
+            allowNull: false
+        },
+        userId: {
+            field: 'user_id',
+            type: idType,
+            allowNull: true
+        },
+        login: {
+            type: DataTypes.STRING(128),
+            allowNull: true
+        },
+        metadata: {
+            type: DataTypes.JSON,
+            allowNull: true
+        },
+        expiresAt: {
+            field: 'expires_at',
+            type: DataTypes.DATE,
+            allowNull: false
+        }
+    }, {
+        sequelize,
+        tableName: 'passkey_challenges',
+        timestamps: true,
+        underscored: true,
+        indexes: [{ fields: ['expires_at'] }, { fields: ['user_id'] }]
+    });
+}
+export class SequelizePasskeyStore extends PasskeyStore {
+    constructor(options) {
+        super();
+        if (!options?.sequelize) {
+            throw new Error('SequelizePasskeyStore requires an initialised Sequelize instance');
+        }
+        this.resolveUserFn = options.resolveUser;
+        this.credentials =
+            options.credentialModel ??
+                (options.credentialModelFactory ?? initPasskeyCredentialModel)(options.sequelize);
+        this.challenges =
+            options.challengeModel ?? (options.challengeModelFactory ?? initPasskeyChallengeModel)(options.sequelize);
+    }
+    async resolveUser(params) {
+        return this.resolveUserFn(params);
+    }
+    async listUserCredentials(userId) {
+        const models = await this.credentials.findAll({ where: { userId: normalizeUserId(userId) } });
+        return models.map((model) => ({
+            userId: model.userId,
+            credentialId: model.credentialId,
+            publicKey: model.publicKey,
+            counter: model.counter,
+            transports: (model.transports ?? undefined),
+            backedUp: model.backedUp,
+            deviceType: model.deviceType,
+            createdAt: model.createdAt ?? undefined,
+            updatedAt: model.updatedAt ?? undefined
+        }));
+    }
+    async deleteCredential(credentialId) {
+        const encoded = Buffer.isBuffer(credentialId) ? credentialId.toString('base64') : credentialId;
+        const deleted = await this.credentials.destroy({ where: { credentialId: encoded } });
+        return deleted > 0;
+    }
+    async findCredentialById(credentialId) {
+        const model = await this.credentials.findByPk(encodeCredentialId(credentialId));
+        if (!model) {
+            return null;
+        }
+        return {
+            userId: model.userId,
+            credentialId: model.credentialId,
+            publicKey: model.publicKey,
+            counter: model.counter,
+            transports: (model.transports ?? undefined),
+            backedUp: model.backedUp,
+            deviceType: model.deviceType,
+            createdAt: model.createdAt ?? undefined,
+            updatedAt: model.updatedAt ?? undefined
+        };
+    }
+    async saveCredential(record) {
+        await this.credentials.upsert({
+            credentialId: record.credentialId,
+            userId: normalizeUserId(record.userId),
+            publicKey: record.publicKey,
+            counter: record.counter,
+            transports: record.transports ?? null,
+            backedUp: record.backedUp,
+            deviceType: record.deviceType
+        });
+    }
+    async updateCredentialCounter(credentialId, counter) {
+        await this.credentials.update({ counter }, { where: { credentialId: encodeCredentialId(credentialId) } });
+    }
+    async saveChallenge(record) {
+        await this.challenges.upsert({
+            challenge: record.challenge,
+            action: record.action,
+            userId: record.userId !== undefined ? normalizeUserId(record.userId) : null,
+            login: record.login ?? null,
+            metadata: (record.metadata ?? {}),
+            expiresAt: record.expiresAt
+        });
+    }
+    async consumeChallenge(challenge) {
+        const model = await this.challenges.findByPk(challenge);
+        if (!model) {
+            return null;
+        }
+        await model.destroy();
+        return {
+            challenge: model.challenge,
+            action: model.action,
+            userId: model.userId ?? undefined,
+            login: model.login ?? undefined,
+            expiresAt: model.expiresAt,
+            metadata: model.metadata ?? {}
+        };
+    }
+    async cleanupChallenges(now) {
+        await this.challenges.destroy({ where: { expiresAt: { [Op.lte]: now } } });
+    }
+}

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

@@ -0,0 +1,20 @@
+import type { PasskeyChallenge, PasskeyChallengeParams, PasskeyStorageAdapter, PasskeyVerificationParams, PasskeyVerificationResult, PasskeyServiceConfig, StoredPasskeyCredential } from './types.js';
+import type { AuthIdentifier } from '../auth-api/types.js';
+export type { CredentialDeviceType, PasskeyChallenge, PasskeyChallengeParams, PasskeyChallengeRecord, PasskeyChallengeMetadata, PasskeyUserDescriptor, PasskeyVerificationParams, PasskeyVerificationResult, PasskeyServiceConfig, PasskeyStorageAdapter, StoredPasskeyCredential } from './types.js';
+type Logger = Pick<typeof console, 'error' | 'warn'>;
+export declare class PasskeyService {
+    private readonly config;
+    private readonly adapter;
+    private readonly logger;
+    constructor(config: PasskeyServiceConfig, adapter: PasskeyStorageAdapter, logger?: Logger);
+    listUserCredentials(userId: AuthIdentifier): Promise<StoredPasskeyCredential[]>;
+    deleteCredential(credentialId: Buffer | string): Promise<boolean>;
+    createChallenge(params: PasskeyChallengeParams): Promise<PasskeyChallenge>;
+    verifyResponse(params: PasskeyVerificationParams): Promise<PasskeyVerificationResult>;
+    private createRegistrationChallenge;
+    private createAuthenticationChallenge;
+    private verifyRegistration;
+    private verifyAuthentication;
+    private requireUser;
+    private createExpiry;
+}

package/dist/esm/passkey/service.js

@@ -0,0 +1,319 @@
+import { generateAuthenticationOptions, generateRegistrationOptions, verifyAuthenticationResponse, verifyRegistrationResponse } from '@simplewebauthn/server';
+import { isoBase64URL, isoCBOR, decodeAttestationObject, parseAuthenticatorData } from '@simplewebauthn/server/helpers';
+const ALLOWED_TRANSPORTS = [
+    'ble',
+    'cable',
+    'hybrid',
+    'internal',
+    'nfc',
+    'smart-card',
+    'usb'
+];
+function sanitizeTransports(input) {
+    if (!Array.isArray(input)) {
+        return undefined;
+    }
+    const filtered = input
+        .map((value) => String(value))
+        .filter((value) => ALLOWED_TRANSPORTS.includes(value));
+    return filtered.length > 0 ? filtered : undefined;
+}
+function toBase64Url(buffer) {
+    return isoBase64URL.fromBuffer(new Uint8Array(buffer));
+}
+function fromBase64Url(value) {
+    return Buffer.from(isoBase64URL.toBuffer(value));
+}
+function toBuffer(value) {
+    if (Buffer.isBuffer(value)) {
+        return value;
+    }
+    const view = value instanceof Uint8Array ? value : new Uint8Array(value);
+    return Buffer.from(view);
+}
+function toBufferOrNull(value) {
+    if (!value) {
+        return null;
+    }
+    if (Buffer.isBuffer(value)) {
+        return value;
+    }
+    if (value instanceof ArrayBuffer || value instanceof Uint8Array) {
+        return toBuffer(value);
+    }
+    if (typeof value === 'string') {
+        try {
+            return fromBase64Url(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+async function spkiToCosePublicKey(spki) {
+    try {
+        const subtle = globalThis.crypto?.subtle ?? (await import('crypto')).webcrypto?.subtle;
+        if (!subtle) {
+            return null;
+        }
+        const key = await subtle.importKey('spki', spki, { name: 'ECDSA', namedCurve: 'P-256' }, true, ['verify']);
+        const raw = Buffer.from(await subtle.exportKey('raw', key));
+        if (raw.length !== 65 || raw[0] !== 0x04) {
+            return null;
+        }
+        const x = raw.slice(1, 33);
+        const y = raw.slice(33, 65);
+        const coseMap = new Map([
+            [1, 2], // kty: EC2
+            [3, -7], // alg: ES256
+            [-1, 1], // crv: P-256
+            [-2, x],
+            [-3, y]
+        ]);
+        return Buffer.from(isoCBOR.encode(coseMap));
+    }
+    catch {
+        return null;
+    }
+}
+export class PasskeyService {
+    constructor(config, adapter, logger = console) {
+        this.config = config;
+        this.adapter = adapter;
+        this.logger = logger;
+    }
+    async listUserCredentials(userId) {
+        return this.adapter.listUserCredentials(userId);
+    }
+    async deleteCredential(credentialId) {
+        return this.adapter.deleteCredential(credentialId);
+    }
+    async createChallenge(params) {
+        await this.adapter.cleanupChallenges?.(new Date());
+        const metadata = {
+            domain: typeof params.domain === 'string' ? params.domain : undefined,
+            fingerprint: typeof params.fingerprint === 'string' ? params.fingerprint : undefined,
+            label: typeof params.label === 'string' ? params.label : undefined,
+            userAgent: typeof params.userAgent === 'string' ? params.userAgent : undefined
+        };
+        if (params.action === 'register') {
+            return this.createRegistrationChallenge(params, metadata);
+        }
+        if (params.action === 'authenticate') {
+            return this.createAuthenticationChallenge(params, metadata);
+        }
+        throw new Error(`Unsupported passkey action: ${String(params.action)}`);
+    }
+    async verifyResponse(params) {
+        await this.adapter.cleanupChallenges?.(new Date());
+        const record = await this.adapter.consumeChallenge(params.expectedChallenge);
+        if (!record) {
+            return { verified: false };
+        }
+        if (record.expiresAt.getTime() <= Date.now()) {
+            return { verified: false };
+        }
+        try {
+            if (record.action === 'register') {
+                return this.verifyRegistration(params, record);
+            }
+            if (record.action === 'authenticate') {
+                return this.verifyAuthentication(params, record);
+            }
+        }
+        catch (error) {
+            this.logger.error?.('Passkey verification failed', error);
+        }
+        return { verified: false };
+    }
+    async createRegistrationChallenge(params, metadata) {
+        const user = await this.requireUser({ userId: params.userId, login: params.login });
+        const existing = await this.adapter.listUserCredentials(user.id);
+        const excludeCredentials = existing.map((credential) => {
+            const transports = credential.transports;
+            return transports && transports.length > 0
+                ? { id: toBase64Url(credential.credentialId), transports }
+                : { id: toBase64Url(credential.credentialId) };
+        });
+        const options = await generateRegistrationOptions({
+            rpName: this.config.rpName,
+            rpID: this.config.rpId,
+            userID: Buffer.from(String(user.id)),
+            userName: user.login,
+            userDisplayName: user.displayName,
+            excludeCredentials
+        });
+        const expiresAt = this.createExpiry();
+        await this.adapter.saveChallenge({
+            challenge: options.challenge,
+            action: 'register',
+            userId: user.id,
+            login: user.login,
+            expiresAt,
+            metadata
+        });
+        return {
+            challenge: options.challenge,
+            expiresAt: expiresAt.toISOString(),
+            userId: user.id,
+            publicKey: options
+        };
+    }
+    async createAuthenticationChallenge(params, metadata) {
+        const user = await this.requireUser({ userId: params.userId, login: params.login });
+        const credentials = await this.adapter.listUserCredentials(user.id);
+        const allowCredentials = credentials.map((credential) => {
+            const transports = sanitizeTransports(credential.transports);
+            return transports && transports.length > 0
+                ? { type: 'public-key', id: toBase64Url(credential.credentialId), transports }
+                : { type: 'public-key', id: toBase64Url(credential.credentialId) };
+        });
+        const options = await generateAuthenticationOptions({
+            allowCredentials,
+            userVerification: this.config.userVerification,
+            rpID: this.config.rpId
+        });
+        const expiresAt = this.createExpiry();
+        await this.adapter.saveChallenge({
+            challenge: options.challenge,
+            action: 'authenticate',
+            userId: user.id,
+            login: user.login,
+            expiresAt,
+            metadata
+        });
+        return {
+            challenge: options.challenge,
+            expiresAt: expiresAt.toISOString(),
+            userId: user.id,
+            publicKey: options
+        };
+    }
+    async verifyRegistration(params, record) {
+        const parsed = typeof params.response === 'object' && params.response ? { ...params.response } : {};
+        const response = {
+            ...parsed,
+            id: String(parsed.id ?? ''),
+            rawId: String(parsed.rawId ?? '')
+        };
+        const user = await this.requireUser({ userId: record.userId, login: record.login });
+        const result = await verifyRegistrationResponse({
+            response,
+            expectedChallenge: record.challenge,
+            expectedOrigin: this.config.origins,
+            expectedRPID: this.config.rpId,
+            requireUserVerification: true
+        });
+        if (!result.verified || !result.registrationInfo) {
+            if (!result.verified) {
+                const err = result.error ?? result;
+                this.logger.error?.('Passkey registration verification failed', err);
+            }
+            return { verified: false };
+        }
+        const registrationInfo = result.registrationInfo;
+        const attestationResponse = params.response?.response;
+        const credentialIdPrimary = toBufferOrNull(registrationInfo.credentialID);
+        const credentialIdFallback = toBufferOrNull(params.response?.id);
+        const credentialId = credentialIdPrimary && credentialIdPrimary.length > 0 ? credentialIdPrimary : credentialIdFallback;
+        const publicKeyPrimary = toBufferOrNull(registrationInfo.credentialPublicKey);
+        let publicKeyFallback = toBufferOrNull(attestationResponse?.publicKey);
+        if ((!publicKeyPrimary || publicKeyPrimary.length === 0) && attestationResponse?.attestationObject) {
+            try {
+                const attObj = decodeAttestationObject(isoBase64URL.toBuffer(attestationResponse.attestationObject));
+                const parsedAuth = parseAuthenticatorData(attObj.get('authData'));
+                publicKeyFallback = toBufferOrNull(parsedAuth.credentialPublicKey) ?? publicKeyFallback;
+            }
+            catch (error) {
+                this.logger.warn?.('Passkey registration: failed to parse attestationObject', error);
+            }
+        }
+        const publicKey = publicKeyPrimary && publicKeyPrimary.length > 0 ? publicKeyPrimary : publicKeyFallback;
+        if (this.logger?.warn) {
+            const pkPrimaryHex = publicKeyPrimary ? publicKeyPrimary.slice(0, 4).toString('hex') : 'null';
+            const pkFallbackHex = publicKeyFallback ? publicKeyFallback.slice(0, 4).toString('hex') : 'null';
+            this.logger.warn(`Passkey registration: pkPrimary len=${publicKeyPrimary?.length ?? 0} head=${pkPrimaryHex}, pkFallback len=${publicKeyFallback?.length ?? 0} head=${pkFallbackHex}`);
+        }
+        if (!credentialId || credentialId.length === 0) {
+            return { verified: false, message: 'Missing credential id in registration response' };
+        }
+        if (!publicKey || publicKey.length === 0) {
+            return { verified: false, message: 'Missing public key in registration response' };
+        }
+        let storedPublicKey = Buffer.isBuffer(publicKey) ? publicKey : toBuffer(publicKey);
+        // If fallback is an SPKI key (DER, starts with 0x30) convert to COSE so verification succeeds.
+        if (storedPublicKey[0] === 0x30) {
+            const converted = await spkiToCosePublicKey(storedPublicKey);
+            if (converted) {
+                storedPublicKey = converted;
+            }
+            else {
+                this.logger.warn?.('Passkey registration: failed to convert SPKI public key to COSE');
+            }
+        }
+        await this.adapter.saveCredential({
+            userId: user.id,
+            credentialId,
+            publicKey: storedPublicKey,
+            counter: registrationInfo.counter ?? 0,
+            transports: sanitizeTransports(params.response.transports),
+            backedUp: registrationInfo.credentialDeviceType === 'multiDevice',
+            deviceType: registrationInfo.credentialDeviceType
+        });
+        return { verified: true, userId: user.id, login: user.login };
+    }
+    async verifyAuthentication(params, record) {
+        const parsed = typeof params.response === 'object' && params.response ? { ...params.response } : {};
+        const response = {
+            ...parsed,
+            id: String(parsed.id ?? ''),
+            rawId: String(parsed.rawId ?? '')
+        };
+        const credential = await this.adapter.findCredentialById(fromBase64Url(response.id));
+        if (!credential) {
+            return { verified: false };
+        }
+        const user = await this.requireUser({ userId: credential.userId, login: record.login });
+        const storedAuthData = {
+            id: credential.credentialId,
+            publicKey: toBuffer(credential.publicKey),
+            credentialPublicKey: toBuffer(credential.publicKey),
+            counter: credential.counter,
+            transports: credential.transports ?? undefined,
+            credentialBackedUp: credential.backedUp,
+            credentialDeviceType: credential.deviceType
+            // simplewebauthn accepts either Uint8Array or Buffer; ensure Buffer
+            // see https://github.com/MasterKale/SimpleWebAuthn/blob/master/packages/server/src/authentication/verifyAuthenticationResponse.ts
+        };
+        const result = await verifyAuthenticationResponse({
+            response,
+            expectedChallenge: record.challenge,
+            expectedOrigin: this.config.origins,
+            expectedRPID: this.config.rpId,
+            credential: storedAuthData,
+            requireUserVerification: true
+        });
+        if (!result.verified) {
+            const err = result.error ?? result;
+            this.logger.error?.('Passkey authentication verification failed', err);
+            return { verified: false };
+        }
+        await this.adapter.updateCredentialCounter(credential.credentialId, result.authenticationInfo.newCounter);
+        return {
+            verified: true,
+            userId: user.id,
+            login: user.login
+        };
+    }
+    async requireUser(params) {
+        const user = await this.adapter.resolveUser(params);
+        if (!user) {
+            throw new Error('User not found');
+        }
+        return user;
+    }
+    createExpiry() {
+        return new Date(Date.now() + this.config.timeoutMs);
+    }
+}

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

@@ -0,0 +1,78 @@
+import type { AuthIdentifier } from '../auth-api/types.js';
+import type { Token, TokenPair } from '../token/types.js';
+import type { AuthenticatorTransportFuture } from '@simplewebauthn/server';
+export type CredentialDeviceType = 'singleDevice' | 'multiDevice';
+export interface PasskeyServiceConfig {
+    rpId: string;
+    rpName: string;
+    origins: string[];
+    timeoutMs: number;
+    userVerification?: 'preferred' | 'required' | 'discouraged';
+}
+export interface PasskeyChallengeMetadata {
+    domain?: string;
+    fingerprint?: string;
+    label?: string;
+    userAgent?: string;
+}
+export interface PasskeyChallengeRecord {
+    challenge: string;
+    action: 'register' | 'authenticate';
+    userId?: AuthIdentifier;
+    login?: string;
+    expiresAt: Date;
+    metadata: PasskeyChallengeMetadata;
+}
+export interface PasskeyUserDescriptor {
+    id: AuthIdentifier;
+    login: string;
+    displayName: string;
+}
+export interface StoredPasskeyCredential {
+    userId: AuthIdentifier;
+    credentialId: Buffer;
+    publicKey: Buffer;
+    counter: number;
+    transports?: AuthenticatorTransportFuture[];
+    backedUp: boolean;
+    deviceType: CredentialDeviceType;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+export interface PasskeyStorageAdapter {
+    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>;
+    consumeChallenge(challenge: string): Promise<PasskeyChallengeRecord | null>;
+    cleanupChallenges?(now: Date): Promise<void>;
+}
+export interface PasskeyChallengeParams extends Partial<Omit<Token, 'userId'>> {
+    action: 'register' | 'authenticate';
+    login?: string;
+    userAgent?: string;
+    userId?: AuthIdentifier;
+}
+export interface PasskeyChallenge extends Record<string, unknown> {
+    challenge: string;
+    expiresAt?: string | number | Date;
+    userId?: AuthIdentifier;
+}
+export interface PasskeyVerificationParams extends Partial<Omit<Token, 'userId'>> {
+    expectedChallenge: string;
+    login?: string;
+    response: Record<string, unknown>;
+    userId?: AuthIdentifier;
+}
+export interface PasskeyVerificationResult extends Record<string, unknown> {
+    login?: string;
+    tokens?: TokenPair;
+    userId?: AuthIdentifier;
+    verified: boolean;
+}

package/dist/esm/passkey/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,38 @@
+import type { Token } from './types.js';
+import type { DecodeOptions, SignOptions, VerifyOptions } from 'jsonwebtoken';
+export interface JwtSignResult {
+    success: boolean;
+    token?: string;
+    error?: string;
+}
+export interface JwtVerifyResult<T> {
+    success: boolean;
+    data?: T;
+    expired?: boolean;
+    error?: string;
+}
+export interface JwtDecodeResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+export declare abstract class TokenStore {
+    abstract save(record: Token): Promise<void>;
+    abstract get(query: Partial<Token>, opts?: {
+        includeExpired?: boolean;
+    }): Promise<Token | null>;
+    abstract delete(query: Partial<Token>): Promise<number>;
+    abstract update(update: Partial<Token> & {
+        refreshToken: string;
+    }): Promise<boolean>;
+    abstract list(userId: string | number, opts?: {
+        limit?: number;
+        offset?: number;
+        includeExpired?: boolean;
+    }): Promise<Token[]>;
+    abstract close(): Promise<void>;
+    normalizeToken(token: Partial<Token>): Token;
+    jwtSign(payload: any, secret: string, expiresInSeconds: number, options?: SignOptions): JwtSignResult;
+    jwtVerify<T>(token: string, secret: string, options?: VerifyOptions): JwtVerifyResult<T>;
+    jwtDecode<T>(token: string, options?: DecodeOptions): JwtDecodeResult<T>;
+}