@ic-reactor/react 1.5.5-beta.2 → 1.6.0-beta.0

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

@@ -1,4 +1,4 @@
-import { BaseActor } 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.

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

@@ -16,8 +16,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createActorContext = void 0;
 const react_1 = __importDefault(require("react"));
-const useActor_1 = require("../hooks/useActor");
-const extractActorContext_1 = require("../helpers/extractActorContext");
+const useActor_1 = require("../../hooks/useActor");
+const extractActorContext_1 = require("../../helpers/extractActorContext");
 /**
  * Creates a React context specifically designed for managing the state and interactions with an actor on the Internet Computer (IC) blockchain.
  * This context facilitates the dynamic creation and management of IC actors within React applications, leveraging the provided configuration options.
@@ -82,12 +82,13 @@ function createActorContext(contextConfig = {}) {
     const { canisterId: defaultCanisterId } = contextConfig, defaultConfig = __rest(contextConfig, ["canisterId"]);
     const ActorContext = react_1.default.createContext(null);
     const ActorProvider = (_a) => {
-        var { children, canisterId = defaultCanisterId, loadingComponent = react_1.default.createElement("div", null, "Fetching canister..."), authenticatingComponent = react_1.default.createElement("div", null, "Authenticating...") } = _a, restConfig = __rest(_a, ["children", "canisterId", "loadingComponent", "authenticatingComponent"]);
+        var { children, canisterId = defaultCanisterId, loadingComponent = react_1.default.createElement("div", null, "Fetching canister..."), authenticatingComponent = react_1.default.createElement("div", null, "Authenticating..."), candidString } = _a, restConfig = __rest(_a, ["children", "canisterId", "loadingComponent", "authenticatingComponent", "candidString"]);
         if (!canisterId) {
             throw new Error("canisterId is required");
         }
         const config = react_1.default.useMemo(() => (Object.assign(Object.assign({}, defaultConfig), restConfig)), [defaultConfig, restConfig]);
-        const { fetchError, authenticating, hooks } = (0, useActor_1.useActor)(Object.assign({ canisterId }, config));
+        const { fetchError, authenticating, hooks } = (0, useActor_1.useActor)(Object.assign({ canisterId,
+            candidString }, config));
         return (react_1.default.createElement(ActorContext.Provider, { value: hooks }, hooks === null
             ? fetchError
                 ? fetchError

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

@@ -0,0 +1,17 @@
+/// <reference types="react" />
+import type { IDL, ActorHooksReturnType, BaseActor, ActorManagerParameters, CanisterId } from "../../types";
+export interface CreateActorContextReturnType<A = BaseActor> extends ActorHooksReturnType<A> {
+    ActorProvider: React.FC<ActorProviderProps>;
+}
+export interface ActorProviderProps extends CreateActorContextParameters {
+    children?: React.ReactNode | undefined;
+    candidString?: string;
+    loadingComponent?: React.ReactNode;
+    authenticatingComponent?: React.ReactNode;
+}
+export interface CreateActorContextParameters extends Omit<ActorManagerParameters, "idlFactory" | "agentManager" | "canisterId"> {
+    didjsId?: string;
+    canisterId?: CanisterId;
+    idlFactory?: IDL.InterfaceFactory;
+    initializeParser?: boolean;
+}

package/dist/context/actor/types.js

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

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

@@ -0,0 +1,7 @@
+import React from "react";
+import { CandidAdapterContextType } from "./types";
+/**
+ * Adapter context for the Candid adapter.
+ */
+declare const CandidAdapterContext: React.Context<CandidAdapterContextType | null>;
+export { CandidAdapterContext };

package/dist/context/adapter/index.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CandidAdapterContext = void 0;
+const react_1 = __importDefault(require("react"));
+/**
+ * Adapter context for the Candid adapter.
+ */
+const CandidAdapterContext = react_1.default.createContext(null);
+exports.CandidAdapterContext = CandidAdapterContext;
+CandidAdapterContext.displayName = "CandidAdapterContext";

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

