@ic-reactor/core 1.0.0 → 1.0.2

package/README.md

@@ -1,6 +1,4 @@
-# @ic-reactor/core
-
-The `@ic-reactor/core` package provides a streamlined way to interact with the Internet Computer (IC) by simplifying agent and actor management. It offers utilities for creating and managing IC agents, enabling seamless communication with canisters through a friendly API.
+The `@ic-reactor/core` package provides a streamlined way to interact with the Internet Computer (IC). It simplifies agent and actor management, ensuring type-safe communication with canisters. This package offers utilities for creating and managing IC agents, enabling seamless interaction through a friendly API.
 
 ## Installation
 
@@ -18,111 +16,92 @@ npm install @ic-reactor/core
 yarn add @ic-reactor/core
 ```
 
-## Usage
-
-`@ic-reactor/core` can be utilized in two primary ways: automatic agent creation and manual agent management. Below are examples of both approaches to suit your project's needs.
-
-### Automatic Agent Creation
+### Using `createReactorCore`
 
-For ease of use, the `createReActorStore` factory function automatically sets up a new ReActor store instance, managing the agent and its state internally.
+For ease of use, the `createReactorCore` factory function automatically sets up a new Reactor instance, managing the agent and its state internally, and providing a simple API for authenticating, querying, and updating actors.
 
 **Example:**
 
 ```typescript
-import { createReActorStore } from "@ic-reactor/core"
-import { candid, canisterId, idlFactory } from "./candid"
+import { createReactorCore } from "@ic-reactor/core"
+import { candid, canisterId, idlFactory } from "./declarations/candid"
 
 type Candid = typeof candid
 
-const { callMethod, authenticate } = createReActor<Candid>({
-  canisterId,
-  idlFactory,
-})
-
-// Usage example
-const identity = await authenticate()
-const data = await callMethod("version")
-console.log(data)
-```
-
-### Manual Agent Creation
-
-If you require more control over the agent's lifecycle or configuration, `@ic-reactor/core` provides the `createAgentManager` function for manual agent instantiation.
-
-**IC Agent Example:**
-
-```typescript
-// agent.ts
-import { createAgentManager } from "@ic-reactor/core"
-
-export const agentManager = createAgentManager() // Connects to IC network by default
-
-// Usage example
-await agentManager.authenticate()
-// Then use the store to access the authClient, identity, and more...
-const { authClient, identity, authenticating } =
-  agentManager.authStore.getState()
+const { queryCall, updateCall, getPrincipal, login } =
+  createReactorCore<Candid>({
+    canisterId,
+    idlFactory,
+    withProcessEnv: true, // will use process.env.DFX_NETWORK
+  })
 ```
 
-**Local Agent Example:**
-
-For development purposes, you might want to connect to a local instance of the IC network:
+You can find All available methods are returned from the `createReactorCore` function here: [ReactorCore](https://b3pay.github.io/ic-reactor/interfaces/core.types.ReactorCore.html)
 
 ```typescript
