feat: add new error code description and troubleshooting for 4321

[pesickaa]

Description (required)

Add Error 4321 Description and troubleshooting steps

We don't currently have this documented publicly, but it is a very clear error with clear steps to help users solve without needing to reach out to support first.

Related issues & labels (optional)

• Closes #
• Suggested label:

Summary by CodeRabbit

• Documentation
  • Added troubleshooting entry for Error code 4321 describing the mid-step URL access scenario, common causes (reused/bookmarked step URLs, shared step-specific links, browser back/forward skipping steps), and step-by-step resolutions: restart login from the main entry point, clear cookies/cache, and avoid using bookmarked or shared step-specific login URLs.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 5caab07a-384c-4ff9-8920-83aec7836e66

📥 Commits

Reviewing files that changed from the base of the PR and between 2ced69d and 7ece11f.

📒 Files selected for processing (1)

• src/content/docs/get-started/guides/error-codes.mdx

🚧 Files skipped from review as they are similar to previous changes (1)

• src/content/docs/get-started/guides/error-codes.mdx

---

Walkthrough

This PR adds troubleshooting documentation for error code 4321 in the error-codes guide. The new section describes mid-step URL access scenarios, lists common causes (bookmarked step URLs, shared URLs, browser navigation skipping steps), and provides remediation guidance for users.

Changes

Error Code 4321 Documentation

Layer / File(s)	Summary
Error code 4321 troubleshooting entry src/content/docs/get-started/guides/error-codes.mdx	New troubleshooting section for error code 4321 documents the mid-step URL access scenario, lists causes (reused/bookmarked step URLs, shared step-specific URLs, browser back/forward navigation), and provides remediation steps (restart from main entry point, clear cookies/cache, avoid bookmarked/shared login URLs).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• kinde-oss/documentation#740: Adds other error-code troubleshooting entries in the same error-codes.mdx document.

Suggested reviewers

• DanielRivers
• coel

Poem

🐰 A hop through the docs, so clear and so bright,
Error 4321 now shines with new light—
Mid-step URL troubles? We've got your solution,
Clear cookies, restart, find your absolution! ✨

🚥 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 and directly describes the main change: adding documentation for a new error code (4321) with its description and troubleshooting steps, which aligns perfectly with the changeset.
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.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/add-4321-error-code

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[cloudflare-workers-and-pages]

Deploying kinde-docs-preview with    Cloudflare Pages

Latest commit:	7ece11f
Status:	✅  Deploy successful!
Preview URL:	https://6191888a.kinde-docs-preview.pages.dev
Branch Preview URL:	https://feat-add-4321-error-code.kinde-docs-preview.pages.dev

View logs

[coderabbitai]

🧹 Nitpick comments (1)

src/content/docs/get-started/guides/error-codes.mdx (1)

196-196: 💤 Low value

Consider using "authentication flow" instead of "login flow" for broader applicability.

The term "login flow" may be too narrow if this error can also occur during signup, password reset, or other authentication flows. Using "authentication flow" would be more inclusive and consistent with similar entries like Error code 8809 (line 253) which uses "auth flow."

📝 Suggested phrasing

-  - This error typically occurs when a user attempts to access a login flow from a mid-step URL instead of starting from the beginning.
+  - This error typically occurs when a user attempts to access an authentication flow from a mid-step URL instead of starting from the beginning.

🤖 Prompt for 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.

In `@src/content/docs/get-started/guides/error-codes.mdx` at line 196, Replace the
phrase "login flow" in the sentence that reads "This error typically occurs when
a user attempts to access a login flow from a mid-step URL instead of starting
from the beginning." with "authentication flow" for broader applicability and
consistency with the wording used in Error code 8809; update the sentence to
"This error typically occurs when a user attempts to access an authentication
flow from a mid-step URL instead of starting from the beginning."

🤖 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.

Nitpick comments:
In `@src/content/docs/get-started/guides/error-codes.mdx`:
- Line 196: Replace the phrase "login flow" in the sentence that reads "This
error typically occurs when a user attempts to access a login flow from a
mid-step URL instead of starting from the beginning." with "authentication flow"
for broader applicability and consistency with the wording used in Error code
8809; update the sentence to "This error typically occurs when a user attempts
to access an authentication flow from a mid-step URL instead of starting from
the beginning."

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 5635f3c7-5935-4805-ab1f-c179ff196173

📥 Commits

Reviewing files that changed from the base of the PR and between 0e0a2ed and 2ced69d.

📒 Files selected for processing (1)

• src/content/docs/get-started/guides/error-codes.mdx

[tamalchowdhury]

LGTM, check for any merge conflicts.