@ic-reactor/react 1.0.0 → 1.0.2

package/README.md

@@ -1,5 +1,3 @@
-# IC-ReActor - React
-
 `@ic-reactor/react` is a comprehensive React library designed to streamline interactions with the Internet Computer (IC) blockchain. It provides React hooks and utilities for efficient state management, authentication, and interaction with IC actors.
 
 ## Features
@@ -33,12 +31,12 @@ First, create an actor declaration file:
 ```ts
 // store.ts
 import { canisterId, idlFactory, actor } from "declaration/actor"
-import { createReActor } from "@ic-reactor/react"
+import { createReactor } from "@ic-reactor/react"
 
 type Actor = typeof actor
 
 export const { useActorStore, useAuthClient, useQueryCall } =
-  createReActor<Actor>({
+  createReactor<Actor>({
     canisterId: "rrkah-fqaaa-aaaaa-aaaaq-cai",
     idlFactory,
     host: "https://localhost:4943",
@@ -131,24 +129,3 @@ const Login = () => {
 
 export default Login
 ```
-
-## API Reference
-
-The library provides various hooks and utilities for interacting with IC actors:
-
-- `useActorStore`: Hook for managing actor states.
-- `useAuthStore` Hook for managing authentication states.
-- `useAuthClient`: Hook for managing authentication with the IC blockchain.
-- `useQueryCall`: Hook for querying data from an actor.
-- `useUpdateCall`: Hook for updating data in an actor.
-- Additional hooks for handling loading, errors, authentication, and more.
-
-For detailed API usage and options, please refer to the [documentation](#).
-
-## Contributing
-
-Contributions to `@ic-reactor/react` are welcome! Please read our [contributing guidelines](#) for more information.
-
-## License
-
-`@ic-reactor/react` is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.

package/dist/context/actor/index.d.ts

@@ -1,8 +1,9 @@
 import React from "react";
 import { ActorUseMethodCallArg, ActorUseQueryArgs, ActorUseUpdateArgs } from "../../types";
 import { CreateActorOptions, ActorContextType, ActorProviderProps } from "./types";
-export * from "./types";
-export declare const createReActorContext: <Actor extends unknown>({ canisterId: defaultCanisterId, ...defaultConfig }?: Partial<CreateActorOptions>) => {
+import type { ActorSubclass } from "@dfinity/agent";
+export declare const ActorContext: React.Context<ActorContextType | null>, ActorProvider: React.FC<ActorProviderProps>, useActorContext: <A extends unknown = unknown>() => ActorContextType<A>, useActorState: () => import("../../types").UseActorStoreReturn<unknown>, useQueryCall: <M extends never>(args: ActorUseQueryArgs<unknown, M>) => import("../../types").ActorCallReturn<unknown, M>, useUpdateCall: <M extends never>(args: ActorUseUpdateArgs<unknown, M>) => import("../../types").ActorCallReturn<unknown, M>, useMethodCall: <M extends never>(args: ActorUseMethodCallArg<unknown, M>) => import("../../types").ActorUseMethodCallReturn<unknown, M, true>, useVisitMethod: (functionName: never) => never;
+export declare function createReactorContext<Actor extends ActorSubclass<any>>({ canisterId: defaultCanisterId, ...defaultConfig }?: Partial<CreateActorOptions>): {
     ActorContext: React.Context<ActorContextType | null>;
     ActorProvider: React.FC<ActorProviderProps>;
     useActorContext: <A extends unknown = Actor>() => ActorContextType<A>;
@@ -10,7 +11,6 @@ export declare const createReActorContext: <Actor extends unknown>({ canisterId:
     useQueryCall: <M extends keyof Actor & string>(args: ActorUseQueryArgs<Actor, M>) => import("../../types").ActorCallReturn<Actor, M>;
     useUpdateCall: <M_1 extends keyof Actor & string>(args: ActorUseUpdateArgs<Actor, M_1>) => import("../../types").ActorCallReturn<Actor, M_1>;
     useMethodCall: <M_2 extends keyof Actor & string>(args: ActorUseMethodCallArg<Actor, M_2>) => import("../../types").ActorUseMethodCallReturn<Actor, M_2, true>;
-    useVisitMethod: (functionName: keyof Actor & string) => import("@ic-reactor/core").VisitService<Actor>[keyof Actor & string];
+    useVisitMethod: (functionName: keyof Actor & string) => import("@ic-reactor/core/dist/actor/types").VisitService<Actor>[keyof Actor & string];
     initialize: () => Promise<void>;
 };
-export declare const ActorContext: React.Context<ActorContextType | null>, ActorProvider: React.FC<ActorProviderProps>, useActorContext: <A extends unknown = unknown>() => ActorContextType<A>, useActorState: () => import("../../types").UseActorStoreReturn<unknown>, useQueryCall: <M extends never>(args: ActorUseQueryArgs<unknown, M>) => import("../../types").ActorCallReturn<unknown, M>, useUpdateCall: <M extends never>(args: ActorUseUpdateArgs<unknown, M>) => import("../../types").ActorCallReturn<unknown, M>, useMethodCall: <M extends never>(args: ActorUseMethodCallArg<unknown, M>) => import("../../types").ActorUseMethodCallReturn<unknown, M, true>, useVisitMethod: (functionName: never) => never;

package/dist/context/actor/index.js

@@ -22,9 +22,6 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-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);
-};
 var __rest = (this && this.__rest) || function (s, e) {
     var t = {};
     for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
@@ -38,13 +35,13 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useVisitMethod = exports.useMethodCall = exports.useUpdateCall = exports.useQueryCall = exports.useActorState = exports.useActorContext = exports.ActorProvider = exports.ActorContext = exports.createReActorContext = void 0;
+exports.createReactorContext = exports.useVisitMethod = exports.useMethodCall = exports.useUpdateCall = exports.useQueryCall = exports.useActorState = exports.useActorContext = exports.ActorProvider = exports.ActorContext = void 0;
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const react_1 = __importStar(require("react"));
-const actor_1 = require("../../hooks/actor");
+const actor_1 = require("../../helpers/actor");
 const useActor_1 = require("../../hooks/useActor");
-__exportStar(require("./types"), exports);
-const createReActorContext = (_a = {}) => {
+_a = createReactorContext(), exports.ActorContext = _a.ActorContext, exports.ActorProvider = _a.ActorProvider, exports.useActorContext = _a.useActorContext, exports.useActorState = _a.useActorState, exports.useQueryCall = _a.useQueryCall, exports.useUpdateCall = _a.useUpdateCall, exports.useMethodCall = _a.useMethodCall, exports.useVisitMethod = _a.useVisitMethod;
+function createReactorContext(_a = {}) {
     var { canisterId: defaultCanisterId } = _a, defaultConfig = __rest(_a, ["canisterId"]);
     const ActorContext = (0, react_1.createContext)(null);
     const ActorProvider = (_a) => {
@@ -87,6 +84,5 @@ const createReActorContext = (_a = {}) => {
         useVisitMethod,
         initialize,
     };
-};
-exports.createReActorContext = createReActorContext;
-_a = (0, exports.createReActorContext)(), exports.ActorContext = _a.ActorContext, exports.ActorProvider = _a.ActorProvider, exports.useActorContext = _a.useActorContext, exports.useActorState = _a.useActorState, exports.useQueryCall = _a.useQueryCall, exports.useUpdateCall = _a.useUpdateCall, exports.useMethodCall = _a.useMethodCall, exports.useVisitMethod = _a.useVisitMethod;
+}
+exports.createReactorContext = createReactorContext;

package/dist/context/actor/types.d.ts

@@ -1,14 +1,13 @@
 /// <reference types="react" />
 import { IDL } from "@dfinity/candid";
-import { ActorManagerOptions, BaseActor } from "@ic-reactor/core";
-import { AgentContextType } from "../agent";
-import { ActorHooks } from "../../types";
+import { ActorManagerOptions, BaseActor } from "@ic-reactor/core/dist/types";
+import { ActorHooks, AgentContextType } from "../../types";
 export type ActorContextType<Actor = BaseActor, F extends boolean = true> = ActorHooks<Actor, F> & {
     ActorContext: React.Context<ActorContextType<Actor, F> | null>;
     useActorContext: <A = Actor>() => ActorContextType<A>;
     ActorProvider: React.FC<ActorProviderProps>;
 };
-export type CreateReActorContext = {
+export type CreateReactorContext = {
     <A = BaseActor>(options?: Partial<CreateActorOptions> & {
         withVisitor: true;
     }): ActorContextType<A, true>;

package/dist/context/agent/context.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+import type { AgentManagerOptions } from "@ic-reactor/core/dist/types";
+import type { AgentContextValue, AgentProviderProps } from "./types";
+export declare const AgentContext: React.Context<AgentContextValue | null>;
+declare const AgentProvider: React.FC<AgentProviderProps>;
+export { AgentProvider };
+export declare const createAgentContext: (config: AgentManagerOptions) => AgentContextValue;

package/dist/context/agent/context.js

@@ -0,0 +1,56 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentContext = exports.AgentProvider = exports.AgentContext = void 0;
+const react_1 = __importStar(require("react"));
+const core_1 = require("@ic-reactor/core");
+const agent_1 = require("../../helpers/agent");
+const auth_1 = require("../../helpers/auth");
+exports.AgentContext = (0, react_1.createContext)(null);
+const AgentProvider = (_a) => {
+    var { children } = _a, config = __rest(_a, ["children"]);
+    const value = (0, react_1.useMemo)(() => (0, exports.createAgentContext)(config), [config]);
+    return react_1.default.createElement(exports.AgentContext.Provider, { value: value }, children);
+};
+exports.AgentProvider = AgentProvider;
+AgentProvider.displayName = "AgentProvider";
+const createAgentContext = (config) => {
+    const agentManager = (0, core_1.createAgentManager)(config);
+    const agenthooks = (0, agent_1.getAgentHooks)(agentManager);
+    const authHooks = (0, auth_1.getAuthHooks)(agentManager);
+    return Object.assign(Object.assign(Object.assign({}, agenthooks), authHooks), { agentManager });
+};
+exports.createAgentContext = createAgentContext;

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

@@ -1,4 +1,24 @@
-import { AgentManager, HttpAgent } from "@ic-reactor/core";
-import { AgentContextType } from "./types";
+import { AgentManager } from "@ic-reactor/core/dist/agent";
+import type { AgentContextType } from "./types";
+import { AuthArgs } from "../../types";
+export declare const useAgentManagerContext: (agentContext?: AgentContextType) => import("./types").AgentContextValue;
 export declare const useAgentManager: (agentContext?: AgentContextType) => AgentManager;
-export declare const useAgentContext: (agentContext?: AgentContextType) => HttpAgent | undefined;
+export declare const useAgent: (agentContext?: AgentContextType) => import("@dfinity/agent/lib/cjs/agent/http").HttpAgent | undefined;
+export declare const useAuthState: (agentContext?: AgentContextType) => import("@ic-reactor/core/dist/agent/types").AuthState;
+export declare const useAgentState: (agentContext?: AgentContextType) => import("@ic-reactor/core/dist/agent/types").AgentState;
+export declare const useAuthClient: ({ agentContext, ...args }: AuthArgs & {
+    agentContext?: AgentContextType | undefined;
+}) => {
+    authClient: import("@dfinity/auth-client").AuthClient | null;
+    authenticated: boolean;
+    authenticating: boolean;
+    identity: import("@dfinity/agent/lib/cjs/auth").Identity | null;
+    login: (options?: import("@dfinity/auth-client").AuthClientLoginOptions | undefined) => Promise<void>;
+    logout: (options?: {
+        returnTo?: string | undefined;
+    } | undefined) => Promise<void>;
+    authenticate: () => Promise<import("@dfinity/agent/lib/cjs/auth").Identity>;
+    loginLoading: boolean;
+    loginError: Error | null;
+};
+export declare const useUserPrincipal: (agentContext?: AgentContextType) => import("@dfinity/principal").Principal | undefined;

package/dist/context/agent/hooks.js

@@ -1,17 +1,43 @@
 "use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useAgentContext = exports.useAgentManager = void 0;
+exports.useUserPrincipal = exports.useAuthClient = exports.useAgentState = exports.useAuthState = exports.useAgent = exports.useAgentManager = exports.useAgentManagerContext = void 0;
 const react_1 = require("react");
-const _1 = require(".");
+const context_1 = require("./context");
+const useAgentManagerContext = (agentContext) => {
+    const context = (0, react_1.useContext)(agentContext || context_1.AgentContext);
+    if (!context) {
+        throw new Error("Agent context must be used within a AgentProvider");
+    }
+    return context;
+};
+exports.useAgentManagerContext = useAgentManagerContext;
 const useAgentManager = (agentContext) => {
-    const context = (0, _1.useAgentManagerContext)(agentContext);
+    const context = (0, exports.useAgentManagerContext)(agentContext);
     return context.agentManager;
 };
 exports.useAgentManager = useAgentManager;
-const useAgentContext = (agentContext) => {
-    const agentManager = (0, exports.useAgentManager)(agentContext);
-    const [agent, setAgent] = (0, react_1.useState)(agentManager.getAgent());
-    (0, react_1.useEffect)(() => agentManager.subscribeAgent(setAgent), []);
-    return agent;
+const useAgent = (agentContext) => (0, exports.useAgentManagerContext)(agentContext).useAgent();
+exports.useAgent = useAgent;
+const useAuthState = (agentContext) => (0, exports.useAgentManagerContext)(agentContext).useAuthState();
+exports.useAuthState = useAuthState;
+const useAgentState = (agentContext) => (0, exports.useAgentManagerContext)(agentContext).useAgentState();
+exports.useAgentState = useAgentState;
+const useAuthClient = (_a) => {
+    var { agentContext } = _a, args = __rest(_a, ["agentContext"]);
+    const context = (0, exports.useAgentManagerContext)(agentContext);
+    return context.useAuthClient(args);
 };
-exports.useAgentContext = useAgentContext;
+exports.useAuthClient = useAuthClient;
+const useUserPrincipal = (agentContext) => (0, exports.useAgentManagerContext)(agentContext).useUserPrincipal();
+exports.useUserPrincipal = useUserPrincipal;

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

@@ -1,10 +1,2 @@
-import React from "react";
-import { AgentManagerOptions } from "@ic-reactor/core";
-import { AgentContextValue, AgentContextType, AgentProviderProps } from "./types";
-export * from "./types";
+export * from "./context";
 export * from "./hooks";
-export declare const AgentManagerContext: React.Context<AgentContextValue | null>;
-export declare const useAgentManagerContext: (agentContext?: AgentContextType) => AgentContextValue;
-export declare const createAgentContext: (config: AgentManagerOptions) => AgentContextValue;
-declare const AgentProvider: React.FC<AgentProviderProps>;
-export { AgentProvider };

package/dist/context/agent/index.js

@@ -10,60 +10,9 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 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);
 };
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentProvider = exports.createAgentContext = exports.useAgentManagerContext = exports.AgentManagerContext = void 0;
-const react_1 = __importStar(require("react"));
-const core_1 = require("@ic-reactor/core");
-const agent_1 = require("../../hooks/agent");
-const auth_1 = require("../../hooks/auth");
-__exportStar(require("./types"), exports);
+__exportStar(require("./context"), exports);
 __exportStar(require("./hooks"), exports);
-exports.AgentManagerContext = (0, react_1.createContext)(null);
-const useAgentManagerContext = (agentContext) => {
-    const context = (0, react_1.useContext)(agentContext || exports.AgentManagerContext);
-    if (!context) {
-        throw new Error("Agent context must be used within a AgentProvider");
-    }
-    return context;
-};
-exports.useAgentManagerContext = useAgentManagerContext;
-const createAgentContext = (config) => {
-    const agentManager = (0, core_1.createAgentManager)(config);
-    const agenthooks = (0, agent_1.getAgentHooks)(agentManager);
-    const authHooks = (0, auth_1.getAuthHooks)(agentManager);
-    return Object.assign(Object.assign(Object.assign({}, agenthooks), authHooks), { agentManager });
-};
-exports.createAgentContext = createAgentContext;
-const AgentProvider = (_a) => {
-    var { children } = _a, config = __rest(_a, ["children"]);
-    const value = (0, react_1.useMemo)(() => (0, exports.createAgentContext)(config), [config]);
-    return (react_1.default.createElement(exports.AgentManagerContext.Provider, { value: value }, children));
-};
-exports.AgentProvider = AgentProvider;
-AgentProvider.displayName = "AgentProvider";

package/dist/context/agent/types.d.ts

@@ -1,7 +1,8 @@
 import React, { PropsWithChildren } from "react";
-import { AgentManager, AgentManagerOptions } from "@ic-reactor/core";
-import { getAuthHooks } from "../../hooks/auth";
-import { getAgentHooks } from "../../hooks/agent";
+import type { AgentManagerOptions } from "@ic-reactor/core/dist/types";
+import type { AgentManager } from "@ic-reactor/core/dist/agent";
+import type { getAuthHooks } from "../../helpers/auth";
+import type { getAgentHooks } from "../../helpers/agent";
 export type AgentContextValue = ReturnType<typeof getAuthHooks> & ReturnType<typeof getAgentHooks> & {
     agentManager: AgentManager;
 };

package/dist/core.d.ts

@@ -0,0 +1 @@
+export { createReactorStore, createActorManager, createAgentManager, createCandidAdapter, } from "@ic-reactor/core";

package/dist/core.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCandidAdapter = exports.createAgentManager = exports.createActorManager = exports.createReactorStore = void 0;
+var core_1 = require("@ic-reactor/core");
+Object.defineProperty(exports, "createReactorStore", { enumerable: true, get: function () { return core_1.createReactorStore; } });
+Object.defineProperty(exports, "createActorManager", { enumerable: true, get: function () { return core_1.createActorManager; } });
+Object.defineProperty(exports, "createAgentManager", { enumerable: true, get: function () { return core_1.createAgentManager; } });
+Object.defineProperty(exports, "createCandidAdapter", { enumerable: true, get: function () { return core_1.createCandidAdapter; } });

package/dist/{hooks → helpers}/actor.d.ts

@@ -1,3 +1,3 @@
 import { ActorHooks } from "../types";
-import { ActorManager } from "@ic-reactor/core";
+import type { ActorManager } from "@ic-reactor/core/dist/actor";
 export declare const getActorHooks: <A>({ initialize, canisterId, actorStore, callMethod, visitFunction, }: ActorManager<A>) => ActorHooks<A, true>;

package/dist/{hooks → helpers}/actor.js

@@ -43,7 +43,7 @@ const getActorHooks = ({ initialize, canisterId, actorStore, callMethod, visitFu
             return serviceFields[functionName];
         }, [functionName, serviceFields]);
     };
-    const useReActorCall = ({ onError, onSuccess, onLoading, args = [], functionName, throwOnError = false, }) => {
+    const useReactorCall = ({ onError, onSuccess, onLoading, args = [], functionName, throwOnError = false, }) => {
         const [state, setState] = (0, react_1.useState)(DEFAULT_STATE);
         const reset = (0, react_1.useCallback)(() => setState(DEFAULT_STATE), []);
         const call = (0, react_1.useCallback)((eventOrReplaceArgs) => __awaiter(void 0, void 0, void 0, function* () {
@@ -75,7 +75,7 @@ const getActorHooks = ({ initialize, canisterId, actorStore, callMethod, visitFu
     };
     const useQueryCall = (_a) => {
         var { refetchOnMount = true, refetchInterval = false } = _a, rest = __rest(_a, ["refetchOnMount", "refetchInterval"]);
-        const _b = useReActorCall(rest), { call } = _b, state = __rest(_b, ["call"]);
+        const _b = useReactorCall(rest), { call } = _b, state = __rest(_b, ["call"]);
         const intervalId = (0, react_1.useRef)(undefined);
         (0, react_1.useEffect)(() => {
             // Auto-refresh logic
@@ -84,22 +84,23 @@ const getActorHooks = ({ initialize, canisterId, actorStore, callMethod, visitFu
                     call();
                 }, refetchInterval);
             }
-            // Initial call logic
-            if (refetchOnMount) {
-                call();
-            }
             return () => {
                 clearInterval(intervalId.current);
             };
-        }, [refetchOnMount, refetchInterval]);
+        }, [refetchInterval]);
+        (0, react_1.useLayoutEffect)(() => {
+            if (refetchOnMount) {
+                call();
+            }
+        }, []);
         return Object.assign({ call }, state);
     };
     const useUpdateCall = (args) => {
-        return useReActorCall(args);
+        return useReactorCall(args);
     };
     const useMethodCall = (args) => {
         const visit = visitFunction[args.functionName];
-        return Object.assign({ visit }, useReActorCall(args));
+        return Object.assign({ visit }, useReactorCall(args));
     };
     return {
         initialize,

package/dist/helpers/agent.d.ts

@@ -0,0 +1,6 @@
+import type { AgentManager } from "@ic-reactor/core/dist/agent";
+import type { HttpAgent } from "@ic-reactor/core/dist/types";
+export declare const getAgentHooks: (agentManager: AgentManager) => {
+    useAgent: () => HttpAgent | undefined;
+    useAgentState: () => import("@ic-reactor/core/dist/types").AgentState;
+};

package/dist/{hooks → helpers}/auth.d.ts

@@ -1,10 +1,10 @@
 import type { AuthClientLoginOptions } from "@dfinity/auth-client";
-import type { AgentManager, Identity, Principal } from "@ic-reactor/core";
+import type { Identity, Principal } from "@ic-reactor/core/dist/types";
+import type { AgentManager } from "@ic-reactor/core/dist/agent";
 import { AuthArgs } from "../types";
-export type AuthHooks = ReturnType<typeof getAuthHooks>;
 export declare const getAuthHooks: (agentManager: AgentManager) => {
     useUserPrincipal: () => Principal | undefined;
-    useAuthStore: () => import("@ic-reactor/core").AuthState;
+    useAuthState: () => import("@ic-reactor/core/dist/types").AuthState;
     useAuthClient: ({ onAuthentication, onAuthenticationSuccess, onAuthenticationFailure, onLogin, onLoginSuccess, onLoginError, onLoggedOut, }?: AuthArgs) => {
         authClient: import("@dfinity/auth-client").AuthClient | null;
         authenticated: boolean;

package/dist/{hooks → helpers}/auth.js

@@ -14,18 +14,17 @@ const react_1 = require("react");
 const zustand_1 = require("zustand");
 const getAuthHooks = (agentManager) => {
     const { authenticate: authenticator, authStore, isLocalEnv } = agentManager;
-    const useAuthStore = () => {
-        const authState = (0, zustand_1.useStore)(authStore, (state) => state);
-        return authState;
+    const useAuthState = () => {
+        return (0, zustand_1.useStore)(authStore, (state) => state);
     };
     const useUserPrincipal = () => {
-        const { identity } = useAuthStore();
+        const { identity } = useAuthState();
         return identity === null || identity === void 0 ? void 0 : identity.getPrincipal();
     };
     const useAuthClient = ({ onAuthentication, onAuthenticationSuccess, onAuthenticationFailure, onLogin, onLoginSuccess, onLoginError, onLoggedOut, } = {}) => {
         const [loginLoading, setLoginLoading] = (0, react_1.useState)(false);
         const [loginError, setLoginError] = (0, react_1.useState)(null);
-        const { authClient, authenticated, authenticating, identity } = useAuthStore();
+        const { authClient, authenticated, authenticating, identity } = useAuthState();
         const authenticate = (0, react_1.useCallback)(() => __awaiter(void 0, void 0, void 0, function* () {
             const authenticatePromise = new Promise((resolve, reject) => {
                 authenticator()
@@ -124,7 +123,7 @@ const getAuthHooks = (agentManager) => {
     };
     return {
         useUserPrincipal,
-        useAuthStore,
+        useAuthState,
         useAuthClient,
     };
 };

package/dist/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./agent";
+export * from "./actor";
+export * from "./auth";

package/dist/helpers/index.js

@@ -0,0 +1,19 @@
+"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("./agent"), exports);
+__exportStar(require("./actor"), exports);
+__exportStar(require("./auth"), exports);

package/dist/helpers/types.d.ts

@@ -0,0 +1,4 @@
+import { getAgentHooks } from "./agent";
+import { getAuthHooks } from "./auth";
+export type AgentHooks = ReturnType<typeof getAgentHooks>;
+export type AuthHooks = ReturnType<typeof getAuthHooks>;

package/dist/helpers/types.js

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

package/dist/hooks/index.d.ts

@@ -1,5 +1,2 @@
 export * from "./useActor";
 export * from "./useCandid";
-export * from "./agent";
-export * from "./actor";
-export * from "./auth";

package/dist/hooks/index.js

@@ -16,6 +16,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./useActor"), exports);
 __exportStar(require("./useCandid"), exports);
-__exportStar(require("./agent"), exports);
-__exportStar(require("./actor"), exports);
-__exportStar(require("./auth"), exports);

package/dist/hooks/useActor.d.ts

@@ -1,13 +1,19 @@
-import { ActorManagerOptions, BaseActor, IDL } from "@ic-reactor/core";
-import { AgentContextType } from "../context/agent";
+import { IDL } from "@dfinity/candid";
+import { ActorManagerOptions, BaseActor } from "@ic-reactor/core/dist/types";
+import { AgentContextType } from "../types";
 interface DynamicActorArgs extends Omit<ActorManagerOptions, "idlFactory" | "agentManager" | "canisterId"> {
     canisterId: string;
     idlFactory?: IDL.InterfaceFactory;
     agentContext?: AgentContextType;
     didjsCanisterId?: string;
 }
+/**
+ * A hook to create an actor manager and fetch the actor's candid interface.
+ *
+ * @category Hooks
+ */
 export declare const useActor: <A = BaseActor>({ canisterId, agentContext, idlFactory: maybeIdlFactory, didjsCanisterId, ...config }: DynamicActorArgs) => {
-    fetchCandid: () => Promise<import("@ic-reactor/core").CandidDefenition | undefined>;
+    fetchCandid: () => Promise<import("@ic-reactor/core/dist/types").CandidDefenition | undefined>;
     fetching: boolean;
     fetchError: string | null;
     actorManager: import("@ic-reactor/core").ActorManager<A> | null;

package/dist/hooks/useActor.js

@@ -16,6 +16,11 @@ const core_1 = require("@ic-reactor/core");
 const react_1 = require("react");
 const agent_1 = require("../context/agent");
 const useCandid_1 = require("./useCandid");
+/**
+ * A hook to create an actor manager and fetch the actor's candid interface.
+ *
+ * @category Hooks
+ */
 const useActor = (_a) => {
     var { canisterId, agentContext, idlFactory: maybeIdlFactory, didjsCanisterId } = _a, config = __rest(_a, ["canisterId", "agentContext", "idlFactory", "didjsCanisterId"]);
     const agentManager = (0, agent_1.useAgentManager)(agentContext);
@@ -29,7 +34,7 @@ const useActor = (_a) => {
             return null;
         }
         else {
-            const manager = (0, core_1.createReActorStore)({
+            const manager = (0, core_1.createReactorStore)({
                 agentManager,
                 idlFactory,
                 canisterId,

package/dist/hooks/useCandid.d.ts

@@ -5,7 +5,7 @@ interface UseIDLFactoryArgs {
     idlFactory?: IDL.InterfaceFactory;
 }
 export declare const useCandid: ({ canisterId, didjsCanisterId, idlFactory, }: UseIDLFactoryArgs) => {
-    fetchCandid: () => Promise<import("@ic-reactor/core").CandidDefenition | undefined>;
+    fetchCandid: () => Promise<import("@ic-reactor/core/dist/types").CandidDefenition | undefined>;
     candid: {
         idlFactory?: IDL.InterfaceFactory | undefined;
         init: ({ idl }: {

package/dist/hooks/useCandid.js

@@ -23,7 +23,7 @@ const useCandid = ({ canisterId, didjsCanisterId, idlFactory, }) => {
             idlFactory,
             init: () => [],
         } }));
-    const agent = (0, agent_1.useAgentContext)();
+    const agent = (0, agent_1.useAgent)();
     const fetchCandid = (0, react_1.useCallback)(() => __awaiter(void 0, void 0, void 0, function* () {
         if (!canisterId || !agent)
             return;

package/dist/index.d.ts

@@ -1,22 +1,17 @@
-import { CreateReActorOptions, BaseActor } from "@ic-reactor/core";
-export { createReActor as createReActorCore } from "@ic-reactor/core";
-export * from "@ic-reactor/core";
-export * from "./context/agent";
-export * from "./context/actor";
-export * from "./hooks";
-export declare const createReActor: <A = BaseActor>({ isLocalEnv, withVisitor, withProcessEnv, ...options }: CreateReActorOptions) => {
+import { BaseActor, CreateReactorOptions } from "@ic-reactor/core/dist/types";
+export declare const createReactor: <A = BaseActor>({ isLocalEnv, withVisitor, withProcessEnv, ...options }: CreateReactorOptions) => {
     useUserPrincipal: () => import("@dfinity/principal").Principal | undefined;
-    useAuthStore: () => import("@ic-reactor/core").AuthState;
+    useAuthState: () => import("@ic-reactor/core/dist/types").AuthState;
     useAuthClient: ({ onAuthentication, onAuthenticationSuccess, onAuthenticationFailure, onLogin, onLoginSuccess, onLoginError, onLoggedOut, }?: import("./types").AuthArgs) => {
         authClient: import("@dfinity/auth-client").AuthClient | null;
         authenticated: boolean;
         authenticating: boolean;
-        identity: import("@ic-reactor/core").Identity | null;
+        identity: import("@ic-reactor/core/dist/types").Identity | null;
         login: (options?: import("@dfinity/auth-client").AuthClientLoginOptions | undefined) => Promise<void>;
         logout: (options?: {
             returnTo?: string | undefined;
         } | undefined) => Promise<void>;
-        authenticate: () => Promise<import("@ic-reactor/core").Identity>;
+        authenticate: () => Promise<import("@ic-reactor/core/dist/types").Identity>;
         loginLoading: boolean;
         loginError: Error | null;
     };
@@ -24,8 +19,14 @@ export declare const createReActor: <A = BaseActor>({ isLocalEnv, withVisitor, w
     useActorState: () => import("./types").UseActorStoreReturn<A>;
     useQueryCall: import("./types").ActorQueryCall<A>;
     useUpdateCall: import("./types").ActorUpdateCall<A>;
-    useMethodCall: <M extends import("@ic-reactor/core").FunctionName<A>>(args: import("./types").ActorUseMethodCallArg<A, M>) => import("./types").ActorUseMethodCallReturn<A, M, true>;
-    useVisitMethod: <M_1 extends import("@ic-reactor/core").FunctionName<A>>(functionName: M_1) => import("@ic-reactor/core").VisitService<A>[M_1];
-    getAgent: () => import("@ic-reactor/core").HttpAgent;
-    getVisitFunction: () => import("@ic-reactor/core").VisitService<A>;
+    useMethodCall: <M extends import("@ic-reactor/core/dist/types").FunctionName<A>>(args: import("./types").ActorUseMethodCallArg<A, M>) => import("./types").ActorUseMethodCallReturn<A, M, true>;
+    useVisitMethod: <M_1 extends import("@ic-reactor/core/dist/types").FunctionName<A>>(functionName: M_1) => import("@ic-reactor/core/dist/types").VisitService<A>[M_1];
+    getAgent: () => import("@ic-reactor/core/dist/types").HttpAgent;
+    getVisitFunction: () => import("@ic-reactor/core/dist/types").VisitService<A>;
 };
+export * from "./context/agent";
+export * from "./context/actor";
+export * as helpers from "./helpers";
+export * as hooks from "./hooks";
+export * as types from "./types";
+export * as core from "./core";

package/dist/index.js

@@ -10,9 +10,21 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
 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);
 };
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 var __rest = (this && this.__rest) || function (s, e) {
     var t = {};
     for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
@@ -25,26 +37,15 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createReActor = exports.createReActorCore = void 0;
+exports.core = exports.types = exports.hooks = exports.helpers = exports.createReactor = void 0;
 const core_1 = require("@ic-reactor/core");
-const actor_1 = require("./hooks/actor");
-const auth_1 = require("./hooks/auth");
-var core_2 = require("@ic-reactor/core");
-Object.defineProperty(exports, "createReActorCore", { enumerable: true, get: function () { return core_2.createReActor; } });
-__exportStar(require("@ic-reactor/core"), exports);
-__exportStar(require("./context/agent"), exports);
-__exportStar(require("./context/actor"), exports);
-__exportStar(require("./hooks"), exports);
-const createReActor = (_a) => {
+const actor_1 = require("./helpers/actor");
+const auth_1 = require("./helpers/auth");
+const tools_1 = require("@ic-reactor/core/dist/tools");
+const createReactor = (_a) => {
     var { isLocalEnv, withVisitor, withProcessEnv } = _a, options = __rest(_a, ["isLocalEnv", "withVisitor", "withProcessEnv"]);
-    isLocalEnv =
-        isLocalEnv ||
-            (withProcessEnv
-                ? typeof process !== "undefined" &&
-                    (process.env.DFX_NETWORK === "local" ||
-                        process.env.NODE_ENV === "development")
-                : false);
-    const actorManager = (0, core_1.createReActorStore)(Object.assign({ isLocalEnv,
+    isLocalEnv = isLocalEnv || (withProcessEnv ? (0, tools_1.isInLocalOrDevelopment)() : false);
+    const actorManager = (0, core_1.createReactorStore)(Object.assign({ isLocalEnv,
         withVisitor }, options));
     const getVisitFunction = () => {
         if (!withVisitor) {
@@ -60,4 +61,10 @@ const createReActor = (_a) => {
     return Object.assign(Object.assign({ getAgent,
         getVisitFunction }, actorHooks), authHooks);
 };
-exports.createReActor = createReActor;
+exports.createReactor = createReactor;
+__exportStar(require("./context/agent"), exports);
+__exportStar(require("./context/actor"), exports);
+exports.helpers = __importStar(require("./helpers"));
+exports.hooks = __importStar(require("./hooks"));
+exports.types = __importStar(require("./types"));
+exports.core = __importStar(require("./core"));

package/dist/types.d.ts

@@ -1,7 +1,10 @@
 /// <reference types="react" />
-import type { ActorState, CanisterId, CreateReActorOptions, ActorMethodArgs, ActorMethodReturnType, HttpAgent, Identity, Principal, FunctionName, VisitService } from "@ic-reactor/core";
-import type { AuthHooks } from "./hooks/auth";
-import { AgentHooks } from "./hooks/agent";
+import type { ActorState, CanisterId, CreateReactorOptions, ActorMethodArgs, ActorMethodReturnType, HttpAgent, Identity, Principal, FunctionName, VisitService } from "@ic-reactor/core/dist/types";
+import type { AgentHooks, AuthHooks } from "./helpers/types";
+export * from "@ic-reactor/core/dist/types";
+export * from "./context/agent/types";
+export * from "./context/actor/types";
+export * from "./helpers/types";
 export type AuthArgs = {
     onAuthentication?: (promise: () => Promise<Identity>) => void;
     onAuthenticationSuccess?: (identity: Identity) => void;
@@ -63,11 +66,11 @@ export type GetFunctions<A> = {
     getAgent: () => HttpAgent;
     getVisitFunction: () => VisitService<A>;
 };
-export type CreateReActor = {
-    <A>(options: CreateReActorOptions & {
+export type CreateReactor = {
+    <A>(options: CreateReactorOptions & {
         withVisitor: true;
     }): GetFunctions<A> & ActorHooks<A, true> & AuthHooks & AgentHooks;
-    <A>(options: CreateReActorOptions & {
+    <A>(options: CreateReactorOptions & {
         withVisitor?: false | undefined;
     }): GetFunctions<A> & ActorHooks<A, false> & AuthHooks & AgentHooks;
 };

package/dist/types.js

@@ -1,2 +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("@ic-reactor/core/dist/types"), exports);
+__exportStar(require("./context/agent/types"), exports);
+__exportStar(require("./context/actor/types"), exports);
+__exportStar(require("./helpers/types"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ic-reactor/react",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A React library for interacting with Internet Computer canisters",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,7 +24,7 @@
   "bugs": {
     "url": "https://github.com/b3hr4d/ic-reactor/issues"
   },
-  "homepage": "https://github.com/b3hr4d/ic-reactor/tree/main/packages/react#readme",
+  "homepage": "https://b3pay.github.io/ic-reactor/modules/react.html",
   "scripts": {
     "test": "npx jest",
     "start": "tsc watch",
@@ -35,7 +35,7 @@
     "node": ">=10"
   },
   "dependencies": {
-    "@ic-reactor/core": "^1.0.0",
+    "@ic-reactor/core": "^1.0.2",
     "zustand-utils": "^1.3"
   },
   "peerDependencies": {
@@ -48,5 +48,5 @@
     "react": ">=16.8",
     "zustand": "4.5"
   },
-  "gitHead": "ca9e2f3438a4566c26d5ce56b0f0b953aa93df53"
+  "gitHead": "4d19bef671056c8046ec64037f51d85380ff5bae"
 }

package/dist/hooks/agent.d.ts

@@ -1,6 +0,0 @@
-import type { AgentManager, HttpAgent } from "@ic-reactor/core";
-export type AgentHooks = ReturnType<typeof getAgentHooks>;
-export declare const getAgentHooks: (agentManager: AgentManager) => {
-    useAgent: () => HttpAgent | undefined;
-    useAgentState: () => import("@ic-reactor/core").AgentState;
-};