@ic-reactor/core 1.0.5 → 1.0.7

package/README.md

@@ -238,7 +238,7 @@ For development purposes, you might want to connect to a local instance of the I
 import { createAgentManager } from "@ic-reactor/core"
 
 export const agentManager = createAgentManager({
-  isLocalEnv: true,
+  withLocalEnv: true,
   port: 8000, // Default port is 4943
 })
 ```

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

@@ -17,7 +17,7 @@ export declare class ActorManager<A = BaseActor> {
     }>) => void;
     constructor(actorConfig: ActorManagerParameters);
     initialize: (options?: UpdateAgentParameters) => Promise<void>;
-    extractService(): VisitService<A>;
+    extractService: () => VisitService<A>;
     private initializeActor;
     callMethod: <M extends FunctionName<A>>(functionName: M, ...args: ActorMethodParameters<A[M]>) => Promise<ActorMethodReturnType<A[M]>>;
     get agentManager(): AgentManager;

package/dist/classes/actor/index.js

@@ -12,8 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActorManager = void 0;
 /* eslint-disable no-console */
 const agent_1 = require("@dfinity/agent");
-const helper_1 = require("../../tools/helper");
-const candid_1 = require("@dfinity/candid");
+const helper_1 = require("../../utils/helper");
 class ActorManager {
     constructor(actorConfig) {
         this._actor = null;
@@ -37,6 +36,20 @@ class ActorManager {
         this.initialize = (options) => __awaiter(this, void 0, void 0, function* () {
             yield this._agentManager.updateAgent(options);
         });
+        this.extractService = () => {
+            if (this._actor === null) {
+                throw new Error("For extracting service, actor must be initialized");
+            }
+            return agent_1.Actor.interfaceOf(this._actor)._fields.reduce((acc, service) => {
+                const functionName = service[0];
+                const type = service[1];
+                const visit = ((extractorClass, data) => {
+                    return type.accept(extractorClass, data || functionName);
+                });
+                acc[functionName] = visit;
+                return acc;
+            }, {});
+        };
         this.initializeActor = (agent) => {
             console.info(`Initializing actor ${this.canisterId} on ${agent.isLocal() ? "local" : "ic"} network`);
             const { _idlFactory: idlFactory, canisterId } = this;
@@ -92,35 +105,21 @@ class ActorManager {
             return this.actorStore.setState(updater);
         };
         const { agentManager, canisterId, idlFactory, withVisitor = false, withDevtools = false, initializeOnCreate = true, } = actorConfig;
-        this._agentManager = agentManager;
-        this._agentManager.subscribeAgent(this.initializeActor);
         this.canisterId = canisterId;
         this._idlFactory = idlFactory;
-        if (withVisitor) {
-            this.visitFunction = withVisitor ? this.extractService() : emptyVisitor;
-        }
-        else {
-            this.visitFunction = emptyVisitor;
-        }
+        this._agentManager = agentManager;
         // Initialize stores
         this.actorStore = (0, helper_1.createStoreWithOptionalDevtools)(this.initialState, {
             withDevtools,
             store: `actor-${String(canisterId)}`,
         });
-        if (initializeOnCreate) {
-            this.initializeActor(agentManager.getAgent());
+        this._agentManager.subscribeAgent(this.initializeActor, initializeOnCreate);
+        if (withVisitor) {
+            this.visitFunction = this.extractService();
+        }
+        else {
+            this.visitFunction = emptyVisitor;
         }
-    }
-    extractService() {
-        return this._idlFactory({ IDL: candid_1.IDL })._fields.reduce((acc, service) => {
-            const functionName = service[0];
-            const type = service[1];
-            const visit = ((extractorClass, data) => {
-                return type.accept(extractorClass, data || functionName);
-            });
-            acc[functionName] = visit;
-            return acc;
-        }, {});
     }
     // agent store
     get agentManager() {

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

@@ -13,7 +13,7 @@ export declare class AgentManager {
     private updateAuthState;
     constructor(options?: AgentManagerParameters);
     private initializeAgent;
-    subscribeAgent: (callback: (agent: HttpAgent) => void) => () => void;
+    subscribeAgent: (callback: (agent: HttpAgent) => void, initialize?: boolean) => () => void;
     unsubscribeAgent: (callback: (agent: HttpAgent) => void) => void;
     private notifySubscribers;
     updateAgent: (options?: UpdateAgentParameters) => Promise<void>;

package/dist/classes/agent/index.js

@@ -45,8 +45,8 @@ var __rest = (this && this.__rest) || function (s, e) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentManager = void 0;
 const agent_1 = require("@dfinity/agent");
-const helper_1 = require("../../tools/helper");
-const constants_1 = require("../../tools/constants");
+const helper_1 = require("../../utils/helper");
+const constants_1 = require("../../utils/constants");
 class AgentManager {
     constructor(options) {
         this._auth = null;
@@ -80,16 +80,19 @@ class AgentManager {
                 }
             }
         });
-        this.subscribeAgent = (callback) => {
+        this.subscribeAgent = (callback, initialize = true) => {
+            if (initialize) {
+                callback(this._agent);
+            }
             this._subscribers.push(callback);
             return () => this.unsubscribeAgent(callback);
         };
         this.unsubscribeAgent = (callback) => {
             this._subscribers = this._subscribers.filter((sub) => sub !== callback);
         };
-        this.notifySubscribers = () => {
-            this._subscribers.forEach((callback) => callback(this._agent));
-        };
+        this.notifySubscribers = () => __awaiter(this, void 0, void 0, function* () {
+            yield Promise.all(this._subscribers.map((callback) => __awaiter(this, void 0, void 0, function* () { return callback(this._agent); })));
+        });
         this.updateAgent = (options) => __awaiter(this, void 0, void 0, function* () {
             const { agent } = options || {};
             if (agent) {
@@ -100,7 +103,7 @@ class AgentManager {
                 this.isLocalEnv = this._agent.isLocal();
                 yield this.initializeAgent();
             }
-            this.notifySubscribers();
+            yield this.notifySubscribers();
         });
         this.authenticate = () => __awaiter(this, void 0, void 0, function* () {
             this.updateAuthState({ authenticating: true });
@@ -154,8 +157,8 @@ class AgentManager {
             const identity = this.authStore.getState().identity;
             return identity ? identity.getPrincipal() : null;
         };
-        const _a = options || {}, { withDevtools, port = 4943, isLocalEnv, host: optionHost } = _a, agentParameters = __rest(_a, ["withDevtools", "port", "isLocalEnv", "host"]);
-        const host = isLocalEnv
+        const _a = options || {}, { withDevtools, port = 4943, withLocalEnv, host: optionHost } = _a, agentParameters = __rest(_a, ["withDevtools", "port", "withLocalEnv", "host"]);
+        const host = withLocalEnv
             ? `http://127.0.0.1:${port}`
             : optionHost
                 ? optionHost.includes("localhost")

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

