@ahoo-wang/fetcher-react 3.5.6 → 3.6.0

package/dist/core/debounced/index.d.ts

@@ -0,0 +1,4 @@
+export * from './useDebouncedCallback';
+export * from './useDebouncedExecutePromise';
+export * from './useDebouncedQuery';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/debounced/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/debounced/index.ts"],"names":[],"mappings":"AAaA,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC"}

package/dist/core/debounced/useDebouncedCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedCallback.d.ts","sourceRoot":"","sources":["../../../src/core/debounced/useDebouncedCallback.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAC;IACd,wGAAwG;IACxG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;IAC3E,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC/C,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACpE,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,2BAA2B,GACnC,0BAA0B,CAAC,CAAC,CAAC,CAuF/B"}

package/dist/core/{useDebouncedExecutePromise.d.ts → debounced/useDebouncedExecutePromise.d.ts}

@@ -1,4 +1,4 @@
-import { UseExecutePromiseOptions, UseExecutePromiseReturn } from './useExecutePromise';
+import { UseExecutePromiseOptions, UseExecutePromiseReturn } from '../useExecutePromise';
 import { UseDebouncedCallbackOptions, UseDebouncedCallbackReturn } from './useDebouncedCallback';
 import { FetcherError } from '@ahoo-wang/fetcher';
 /**

package/dist/core/debounced/useDebouncedExecutePromise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedExecutePromise.d.ts","sourceRoot":"","sources":["../../../src/core/debounced/useDebouncedExecutePromise.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,EAAE,2BAA2B,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iCAAiC,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAC/D,SAAQ,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,EACpC,eAAe;CAAG;AAEtB;;;;;;;GAOG;AACH,MAAM,WAAW,gCAAgC,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAC9D,SAAQ,IAAI,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,EACpD,0BAA0B,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;CAAG;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,YAAY,EACtE,OAAO,EAAE,iCAAiC,CAAC,CAAC,EAAE,CAAC,CAAC,GAC/C,gCAAgC,CAAC,CAAC,EAAE,CAAC,CAAC,CAsBxC"}

package/dist/{wow/debounce → core/debounced}/useDebouncedQuery.d.ts

@@ -1,6 +1,5 @@
 import { FetcherError } from '@ahoo-wang/fetcher';
-import { UseQueryOptions, UseQueryReturn } from '../useQuery';
-import { DebounceCapable, UseDebouncedCallbackReturn } from '../../core';
+import { UseQueryOptions, UseQueryReturn, DebounceCapable, UseDebouncedCallbackReturn } from '../index';
 /**
  * Configuration options for the useDebouncedQuery hook
  * @template Q - The type of the query parameters

package/dist/core/debounced/useDebouncedQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedQuery.d.ts","sourceRoot":"","sources":["../../../src/core/debounced/useDebouncedQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAY,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EACL,eAAe,EAEf,0BAA0B,EAC3B,MAAM,UAAU,CAAC;AAGlB;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAC9D,SAAQ,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe;CAClD;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAC7D,SAAQ,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,EAC9C,0BAA0B,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,EACtD,OAAO,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACzC,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CA4DlC"}

package/dist/core/index.d.ts

@@ -1,10 +1,11 @@
+export * from './debounced';
 export * from './useExecutePromise';
 export * from './usePromiseState';
 export * from './useRequestId';
 export * from './useLatest';
 export * from './useMounted';
 export * from './useRefs';
-export * from './useDebouncedCallback';
-export * from './useDebouncedExecutePromise';
 export * from './useForceUpdate';
+export * from './useQuery';
+export * from './useQueryState';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAaA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAaA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/{wow → core}/useQuery.d.ts

@@ -1,7 +1,7 @@
-import { UseExecutePromiseReturn, UseExecutePromiseOptions } from '../core';
+import { UseExecutePromiseReturn, UseExecutePromiseOptions } from './index';
 import { AttributesCapable, FetcherError } from '@ahoo-wang/fetcher';
-import { AutoExecuteCapable } from './types';
 import { UseQueryStateReturn } from './useQueryState';
+import { AutoExecuteCapable } from '../types';
 /**
  * Configuration options for the useQuery hook
  * @template Q - The type of the query parameters

package/dist/core/useQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQuery.d.ts","sourceRoot":"","sources":["../../src/core/useQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,uBAAuB,EACvB,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAiB,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CACrD,SAAQ,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,EACpC,iBAAiB,EACjB,kBAAkB;IACpB,mCAAmC;IACnC,YAAY,EAAE,CAAC,CAAC;IAEhB,kFAAkF;IAClF,OAAO,EAAE,CACP,KAAK,EAAE,CAAC,EACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,eAAe,CAAC,EAAE,eAAe,KAC9B,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAC7B,CAAC,EACD,CAAC,EACD,CAAC,GAAG,YAAY,CAChB,SAAQ,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC7D,4DAA4D;IAC5D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,EAC7C,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAChC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CA8DzB"}

package/dist/{wow → core}/useQueryState.d.ts

@@ -1,4 +1,4 @@
-import { AutoExecuteCapable } from './types';
+import { AutoExecuteCapable } from '../types';
 /**
  * Configuration options for the useQueryState hook
  * @template Q - The type of the query parameters

package/dist/core/useQueryState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQueryState.d.ts","sourceRoot":"","sources":["../../src/core/useQueryState.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,CAAE,SAAQ,kBAAkB;IACjE,4DAA4D;IAC5D,YAAY,EAAE,CAAC,CAAC;IAChB,6FAA6F;IAC7F,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClB,yFAAyF;IACzF,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,mBAAmB,CAAC,CAAC,CAAC,CA0BxB"}

package/dist/cosec/RouteGuard.d.ts

@@ -0,0 +1,49 @@
+import { ReactNode } from 'react';
+/**
+ * Props for the RouteGuard component.
+ */
+export interface RouteGuardProps {
+    /**
+     * The content to render when the user is authenticated.
+     */
+    children: ReactNode;
+    /**
+     * The fallback content to render when the user is not authenticated.
+     * If not provided, nothing will be rendered.
+     */
+    fallback?: ReactNode;
+    /**
+     * Optional redirect function to call when user is not authenticated.
+     * This can be used to programmatically navigate to a login page.
+     */
+    onUnauthorized?: () => void;
+}
+/**
+ * Route guard component that conditionally renders content based on authentication status.
+ *
+ * This component uses the SecurityContext to check if the user is authenticated.
+ * If authenticated, it renders the children. If not authenticated, it renders the fallback
+ * content (if provided) and optionally calls the onUnauthorized callback.
+ *
+ * @param children - The protected content to render when authenticated.
+ * @param fallback - Optional fallback content to render when not authenticated.
+ * @param onUnauthorized - Optional callback to execute when user is not authenticated.
+ * @returns The children if authenticated, fallback if provided, or null otherwise.
+ * @example
+ * ```tsx
+ * import { RouteGuard } from '@ahoo-wang/fetcher-react';
+ *
+ * function ProtectedPage() {
+ *   return (
+ *     <RouteGuard
+ *       fallback={<div>Please log in to access this page.</div>}
+ *       onUnauthorized={() => navigate('/login')}
+ *     >
+ *       <div>Protected content</div>
+ *     </RouteGuard>
+ *   );
+ * }
+ * ```
+ */
+export declare function RouteGuard({ children, fallback, onUnauthorized, }: RouteGuardProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+//# sourceMappingURL=RouteGuard.d.ts.map

package/dist/cosec/RouteGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteGuard.d.ts","sourceRoot":"","sources":["../../src/cosec/RouteGuard.tsx"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,QAAQ,EACR,cAAc,GACf,EAAE,eAAe,2UAcjB"}

package/dist/cosec/SecurityContext.d.ts

@@ -1,55 +1,88 @@
-import { UseSecurityReturn } from './useSecurity';
+import { UseSecurityOptions, UseSecurityReturn } from './useSecurity';
 import { ReactNode } from 'react';
 import { TokenStorage } from '@ahoo-wang/fetcher-cosec';
 /**
- * Type alias for the security context value, which is the same as the return type of useSecurity hook.
- * Provides access to current user information, authentication status, and authentication methods.
+ * Type alias for the security context value, representing the authentication state and methods.
+ * This is equivalent to the return type of the useSecurity hook, providing reactive access to:
+ * - Current authenticated user information (JWT payload)
+ * - Authentication status (boolean flag)
+ * - Sign-in method for authenticating users
+ * - Sign-out method for clearing authentication
+ *
+ * Used internally by the SecurityContext to type the context value.
  */
 export type SecurityContext = UseSecurityReturn;
 /**
  * React context for managing authentication state across the component tree.
- * This context provides a way to share authentication state and methods between components
- * without prop drilling. It should be used with SecurityProvider to wrap the application.
+ * This context enables sharing of authentication state and methods between components
+ * without prop drilling. Components can access authentication data and methods through
+ * the useSecurityContext hook when wrapped by the SecurityProvider.
+ *
+ * The context value is undefined by default, requiring components to be wrapped by
+ * SecurityProvider to access authentication functionality.
  */
 export declare const SecurityContext: import('react').Context<UseSecurityReturn | undefined>;
 /**
- * Props for the SecurityProvider component.
+ * Configuration options for the SecurityProvider component.
+ * Extends UseSecurityOptions to include provider-specific settings like token storage and children.
  */
-export interface SecurityContextOptions {
+export interface SecurityContextOptions extends UseSecurityOptions {
     /**
      * The token storage instance used to manage authentication tokens.
-     * This should be a valid TokenStorage implementation that handles token persistence and retrieval.
+     * This should be a valid TokenStorage implementation that handles token persistence,
+     * retrieval, and lifecycle management across different storage backends (localStorage,
+     * sessionStorage, memory, etc.).
      */
     tokenStorage: TokenStorage;
     /**
      * The child components that will have access to the security context.
+     * These components can use the useSecurityContext hook to access authentication state and methods.
      */
     children: ReactNode;
 }
 /**
  * Provider component that supplies authentication state and methods to its child components.
  * This component wraps the application or a portion of it to provide access to authentication
- * functionality through the useSecurityContext hook.
+ * functionality through the useSecurityContext hook. It internally uses the useSecurity hook
+ * to manage authentication state and makes it available via React context.
  *
  * @param tokenStorage - The token storage instance for managing authentication tokens.
+ *                      This should be a valid TokenStorage implementation that handles
+ *                      token persistence, retrieval, and lifecycle management across different
+ *                      storage backends (localStorage, sessionStorage, memory, etc.).
  * @param children - The child components that will have access to the security context.
+ *                  These components can use the useSecurityContext hook to access authentication
+ *                  state and methods without prop drilling.
+ * @param useSecurityOptions - Optional configuration object containing lifecycle callbacks
+ *                            for sign-in and sign-out events. Extends UseSecurityOptions interface.
+ * @param useSecurityOptions.onSignIn - Callback function invoked when sign in is successful.
+ * @param useSecurityOptions.onSignOut - Callback function invoked when sign out occurs.
  * @returns A React element that provides the security context to its children.
- * @throws {Error} May throw errors if tokenStorage operations fail during initialization.
+ *          The context value includes currentUser, authenticated status, signIn, and signOut methods.
+ * @throws {Error} May throw errors if tokenStorage operations fail during initialization,
+ *                 such as invalid tokens or storage access issues (implementation dependent).
  * @example
  * ```tsx
- * import { SecurityProvider } from '@ahoo-wang/fetcher-react/cosec';
+ * import { SecurityProvider } from '@ahoo-wang/fetcher-react';
  * import { tokenStorage } from './tokenStorage';
+ * import { useNavigate } from 'react-router-dom';
  *
  * function App() {
+ *   const navigate = useNavigate();
+ *
  *   return (
- *     <SecurityProvider tokenStorage={tokenStorage}>
+ *     <SecurityProvider
+ *       tokenStorage={tokenStorage}
+ *       onSignIn={() => navigate('/dashboard')}
+ *       onSignOut={() => navigate('/login')}
+ *     >
  *       <MyApp />
  *     </SecurityProvider>
  *   );
  * }
  * ```
  */
-export declare function SecurityProvider({ tokenStorage, children, }: SecurityContextOptions): import("react/jsx-runtime").JSX.Element;
+export declare function SecurityProvider({ tokenStorage, children, ...useSecurityOptions }: SecurityContextOptions): import("react/jsx-runtime").JSX.Element;
 /**
  * Hook to access the security context within components wrapped by SecurityProvider.
  * This hook provides reactive access to authentication state and methods throughout the component tree.
@@ -58,7 +91,7 @@ export declare function SecurityProvider({ tokenStorage, children, }: SecurityCo
  * @throws {Error} Throws an error if used outside of a SecurityProvider component.
  * @example
  * ```tsx
- * import { useSecurityContext } from '@ahoo-wang/fetcher-react/cosec';
+ * import { useSecurityContext } from '@ahoo-wang/fetcher-react';
  *
  * function UserProfile() {
  *   const { currentUser, authenticated, signOut } = useSecurityContext();

package/dist/cosec/SecurityContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SecurityContext.d.ts","sourceRoot":"","sources":["../../src/cosec/SecurityContext.tsx"],"names":[],"mappings":"AAaA,OAAO,EAAe,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAiB,SAAS,EAAc,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,eAAe,wDAE3B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,YAAY,EAAE,YAAY,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,YAAY,EACZ,QAAQ,GACT,EAAE,sBAAsB,2CAOxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAQpD"}
+{"version":3,"file":"SecurityContext.d.ts","sourceRoot":"","sources":["../../src/cosec/SecurityContext.tsx"],"names":[],"mappings":"AAaA,OAAO,EAEL,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAiB,SAAS,EAAc,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,wDAE3B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE;;;;;OAKG;IACH,YAAY,EAAE,YAAY,CAAC;IAE3B;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,YAAY,EACZ,QAAQ,EACR,GAAG,kBAAkB,EACtB,EAAE,sBAAsB,2CAOxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAQpD"}

package/dist/cosec/index.d.ts

@@ -1,3 +1,4 @@
 export * from './SecurityContext';
 export * from './useSecurity';
+export * from './RouteGuard';
 //# sourceMappingURL=index.d.ts.map

package/dist/cosec/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cosec/index.ts"],"names":[],"mappings":"AAaA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cosec/index.ts"],"names":[],"mappings":"AAaA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/cosec/useSecurity.d.ts

@@ -1,11 +1,31 @@
 import { TokenStorage, CompositeToken, CoSecJwtPayload } from '@ahoo-wang/fetcher-cosec';
+/**
+ * Type representing a composite token provider.
+ * Can be either a direct composite token or a function that returns a promise of a composite token.
+ */
+type CompositeTokenProvider = CompositeToken | (() => Promise<CompositeToken>);
 export declare const ANONYMOUS_USER: CoSecJwtPayload;
+/**
+ * Options for configuring the useSecurity hook.
+ */
+export interface UseSecurityOptions {
+    /**
+     * Callback function invoked when sign in is successful.
+     * This is called after the token has been successfully stored.
+     */
+    onSignIn?: () => void;
+    /**
+     * Callback function invoked when sign out occurs.
+     * This is called after the token has been removed.
+     */
+    onSignOut?: () => void;
+}
 /**
  * Return type for the useSecurity hook.
  */
 export interface UseSecurityReturn {
     /**
-     * The current authenticated user's JWT payload, or null if not authenticated.
+     * The current authenticated user's JWT payload, or ANONYMOUS_USER if not authenticated.
      * Contains user information extracted from the access token.
      */
     currentUser: CoSecJwtPayload;
@@ -15,10 +35,12 @@ export interface UseSecurityReturn {
      */
     authenticated: boolean;
     /**
-     * Function to sign in with a composite token.
-     * @param compositeToken - The composite token containing access and refresh tokens.
+     * Function to sign in with a composite token or a function that returns a promise of composite token.
+     * @param compositeTokenProvider - Either a composite token containing access and refresh tokens,
+     *                                or a function that returns a promise resolving to a composite token.
+     * @returns A promise that resolves when the sign-in operation is complete.
      */
-    signIn: (compositeToken: CompositeToken) => void;
+    signIn: (compositeTokenProvider: CompositeTokenProvider) => Promise<void>;
     /**
      * Function to sign out the current user.
      */
@@ -34,6 +56,9 @@ export interface UseSecurityReturn {
  * @param tokenStorage - The token storage instance used to manage authentication tokens.
  *                      This should be a valid TokenStorage implementation that handles
  *                      token persistence and retrieval.
+ * @param options - Optional configuration object containing lifecycle callbacks.
+ * @param options.onSignIn - Callback function invoked when sign in is successful.
+ * @param options.onSignOut - Callback function invoked when sign out occurs.
  * @returns An object containing:
  *          - currentUser: The current authenticated user's JWT payload, or null if not authenticated.
  *          - authenticated: Boolean indicating whether the user is currently authenticated.
@@ -43,14 +68,40 @@ export interface UseSecurityReturn {
  *                 or storage access issues (implementation dependent).
  * @example
  * ```typescript
- * import { useSecurity } from '@ahoo-wang/fetcher-react/cosec';
+ * import { useSecurity } from '@ahoo-wang/fetcher-react';
  * import { tokenStorage } from './tokenStorage';
+ * import { useNavigate } from 'react-router-dom';
  *
  * function App() {
- *   const { currentUser, authenticated, signIn, signOut } = useSecurity(tokenStorage);
+ *   const navigate = useNavigate();
+ *
+ *   const { currentUser, authenticated, signIn, signOut } = useSecurity(tokenStorage, {
+ *     onSignIn: () => {
+ *       // Redirect to dashboard after successful login
+ *       navigate('/dashboard');
+ *     },
+ *     onSignOut: () => {
+ *       // Redirect to login page after logout
+ *       navigate('/login');
+ *     }
+ *   });
+ *
+ *   const handleSignIn = async () => {
+ *     // Direct token
+ *     await signIn(compositeToken);
+ *
+ *     // Or async function
+ *     await signIn(async () => {
+ *       const response = await fetch('/api/auth/login', {
+ *         method: 'POST',
+ *         body: JSON.stringify({ username, password })
+ *       });
+ *       return response.json();
+ *     });
+ *   };
  *
  *   if (!authenticated) {
- *     return <button onClick={() => signIn(compositeToken)}>Sign In</button>;
+ *     return <button onClick={handleSignIn}>Sign In</button>;
  *   }
  *
  *   return (
@@ -62,5 +113,6 @@ export interface UseSecurityReturn {
  * }
  * ```
  */
-export declare function useSecurity(tokenStorage: TokenStorage): UseSecurityReturn;
+export declare function useSecurity(tokenStorage: TokenStorage, options?: UseSecurityOptions): UseSecurityReturn;
+export {};
 //# sourceMappingURL=useSecurity.d.ts.map

package/dist/cosec/useSecurity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSecurity.d.ts","sourceRoot":"","sources":["../../src/cosec/useSecurity.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,cAAc,EAAE,eAK5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,WAAW,EAAE,eAAe,CAAC;IAE7B;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,MAAM,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,IAAI,CAAC;IAEjD;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,iBAAiB,CAezE"}
+{"version":3,"file":"useSecurity.d.ts","sourceRoot":"","sources":["../../src/cosec/useSecurity.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAGlC;;;GAGG;AACH,KAAK,sBAAsB,GAAG,cAAc,GAAG,CAAC,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;AAE/E,eAAO,MAAM,cAAc,EAAE,eAK5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,WAAW,EAAE,eAAe,CAAC;IAE7B;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;;;;OAKG;IACH,MAAM,EAAE,CAAC,sBAAsB,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CA0BnB"}

package/dist/fetcher/debounced/index.d.ts

@@ -0,0 +1,3 @@
+export * from './useDebouncedFetcher';
+export * from './useDebouncedFetcherQuery';
+//# sourceMappingURL=index.d.ts.map

package/dist/fetcher/debounced/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fetcher/debounced/index.ts"],"names":[],"mappings":"AAaA,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC"}

package/dist/fetcher/{useDebouncedFetcher.d.ts → debounced/useDebouncedFetcher.d.ts}

@@ -1,6 +1,6 @@
-import { UseFetcherOptions, UseFetcherReturn } from './useFetcher';
+import { UseFetcherOptions, UseFetcherReturn } from '../useFetcher';
 import { FetcherError } from '@ahoo-wang/fetcher';
-import { DebounceCapable, UseDebouncedCallbackReturn } from '../core';
+import { DebounceCapable, UseDebouncedCallbackReturn } from '../../core';
 /**
  * Configuration options for the useDebouncedFetcher hook.
  * Extends UseFetcherOptions with debouncing capabilities to control the rate

package/dist/fetcher/debounced/useDebouncedFetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedFetcher.d.ts","sourceRoot":"","sources":["../../../src/fetcher/debounced/useDebouncedFetcher.ts"],"names":[],"mappings":"AAaA,OAAO,EAAc,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,eAAe,EAEf,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAGpB;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC,EAAE,CAAC,GAAG,YAAY,CAC7D,SAAQ,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,EAC7B,eAAe;CAAG;AAEtB;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC,EAAE,CAAC,GAAG,YAAY,CAC5D,SAAQ,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,EAC7C,0BAA0B,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;CAAG;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,GAAG,YAAY,EACrD,OAAO,EAAE,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,GACxC,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,CAiCjC"}

package/dist/{wow/debounce → fetcher/debounced}/useDebouncedFetcherQuery.d.ts

@@ -1,6 +1,6 @@
 import { FetcherError } from '@ahoo-wang/fetcher';
 import { DebounceCapable, UseDebouncedCallbackReturn } from '../../core';
-import { UseFetcherQueryOptions, UseFetcherQueryReturn } from '../useFetcherQuery';
+import { UseFetcherQueryOptions, UseFetcherQueryReturn } from '../index';
 /**
  * Configuration options for the useDebouncedFetcherQuery hook.
  *

package/dist/fetcher/debounced/useDebouncedFetcherQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedFetcherQuery.d.ts","sourceRoot":"","sources":["../../../src/fetcher/debounced/useDebouncedFetcherQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,eAAe,EAEf,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,+BAA+B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CACrE,SAAQ,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe;CAAG;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,8BAA8B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CACpE,SACE,IAAI,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,EAC/C,0BAA0B,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;CAAG;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,EAC7D,OAAO,EAAE,+BAA+B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAChD,8BAA8B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CA+DzC"}

package/dist/fetcher/index.d.ts

@@ -1,3 +1,4 @@
+export * from './debounced';
 export * from './useFetcher';
-export * from './useDebouncedFetcher';
+export * from './useFetcherQuery';
 //# sourceMappingURL=index.d.ts.map

package/dist/fetcher/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetcher/index.ts"],"names":[],"mappings":"AAaA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetcher/index.ts"],"names":[],"mappings":"AAaA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/{wow → fetcher}/useFetcherQuery.d.ts

@@ -1,7 +1,7 @@
-import { UseFetcherOptions, UseFetcherReturn } from '../fetcher';
+import { UseFetcherOptions, UseFetcherReturn } from './index';
 import { FetcherError } from '@ahoo-wang/fetcher';
-import { AutoExecuteCapable } from './types';
-import { UseQueryStateReturn } from './useQueryState';
+import { UseQueryStateReturn } from '../core';
+import { AutoExecuteCapable } from '../types';
 /**
  * Configuration options for the useFetcherQuery hook
  * @template Q - The type of the query parameters

package/dist/fetcher/useFetcherQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFetcherQuery.d.ts","sourceRoot":"","sources":["../../src/fetcher/useFetcherQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAAc,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAqC,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAA4B,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAExE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAC5D,SAAQ,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,kBAAkB;IACnD,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,YAAY,EAAE,CAAC,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAC3D,SAAQ,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACtD,4DAA4D;IAC5D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,EACpD,OAAO,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACvC,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CA6DhC"}