react-token-manager 1.0.0

package/LICENSE

@@ -0,0 +1,6 @@
+
+---
+
+If you want, I can **also create a super short “copy-paste example app” section** that shows this working in a Next.js or React component so users can just drop it in and see it run.  
+
+Do you want me to add that?

package/README.md

@@ -0,0 +1,132 @@
+# React Token Manager
+
+A simple React library to manage JWT tokens with support for `localStorage`, `sessionStorage`, and cookies. Features include storing tokens, decoding JWTs, checking expiration, and a convenient React hook.
+
+---
+
+## Installation
+
+```bash
+npm install react-token-manager
+```
+
+## Global Configuration
+
+Set storage type and token key once for your app:
+
+```bash
+import { configureTokenManager } from 'react-token-manager'
+
+configureTokenManager({
+  storage: 'localStorage', // 'localStorage' | 'sessionStorage' | 'cookie'
+  tokenKey: 'access_token', // default: 'access_token'
+})
+```
+## Using the Hook useTokenManager
+
+```bash
+import { useTokenManager } from 'react-token-manager'
+
+export default function Dashboard() {
+  const { token, setToken, removeToken, isExpired, decode } = useTokenManager()
+
+  const handleLogin = () => setToken('your.jwt.token.here')
+  const handleLogout = () => removeToken()
+
+  return (
+    <div>
+      <p>Token: {token}</p>
+      <p>Expired? {isExpired() ? 'Yes' : 'No'}</p>
+      <p>Decoded Payload: {JSON.stringify(decode())}</p>
+      <button onClick={handleLogin}>Login</button>
+      <button onClick={handleLogout}>Logout</button>
+    </div>
+  )
+}
+```
+
+You can override storage or tokenKey per hook if needed.
+
+## Using TokenManager Class Directly
+
+```bash
+import { TokenManager } from 'react-token-manager'
+
+const manager = new TokenManager({ storage: 'cookie', tokenKey: 'access_token' })
+
+manager.set('your.jwt.token')
+console.log(manager.get())
+console.log(manager.decode())  // decoded JWT payload
+console.log(manager.isExpired())
+manager.remove()
+```
+
+## API Reference
+
+configureTokenManager(options: TokenManagerOptions)
+
+Set global options.
+
+```bash
+{
+  storage?: 'localStorage' | 'sessionStorage' | 'cookie';
+  tokenKey?: string;
+}
+
+useTokenManager(options?: TokenManagerOptions)
+
+Returns:
+
+    token: string | null — current token
+
+    setToken(value: string) — set a new token
+
+    removeToken() — remove the token
+
+    isExpired(): boolean — check expiration
+
+    decode<T>(): T | null — decode JWT payload
+
+TokenManager Class Methods
+
+    set(token: string) — store token
+
+    get(): string | null — retrieve token
+
+    remove() — delete token
+
+    decode<T = unknown>(): T | null — decode JWT payload
+
+    isExpired(): boolean — check if token is expired
+
+    getValid(): string | null — get token only if valid
+
+```
+
+## Examples
+
+Multiple Tokens
+
+```bash
+const { token: accessToken, setToken: setAccess } = useTokenManager({ tokenKey: 'access_token' })
+const { token: refreshToken, setToken: setRefresh } = useTokenManager({ tokenKey: 'refresh_token' })
+
+setAccess('abc')
+setRefresh('xyz')
+```
+
+##Using Cookies
+```bash
+configureTokenManager({ storage: 'cookie', tokenKey: 'access_token' })
+```
+
+Checking Expiry Before API Call
+
+```bash
+const manager = useTokenManager()
+
+if (!manager.isExpired()) {
+  callApi(manager.token)
+}
+```
+

package/dist/index.d.mts

@@ -0,0 +1,28 @@
+type StorageType = 'localStorage' | 'sessionStorage' | 'cookie';
+interface TokenManagerOptions {
+    storage?: StorageType;
+    tokenKey?: string;
+}
+declare const configureTokenManager: (options: TokenManagerOptions) => void;
+declare class TokenManager {
+    private storage;
+    private tokenKey;
+    constructor(options?: TokenManagerOptions);
+    set(token: string): void;
+    get(): string | null;
+    remove(): void;
+    decode<T = unknown>(): T | null;
+    isExpired(): boolean;
+    getValid(): string | null;
+}
+
+interface UseTokenManagerReturn {
+    token: string | null;
+    setToken: (value: string) => void;
+    removeToken: () => void;
+    isExpired: () => boolean;
+    decode: <T = unknown>() => T | null;
+}
+declare const useTokenManager: (options?: TokenManagerOptions) => UseTokenManagerReturn;
+
+export { type StorageType, TokenManager, type TokenManagerOptions, type UseTokenManagerReturn, configureTokenManager, useTokenManager };

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+type StorageType = 'localStorage' | 'sessionStorage' | 'cookie';
+interface TokenManagerOptions {
+    storage?: StorageType;
+    tokenKey?: string;
+}
+declare const configureTokenManager: (options: TokenManagerOptions) => void;
+declare class TokenManager {
+    private storage;
+    private tokenKey;
+    constructor(options?: TokenManagerOptions);
+    set(token: string): void;
+    get(): string | null;
+    remove(): void;
+    decode<T = unknown>(): T | null;
+    isExpired(): boolean;
+    getValid(): string | null;
+}
+
+interface UseTokenManagerReturn {
+    token: string | null;
+    setToken: (value: string) => void;
+    removeToken: () => void;
+    isExpired: () => boolean;
+    decode: <T = unknown>() => T | null;
+}
+declare const useTokenManager: (options?: TokenManagerOptions) => UseTokenManagerReturn;
+
+export { type StorageType, TokenManager, type TokenManagerOptions, type UseTokenManagerReturn, configureTokenManager, useTokenManager };