docs(nextjs): point the sample, JSDoc and quick start at the middleware entry point

[DonOmalVindula]

Problem

asgardeoMiddleware and createRouteMatcher moved to the Edge-safe @asgardeo/nextjs/middleware entry point in d6b5cba (token refresh in the middleware), but nothing that points users at the middleware followed:

• samples/teamspace-nextjs/middleware.ts still imports them from @asgardeo/nextjs/server, which no longer exports them, so the sample does not build. CI's E2E suite only runs the React sample, so this went unnoticed.
• The JSDoc examples on asgardeoMiddleware import from the package root, which never exported it.
• QUICKSTART.md describes a new AsgardeoNext() / asgardeo.middleware(request) setup that does not exist (the constructor is private and there is no middleware() method), and configures the embedded sign-in page path through that non-existent API.

Fix

• Sample and JSDoc examples import from @asgardeo/nextjs/middleware.
• Quick start: the middleware step uses asgardeoMiddleware() from the middleware entry point; the embedded login step configures the sign-in page through NEXT_PUBLIC_ASGARDEO_SIGN_IN_URL, which both the provider and the middleware read (SignInButton navigates there, protectRoute() redirects there). The stray "Auth.js" references in the intro and resources are dropped.
• README gains a short "Middleware" section explaining the entry point and why the root/server entries cannot be used from middleware.ts.

Re-exporting the middleware from /server for backward compatibility was deliberately not done: that entry pulls @asgardeo/node (and its Node-only dependencies) into the Edge bundle, which is what the separate entry point avoids.

Testing

• pnpm lint for @asgardeo/nextjs; the ./middleware export condition and dist/types/middleware.d.ts are present in the build.
• The sample is excluded from the pnpm workspace, so it was not built here.

Changeset included (@asgardeo/nextjs patch).

🤖 Generated with Claude Code

[coderabbitai]

Warning

Review limit reached

Next included review available in 53 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Team

Run ID: 8baed1d6-065b-4217-85cb-4138c1540cde

📥 Commits

Reviewing files that changed from the base of the PR and between 409ebae and ea4a282.

📒 Files selected for processing (5)

• .changeset/nextjs-middleware-import-path.md
• packages/nextjs/QUICKSTART.md
• packages/nextjs/README.md
• packages/nextjs/src/server/middleware/asgardeoMiddleware.ts
• samples/teamspace-nextjs/middleware.ts

---

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

[asgardeo-github-bot]

🦋 Changeset detected

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.