@asgardeo/react 0.11.2 → 0.12.0

package/dist/hooks/useBranding.d.ts

@@ -24,48 +24,40 @@ export interface UseBrandingConfig {
     /**
      * @deprecated This configuration is now handled by BrandingProvider
      */
-    locale?: string;
+    autoFetch?: boolean;
     /**
      * @deprecated This configuration is now handled by BrandingProvider
      */
-    name?: string;
+    fetcher?: (url: string, config: RequestInit) => Promise<Response>;
     /**
      * @deprecated This configuration is now handled by BrandingProvider
      */
-    type?: string;
+    forceTheme?: 'light' | 'dark';
     /**
      * @deprecated This configuration is now handled by BrandingProvider
      */
-    forceTheme?: 'light' | 'dark';
+    locale?: string;
     /**
      * @deprecated This configuration is now handled by BrandingProvider
      */
-    autoFetch?: boolean;
+    name?: string;
     /**
      * @deprecated This configuration is now handled by BrandingProvider
      */
-    fetcher?: (url: string, config: RequestInit) => Promise<Response>;
+    type?: string;
 }
 /**
  * Return type of the useBranding hook
  */
 export interface UseBrandingReturn {
-    /**
-     * The raw branding preference data
-     */
-    brandingPreference: BrandingPreference | null;
-    /**
-     * The transformed theme object
-     */
-    theme: Theme | null;
     /**
      * The active theme mode from branding preference ('light' | 'dark')
      */
     activeTheme: 'light' | 'dark' | null;
     /**
-     * Loading state
+     * The raw branding preference data
      */
-    isLoading: boolean;
+    brandingPreference: BrandingPreference | null;
     /**
      * Error state
      */
@@ -74,11 +66,19 @@ export interface UseBrandingReturn {
      * Function to manually fetch branding preference
      */
     fetchBranding: () => Promise<void>;
+    /**
+     * Loading state
+     */
+    isLoading: boolean;
     /**
      * Function to refetch branding preference
      * This bypasses the single-call restriction and forces a new API call
      */
     refetch: () => Promise<void>;
+    /**
+     * The transformed theme object
+     */
+    theme: Theme | null;
 }
 /**
  * React hook for accessing branding preferences from the BrandingProvider context.
@@ -123,5 +123,5 @@ export interface UseBrandingReturn {
  * }
  * ```
  */
-export declare const useBranding: (config?: UseBrandingConfig) => UseBrandingReturn;
+export declare const useBranding: () => UseBrandingReturn;
 export default useBranding;

package/dist/hooks/useBrowserUrl.d.ts

@@ -27,6 +27,14 @@ export interface UseBrowserUrl {
      * @returns True if the URL contains authentication parameters and matches the afterSignInUrl, or if it contains an error parameter
      */
     hasAuthParams: (url: URL, afterSignInUrl: string) => boolean;
+    /**
+     * Checks if the URL indicates that the authentication flow has been called for this instance.
+     *
+     * @param url - The URL object to check
+     * @param instanceId - The instance ID to check against
+     * @returns True if the URL indicates the flow has been called for this instance
+     */
+    hasCalledForThisInstance: (url: URL, instanceId: number) => boolean;
 }
 /**
  * Hook that provides utilities for handling browser URLs in authentication flows.

package/dist/hooks/useForm.d.ts

@@ -15,6 +15,7 @@
  * specific language governing permissions and limitations
  * under the License.
  */
+import { FormEvent } from 'react';
 /**
  * Generic form field configuration
  */
@@ -87,7 +88,7 @@ export interface UseFormReturn<T extends Record<string, string>> {
     /**
      * Handle form submission
      */
-    handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: React.FormEvent) => Promise<void>;
+    handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: FormEvent) => Promise<void>;
     /**
      * Whether the form has been submitted
      */
