Skip to content

Conversation

ChiragAgg5k
Copy link
Member

@ChiragAgg5k ChiragAgg5k commented Oct 8, 2025

This PR contains updates to the Flutter SDK for version 20.1.0.

Summary by CodeRabbit

  • New Features
    • Added email verification APIs for creating and completing verifications.
  • Deprecations
    • Deprecated legacy verification methods in favor of the new email verification APIs.
  • Documentation
    • Added examples for creating and updating email verification.
    • Updated README to reference the latest package version.
    • Updated change log with details for version 20.1.0.
  • Tests
    • Added tests covering new email verification flows.
  • Chores
    • Bumped SDK version to 20.1.0 and updated version headers.

Copy link

coderabbitai bot commented Oct 8, 2025

Walkthrough

Adds Account API methods createEmailVerification and updateEmailVerification, deprecates createVerification and updateVerification, and updates verification endpoint paths to /account/verifications/email and /account/verifications/phone. Adds Dart examples for creating/updating email verifications and unit tests for the new methods. Bumps package version and README dependency to 20.1.0 and updates x-sdk-version headers in client_browser and client_io to 20.1.0. Updates TablesDB comment links to new documentation URLs. No other functional signature changes.

Possibly related PRs

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The title clearly indicates that the pull request introduces a new feature release by updating the Flutter SDK to version 20.1.0, which aligns with the primary changes of deprecating old methods, adding email verification endpoints, and bumping the package version. It is concise, specific, and reflects the main purpose of the changeset.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch dev

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between c11a4e5 and c857cbc.

