@nibssplc/cams-sdk-react 1.0.0-rc.13 → 1.0.0-rc.130

package/README.md

@@ -13,6 +13,28 @@ For MSAL mode, also install:
 npm install @azure/msal-browser @azure/msal-react
 ```
 
+### Importing Styles
+
+The SDK includes bundled Tailwind CSS. Import it in your app entry point:
+
+```tsx
+import '@nibssplc/cams-sdk-react/dist/styles.css';
+```
+
+For Next.js, add to `app/layout.tsx` or `pages/_app.tsx`:
+```tsx
+import '@nibssplc/cams-sdk-react/dist/styles.css';
+```
+
+**Important:** For complete Tailwind CSS support, add this script to your `index.html`:
+
+```html
+<script
+  async
+  src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"
+></script>
+```
+
 ## Features
 
 - ⚛️ React hooks for authentication
@@ -273,13 +295,23 @@ export default function RootLayout({ children }) {
 
 ## Styling
 
-Components use Tailwind CSS. Ensure Tailwind is configured in your project:
+The SDK bundles all required Tailwind CSS, so you don't need to configure Tailwind in your project. Simply import the styles:
 
-```bash
-npm install -D tailwindcss
-npx tailwindcss init
+```tsx
+import '@nibssplc/cams-sdk-react/dist/styles.css';
 ```
 
+**For complete Tailwind CSS functionality**, add the Tailwind browser script to your HTML:
+
+```html
+<script
+  async
+  src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"
+></script>
+```
+
+If your project already uses Tailwind, the SDK styles will work alongside your existing configuration.
+
 ## Examples
 
 See the [examples](../../examples) directory for complete implementations:

package/dist/components/ADLoginModal.d.ts