-// agent.ts
-import { createAgentManager } from "@ic-reactor/core"
-
-export const agentManager = createAgentManager({
-  isLocalEnv: true,
-  port: 8000, // Default port is 4943
+// later in your code
+await login({
+  onSuccess: () => {
+    console.log("Logged in successfully")
+  },
+  onError: (error) => {
+    console.error("Failed to login:", error)
+  },
 })
-```
 
-Alternatively, you can specify a host directly:
-
-```typescript
-export const agentManager = createAgentManager({
-  host: "http://localhost:8000",
+// queryCall, will automatically call and return a promise with the result
+const { dataPromise, call } = queryCall({
+  functionName: "icrc1_balance_of",
+  args: [{ owner: getPrincipal(), subaccount: [] }],
 })
-```
-
-### Creating an Actor Manager
-
-Once you have an agent manager, use `createActorManager` to instantiate an actor manager for calling methods on your canisters.
 
-```typescript
-// actor.ts
-import { createActorManager } from "@ic-reactor/core"
-import { candid, canisterId, idlFactory } from "./candid"
-import { agentManager } from "./agent"
-
-type Candid = typeof candid
-
-const candidActor = createActorManager<Candid>({
-  agentManager,
-  canisterId,
-  idlFactory,
+console.log(await dataPromise)
+
+// updateCall
+const { call, subscribe } = updateCall({
+  functionName: "icrc1_transfer",
+  args: [
+    {
+      to: { owner: getPrincipal(), subaccount: [] },
+      amount: BigInt(10000000000),
+      fee: [],
+      memo: [],
+      created_at_time: [],
+      from_subaccount: [],
+    },
+  ],
+})
+// subscribe to the update call
+subscribe(({ loading, error, data }) => {
+  console.log({ loading, error, data })
 })
 
-// Usage example
-const data = await candidActor.callMethod("version")
-console.log(data)
+const result = await call()
+console.log(result)
 ```
 
 ### Managing Multiple Actors
 
-When interacting with multiple canisters using `@ic-reactor/core`, you can create separate actor managers for each canister. This enables modular interaction with different services on the Internet Computer. Here's how to adjust the example to handle methods that require multiple arguments:
-
-**Creating Actor Managers:**
+When interacting with multiple canisters using `@ic-reactor/core`, you need one agent manager for each canister. This way, you can create separate reactor for each canister. This enables modular interaction with different services on the Internet Computer,
+and allows you to manage the state of each actor independently.
+Here's how to adjust the example to handle methods that require multiple arguments:
 
-First, ensure you have your actor managers set up for each canister:
+Fist you need to create a agent manager:
 
 ```typescript
-// Assuming you've already set up `candidA`, `candidB`, `canisterIdA`, `canisterIdB`, and `agentManager`
+// agent.ts
+import { createAgentManager } from "@ic-reactor/core"
 
+export const agentManager = createAgentManager() // Connects to IC network by default
+```
+
+Then you can create a reactor for each canister:
+
+```typescript
+// Assuming you've already set up `candidA`, `candidB`, and `agentManager`
 import { createActorManager } from "@ic-reactor/core"
-import { candidA, canisterIdA } from "./candidA"
-import { candidB, canisterIdB } from "./candidB"
+import candidA from "./declarations/candidA"
+import candidB from "./declarations/candidB"
 import { agentManager } from "./agent"
 
 type CandidA = typeof candidA
@@ -141,18 +120,20 @@ const actorB = createActorManager<CandidB>({
 })
 ```
 
-### Using `callMethod` with Multiple Arguments
-
-To call a method on a canister that requires multiple arguments, pass the method name followed by the arguments as separate parameters to `callMethod`:
+You can now use the `actorA` and `actorB` instances to interact with their respective canisters:
 
 ```typescript
 // Example usage with CanisterA calling a method that requires one argument
-const responseA = await actorA.callMethod("otherMethod", "arg1")
-console.log("Response from CanisterA method:", responseA)
+const { dataPromise: versionActorA } = actorA.queryCall({
+  functionName: "version",
+})
+console.log("Response from CanisterA method:", await versionActorA)
 
 // Example usage with CanisterB calling a different method also with two arguments
-const responseB = await actorB.callMethod("anotherMethod", "arg1", "arg2")
-console.log("Response from CanisterB method:", responseB)
+const { dataPromise: versionActorB } = actorB.queryCall({
+  functionName: "version",
+})
+console.log("Response from CanisterB method:", await versionActorB)
 ```
 
 ### Using Candid Adapter
@@ -177,12 +158,12 @@ try {
 }
 ```
 
-### Using `createReActorStore` with `CandidAdapter`
+### Using `createReactorCore` with `CandidAdapter`
 
-You can use the `candidAdapter` to fetch the Candid definition and then pass it to the `createReActorStore` function.
+You can use the `candidAdapter` to fetch the Candid definition and then pass it to the `createReactorCore` function.
 
 ```typescript
-import { createReActorStore, createCandidAdapter } from "@ic-reactor/core"
+import { createReactorCore, createCandidAdapter } from "@ic-reactor/core"
 import { agentManager } from "./agent"
 
 const candidAdapter = createCandidAdapter({ agentManager })
@@ -192,7 +173,7 @@ const canisterId = "ryjl3-tyaaa-aaaaa-aaaba-cai" // NNS ICP Ledger Canister
 // Usage example
 try {
   const { idlFactory } = await candidAdapter.getCandidDefinition(canisterId)
-  const { callMethod } = createReActorStore({
+  const { callMethod } = createReactorCore({
     agentManager,
     canisterId,
     idlFactory,
@@ -205,6 +186,93 @@ try {
 }
 ```
 
-## Conclusion
+### Using store to lower level control
 
-The `@ic-reactor/core` package offers a flexible and powerful way to interact with the Internet Computer, catering to both straightforward use cases with automatic agent management and more complex scenarios requiring manual control. By abstracting away some of the intricacies of agent and actor management, it enables developers to focus more on building their applications.
+If you require more control over the state management, you can use the `createReactorStore` function to create a store that provides methods for querying and updating actors.
+
+```typescript
+import { createReactorStore } from "@ic-reactor/core"
+import { candid, canisterId, idlFactory } from "./declarations/candid"
+
+type Candid = typeof candid
+
+const { agentManager, callMethod } = createReactorStore<Candid>({
+  canisterId,
+  idlFactory,
+})
+
+// Usage example
+await agentManager.authenticate()
+const authClient = agentManager.getAuthClient()
+
+authClient?.login({
+  onSuccess: () => {
+    console.log("Logged in successfully")
+  },
+  onError: (error) => {
+    console.error("Failed to login:", error)
+  },
+})
+
+// Call a method
+const version = callMethod("version")
+
+console.log("Response from version method:", await version)
+```
+
+**IC Agent Example:**
+
+```typescript
+// agent.ts
+import { createAgentManager } from "@ic-reactor/core"
+
+export const agentManager = createAgentManager() // Connects to IC network by default
+```
+
+**Local Agent Example:**
+
+For development purposes, you might want to connect to a local instance of the IC network:
+
+```typescript
+// agent.ts
+import { createAgentManager } from "@ic-reactor/core"
+
+export const agentManager = createAgentManager({
+  isLocalEnv: true,
+  port: 8000, // Default port is 4943
+})
+```
+
+Alternatively, you can specify a host directly:
+
+```typescript
+// agent.ts
+import { createAgentManager } from "@ic-reactor/core"
+
+export const agentManager = createAgentManager({
+  host: "http://localhost:8000",
+})
+```
+
+### Creating an Actor Manager
+
+You can use Actor Managers to create your implementation of an actor. This allows you to manage the actor's lifecycle and state, as well as interact with the actor's methods.
+
+```typescript
+// actor.ts
+import { createActorManager } from "@ic-reactor/core"
+import { candid, canisterId, idlFactory } from "./declarations/candid"
+import { agentManager } from "./agent"
+
+type Candid = typeof candid
+
+const candidActor = createActorManager<Candid>({
+  agentManager,
+  canisterId,
+  idlFactory,
+})
+
+// Usage example
+const data = await candidActor.callMethod("version")
+console.log(data)
+```

package/dist/actor/index.d.ts

@@ -1,7 +1,7 @@
 import type { HttpAgent } from "@dfinity/agent";
 import type { CanisterId, ActorMethodArgs, ActorMethodReturnType, ActorStore, ActorManagerOptions, FunctionName, VisitService, BaseActor, ActorMethodState } from "./types";
-import type { AgentManager, UpdateAgentOptions } from "../agent";
-export * from "./types";
+import type { AgentManager } from "../agent";
+import type { UpdateAgentOptions } from "../types";
 export declare class ActorManager<A = BaseActor> {
     private _actor;
     private _idlFactory;

package/dist/actor/index.js

@@ -1,18 +1,4 @@
 "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);
-};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -28,7 +14,6 @@ exports.ActorManager = void 0;
 const agent_1 = require("@dfinity/agent");
 const helper_1 = require("../tools/helper");
 const candid_1 = require("@dfinity/candid");
-__exportStar(require("./types"), exports);
 class ActorManager {
     constructor(actorConfig) {
         this._actor = null;

package/dist/agent/index.d.ts

@@ -1,8 +1,5 @@
 import { HttpAgent } from "@dfinity/agent";
 import type { AgentStore, AgentManagerOptions, UpdateAgentOptions, AuthStore } from "./types";
-export * from "./types";
-export declare const IC_HOST_NETWORK_URI = "https://ic0.app";
-export declare const LOCAL_HOST_NETWORK_URI = "http://127.0.0.1:4943";
 export declare class AgentManager {
     private _agent;
     private _subscribers;
@@ -21,7 +18,6 @@ export declare class AgentManager {
     updateAgent: (options?: UpdateAgentOptions) => Promise<void>;
     authenticate: () => Promise<import("@dfinity/agent").Identity>;
     getAgent: () => HttpAgent;
-    getAgentStore: () => AgentStore;
     getAgentState: AgentStore["getState"];
     subscribeAgentState: AgentStore["subscribe"];
     getAuthState: AuthStore["getState"];

package/dist/agent/index.js

@@ -15,9 +15,6 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : 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 = {};
@@ -46,12 +43,10 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentManager = exports.LOCAL_HOST_NETWORK_URI = exports.IC_HOST_NETWORK_URI = void 0;
+exports.AgentManager = void 0;
 const agent_1 = require("@dfinity/agent");
 const helper_1 = require("../tools/helper");
-__exportStar(require("./types"), exports);
-exports.IC_HOST_NETWORK_URI = "https://ic0.app";
-exports.LOCAL_HOST_NETWORK_URI = "http://127.0.0.1:4943";
+const constants_1 = require("../tools/constants");
 class AgentManager {
     constructor(options) {
         this._subscribers = [];
@@ -137,9 +132,6 @@ class AgentManager {
         this.getAgent = () => {
             return this._agent;
         };
-        this.getAgentStore = () => {
-            return this.agentStore;
-        };
         this.getAgentState = () => {
             return this.agentStore.getState();
         };
@@ -170,7 +162,7 @@ class AgentManager {
                 ? optionHost.includes("localhost")
                     ? optionHost.replace("localhost", "127.0.0.1")
                     : optionHost
-                : exports.IC_HOST_NETWORK_URI;
+                : constants_1.IC_HOST_NETWORK_URI;
         this.agentStore = (0, helper_1.createStoreWithOptionalDevtools)(this.initialAgentState, {
             withDevtools,
             store: "agent",

package/dist/{tools/candid.d.ts → candid/index.d.ts}

@@ -1,8 +1,5 @@
 import { HttpAgent } from "@dfinity/agent";
-import { CanisterId } from "../actor";
-import { CandidAdapterOptions, CandidDefenition } from "./types";
-export declare const DEFAULT_LOCAL_DIDJS_ID = "bd3sg-teaaa-aaaaa-qaaba-cai";
-export declare const DEFAULT_IC_DIDJS_ID = "a4gq6-oaaaa-aaaab-qaa4q-cai";
+import type { CanisterId, CandidAdapterOptions, CandidDefenition } from "../types";
 export declare class CandidAdapter {
     agent: HttpAgent;
     didjsCanisterId: string;

package/dist/{tools/candid.js → candid/index.js}

@@ -9,11 +9,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CandidAdapter = exports.DEFAULT_IC_DIDJS_ID = exports.DEFAULT_LOCAL_DIDJS_ID = void 0;
+exports.CandidAdapter = void 0;
 const agent_1 = require("@dfinity/agent");
 const principal_1 = require("@dfinity/principal");
-exports.DEFAULT_LOCAL_DIDJS_ID = "bd3sg-teaaa-aaaaa-qaaba-cai";
-exports.DEFAULT_IC_DIDJS_ID = "a4gq6-oaaaa-aaaab-qaa4q-cai";
+const constants_1 = require("../tools/constants");
 class CandidAdapter {
     constructor({ agentManager, agent, didjsCanisterId }) {
         if (agent) {
@@ -32,7 +31,7 @@ class CandidAdapter {
         this.didjsCanisterId = didjsCanisterId || this.getDefaultDidJsId();
     }
     getDefaultDidJsId() {
-        return this.agent.isLocal() ? exports.DEFAULT_LOCAL_DIDJS_ID : exports.DEFAULT_IC_DIDJS_ID;
+        return this.agent.isLocal() ? constants_1.DEFAULT_LOCAL_DIDJS_ID : constants_1.DEFAULT_IC_DIDJS_ID;
     }
     getCandidDefinition(canisterId) {
         return __awaiter(this, void 0, void 0, function* () {

package/dist/index.d.ts

@@ -1,30 +1,34 @@
-import type { ActorManagerOptions, BaseActor } from "./actor/types";
-import type { AgentManagerOptions } from "./agent/types";
 import { ActorManager } from "./actor";
 import { AgentManager } from "./agent";
-import type { ActorCoreActions, CreateReActorOptions, CreateReActorStoreOptions } from "./types";
-import { CandidAdapter, CandidAdapterOptions } from "./tools";
-export * from "./types";
-export * from "./actor";
-export * from "./agent";
-export * from "./tools";
+import type { ActorManagerOptions, BaseActor, AgentManagerOptions, ReactorCore, CreateReactorOptions, CreateReactorStoreOptions, CandidAdapterOptions } from "./types";
+import { CandidAdapter } from "./candid";
 /**
+ * The Core module is the main entry point for the library.
  * Create a new actor manager with the given options.
  * Its create a new agent manager if not provided.
  *
  * @category Main
- * @includeExample ./packages/core/README.md:30-91
+ * @includeExample ./packages/core/README.md:26-80
+ */
+export declare const createReactorCore: <A = BaseActor>({ isLocalEnv, withProcessEnv, ...options }: CreateReactorOptions) => ReactorCore<A>;
+/**
+ * The `CandidAdapter` class is used to interact with a canister and retrieve its Candid interface definition.
+ * It provides methods to fetch the Candid definition either from the canister's metadata or by using a temporary hack method.
+ * If both methods fail, it throws an error.
+ *
+ * @category Main
+ * @includeExample ./packages/core/README.md:145-186
  */
-export declare const createReActor: <A = BaseActor>({ isLocalEnv, withProcessEnv, ...options }: CreateReActorOptions) => ActorCoreActions<A>;
+export declare const createCandidAdapter: (options: CandidAdapterOptions) => CandidAdapter;
 /**
  * Create a new actor manager with the given options.
  * Its create a new agent manager if not provided.
  * It also creates a new actor manager with the given options.
  *
  * @category Main
- * @includeExample ./packages/core/README.md:32-45
+ * @includeExample ./packages/core/README.md:194-220
  */
-export declare const createReActorStore: <A = BaseActor>(options: CreateReActorStoreOptions) => ActorManager<A>;
+export declare const createReactorStore: <A = BaseActor>(options: CreateReactorStoreOptions) => ActorManager<A>;
 /**
  * Agent manager handles the lifecycle of the `@dfinity/agent`.
  * It is responsible for creating agent and managing the agent's state.
@@ -32,7 +36,7 @@ export declare const createReActorStore: <A = BaseActor>(options: CreateReActorS
  * login and logout to the internet identity.
  *
  * @category Main
- * @includeExample ./packages/core/README.md:55-86
+ * @includeExample ./packages/core/README.md:226-254
  */
 export declare const createAgentManager: (options?: AgentManagerOptions) => AgentManager;
 /**
@@ -42,15 +46,11 @@ export declare const createAgentManager: (options?: AgentManagerOptions) => Agen
  * It also provides a way to interact with the actor's state.
  *
  * @category Main
- * @includeExample ./packages/core/README.md:94-109
+ * @includeExample ./packages/core/README.md:262-277
  */
 export declare const createActorManager: <A = BaseActor>(options: ActorManagerOptions) => ActorManager<A>;
-/**
- * The `CandidAdapter` class is used to interact with a canister and retrieve its Candid interface definition.
- * It provides methods to fetch the Candid definition either from the canister's metadata or by using a temporary hack method.
- * If both methods fail, it throws an error.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:164-205
- */
-export declare const createCandidAdapter: (options: CandidAdapterOptions) => CandidAdapter;
+export * from "./actor";
+export * from "./agent";
+export * from "./candid";
+export * as types from "./types";
+export * as tools from "./tools";

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 __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -34,31 +46,24 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCandidAdapter = exports.createActorManager = exports.createAgentManager = exports.createReActorStore = exports.createReActor = void 0;
+exports.tools = exports.types = exports.createActorManager = exports.createAgentManager = exports.createReactorStore = exports.createCandidAdapter = exports.createReactorCore = void 0;
 const actor_1 = require("./actor");
 const agent_1 = require("./agent");
+const constants_1 = require("./tools/constants");
 const tools_1 = require("./tools");
-__exportStar(require("./types"), exports);
-__exportStar(require("./actor"), exports);
-__exportStar(require("./agent"), exports);
-__exportStar(require("./tools"), exports);
+const candid_1 = require("./candid");
 /**
+ * The Core module is the main entry point for the library.
  * Create a new actor manager with the given options.
  * Its create a new agent manager if not provided.
  *
  * @category Main
- * @includeExample ./packages/core/README.md:30-91
+ * @includeExample ./packages/core/README.md:26-80
  */
-const createReActor = (_a) => {
+const createReactorCore = (_a) => {
     var { isLocalEnv, withProcessEnv = false } = _a, options = __rest(_a, ["isLocalEnv", "withProcessEnv"]);
-    isLocalEnv =
-        isLocalEnv ||
-            (withProcessEnv
-                ? typeof process !== "undefined" &&
-                    (process.env.DFX_NETWORK === "local" ||
-                        process.env.NODE_ENV === "development")
-                : false);
-    const _b = (0, exports.createReActorStore)(Object.assign({ isLocalEnv }, options)), { subscribeActorState, updateMethodState, callMethod, getState, agentManager } = _b, rest = __rest(_b, ["subscribeActorState", "updateMethodState", "callMethod", "getState", "agentManager"]);
+    isLocalEnv = isLocalEnv || (withProcessEnv ? (0, tools_1.isInLocalOrDevelopment)() : false);
+    const _b = (0, exports.createReactorStore)(Object.assign({ isLocalEnv }, options)), { subscribeActorState, updateMethodState, callMethod, getState, agentManager } = _b, rest = __rest(_b, ["subscribeActorState", "updateMethodState", "callMethod", "getState", "agentManager"]);
     const reActorMethod = (functionName, ...args) => {
         const requestHash = (0, tools_1.generateRequestHash)(args);
         const updateState = (newState = {}) => {
@@ -143,9 +148,12 @@ const createReActor = (_a) => {
         if (!authClient) {
             yield agentManager.authenticate();
         }
+        if (!authClient) {
+            throw new Error("Auth client not initialized");
+        }
         yield authClient.login(Object.assign({ identityProvider: isLocalEnv
-                ? "https://identity.ic0.app/#authorize"
-                : "http://rdmx6-jaaaa-aaaaa-aaadq-cai.localhost:4943/#authorize" }, options));
+                ? constants_1.IC_INTERNET_IDENTITY_PROVIDER
+                : constants_1.LOCAL_INTERNET_IDENTITY_PROVIDER }, options));
     });
     const logout = (options) => __awaiter(void 0, void 0, void 0, function* () {
         const authClient = agentManager.getAuthClient();
@@ -163,16 +171,28 @@ const createReActor = (_a) => {
         logout,
         subscribeActorState }, agentManager), rest);
 };
-exports.createReActor = createReActor;
+exports.createReactorCore = createReactorCore;
+/**
+ * The `CandidAdapter` class is used to interact with a canister and retrieve its Candid interface definition.
+ * It provides methods to fetch the Candid definition either from the canister's metadata or by using a temporary hack method.
+ * If both methods fail, it throws an error.
+ *
+ * @category Main
+ * @includeExample ./packages/core/README.md:145-186
+ */
+const createCandidAdapter = (options) => {
+    return new candid_1.CandidAdapter(options);
+};
+exports.createCandidAdapter = createCandidAdapter;
 /**
  * Create a new actor manager with the given options.
  * Its create a new agent manager if not provided.
  * It also creates a new actor manager with the given options.
  *
  * @category Main
- * @includeExample ./packages/core/README.md:32-45
+ * @includeExample ./packages/core/README.md:194-220
  */
-const createReActorStore = (options) => {
+const createReactorStore = (options) => {
     const { idlFactory, canisterId, withDevtools = false, initializeOnCreate = true, withVisitor = false, agentManager: maybeAgentManager } = options, agentOptions = __rest(options, ["idlFactory", "canisterId", "withDevtools", "initializeOnCreate", "withVisitor", "agentManager"]);
     const agentManager = maybeAgentManager ||
         (0, exports.createAgentManager)(Object.assign({ withDevtools }, agentOptions));
@@ -186,7 +206,7 @@ const createReActorStore = (options) => {
     });
     return actorManager;
 };
-exports.createReActorStore = createReActorStore;
+exports.createReactorStore = createReactorStore;
 /**
  * Agent manager handles the lifecycle of the `@dfinity/agent`.
  * It is responsible for creating agent and managing the agent's state.
@@ -194,7 +214,7 @@ exports.createReActorStore = createReActorStore;
  * login and logout to the internet identity.
  *
  * @category Main
- * @includeExample ./packages/core/README.md:55-86
+ * @includeExample ./packages/core/README.md:226-254
  */
 const createAgentManager = (options) => {
     return new agent_1.AgentManager(options);
@@ -207,21 +227,14 @@ exports.createAgentManager = createAgentManager;
  * It also provides a way to interact with the actor's state.
  *
  * @category Main
- * @includeExample ./packages/core/README.md:94-109
+ * @includeExample ./packages/core/README.md:262-277
  */
 const createActorManager = (options) => {
     return new actor_1.ActorManager(options);
 };
 exports.createActorManager = createActorManager;
-/**
- * The `CandidAdapter` class is used to interact with a canister and retrieve its Candid interface definition.
- * It provides methods to fetch the Candid definition either from the canister's metadata or by using a temporary hack method.
- * If both methods fail, it throws an error.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:164-205
- */
-const createCandidAdapter = (options) => {
-    return new tools_1.CandidAdapter(options);
-};
-exports.createCandidAdapter = createCandidAdapter;
+__exportStar(require("./actor"), exports);
+__exportStar(require("./agent"), exports);
+__exportStar(require("./candid"), exports);
+exports.types = __importStar(require("./types"));
+exports.tools = __importStar(require("./tools"));

package/dist/tools/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const IC_HOST_NETWORK_URI = "https://ic0.app";
+export declare const LOCAL_HOST_NETWORK_URI = "http://127.0.0.1:4943";
+export declare const DEFAULT_LOCAL_DIDJS_ID = "bd3sg-teaaa-aaaaa-qaaba-cai";
+export declare const DEFAULT_IC_DIDJS_ID = "a4gq6-oaaaa-aaaab-qaa4q-cai";
+export declare const IC_INTERNET_IDENTITY_PROVIDER = "https://identity.ic0.app/#authorize";
+export declare const LOCAL_INTERNET_IDENTITY_PROVIDER = "http://rdmx6-jaaaa-aaaaa-aaadq-cai.localhost:4943/#authorize";

package/dist/tools/constants.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOCAL_INTERNET_IDENTITY_PROVIDER = exports.IC_INTERNET_IDENTITY_PROVIDER = exports.DEFAULT_IC_DIDJS_ID = exports.DEFAULT_LOCAL_DIDJS_ID = exports.LOCAL_HOST_NETWORK_URI = exports.IC_HOST_NETWORK_URI = void 0;
+exports.IC_HOST_NETWORK_URI = "https://ic0.app";
+exports.LOCAL_HOST_NETWORK_URI = "http://127.0.0.1:4943";
+exports.DEFAULT_LOCAL_DIDJS_ID = "bd3sg-teaaa-aaaaa-qaaba-cai";
+exports.DEFAULT_IC_DIDJS_ID = "a4gq6-oaaaa-aaaab-qaa4q-cai";
+exports.IC_INTERNET_IDENTITY_PROVIDER = "https://identity.ic0.app/#authorize";
+exports.LOCAL_INTERNET_IDENTITY_PROVIDER = "http://rdmx6-jaaaa-aaaaa-aaadq-cai.localhost:4943/#authorize";

package/dist/tools/helper.d.ts

@@ -1,4 +1,4 @@
-import { BaseActor } from "../actor";
+import { BaseActor } from "../types";
 interface StoreOptions {
     withDevtools?: boolean;
     store: string;
@@ -8,7 +8,8 @@ export declare function createStoreWithOptionalDevtools<T>(initialState: T, opti
         type: string;
     }>(partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean | undefined, action?: A | undefined): void;
 };
-export declare function jsonToString(json: unknown): string;
+export declare const isInLocalOrDevelopment: () => boolean;
+export declare const jsonToString: (json: unknown) => string;
 export declare const generateRequestHash: (args?: unknown[]) => `0x${string}`;
 export declare const generateHash: (field?: unknown) => `0x${string}`;
 export declare const generateActorHash: (actor: BaseActor) => `0x${string}`;

package/dist/tools/helper.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stringToHash = exports.generateActorHash = exports.generateHash = exports.generateRequestHash = exports.jsonToString = exports.createStoreWithOptionalDevtools = void 0;
+exports.stringToHash = exports.generateActorHash = exports.generateHash = exports.generateRequestHash = exports.jsonToString = exports.isInLocalOrDevelopment = exports.createStoreWithOptionalDevtools = void 0;
 const agent_1 = require("@dfinity/agent");
 const candid_1 = require("@dfinity/candid");
 const middleware_1 = require("zustand/middleware");
@@ -8,7 +8,7 @@ const vanilla_1 = require("zustand/vanilla");
 function createStoreWithOptionalDevtools(initialState, options) {
     if (options.withDevtools) {
         return (0, vanilla_1.createStore)((0, middleware_1.devtools)(() => initialState, {
-            name: "ReActor",
+            name: "Reactor",
             store: options.store,
         }));
     }
@@ -17,9 +17,15 @@ function createStoreWithOptionalDevtools(initialState, options) {
     }
 }
 exports.createStoreWithOptionalDevtools = createStoreWithOptionalDevtools;
-function jsonToString(json) {
+const isInLocalOrDevelopment = () => {
+    return (typeof process !== "undefined" &&
+        (process.env.DFX_NETWORK === "local" ||
+            process.env.NODE_ENV === "development"));
+};
+exports.isInLocalOrDevelopment = isInLocalOrDevelopment;
+const jsonToString = (json) => {
     return JSON.stringify(json, (_, value) => (typeof value === "bigint" ? `BigInt(${value})` : value), 2);
-}
+};
 exports.jsonToString = jsonToString;
 const generateRequestHash = (args = []) => {
     const serializedArgs = args

package/dist/tools/index.d.ts

@@ -1,3 +1,2 @@
-export * from "./candid";
 export * from "./helper";
-export * from "./types";
+export * from "./constants";

package/dist/tools/index.js

@@ -14,6 +14,5 @@ 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("./candid"), exports);
 __exportStar(require("./helper"), exports);
-__exportStar(require("./types"), exports);
+__exportStar(require("./constants"), exports);

package/dist/types.d.ts

@@ -2,13 +2,17 @@
 import type { ActorMethod, ActorSubclass, HttpAgentOptions, HttpAgent, Identity } from "@dfinity/agent";
 import type { Principal } from "@dfinity/principal";
 import type { IDL } from "@dfinity/candid";
-import type { ActorManager, ActorManagerOptions, ActorMethodArgs, ActorMethodReturnType, ActorMethodState, BaseActor, FunctionName } from "./actor";
+import type { ActorManager } from "./actor";
+import type { ActorManagerOptions, ActorMethodArgs, ActorMethodReturnType, ActorMethodState, BaseActor, FunctionName } from "./actor/types";
 import type { AgentManager } from "./agent";
 import type { AuthClientLoginOptions } from "@dfinity/auth-client";
+export * from "./agent/types";
+export * from "./actor/types";
+export * from "./candid/types";
 export type { ActorMethod, HttpAgentOptions, ActorSubclass, Principal, HttpAgent, Identity, IDL, };
-export interface CreateReActorOptions extends CreateReActorStoreOptions {
+export interface CreateReactorOptions extends CreateReactorStoreOptions {
 }
-export interface CreateReActorStoreOptions extends HttpAgentOptions, Omit<ActorManagerOptions, "agentManager"> {
+export interface CreateReactorStoreOptions extends HttpAgentOptions, Omit<ActorManagerOptions, "agentManager"> {
     agentManager?: AgentManager;
     withProcessEnv?: boolean;
     isLocalEnv?: boolean;
@@ -49,7 +53,7 @@ export type ActorUpdateArgs<A, M extends FunctionName<A>> = {
 export type ActorMethodCall<A = Record<string, ActorMethod>> = <M extends FunctionName<A>>(functionName: M, ...args: ActorMethodArgs<A[M]>) => ActorUpdateReturn<A, M>;
 export type ActorQuery<A = Record<string, ActorMethod>> = <M extends FunctionName<A>>(options: ActorQueryArgs<A, M>) => ActorQueryReturn<A, M>;
 export type ActorUpdate<A = Record<string, ActorMethod>> = <M extends FunctionName<A>>(options: ActorUpdateArgs<A, M>) => ActorUpdateReturn<A, M>;
-export interface ActorCoreActions<A = BaseActor> extends AgentManager, Omit<ActorManager<A>, "updateMethodState"> {
+export interface ReactorCore<A = BaseActor> extends AgentManager, Omit<ActorManager<A>, "updateMethodState"> {
     login: (options?: AuthClientLoginOptions) => Promise<void>;
     logout: (options?: {
         returnTo?: string;

package/dist/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("./agent/types"), exports);
+__exportStar(require("./actor/types"), exports);
+__exportStar(require("./candid/types"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ic-reactor/core",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A library for intracting with the 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/core#readme",
+  "homepage": "https://b3pay.github.io/ic-reactor/modules/core.html",
   "peerDependencies": {
     "@dfinity/agent": ">=1.0",
     "@dfinity/auth-client": ">=1.0",
@@ -43,5 +43,5 @@
   "engines": {
     "node": ">=10"
   },
-  "gitHead": "ca9e2f3438a4566c26d5ce56b0f0b953aa93df53"
+  "gitHead": "4d19bef671056c8046ec64037f51d85380ff5bae"
 }