@ic-reactor/react 1.0.6 → 1.0.7

package/dist/{provider/context → 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/context → context}/actor.js

@@ -37,7 +37,7 @@ 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 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/context → context}/agent.d.ts

@@ -1,26 +1,28 @@
-import type { AgentManagerParameters } from "../../types";
-import type { CreateAgentContextReturnType } from "../types";
+import type { CreateAgentContextReturnType, CreateAgentCotextParameters } 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.
  *
- * @param agentParameters A partial configuration object for the agent manager, allowing customization of the agent's behavior.
+ * @param config A partial configuration object {@link CreateAgentCotextParameters}, allowing customization of the agent's behavior.
  *
- * @returns An object containing the `AgentProvider` component and various hooks for interacting with the agent and authentication state.
- * The `AgentProvider` component is a React context provider that should wrap your app or components needing access to agent functionalities.
+ * @returns
+ * An object containing the {@link AgentProvider} component and various hooks for interacting with the agent and authentication state.
+ * The {@link AgentProvider} component is a React context provider that should wrap your app or components needing access to agent functionalities.
  *
  * Usage:
- * - `AgentProvider`: React component to provide agent context to your application.
- * - `useAgent`, `useAuth`, `useAuthState`, `useAgentState`, `useAgentManager`, `useUserPrincipal`: Hooks extracted from the created context for managing agent and authentication state within components.
+ * - {@link AgentProvider}: React component to provide agent context to your application.
+ * - {@link useAgent}, {@link useAuth}, {@link useAuthState},
+ *   {@link useAgentState}, {@link useAgentManager}, {@link useUserPrincipal}:
+ *  Hooks extracted from the created context for managing agent and authentication state within components.
  *
  * @example
+ * agent.ts
  * ```tsx
- * // agent.ts
  * import { createAgentContext } from "@ic-reactor/react";
- * import { CreateAgentParameters } from "@ic-reactor/react/dist/types";
+ * import { CreateAgentCotextParameters } from "@ic-reactor/react/dist/types";
  *
  * // Optional: Define custom agent configuration
- * const agentConfig: CreateAgentParameters = {
+ * const agentConfig: CreateAgentCotextParameters = {
  *   host: "https://localhost:8000",
  *   // or
  *   // isLocalEnv: true,
@@ -38,8 +40,9 @@ import type { CreateAgentContextReturnType } from "../types";
  * } = createAgentContext(agentConfig);
  *
  * // Now you can use the returned hooks in your React components
- *
- * // App.tsx
+ *```
+ * App.tsx
+ * ```tsx
  * import React from 'react';
  * import { AgentProvider } from './agent';
  *
@@ -65,7 +68,7 @@ import type { CreateAgentContextReturnType } from "../types";
  * ```
  *
  * This setup allows you to use the agent and authentication hooks within
- * the components wrapped by `AgentProvider`, facilitating interaction
+ * the components wrapped by {@link AgentProvider}, facilitating interaction
  * with the Internet Computer blockchain.
  */
-export declare const createAgentContext: (config?: AgentManagerParameters) => CreateAgentContextReturnType;
+export declare const createAgentContext: (config?: CreateAgentCotextParameters) => CreateAgentContextReturnType;

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

@@ -37,30 +37,33 @@ 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.
  *
- * @param agentParameters A partial configuration object for the agent manager, allowing customization of the agent's behavior.
+ * @param config A partial configuration object {@link CreateAgentCotextParameters}, allowing customization of the agent's behavior.
  *
- * @returns An object containing the `AgentProvider` component and various hooks for interacting with the agent and authentication state.
- * The `AgentProvider` component is a React context provider that should wrap your app or components needing access to agent functionalities.
+ * @returns
+ * An object containing the {@link AgentProvider} component and various hooks for interacting with the agent and authentication state.
+ * The {@link AgentProvider} component is a React context provider that should wrap your app or components needing access to agent functionalities.
  *
  * Usage:
- * - `AgentProvider`: React component to provide agent context to your application.
- * - `useAgent`, `useAuth`, `useAuthState`, `useAgentState`, `useAgentManager`, `useUserPrincipal`: Hooks extracted from the created context for managing agent and authentication state within components.
+ * - {@link AgentProvider}: React component to provide agent context to your application.
+ * - {@link useAgent}, {@link useAuth}, {@link useAuthState},
+ *   {@link useAgentState}, {@link useAgentManager}, {@link useUserPrincipal}:
+ *  Hooks extracted from the created context for managing agent and authentication state within components.
  *
  * @example
+ * agent.ts
  * ```tsx
- * // agent.ts
  * import { createAgentContext } from "@ic-reactor/react";
- * import { CreateAgentParameters } from "@ic-reactor/react/dist/types";
+ * import { CreateAgentCotextParameters } from "@ic-reactor/react/dist/types";
  *
  * // Optional: Define custom agent configuration
- * const agentConfig: CreateAgentParameters = {
+ * const agentConfig: CreateAgentCotextParameters = {
  *   host: "https://localhost:8000",
  *   // or
  *   // isLocalEnv: true,
@@ -78,8 +81,9 @@ const extractAgentContext_1 = require("../../helpers/extractAgentContext");
  * } = createAgentContext(agentConfig);
  *
  * // Now you can use the returned hooks in your React components
- *
- * // App.tsx
+ *```
+ * App.tsx
+ * ```tsx
  * import React from 'react';
  * import { AgentProvider } from './agent';
  *
@@ -105,7 +109,7 @@ const extractAgentContext_1 = require("../../helpers/extractAgentContext");
  * ```
  *
  * This setup allows you to use the agent and authentication hooks within
- * the components wrapped by `AgentProvider`, facilitating interaction
+ * the components wrapped by {@link AgentProvider}, facilitating interaction
  * with the Internet Computer blockchain.
  */
 const createAgentContext = (config = {}) => {

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

@@ -1,9 +1,10 @@
 import type { IDL, ActorHooksReturnType, AgentHooksReturnType, AuthHooksReturnType, BaseActor, AgentManager, ActorManagerParameters, AgentManagerParameters } from "../types";
 import type { PropsWithChildren } from "react";
-export * from "./hooks/types";
 export interface AgentContext extends AgentHooksReturnType, AuthHooksReturnType {
     agentManager: AgentManager;
 }
+export interface CreateAgentCotextParameters extends AgentManagerParameters {
+}
 export interface CreateAgentContextReturnType extends AgentHooksReturnType, AuthHooksReturnType {
     useAgentManager: (agentContext?: React.Context<AgentContext | null>) => AgentManager;
     AgentProvider: React.FC<AgentProviderProps>;

package/dist/createReactor.d.ts

@@ -0,0 +1,49 @@
+import type { BaseActor, CreateReactorParameters, CreateReactorReturnType } from "./types";
+/**
+ * Initializes and configures the reactor environment for interacting with the Internet Computer (IC) blockchain within a React application.
+ * It encapsulates the creation of actors, authentication, and agent management, offering a streamlined interface for blockchain interactions.
+ *
+ * @param config Configuration {@link CreateReactorParameters} for the reactor, including:
+ *  - `withProcessEnv` (optional): Specifies whether to use process environment variables to determine if the environment is local or development. Defaults to false.
+ *  - `isLocalEnv` (optional): Indicates if the current environment is local or development, influencing the agent and actor behavior. Useful for testing or development.
+ *  - `port` (optional): Port number for the local or development environment.
+ *
+ * @returns An object containing {@link CreateReactorReturnType} hooks and utilities:
+ *  - {@link getAgent} - Returns the current agent instance.
+ *  - {@link getVisitFunction} - Returns the visit function for the actor.
+ *  - {@link useQueryCall} - A hook for querying actor methods.
+ *  - {@link useUpdateCall} - A hook for updating actor methods.
+ *  - {@link useAuth} - A hook for managing authentication and user principal.
+ *  - {@link useActor} - A hook for managing actors and their methods.
+ *  - {@link useActorManager} - A hook for managing actor manager and its methods.
+ *  - {@link useAgentManager} - A hook for managing agent manager and its methods.
+ *  - {@link initialize} - A function to initialize the actor manager if not initialized.
+ *  - {@link useActorState} - A hook for managing actor state.
+ *  - {@link useAgent} - A hook for managing agent and its methods.
+ *  - {@link useAuthState} - A hook for managing authentication state.
+ *  - {@link useAgentState} - A hook for managing agent state.
+ *  - {@link useUserPrincipal} - A hook for managing user principal.
+ *  - {@link useVisitMethod} - A hook for visiting actor methods.
+ *
+ * @example
+ * ```typescript
+ * import { createReactor } from "@ic-reactor/react";
+ * import type { CreateReactorParameters } from "@ic-reactor/react/dist/types";
+ * import { canisterId, idlFactory, yourActor } from "./declaration/yourActor"
+ *
+ * const config: CreateReactorParameters = {
+ *   canisterId,
+ *   idlFactory,
+ *   host: "https://localhost:8000", // IC network host         |
+ *   isLocalEnv: true, // Set true for local network            | one of these
+ *   withProcessEnv: true, // Use process.env to determine host |
+ *   port: 8000, // Port number for local network               |
+ * };
+ *
+ * export type YourActor = typeof yourActor;
+ *
+ * export const { useAuth, useQueryCall, useUpdateCall } = createReactor<YourActor>(config);
+ * // Now you can use the returned hooks in your React components
+ * ```
+ */
+export declare const createReactor: <A = BaseActor>(config: CreateReactorParameters) => CreateReactorReturnType<A>;

package/dist/createReactor.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReactor = void 0;
+const core_1 = require("@ic-reactor/core");
+const helpers_1 = require("./helpers");
+/**
+ * Initializes and configures the reactor environment for interacting with the Internet Computer (IC) blockchain within a React application.
+ * It encapsulates the creation of actors, authentication, and agent management, offering a streamlined interface for blockchain interactions.
+ *
+ * @param config Configuration {@link CreateReactorParameters} for the reactor, including:
+ *  - `withProcessEnv` (optional): Specifies whether to use process environment variables to determine if the environment is local or development. Defaults to false.
+ *  - `isLocalEnv` (optional): Indicates if the current environment is local or development, influencing the agent and actor behavior. Useful for testing or development.
+ *  - `port` (optional): Port number for the local or development environment.
+ *
+ * @returns An object containing {@link CreateReactorReturnType} hooks and utilities:
+ *  - {@link getAgent} - Returns the current agent instance.
+ *  - {@link getVisitFunction} - Returns the visit function for the actor.
+ *  - {@link useQueryCall} - A hook for querying actor methods.
+ *  - {@link useUpdateCall} - A hook for updating actor methods.
+ *  - {@link useAuth} - A hook for managing authentication and user principal.
+ *  - {@link useActor} - A hook for managing actors and their methods.
+ *  - {@link useActorManager} - A hook for managing actor manager and its methods.
+ *  - {@link useAgentManager} - A hook for managing agent manager and its methods.
+ *  - {@link initialize} - A function to initialize the actor manager if not initialized.
+ *  - {@link useActorState} - A hook for managing actor state.
+ *  - {@link useAgent} - A hook for managing agent and its methods.
+ *  - {@link useAuthState} - A hook for managing authentication state.
+ *  - {@link useAgentState} - A hook for managing agent state.
+ *  - {@link useUserPrincipal} - A hook for managing user principal.
+ *  - {@link useVisitMethod} - A hook for visiting actor methods.
+ *
+ * @example
+ * ```typescript
+ * import { createReactor } from "@ic-reactor/react";
+ * import type { CreateReactorParameters } from "@ic-reactor/react/dist/types";
+ * import { canisterId, idlFactory, yourActor } from "./declaration/yourActor"
+ *
+ * const config: CreateReactorParameters = {
+ *   canisterId,
+ *   idlFactory,
+ *   host: "https://localhost:8000", // IC network host         |
+ *   isLocalEnv: true, // Set true for local network            | one of these
+ *   withProcessEnv: true, // Use process.env to determine host |
+ *   port: 8000, // Port number for local network               |
+ * };
+ *
+ * export type YourActor = typeof yourActor;
+ *
+ * export const { useAuth, useQueryCall, useUpdateCall } = createReactor<YourActor>(config);
+ * // Now you can use the returned hooks in your React components
+ * ```
+ */
+const createReactor = (config) => {
+    const actorManager = (0, core_1.createReactorStore)(config);
+    const getVisitFunction = () => {
+        return actorManager.visitFunction;
+    };
+    const getAgent = () => {
+        return actorManager.agentManager.getAgent();
+    };
+    return Object.assign(Object.assign(Object.assign({ getAgent,
+        getVisitFunction }, (0, helpers_1.actorHooks)(actorManager)), (0, helpers_1.authHooks)(actorManager.agentManager)), (0, helpers_1.agentHooks)(actorManager.agentManager));
+};
+exports.createReactor = createReactor;

package/dist/helpers/authHooks.js

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.authHooks = void 0;
 const zustand_1 = require("zustand");
 const react_1 = require("react");
-const tools_1 = require("@ic-reactor/core/dist/tools");
+const utils_1 = require("@ic-reactor/core/dist/utils");
 const authHooks = (agentManager) => {
     const { authenticate: authenticator, getAuth, authStore, isLocalEnv, } = agentManager;
     const useAuthState = () => (0, zustand_1.useStore)(authStore);
@@ -52,8 +52,8 @@ const authHooks = (agentManager) => {
                         throw new Error("Auth client not initialized");
                     }
                     authClient.login(Object.assign(Object.assign({ identityProvider: isLocalEnv
-                            ? tools_1.IC_INTERNET_IDENTITY_PROVIDER
-                            : tools_1.LOCAL_INTERNET_IDENTITY_PROVIDER }, options), { onSuccess: () => {
+                            ? utils_1.LOCAL_INTERNET_IDENTITY_PROVIDER
+                            : utils_1.IC_INTERNET_IDENTITY_PROVIDER }, options), { onSuccess: () => {
                             authenticate()
                                 .then((identity) => {
                                 var _a;

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

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

package/dist/{provider/actorHooks.js → hooks/actor/hooks.js}

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

package/dist/{provider/hooks → hooks}/actor/useActorState.d.ts

@@ -18,4 +18,4 @@
  * }
  *```
  */
-export declare const useActorState: () => import("../../../types").UseActorState;
+export declare const useActorState: () => import("../../types").UseActorState;

package/dist/{provider/hooks → hooks}/actor/useActorState.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useActorState = void 0;
-const actorHooks_1 = require("../../actorHooks");
+const hooks_1 = require("./hooks");
 /**
  * Hook for accessing the current state of the actor, including the canister ID.
  *
@@ -22,4 +22,4 @@ const actorHooks_1 = require("../../actorHooks");
  * }
  *```
  */
-exports.useActorState = actorHooks_1.ActorHooks.useActorState;
+exports.useActorState = hooks_1.ActorHooks.useActorState;

package/dist/{provider/hooks → hooks}/actor/useQueryCall.d.ts

@@ -1,4 +1,4 @@
-import { FunctionName, UseQueryCallParameters } from "../../../types";
+import { FunctionName, UseQueryCallParameters } from "../../types";
 /**
  * Hook for making query calls to actors. It supports automatic refetching on component mount and at specified intervals.
  *
@@ -25,4 +25,4 @@ import { FunctionName, UseQueryCallParameters } from "../../../types";
  * }
  * ```
  */
-export declare function useQueryCall<A, M extends FunctionName<A> = FunctionName<A>>(args: UseQueryCallParameters<A, M>): import("../../../types").UseMethodCallReturnType<A, M>;
+export declare function useQueryCall<A, M extends FunctionName<A> = FunctionName<A>>(args: UseQueryCallParameters<A, M>): import("../../types").UseMethodCallReturnType<A, M>;

package/dist/{provider/hooks → hooks}/actor/useQueryCall.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useQueryCall = void 0;
-const actorHooks_1 = require("../../actorHooks");
+const hooks_1 = require("./hooks");
 /**
  * Hook for making query calls to actors. It supports automatic refetching on component mount and at specified intervals.
  *
@@ -29,6 +29,6 @@ const actorHooks_1 = require("../../actorHooks");
  * ```
  */
 function useQueryCall(args) {
-    return actorHooks_1.ActorHooks.useQueryCall(args);
+    return hooks_1.ActorHooks.useQueryCall(args);
 }
 exports.useQueryCall = useQueryCall;

package/dist/{provider/hooks → hooks}/actor/useUpdateCall.d.ts

@@ -1,4 +1,4 @@
-import { BaseActor, FunctionName, UseUpdateCallParameters } from "../../../types";
+import { BaseActor, FunctionName, UseUpdateCallParameters } from "../../types";
 /**
  * Hook for making update calls to actors, handling loading states, and managing errors. It supports custom event handlers for loading, success, and error events.
  *
@@ -26,4 +26,4 @@ import { BaseActor, FunctionName, UseUpdateCallParameters } from "../../../types
  * }
  * ```
  */
-export declare function useUpdateCall<A = BaseActor, M extends FunctionName<A> = FunctionName<A>>(args: UseUpdateCallParameters<A, M>): import("../../../types").UseMethodCallReturnType<A, M>;
+export declare function useUpdateCall<A = BaseActor, M extends FunctionName<A> = FunctionName<A>>(args: UseUpdateCallParameters<A, M>): import("../../types").UseMethodCallReturnType<A, M>;

package/dist/{provider/hooks → hooks}/actor/useUpdateCall.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useUpdateCall = void 0;
-const actorHooks_1 = require("../../actorHooks");
+const hooks_1 = require("./hooks");
 /**
  * Hook for making update calls to actors, handling loading states, and managing errors. It supports custom event handlers for loading, success, and error events.
  *
@@ -30,6 +30,6 @@ const actorHooks_1 = require("../../actorHooks");
  * ```
  */
 function useUpdateCall(args) {
-    return actorHooks_1.ActorHooks.useUpdateCall(args);
+    return hooks_1.ActorHooks.useUpdateCall(args);
 }
 exports.useUpdateCall = useUpdateCall;

package/dist/{provider/hooks → hooks}/actor/useVisitMethod.d.ts

@@ -1,4 +1,4 @@
-import { BaseActor, FunctionName } from "../../../types";
+import { BaseActor, FunctionName } from "../../types";
 /**
  * Memoizes and returns a visit service function for a specific actor method.
  *

package/dist/{provider/hooks → hooks}/actor/useVisitMethod.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useVisitMethod = void 0;
-const actorHooks_1 = require("../../actorHooks");
+const hooks_1 = require("./hooks");
 /**
  * Memoizes and returns a visit service function for a specific actor method.
  *
@@ -9,6 +9,6 @@ const actorHooks_1 = require("../../actorHooks");
  * @returns The visit service function for the specified method.
  */
 function useVisitMethod(functionName) {
-    return actorHooks_1.ActorHooks.useVisitMethod(functionName);
+    return hooks_1.ActorHooks.useVisitMethod(functionName);
 }
 exports.useVisitMethod = useVisitMethod;

package/dist/hooks/agent/hooks.d.ts

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

package/dist/{provider/agentHooks.js → hooks/agent/hooks.js}

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

package/dist/{provider/hooks → hooks}/agent/useAgent.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useAgent = void 0;
-const agentHooks_1 = require("../../agentHooks");
+const hooks_1 = require("./hooks");
 /**
  * Accesses the current agent instance.
  *
@@ -15,4 +15,4 @@ const agentHooks_1 = require("../../agentHooks");
  *  }
  *```
  */
-exports.useAgent = agentHooks_1.AgentHooks.useAgent;
+exports.useAgent = hooks_1.AgentHooks.useAgent;

package/dist/{provider/hooks → hooks}/agent/useAgentManager.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useAgentManager = void 0;
-const agentHooks_1 = require("../../agentHooks");
+const hooks_1 = require("./hooks");
 /**
  * Accesses the `AgentManager` instance for managing agent configurations and state.
  *
@@ -15,4 +15,4 @@ const agentHooks_1 = require("../../agentHooks");
  *  }
  *```
  */
-exports.useAgentManager = agentHooks_1.AgentHooks.useAgentManager;
+exports.useAgentManager = hooks_1.AgentHooks.useAgentManager;

package/dist/{provider/hooks → hooks}/agent/useAgentState.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useAgentState = void 0;
-const agentHooks_1 = require("../../agentHooks");
+const hooks_1 = require("./hooks");
 /**
  * Accesses the current state of the agent.
  *
@@ -22,4 +22,4 @@ const agentHooks_1 = require("../../agentHooks");
  * }
  * ```
  */
-exports.useAgentState = agentHooks_1.AgentHooks.useAgentState;
+exports.useAgentState = hooks_1.AgentHooks.useAgentState;

package/dist/{provider/hooks → hooks}/agent/useAuth.d.ts

@@ -54,4 +54,4 @@
  *
  * This hook simplifies integrating authentication flows into your IC application, providing hooks for various stages of the authentication process.
  */
-export declare const useAuth: (options?: import("../../../types").UseAuthParameters | undefined) => import("../../../types").UseAuthReturnType;
+export declare const useAuth: (options?: import("../../types").UseAuthParameters | undefined) => import("../../types").UseAuthReturnType;

package/dist/{provider/hooks → hooks}/agent/useAuth.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useAuth = void 0;
-const agentHooks_1 = require("../../agentHooks");
+const hooks_1 = require("./hooks");
 /**
  * `useAuth` is a custom React hook designed to manage authentication processes in applications interacting with the Internet Computer (IC).
  * It encapsulates the logic for logging in, logging out, and maintaining the authentication state, leveraging an authentication client.
@@ -58,4 +58,4 @@ const agentHooks_1 = require("../../agentHooks");
  *
  * This hook simplifies integrating authentication flows into your IC application, providing hooks for various stages of the authentication process.
  */
-exports.useAuth = agentHooks_1.AgentHooks.useAuth;
+exports.useAuth = hooks_1.AgentHooks.useAuth;

package/dist/{provider/hooks → hooks}/agent/useAuthState.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useAuthState = void 0;
-const agentHooks_1 = require("../../agentHooks");
+const hooks_1 = require("./hooks");
 /**
  * Accesses the current authentication state.
  *
@@ -20,4 +20,4 @@ const agentHooks_1 = require("../../agentHooks");
  * }
  * ```
  */
-exports.useAuthState = agentHooks_1.AgentHooks.useAuthState;
+exports.useAuthState = hooks_1.AgentHooks.useAuthState;

package/dist/{provider/hooks → hooks}/agent/useUserPrincipal.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useUserPrincipal = void 0;
-const agentHooks_1 = require("../../agentHooks");
+const hooks_1 = require("./hooks");
 /**
  * Accesses the user's principal.
  *
@@ -18,4 +18,4 @@ const agentHooks_1 = require("../../agentHooks");
  * }
  * ```
  */
-exports.useUserPrincipal = agentHooks_1.AgentHooks.useUserPrincipal;
+exports.useUserPrincipal = hooks_1.AgentHooks.useUserPrincipal;

package/dist/{provider/hooks → hooks}/types.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="react" />
 import type { IDL } from "@dfinity/candid";
-import { AgentContext } from "../types";
-import { ActorHooksReturnType, ActorManagerParameters, BaseActor } from "../../types";
+import { AgentContext } from "../context/types";
+import { ActorHooksReturnType, ActorManagerParameters, BaseActor } from "../types";
 export interface UseActorParameters extends Omit<ActorManagerParameters, "idlFactory" | "agentManager" | "canisterId"> {
     canisterId: string;
     idlFactory?: IDL.InterfaceFactory;

package/dist/hooks/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/{provider/hooks → hooks}/useActor.d.ts

@@ -1,4 +1,4 @@
-import type { BaseActor } from "../../types";
+import type { BaseActor } from "../types";
 import type { UseActorParameters, UseActorReturn } from "./types";
 /**
  * A comprehensive hook that manages both the fetching of Candid interfaces

package/dist/{provider/hooks → hooks}/useActor.js

@@ -24,7 +24,7 @@ exports.useActor = void 0;
 const core_1 = require("@ic-reactor/core");
 const react_1 = require("react");
 const useAgentManager_1 = require("./agent/useAgentManager");
-const helpers_1 = require("../../helpers");
+const helpers_1 = require("../helpers");
 /**
  * A comprehensive hook that manages both the fetching of Candid interfaces
  * and the initialization of actor stores for Internet Computer (IC) canisters.
@@ -95,8 +95,8 @@ const useActor = (config) => {
         fetchError: null,
     });
     const agentManager = (0, useAgentManager_1.useAgentManager)(agentContext);
-    const fetchCandid = (0, react_1.useCallback)(() => __awaiter(void 0, void 0, void 0, function* () {
-        if (!canisterId)
+    const fetchCandid = (0, react_1.useCallback)((agent) => __awaiter(void 0, void 0, void 0, function* () {
+        if (!canisterId || fetching)
             return;
         setState({
             idlFactory: undefined,
@@ -105,7 +105,7 @@ const useActor = (config) => {
         });
         try {
             const candidManager = (0, core_1.createCandidAdapter)({
-                agentManager,
+                agent,
                 didjsCanisterId,
             });
             const { idlFactory } = yield candidManager.getCandidDefinition(canisterId);
@@ -125,13 +125,9 @@ const useActor = (config) => {
                 fetching: false,
             });
         }
-    }), [canisterId, didjsCanisterId, agentManager]);
+    }), [canisterId, didjsCanisterId]);
     // Automatically fetch Candid if not already fetched or provided.
-    (0, react_1.useEffect)(() => {
-        if (!fetching && !idlFactory) {
-            fetchCandid();
-        }
-    }, [fetchCandid]);
+    (0, react_1.useEffect)(() => agentManager.subscribeAgent(fetchCandid, !maybeIdlFactory), [fetchCandid, agentManager]);
     const hooks = (0, react_1.useMemo)(() => {
         if (!idlFactory)
             return null;
@@ -139,7 +135,7 @@ const useActor = (config) => {
             idlFactory,
             canisterId }, actorConfig));
         return (0, helpers_1.actorHooks)(actorManager);
-    }, [idlFactory]);
+    }, [canisterId, idlFactory]);
     return { hooks, fetching, fetchError };
 };
 exports.useActor = useActor;

package/dist/index.d.ts

@@ -1,5 +1,9 @@
-export * from "./main";
-export * from "./provider";
+export * from "./createReactor";
+export * from "./context/actor";
+export * from "./context/agent";
+export * from "./provider/actor";
+export * from "./provider/agent";
+export * from "./hooks";
 export * as helpers from "./helpers";
 export * as types from "./types";
 export * as core from "./core";

package/dist/index.js

@@ -27,8 +27,12 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.core = exports.types = exports.helpers = void 0;
-__exportStar(require("./main"), exports);
-__exportStar(require("./provider"), exports);
+__exportStar(require("./createReactor"), exports);
+__exportStar(require("./context/actor"), exports);
+__exportStar(require("./context/agent"), exports);
+__exportStar(require("./provider/actor"), exports);
+__exportStar(require("./provider/agent"), exports);
+__exportStar(require("./hooks"), exports);
 exports.helpers = __importStar(require("./helpers"));
 exports.types = __importStar(require("./types"));
 exports.core = __importStar(require("./core"));

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

@@ -23,4 +23,4 @@
  * ```
  * This setup ensures that `YourComponent` and any of its children can interact with the specified IC actor through the context provided by `ActorProvider`.
  */
-export declare const ActorProvider: import("react").FC<import("./types").ActorProviderProps>;
+export declare const ActorProvider: import("react").FC<import("../types").ActorProviderProps>;

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActorProvider = void 0;
-const actorHooks_1 = require("./actorHooks");
+const hooks_1 = require("../hooks/actor/hooks");
 /**
  * `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.
@@ -26,4 +26,4 @@ const actorHooks_1 = require("./actorHooks");
  * ```
  * 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 = actorHooks_1.ActorHooks.ActorProvider;
+exports.ActorProvider = hooks_1.ActorHooks.ActorProvider;

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

@@ -26,4 +26,4 @@
  * 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.
  */
-export declare const AgentProvider: import("react").FC<import("./types").AgentProviderProps>;
+export declare const AgentProvider: import("react").FC<import("../types").AgentProviderProps>;

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentProvider = void 0;
-const agentHooks_1 = require("./agentHooks");
+const hooks_1 = require("../hooks/agent/hooks");
 /**
  * `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.
@@ -29,4 +29,4 @@ const agentHooks_1 = require("./agentHooks");
  * 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 = agentHooks_1.AgentHooks.AgentProvider;
+exports.AgentProvider = hooks_1.AgentHooks.AgentProvider;

package/dist/types.d.ts

@@ -6,6 +6,7 @@ export interface CreateReactorReturnType<A> extends ActorHooksReturnType<A>, Aut
     getAgent: () => HttpAgent;
     getVisitFunction: () => VisitService<A>;
 }
-export * from "./provider/types";
+export * from "./context/types";
 export * from "./helpers/types";
+export * from "./hooks/types";
 export * from "@ic-reactor/core/dist/types";

package/dist/types.js

@@ -14,6 +14,7 @@ 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("./provider/types"), exports);
+__exportStar(require("./context/types"), exports);
 __exportStar(require("./helpers/types"), exports);
+__exportStar(require("./hooks/types"), exports);
 __exportStar(require("@ic-reactor/core/dist/types"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ic-reactor/react",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "A React library for interacting with Internet Computer canisters",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -35,7 +35,7 @@
     "node": ">=10"
   },
   "dependencies": {
-    "@ic-reactor/core": "^1.0.5",
+    "@ic-reactor/core": "^1.0.6",
     "zustand-utils": "^1.3"
   },
   "peerDependencies": {
@@ -48,5 +48,5 @@
     "react": ">=16.8",
     "zustand": "4.5"
   },
-  "gitHead": "c52ec12bc91d5a0e2c5fc7c6e163530a1aa5e47f"
+  "gitHead": "bf69ae06def96cd40814a72535325f7c7a8a6b5a"
 }

package/dist/main.d.ts

@@ -1,38 +0,0 @@
-import type { BaseActor, CreateReactorParameters, CreateReactorReturnType } from "./types";
-/**
- * Initializes and configures the reactor environment for interacting with the Internet Computer (IC) blockchain within a React application.
- * It encapsulates the creation of actors, authentication, and agent management, offering a streamlined interface for blockchain interactions.
- *
- * @param config Configuration config for the reactor, including:
- *  - withProcessEnv (optional): Specifies whether to use process environment variables to determine if the environment is local or development. Defaults to false.
- *  - isLocalEnv (optional): Indicates if the current environment is local or development, influencing the agent and actor behavior. Useful for testing or development.
- *  - port (optional): Port number for the local or development environment.
- *  Extends `CreateReactorStoreParameters` which includes HTTP agent config, actor manager config (excluding `agentManager`), and an optional custom agent manager.
- *
- * @returns An object containing various hooks and utilities:
- *  - getAgent: Function to retrieve the configured IC agent.
- *  - getVisitFunction: Function to access the visit function from the actor manager, used for visitor pattern implementations.
- *  - Includes actor, auth, and agent hooks for state management, authentication, and agent operations.
- *
- * @example
- * ```typescript
- * import { createReactor } from "@ic-reactor/react";
- * import type { CreateReactorCoreParameters } from "@ic-reactor/react/dist/types";
- * import { canisterId, idlFactory, yourActor } from "./declaration/yourActor"
- *
- * const config: CreateReactorCoreParameters = {
- *   canisterId,
- *   idlFactory,
- *   host: "https://localhost:8000", // IC network host         |
- *   isLocalEnv: true, // Set true for local network            | one of these
- *   withProcessEnv: true, // Use process.env to determine host |
- *   port: 8000, // Port number for local network               |
- * };
- *
- * export type YourActor = typeof yourActor;
- *
- * export const { useAuth, useQueryCall, useUpdateCall } = createReactor<YourActor>(config);
- * // Now you can use the returned hooks in your React components
- * ```
- */
-export declare const createReactor: <A = BaseActor>(config: CreateReactorParameters) => CreateReactorReturnType<A>;

package/dist/main.js

@@ -1,53 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createReactor = void 0;
-const core_1 = require("@ic-reactor/core");
-const helpers_1 = require("./helpers");
-/**
- * Initializes and configures the reactor environment for interacting with the Internet Computer (IC) blockchain within a React application.
- * It encapsulates the creation of actors, authentication, and agent management, offering a streamlined interface for blockchain interactions.
- *
- * @param config Configuration config for the reactor, including:
- *  - withProcessEnv (optional): Specifies whether to use process environment variables to determine if the environment is local or development. Defaults to false.
- *  - isLocalEnv (optional): Indicates if the current environment is local or development, influencing the agent and actor behavior. Useful for testing or development.
- *  - port (optional): Port number for the local or development environment.
- *  Extends `CreateReactorStoreParameters` which includes HTTP agent config, actor manager config (excluding `agentManager`), and an optional custom agent manager.
- *
- * @returns An object containing various hooks and utilities:
- *  - getAgent: Function to retrieve the configured IC agent.
- *  - getVisitFunction: Function to access the visit function from the actor manager, used for visitor pattern implementations.
- *  - Includes actor, auth, and agent hooks for state management, authentication, and agent operations.
- *
- * @example
- * ```typescript
- * import { createReactor } from "@ic-reactor/react";
- * import type { CreateReactorCoreParameters } from "@ic-reactor/react/dist/types";
- * import { canisterId, idlFactory, yourActor } from "./declaration/yourActor"
- *
- * const config: CreateReactorCoreParameters = {
- *   canisterId,
- *   idlFactory,
- *   host: "https://localhost:8000", // IC network host         |
- *   isLocalEnv: true, // Set true for local network            | one of these
- *   withProcessEnv: true, // Use process.env to determine host |
- *   port: 8000, // Port number for local network               |
- * };
- *
- * export type YourActor = typeof yourActor;
- *
- * export const { useAuth, useQueryCall, useUpdateCall } = createReactor<YourActor>(config);
- * // Now you can use the returned hooks in your React components
- * ```
- */
-const createReactor = (config) => {
-    const actorManager = (0, core_1.createReactorStore)(config);
-    const getVisitFunction = () => {
-        return actorManager.visitFunction;
-    };
-    const getAgent = () => {
-        return actorManager.agentManager.getAgent();
-    };
-    return Object.assign(Object.assign(Object.assign({ getAgent,
-        getVisitFunction }, (0, helpers_1.actorHooks)(actorManager)), (0, helpers_1.authHooks)(actorManager.agentManager)), (0, helpers_1.agentHooks)(actorManager.agentManager));
-};
-exports.createReactor = createReactor;

package/dist/provider/actorHooks.d.ts

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

package/dist/provider/agentHooks.d.ts

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

package/dist/provider/index.d.ts

@@ -1,5 +0,0 @@
-export { createActorContext } from "./context/actor";
-export { createAgentContext } from "./context/agent";
-export * from "./hooks";
-export * from "./ActorProvider";
-export * from "./AgentProvider";

package/dist/provider/index.js

@@ -1,24 +0,0 @@
-"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 });
-exports.createAgentContext = exports.createActorContext = void 0;
-var actor_1 = require("./context/actor");
-Object.defineProperty(exports, "createActorContext", { enumerable: true, get: function () { return actor_1.createActorContext; } });
-var agent_1 = require("./context/agent");
-Object.defineProperty(exports, "createAgentContext", { enumerable: true, get: function () { return agent_1.createAgentContext; } });
-__exportStar(require("./hooks"), exports);
-__exportStar(require("./ActorProvider"), exports);
-__exportStar(require("./AgentProvider"), exports);

package/dist/provider/types.js

@@ -1,17 +0,0 @@
-"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("./hooks/types"), exports);