@ic-reactor/react 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,5 +1,3 @@
1
- # IC-ReActor - React
2
-
3
1
  `@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.
4
2
 
5
3
  ## Features
@@ -131,24 +129,3 @@ const Login = () => {
131
129
 
132
130
  export default Login
133
131
  ```
134
-
135
- ## API Reference
136
-
137
- The library provides various hooks and utilities for interacting with IC actors:
138
-
139
- - `useActorStore`: Hook for managing actor states.
140
- - `useAuthStore` Hook for managing authentication states.
141
- - `useAuthClient`: Hook for managing authentication with the IC blockchain.
142
- - `useQueryCall`: Hook for querying data from an actor.
143
- - `useUpdateCall`: Hook for updating data in an actor.
144
- - Additional hooks for handling loading, errors, authentication, and more.
145
-
146
- For detailed API usage and options, please refer to the [documentation](#).
147
-
148
- ## Contributing
149
-
150
- Contributions to `@ic-reactor/react` are welcome! Please read our [contributing guidelines](#) for more information.
151
-
152
- ## License
153
-
154
- `@ic-reactor/react` is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
@@ -1,8 +1,9 @@
1
1
  import React from "react";
2
2
  import { ActorUseMethodCallArg, ActorUseQueryArgs, ActorUseUpdateArgs } from "../../types";
3
3
  import { CreateActorOptions, ActorContextType, ActorProviderProps } from "./types";
4
- export * from "./types";
5
- export declare const createReActorContext: <Actor extends unknown>({ canisterId: defaultCanisterId, ...defaultConfig }?: Partial<CreateActorOptions>) => {
4
+ import type { ActorSubclass } from "@dfinity/agent";
5
+ 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;
6
+ export declare function createReActorContext<Actor extends ActorSubclass<any>>({ canisterId: defaultCanisterId, ...defaultConfig }?: Partial<CreateActorOptions>): {
6
7
  ActorContext: React.Context<ActorContextType | null>;
7
8
  ActorProvider: React.FC<ActorProviderProps>;
8
9
  useActorContext: <A extends unknown = Actor>() => ActorContextType<A>;
@@ -10,7 +11,6 @@ export declare const createReActorContext: <Actor extends unknown>({ canisterId:
10
11
  useQueryCall: <M extends keyof Actor & string>(args: ActorUseQueryArgs<Actor, M>) => import("../../types").ActorCallReturn<Actor, M>;
11
12
  useUpdateCall: <M_1 extends keyof Actor & string>(args: ActorUseUpdateArgs<Actor, M_1>) => import("../../types").ActorCallReturn<Actor, M_1>;
12
13
  useMethodCall: <M_2 extends keyof Actor & string>(args: ActorUseMethodCallArg<Actor, M_2>) => import("../../types").ActorUseMethodCallReturn<Actor, M_2, true>;
13
- useVisitMethod: (functionName: keyof Actor & string) => import("@ic-reactor/core").VisitService<Actor>[keyof Actor & string];
14
+ useVisitMethod: (functionName: keyof Actor & string) => import("@ic-reactor/core/dist/actor/types").VisitService<Actor>[keyof Actor & string];
14
15
  initialize: () => Promise<void>;
15
16
  };
16
- 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;
@@ -22,9 +22,6 @@ var __importStar = (this && this.__importStar) || function (mod) {
22
22
  __setModuleDefault(result, mod);
23
23
  return result;
24
24
  };
25
- var __exportStar = (this && this.__exportStar) || function(m, exports) {
26
- for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
27
- };
28
25
  var __rest = (this && this.__rest) || function (s, e) {
29
26
  var t = {};
30
27
  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) {
38
35
  };
39
36
  var _a;
40
37
  Object.defineProperty(exports, "__esModule", { value: true });
41
- exports.useVisitMethod = exports.useMethodCall = exports.useUpdateCall = exports.useQueryCall = exports.useActorState = exports.useActorContext = exports.ActorProvider = exports.ActorContext = exports.createReActorContext = void 0;
38
+ exports.createReActorContext = exports.useVisitMethod = exports.useMethodCall = exports.useUpdateCall = exports.useQueryCall = exports.useActorState = exports.useActorContext = exports.ActorProvider = exports.ActorContext = void 0;
42
39
  /* eslint-disable @typescript-eslint/no-explicit-any */
43
40
  const react_1 = __importStar(require("react"));
44
41
  const actor_1 = require("../../hooks/actor");
45
42
  const useActor_1 = require("../../hooks/useActor");
46
- __exportStar(require("./types"), exports);
47
- const createReActorContext = (_a = {}) => {
43
+ _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;
44
+ function createReActorContext(_a = {}) {
48
45
  var { canisterId: defaultCanisterId } = _a, defaultConfig = __rest(_a, ["canisterId"]);
49
46
  const ActorContext = (0, react_1.createContext)(null);
50
47
  const ActorProvider = (_a) => {
@@ -87,6 +84,5 @@ const createReActorContext = (_a = {}) => {
87
84
  useVisitMethod,
88
85
  initialize,
89
86
  };
90
- };
87
+ }
91
88
  exports.createReActorContext = createReActorContext;
92
- _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;
@@ -1,8 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { IDL } from "@dfinity/candid";
3
- import { ActorManagerOptions, BaseActor } from "@ic-reactor/core";
4
- import { AgentContextType } from "../agent";
5
- import { ActorHooks } from "../../types";
3
+ import { ActorManagerOptions, BaseActor } from "@ic-reactor/core/dist/types";
4
+ import { ActorHooks, AgentContextType } from "../../types";
6
5
  export type ActorContextType<Actor = BaseActor, F extends boolean = true> = ActorHooks<Actor, F> & {
7
6
  ActorContext: React.Context<ActorContextType<Actor, F> | null>;
8
7
  useActorContext: <A = Actor>() => ActorContextType<A>;
@@ -0,0 +1,5 @@
1
+ import React from "react";
2
+ import type { AgentContextValue, AgentProviderProps } from "./types";
3
+ export declare const AgentContext: React.Context<AgentContextValue | null>;
4
+ declare const AgentProvider: React.FC<AgentProviderProps>;
5
+ export { AgentProvider };
@@ -0,0 +1,55 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || function (mod) {
19
+ if (mod && mod.__esModule) return mod;
20
+ var result = {};
21
+ if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
22
+ __setModuleDefault(result, mod);
23
+ return result;
24
+ };
25
+ var __rest = (this && this.__rest) || function (s, e) {
26
+ var t = {};
27
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
28
+ t[p] = s[p];
29
+ if (s != null && typeof Object.getOwnPropertySymbols === "function")
30
+ for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
31
+ if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
32
+ t[p[i]] = s[p[i]];
33
+ }
34
+ return t;
35
+ };
36
+ Object.defineProperty(exports, "__esModule", { value: true });
37
+ exports.AgentProvider = exports.AgentContext = void 0;
38
+ const react_1 = __importStar(require("react"));
39
+ const core_1 = require("@ic-reactor/core");
40
+ const agent_1 = require("../../hooks/agent");
41
+ const auth_1 = require("../../hooks/auth");
42
+ exports.AgentContext = (0, react_1.createContext)(null);
43
+ const AgentProvider = (_a) => {
44
+ var { children } = _a, config = __rest(_a, ["children"]);
45
+ const value = (0, react_1.useMemo)(() => createAgentContext(config), [config]);
46
+ return react_1.default.createElement(exports.AgentContext.Provider, { value: value }, children);
47
+ };
48
+ exports.AgentProvider = AgentProvider;
49
+ AgentProvider.displayName = "AgentProvider";
50
+ const createAgentContext = (config) => {
51
+ const agentManager = (0, core_1.createAgentManager)(config);
52
+ const agenthooks = (0, agent_1.getAgentHooks)(agentManager);
53
+ const authHooks = (0, auth_1.getAuthHooks)(agentManager);
54
+ return Object.assign(Object.assign(Object.assign({}, agenthooks), authHooks), { agentManager });
55
+ };
@@ -1,4 +1,24 @@
1
- import { AgentManager, HttpAgent } from "@ic-reactor/core";
2
- import { AgentContextType } from "./types";
1
+ import { AgentManager } from "@ic-reactor/core/dist/agent";
2
+ import type { AgentContextType } from "./types";
3
+ import { AuthArgs } from "../../types";
4
+ export declare const useAgentManagerContext: (agentContext?: AgentContextType) => import("./types").AgentContextValue;
3
5
  export declare const useAgentManager: (agentContext?: AgentContextType) => AgentManager;
4
- export declare const useAgentContext: (agentContext?: AgentContextType) => HttpAgent | undefined;
6
+ export declare const useAgent: (agentContext?: AgentContextType) => import("@dfinity/agent/lib/cjs/agent/http").HttpAgent | undefined;
7
+ export declare const useAuthStore: (agentContext?: AgentContextType) => import("@ic-reactor/core/dist/agent/types").AuthState;
8
+ export declare const useAgentState: (agentContext?: AgentContextType) => import("@ic-reactor/core/dist/agent/types").AgentState;
9
+ export declare const useAuthClient: ({ agentContext, ...args }: AuthArgs & {
10
+ agentContext?: AgentContextType | undefined;
11
+ }) => {
12
+ authClient: import("@dfinity/auth-client").AuthClient | null;
13
+ authenticated: boolean;
14
+ authenticating: boolean;
15
+ identity: import("@dfinity/agent/lib/cjs/auth").Identity | null;
16
+ login: (options?: import("@dfinity/auth-client").AuthClientLoginOptions | undefined) => Promise<void>;
17
+ logout: (options?: {
18
+ returnTo?: string | undefined;
19
+ } | undefined) => Promise<void>;
20
+ authenticate: () => Promise<import("@dfinity/agent/lib/cjs/auth").Identity>;
21
+ loginLoading: boolean;
22
+ loginError: Error | null;
23
+ };
24
+ export declare const useUserPrincipal: (agentContext?: AgentContextType) => import("@dfinity/principal").Principal | undefined;
@@ -1,17 +1,43 @@
1
1
  "use strict";
2
+ var __rest = (this && this.__rest) || function (s, e) {
3
+ var t = {};
4
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
5
+ t[p] = s[p];
6
+ if (s != null && typeof Object.getOwnPropertySymbols === "function")
7
+ for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
8
+ if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
9
+ t[p[i]] = s[p[i]];
10
+ }
11
+ return t;
12
+ };
2
13
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.useAgentContext = exports.useAgentManager = void 0;
14
+ exports.useUserPrincipal = exports.useAuthClient = exports.useAgentState = exports.useAuthStore = exports.useAgent = exports.useAgentManager = exports.useAgentManagerContext = void 0;
4
15
  const react_1 = require("react");
5
- const _1 = require(".");
16
+ const context_1 = require("./context");
17
+ const useAgentManagerContext = (agentContext) => {
18
+ const context = (0, react_1.useContext)(agentContext || context_1.AgentContext);
19
+ if (!context) {
20
+ throw new Error("Agent context must be used within a AgentProvider");
21
+ }
22
+ return context;
23
+ };
24
+ exports.useAgentManagerContext = useAgentManagerContext;
6
25
  const useAgentManager = (agentContext) => {
7
- const context = (0, _1.useAgentManagerContext)(agentContext);
26
+ const context = (0, exports.useAgentManagerContext)(agentContext);
8
27
  return context.agentManager;
9
28
  };
10
29
  exports.useAgentManager = useAgentManager;
11
- const useAgentContext = (agentContext) => {
12
- const agentManager = (0, exports.useAgentManager)(agentContext);
13
- const [agent, setAgent] = (0, react_1.useState)(agentManager.getAgent());
14
- (0, react_1.useEffect)(() => agentManager.subscribeAgent(setAgent), []);
15
- return agent;
30
+ const useAgent = (agentContext) => (0, exports.useAgentManagerContext)(agentContext).useAgent();
31
+ exports.useAgent = useAgent;
32
+ const useAuthStore = (agentContext) => (0, exports.useAgentManagerContext)(agentContext).useAuthStore();
33
+ exports.useAuthStore = useAuthStore;
34
+ const useAgentState = (agentContext) => (0, exports.useAgentManagerContext)(agentContext).useAgentState();
35
+ exports.useAgentState = useAgentState;
36
+ const useAuthClient = (_a) => {
37
+ var { agentContext } = _a, args = __rest(_a, ["agentContext"]);
38
+ const context = (0, exports.useAgentManagerContext)(agentContext);
39
+ return context.useAuthClient(args);
16
40
  };
17
- exports.useAgentContext = useAgentContext;
41
+ exports.useAuthClient = useAuthClient;
42
+ const useUserPrincipal = (agentContext) => (0, exports.useAgentManagerContext)(agentContext).useUserPrincipal();
43
+ exports.useUserPrincipal = useUserPrincipal;
@@ -1,10 +1,2 @@
1
- import React from "react";
2
- import { AgentManagerOptions } from "@ic-reactor/core";
3
- import { AgentContextValue, AgentContextType, AgentProviderProps } from "./types";
4
- export * from "./types";
1
+ export * from "./context";
5
2
  export * from "./hooks";
6
- export declare const AgentManagerContext: React.Context<AgentContextValue | null>;
7
- export declare const useAgentManagerContext: (agentContext?: AgentContextType) => AgentContextValue;
8
- export declare const createAgentContext: (config: AgentManagerOptions) => AgentContextValue;
9
- declare const AgentProvider: React.FC<AgentProviderProps>;
10
- export { AgentProvider };
@@ -10,60 +10,9 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
10
10
  if (k2 === undefined) k2 = k;
11
11
  o[k2] = m[k];
12
12
  }));
13
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
- Object.defineProperty(o, "default", { enumerable: true, value: v });
15
- }) : function(o, v) {
16
- o["default"] = v;
17
- });
18
- var __importStar = (this && this.__importStar) || function (mod) {
19
- if (mod && mod.__esModule) return mod;
20
- var result = {};
21
- if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
22
- __setModuleDefault(result, mod);
23
- return result;
24
- };
25
13
  var __exportStar = (this && this.__exportStar) || function(m, exports) {
26
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
27
15
  };