@@ -4,7 +4,7 @@ import type { StoreApi } from "zustand";
 export { HttpAgentOptions, AuthClient, Identity };
 export interface AgentManagerParameters extends HttpAgentOptions {
     port?: number;
-    isLocalEnv?: boolean;
+    withLocalEnv?: boolean;
     withDevtools?: boolean;
 }
 export interface AgentState {

package/dist/classes/candid/index.js

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CandidAdapter = void 0;
 const agent_1 = require("@dfinity/agent");
 const principal_1 = require("@dfinity/principal");
-const constants_1 = require("../../tools/constants");
+const constants_1 = require("../../utils/constants");
 class CandidAdapter {
     constructor({ agentManager, agent, didjsCanisterId, }) {
         if (agent) {

package/dist/createActorManager.d.ts

@@ -0,0 +1,12 @@
+import { ActorManager } from "./classes/actor";
+import { ActorManagerParameters, BaseActor } from "./types";
+/**
+ * Actor manager handles the lifecycle of the actors.
+ * It is responsible for creating and managing the actors.
+ * You can use it to call and visit the actor's methods.
+ * It also provides a way to interact with the actor's state.
+ *
+ * @category Main
+ * @includeExample ./packages/core/README.md:262-277
+ */
+export declare const createActorManager: <A = BaseActor>(config: ActorManagerParameters) => ActorManager<A>;

package/dist/createActorManager.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createActorManager = void 0;
+const actor_1 = require("./classes/actor");
+/**
+ * Actor manager handles the lifecycle of the actors.
+ * It is responsible for creating and managing the actors.
+ * You can use it to call and visit the actor's methods.
+ * It also provides a way to interact with the actor's state.
+ *
+ * @category Main
+ * @includeExample ./packages/core/README.md:262-277
+ */
+const createActorManager = (config) => {
+    return new actor_1.ActorManager(config);
+};
+exports.createActorManager = createActorManager;

package/dist/createAgentManager.d.ts

@@ -0,0 +1,12 @@
+import { AgentManager } from "./classes/agent";
+import { AgentManagerParameters } from "./types";
+/**
+ * Agent manager handles the lifecycle of the `@dfinity/agent`.
+ * It is responsible for creating agent and managing the agent's state.
+ * You can use it to subscribe to the agent changes.
+ * login and logout to the internet identity.
+ *
+ * @category Main
+ * @includeExample ./packages/core/README.md:226-254
+ */
+export declare const createAgentManager: (config?: AgentManagerParameters) => AgentManager;

package/dist/createAgentManager.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentManager = void 0;
+const agent_1 = require("./classes/agent");
+/**
+ * Agent manager handles the lifecycle of the `@dfinity/agent`.
+ * It is responsible for creating agent and managing the agent's state.
+ * You can use it to subscribe to the agent changes.
+ * login and logout to the internet identity.
+ *
+ * @category Main
+ * @includeExample ./packages/core/README.md:226-254
+ */
+const createAgentManager = (config) => {
+    return new agent_1.AgentManager(config);
+};
+exports.createAgentManager = createAgentManager;

package/dist/createCandidAdapter.d.ts

@@ -0,0 +1,11 @@
+import { CandidAdapter } from "./classes/candid";
+import { CandidAdapterParameters } from "./types";
+/**
+ * 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 createCandidAdapter: (config: CandidAdapterParameters) => CandidAdapter;

package/dist/createCandidAdapter.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCandidAdapter = void 0;
+const candid_1 = require("./classes/candid");
+/**
+ * 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 = (config) => {
+    return new candid_1.CandidAdapter(config);
+};
+exports.createCandidAdapter = createCandidAdapter;

package/dist/{main.js → createReactorCore.js}

@@ -21,9 +21,9 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createReactorCore = void 0;
-const constants_1 = require("./tools/constants");
-const tools_1 = require("./tools");
-const store_1 = require("./store");
+const constants_1 = require("./utils/constants");
+const utils_1 = require("./utils");
+const createReactorStore_1 = require("./createReactorStore");
 /**
  * The Core module is the main entry point for the library.
  * Create a new actor manager with the given options.
@@ -33,9 +33,9 @@ const store_1 = require("./store");
  * @includeExample ./packages/core/README.md:26-80
  */
 const createReactorCore = (config) => {
-    const _a = (0, store_1.createReactorStore)(config), { subscribeActorState, updateMethodState, callMethod, getState, agentManager } = _a, rest = __rest(_a, ["subscribeActorState", "updateMethodState", "callMethod", "getState", "agentManager"]);
+    const _a = (0, createReactorStore_1.createReactorStore)(config), { subscribeActorState, updateMethodState, callMethod, getState, agentManager } = _a, rest = __rest(_a, ["subscribeActorState", "updateMethodState", "callMethod", "getState", "agentManager"]);
     const actorMethod = (functionName, ...args) => {
-        const requestHash = (0, tools_1.generateRequestHash)(args);
+        const requestHash = (0, utils_1.generateRequestHash)(args);
         const updateState = (newState = {}) => {
             updateMethodState(functionName, requestHash, newState);
         };
@@ -55,6 +55,7 @@ const createReactorCore = (config) => {
                 }
             });
             const subscribe = (callback) => {
+                callback(methodState());
                 const unsubscribe = subscribeActorState((state) => {
                     const methodState = state.methodState[functionName];
                     const methodStateHash = methodState[requestHash];
@@ -122,8 +123,8 @@ const createReactorCore = (config) => {
             throw new Error("Auth client not initialized");
         }
         yield authClient.login(Object.assign({ identityProvider: agentManager.isLocalEnv
-                ? constants_1.IC_INTERNET_IDENTITY_PROVIDER
-                : constants_1.LOCAL_INTERNET_IDENTITY_PROVIDER }, options));
+                ? constants_1.LOCAL_INTERNET_IDENTITY_PROVIDER
+                : constants_1.IC_INTERNET_IDENTITY_PROVIDER }, options));
     });
     const logout = (options) => __awaiter(void 0, void 0, void 0, function* () {
         const authClient = agentManager.getAuth();

package/dist/{store.js → createReactorStore.js}

@@ -12,8 +12,9 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createReactorStore = void 0;
-const other_1 = require("./other");
-const tools_1 = require("./tools");
+const utils_1 = require("./utils");
+const createActorManager_1 = require("./createActorManager");
+const createAgentManager_1 = require("./createAgentManager");
 /**
  * Create a new actor manager with the given options.
  * Its create a new agent manager if not provided.
@@ -23,14 +24,14 @@ const tools_1 = require("./tools");
  * @includeExample ./packages/core/README.md:194-220
  */
 const createReactorStore = (config) => {
-    const isLocalEnv = config.withProcessEnv
-        ? (0, tools_1.isInLocalOrDevelopment)()
+    const withLocalEnv = config.withProcessEnv
+        ? (0, utils_1.isInLocalOrDevelopment)()
         : undefined;
     const { idlFactory, canisterId, withDevtools = false, initializeOnCreate = true, withVisitor = false, agentManager: maybeAgentManager } = config, agentParameters = __rest(config, ["idlFactory", "canisterId", "withDevtools", "initializeOnCreate", "withVisitor", "agentManager"]);
     const agentManager = maybeAgentManager ||
-        (0, other_1.createAgentManager)(Object.assign({ withDevtools,
-            isLocalEnv }, agentParameters));
-    const actorManager = (0, other_1.createActorManager)({
+        (0, createAgentManager_1.createAgentManager)(Object.assign({ withDevtools,
+            withLocalEnv }, agentParameters));
+    const actorManager = (0, createActorManager_1.createActorManager)({
         idlFactory,
         canisterId,
         agentManager,

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-export * from "./main";
-export * from "./store";
-export * from "./other";
+export * from "./createReactorCore";
+export * from "./createReactorStore";
+export * from "./createCandidAdapter";
+export * from "./createActorManager";
+export * from "./createAgentManager";
 export * as classes from "./classes";
 export * as types from "./types";
-export * as tools from "./tools";
+export * as utils from "./utils";

package/dist/index.js

@@ -26,10 +26,12 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.tools = exports.types = exports.classes = void 0;
-__exportStar(require("./main"), exports);
-__exportStar(require("./store"), exports);
-__exportStar(require("./other"), exports);
+exports.utils = exports.types = exports.classes = void 0;
+__exportStar(require("./createReactorCore"), exports);
+__exportStar(require("./createReactorStore"), exports);
+__exportStar(require("./createCandidAdapter"), exports);
+__exportStar(require("./createActorManager"), exports);
+__exportStar(require("./createAgentManager"), exports);
 exports.classes = __importStar(require("./classes"));
 exports.types = __importStar(require("./types"));
-exports.tools = __importStar(require("./tools"));
+exports.utils = __importStar(require("./utils"));

package/dist/types.d.ts

@@ -14,7 +14,7 @@ export type { ActorMethod, AuthClientLoginOptions, HttpAgentOptions, ActorSubcla
 export interface CreateReactorStoreParameters extends HttpAgentOptions, Omit<ActorManagerParameters, "agentManager"> {
     agentManager?: AgentManager;
     withProcessEnv?: boolean;
-    isLocalEnv?: boolean;
+    withLocalEnv?: boolean;
     port?: number;
 }
 export type ActorGetStateFunction<A, M extends FunctionName<A>> = {

package/dist/{tools → utils}/helper.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 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");
 const vanilla_1 = require("zustand/vanilla");
 function createStoreWithOptionalDevtools(initialState, config) {
@@ -51,6 +50,9 @@ const generateActorHash = (actor) => {
 exports.generateActorHash = generateActorHash;
 const stringToHash = (str) => {
     const hashBytes = (0, agent_1.hash)(new TextEncoder().encode(str));
-    return `0x${(0, candid_1.toHexString)(hashBytes)}`;
+    return `0x${toHexString(hashBytes)}`;
 };
 exports.stringToHash = stringToHash;
+function toHexString(bytes) {
+    return new Uint8Array(bytes).reduce((str, byte) => str + byte.toString(16).padStart(2, "0"), "");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ic-reactor/core",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "A library for intracting with the Internet Computer canisters",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -43,5 +43,5 @@
   "engines": {
     "node": ">=10"
   },
-  "gitHead": "c52ec12bc91d5a0e2c5fc7c6e163530a1aa5e47f"
+  "gitHead": "ed812d516651ec01414d9a1a79e959d8cc139a93"
 }

package/dist/other.d.ts

@@ -1,33 +0,0 @@
-import { ActorManager } from "./classes/actor";
-import { AgentManager } from "./classes/agent";
-import { CandidAdapter } from "./classes/candid";
-import { CandidAdapterParameters, ActorManagerParameters, AgentManagerParameters, BaseActor } from "./types";
-/**
- * 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 createCandidAdapter: (config: CandidAdapterParameters) => CandidAdapter;
-/**
- * Agent manager handles the lifecycle of the `@dfinity/agent`.
- * It is responsible for creating agent and managing the agent's state.
- * You can use it to subscribe to the agent changes.
- * login and logout to the internet identity.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:226-254
- */
-export declare const createAgentManager: (config?: AgentManagerParameters) => AgentManager;
-/**
- * Actor manager handles the lifecycle of the actors.
- * It is responsible for creating and managing the actors.
- * You can use it to call and visit the actor's methods.
- * It also provides a way to interact with the actor's state.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:262-277
- */
-export declare const createActorManager: <A = BaseActor>(config: ActorManagerParameters) => ActorManager<A>;

package/dist/other.js

@@ -1,44 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createActorManager = exports.createAgentManager = exports.createCandidAdapter = void 0;
-const actor_1 = require("./classes/actor");
-const agent_1 = require("./classes/agent");
-const candid_1 = require("./classes/candid");
-/**
- * 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 = (config) => {
-    return new candid_1.CandidAdapter(config);
-};
-exports.createCandidAdapter = createCandidAdapter;
-/**
- * Agent manager handles the lifecycle of the `@dfinity/agent`.
- * It is responsible for creating agent and managing the agent's state.
- * You can use it to subscribe to the agent changes.
- * login and logout to the internet identity.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:226-254
- */
-const createAgentManager = (config) => {
-    return new agent_1.AgentManager(config);
-};
-exports.createAgentManager = createAgentManager;
-/**
- * Actor manager handles the lifecycle of the actors.
- * It is responsible for creating and managing the actors.
- * You can use it to call and visit the actor's methods.
- * It also provides a way to interact with the actor's state.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:262-277
- */
-const createActorManager = (config) => {
-    return new actor_1.ActorManager(config);
-};
-exports.createActorManager = createActorManager;