@@ -129,21 +130,21 @@ export interface UseFormReturn<T extends Record<string, string>> {
      */
     touchAllFields: () => void;
     /**
-     * Validate all fields
-     */
-    validateForm: () => ValidationResult;
-    /**
-     * Current form values
+     * Fields that have been touched by the user
      */
-    values: T;
+    touched: Record<keyof T, boolean>;
     /**
      * Validate a single field
      */
     validateField: (name: keyof T) => string | null;
     /**
-     * Fields that have been touched by the user
+     * Validate all fields
      */
-    touched: Record<keyof T, boolean>;
+    validateForm: () => ValidationResult;
+    /**
+     * Current form values
+     */
+    values: T;
 }
 /**
  * Generic form hook that provides comprehensive form state management and validation.

package/dist/hooks/useTranslation.d.ts

@@ -18,9 +18,9 @@
 import { I18nPreferences } from '@asgardeo/browser';
 export interface UseTranslation {
     /**
-     * Translation function that returns a translated string for the given key
+     * All available language codes
      */
-    t: (key: string, params?: Record<string, string | number>) => string;
+    availableLanguages: string[];
     /**
      * The current language code
      */
@@ -30,9 +30,9 @@ export interface UseTranslation {
      */
     setLanguage: (language: string) => void;
     /**
-     * All available language codes
+     * Translation function that returns a translated string for the given key
      */
-    availableLanguages: string[];
+    t: (key: string, params?: Record<string, string | number>) => string;
 }
 export interface UseTranslationWithPreferences extends UseTranslation {
     /**

package/dist/hooks/v2/useOAuthCallback.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) 2026, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { type RefObject } from 'react';
+export interface UseOAuthCallbackOptions {
+    /**
+     * Current flowId from component state
+     */
+    currentFlowId: string | null;
+    /**
+     * SessionStorage key for flowId (defaults to 'asgardeo_flow_id')
+     */
+    flowIdStorageKey?: string;
+    /**
+     * Whether the component is initialized and ready to process OAuth callback
+     */
+    isInitialized: boolean;
+    /**
+     * Whether a submission is currently in progress
+     */
+    isSubmitting?: boolean;
+    /**
+     * Callback when OAuth flow completes successfully
+     */
+    onComplete?: () => void;
+    /**
+     * Callback when OAuth flow encounters an error
+     */
+    onError?: (error: any) => void;
+    /**
+     * Function to handle flow response after submission
+     */
+    onFlowChange?: (response: any) => void;
+    /**
+     * Callback to set loading state at the start of OAuth processing
+     */
+    onProcessingStart?: () => void;
+    /**
+     * Function to submit OAuth code to the server
+     */
+    onSubmit: (payload: OAuthCallbackPayload) => Promise<any>;
+    /**
+     * Optional external ref to track processed state. If provided, the component
+     * manages the ref (allowing resets on flow clear/retry). Otherwise hook manages internally.
+     */
+    processedRef?: RefObject<boolean>;
+    /**
+     * Additional handler for setting state (e.g., setFlowId)
+     */
+    setFlowId?: (flowId: string) => void;
+    /**
+     * Ref to mark that token validation was attempted (prevents duplicate validation)
+     * Used in AcceptInvite to coordinate between OAuth callback and token validation
+     */
+    tokenValidationAttemptedRef?: RefObject<boolean>;
+}
+export interface OAuthCallbackPayload {
+    flowId: string;
+    inputs: {
+        code: string;
+        nonce?: string;
+    };
+}
+/**
+ * Processes OAuth callbacks by detecting auth code in URL, resolving flowId, and submitting to server.
+ * Used by SignIn, SignUp, and AcceptInvite components.
+ */
+export declare function useOAuthCallback({ currentFlowId, flowIdStorageKey, isInitialized, isSubmitting, onComplete, onError, onFlowChange, onProcessingStart, onSubmit, processedRef, setFlowId, tokenValidationAttemptedRef, }: UseOAuthCallbackOptions): void;

package/dist/index.d.ts

@@ -20,51 +20,42 @@ export * from './contexts/Asgardeo/AsgardeoProvider';
 export { default as AsgardeoContext } from './contexts/Asgardeo/AsgardeoContext';
 export * from './contexts/Asgardeo/AsgardeoContext';
 export { default as useAsgardeo } from './contexts/Asgardeo/useAsgardeo';
-export * from './contexts/Asgardeo/useAsgardeo';
 export { default as UserContext } from './contexts/User/UserContext';
 export * from './contexts/User/UserContext';
 export { default as UserProvider } from './contexts/User/UserProvider';
 export * from './contexts/User/UserProvider';
 export { default as useUser } from './contexts/User/useUser';