28
- var __rest = (this && this.__rest) || function (s, e) {
29
- var t = {};
30
- for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
31
- t[p] = s[p];
32
- if (s != null && typeof Object.getOwnPropertySymbols === "function")
33
- for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
34
- if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
35
- t[p[i]] = s[p[i]];
36
- }
37
- return t;
38
- };
39
16
  Object.defineProperty(exports, "__esModule", { value: true });
40
- exports.AgentProvider = exports.createAgentContext = exports.useAgentManagerContext = exports.AgentManagerContext = void 0;
41
- const react_1 = __importStar(require("react"));
42
- const core_1 = require("@ic-reactor/core");
43
- const agent_1 = require("../../hooks/agent");
44
- const auth_1 = require("../../hooks/auth");
45
- __exportStar(require("./types"), exports);
17
+ __exportStar(require("./context"), exports);
46
18
  __exportStar(require("./hooks"), exports);
47
- exports.AgentManagerContext = (0, react_1.createContext)(null);
48
- const useAgentManagerContext = (agentContext) => {
49
- const context = (0, react_1.useContext)(agentContext || exports.AgentManagerContext);
50
- if (!context) {
51
- throw new Error("Agent context must be used within a AgentProvider");
52
- }
53
- return context;
54
- };
55
- exports.useAgentManagerContext = useAgentManagerContext;
56
- const createAgentContext = (config) => {
57
- const agentManager = (0, core_1.createAgentManager)(config);
58
- const agenthooks = (0, agent_1.getAgentHooks)(agentManager);
59
- const authHooks = (0, auth_1.getAuthHooks)(agentManager);
60
- return Object.assign(Object.assign(Object.assign({}, agenthooks), authHooks), { agentManager });
61
- };
62
- exports.createAgentContext = createAgentContext;
63
- const AgentProvider = (_a) => {
64
- var { children } = _a, config = __rest(_a, ["children"]);
65
- const value = (0, react_1.useMemo)(() => (0, exports.createAgentContext)(config), [config]);
66
- return (react_1.default.createElement(exports.AgentManagerContext.Provider, { value: value }, children));
67
- };
68
- exports.AgentProvider = AgentProvider;
69
- AgentProvider.displayName = "AgentProvider";
@@ -1,7 +1,8 @@
1
1
  import React, { PropsWithChildren } from "react";
