@abaxx_tech/v-integration-react 1.1.1 → 1.1.2-dev.2

package/README.md

@@ -11,6 +11,7 @@
 - **Error Handling**: Comprehensive error handling and user feedback.
 - **Customizable Styling**: Full control over colors, sizes, and text with support for both Tailwind classes and hex colors.
 - **Background Authentication Service**: Automatic token management and authentication flow handling.
+- **State Reset**: Built-in functionality to reset authentication state back to initial values.
 <br/><br/>
 
 ## Installation
@@ -31,7 +32,6 @@ import { VerifierProvider } from "@abaxx_tech/v-integration-react";
 const App = () => {
   return (
     <VerifierProvider
-      appId={Number(import.meta.env.VITE_APP_ID)}
       apiUrl={import.meta.env.VITE_API_URL}
       clientId={import.meta.env.VITE_CLIENT_ID}
     >
@@ -130,6 +130,41 @@ const MyComponent = () => {
   return <div>Not authenticated</div>;
 };
 ```
+
+### 4. Reset Authentication State
+Use the `useVerifierReset` hook to reset the authentication state back to initial values:
+
+```ts
+import { useVerifierReset } from "@abaxx_tech/v-integration-react";
+
+const LogoutButton = () => {
+  const resetState = useVerifierReset();
+  
+  const handleLogout = () => {
+    resetState(); // Resets all authentication state to initial values
+  };
+  
+  return (
+    <button onClick={handleLogout}>
+      Logout & Reset
+    </button>
+  );
+};
+
+export default LogoutButton;
+```
+
+**What gets reset:**
+- `identity` → `""`
+- `authRequestId` → `""`
+- `isAuthenticating` → `false`
+- `codeVerifier` → `""`
+- `codeChallenge` → `""`
+- `authCode` → `""`
+- `authRequestIdExpires` → `new Date()`
+- `token` → `null`
+- `authError` → `null`
+
 <br/><br/>
 
 ## Components
@@ -140,7 +175,6 @@ The main provider component that wraps your application and manages the authenti
 #### Props:
 | Prop | Type | Description |
 | ------------- | ------------- | ------------- |
-| `appId` | `string \| number`  | Unique application ID |
 | `apiUrl` | `string`  | API URL for authentication |
 | `clientId` | `string`  | Client identifier |
 | `children` | `ReactNode`  | Child components to be wrapped |
@@ -239,6 +273,31 @@ The authentication context provides access to all authentication-related state a
 | `authCode` | `string` | Authorization code from successful auth |
 | `token` | `string \| null` | Authentication token |
 | `authError` | `string \| null` | Authentication error message |
+| `resetState` | `() => void` | Function to reset all state to initial values |
+
+### Reset Functionality
+The library provides a built-in reset function to clear all authentication state:
+
+```ts
+import { useContext } from 'react';
+import { VContext, useVerifierReset } from "@abaxx_tech/v-integration-react";
+
+const MyComponent = () => {
+  const { resetState: resetStateFromContext } = useContext(VContext);
+  const resetState = useVerifierReset();
+
+  return (
+    <>
+      <button onClick={resetStateFromContext}>
+        Reset Authentication from context
+      </button>
+      <button onClick={resetState}>
+        Reset Authentication
+      </button>
+    </>
+  );
+};
+```
 
 ## Authentication Flow
 

package/dist/v-integration-react.d.ts

@@ -2,16 +2,18 @@ import { default as default_2 } from 'react';
 import { ReactNode } from 'react';
 
 declare type Props = {
-    appId: string | number;
     clientId: string;
     apiUrl: string;
     children: ReactNode;
 };
 
+export declare function resetVerifierStateUnsafe(ctx: React.ContextType<typeof VContext>): void;
+
+export declare function useVerifierReset(): () => void;
+
 export declare const VContext: default_2.Context<VContextObj>;
 
 export declare type VContextObj = {
-    appId: string | number;
     apiUrl: string;
     clientId: string;
     authRequestId: string;
@@ -32,6 +34,7 @@ export declare type VContextObj = {
     setToken: default_2.Dispatch<default_2.SetStateAction<string | null>>;
     authError: string | null;
     setAuthError: default_2.Dispatch<default_2.SetStateAction<string | null>>;
+    resetState: () => void;
 };
 
 export declare const VContextProvider: default_2.FC<Props>;
@@ -78,7 +81,6 @@ export declare interface VerifierAuthQrProps {
 export declare const VerifierProvider: default_2.FC<VerifierProviderProps>;
 
 export declare interface VerifierProviderProps {
-    appId: string | number;
     clientId: string;
     apiUrl: string;
     children: ReactNode;