@ic-reactor/react 1.0.5 → 1.0.6

package/README.md

@@ -36,12 +36,11 @@ import { createReactor } from "@ic-reactor/react"
 
 type Actor = typeof actor
 
-export const { useActorStore, useAuthClient, useQueryCall } =
-  createReactor<Actor>({
-    canisterId,
-    idlFactory,
-    host: "https://localhost:4943",
-  })
+export const { useActorStore, useAuth, useQueryCall } = createReactor<Actor>({
+  canisterId,
+  idlFactory,
+  host: "https://localhost:4943",
+})
 ```
 
 Then, use the `useQueryCall` hook to call your canister method:
@@ -82,7 +81,7 @@ export default Balance
 
 ```jsx
 // Login.tsx
-import { useAuthClient } from "./actor"
+import { useAuth } from "./actor"
 
 const Login = () => {
   const {
@@ -93,7 +92,7 @@ const Login = () => {
     identity,
     authenticating,
     authenticated,
-  } = useAuthClient()
+  } = useAuth()
 
   return (
     <div>

package/dist/helpers/authHooks.js

@@ -14,15 +14,15 @@ const zustand_1 = require("zustand");
 const react_1 = require("react");
 const tools_1 = require("@ic-reactor/core/dist/tools");
 const authHooks = (agentManager) => {
-    const { authenticate: authenticator, authStore, isLocalEnv } = agentManager;
+    const { authenticate: authenticator, getAuth, authStore, isLocalEnv, } = agentManager;
     const useAuthState = () => (0, zustand_1.useStore)(authStore);
     const useUserPrincipal = () => { var _a, _b; return (_b = (_a = useAuthState()) === null || _a === void 0 ? void 0 : _a.identity) === null || _b === void 0 ? void 0 : _b.getPrincipal(); };
-    const useAuthClient = ({ onAuthentication, onAuthenticationSuccess, onAuthenticationFailure, onLogin, onLoginSuccess, onLoginError, onLoggedOut, } = {}) => {
+    const useAuth = ({ onAuthentication, onAuthenticationSuccess, onAuthenticationFailure, onLogin, onLoginSuccess, onLoginError, onLoggedOut, } = {}) => {
         const [loginState, setLoginState] = (0, react_1.useState)({
             loading: false,
             error: null,
         });
-        const { authClient, authenticated, authenticating, error, identity } = useAuthState();
+        const { authenticated, authenticating, error, identity } = useAuthState();
         const authenticate = (0, react_1.useCallback)(() => __awaiter(void 0, void 0, void 0, function* () {
             const authenticatePromise = new Promise((resolve, reject) => {
                 authenticator()
@@ -47,6 +47,7 @@ const authHooks = (agentManager) => {
             setLoginState({ loading: true, error: null });
             const loginPromise = new Promise((resolve, reject) => {
                 try {
+                    const authClient = getAuth();
                     if (!authClient) {
                         throw new Error("Auth client not initialized");
                     }
@@ -60,6 +61,7 @@ const authHooks = (agentManager) => {
                                 (_a = options === null || options === void 0 ? void 0 : options.onSuccess) === null || _a === void 0 ? void 0 : _a.call(options);
                                 onLoginSuccess === null || onLoginSuccess === void 0 ? void 0 : onLoginSuccess(principal);
                                 resolve(principal);
+                                setLoginState({ loading: false, error: null });
                             })
                                 .catch((e) => {
                                 const error = e;
@@ -84,29 +86,23 @@ const authHooks = (agentManager) => {
                 }
             });
             onLogin === null || onLogin === void 0 ? void 0 : onLogin(() => loginPromise);
-        }), [
-            authClient,
-            onLogin,
-            onLoginSuccess,
-            onLoginError,
-            isLocalEnv,
-            authenticate,
-        ]);
+        }), [onLogin, onLoginSuccess, onLoginError, isLocalEnv, authenticate]);
         const logout = (0, react_1.useCallback)((options) => __awaiter(void 0, void 0, void 0, function* () {
+            const authClient = getAuth();
             if (!authClient) {
                 throw new Error("Auth client not initialized");
             }
             yield authClient.logout(options);
             yield authenticate();
             onLoggedOut === null || onLoggedOut === void 0 ? void 0 : onLoggedOut();
-        }), [authClient, onLoggedOut]);
+        }), [onLoggedOut]);
         (0, react_1.useEffect)(() => {
+            const authClient = getAuth();
             if (!authClient && !authenticating) {
                 authenticate();
             }
-        }, [authClient, authenticating]);
+        }, [authenticating]);
         return {
-            authClient,
             authenticated,
             authenticating,
             identity,
@@ -121,7 +117,7 @@ const authHooks = (agentManager) => {
     return {
         useUserPrincipal,
         useAuthState,
-        useAuthClient,
+        useAuth,
     };
 };
 exports.authHooks = authHooks;

package/dist/helpers/extractActorContext.js

@@ -35,92 +35,10 @@ function extractActorContext(actorContext) {
         }
         return context;
     };
-    /**
-     * Initializes the actor manager, setting up the actor's state.
-     */
     const initialize = () => useActorContext().initialize();
-    /**
-     * Hook for accessing the current state of the actor, including the canister ID.
-     *
-     * @returns An object containing the current state of the actor from Zustand's store and the canister ID.
-     * @example
-     * ```tsx
-     * function ActorStateComponent() {
-     *   const { canisterId, initializing, error, initialized } = useActorState();
-     *
-     *   return (
-     *    <div>
-     *     <p>Canister ID: {canisterId}</p>
-     *     <p>Initializing: {initializing.toString()}</p>
-     *     <p>Initialized: {initialized.toString()}</p>
-     *     <p>Error: {error?.message}</p>
-     *   </div>
-     *   );
-     * }
-     *```
-     */
     const useActorState = () => useActorContext().useActorState();
-    /**
-     * Hook for making query calls to actors. It supports automatic refetching on component mount and at specified intervals.
-     *
-     * @param options Configuration object for the query call, including refetching options and other configurations passed to useReactorCall.
-     * @returns An object containing the query call function and the current call state (data, error, loading, call, reset).
-     * @example
-     * ```tsx
-     * function QueryCallComponent() {
-     *    const { call, data, loading } = useQueryCall({
-     *      functionName: 'getUserProfile',
-     *      args: ['123'],
-     *      refetchOnMount: true,
-     *      refetchInterval: 5000, // refetch every 5 seconds
-     *    });
-     *
-     *    if (loading) return <p>Loading profile...</p>;
-     *
-     *    return (
-     *      <div>
-     *        <p>User Profile: {JSON.stringify(data)}</p>
-     *        <button onClick={call}>Refetch</button>
-     *      </div>
-     *    );
-     * }
-     * ```
-     */
     const useQueryCall = (args) => useActorContext().useQueryCall(args);
-    /**
-     * Hook for making update calls to actors, handling loading states, and managing errors. It supports custom event handlers for loading, success, and error events.
-     *
-     * @param options Configuration object for the actor method call, including the method name, arguments, and event handlers.
-     * @returns An object containing the method call function, a reset function to reset the call state to its default, and the current call state (data, error, loading, call, reset).
-     * @example
-     * ```tsx
-     * function UpdateCallComponent() {
-     *   const { call, data, loading } = useUpdateCall({
-     *      functionName: 'updateUserProfile',
-     *      args: ['123', { name: 'John Doe' }],
-     *      onLoading: (loading) => console.log('Loading:', loading),
-     *      onError: (error) => console.error('Error:', error),
-     *      onSuccess: (data) => console.log('Success:', data),
-     *   });
-     *
-     *  if (loading) return <p>Updating profile...</p>;
-     *
-     *  return (
-     *    <div>
-     *      <p>Updated Profile: {JSON.stringify(data)}</p>
-     *      <button onClick={call}>Update</button>
-     *    </div>
-     *  );
-     * }
-     * ```
-     */
     const useUpdateCall = (args) => useActorContext().useUpdateCall(args);
-    /**
-     * Memoizes and returns a visit service function for a specific actor method.
-     *
-     * @param functionName The name of the actor method to visit.
-     * @returns The visit service function for the specified method.
-     */
     const useVisitMethod = (functionName) => useActorContext().useVisitMethod(functionName);
     return {
         useActorState,

package/dist/helpers/extractAgentContext.d.ts

@@ -9,7 +9,7 @@ import type { AgentContext, CreateAgentContextReturnType } from "../types";
  *  - useAgent: Hook for accessing the current agent instance.
  *  - useAuthState: Hook for accessing the current authentication state.
  *  - useAgentState: Hook for accessing the current state of the agent.
- *  - useAuthClient: Hook for accessing the authentication client, optionally accepting arguments for configuration.
+ *  - useAuth: Hook for accessing the authentication client, optionally accepting arguments for configuration.
  *  - useAgentManager: Hook for accessing the AgentManager instance.
  *  - useUserPrincipal: Hook for accessing the user's principal.
  *

package/dist/helpers/extractAgentContext.js

@@ -12,7 +12,7 @@ const react_1 = require("react");
  *  - useAgent: Hook for accessing the current agent instance.
  *  - useAuthState: Hook for accessing the current authentication state.
  *  - useAgentState: Hook for accessing the current state of the agent.
- *  - useAuthClient: Hook for accessing the authentication client, optionally accepting arguments for configuration.
+ *  - useAuth: Hook for accessing the authentication client, optionally accepting arguments for configuration.
  *  - useAgentManager: Hook for accessing the AgentManager instance.
  *  - useUserPrincipal: Hook for accessing the user's principal.
  *
@@ -35,98 +35,20 @@ const extractAgentContext = (agentContext) => {
         }
         return context;
     };
-    /**
-     * Accesses the `AgentManager` instance for managing agent configurations and state.
-     *
-     * @example
-     *```jsx
-     *  function AgentManagerComponent() {
-     *    const agentManager = useAgentManager();
-     *
-     *    // Use agentManager for managing agent configurations, etc.
-     *    return <div>Agent Manager ready.</div>;
-     *  }
-     *```
-     */
     const useAgentManager = (agentContext) => {
         const context = useAgentContext(agentContext);
         return context.agentManager;
     };
-    /**
-     * Accesses the current agent instance.
-     *
-     * @example
-     *```jsx
-     *  function AgentComponent() {
-     *    const agent = useAgent();
-     *
-     *    // Use agent for interacting with the Internet Computer.
-     *    return <div>Agent ready.</div>;
-     *  }
-     *```
-     */
     const useAgent = () => useAgentContext().useAgent();
-    /**
-     * Accesses the current authentication state.
-     *
-     * @example
-     * ```jsx
-     * function AuthStateComponent() {
-     *   const { isAuthenticated, user } = useAuthState();
-     *
-     *   return (
-     *     <div>
-     *       {isAuthenticated ? `User ${user} is authenticated.` : 'User is not authenticated.'}
-     *     </div>
-     *   );
-     * }
-     * ```
-     */
     const useAuthState = () => useAgentContext().useAuthState();
-    /**
-     * Accesses the current state of the agent.
-     *
-     * @example
-     * ```jsx
-     * function AgentStateComponent() {
-     *  const { initialized, initializing } = useAgentState();
-     *
-     *  return (
-     *   <div>
-     *    {initialized
-     *      ? 'Agent is initialized.'
-     *        : initializing
-     *        ? 'Agent is initializing...'
-     *        : 'Agent is not initialized.'}
-     *   </div>
-     *  );
-     * }
-     * ```
-     */
     const useAgentState = () => useAgentContext().useAgentState();
-    const useAuthClient = (args) => useAgentContext().useAuthClient(args);
-    /**
-     * Accesses the user's principal.
-     *
-     * @example
-     * ```jsx
-     * function UserPrincipalComponent() {
-     *   const userPrincipal = useUserPrincipal();
-     *
-     *   return (
-     *     <div>
-     *       {userPrincipal ? `User principal: ${userPrincipal}` : 'User principal not found.'}
-     *     </div>
-     *   );
-     * }
-     * ```
-     */
+    const useAuth = (args) => useAgentContext().useAuth(args);
     const useUserPrincipal = () => useAgentContext().useUserPrincipal();
     return {
         useAgent,
         useAuthState,
         useAgentState,
-        useAuthClient,
+        useAuth: useAuth,
         useAgentManager,
         useUserPrincipal,
     };

package/dist/helpers/types.d.ts

@@ -1,22 +1,15 @@
 /// <reference types="react" />
-import type { ActorState, CanisterId, AuthClientLoginOptions, ActorMethodParameters, ActorMethodReturnType, Identity, Principal, FunctionName, VisitService, AuthClient, AuthState, HttpAgent, AgentState, BaseActor } from "@ic-reactor/core/dist/types";
+import type { ActorState, CanisterId, AuthClientLoginOptions, ActorMethodParameters, ActorMethodReturnType, Identity, Principal, FunctionName, VisitService, AuthState, HttpAgent, AgentState, BaseActor } from "@ic-reactor/core/dist/types";
 export interface AgentHooksReturnType {
     useAgent: () => HttpAgent | undefined;
     useAgentState: () => AgentState;
 }
 export interface AuthHooksReturnType {
-    useUserPrincipal: () => Principal | undefined;
+    useAuth: (options?: UseAuthParameters) => UseAuthReturnType;
     useAuthState: () => AuthState;
-    useAuthClient: (args?: UseAuthClientParameters) => UseAuthClientReturnType;
-}
-export interface ActorHooksReturnType<A = BaseActor> {
-    initialize: () => Promise<void>;
-    useActorState: () => UseActorState;
-    useQueryCall: UseQueryCall<A>;
-    useUpdateCall: UseUpdateCall<A>;
-    useVisitMethod: <M extends FunctionName<A>>(functionName: M) => VisitService<A>[M];
+    useUserPrincipal: () => Principal | undefined;
 }
-export interface UseAuthClientParameters {
+export interface UseAuthParameters {
     onAuthentication?: (promise: () => Promise<Identity>) => void;
     onAuthenticationSuccess?: (identity: Identity) => void;
     onAuthenticationFailure?: (error: Error) => void;
@@ -25,9 +18,8 @@ export interface UseAuthClientParameters {
     onLogin?: (promise: () => Promise<Principal>) => void;
     onLoggedOut?: () => void;
 }
-export interface UseAuthClientReturnType {
+export interface UseAuthReturnType {
     error: Error | undefined;
-    authClient: AuthClient | null;
     authenticated: boolean;
     authenticating: boolean;
     identity: Identity | null;
@@ -45,6 +37,9 @@ export type LoginParameters = AuthClientLoginOptions;
 export type LogoutParameters = {
     returnTo?: string;
 };
+export interface UseActorState extends Omit<ActorState, "methodState"> {
+    canisterId: CanisterId;
+}
 export type UseMethodCallParameters<A, M extends FunctionName<A>> = {
     functionName: M;
     args?: ActorMethodParameters<A[M]>;
@@ -71,6 +66,11 @@ export interface UseMethodCallReturnType<A, M extends FunctionName<A> = Function
 export type UseMethodCall<A> = <M extends FunctionName<A>>(args: UseMethodCallParameters<A, M>) => UseMethodCallReturnType<A, M>;
 export type UseQueryCall<A> = <M extends FunctionName<A>>(args: UseQueryCallParameters<A, M>) => UseMethodCallReturnType<A, M>;
 export type UseUpdateCall<A> = <M extends FunctionName<A>>(args: UseUpdateCallParameters<A, M>) => UseMethodCallReturnType<A, M>;
-export interface UseActorState extends Omit<ActorState, "methodState"> {
-    canisterId: CanisterId;
+export type UseVisitMethod<A> = <M extends FunctionName<A>>(functionName: M) => VisitService<A>[M];
+export interface ActorHooksReturnType<A = BaseActor> {
+    initialize: () => Promise<void>;
+    useActorState: () => UseActorState;
+    useQueryCall: UseQueryCall<A>;
+    useUpdateCall: UseUpdateCall<A>;
+    useVisitMethod: UseVisitMethod<A>;
 }

package/dist/main.d.ts

@@ -31,7 +31,7 @@ import type { BaseActor, CreateReactorParameters, CreateReactorReturnType } from
  *
  * export type YourActor = typeof yourActor;
  *
- * export const { useAuthClient, useQueryCall, useUpdateCall } = createReactor<YourActor>(config);
+ * export const { useAuth, useQueryCall, useUpdateCall } = createReactor<YourActor>(config);
  * // Now you can use the returned hooks in your React components
  * ```
  */

package/dist/main.js

@@ -35,7 +35,7 @@ const helpers_1 = require("./helpers");
  *
  * export type YourActor = typeof yourActor;
  *
- * export const { useAuthClient, useQueryCall, useUpdateCall } = createReactor<YourActor>(config);
+ * export const { useAuth, useQueryCall, useUpdateCall } = createReactor<YourActor>(config);
  * // Now you can use the returned hooks in your React components
  * ```
  */

package/dist/provider/ActorProvider.d.ts

@@ -1,5 +1,4 @@
 /// <reference types="react" />
-export declare const ActorHooks: import("./types").CreateActorContextReturnType<import("@ic-reactor/core/dist/types").BaseActor>;
 /**
  * `ActorProvider` is a React functional component that serves as a context provider for IC actor interactions within a React application.
  * It wraps child components, providing them access to actor-specific hooks and functionalities based on the provided canister ID and configuration.

package/dist/provider/ActorProvider.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActorProvider = exports.ActorHooks = void 0;
-const actor_1 = require("./actor");
-exports.ActorHooks = (0, actor_1.createActorContext)();
+exports.ActorProvider = void 0;
+const actorHooks_1 = require("./actorHooks");
 /**
  * `ActorProvider` is a React functional component that serves as a context provider for IC actor interactions within a React application.
  * It wraps child components, providing them access to actor-specific hooks and functionalities based on the provided canister ID and configuration.
@@ -27,4 +26,4 @@ exports.ActorHooks = (0, actor_1.createActorContext)();
  * ```
  * This setup ensures that `YourComponent` and any of its children can interact with the specified IC actor through the context provided by `ActorProvider`.
  */
-exports.ActorProvider = exports.ActorHooks.ActorProvider;
+exports.ActorProvider = actorHooks_1.ActorHooks.ActorProvider;

package/dist/provider/AgentProvider.d.ts

@@ -1,5 +1,4 @@
 /// <reference types="react" />
-export declare const AgentHooks: import("./types").CreateAgentContextReturnType;
 /**
  * `AgentProvider` is a React functional component that serves as a context provider for IC agent and authentication hooks.
  * It enables any child components to access and use the agent and authentication functionalities seamlessly.

package/dist/provider/AgentProvider.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentProvider = exports.AgentHooks = void 0;
-const agent_1 = require("./agent");
-exports.AgentHooks = (0, agent_1.createAgentContext)();
+exports.AgentProvider = void 0;
+const agentHooks_1 = require("./agentHooks");
 /**
  * `AgentProvider` is a React functional component that serves as a context provider for IC agent and authentication hooks.
  * It enables any child components to access and use the agent and authentication functionalities seamlessly.
@@ -30,4 +29,4 @@ exports.AgentHooks = (0, agent_1.createAgentContext)();
  * Inside `YourComponent` or any of its children, you can use the hooks provided through the context to interact with the IC,
  * manage authentication, and perform other agent-related tasks.
  */
-exports.AgentProvider = exports.AgentHooks.AgentProvider;
+exports.AgentProvider = agentHooks_1.AgentHooks.AgentProvider;

package/dist/provider/actorHooks.d.ts

@@ -0,0 +1 @@
+export declare const ActorHooks: import("./types").CreateActorContextReturnType<import("@ic-reactor/core/dist/types").BaseActor>;

package/dist/provider/actorHooks.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActorHooks = void 0;
+const actor_1 = require("./context/actor");
+exports.ActorHooks = (0, actor_1.createActorContext)();

package/dist/provider/agentHooks.d.ts

@@ -0,0 +1 @@
+export declare const AgentHooks: import("./types").CreateAgentContextReturnType;

package/dist/provider/agentHooks.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentHooks = void 0;
+const agent_1 = require("./context/agent");
+exports.AgentHooks = (0, agent_1.createAgentContext)();

package/dist/provider/{actor.d.ts → context/actor.d.ts}

@@ -1,5 +1,5 @@
-import { BaseActor } from "../types";
-import { CreateActorContextParameters, CreateActorContextReturnType } from "./types";
+import { BaseActor } from "../../types";
+import { CreateActorContextParameters, CreateActorContextReturnType } from "../types";
 /**
  * Creates a React context specifically designed for managing the state and interactions with an actor on the Internet Computer (IC) blockchain.
  * This context facilitates the dynamic creation and management of IC actors within React applications, leveraging the provided configuration options.

package/dist/provider/{actor.js → context/actor.js}

@@ -36,8 +36,8 @@ var __rest = (this && this.__rest) || function (s, e) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createActorContext = void 0;
 const react_1 = __importStar(require("react"));
-const useActor_1 = require("./hooks/useActor");
-const extractActorContext_1 = require("../helpers/extractActorContext");
+const useActor_1 = require("../hooks/useActor");
+const extractActorContext_1 = require("../../helpers/extractActorContext");
 /**
  * Creates a React context specifically designed for managing the state and interactions with an actor on the Internet Computer (IC) blockchain.
  * This context facilitates the dynamic creation and management of IC actors within React applications, leveraging the provided configuration options.

package/dist/provider/{agent.d.ts → context/agent.d.ts}

@@ -1,5 +1,5 @@
-import type { AgentManagerParameters } from "../types";
-import type { CreateAgentContextReturnType } from "./types";
+import type { AgentManagerParameters } from "../../types";
+import type { CreateAgentContextReturnType } from "../types";
 /**
  * Creates a React context for managing IC agent and authentication states, providing hooks for interacting with the IC blockchain.
  * This function initializes an `AgentContext` with a set of utilities and hooks based on the provided agent configuration.
@@ -11,7 +11,7 @@ import type { CreateAgentContextReturnType } from "./types";
  *
  * Usage:
  * - `AgentProvider`: React component to provide agent context to your application.
- * - `useAgent`, `useAuthClient`, `useAuthState`, `useAgentState`, `useAgentManager`, `useUserPrincipal`: Hooks extracted from the created context for managing agent and authentication state within components.
+ * - `useAgent`, `useAuth`, `useAuthState`, `useAgentState`, `useAgentManager`, `useUserPrincipal`: Hooks extracted from the created context for managing agent and authentication state within components.
  *
  * @example
  * ```tsx
@@ -30,7 +30,7 @@ import type { CreateAgentContextReturnType } from "./types";
  * export const {
  *   AgentProvider,
  *   useAgent,
- *   useAuthClient,
+ *   useAuth,
  *   useAuthState,
  *   useAgentState,
  *   useAgentManager,
@@ -51,7 +51,7 @@ import type { CreateAgentContextReturnType } from "./types";
  * );
  *
  * const Login = () => {
- *  const { login } = useAuthClient()
+ *  const { login } = useAuth()
  *  const principal = useUserPrincipal()
  *
  *  return (

package/dist/provider/{agent.js → context/agent.js}

@@ -37,9 +37,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAgentContext = void 0;
 const react_1 = __importStar(require("react"));
 const core_1 = require("@ic-reactor/core");
-const agentHooks_1 = require("../helpers/agentHooks");
-const authHooks_1 = require("../helpers/authHooks");
-const extractAgentContext_1 = require("../helpers/extractAgentContext");
+const agentHooks_1 = require("../../helpers/agentHooks");
+const authHooks_1 = require("../../helpers/authHooks");
+const extractAgentContext_1 = require("../../helpers/extractAgentContext");
 /**
  * Creates a React context for managing IC agent and authentication states, providing hooks for interacting with the IC blockchain.
  * This function initializes an `AgentContext` with a set of utilities and hooks based on the provided agent configuration.
@@ -51,7 +51,7 @@ const extractAgentContext_1 = require("../helpers/extractAgentContext");
  *
  * Usage:
  * - `AgentProvider`: React component to provide agent context to your application.
- * - `useAgent`, `useAuthClient`, `useAuthState`, `useAgentState`, `useAgentManager`, `useUserPrincipal`: Hooks extracted from the created context for managing agent and authentication state within components.
+ * - `useAgent`, `useAuth`, `useAuthState`, `useAgentState`, `useAgentManager`, `useUserPrincipal`: Hooks extracted from the created context for managing agent and authentication state within components.
  *
  * @example
  * ```tsx
@@ -70,7 +70,7 @@ const extractAgentContext_1 = require("../helpers/extractAgentContext");
  * export const {
  *   AgentProvider,
  *   useAgent,
- *   useAuthClient,
+ *   useAuth,
  *   useAuthState,
  *   useAgentState,
  *   useAgentManager,
@@ -91,7 +91,7 @@ const extractAgentContext_1 = require("../helpers/extractAgentContext");
  * );
  *
  * const Login = () => {
- *  const { login } = useAuthClient()
+ *  const { login } = useAuth()
  *  const principal = useUserPrincipal()
  *
  *  return (

package/dist/provider/hooks/actor/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./useActorState";
+export * from "./useQueryCall";
+export * from "./useUpdateCall";
+export * from "./useVisitMethod";

package/dist/provider/hooks/actor/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useActorState"), exports);
+__exportStar(require("./useQueryCall"), exports);
+__exportStar(require("./useUpdateCall"), exports);
+__exportStar(require("./useVisitMethod"), exports);

package/dist/provider/hooks/actor/useActorState.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Hook for accessing the current state of the actor, including the canister ID.
+ *
+ * @returns An object containing the current state of the actor from Zustand's store and the canister ID.
+ * @example
+ * ```tsx
+ * function ActorStateComponent() {
+ *   const { canisterId, initializing, error, initialized } = useActorState();
+ *
+ *   return (
+ *    <div>
+ *     <p>Canister ID: {canisterId}</p>
+ *     <p>Initializing: {initializing.toString()}</p>
+ *     <p>Initialized: {initialized.toString()}</p>
+ *     <p>Error: {error?.message}</p>
+ *   </div>
+ *   );
+ * }
+ *```
+ */
+export declare const useActorState: () => import("../../../types").UseActorState;

package/dist/provider/hooks/actor/useActorState.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useActorState = void 0;
+const actorHooks_1 = require("../../actorHooks");
+/**
+ * Hook for accessing the current state of the actor, including the canister ID.
+ *
+ * @returns An object containing the current state of the actor from Zustand's store and the canister ID.
+ * @example
+ * ```tsx
+ * function ActorStateComponent() {
+ *   const { canisterId, initializing, error, initialized } = useActorState();
+ *
+ *   return (
+ *    <div>
+ *     <p>Canister ID: {canisterId}</p>
+ *     <p>Initializing: {initializing.toString()}</p>
+ *     <p>Initialized: {initialized.toString()}</p>
+ *     <p>Error: {error?.message}</p>
+ *   </div>
+ *   );
+ * }
+ *```
+ */
+exports.useActorState = actorHooks_1.ActorHooks.useActorState;