@nibssplc/cams-sdk-react 1.0.0-rc.8 → 1.0.0-rc.81

package/README.md

@@ -13,6 +13,19 @@ 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';
+```
+
 ## Features
 
 - ⚛️ React hooks for authentication
@@ -273,13 +286,14 @@ 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';
 ```
 
+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 { 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/MFAGate.d.ts

@@ -1,6 +1,6 @@
 import z from "zod";
 declare const MFAEndpointsSchema: z.ZodObject<{
-    ValidateMFA: z.ZodURL;
+    ValidateUserMFA: z.ZodURL;
     RegisterNewChallenge: z.ZodURL;
     RegisterVerify: z.ZodURL;
     RetrieveAuthChallenge: z.ZodURL;
@@ -15,6 +15,12 @@ interface MFAGateProps {
     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, PassKeysRegisterProps, 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/UnifiedCAMSProvider.d.ts

@@ -1,7 +1,6 @@
 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;
@@ -10,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/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/hooks/useCAMSMSALAuth.d.ts

@@ -1,7 +1,6 @@
-import { CAMSError, CAMSMFAAuthenticator, MFAResponse } from "@nibssplc/cams-sdk";
+import "../utils/crypto-polyfill";
+import { CAMSError, type MFAAuthenticatedResponse } from "@nibssplc/cams-sdk";
 export interface UseCAMSMSALAuthOptions {
-    onAuthSuccess?: (token: string) => void;
-    onAuthError?: (error: CAMSError) => void;
     onTokenExpired?: () => void;
     scopes?: string[];
     storageKey?: string;
@@ -9,7 +8,8 @@ export interface UseCAMSMSALAuthOptions {
     messageOrigin?: string;
     appCode: string;
     allowedOrigins?: string[];
-    MFAEndpoint?: string;
+    ValidateUserEndpoint: string;
+    activeCookiePeriod?: number;
 }
 export interface UseCAMSMSALAuthReturn {
     login: () => Promise<void>;
@@ -21,10 +21,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: () => Promise<MFAAuthenticatedResponse>;
+    activeCookiePeriod: number;
 }
 export declare function useCAMSMSALAuth(options: UseCAMSMSALAuthOptions): UseCAMSMSALAuthReturn;

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) => 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;