@@ -1,3 +1,4 @@
+import { type Credentials } from "@nibssplc/cams-sdk";
 interface ADLoginModalProps {
     open: boolean;
     isLoading: boolean;

package/dist/components/CoreFIDO.d.ts

@@ -1,12 +1,4 @@
-export interface AttestationResult {
-    id: string;
-    rawId: string;
-    type: string;
-    response: {
-        clientDataJSON: string;
-        attestationObject: string;
-    };
-}
+import { AttestationResult } from "@nibssplc/cams-sdk";
 /**
  * Initiates the WebAuthn registration process.
  * It takes server-provided options, converts them for the browser API,

package/dist/components/DefaultLoginPage.d.ts

@@ -1,11 +1,7 @@
-import "../utils/crypto-polyfill";
-import { MFAEndpoints } from "./MFAGate";
-interface LoginPageProps {
-    usePassKey?: boolean;
+export interface LoginPageProps {
     CredentialsAuthEndpoint?: string;
     useADLogin?: boolean;
-    MFAEndpoints: MFAEndpoints;
-    PassKeysRegisterProps?: Record<string, unknown>;
+    onADLoginSuccess?: () => void;
 }
-declare const DefaultLoginPage: ({ usePassKey, useADLogin, MFAEndpoints, CredentialsAuthEndpoint, PassKeysRegisterProps, }: LoginPageProps) => import("react/jsx-runtime").JSX.Element;
+declare const DefaultLoginPage: ({ useADLogin, CredentialsAuthEndpoint, onADLoginSuccess, }: LoginPageProps) => import("react/jsx-runtime").JSX.Element;
 export default DefaultLoginPage;

package/dist/components/GenericOTP.d.ts

@@ -8,6 +8,7 @@ interface GenericOTPProps {
     attemptCount?: number;
     remainingAttempts?: number;
     isMaxAttemptsReached?: boolean;
+    maxOTPDigits?: number;
 }
-export declare const GenericOTPVerifier: ({ value, setValue, setLoading, onChangeOTP, fieldName, attemptCount, remainingAttempts, isMaxAttemptsReached, }: GenericOTPProps) => import("react/jsx-runtime").JSX.Element;
+export declare const GenericOTPVerifier: ({ value, setValue, setLoading, onChangeOTP, fieldName, attemptCount, remainingAttempts, isMaxAttemptsReached, maxOTPDigits, }: GenericOTPProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/Loading.d.ts

@@ -1,6 +1,4 @@
-import "ldrs/waveform";
-import "ldrs/react/Waveform.css";
-declare const LoadingSpinner: ({ loadingText }: {
+declare const LoadingScreen: ({ loadingText }: {
     loadingText?: string;
 }) => import("react/jsx-runtime").JSX.Element;
-export default LoadingSpinner;
+export default LoadingScreen;

package/dist/components/MFAGate.d.ts

@@ -1,8 +1,6 @@
 import z from "zod";
 declare const MFAEndpointsSchema: z.ZodObject<{
-    ValidateMFA: z.ZodURL;
-    RegisterNewChallenge: z.ZodURL;
-    RegisterVerify: z.ZodURL;
+    ValidateUserMFA: z.ZodURL;
     RetrieveAuthChallenge: z.ZodURL;
     AuthChallengeVerify: z.ZodURL;
 }, z.core.$strip>;
@@ -13,8 +11,13 @@ interface MFAGateProps {
     usePassKey?: boolean;
     useADLogin?: boolean;
     CredentialsAuthEndpoint?: string;
-    PassKeysRegisterProps?: Record<string, unknown>;
     MFAEndpoints?: MFAEndpoints;
+    requiresMFA?: boolean;
+    onAuthSuccess?: (tokens: {
+        accessToken: string;
+        idToken: string;
+    }) => void;
+    onAuthError?: (error: any) => void;
 }
-declare const MFAGate: ({ children, fallback, usePassKey, useADLogin, CredentialsAuthEndpoint, PassKeysRegisterProps, MFAEndpoints, }: MFAGateProps) => string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null;
+declare const MFAGate: ({ children, fallback, usePassKey, useADLogin, CredentialsAuthEndpoint, MFAEndpoints, requiresMFA, onAuthSuccess, onAuthError, }: MFAGateProps) => string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null;
 export default MFAGate;

package/dist/components/MFAOptions.d.ts

@@ -1,9 +1,9 @@
 import { MFAEndpoints } from "./MFAGate";
 interface MFAOptionsProps {
-    onComplete?: (success: boolean) => void;
+    onComplete: (success: boolean) => void;
     onAuthFailed?: () => void;
     MFAEndpoints: MFAEndpoints;
-    usePassKey?: boolean;
+    usePassKeys?: boolean;
 }
-declare const MFAOptions: ({ onComplete, onAuthFailed, MFAEndpoints, usePassKey, }: MFAOptionsProps) => import("react/jsx-runtime").JSX.Element;
+declare const MFAOptions: ({ onComplete, onAuthFailed, MFAEndpoints, usePassKeys, }: MFAOptionsProps) => import("react/jsx-runtime").JSX.Element;
 export default MFAOptions;

package/dist/context/CAMSContext.d.ts

@@ -3,15 +3,21 @@ import { UseCAMSAuthReturn } from "../hooks/useCAMSAuth";
 import { UseCAMSMSALAuthReturn } from "../hooks/useCAMSMSALAuth";
 type AuthMode = "REGULAR" | "MSAL";
 interface BaseCAMSContextValue {
-    userProfile: Profile | null;
-    setUserProfile: (profile: Profile | null) => void;
+    user: Profile | null;
+    setUserProfile: (user: Profile | null) => void;
     authMode: AuthMode;
 }
 interface RegularCAMSContextValue extends BaseCAMSContextValue, UseCAMSAuthReturn {
     authMode: "REGULAR";
 }
 interface MSALCAMSContextValue extends BaseCAMSContextValue, UseCAMSMSALAuthReturn {
+    email: string;
     authMode: "MSAL";
+    onAuthSuccess?: (tokens: {
+        accessToken: string;
+        idToken: string;
+    }) => void;
+    onAuthError?: (error: any) => void;
 }
 export type CAMSContextValue = RegularCAMSContextValue | MSALCAMSContextValue;
 export declare const CAMSContext: import("react").Context<CAMSContextValue | null>;

package/dist/{components → context}/CAMSMSALProvider.d.ts

@@ -1,4 +1,3 @@
-import "../utils/crypto-polyfill";
 import React from "react";
 import { PublicClientApplication, Configuration } from "@azure/msal-browser";
 import { Profile } from "@nibssplc/cams-sdk";

package/dist/{components → context}/UnifiedCAMSProvider.d.ts

@@ -1,8 +1,6 @@
-import "../utils/crypto-polyfill";
 import React from "react";
 import { PublicClientApplication, Configuration } from "@azure/msal-browser";
 import { UseCAMSAuthOptions } from "../hooks/useCAMSAuth";
-import { UseCAMSMSALAuthOptions } from "../hooks/useCAMSMSALAuth";
 import { useCAMSContext } from "../context/CAMSContext";
 interface BaseProviderProps {
     children: React.ReactNode;
@@ -11,10 +9,16 @@ interface BaseProviderProps {
 interface RegularProviderProps extends BaseProviderProps, Omit<UseCAMSAuthOptions, "appCode"> {
     mode: "REGULAR";
 }
-interface MSALProviderProps extends BaseProviderProps, Omit<UseCAMSMSALAuthOptions, "MFAEndpoint"> {
+interface MSALProviderProps extends BaseProviderProps {
     mode: "MSAL";
+    ValidateUserEndpoint: string;
     msalConfig: Configuration;
     msalInstance?: PublicClientApplication;
+    onAuthSuccess?: (tokens: {
+        accessToken: string;
+        idToken: string;
+    }) => void;
+    onAuthError?: (error: any) => void;
 }
 type UnifiedCAMSProviderProps = RegularProviderProps | MSALProviderProps;
 export declare function UnifiedCAMSProvider(props: UnifiedCAMSProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/hooks/useCAMSMSALAuth.d.ts

@@ -1,8 +1,6 @@
 import "../utils/crypto-polyfill";
-import { CAMSError, CAMSMFAAuthenticator, MFAResponse } from "@nibssplc/cams-sdk";
+import { CAMSError, type MFAAuthenticatedResponse, type Credentials } from "@nibssplc/cams-sdk";
 export interface UseCAMSMSALAuthOptions {
-    onAuthSuccess?: (token: string) => void;
-    onAuthError?: (error: CAMSError) => void;
     onTokenExpired?: () => void;
     scopes?: string[];
     storageKey?: string;
@@ -10,7 +8,9 @@ export interface UseCAMSMSALAuthOptions {
     messageOrigin?: string;
     appCode: string;
     allowedOrigins?: string[];
-    MFAEndpoint?: string;
+    ValidateUserEndpoint: string;
+    activeCookiePeriod?: number;
+    DisableCAMSUserProfileValidation?: boolean;
 }
 export interface UseCAMSMSALAuthReturn {
     login: () => Promise<void>;
@@ -22,10 +22,11 @@ export interface UseCAMSMSALAuthReturn {
     idToken: string;
     accessToken: string;
     appCode: string;
-    mfaAuthenticator: CAMSMFAAuthenticator | null;
+    email: string;
     requiresMFA: boolean;
-    completeMFA: (data: UserValidatedResponse) => Promise<MFAResponse>;
+    completeMFA: (data: MFAAuthenticatedResponse) => Promise<MFAAuthenticatedResponse>;
     setRequiresMFA: React.Dispatch<React.SetStateAction<boolean>>;
-    sendEmailOTP: () => Promise<boolean>;
+    LoginADCredentials: (credentials: Credentials, appCode: string, endpoint: string) => Promise<MFAAuthenticatedResponse>;
+    activeCookiePeriod: number;
 }
 export declare function useCAMSMSALAuth(options: UseCAMSMSALAuthOptions): UseCAMSMSALAuthReturn;

package/dist/hooks/useFIDOAuth.d.ts

@@ -3,7 +3,7 @@ import { register, authenticate } from '../components/CoreFIDO';
  * A React hook that provides access to the WebAuthn `register` and `authenticate` functions.
  * @returns An object containing the `register` and `authenticate` functions.
  */
-export declare const useWebAuthn: () => {
+export declare const useWebAuthN: () => {
     register: typeof register;
     authenticate: typeof authenticate;
 };

package/dist/hooks/useOTPHandler.d.ts

@@ -1,11 +1,10 @@
-export declare const useOTPHandler: ({ provider, accessToken, idToken, appCode, authenticationType, MFAEndpoint, onAuthComplete, }: {
-    provider: string;
-    accessToken: string;
-    idToken: string;
+import { type Credentials, MFAAuthenticatedResponse } from "@nibssplc/cams-sdk";
+export declare const useOTPHandler: ({ email, appCode, instCode, MFAEndpoint, onAuthComplete, }: {
+    email: string;
     appCode: string;
-    authenticationType: "AuthenticatorCode" | "EmailOTP" | null;
+    instCode?: string;
     MFAEndpoint?: string;
-    onAuthComplete: (state: boolean, data: UserValidatedResponse | null) => void;
+    onAuthComplete: (state: boolean, data: MFAAuthenticatedResponse | null) => Promise<void>;
 }) => {
     handleSubmitOTP: (authenticationValue: string) => Promise<boolean>;
     loading: boolean;
@@ -15,8 +14,8 @@ export declare const useOTPHandler: ({ provider, accessToken, idToken, appCode,
     resetAttempts: () => void;
     remainingAttempts: number;
 };
-export declare const useCredentialsHandler: (onAuthComplete: (state: boolean, data: UserValidatedResponse | null) => void) => {
-    handleSubmitCredentials: (CredAuthEndpoint: string, credentials: Credentials, appCode: string) => Promise<boolean>;
+export declare const useCredentialsHandler: (onAuthComplete: (state: boolean, data: MFAAuthenticatedResponse | null) => void) => {
+    handleSubmitCredentials: (CredentialsAuthEndpoint: string, credentials: Credentials) => Promise<boolean>;
     loading: boolean;
     setLoading: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     attemptCount: number;