-export * from './contexts/User/useUser';
 export { default as OrganizationContext } from './contexts/Organization/OrganizationContext';
 export * from './contexts/Organization/OrganizationContext';
 export { default as OrganizationProvider } from './contexts/Organization/OrganizationProvider';
 export * from './contexts/Organization/OrganizationProvider';
 export { default as useOrganization } from './contexts/Organization/useOrganization';
-export * from './contexts/Organization/useOrganization';
 export { default as FlowContext } from './contexts/Flow/FlowContext';
-export * from './contexts/Flow/FlowContext';
+export type { FlowStep, FlowMessage, FlowContextValue } from './contexts/Flow/FlowContext';
 export { default as FlowProvider } from './contexts/Flow/FlowProvider';
-export * from './contexts/Flow/FlowProvider';
+export type { FlowProviderProps } from './contexts/Flow/FlowProvider';
 export { default as useFlow } from './contexts/Flow/useFlow';
-export * from './contexts/Flow/useFlow';
 export { default as I18nContext } from './contexts/I18n/I18nContext';
 export * from './contexts/I18n/I18nContext';
 export { default as I18nProvider } from './contexts/I18n/I18nProvider';
 export * from './contexts/I18n/I18nProvider';
 export { default as useI18n } from './contexts/I18n/useI18n';
-export * from './contexts/I18n/useI18n';
 export { default as ThemeContext } from './contexts/Theme/ThemeContext';
 export * from './contexts/Theme/ThemeContext';
 export { default as ThemeProvider } from './contexts/Theme/ThemeProvider';
 export * from './contexts/Theme/ThemeProvider';
 export { default as useTheme } from './contexts/Theme/useTheme';
-export * from './contexts/Theme/useTheme';
 export { default as BrandingContext } from './contexts/Branding/BrandingContext';
 export * from './contexts/Branding/BrandingContext';
 export { default as BrandingProvider } from './contexts/Branding/BrandingProvider';
 export * from './contexts/Branding/BrandingProvider';
 export { default as useBrandingContext } from './contexts/Branding/useBrandingContext';
-export * from './contexts/Branding/useBrandingContext';
 export { default as useBrowserUrl } from './hooks/useBrowserUrl';
 export * from './hooks/useBrowserUrl';
 export { default as useTranslation } from './hooks/useTranslation';
 export * from './hooks/useTranslation';
 export { default as useForm } from './hooks/useForm';
-export * from './hooks/useForm';
 export { default as useBranding } from './hooks/useBranding';
-export * from './hooks/useBranding';
 export { default as BaseSignInButton } from './components/actions/SignInButton/BaseSignInButton';
 export * from './components/actions/SignInButton/BaseSignInButton';
 export { default as SignInButton } from './components/actions/SignInButton/SignInButton';
@@ -91,10 +82,9 @@ export { default as BaseSignUp } from './components/presentation/auth/SignUp/Bas
 export * from './components/presentation/auth/SignUp/BaseSignUp';
 export { default as SignUp } from './components/presentation/auth/SignUp/SignUp';
 export * from './components/presentation/auth/SignUp/SignUp';
-export { BaseInviteUser, InviteUser } from './components/presentation/auth/InviteUser';
 export * from './components/presentation/auth/InviteUser';
 export { BaseAcceptInvite, AcceptInvite } from './components/presentation/auth/AcceptInvite';
-export * from './components/presentation/auth/AcceptInvite';
+export * from './components/auth/Callback/Callback';
 export { default as IdentifierFirst } from './components/presentation/auth/SignIn/v1/options/IdentifierFirst';
 export { default as UsernamePassword } from './components/presentation/auth/SignIn/v1/options/UsernamePassword';
 export { default as GoogleButton } from './components/adapters/GoogleButton';
@@ -116,37 +106,31 @@ export * from './components/presentation/User/User';
 export { default as BaseOrganization } from './components/presentation/Organization/BaseOrganization';
 export * from './components/presentation/Organization/BaseOrganization';
 export { default as Organization } from './components/presentation/Organization/Organization';
