feat(tanstack-router): implement @asgardeo/tanstack-router with <ProtectedRoute /> for auth-guarded routes

[d3varaja]

Initial implementation of @asgardeo/tanstack-router, providing a for TanStack Router. This enables auth-guarded routes with Asgardeo, removing the need for manual useAsgardeo wiring and aligning with the DX of @asgardeo/react-router.

Purpose

• Deliver first-class TanStack Router support (requested in feat: implement @asgardeo/tanstack-router package for route protection #152).
• Guard routes declaratively with using isSignedIn/isLoading.
• Support fallback, redirectTo, and loader props.
• Fail-fast with AsgardeoRuntimeError if neither fallback nor redirectTo provided.
• API mirrors @asgardeo/react-router for easy migration.

Related Issues

• Closes feat: implement @asgardeo/tanstack-router package for route protection #152

Checklist

• e2e cypress tests locally verified
• Manual test round performed and verified
• UX/UI review done on the final implementation
• Documentation provided (README + migration guide)
• Unit tests provided (export/shape checks)
• Integration tests provided

Security checks

• Followed secure coding standards in http://wso2.com/technical-reports/wso2-secure-engineering-guidelines?
• Ran FindSecurityBugs plugin and verified report (N/A for JS/TS)
• Confirmed no keys, tokens, or secrets committed

[brionmario]

Hey @d3varaja,

Thanks alot for the PR.
I've approved workflow runs.

There seems to be some failures due to pnpm-lock being not commited.
Please commit that as well.

Additionally, shall we do the following tasks as well:

1. Have a simple sample under the samples directory.

samples:
    - react-tanstack-router

The samples should be:

• Scaffolded with vite (React TS Template)
• Have a protected page (ex: Dashboard.tsx) -> Protected with the ProtectedRoute from @asgardeo/tanstack-router
• Have a root component that's unprotected (ex: Home.tsx)

2. Send a PR to the official docs space (https://wso2.com/asgardeo/docs/sdks/react/guides/protecting-routes/)

• File Location: https://github.com/wso2/docs-is/blob/6685ef954bbe29d4f9d62da2318a2639a811ebdc/en/includes/sdks/react/guides/protecting-routes.md?plain=1#L36

Note

We may have to restructure the current structure to include both router options. i.e @asgardeo/react-router & @asgardeo/tanstack-router

[d3varaja]

hi @brionmario,

i created a pr for the documentation update at wso2/docs-is#5607 please feel free to check it out

thanks!

[brionmario]

hi @brionmario,

i created a pr for the documentation update at wso2/docs-is#5607 please feel free to check it out

thanks!

Cool. Will check 🙌

Shall we work on the sample as well?

[d3varaja]

hi @brionmario,
i created a pr for the documentation update at wso2/docs-is#5607 please feel free to check it out
thanks!

Cool. Will check 🙌

Shall we work on the sample as well?

working on it right now, will push in a bit

[d3varaja]

@brionmario pushed the sample application, feel free to look at it when you have some time, thanks

[brionmario]

@brionmario pushed the sample application, feel free to look at it when you have some time, thanks

Great!
Let me have a look and get back.

Meantime, lets do the following:

• There's a build failure. Could you have a look.

• Lets add a changeset to the new package.

  • Guide: https://github.com/asgardeo/javascript/blob/main/CONTRIBUTING.md#creating-a-changeset

  Lets add a PATCH bump. (so it'll be 0.0.1, first tagged release)

• Also try to follow our commit message guideline: https://github.com/asgardeo/javascript/blob/main/CONTRIBUTING.md#example-commit-message

[asgardeo-github-bot]

⚠️ No Changeset found

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go.

If these changes should result in a version bump, you need to add a changeset.

Refer Release Documentation to learn how to add a changeset.

[d3varaja]

hi @brionmario, i updated the lock file which was causing the ci/cd issues and also add the change set, let me know if there is any issues with them, thanks! :)