@@ -0,0 +1,10 @@
+import type { PropsWithChildren } from "react";
+import type { CandidAdapterParameters } from "../../types";
+import type { CandidAdapter } from "@ic-reactor/core/dist/classes";
+export type { CandidAdapter };
+export interface CandidAdapterContextType extends CandidAdapter {
+}
+export interface CandidAdapterProviderProps extends PropsWithChildren, CandidAdapterParameters {
+    initialParser?: boolean;
+    loadingComponent?: React.ReactNode;
+}

package/dist/context/adapter/types.js

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

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

@@ -17,9 +17,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAgentContext = void 0;
 const react_1 = __importDefault(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.

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

@@ -0,0 +1,16 @@
+import type { AgentHooksReturnType, AuthHooksReturnType, AgentManager, AgentManagerParameters } from "../../types";
+import type { PropsWithChildren } from "react";
+export interface AgentContext extends AgentHooksReturnType, AuthHooksReturnType {
+    agentManager: AgentManager;
+}
+export interface CreateAgentCotextParameters extends AgentManagerParameters {
+    withProcessEnv?: boolean;
+    disableAuthenticateOnMount?: boolean;
+}
+export interface CreateAgentContextReturnType extends AgentHooksReturnType, AuthHooksReturnType {
+    useAgentManager: () => AgentManager;
+    AgentProvider: React.FC<AgentProviderProps>;
+}
+export interface AgentProviderProps extends PropsWithChildren, CreateAgentCotextParameters {
+    agentManager?: AgentManager;
+}

package/dist/context/agent/types.js

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

package/dist/context/index.d.ts

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

package/dist/context/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("./adapter"), exports);

package/dist/context/types.d.ts

@@ -1,29 +1,3 @@
-import type { IDL, ActorHooksReturnType, AgentHooksReturnType, AuthHooksReturnType, BaseActor, AgentManager, ActorManagerParameters, AgentManagerParameters, CanisterId } from "../types";
-import type { PropsWithChildren } from "react";
-export interface AgentContext extends AgentHooksReturnType, AuthHooksReturnType {
-    agentManager: AgentManager;
-}
-export interface CreateAgentCotextParameters extends AgentManagerParameters {
-    withProcessEnv?: boolean;
-    disableAuthenticateOnMount?: boolean;
-}
-export interface CreateAgentContextReturnType extends AgentHooksReturnType, AuthHooksReturnType {
-    useAgentManager: () => AgentManager;
-    AgentProvider: React.FC<AgentProviderProps>;
-}
-export interface AgentProviderProps extends PropsWithChildren, CreateAgentCotextParameters {
-    agentManager?: AgentManager;
-}
-export interface CreateActorContextReturnType<A = BaseActor> extends ActorHooksReturnType<A> {
-    ActorProvider: React.FC<ActorProviderProps>;
-}
-export interface ActorProviderProps extends CreateActorContextParameters {
-    children?: React.ReactNode | undefined;
-    loadingComponent?: React.ReactNode;
-    authenticatingComponent?: React.ReactNode;
-}
-export interface CreateActorContextParameters extends Omit<ActorManagerParameters, "idlFactory" | "agentManager" | "canisterId"> {
-    didjsId?: string;
-    canisterId?: CanisterId;
-    idlFactory?: IDL.InterfaceFactory;
-}
+export * from "./actor/types";
+export * from "./agent/types";
+export * from "./adapter/types";

package/dist/context/types.js

@@ -1,2 +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("./actor/types"), exports);
+__exportStar(require("./agent/types"), exports);
+__exportStar(require("./adapter/types"), exports);

package/dist/helpers/extractActorContext.d.ts

@@ -1,3 +1,4 @@
 import React from "react";
-import type { ActorHooksReturnType, BaseActor, CreateActorContextReturnType } from "../types";
+import type { ActorHooksReturnType, BaseActor } from "../types";
+import { CreateActorContextReturnType } from "../context/actor/types";
 export declare function extractActorContext<A = BaseActor>(actorContext: React.Context<ActorHooksReturnType<A> | null>): Omit<CreateActorContextReturnType<A>, "ActorProvider">;

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

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

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