2
- import { AgentManager, AgentManagerOptions } from "@ic-reactor/core";
3
- import { getAuthHooks } from "../../hooks/auth";
4
- import { getAgentHooks } from "../../hooks/agent";
2
+ import type { AgentManagerOptions } from "@ic-reactor/core/dist/types";
3
+ import type { AgentManager } from "@ic-reactor/core/dist/agent";
4
+ import type { getAuthHooks } from "../../hooks/auth";
5
+ import type { getAgentHooks } from "../../hooks/agent";
5
6
  export type AgentContextValue = ReturnType<typeof getAuthHooks> & ReturnType<typeof getAgentHooks> & {
6
7
  agentManager: AgentManager;
7
8
  };
@@ -1,3 +1,3 @@
1
1
  import { ActorHooks } from "../types";
2
- import { ActorManager } from "@ic-reactor/core";
2
+ import type { ActorManager } from "@ic-reactor/core/dist/actor";
3
3
  export declare const getActorHooks: <A>({ initialize, canisterId, actorStore, callMethod, visitFunction, }: ActorManager<A>) => ActorHooks<A, true>;
@@ -84,14 +84,15 @@ const getActorHooks = ({ initialize, canisterId, actorStore, callMethod, visitFu
84
84
  call();
85
85
  }, refetchInterval);
