@asgardeo/react 0.11.3 → 0.12.0

package/dist/components/auth/Callback/Callback.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 { FC } from 'react';
+/**
+ * Props for Callback component
+ */
+export interface CallbackProps {
+    /**
+     * Callback function called when an error occurs
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Function to navigate to a different path.
+     * If not provided, falls back to the browser navigate utility (SPA navigation via History API for same-origin paths).
+     * Provide this prop to enable framework-specific navigation (e.g., from React Router).
+     */
+    onNavigate?: (path: string) => void;
+}
+/**
+ * BaseCallback is a headless component that handles OAuth callback parameter forwarding.
+ * This component extracts OAuth parameters (code, state, error) from the URL and forwards them
+ * to the original component that initiated the OAuth flow.
+ *
+ * Works standalone using the browser navigate utility (History API) for navigation by default.
+ * Pass an onNavigate prop to enable framework-specific navigation (e.g., via React Router).
+ *
+ * Flow: Extract OAuth parameters from URL -> Parse state parameter -> Redirect to original path with parameters
+ *
+ * The original component (SignIn/AcceptInvite) is responsible for:
+ * - Processing the OAuth code via the SDK
+ * - Calling /flow/execute
+ * - Handling the assertion and auth/callback POST
+ * - Managing the authenticated session
+ */
+export declare const Callback: FC<CallbackProps>;
+export default Callback;

package/dist/components/presentation/auth/AcceptInvite/v2/BaseAcceptInvite.d.ts

@@ -27,6 +27,7 @@ export interface AcceptInviteFlowResponse {
         meta?: {
             components?: any[];
         };
+        redirectURL?: string;
     };
     failureReason?: string;
     flowId: string;

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/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

@@ -82,8 +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/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';