-export * from './components/presentation/Organization/Organization';
 export { default as BaseUserProfile } from './components/presentation/UserProfile/BaseUserProfile';
 export * from './components/presentation/UserProfile/BaseUserProfile';
 export { default as UserProfile } from './components/presentation/UserProfile/UserProfile';
 export * from './components/presentation/UserProfile/UserProfile';
 export { default as BaseUserDropdown } from './components/presentation/UserDropdown/BaseUserDropdown';
-export * from './components/presentation/UserDropdown/BaseUserDropdown';
+export type { BaseUserDropdownProps } from './components/presentation/UserDropdown/BaseUserDropdown';
 export { default as UserDropdown } from './components/presentation/UserDropdown/UserDropdown';
 export * from './components/presentation/UserDropdown/UserDropdown';
 export { default as BaseOrganizationSwitcher } from './components/presentation/OrganizationSwitcher/BaseOrganizationSwitcher';
-export * from './components/presentation/OrganizationSwitcher/BaseOrganizationSwitcher';
+export type { BaseOrganizationSwitcherProps } from './components/presentation/OrganizationSwitcher/BaseOrganizationSwitcher';
 export { default as OrganizationSwitcher } from './components/presentation/OrganizationSwitcher/OrganizationSwitcher';
-export * from './components/presentation/OrganizationSwitcher/OrganizationSwitcher';
 export { default as BaseOrganizationList } from './components/presentation/OrganizationList/BaseOrganizationList';
-export * from './components/presentation/OrganizationList/BaseOrganizationList';
+export type { BaseOrganizationListProps, OrganizationWithSwitchAccess, } from './components/presentation/OrganizationList/BaseOrganizationList';
 export { default as OrganizationList } from './components/presentation/OrganizationList/OrganizationList';
-export * from './components/presentation/OrganizationList/OrganizationList';
 export { default as BaseOrganizationProfile } from './components/presentation/OrganizationProfile/BaseOrganizationProfile';
 export * from './components/presentation/OrganizationProfile/BaseOrganizationProfile';
 export { default as OrganizationProfile } from './components/presentation/OrganizationProfile/OrganizationProfile';
 export * from './components/presentation/OrganizationProfile/OrganizationProfile';
 export { BaseCreateOrganization } from './components/presentation/CreateOrganization/BaseCreateOrganization';
-export * from './components/presentation/CreateOrganization/BaseCreateOrganization';
+export type { BaseCreateOrganizationProps, OrganizationFormData, } from './components/presentation/CreateOrganization/BaseCreateOrganization';
 export { CreateOrganization } from './components/presentation/CreateOrganization/CreateOrganization';
-export * from './components/presentation/CreateOrganization/CreateOrganization';
 export { default as Button } from './components/primitives/Button/Button';
 export * from './components/primitives/Button/Button';
 export { default as Card } from './components/primitives/Card/Card';
-export * from './components/primitives/Card/Card';
 export { default as Alert } from './components/primitives/Alert/Alert';
-export * from './components/primitives/Alert/Alert';
 export { default as OtpField } from './components/primitives/OtpField/OtpField';
 export * from './components/primitives/OtpField/OtpField';
 export { default as TextField } from './components/primitives/TextField/TextField';
@@ -184,10 +168,7 @@ export { default as Info } from './components/primitives/Icons/Info';
 export { default as UserIcon } from './components/primitives/Icons/User';
 export { default as LogOut } from './components/primitives/Icons/LogOut';
 export { createField, FieldFactory, validateFieldValue } from './components/factories/FieldFactory';
-export * from './components/factories/FieldFactory';
 export { default as BuildingAlt } from './components/primitives/Icons/BuildingAlt';
-export type { FlowStep, FlowMessage, FlowContextValue } from './contexts/Flow/FlowContext';
-export type { FlowProviderProps } from './contexts/Flow/FlowProvider';
 export { default as getAllOrganizations, GetAllOrganizationsConfig } from './api/getAllOrganizations';
 export { default as createOrganization, CreateOrganizationConfig } from './api/createOrganization';
 export { default as getMeOrganizations, GetMeOrganizationsConfig } from './api/getMeOrganizations';