📒 Files selected for processing (5)
  • CHANGELOG.md (1 hunks)
  • README.md (1 hunks)
  • lib/src/client_browser.dart (1 hunks)
  • lib/src/client_io.dart (1 hunks)
  • pubspec.yaml (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (5)
  • README.md
  • CHANGELOG.md
  • pubspec.yaml
  • lib/src/client_io.dart
  • lib/src/client_browser.dart

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
lib/services/account.dart (1)

1366-1396: Update documentation link to reference the new method.

Line 1373 references the deprecated updateVerification method. Since this is the new createEmailVerification method, the documentation should reference updateEmailVerification instead to guide users to the current API.

Apply this diff to update the documentation link:

-  /// process](https://appwrite.io/docs/references/cloud/client-web/account#updateVerification).
+  /// process](https://appwrite.io/docs/references/cloud/client-web/account#updateEmailVerification).
🧹 Nitpick comments (1)
lib/services/account.dart (1)

29-29: Fix typo in documentation URL.

The URL contains a typo: "verfication" should be "verification".

Apply this diff to fix the typo:

-  /// [/account/verfication](https://appwrite.io/docs/references/cloud/client-web/account#createVerification)
+  /// [/account/verification](https://appwrite.io/docs/references/cloud/client-web/account#createVerification)

Note: Consider also updating this reference to point to createEmailVerification instead of the deprecated createVerification method.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 7c5b893 and c11a4e5.

📒 Files selected for processing (10)
  • CHANGELOG.md (1 hunks)
  • README.md (1 hunks)
  • docs/examples/account/create-email-verification.md (1 hunks)
  • docs/examples/account/update-email-verification.md (1 hunks)
  • lib/services/account.dart (4 hunks)
  • lib/services/tables_db.dart (2 hunks)
  • lib/src/client_browser.dart (1 hunks)
  • lib/src/client_io.dart (1 hunks)
  • pubspec.yaml (1 hunks)
  • test/services/account_test.dart (2 hunks)
🔇 Additional comments (14)
lib/services/tables_db.dart (1)

33-35: Doc link refresh looks good.

Updated URLs point to the new server-dart TablesDB docs and keep the comment formatting intact. 👍

Also applies to: 95-96

README.md (1)

24-24: LGTM!

Version bump to 20.0.1 is consistent with the overall SDK update.

lib/src/client_io.dart (1)

61-61: LGTM!

SDK version header update is consistent with the package version bump.

pubspec.yaml (1)

2-2: LGTM!

Version bump to 20.0.1 is appropriate for this feature update.

lib/src/client_browser.dart (1)

43-43: LGTM!

SDK version header update is consistent with the package version bump and matches the client_io.dart update.

docs/examples/account/create-email-verification.md (1)

1-11: LGTM!

The example clearly demonstrates the usage of the new createEmailVerification method and follows the standard pattern for Appwrite SDK documentation examples.

docs/examples/account/update-email-verification.md (1)

1-12: LGTM!

The example clearly demonstrates the usage of the new updateEmailVerification method and follows the standard pattern for Appwrite SDK documentation examples.

test/services/account_test.dart (2)

1383-1403: LGTM!

The test for createEmailVerification follows the established pattern in the test suite and appropriately validates the method's behavior.


1427-1448: LGTM!

The test for updateEmailVerification follows the established pattern in the test suite and appropriately validates the method's behavior.

lib/services/account.dart (5)

1413-1431: LGTM! Well-executed deprecation strategy.

The deprecation is properly annotated with a clear migration path, and the implementation maintains backward compatibility by pointing to the new email-specific endpoint. The duplicate code is intentional and acceptable for this transition period.


1437-1455: LGTM! Clean implementation of the new email verification update method.

The method correctly implements the email verification completion endpoint with appropriate parameters and return type.


1461-1482: LGTM! Consistent deprecation pattern.

The deprecation follows the same well-executed pattern as createVerification, maintaining backward compatibility while guiding users to the new API.


1492-1507: LGTM! Consistent API path structure.

The path update to /account/verifications/phone aligns with the new RESTful endpoint structure and matches the pattern used for email verification.


1513-1531: LGTM! Consistent path update for phone verification.

The path update maintains consistency with the create method and follows the new endpoint structure.

CHANGELOG.md Outdated
Comment on lines 3 to 7
## 20.0.1

* Deprecate `createVerification` method in `Account` service
* Add `createEmailVerification` method in `Account` service

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

CHANGELOG entry appears incomplete.

Based on the AI summary and the test file changes (which include both createEmailVerification and updateEmailVerification tests), the changelog should document:

  1. Deprecation of createVerification method ✓ (documented)
  2. Addition of createEmailVerification method ✓ (documented)
  3. Deprecation of updateVerification method ✗ (missing)
  4. Addition of updateEmailVerification method ✗ (missing)

Additionally, the AI summary mentions endpoint path updates (/account/verifications/email and /account/verifications/phone), which are not documented in the changelog.

Consider updating the changelog to:

 ## 20.0.1
 
-* Deprecate `createVerification` method in `Account` service
-* Add `createEmailVerification` method in `Account` service
+* Deprecate `createVerification` and `updateVerification` methods in `Account` service
+* Add `createEmailVerification` and `updateEmailVerification` methods in `Account` service
+* Update endpoint paths for email and phone verification methods
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
## 20.0.1
* Deprecate `createVerification` method in `Account` service
* Add `createEmailVerification` method in `Account` service
## 20.0.1
* Deprecate `createVerification` and `updateVerification` methods in `Account` service
* Add `createEmailVerification` and `updateEmailVerification` methods in `Account` service
* Update endpoint paths for email and phone verification methods
🤖 Prompt for AI Agents
In CHANGELOG.md around lines 3 to 7, the 20.0.1 entry is incomplete: it
documents deprecation of createVerification and addition of
createEmailVerification but omits deprecation of updateVerification, addition of
updateEmailVerification, and the endpoint path updates
(/account/verifications/email and /account/verifications/phone). Update the
20.0.1 section to add entries noting deprecation of updateVerification, addition
of updateEmailVerification, and list the endpoint path changes for email and
phone verification routes; keep wording consistent with existing bullets and
include backticks for method names and endpoint paths.

@ChiragAgg5k ChiragAgg5k changed the title feat: Flutter SDK update for version 20.0.1 feat: Flutter SDK update for version 20.1.0 Oct 8, 2025
@abnegate abnegate merged commit 439d798 into main Oct 8, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants