@ic-reactor/react 1.3.1 → 1.3.3

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

@@ -4,3 +4,4 @@ export * from "./useAgentManager";
 export * from "./useAuth";
 export * from "./useAuthState";
 export * from "./useUserPrincipal";
+export * from "./useCandidAdapter";

package/dist/hooks/agent/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./useAgentManager"), exports);
 __exportStar(require("./useAuth"), exports);
 __exportStar(require("./useAuthState"), exports);
 __exportStar(require("./useUserPrincipal"), exports);
+__exportStar(require("./useCandidAdapter"), exports);

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

@@ -0,0 +1,30 @@
+/// <reference types="react" />
+import { CandidAdapter } from "@ic-reactor/core/dist/classes";
+import { AgentContext } from "../../types";
+export interface UseCandidAdapterParams {
+    agentContext?: React.Context<AgentContext | null>;
+    didjsCanisterId?: string;
+}
+/**
+ * Accesses the `CandidAdapter` to download the actor's Candid interface.
+ *
+ * @param config - `UseCandidAdapterParams` The configuration object.
+ * @returns The `CandidAdapter` instance.
+ *
+ * @example
+ * ```jsx
+ * function CandidAdapterComponent() {
+ *   const candidAdapter = useCandidAdapter();
+ *
+ *   const getActor = async () => {
+ *      const { idlFactory } = await candidAdapter.getCandidDefinition(canisterId)
+ *      console.log(idlFactory)
+ *   }
+ *
+ *   return (
+ *       <button onClick={getActor}>Get Actor</button>
+ *   );
+ * }
+ *```
+ */
+export declare const useCandidAdapter: (config: UseCandidAdapterParams) => CandidAdapter | undefined;

package/dist/hooks/agent/useCandidAdapter.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCandidAdapter = void 0;
+const useAgentManager_1 = require("./useAgentManager");
+const react_1 = require("react");
+const core_1 = require("@ic-reactor/core");
+/**
+ * Accesses the `CandidAdapter` to download the actor's Candid interface.
+ *
+ * @param config - `UseCandidAdapterParams` The configuration object.
+ * @returns The `CandidAdapter` instance.
+ *
+ * @example
+ * ```jsx
+ * function CandidAdapterComponent() {
+ *   const candidAdapter = useCandidAdapter();
+ *
+ *   const getActor = async () => {
+ *      const { idlFactory } = await candidAdapter.getCandidDefinition(canisterId)
+ *      console.log(idlFactory)
+ *   }
+ *
+ *   return (
+ *       <button onClick={getActor}>Get Actor</button>
+ *   );
+ * }
+ *```
+ */
+const useCandidAdapter = (config) => {
+    const [candidAdapter, setCandidAdapter] = (0, react_1.useState)();
+    const agentManager = (0, useAgentManager_1.useAgentManager)(config.agentContext);
+    (0, react_1.useEffect)(() => {
+        const agent = agentManager.getAgent();
+        try {
+            const candidManager = (0, core_1.createCandidAdapter)({
+                agent,
+                didjsCanisterId: config.didjsCanisterId,
+            });
+            setCandidAdapter(candidManager);
+        }
+        catch (error) {
+            // eslint-disable-next-line no-console
+            console.error("Error creating CandidAdapter", error);
+        }
+    }, [agentManager, config.didjsCanisterId]);
+    return candidAdapter;
+};
+exports.useCandidAdapter = useCandidAdapter;

package/dist/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/hooks/useActor.js

@@ -26,6 +26,7 @@ const react_1 = require("react");
 const useAgentManager_1 = require("./agent/useAgentManager");
 const helpers_1 = require("../helpers");
 const agent_1 = require("./agent");
+const useCandidAdapter_1 = require("./agent/useCandidAdapter");
 /**
  * A comprehensive hook that manages both the fetching of Candid interfaces
  * and the initialization of actor stores for Internet Computer (IC) canisters.
@@ -93,27 +94,31 @@ const useActor = (config) => {
     if (!canisterId) {
         throw new Error("canisterId is required");
     }
-    const [actorManager, setActorManager] = (0, react_1.useState)();
+    const [actorManager, setActorManager] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        if ((actorManager === null || actorManager === void 0 ? void 0 : actorManager.canisterId) !== canisterId) {
+            setActorManager(null);
+        }
+        return actorManager === null || actorManager === void 0 ? void 0 : actorManager.cleanup();
+    }, [canisterId, actorManager]);
     const [{ fetching, fetchError }, setState] = (0, react_1.useState)({
         fetching: false,
         fetchError: null,
     });
-    const agentManager = (0, useAgentManager_1.useAgentManager)(agentContext);
+    const candidAdapter = (0, useCandidAdapter_1.useCandidAdapter)({
+        agentContext,
+        didjsCanisterId,
+    });
     const authenticating = (0, agent_1.useAuthState)().authenticating;
     const fetchCandid = (0, react_1.useCallback)(() => __awaiter(void 0, void 0, void 0, function* () {
-        if (fetching || authenticating)
+        if (fetching || authenticating || !candidAdapter)
             return;
         setState({
             fetching: true,
             fetchError: null,
         });
-        const agent = agentManager.getAgent();
         try {
-            const candidManager = (0, core_1.createCandidAdapter)({
-                agent,
-                didjsCanisterId,
-            });
-            const { idlFactory } = yield candidManager.getCandidDefinition(canisterId);
+            const { idlFactory } = yield candidAdapter.getCandidDefinition(canisterId);
             setState({
                 fetching: false,
                 fetchError: null,
@@ -128,28 +133,27 @@ const useActor = (config) => {
                 fetching: false,
             });
         }
-    }), [canisterId, authenticating, didjsCanisterId]);
+    }), [canisterId, candidAdapter, authenticating, didjsCanisterId]);
+    const agentManager = (0, useAgentManager_1.useAgentManager)(agentContext);
     const initialActorManager = (0, react_1.useCallback)((idlFactory) => {
         if (authenticating)
             return;
         const actorManager = (0, core_1.createActorManager)(Object.assign({ agentManager,
             idlFactory,
             canisterId }, actorConfig));
-        setActorManager(() => actorManager);
+        setActorManager(actorManager);
     }, [canisterId, agentManager, authenticating]);
     (0, react_1.useEffect)(() => {
         if (maybeIdlFactory) {
             initialActorManager(maybeIdlFactory);
         }
         else {
-            setActorManager(undefined);
             fetchCandid().then((idlFactory) => {
                 if (!idlFactory)
                     return;
                 initialActorManager(idlFactory);
             });
         }
-        return actorManager === null || actorManager === void 0 ? void 0 : actorManager.cleanup();
     }, [fetchCandid, maybeIdlFactory, initialActorManager]);
     const hooks = (0, react_1.useMemo)(() => {
         if (!actorManager)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ic-reactor/react",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "A React library for interacting with Internet Computer canisters",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,5 +47,5 @@
     "react": ">=16.8",
     "zustand": "4.5"
   },
-  "gitHead": "05130e2581edfafd6390cf04ba618cb084bafc31"
+  "gitHead": "a471daafc519bd06902e773058748241c1f0331b"
 }