Flutter SDK API

import 'package:para/src/auth_extensions.dart';

enum Environment {
  dev,      // Development environment
  beta,     // Beta environment
  prod      // Production environment
}

class Auth {
  static AuthEmail email(String email);
  static AuthPhone phone(String phoneNumber);
}

class AuthState {
  final AuthStage stage;           // Current authentication stage
  final String? userId;            // User's unique identifier
  final AuthIdentity auth;         // Authentication identity details
  final String? displayName;       // User's display name
  final String? pfpUrl;           // Profile picture URL
  final String? username;         // Username
  final Map<String, dynamic>? externalWallet; // External wallet info
  final String? loginUrl;         // One-Click URL, when provided
  final List<String>? loginAuthMethods;   // Advertised login methods (e.g., BASIC_LOGIN)
  final List<String>? signupAuthMethods;  // Advertised signup methods
  final String? passkeyUrl;       // URL for passkey authentication
  final String? passkeyId;        // Passkey identifier
  final String? passwordUrl;      // URL for password authentication
  final AuthStage? nextStage;     // Optional next stage hint

  // Helper getters exposed by the SDK:
  bool get hasSloUrl;             // loginUrl is non-empty
  List<String> get loginMethods;  // loginAuthMethods ?? []
  List<String> get signupMethods; // signupAuthMethods ?? []
  AuthStage get effectiveNextStage; // nextStage ?? stage
}

class AuthIdentity {
  final String? email;
  final String? phoneNumber;
  final String? fid;              // Farcaster ID
  final String? telegramUserId;
  // Other identity types
}

enum AuthStage {
  verify,  // Need to verify email/phone
  login,   // Existing user, proceed to login
  signup   // New user, proceed to signup
}

enum SignupMethod {
  passkey,  // Hardware-backed passkey
  password  // Password-based authentication
}

enum OAuthMethod {
  google,
  twitter,
  apple,
  discord,
  facebook
}

enum WalletType {
  evm,     // Ethereum and EVM-compatible chains
  solana,  // Solana blockchain
  cosmos   // Cosmos-based chains
}

class ParaFuture<T> {
  final Future<T> future;    // The actual future
  final String requestId;    // ID for cancellation
}

class Wallet {
  final String id;
  final String address;
  final WalletType type;
  final WalletScheme scheme;
  final String? userId;         // Associated user ID
  final DateTime? createdAt;    // Creation timestamp
  final String? publicKey;      // Wallet public key
  final bool? isPregen;         // Whether this is a pregenerated wallet
  // Additional optional fields available
}

// Abstract base class
abstract class SignatureResult {}

// Successful signature
class SuccessfulSignatureResult extends SignatureResult {
  final String signedTransaction;  // For transactions: complete signed transaction ready for broadcasting
                                   // For messages: just the signature
  
  SuccessfulSignatureResult(this.signedTransaction);
  
  /// Gets the transaction data ready for broadcasting.
  String get transactionData => signedTransaction;
}

// Denied signature
class DeniedSignatureResult extends SignatureResult {
  final String? pendingTransactionId;
  DeniedSignatureResult(this.pendingTransactionId);
}

// Denied with URL
class DeniedSignatureResultWithUrl extends SignatureResult {
  final String? pendingTransactionId;
  final String url;
  DeniedSignatureResultWithUrl({this.pendingTransactionId, required this.url});
}