chore: stabilize `@asgardeo/react` & `@asgardeo/nextjs`

**Is your feature request related to a problem? Please describe.**
The `@asgardeo/react` and `@asgardeo/nextjs` packages currently have APIs and behaviors that may change unexpectedly between versions. This makes it difficult for consumers to confidently adopt them in production environments, especially when version bumps introduce breaking changes or undocumented side effects.

**Describe the solution you would prefer**
Finalize and stabilize the public APIs for both `@asgardeo/react` and `@asgardeo/nextjs`, ensuring that future changes follow semantic versioning and include appropriate documentation. Mark internal or experimental APIs clearly to prevent unintentional usage by consumers.

**Additional context**
Stabilizing these packages is essential ahead of broader adoption, especially for enterprise clients and OSS maintainers. It will also help reduce developer friction, improve long-term maintainability, and align the SDKs with expectations set by other Asgardeo tooling.

Inizia facendo un inventario delle API pubbliche e dei comportamenti esposti dai package @asgardeo/react e @asgardeo/nextjs; l’issue non specifica file o test. Confronta le API attuali con la documentazione dei package e definisci il completamento come API stabili documentate, confini chiari tra elementi sperimentali e interni e indicazioni sul versionamento semantico per modifiche future.

Scritto dal modello di indicizzazione a partire dal testo della issue.