Skip to content

docs(database): document signUp and changePassword - #208

Merged
tusharpandey13 merged 5 commits into
mainfrom
feat/database-conns-docs
Jul 21, 2026
Merged

docs(database): document signUp and changePassword#208
tusharpandey13 merged 5 commits into
mainfrom
feat/database-conns-docs

Conversation

@tusharpandey13

@tusharpandey13 tusharpandey13 commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the database-connection operations across both packages:

  • auth0-auth-js/README.md — new section "Database Connections (Sign-up & Change Password)" with public-endpoint / plain-text / no-secret callout.
  • auth0-auth-js/EXAMPLES.md — TOC entry + full "Using Database Connections" section: signUp (SignUpResult table), changePassword, error-handling table (code + sanitized cause).
  • auth0-server-js/README.md — new section documenting ServerClient.signUp / changePassword pure-passthrough (no session write) + resolver-mode note.

Test plan

  • Section numbering sequential (1–10)
  • EXAMPLES anchor resolves
  • No placeholders

Depends on

Documents the API from #206 (feat(database)). Merge after #206.

Summary by CodeRabbit

  • Documentation
    • Added guidance for database connection sign-up and password-change workflows.
    • Documented client and server usage, required and optional fields, response formats, and per-request client ID overrides.
    • Added examples covering error handling, field normalization, validation, and multi-tenant domain resolution.
    • Updated table-of-contents and section numbering across the documentation.

@coderabbitai

coderabbitai Bot commented Jun 30, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@tusharpandey13, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 59 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: de8b2a92-ff13-482f-a22f-7c9d4a162145

📥 Commits

Reviewing files that changed from the base of the PR and between d374527 and a5195af.

📒 Files selected for processing (3)
  • packages/auth0-auth-js/EXAMPLES.md
  • packages/auth0-auth-js/README.md
  • packages/auth0-server-js/README.md
📝 Walkthrough

Walkthrough

Documentation now covers database connection sign-up and change-password workflows for Auth and Server clients, including endpoint behavior, examples, response handling, validation, errors, client ID usage, and resolver behavior.

Changes

Database connection documentation

Layer / File(s) Summary
Auth client database workflows
packages/auth0-auth-js/EXAMPLES.md, packages/auth0-auth-js/README.md
Adds database.signUp and database.changePassword documentation, including request behavior, result handling, error classes, validation, examples, and updated section numbering.
Server client database workflows
packages/auth0-server-js/README.md
Documents the ServerClient.database sub-client, passthrough endpoint behavior, error handling, plain-text responses, client ID usage, and resolver domain handling.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Suggested reviewers: nandan-bhat, gyaneshgouraw-okta

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main documentation changes for database signUp and changePassword flows.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/database-conns-docs

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/auth0-auth-js/EXAMPLES.md`:
- Line 1582: Update the changePassword documentation to describe the full input
contract: packages/auth0-auth-js/EXAMPLES.md lines 1582-1582 must state that
connection plus either email or username is accepted and show the username
alternative; packages/auth0-auth-js/README.md lines 336-340 and
packages/auth0-server-js/README.md lines 283-287 must also mention or link to
the username-based variant. No implementation changes are needed.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: dc348d36-f914-4559-b048-cc174bddc4e8

📥 Commits

Reviewing files that changed from the base of the PR and between 60d0e42 and d374527.

📒 Files selected for processing (3)
  • packages/auth0-auth-js/EXAMPLES.md
  • packages/auth0-auth-js/README.md
  • packages/auth0-server-js/README.md

Comment thread packages/auth0-auth-js/EXAMPLES.md Outdated
- Restore passkey sub-entries (Signup/Login Challenge, Exchanging a Credential)
  under "Using Passkeys" and move "Using Database Connections" after Custom Token
  Exchange to match the document body order, with correct sub-entries
- Add an endpoints table to the Database Connections section and normalize the
  "Learn more:" link label
- Clarify in auth0-server-js README that domain resolution is independent of
  session state (constructor domain in static mode; per-call resolver with
  storeOptions in resolver mode)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Piyush-85
Piyush-85 previously approved these changes Jul 17, 2026
changePassword accepts connection plus either email or username; the docs
previously showed only the email path and incorrectly stated email is required.
Correct the requirement to "email or username" and show the username-based
alternative in EXAMPLES.md, auth0-auth-js README, and auth0-server-js README.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@Piyush-85

Copy link
Copy Markdown

LGTM, reviewed async with @tusharpandey13

@tusharpandey13
tusharpandey13 merged commit b698c9e into main Jul 21, 2026
15 of 16 checks passed
@tusharpandey13
tusharpandey13 deleted the feat/database-conns-docs branch July 21, 2026 15:36
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