@@ -0,0 +1 @@
+export { useCandidAdapter } from "./useCandidAdapter";

package/dist/hooks/adapter/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCandidAdapter = void 0;
+var useCandidAdapter_1 = require("./useCandidAdapter");
+Object.defineProperty(exports, "useCandidAdapter", { enumerable: true, get: function () { return useCandidAdapter_1.useCandidAdapter; } });

package/dist/hooks/{agent → adapter}/useCandidAdapter.d.ts

@@ -1,7 +1,3 @@
-import { CandidAdapter } from "@ic-reactor/core/dist/classes";
-export interface UseCandidAdapterParams {
-    didjsCanisterId?: string;
-}
 /**
  * Accesses the `CandidAdapter` to download the actor's Candid interface.
  *
@@ -24,4 +20,4 @@ export interface UseCandidAdapterParams {
  * }
  *```
  */
-export declare const useCandidAdapter: (config?: UseCandidAdapterParams) => CandidAdapter | undefined;
+export declare const useCandidAdapter: () => import("../../context/types").CandidAdapterContextType | null;

package/dist/hooks/{agent → adapter}/useCandidAdapter.js

@@ -1,9 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useCandidAdapter = void 0;
-const react_1 = require("react");
-const core_1 = require("@ic-reactor/core");
-const useAgent_1 = require("./useAgent");
+const react_1 = __importDefault(require("react"));
+const adapter_1 = require("../../context/adapter");
 /**
  * Accesses the `CandidAdapter` to download the actor's Candid interface.
  *
@@ -26,22 +28,8 @@ const useAgent_1 = require("./useAgent");
  * }
  *```
  */
-const useCandidAdapter = (config = {}) => {
-    const [candidAdapter, setCandidAdapter] = (0, react_1.useState)();
-    const agent = (0, useAgent_1.useAgent)();
-    (0, react_1.useEffect)(() => {
-        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);
-        }
-    }, [agent, config.didjsCanisterId]);
+const useCandidAdapter = () => {
+    const candidAdapter = react_1.default.useContext(adapter_1.CandidAdapterContext);
     return candidAdapter;
 };
 exports.useCandidAdapter = useCandidAdapter;

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

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

package/dist/hooks/agent/index.js

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

package/dist/hooks/types.d.ts

@@ -1,9 +1,10 @@
 import type { IDL } from "@dfinity/candid";
 import { ActorHooksReturnType, ActorManagerParameters, BaseActor, CanisterId } from "../types";
+export * from "./adapter/useCandidAdapter";
 export interface UseActorParameters extends Omit<ActorManagerParameters, "idlFactory" | "agentManager" | "canisterId"> {
+    candidString?: string;
     canisterId: CanisterId;
     idlFactory?: IDL.InterfaceFactory;
-    didjsCanisterId?: string;
 }
 export interface UseActorReturn<A = BaseActor> {
     hooks: ActorHooksReturnType<A> | null;

package/dist/hooks/types.js

@@ -1,2 +1,17 @@
 "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("./adapter/useCandidAdapter"), exports);

package/dist/hooks/useActor.js

@@ -26,7 +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");
+const useCandidAdapter_1 = require("./adapter/useCandidAdapter");
 /**
  * A comprehensive hook that manages both the fetching of Candid interfaces
  * and the initialization of actor stores for Internet Computer (IC) canisters.
@@ -90,7 +90,7 @@ const useCandidAdapter_1 = require("./agent/useCandidAdapter");
  * ```
  */
 const useActor = (config) => {
-    const { canisterId, idlFactory: maybeIdlFactory, didjsCanisterId } = config, actorConfig = __rest(config, ["canisterId", "idlFactory", "didjsCanisterId"]);
+    const { canisterId, candidString, idlFactory: maybeIdlFactory } = config, actorConfig = __rest(config, ["canisterId", "candidString", "idlFactory"]);
     if (!canisterId) {
         throw new Error("canisterId is required");
     }
@@ -105,9 +105,7 @@ const useActor = (config) => {
         fetching: false,
         fetchError: null,
     });
-    const candidAdapter = (0, useCandidAdapter_1.useCandidAdapter)({
-        didjsCanisterId,
-    });
+    const candidAdapter = (0, useCandidAdapter_1.useCandidAdapter)();
     const authenticating = (0, agent_1.useAuthState)().authenticating;
     const fetchCandid = (0, react_1.useCallback)(() => __awaiter(void 0, void 0, void 0, function* () {
         if (fetching || authenticating || !candidAdapter)
@@ -132,28 +130,63 @@ const useActor = (config) => {
                 fetching: false,
             });
         }
-    }), [canisterId, candidAdapter, authenticating, didjsCanisterId]);
+    }), [canisterId, candidAdapter, authenticating]);
     const agentManager = (0, useAgentManager_1.useAgentManager)();
     const initialActorManager = (0, react_1.useCallback)((idlFactory) => {
-        if (authenticating)
+        if (authenticating || !idlFactory)
             return;
         const actorManager = (0, core_1.createActorManager)(Object.assign({ agentManager,
             idlFactory,
             canisterId }, actorConfig));
         setActorManager(actorManager);
     }, [canisterId, agentManager, authenticating]);