86
86
  }
87
- // Initial call logic
88
- if (refetchOnMount) {
89
- call();
90
- }
91
87
  return () => {
92
88
  clearInterval(intervalId.current);
93
89
  };
94
- }, [refetchOnMount, refetchInterval]);
90
+ }, [refetchInterval]);
91
+ (0, react_1.useLayoutEffect)(() => {
92
+ if (refetchOnMount) {
93
+ call();
94
+ }
95
+ }, []);
95
96
  return Object.assign({ call }, state);
96
97
  };
97
98
  const useUpdateCall = (args) => {
@@ -1,6 +1,6 @@
1
- import type { AgentManager, HttpAgent } from "@ic-reactor/core";
2
- export type AgentHooks = ReturnType<typeof getAgentHooks>;
1
+ import type { AgentManager } from "@ic-reactor/core/dist/agent";
2
+ import type { HttpAgent } from "@ic-reactor/core/dist/types";
3
3
  export declare const getAgentHooks: (agentManager: AgentManager) => {
4
4
  useAgent: () => HttpAgent | undefined;
5
- useAgentState: () => import("@ic-reactor/core").AgentState;
5
+ useAgentState: () => import("@ic-reactor/core/dist/types").AgentState;
6
6
  };
@@ -1,10 +1,10 @@
1
1
  import type { AuthClientLoginOptions } from "@dfinity/auth-client";
2
- import type { AgentManager, Identity, Principal } from "@ic-reactor/core";
2
+ import type { Identity, Principal } from "@ic-reactor/core/dist/types";
3
+ import type { AgentManager } from "@ic-reactor/core/dist/agent";
3
4
  import { AuthArgs } from "../types";
4
- export type AuthHooks = ReturnType<typeof getAuthHooks>;
5
5
  export declare const getAuthHooks: (agentManager: AgentManager) => {
6
6
  useUserPrincipal: () => Principal | undefined;
7
- useAuthStore: () => import("@ic-reactor/core").AuthState;
7
+ useAuthStore: () => import("@ic-reactor/core/dist/types").AuthState;
8
8
  useAuthClient: ({ onAuthentication, onAuthenticationSuccess, onAuthenticationFailure, onLogin, onLoginSuccess, onLoginError, onLoggedOut, }?: AuthArgs) => {
9
9
  authClient: import("@dfinity/auth-client").AuthClient | null;
10
10
  authenticated: boolean;
@@ -0,0 +1,4 @@
1
+ import { getAgentHooks } from "./agent";
2
+ import { getAuthHooks } from "./auth";
3
+ export type AgentHooks = ReturnType<typeof getAgentHooks>;
4
+ export type AuthHooks = ReturnType<typeof getAuthHooks>;
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,15 +1,21 @@
1
- import { ActorManagerOptions, BaseActor, IDL } from "@ic-reactor/core";
2
- import { AgentContextType } from "../context/agent";
1
+ import { IDL } from "@dfinity/candid";
2
+ import { ActorManagerOptions, BaseActor } from "@ic-reactor/core/dist/types";
3
+ import { AgentContextType } from "../types";
3
4
  interface DynamicActorArgs extends Omit<ActorManagerOptions, "idlFactory" | "agentManager" | "canisterId"> {
4
5
  canisterId: string;
5
6
  idlFactory?: IDL.InterfaceFactory;
6
7
  agentContext?: AgentContextType;
7
8
  didjsCanisterId?: string;
8
9
  }
10
+ /**
11
+ * A hook to create an actor manager and fetch the actor's candid interface.
12
+ *
13
+ * @category Hooks
14
+ */
9
15
  export declare const useActor: <A = BaseActor>({ canisterId, agentContext, idlFactory: maybeIdlFactory, didjsCanisterId, ...config }: DynamicActorArgs) => {
10
- fetchCandid: () => Promise<import("@ic-reactor/core").CandidDefenition | undefined>;
16
+ fetchCandid: () => Promise<import("@ic-reactor/core/dist/types").CandidDefenition | undefined>;
11
17
  fetching: boolean;
12
18
  fetchError: string | null;
13
- actorManager: import("@ic-reactor/core").ActorManager<A> | null;
19
+ actorManager: import("@ic-reactor/core/dist/actor").ActorManager<A> | null;
14
20
  };
15
21
  export {};
@@ -16,6 +16,11 @@ const core_1 = require("@ic-reactor/core");
16
16
  const react_1 = require("react");
17
17
  const agent_1 = require("../context/agent");
18
18
  const useCandid_1 = require("./useCandid");
19
+ /**
20
+ * A hook to create an actor manager and fetch the actor's candid interface.
21
+ *
22
+ * @category Hooks
23
+ */
19
24
  const useActor = (_a) => {
20
25
  var { canisterId, agentContext, idlFactory: maybeIdlFactory, didjsCanisterId } = _a, config = __rest(_a, ["canisterId", "agentContext", "idlFactory", "didjsCanisterId"]);
21
26
  const agentManager = (0, agent_1.useAgentManager)(agentContext);
@@ -5,7 +5,7 @@ interface UseIDLFactoryArgs {
5
5
  idlFactory?: IDL.InterfaceFactory;
6
6
  }
7
7
  export declare const useCandid: ({ canisterId, didjsCanisterId, idlFactory, }: UseIDLFactoryArgs) => {
8
- fetchCandid: () => Promise<import("@ic-reactor/core").CandidDefenition | undefined>;
8
+ fetchCandid: () => Promise<import("@ic-reactor/core/dist/types").CandidDefenition | undefined>;
9
9
  candid: {
10
10
  idlFactory?: IDL.InterfaceFactory | undefined;
11
11
  init: ({ idl }: {
@@ -23,7 +23,7 @@ const useCandid = ({ canisterId, didjsCanisterId, idlFactory, }) => {
23
23
  idlFactory,
24
24
  init: () => [],
25
25
  } }));
26
- const agent = (0, agent_1.useAgentContext)();
26
+ const agent = (0, agent_1.useAgent)();
27
27
  const fetchCandid = (0, react_1.useCallback)(() => __awaiter(void 0, void 0, void 0, function* () {
28
28
  if (!canisterId || !agent)
29
29
  return;
package/dist/index.d.ts CHANGED
@@ -1,22 +1,17 @@
1
- import { CreateReActorOptions, BaseActor } from "@ic-reactor/core";
2
- export { createReActor as createReActorCore } from "@ic-reactor/core";
3
- export * from "@ic-reactor/core";
4
- export * from "./context/agent";
5
- export * from "./context/actor";
6
- export * from "./hooks";
1
+ import { BaseActor, CreateReActorOptions } from "@ic-reactor/core/dist/types";
7
2
  export declare const createReActor: <A = BaseActor>({ isLocalEnv, withVisitor, withProcessEnv, ...options }: CreateReActorOptions) => {
8
3
  useUserPrincipal: () => import("@dfinity/principal").Principal | undefined;
9
- useAuthStore: () => import("@ic-reactor/core").AuthState;
4
+ useAuthStore: () => import("@ic-reactor/core/dist/types").AuthState;
10
5
  useAuthClient: ({ onAuthentication, onAuthenticationSuccess, onAuthenticationFailure, onLogin, onLoginSuccess, onLoginError, onLoggedOut, }?: import("./types").AuthArgs) => {
11
6
  authClient: import("@dfinity/auth-client").AuthClient | null;
12
7
  authenticated: boolean;
13
8
  authenticating: boolean;
14
- identity: import("@ic-reactor/core").Identity | null;
9
+ identity: import("@ic-reactor/core/dist/types").Identity | null;
15
10
  login: (options?: import("@dfinity/auth-client").AuthClientLoginOptions | undefined) => Promise<void>;
16
11
  logout: (options?: {
17
12
  returnTo?: string | undefined;
18
13
  } | undefined) => Promise<void>;
19
- authenticate: () => Promise<import("@ic-reactor/core").Identity>;
14
+ authenticate: () => Promise<import("@ic-reactor/core/dist/types").Identity>;
20
15
  loginLoading: boolean;
21
16
  loginError: Error | null;
22
17
  };
@@ -24,8 +19,12 @@ export declare const createReActor: <A = BaseActor>({ isLocalEnv, withVisitor, w
24
19
  useActorState: () => import("./types").UseActorStoreReturn<A>;
25
20
  useQueryCall: import("./types").ActorQueryCall<A>;
26
21
  useUpdateCall: import("./types").ActorUpdateCall<A>;
27
- useMethodCall: <M extends import("@ic-reactor/core").FunctionName<A>>(args: import("./types").ActorUseMethodCallArg<A, M>) => import("./types").ActorUseMethodCallReturn<A, M, true>;
28
- useVisitMethod: <M_1 extends import("@ic-reactor/core").FunctionName<A>>(functionName: M_1) => import("@ic-reactor/core").VisitService<A>[M_1];
29
- getAgent: () => import("@ic-reactor/core").HttpAgent;
30
- getVisitFunction: () => import("@ic-reactor/core").VisitService<A>;
22
+ useMethodCall: <M extends import("@ic-reactor/core/dist/types").FunctionName<A>>(args: import("./types").ActorUseMethodCallArg<A, M>) => import("./types").ActorUseMethodCallReturn<A, M, true>;
23
+ 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];
24
+ getAgent: () => import("@ic-reactor/core/dist/types").HttpAgent;
25
+ getVisitFunction: () => import("@ic-reactor/core/dist/types").VisitService<A>;
31
26
  };
27
+ export * as agent from "./context/agent";
28
+ export * as actor from "./context/actor";
29
+ export * as hooks from "./hooks";
30
+ export * as types from "./types";
package/dist/index.js CHANGED
@@ -10,8 +10,17 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
10
10
  if (k2 === undefined) k2 = k;
11
11
  o[k2] = m[k];
12
12
  }));
13
- var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
- for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || function (mod) {
19
+ if (mod && mod.__esModule) return mod;
20
+ var result = {};
21
+ if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
22
+ __setModuleDefault(result, mod);
23
+ return result;
15
24
  };
16
25
  var __rest = (this && this.__rest) || function (s, e) {
17
26
  var t = {};
@@ -25,16 +34,10 @@ var __rest = (this && this.__rest) || function (s, e) {
25
34
  return t;
26
35
  };
27
36
  Object.defineProperty(exports, "__esModule", { value: true });
28
- exports.createReActor = exports.createReActorCore = void 0;
37
+ exports.types = exports.hooks = exports.actor = exports.agent = exports.createReActor = void 0;
29
38
  const core_1 = require("@ic-reactor/core");
30
39
  const actor_1 = require("./hooks/actor");
31
40
  const auth_1 = require("./hooks/auth");
32
- var core_2 = require("@ic-reactor/core");
33
- Object.defineProperty(exports, "createReActorCore", { enumerable: true, get: function () { return core_2.createReActor; } });
34
- __exportStar(require("@ic-reactor/core"), exports);
35
- __exportStar(require("./context/agent"), exports);
36
- __exportStar(require("./context/actor"), exports);
37
- __exportStar(require("./hooks"), exports);
38
41
  const createReActor = (_a) => {
39
42
  var { isLocalEnv, withVisitor, withProcessEnv } = _a, options = __rest(_a, ["isLocalEnv", "withVisitor", "withProcessEnv"]);
40
43
  isLocalEnv =
@@ -61,3 +64,7 @@ const createReActor = (_a) => {
61
64
  getVisitFunction }, actorHooks), authHooks);
62
65
  };
63
66
  exports.createReActor = createReActor;
67
+ exports.agent = __importStar(require("./context/agent"));
68
+ exports.actor = __importStar(require("./context/actor"));
69
+ exports.hooks = __importStar(require("./hooks"));
70
+ exports.types = __importStar(require("./types"));
package/dist/types.d.ts CHANGED
@@ -1,7 +1,10 @@
1
1
  /// <reference types="react" />
2
- import type { ActorState, CanisterId, CreateReActorOptions, ActorMethodArgs, ActorMethodReturnType, HttpAgent, Identity, Principal, FunctionName, VisitService } from "@ic-reactor/core";
3
- import type { AuthHooks } from "./hooks/auth";
4
- import { AgentHooks } from "./hooks/agent";
2
+ import type { ActorState, CanisterId, CreateReActorOptions, ActorMethodArgs, ActorMethodReturnType, HttpAgent, Identity, Principal, FunctionName, VisitService } from "@ic-reactor/core/dist/types";
3
+ import type { AgentHooks, AuthHooks } from "./hooks/types";
4
+ export * from "@ic-reactor/core/dist/types";
5
+ export * from "./context/agent/types";
6
+ export * from "./context/actor/types";
7
+ export * from "./hooks/types";
5
8
  export type AuthArgs = {
6
9
  onAuthentication?: (promise: () => Promise<Identity>) => void;
7
10
  onAuthenticationSuccess?: (identity: Identity) => void;
package/dist/types.js CHANGED
@@ -1,2 +1,20 @@
1
1
  "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
2
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("@ic-reactor/core/dist/types"), exports);
18
+ __exportStar(require("./context/agent/types"), exports);
19
+ __exportStar(require("./context/actor/types"), exports);
20
+ __exportStar(require("./hooks/types"), exports);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ic-reactor/react",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "A React library for interacting with Internet Computer canisters",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -24,7 +24,7 @@
24
24
  "bugs": {
25
25
  "url": "https://github.com/b3hr4d/ic-reactor/issues"
26
26
  },
27
- "homepage": "https://github.com/b3hr4d/ic-reactor/tree/main/packages/react#readme",
27
+ "homepage": "https://b3pay.github.io/ic-reactor/modules/react.html",
28
28
  "scripts": {
29
29
  "test": "npx jest",
30
30
  "start": "tsc watch",
@@ -35,7 +35,7 @@
35
35
  "node": ">=10"
36
36
  },
37
37
  "dependencies": {
38
- "@ic-reactor/core": "^1.0.0",
38
+ "@ic-reactor/core": "^1.0.1",
39
39
  "zustand-utils": "^1.3"
40
40
  },
41
41
  "peerDependencies": {
@@ -48,5 +48,5 @@
48
48
  "react": ">=16.8",
49
49
  "zustand": "4.5"
50
50
  },
51
- "gitHead": "ca9e2f3438a4566c26d5ce56b0f0b953aa93df53"
51
+ "gitHead": "54c9942a98bcad64e63c8d52788103f8b168720e"
52
52
  }