@spfn/auth 0.2.1 → 0.3.0-beta.2

package/dist/authenticate-eucncHxN.d.ts

@@ -1,940 +0,0 @@
-import * as _spfn_core_route from '@spfn/core/route';
-import * as _sinclair_typebox from '@sinclair/typebox';
-import { Static } from '@sinclair/typebox';
-import { User } from '@spfn/auth/server';
-
-/**
- * Role information for client/API responses
- */
-interface Role {
-    id: number;
-    name: string;
-    displayName: string;
-    description: string | null;
-    isBuiltin: boolean;
-    isSystem: boolean;
-    isActive: boolean;
-    priority: number;
-    createdAt: Date;
-    updatedAt: Date;
-}
-/**
- * Permission information for client/API responses
- */
-interface Permission {
-    id: number;
-    name: string;
-    displayName: string;
-    description: string | null;
-    category: string | null;
-    isBuiltin: boolean;
-    isSystem: boolean;
-    isActive: boolean;
-    metadata: Record<string, any> | null;
-    createdAt: Date;
-    updatedAt: Date;
-}
-interface AuthSession {
-    userId: number;
-    publicId: string;
-    email: string | null;
-    emailVerified: boolean;
-    phoneVerified: boolean;
-    role: Role;
-    permissions: Permission[];
-}
-interface ProfileInfo {
-    profileId: number;
-    displayName: string | null;
-    firstName: string | null;
-    lastName: string | null;
-    avatarUrl: string | null;
-    bio: string | null;
-    locale: string;
-    timezone: string;
-    website: string | null;
-    location: string | null;
-    company: string | null;
-    jobTitle: string | null;
-    metadata: Record<string, any> | null;
-    createdAt: Date;
-    updatedAt: Date;
-}
-/**
- * User Profile Response
- *
- * Complete user data including:
- * - User fields at top level (userId, email, etc.)
- * - Profile data as nested field (optional)
- *
- * Excludes:
- * - Role and permissions (use auth session API)
- */
-interface UserProfile {
-    userId: number;
-    publicId: string;
-    email: string | null;
-    username: string | null;
-    emailVerified: boolean;
-    phoneVerified: boolean;
-    lastLoginAt: Date | null;
-    createdAt: Date;
-    updatedAt: Date;
-    profile: ProfileInfo | null;
-}
-
-/**
- * @spfn/auth - Shared Types
- *
- * Common types and constants used across the auth package
- */
-/**
- * Supported JWT signature algorithms
- *
- * - ES256: ECDSA with P-256 and SHA-256 (recommended, smaller keys)
- * - RS256: RSA with SHA-256 (fallback, larger keys)
- */
-declare const KEY_ALGORITHM: readonly ["ES256", "RS256"];
-/**
- * Key algorithm type derived from the const array
- */
-type KeyAlgorithmType = typeof KEY_ALGORITHM[number];
-/**
- * Invitation status enum values
- * Single source of truth for all invitation statuses
- */
-declare const INVITATION_STATUSES: readonly ["pending", "accepted", "expired", "cancelled"];
-/**
- * Invitation status type derived from the const array
- */
-type InvitationStatus = typeof INVITATION_STATUSES[number];
-/**
- * User status enum values
- * Single source of truth for all user statuses
- */
-declare const USER_STATUSES: readonly ["active", "inactive", "suspended"];
-/**
- * User status type derived from the const array
- */
-type UserStatus = typeof USER_STATUSES[number];
-/**
- * Social provider enum values
- * Single source of truth for supported OAuth providers
- */
-declare const SOCIAL_PROVIDERS: readonly ["google", "github", "kakao", "naver"];
-/**
- * Social provider type derived from the const array
- */
-type SocialProvider = typeof SOCIAL_PROVIDERS[number];
-
-/**
- * @spfn/auth - Auth Service
- *
- * Core authentication logic: registration, login, logout, password management
- */
-
-interface CheckAccountExistsParams {
-    email?: string;
-    phone?: string;
-}
-interface CheckAccountExistsResult {
-    exists: boolean;
-    identifier: string;
-    identifierType: 'email' | 'phone';
-}
-interface RegisterParams {
-    email?: string;
-    phone?: string;
-    verificationToken: string;
-    password: string;
-    publicKey: string;
-    keyId: string;
-    fingerprint: string;
-    algorithm?: KeyAlgorithmType;
-    metadata?: Record<string, unknown>;
-}
-interface RegisterResult {
-    userId: string;
-    publicId: string;
-    email?: string;
-    phone?: string;
-}
-interface LoginParams {
-    email?: string;
-    phone?: string;
-    password: string;
-    publicKey: string;
-    keyId: string;
-    fingerprint: string;
-    oldKeyId?: string;
-    algorithm?: KeyAlgorithmType;
-}
-interface LoginResult {
-    userId: string;
-    publicId: string;
-    email?: string;
-    phone?: string;
-    passwordChangeRequired: boolean;
-}
-interface LogoutParams {
-    userId: number;
-    keyId: string;
-}
-interface ChangePasswordParams {
-    userId: number;
-    currentPassword: string;
-    newPassword: string;
-    passwordHash?: string;
-}
-/**
- * Check if an account exists by email or phone
- */
-declare function checkAccountExistsService(params: CheckAccountExistsParams): Promise<CheckAccountExistsResult>;
-/**
- * Register a new user account
- */
-declare function registerService(params: RegisterParams): Promise<RegisterResult>;
-/**
- * Authenticate user and create session
- */
-declare function loginService(params: LoginParams): Promise<LoginResult>;
-/**
- * Logout user (revoke current key)
- */
-declare function logoutService(params: LogoutParams): Promise<void>;
-/**
- * Change user password
- */
-declare function changePasswordService(params: ChangePasswordParams): Promise<void>;
-
-declare const EmailSchema: _sinclair_typebox.TString;
-declare const PhoneSchema: _sinclair_typebox.TString;
-declare const PasswordSchema: _sinclair_typebox.TString;
-declare const TargetTypeSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"email">, _sinclair_typebox.TLiteral<"phone">]>;
-type VerificationTargetType = Static<typeof TargetTypeSchema>;
-declare const VERIFICATION_TARGET_TYPES: readonly ["email", "phone"];
-declare const VerificationPurposeSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"registration">, _sinclair_typebox.TLiteral<"login">, _sinclair_typebox.TLiteral<"password_reset">, _sinclair_typebox.TLiteral<"email_change">, _sinclair_typebox.TLiteral<"phone_change">]>;
-type VerificationPurpose = Static<typeof VerificationPurposeSchema>;
-declare const VERIFICATION_PURPOSES: readonly ["registration", "login", "password_reset", "email_change", "phone_change"];
-
-/**
- * @spfn/auth - Verification Service
- *
- * Handles OTP code generation, validation, and delivery
- */
-
-interface SendVerificationCodeParams {
-    target: string;
-    targetType: VerificationTargetType;
-    purpose: VerificationPurpose;
-}
-interface SendVerificationCodeResult {
-    success: boolean;
-    expiresAt: string;
-}
-interface VerifyCodeParams {
-    target: string;
-    targetType: VerificationTargetType;
-    code: string;
-    purpose: VerificationPurpose;
-}
-interface VerifyCodeResult {
-    valid: boolean;
-    verificationToken: string;
-}
-/**
- * Send verification code via email or SMS
- */
-declare function sendVerificationCodeService(params: SendVerificationCodeParams): Promise<SendVerificationCodeResult>;
-/**
- * Verify OTP code and return verification token
- */
-declare function verifyCodeService(params: VerifyCodeParams): Promise<{
-    valid: boolean;
-    verificationToken: string;
-}>;
-
-/**
- * @spfn/auth - Key Service
- *
- * Handles public key registration, rotation, and revocation
- */
-
-interface RegisterPublicKeyParams {
-    userId: number;
-    keyId: string;
-    publicKey: string;
-    fingerprint: string;
-    algorithm?: KeyAlgorithmType;
-}
-interface RotateKeyParams {
-    userId: number;
-    oldKeyId: string;
-    newKeyId: string;
-    newPublicKey: string;
-    fingerprint: string;
-    algorithm?: KeyAlgorithmType;
-}
-interface RotateKeyResult {
-    success: boolean;
-    keyId: string;
-}
-interface RevokeKeyParams {
-    userId: number;
-    keyId: string;
-    reason: string;
-}
-/**
- * Register a new public key for a user
- */
-declare function registerPublicKeyService(params: RegisterPublicKeyParams): Promise<void>;
-/**
- * Rotate user's public key (revoke old, register new)
- */
-declare function rotateKeyService(params: RotateKeyParams): Promise<RotateKeyResult>;
-/**
- * Revoke a user's public key
- */
-declare function revokeKeyService(params: RevokeKeyParams): Promise<void>;
-
-/**
- * @spfn/auth - RBAC Type Definitions
- *
- * Type definitions for role and permission configuration
- */
-/**
- * Permission category enum values
- * Single source of truth for permission categories
- */
-declare const PERMISSION_CATEGORIES: readonly ["auth", "user", "rbac", "system", "custom"];
-/**
- * Permission category type derived from the const array
- */
-type PermissionCategory = typeof PERMISSION_CATEGORIES[number];
-interface RoleConfig {
-    name: string;
-    displayName: string;
-    description?: string;
-    priority?: number;
-    isSystem?: boolean;
-    isBuiltin?: boolean;
-}
-interface PermissionConfig {
-    name: string;
-    displayName: string;
-    description?: string;
-    category?: PermissionCategory;
-    isSystem?: boolean;
-    isBuiltin?: boolean;
-}
-interface AuthInitOptions {
-    /**
-     * Additional roles to create
-     * Built-in roles (user, admin, superadmin) are automatically included
-     */
-    roles?: RoleConfig[];
-    /**
-     * Additional permissions to create
-     * Built-in permissions are automatically included
-     */
-    permissions?: PermissionConfig[];
-    /**
-     * Role-Permission mappings
-     * Built-in mappings are automatically included
-     * You can extend built-in roles or define mappings for custom roles
-     *
-     * @example
-     * ```typescript
-     * {
-     *   // Extend built-in admin role
-     *   admin: ['project:create', 'project:delete'],
-     *
-     *   // Define custom role permissions
-     *   'project-manager': ['project:create', 'task:assign'],
-     * }
-     * ```
-     */
-    rolePermissions?: Record<string, string[]>;
-    /**
-     * Default role name for new users
-     * Must be a valid role name that exists after initialization
-     * @default 'user'
-     */
-    defaultRole?: string;
-    /**
-     * Default session TTL (Time To Live)
-     *
-     * Supports:
-     * - Number: seconds (e.g., 2592000)
-     * - String: duration format ('30d', '12h', '45m', '3600s')
-     *
-     * Can be overridden at runtime with `remember` parameter.
-     *
-     * @default '7d' (7 days)
-     *
-     * @example
-     * ```typescript
-     * {
-     *   sessionTtl: '30d',  // 30 days
-     * }
-     * ```
-     */
-    sessionTtl?: string | number;
-}
-
-/**
- * One-Time Token Service
- *
- * Issues and verifies one-time tokens for direct API access.
- */
-interface IssueOneTimeTokenResult {
-    token: string;
-    expiresAt: string;
-}
-/**
- * Issue a one-time token for the authenticated user
- *
- * @param userId - Authenticated user's ID
- * @returns Token string and ISO expiration timestamp
- */
-declare function issueOneTimeTokenService(userId: string): Promise<IssueOneTimeTokenResult>;
-/**
- * Verify and consume a one-time token
- *
- * @param token - The one-time token to verify
- * @returns userId if valid, null if invalid/expired/consumed
- */
-declare function verifyOneTimeTokenService(token: string): Promise<string | null>;
-
-/**
- * @spfn/auth - OAuth Service
- *
- * OAuth 인증 비즈니스 로직
- * - Google OAuth Authorization Code Flow
- * - 소셜 계정 연결/생성
- * - publicKey는 state에서 추출하여 등록
- */
-
-interface OAuthStartParams {
-    provider: SocialProvider;
-    returnUrl: string;
-    publicKey: string;
-    keyId: string;
-    fingerprint: string;
-    algorithm: KeyAlgorithmType;
-    metadata?: Record<string, unknown>;
-}
-interface OAuthStartResult {
-    authUrl: string;
-}
-interface OAuthCallbackParams {
-    provider: SocialProvider;
-    code: string;
-    state: string;
-}
-interface OAuthCallbackResult {
-    redirectUrl: string;
-    userId: string;
-    keyId: string;
-    isNewUser: boolean;
-}
-/**
- * OAuth 로그인 시작 - Provider 로그인 페이지로 리다이렉트할 URL 생성
- *
- * Next.js에서 키쌍을 생성한 후, publicKey를 state에 포함하여 호출
- */
-declare function oauthStartService(params: OAuthStartParams): Promise<OAuthStartResult>;
-/**
- * OAuth 콜백 처리 - Code를 Token으로 교환하고 사용자 생성/연결
- *
- * state에서 publicKey를 추출하여 서버에 등록
- * Next.js는 반환된 userId, keyId로 세션을 구성
- */
-declare function oauthCallbackService(params: OAuthCallbackParams): Promise<OAuthCallbackResult>;
-/**
- * OAuth 에러 리다이렉트 URL 생성
- */
-declare function buildOAuthErrorUrl(error: string): string;
-/**
- * OAuth provider가 활성화되어 있는지 확인
- */
-declare function isOAuthProviderEnabled(provider: SocialProvider): boolean;
-/**
- * 활성화된 모든 OAuth provider 목록
- */
-declare function getEnabledOAuthProviders(): SocialProvider[];
-/**
- * Google access token 조회 (만료 시 자동 리프레시)
- *
- * 저장된 토큰이 만료 임박(5분 이내) 또는 만료 상태이면
- * refresh token으로 자동 갱신 후 DB 업데이트하여 유효한 토큰 반환.
- *
- * @param userId - 사용자 ID
- * @returns 유효한 Google access token
- */
-declare function getGoogleAccessToken(userId: number): Promise<string>;
-
-/**
- * @spfn/auth - Main Router
- *
- * Combines all auth-related routes into a single router
- */
-/**
- * Main auth router
- * Exports all authentication-related routes
- *
- * Routes:
- * - Auth: /_auth/exists, /_auth/codes, /_auth/login, /_auth/logout, etc.
- * - OAuth: /_auth/oauth/google, /_auth/oauth/google/callback, etc.
- * - Invitations: /_auth/invitations/*
- * - Users: /_auth/users/*
- * - Admin: /_auth/admin/* (superadmin only)
- */
-declare const mainAuthRouter: _spfn_core_route.Router<{
-    checkAccountExists: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TUnion<[_sinclair_typebox.TObject<{
-            email: _sinclair_typebox.TString;
-        }>, _sinclair_typebox.TObject<{
-            phone: _sinclair_typebox.TString;
-        }>]>;
-    }, {}, CheckAccountExistsResult>;
-    sendVerificationCode: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            target: _sinclair_typebox.TString;
-            targetType: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"email">, _sinclair_typebox.TLiteral<"phone">]>;
-            purpose: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"registration">, _sinclair_typebox.TLiteral<"login">, _sinclair_typebox.TLiteral<"password_reset">, _sinclair_typebox.TLiteral<"email_change">, _sinclair_typebox.TLiteral<"phone_change">]>;
-        }>;
-    }, {}, SendVerificationCodeResult>;
-    verifyCode: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            target: _sinclair_typebox.TString;
-            targetType: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"email">, _sinclair_typebox.TLiteral<"phone">]>;
-            code: _sinclair_typebox.TString;
-            purpose: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"registration">, _sinclair_typebox.TLiteral<"login">, _sinclair_typebox.TLiteral<"password_reset">, _sinclair_typebox.TLiteral<"email_change">, _sinclair_typebox.TLiteral<"phone_change">]>;
-        }>;
-    }, {}, {
-        valid: boolean;
-        verificationToken: string;
-    }>;
-    register: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            email: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            phone: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            verificationToken: _sinclair_typebox.TString;
-            password: _sinclair_typebox.TString;
-            metadata: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnknown>>;
-        }>;
-    }, {
-        body: _sinclair_typebox.TObject<{
-            publicKey: _sinclair_typebox.TString;
-            keyId: _sinclair_typebox.TString;
-            fingerprint: _sinclair_typebox.TString;
-            algorithm: _sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"ES256" | "RS256">[]>;
-        }>;
-    }, RegisterResult>;
-    login: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            email: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            phone: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            password: _sinclair_typebox.TString;
-        }>;
-    }, {
-        body: _sinclair_typebox.TObject<{
-            publicKey: _sinclair_typebox.TString;
-            keyId: _sinclair_typebox.TString;
-            fingerprint: _sinclair_typebox.TString;
-            algorithm: _sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"ES256" | "RS256">[]>;
-            oldKeyId: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-        }>;
-    }, LoginResult>;
-    logout: _spfn_core_route.RouteDef<{}, {}, void>;
-    rotateKey: _spfn_core_route.RouteDef<{}, {
-        body: _sinclair_typebox.TObject<{
-            publicKey: _sinclair_typebox.TString;
-            keyId: _sinclair_typebox.TString;
-            fingerprint: _sinclair_typebox.TString;
-            algorithm: _sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"ES256" | "RS256">[]>;
-        }>;
-    }, RotateKeyResult>;
-    changePassword: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            currentPassword: _sinclair_typebox.TString;
-            newPassword: _sinclair_typebox.TString;
-        }>;
-    }, {}, void>;
-    getAuthSession: _spfn_core_route.RouteDef<{}, {}, {
-        role: {
-            id: number;
-            name: string;
-            displayName: string;
-            priority: number;
-        };
-        permissions: {
-            id: number;
-            name: string;
-            displayName: string;
-            category: "auth" | "custom" | "user" | "rbac" | "system" | undefined;
-        }[];
-        userId: number;
-        publicId: string;
-        email: string | null;
-        emailVerified: boolean;
-        phoneVerified: boolean;
-    }>;
-    issueOneTimeToken: _spfn_core_route.RouteDef<{}, {}, IssueOneTimeTokenResult>;
-    oauthGoogleStart: _spfn_core_route.RouteDef<{
-        query: _sinclair_typebox.TObject<{
-            state: _sinclair_typebox.TString;
-        }>;
-    }, {}, Response>;
-    oauthGoogleCallback: _spfn_core_route.RouteDef<{
-        query: _sinclair_typebox.TObject<{
-            code: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            state: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            error: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            error_description: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-        }>;
-    }, {}, Response>;
-    oauthStart: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            provider: _sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"google" | "github" | "kakao" | "naver">[]>;
-            returnUrl: _sinclair_typebox.TString;
-            publicKey: _sinclair_typebox.TString;
-            keyId: _sinclair_typebox.TString;
-            fingerprint: _sinclair_typebox.TString;
-            algorithm: _sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"ES256" | "RS256">[]>;
-            metadata: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnknown>>;
-        }>;
-    }, {}, OAuthStartResult>;
-    oauthProviders: _spfn_core_route.RouteDef<{}, {}, {
-        providers: ("google" | "github" | "kakao" | "naver")[];
-    }>;
-    getGoogleOAuthUrl: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            returnUrl: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            state: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-        }>;
-    }, {}, {
-        authUrl: string;
-    }>;
-    oauthFinalize: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            userId: _sinclair_typebox.TString;
-            keyId: _sinclair_typebox.TString;
-            returnUrl: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-        }>;
-    }, {}, {
-        success: boolean;
-        userId: string;
-        keyId: string;
-        returnUrl: string;
-    }>;
-    getInvitation: _spfn_core_route.RouteDef<{
-        params: _sinclair_typebox.TObject<{
-            token: _sinclair_typebox.TString;
-        }>;
-    }, {}, {
-        email: string;
-        role: string;
-        roleDisplayName: string;
-        invitedBy: string;
-        expiresAt: string;
-        metadata: Record<string, any> | undefined;
-    }>;
-    acceptInvitation: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            token: _sinclair_typebox.TString;
-            password: _sinclair_typebox.TString;
-        }>;
-    }, {
-        body: _sinclair_typebox.TObject<{
-            publicKey: _sinclair_typebox.TString;
-            keyId: _sinclair_typebox.TString;
-            fingerprint: _sinclair_typebox.TString;
-            algorithm: _sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"ES256" | "RS256">[]>;
-        }>;
-    }, {
-        userId: number;
-        email: string;
-        role: string;
-    }>;
-    createInvitation: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            email: _sinclair_typebox.TString;
-            roleId: _sinclair_typebox.TNumber;
-            expiresInDays: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
-            expiresAt: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            metadata: _sinclair_typebox.TOptional<_sinclair_typebox.TAny>;
-        }>;
-    }, {}, {
-        id: number;
-        email: string;
-        token: string;
-        roleId: number;
-        expiresAt: string;
-        invitationUrl: string;
-    }>;
-    listInvitations: _spfn_core_route.RouteDef<{
-        query: _sinclair_typebox.TObject<{
-            status: _sinclair_typebox.TOptional<_sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"pending" | "accepted" | "expired" | "cancelled">[]>>;
-            page: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
-            limit: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
-        }>;
-    }, {}, {
-        invitations: {
-            id: number;
-            email: string;
-            token: string;
-            roleId: number;
-            invitedBy: number;
-            status: "pending" | "accepted" | "expired" | "cancelled";
-            expiresAt: Date;
-            acceptedAt: Date | null;
-            cancelledAt: Date | null;
-            metadata: Record<string, any> | null;
-            createdAt: Date;
-            updatedAt: Date;
-            role: {
-                id: number;
-                name: string;
-                displayName: string;
-            };
-            inviter: {
-                id: number;
-                email: string | null;
-            };
-        }[];
-        total: number;
-        page: number;
-        limit: number;
-        totalPages: number;
-    }>;
-    cancelInvitation: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            id: _sinclair_typebox.TNumber;
-            reason: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-        }>;
-    }, {}, {
-        cancelledAt: string;
-    }>;
-    resendInvitation: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            id: _sinclair_typebox.TNumber;
-            expiresInDays: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
-        }>;
-    }, {}, {
-        expiresAt: string;
-    }>;
-    deleteInvitation: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            id: _sinclair_typebox.TNumber;
-        }>;
-    }, {}, void>;
-    getUserProfile: _spfn_core_route.RouteDef<{}, {}, UserProfile>;
-    updateUserProfile: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            displayName: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            firstName: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            lastName: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            avatarUrl: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            bio: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            locale: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            timezone: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            dateOfBirth: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            gender: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            website: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            location: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            company: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            jobTitle: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            metadata: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TAny>>;
-        }>;
-    }, {}, ProfileInfo>;
-    checkUsername: _spfn_core_route.RouteDef<{
-        query: _sinclair_typebox.TObject<{
-            username: _sinclair_typebox.TString;
-        }>;
-    }, {}, {
-        available: boolean;
-    }>;
-    updateUsername: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            username: _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNull]>;
-        }>;
-    }, {}, {
-        createdAt: Date;
-        updatedAt: Date;
-        id: number;
-        publicId: string;
-        email: string | null;
-        phone: string | null;
-        username: string | null;
-        passwordHash: string | null;
-        passwordChangeRequired: boolean;
-        roleId: number;
-        status: "active" | "inactive" | "suspended";
-        emailVerifiedAt: Date | null;
-        phoneVerifiedAt: Date | null;
-        lastLoginAt: Date | null;
-    }>;
-    updateLocale: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            locale: _sinclair_typebox.TString;
-        }>;
-    }, {}, {
-        locale: string;
-    }>;
-    listRoles: _spfn_core_route.RouteDef<{
-        query: _sinclair_typebox.TObject<{
-            includeInactive: _sinclair_typebox.TOptional<_sinclair_typebox.TBoolean>;
-        }>;
-    }, {}, {
-        roles: {
-            description: string | null;
-            id: number;
-            name: string;
-            displayName: string;
-            isBuiltin: boolean;
-            isSystem: boolean;
-            isActive: boolean;
-            priority: number;
-            createdAt: Date;
-            updatedAt: Date;
-        }[];
-    }>;
-    createAdminRole: _spfn_core_route.RouteDef<{
-        body: _sinclair_typebox.TObject<{
-            name: _sinclair_typebox.TString;
-            displayName: _sinclair_typebox.TString;
-            description: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            priority: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
-            permissionIds: _sinclair_typebox.TOptional<_sinclair_typebox.TArray<_sinclair_typebox.TNumber>>;
-        }>;
-    }, {}, {
-        role: {
-            description: string | null;
-            id: number;
-            name: string;
-            displayName: string;
-            isBuiltin: boolean;
-            isSystem: boolean;
-            isActive: boolean;
-            priority: number;
-            createdAt: Date;
-            updatedAt: Date;
-        };
-    }>;
-    updateAdminRole: _spfn_core_route.RouteDef<{
-        params: _sinclair_typebox.TObject<{
-            id: _sinclair_typebox.TNumber;
-        }>;
-        body: _sinclair_typebox.TObject<{
-            displayName: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            description: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
-            priority: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
-            isActive: _sinclair_typebox.TOptional<_sinclair_typebox.TBoolean>;
-        }>;
-    }, {}, {
-        role: {
-            description: string | null;
-            id: number;
-            name: string;
-            displayName: string;
-            isBuiltin: boolean;
-            isSystem: boolean;
-            isActive: boolean;
-            priority: number;
-            createdAt: Date;
-            updatedAt: Date;
-        };
-    }>;
-    deleteAdminRole: _spfn_core_route.RouteDef<{
-        params: _sinclair_typebox.TObject<{
-            id: _sinclair_typebox.TNumber;
-        }>;
-    }, {}, void>;
-    updateUserRole: _spfn_core_route.RouteDef<{
-        params: _sinclair_typebox.TObject<{
-            userId: _sinclair_typebox.TNumber;
-        }>;
-        body: _sinclair_typebox.TObject<{
-            roleId: _sinclair_typebox.TNumber;
-        }>;
-    }, {}, {
-        userId: number;
-        roleId: number;
-    }>;
-}>;
-
-interface AuthContext {
-    user: User;
-    userId: string;
-    keyId: string;
-    role: string | null;
-    locale: string;
-}
-declare module 'hono' {
-    interface ContextVariableMap {
-        auth: AuthContext;
-    }
-}
-/**
- * Authentication middleware
- *
- * Verifies client-signed JWT token using stored public key
- * Must be applied to routes that require authentication
- *
- * @example
- * ```typescript
- * // In server.config.ts
- * import { authenticate } from '@spfn/auth/server/middleware';
- *
- * export default defineServerConfig()
- *   .middlewares([authenticate])
- *   .routes(appRouter)
- *   .build();
- *
- * // In route file - skip auth for public routes
- * export const publicRoute = route.get('/health')
- *   .skip(['auth'])  // Type-safe skip
- *   .handler(async (c) => c.success({ status: 'ok' }));
- *
- * // Protected route - auth applied automatically
- * export const protectedRoute = route.get('/profile')
- *   .handler(async (c) => {
- *     const auth = c.get('auth');  // Get auth context
- *     const { user, userId, keyId } = auth;
- *     // Or access directly: c.get('auth').user
- *   });
- * ```
- */
-declare const authenticate: _spfn_core_route.NamedMiddleware<"auth">;
-/**
- * Optional authentication middleware
- *
- * Same as `authenticate` but does NOT reject unauthenticated requests.
- * - No token → continues without auth context
- * - Invalid token → continues without auth context
- * - Valid token → sets auth context normally
- *
- * Auto-skips the global 'auth' middleware when used at route level.
- *
- * @example
- * ```typescript
- * // No need for .skip(['auth']) — handled automatically
- * export const getProducts = route.get('/products')
- *   .use([optionalAuth])
- *   .handler(async (c) => {
- *     const auth = getOptionalAuth(c);  // AuthContext | undefined
- *
- *     if (auth)
- *     {
- *       return getPersonalizedProducts(auth.userId);
- *     }
- *
- *     return getPublicProducts();
- *   });
- * ```
- */
-declare const optionalAuth: _spfn_core_route.NamedMiddleware<"optionalAuth">;
-
-export { oauthCallbackService as $, type AuthSession as A, type LogoutParams as B, type CheckAccountExistsResult as C, type ChangePasswordParams as D, sendVerificationCodeService as E, verifyCodeService as F, type SendVerificationCodeParams as G, type VerifyCodeParams as H, type IssueOneTimeTokenResult as I, type VerifyCodeResult as J, KEY_ALGORITHM as K, type LoginResult as L, registerPublicKeyService as M, rotateKeyService as N, type OAuthStartResult as O, type PermissionConfig as P, revokeKeyService as Q, type RoleConfig as R, type SendVerificationCodeResult as S, type RegisterPublicKeyParams as T, type UserProfile as U, type VerificationTargetType as V, type RotateKeyParams as W, type RevokeKeyParams as X, issueOneTimeTokenService as Y, verifyOneTimeTokenService as Z, oauthStartService as _, type RegisterResult as a, buildOAuthErrorUrl as a0, isOAuthProviderEnabled as a1, getEnabledOAuthProviders as a2, getGoogleAccessToken as a3, type OAuthStartParams as a4, type OAuthCallbackParams as a5, type OAuthCallbackResult as a6, authenticate as a7, optionalAuth as a8, EmailSchema as a9, PhoneSchema as aa, PasswordSchema as ab, TargetTypeSchema as ac, VerificationPurposeSchema as ad, type RotateKeyResult as b, type ProfileInfo as c, INVITATION_STATUSES as d, USER_STATUSES as e, SOCIAL_PROVIDERS as f, type VerificationPurpose as g, VERIFICATION_TARGET_TYPES as h, VERIFICATION_PURPOSES as i, PERMISSION_CATEGORIES as j, type PermissionCategory as k, type AuthInitOptions as l, mainAuthRouter as m, type KeyAlgorithmType as n, type InvitationStatus as o, type UserStatus as p, type SocialProvider as q, type AuthContext as r, checkAccountExistsService as s, registerService as t, loginService as u, logoutService as v, changePasswordService as w, type CheckAccountExistsParams as x, type RegisterParams as y, type LoginParams as z };