-    (0, react_1.useEffect)(() => {
+    const evaluateCandid = (0, react_1.useCallback)((candidString) => __awaiter(void 0, void 0, void 0, function* () {
+        if (!candidAdapter) {
+            return;
+        }
+        try {
+            const definition = yield candidAdapter.dynamicEvalJs(candidString);
+            if (typeof (definition === null || definition === void 0 ? void 0 : definition.idlFactory) !== "function") {
+                throw new Error("Error evaluating Candid definition");
+            }
+            return definition.idlFactory;
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(err);
+            setState({
+                fetchError: `Error evaluating Candid definition, ${err}`,
+                fetching: false,
+            });
+        }
+    }), [candidAdapter]);
+    const handleActorInitialization = (0, react_1.useCallback)(() => __awaiter(void 0, void 0, void 0, function* () {
         if (maybeIdlFactory) {
-            initialActorManager(maybeIdlFactory);
+            return initialActorManager(maybeIdlFactory);
+        }
+        if (!candidAdapter) {
+            throw new Error("CandidAdapter is not available, make sure you have wrapped your component with CandidAdapterProvider");
+        }
+        try {
+            if (candidString) {
+                const idlFactory = yield evaluateCandid(candidString);
+                return initialActorManager(idlFactory);
+            }
+            const idlFactory = yield fetchCandid();
+            return initialActorManager(idlFactory);
         }
-        else {
-            fetchCandid().then((idlFactory) => {
-                if (!idlFactory)
-                    return;
-                initialActorManager(idlFactory);
+        catch (error) {
+            // eslint-disable-next-line no-console
+            console.error(error);
+            setState({
+                fetchError: "Error occurred during actor initialization",
+                fetching: false,
             });
         }
-    }, [fetchCandid, maybeIdlFactory, initialActorManager]);
+    }), [fetchCandid, evaluateCandid, maybeIdlFactory, initialActorManager]);
+    (0, react_1.useEffect)(() => {
+        handleActorInitialization();
+    }, [handleActorInitialization]);
     const hooks = (0, react_1.useMemo)(() => {
         if (!actorManager)
             return null;

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export * from "./createReactor";
-export * from "./context/actor";
-export * from "./context/agent";
+export * from "./context";
 export * from "./provider/actor";
 export * from "./provider/agent";
+export * from "./provider/adapter";
 export * from "./hooks";
 export * as helpers from "./helpers";
 export * as types from "./types";

package/dist/index.js

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

package/dist/provider/actor.d.ts

@@ -25,4 +25,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("../context/types").ActorProviderProps>;

package/dist/provider/adapter.d.ts

@@ -0,0 +1,31 @@
+import React from "react";
+import { CandidAdapterProviderProps } from "../context/types";
+/**
+ * `CandidAdapterProvider` 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.
+ *
+ * The provider encapsulates the logic for initializing and managing an agent manager instance, which is then used to
+ * create various hooks related to agent operations and authentication processes. These hooks are made available to all
+ * child components through the context, facilitating a centralized and efficient way to interact with the Internet Computer (IC) blockchain.
+ *
+ * @param children - Child components that can consume the context.
+ * @param agentManager - An optional `AgentManager` instance to be used by the provider. If not provided, a new instance
+ *                       will be created based on the provided options combined with default configuration.
+ * @param options - Configuration options for the `AgentManager`. These options are merged with any default configurations
+ *                  specified during the context creation and can include custom settings for the agent, such as identity,
+ *                  host URL, etc.
+ *
+ * @example
+ * Wrap your component tree with `CandidAdapterProvider` to provide all child components access to IC agent and authentication hooks.
+ *
+ * ```jsx
+ * <CandidAdapterProvider>
+ *   <YourComponent />
+ * </CandidAdapterProvider>
+ * ```
+ *
+ * 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.
+ */
+declare const CandidAdapterProvider: React.FC<CandidAdapterProviderProps>;
+export { CandidAdapterProvider };

package/dist/provider/adapter.js

@@ -0,0 +1,62 @@
+"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;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CandidAdapterProvider = void 0;
+const react_1 = __importDefault(require("react"));
+const core_1 = require("@ic-reactor/core");
+const adapter_1 = require("../context/adapter");
+const hooks_1 = require("../hooks");
+/**
+ * `CandidAdapterProvider` 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.
+ *
+ * The provider encapsulates the logic for initializing and managing an agent manager instance, which is then used to
+ * create various hooks related to agent operations and authentication processes. These hooks are made available to all
+ * child components through the context, facilitating a centralized and efficient way to interact with the Internet Computer (IC) blockchain.
+ *
+ * @param children - Child components that can consume the context.
+ * @param agentManager - An optional `AgentManager` instance to be used by the provider. If not provided, a new instance
+ *                       will be created based on the provided options combined with default configuration.
+ * @param options - Configuration options for the `AgentManager`. These options are merged with any default configurations
+ *                  specified during the context creation and can include custom settings for the agent, such as identity,
+ *                  host URL, etc.
+ *
+ * @example
+ * Wrap your component tree with `CandidAdapterProvider` to provide all child components access to IC agent and authentication hooks.
+ *
+ * ```jsx
+ * <CandidAdapterProvider>
+ *   <YourComponent />
+ * </CandidAdapterProvider>
+ * ```
+ *
+ * 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.
+ */
+const CandidAdapterProvider = (_a) => {
+    var { children, initialParser, loadingComponent = react_1.default.createElement("div", null, "Loading...") } = _a, options = __rest(_a, ["children", "initialParser", "loadingComponent"]);
+    const [initalized, setInitialized] = react_1.default.useState(false);
+    const agentManager = (0, hooks_1.useAgentManager)();
+    const candidAdapter = react_1.default.useMemo(() => (0, core_1.createCandidAdapter)(Object.assign({ agentManager }, options)), [options, agentManager]);
+    react_1.default.useEffect(() => {
+        if (initialParser) {
+            candidAdapter.initializeParser().then(() => setInitialized(true));
+        }
+    }, []);
+    return (react_1.default.createElement(adapter_1.CandidAdapterContext.Provider, { value: candidAdapter }, initalized ? children : loadingComponent));
+};
+exports.CandidAdapterProvider = CandidAdapterProvider;
+CandidAdapterProvider.displayName = "CandidAdapterContext";

package/dist/types.d.ts

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

package/dist/types.js

@@ -14,7 +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("./context/types"), exports);
+__exportStar(require("./context/agent/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.5.5-beta.2",
+  "version": "1.6.0-beta.0",
   "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.5.4-beta.2",
+    "@ic-reactor/core": "^1.6.0-beta.0",
     "zustand-utils": "^1.3"
   },
   "peerDependencies": {
@@ -47,5 +47,5 @@
     "react": ">=16.8",
     "zustand": "4.5"
   },
-  "gitHead": "bf632e49a5a4d1128531a6fc50b5c2f97dee58c9"
+  "gitHead": "4911f0639b420406550150f789f34ecf3e6167c1"
 }