@authsome/ui-core 0.1.0

package/dist/provider-DXf_a2WT.d.ts

@@ -0,0 +1,457 @@
+/**
+ * Core authentication types and interfaces
+ */
+/**
+ * Authentication state enum
+ */
+declare enum AuthState {
+    AUTHENTICATED = "authenticated",
+    UNAUTHENTICATED = "unauthenticated",
+    LOADING = "loading",
+    ERROR = "error"
+}
+/**
+ * User profile interface
+ */
+interface User {
+    id: string;
+    email?: string;
+    username?: string;
+    phone?: string;
+    emailVerified?: boolean;
+    phoneVerified?: boolean;
+    name?: string;
+    firstName?: string;
+    lastName?: string;
+    avatar?: string;
+    metadata?: Record<string, unknown>;
+    createdAt?: Date;
+    updatedAt?: Date;
+    organizationId?: string;
+    organizationRole?: string;
+    organizationMemberships?: OrganizationMembership[];
+}
+/**
+ * Session interface
+ */
+interface Session {
+    id: string;
+    userId: string;
+    token: string;
+    expiresAt?: Date;
+    createdAt?: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Auth error types
+ */
+declare enum AuthErrorType {
+    INVALID_CREDENTIALS = "invalid_credentials",
+    USER_NOT_FOUND = "user_not_found",
+    USER_ALREADY_EXISTS = "user_already_exists",
+    INVALID_TOKEN = "invalid_token",
+    TOKEN_EXPIRED = "token_expired",
+    NETWORK_ERROR = "network_error",
+    VALIDATION_ERROR = "validation_error",
+    MFA_REQUIRED = "mfa_required",
+    EMAIL_NOT_VERIFIED = "email_not_verified",
+    PHONE_NOT_VERIFIED = "phone_not_verified",
+    RATE_LIMIT_EXCEEDED = "rate_limit_exceeded",
+    UNKNOWN_ERROR = "unknown_error"
+}
+/**
+ * Auth error class
+ *
+ * Extends Error to provide proper error handling with auth-specific context
+ */
+declare class AuthError extends Error {
+    readonly type: AuthErrorType;
+    readonly details?: Record<string, unknown>;
+    readonly code?: string | number;
+    readonly originalError?: unknown;
+    constructor(message: string, type?: AuthErrorType, options?: {
+        details?: Record<string, unknown>;
+        code?: string | number;
+        originalError?: unknown;
+    });
+}
+/**
+ * Auth context state
+ */
+interface AuthContext {
+    state: AuthState;
+    user: User | null;
+    session: Session | null;
+    error: AuthError | null;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+}
+/**
+ * OAuth provider types
+ */
+declare enum OAuthProvider {
+    GOOGLE = "google",
+    GITHUB = "github",
+    FACEBOOK = "facebook",
+    TWITTER = "twitter",
+    MICROSOFT = "microsoft",
+    APPLE = "apple",
+    LINKEDIN = "linkedin",
+    DISCORD = "discord"
+}
+/**
+ * OAuth configuration
+ */
+interface OAuthConfig {
+    provider: OAuthProvider;
+    clientId: string;
+    redirectUri: string;
+    scope?: string[];
+    state?: string;
+}
+/**
+ * 2FA method types
+ */
+declare enum TwoFactorMethod {
+    TOTP = "totp",
+    SMS = "sms",
+    EMAIL = "email",
+    BACKUP_CODE = "backup_code"
+}
+/**
+ * 2FA configuration
+ */
+interface TwoFactorConfig {
+    method: TwoFactorMethod;
+    enabled: boolean;
+    verified?: boolean;
+}
+/**
+ * Passkey/WebAuthn types
+ */
+interface PasskeyCredential {
+    id: string;
+    name?: string;
+    createdAt?: Date;
+    lastUsedAt?: Date;
+}
+/**
+ * Validation error
+ */
+interface ValidationError {
+    field: string;
+    message: string;
+    code?: string;
+}
+/**
+ * Organization interface
+ */
+interface Organization {
+    id: string;
+    name: string;
+    slug: string;
+    logoUrl?: string;
+    createdAt?: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Organization membership interface
+ */
+interface OrganizationMembership {
+    organization: Organization;
+    role: 'owner' | 'admin' | 'member';
+    permissions?: string[];
+}
+
+/**
+ * Sign in request
+ */
+interface SignInRequest {
+    email?: string;
+    username?: string;
+    phone?: string;
+    password?: string;
+    remember?: boolean;
+}
+/**
+ * Sign up request
+ */
+interface SignUpRequest {
+    email?: string;
+    username?: string;
+    phone?: string;
+    password: string;
+    name?: string;
+    firstName?: string;
+    lastName?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * OAuth sign in request
+ */
+interface OAuthSignInRequest {
+    provider: OAuthProvider;
+    redirectUri?: string;
+    state?: string;
+    scope?: string[];
+}
+/**
+ * OAuth callback request
+ */
+interface OAuthCallbackRequest {
+    provider: OAuthProvider;
+    code: string;
+    state?: string;
+}
+/**
+ * Magic link request
+ */
+interface MagicLinkRequest {
+    email: string;
+    redirectUri?: string;
+}
+/**
+ * Magic link verify request
+ */
+interface MagicLinkVerifyRequest {
+    token: string;
+}
+/**
+ * Phone auth request
+ */
+interface PhoneAuthRequest {
+    phone: string;
+}
+/**
+ * Phone verify request
+ */
+interface PhoneVerifyRequest {
+    phone: string;
+    code: string;
+}
+/**
+ * 2FA setup request
+ */
+interface TwoFactorSetupRequest {
+    method: TwoFactorMethod;
+    phone?: string;
+    email?: string;
+}
+/**
+ * 2FA setup response
+ */
+interface TwoFactorSetupResponse {
+    method: TwoFactorMethod;
+    secret?: string;
+    qrCode?: string;
+    backupCodes?: string[];
+}
+/**
+ * 2FA verify request
+ */
+interface TwoFactorVerifyRequest {
+    code: string;
+    method?: TwoFactorMethod;
+    remember?: boolean;
+}
+/**
+ * Passkey registration request
+ */
+interface PasskeyRegisterRequest {
+    name?: string;
+}
+/**
+ * Passkey authentication request
+ */
+interface PasskeyAuthRequest {
+    credentialId?: string;
+}
+/**
+ * Password reset request
+ */
+interface PasswordResetRequest {
+    email: string;
+}
+/**
+ * Password reset confirm request
+ */
+interface PasswordResetConfirmRequest {
+    token: string;
+    password: string;
+}
+/**
+ * Password change request
+ */
+interface PasswordChangeRequest {
+    currentPassword: string;
+    newPassword: string;
+}
+/**
+ * Update user request
+ */
+interface UpdateUserRequest {
+    name?: string;
+    firstName?: string;
+    lastName?: string;
+    avatar?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Auth response
+ */
+interface AuthResponse {
+    user: User;
+    session: Session;
+    requiresTwoFactor?: boolean;
+    twoFactorMethods?: TwoFactorMethod[];
+}
+/**
+ * Provider configuration
+ */
+interface ProviderConfig {
+    apiUrl?: string;
+    apiKey?: string;
+    [key: string]: unknown;
+}
+/**
+ * Auth provider interface
+ *
+ * This interface defines the contract that all auth providers must implement.
+ * Providers can be for different backends like AuthSome, Clerk, Supabase, etc.
+ */
+interface AuthProvider {
+    /**
+     * Provider name/identifier
+     */
+    readonly name: string;
+    /**
+     * Initialize the provider
+     */
+    initialize(config: ProviderConfig): Promise<void>;
+    /**
+     * Sign in with email/username/phone and password
+     */
+    signIn(request: SignInRequest): Promise<AuthResponse>;
+    /**
+     * Sign up with email/username/phone and password
+     */
+    signUp(request: SignUpRequest): Promise<AuthResponse>;
+    /**
+     * Sign out
+     */
+    signOut(): Promise<void>;
+    /**
+     * Get current user
+     */
+    getCurrentUser(): Promise<User | null>;
+    /**
+     * Get current session
+     */
+    getCurrentSession(): Promise<Session | null>;
+    /**
+     * Refresh session
+     */
+    refreshSession(): Promise<Session>;
+    /**
+     * Update user profile
+     */
+    updateUser(request: UpdateUserRequest): Promise<User>;
+    /**
+     * Change password
+     */
+    changePassword(request: PasswordChangeRequest): Promise<void>;
+    /**
+     * Request password reset
+     */
+    requestPasswordReset(request: PasswordResetRequest): Promise<void>;
+    /**
+     * Confirm password reset
+     */
+    confirmPasswordReset(request: PasswordResetConfirmRequest): Promise<void>;
+    /**
+     * Initiate OAuth sign in
+     */
+    oauthSignIn(request: OAuthSignInRequest): Promise<string>;
+    /**
+     * Handle OAuth callback
+     */
+    oauthCallback(request: OAuthCallbackRequest): Promise<AuthResponse>;
+    /**
+     * Get available OAuth providers
+     */
+    getOAuthProviders(): Promise<OAuthProvider[]>;
+    /**
+     * Send magic link
+     */
+    sendMagicLink(request: MagicLinkRequest): Promise<void>;
+    /**
+     * Verify magic link
+     */
+    verifyMagicLink(request: MagicLinkVerifyRequest): Promise<AuthResponse>;
+    /**
+     * Send phone verification code
+     */
+    sendPhoneCode(request: PhoneAuthRequest): Promise<void>;
+    /**
+     * Verify phone code
+     */
+    verifyPhoneCode(request: PhoneVerifyRequest): Promise<AuthResponse>;
+    /**
+     * Setup 2FA
+     */
+    setupTwoFactor(request: TwoFactorSetupRequest): Promise<TwoFactorSetupResponse>;
+    /**
+     * Verify 2FA
+     */
+    verifyTwoFactor(request: TwoFactorVerifyRequest): Promise<AuthResponse>;
+    /**
+     * Disable 2FA
+     */
+    disableTwoFactor(): Promise<void>;
+    /**
+     * Get 2FA status
+     */
+    getTwoFactorStatus(): Promise<TwoFactorMethod[]>;
+    /**
+     * Register passkey
+     */
+    registerPasskey(request: PasskeyRegisterRequest): Promise<PasskeyCredential>;
+    /**
+     * Authenticate with passkey
+     */
+    authenticatePasskey(request: PasskeyAuthRequest): Promise<AuthResponse>;
+    /**
+     * List passkeys
+     */
+    listPasskeys(): Promise<PasskeyCredential[]>;
+    /**
+     * Delete passkey
+     */
+    deletePasskey(credentialId: string): Promise<void>;
+    /**
+     * Normalize provider-specific errors to AuthError
+     */
+    normalizeError(error: unknown): AuthError;
+    /**
+     * Get all organizations the user belongs to
+     * Optional - only available if adapter supports organizations
+     */
+    getOrganizations?(): Promise<Organization[]>;
+    /**
+     * Get the currently active organization
+     * Optional - only available if adapter supports organizations
+     */
+    getActiveOrganization?(): Promise<Organization | null>;
+    /**
+     * Set the active organization
+     * Optional - only available if adapter supports organizations
+     */
+    setActiveOrganization?(organizationId: string): Promise<void>;
+    /**
+     * Get organization memberships with roles and permissions
+     * Optional - only available if adapter supports organizations
+     */
+    getOrganizationMemberships?(): Promise<OrganizationMembership[]>;
+}
+
+export { AuthErrorType as A, type MagicLinkRequest as M, type OAuthSignInRequest as O, type PasswordChangeRequest as P, type SignInRequest as S, type TwoFactorSetupRequest as T, type UpdateUserRequest as U, type ValidationError as V, AuthError as a, type AuthContext as b, type AuthProvider as c, type SignUpRequest as d, type PasswordResetRequest as e, type PasswordResetConfirmRequest as f, type OAuthCallbackRequest as g, OAuthProvider as h, type MagicLinkVerifyRequest as i, type PhoneAuthRequest as j, type PhoneVerifyRequest as k, type TwoFactorSetupResponse as l, type TwoFactorVerifyRequest as m, TwoFactorMethod as n, type PasskeyRegisterRequest as o, type PasskeyCredential as p, type PasskeyAuthRequest as q, type Organization as r, type OrganizationMembership as s, type User as t, type Session as u, AuthState as v, type OAuthConfig as w, type TwoFactorConfig as x, type AuthResponse as y, type ProviderConfig as z };

package/dist/types/index.d.mts

@@ -0,0 +1,98 @@
+export { b as AuthContext, a as AuthError, A as AuthErrorType, c as AuthProvider, y as AuthResponse, v as AuthState, M as MagicLinkRequest, i as MagicLinkVerifyRequest, g as OAuthCallbackRequest, w as OAuthConfig, h as OAuthProvider, O as OAuthSignInRequest, r as Organization, s as OrganizationMembership, q as PasskeyAuthRequest, p as PasskeyCredential, o as PasskeyRegisterRequest, P as PasswordChangeRequest, f as PasswordResetConfirmRequest, e as PasswordResetRequest, j as PhoneAuthRequest, k as PhoneVerifyRequest, z as ProviderConfig, u as Session, S as SignInRequest, d as SignUpRequest, x as TwoFactorConfig, n as TwoFactorMethod, T as TwoFactorSetupRequest, l as TwoFactorSetupResponse, m as TwoFactorVerifyRequest, U as UpdateUserRequest, t as User, V as ValidationError } from '../provider-DXf_a2WT.mjs';
+
+/**
+ * Storage abstraction for auth tokens and data
+ */
+/**
+ * Storage interface
+ */
+interface Storage {
+    /**
+     * Get item from storage
+     */
+    getItem(key: string): Promise<string | null> | string | null;
+    /**
+     * Set item in storage
+     */
+    setItem(key: string, value: string): Promise<void> | void;
+    /**
+     * Remove item from storage
+     */
+    removeItem(key: string): Promise<void> | void;
+    /**
+     * Clear all items from storage
+     */
+    clear(): Promise<void> | void;
+}
+/**
+ * Storage adapter for localStorage
+ */
+declare class LocalStorageAdapter implements Storage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+/**
+ * Storage adapter for sessionStorage
+ */
+declare class SessionStorageAdapter implements Storage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+/**
+ * In-memory storage adapter (for testing or SSR)
+ */
+declare class MemoryStorageAdapter implements Storage {
+    private store;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+
+/**
+ * Observable pattern for state management across frameworks
+ */
+type Listener<T> = (value: T) => void;
+type Unsubscribe = () => void;
+/**
+ * Observable state container
+ */
+declare class Observable<T> {
+    private value;
+    private listeners;
+    constructor(initialValue: T);
+    /**
+     * Get current value
+     */
+    getValue(): T;
+    /**
+     * Set new value and notify listeners
+     */
+    setValue(newValue: T): void;
+    /**
+     * Update value with a function
+     */
+    update(updater: (current: T) => T): void;
+    /**
+     * Subscribe to value changes
+     */
+    subscribe(listener: Listener<T>): Unsubscribe;
+    /**
+     * Notify all listeners
+     */
+    private notify;
+    /**
+     * Clear all listeners
+     */
+    clearListeners(): void;
+    /**
+     * Get number of listeners
+     */
+    getListenerCount(): number;
+}
+
+export { type Listener, LocalStorageAdapter, MemoryStorageAdapter, Observable, SessionStorageAdapter, type Storage, type Unsubscribe };

package/dist/types/index.d.ts

@@ -0,0 +1,98 @@
+export { b as AuthContext, a as AuthError, A as AuthErrorType, c as AuthProvider, y as AuthResponse, v as AuthState, M as MagicLinkRequest, i as MagicLinkVerifyRequest, g as OAuthCallbackRequest, w as OAuthConfig, h as OAuthProvider, O as OAuthSignInRequest, r as Organization, s as OrganizationMembership, q as PasskeyAuthRequest, p as PasskeyCredential, o as PasskeyRegisterRequest, P as PasswordChangeRequest, f as PasswordResetConfirmRequest, e as PasswordResetRequest, j as PhoneAuthRequest, k as PhoneVerifyRequest, z as ProviderConfig, u as Session, S as SignInRequest, d as SignUpRequest, x as TwoFactorConfig, n as TwoFactorMethod, T as TwoFactorSetupRequest, l as TwoFactorSetupResponse, m as TwoFactorVerifyRequest, U as UpdateUserRequest, t as User, V as ValidationError } from '../provider-DXf_a2WT.js';
+
+/**
+ * Storage abstraction for auth tokens and data
+ */
+/**
+ * Storage interface
+ */
+interface Storage {
+    /**
+     * Get item from storage
+     */
+    getItem(key: string): Promise<string | null> | string | null;
+    /**
+     * Set item in storage
+     */
+    setItem(key: string, value: string): Promise<void> | void;
+    /**
+     * Remove item from storage
+     */
+    removeItem(key: string): Promise<void> | void;
+    /**
+     * Clear all items from storage
+     */
+    clear(): Promise<void> | void;
+}
+/**
+ * Storage adapter for localStorage
+ */
+declare class LocalStorageAdapter implements Storage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+/**
+ * Storage adapter for sessionStorage
+ */
+declare class SessionStorageAdapter implements Storage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+/**
+ * In-memory storage adapter (for testing or SSR)
+ */
+declare class MemoryStorageAdapter implements Storage {
+    private store;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+
+/**
+ * Observable pattern for state management across frameworks
+ */
+type Listener<T> = (value: T) => void;
+type Unsubscribe = () => void;
+/**
+ * Observable state container
+ */
+declare class Observable<T> {
+    private value;
+    private listeners;
+    constructor(initialValue: T);
+    /**
+     * Get current value
+     */
+    getValue(): T;
+    /**
+     * Set new value and notify listeners
+     */
+    setValue(newValue: T): void;
+    /**
+     * Update value with a function
+     */
+    update(updater: (current: T) => T): void;
+    /**
+     * Subscribe to value changes
+     */
+    subscribe(listener: Listener<T>): Unsubscribe;
+    /**
+     * Notify all listeners
+     */
+    private notify;
+    /**
+     * Clear all listeners
+     */
+    clearListeners(): void;
+    /**
+     * Get number of listeners
+     */
+    getListenerCount(): number;
+}
+
+export { type Listener, LocalStorageAdapter, MemoryStorageAdapter, Observable, SessionStorageAdapter, type Storage, type Unsubscribe };