frica_id_flutter 1.2.0

Official Flutter SDK for Sign in with Frica ID. OAuth 2.1 PKCE authorization, user management, and seamless authentication for iOS, Android, and Web.

Changelog

1.2.0

• Expose the profile-scoped public_id claim as optional publicId for public display.
• Preserve the opaque OAuth sub for account matching and compatibility with older profile responses.
• Cover missing/malformed claims, stored or serialized profiles, and compact avatar URLs.

1.1.0

• Added Sovereign Wallet & Frica Tokens (FRICA) Support:
  • Added FricaWallet model with availableBalance, lockedBalance, totalToppedUp, and remainingKycChecks (0.45 FRICA / check runway calculator).
  • Added FricaWalletTransaction ledger transaction model.
  • Added FricaClient.getDeveloperWallet(): Query organization wallet balance and KYC check runway.
  • Added FricaClient.topupDeveloperWallet(): Top up organization tokens with Multi-rail payments (Card, Mobile Money, Crypto, Sandbox).
  • Added FricaClient.getUserWallet(): Retrieve user sovereign wallet.
  • Added FricaClient.topupUserWallet(): Top up user tokens with bonus token support.
  • Added FricaClient.payServiceWithTokens(): Pay for tier upgrades directly using tokens.
• Added Digital Passport Authenticity Verification:
  • Added FricaPassportVerificationResult model.
  • Added FricaClient.verifyDigitalPassport(identifier): Verify authenticity of scanned QR codes and passports.
• Enhanced KYC API Compatibility:
  • Extended createKycSession() with returnUrl, cancelUrl, customReference, and automatic customer payload normalization.
  • Extended instantKycCheck() with documentType and documentNumber parameter aliases.

1.0.8

• Added comprehensive KYC and identity verification support:
  • Added strongly-typed KYC claims to FricaUserInfo (kycStatus, kycTier, kycVerifiedAt, kycLegalFirstName, kycLegalLastName, kycDateOfBirth, kycNationality, kycCountryOfResidence).
  • Added helper getters on FricaUserInfo: isKycApproved, isKycUnderReview, isKycPending, isKycRejected.
  • Added Developer KYC Models: FricaKycSession, FricaKycVerification, FricaInstantCheckResult.
  • Added FricaClient.launchKycVerification() to launch the hosted verification portal in the browser.
  • Added FricaClient.createKycSession(), FricaClient.getKycVerification(), and FricaClient.instantKycCheck() for developer KYC integration.
  • Added unit test suite covering PKCE generation, KYC claim parsing, and model serialization.

1.0.7

• Replaced the abbreviated Apache notice with the canonical Apache License 2.0 text so pub.dev can recognize the OSI-approved license.

1.0.6

• Switched pub.dev releases to Dart's official reusable GitHub Actions publishing workflow.
• Fixed trusted publishing so releases authenticate with short-lived GitHub OIDC credentials instead of interactive Google authorization.
• Preserved tag-based release publishing with no long-lived pub.dev secret.

1.0.5

• Added automated CI validation and pub.dev publish dry runs.
• Added secure pub.dev automated publishing through GitHub Actions and OIDC.
• Added release tag/version validation before publishing.
• Updated installation documentation for the current package release.

1.0.4

• Added webRedirectUri to FricaConfig for explicit Flutter Web redirect handling.
• Automatically fall back to Uri.base.origin on Flutter Web when a mobile custom scheme (supfrica://) is provided.
• Added handleWebCallbackIfPresent() automated helper for Flutter Web callbacks.

1.0.3

• Robust response payload unpacking: seamlessly support both standard RFC OAuth responses and nested envelopes.
• Graceful non-blocking user profile caching on authorization code redirect callbacks.
• Whitespace trimming and safety checks on Bearer access tokens before /oauth/userinfo retrieval.

1.0.2

• Enhance error message when fetching user profile to include full HTTP status code and response payload.

1.0.1

• Fix type cast error (type 'Null' is not a subtype of 'String' in type cast) when parsing user profile claims and token responses with optional fields.
• Robust parsing for sub, name, email, and phoneNumber.

1.0.0

• Initial release of frica_id_flutter.
• Official OAuth 2.1 Authorization Code Flow with PKCE (RFC 7636).
• Built-in FricaSignInButton Widget with AMOLED pure black and Frica Gold styling.
• Secure token exchange and refresh lifecycle management.
• User profile retrieval and deep link integration for iOS, Android, and Web.