@ic-reactor/react 2.0.1 → 3.0.0-beta.2

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,22 +1,5 @@
-"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("./context/actor/types"), exports);
-__exportStar(require("./context/agent/types"), exports);
-__exportStar(require("./context/adapter/types"), exports);
-__exportStar(require("./helpers/types"), exports);
-__exportStar(require("./hooks/types"), exports);
-__exportStar(require("@ic-reactor/core/dist/types"), exports);
+/**
+ * Shared type definitions for query factories (createActorQuery, createActorSuspenseQuery, etc.)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/validation.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Validation utilities for React
+ *
+ * Helpers for working with ValidationError in React components,
+ * especially for form integration.
+ */
+import { ValidationError, isValidationError, ValidationIssue } from "@ic-reactor/core";
+export { isValidationError, ValidationError };
+export type { ValidationIssue };
+/**
+ * A map of field names to error messages.
+ * This format is compatible with most form libraries.
+ */
+export type FieldErrors = Record<string, string>;
+/**
+ * A map of field names to arrays of error messages.
+ * Use when you need to show multiple errors per field.
+ */
+export type FieldErrorsMultiple = Record<string, string[]>;
+/**
+ * Options for mapValidationErrors
+ */
+export interface MapValidationErrorsOptions {
+    /**
+     * If true, returns all messages for each field as an array.
+     * If false (default), returns only the first message for each field.
+     */
+    multiple?: boolean;
+}
+/**
+ * Maps validation error issues to a simple field -> message object.
+ * Returns the first error message for each field path.
+ *
+ * @example
+ * ```tsx
+ * const { mutate } = useActorMutation({
+ *   functionName: "transfer",
+ *   onError: (error) => {
+ *     if (isValidationError(error)) {
+ *       const fieldErrors = mapValidationErrors(error)
+ *       // { to: "Recipient is required", amount: "Must be a number" }
+ *
+ *       // Use with React Hook Form
+ *       Object.entries(fieldErrors).forEach(([field, message]) => {
+ *         form.setError(field, { message })
+ *       })
+ *     }
+ *   }
+ * })
+ * ```
+ */
+export declare function mapValidationErrors(error: ValidationError): FieldErrors;
+export declare function mapValidationErrors(error: ValidationError, options: {
+    multiple: true;
+}): FieldErrorsMultiple;
+export declare function mapValidationErrors(error: ValidationError, options: {
+    multiple: false;
+}): FieldErrors;
+/**
+ * Gets error message for a specific field from a ValidationError.
+ * Returns undefined if no error exists for that field.
+ *
+ * @example
+ * ```tsx
+ * if (isValidationError(error)) {
+ *   const toError = getFieldError(error, "to")
+ *   const amountError = getFieldError(error, "amount")
+ * }
+ * ```
+ */
+export declare function getFieldError(error: ValidationError, fieldName: string): string | undefined;
+/**
+ * Gets all error messages for a specific field from a ValidationError.
+ * Returns empty array if no errors exist for that field.
+ *
+ * @example
+ * ```tsx
+ * if (isValidationError(error)) {
+ *   const amountErrors = getFieldErrors(error, "amount")
+ *   // ["Amount is required", "Amount must be positive"]
+ * }
+ * ```
+ */
+export declare function getFieldErrors(error: ValidationError, fieldName: string): string[];
+/**
+ * Checks if a given error is a ValidationError and optionally
+ * extracts field errors in one step.
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync } = useActorMutation({ functionName: "transfer" })
+ *
+ * const handleSubmit = async (data) => {
+ *   try {
+ *     await mutateAsync([data])
+ *   } catch (error) {
+ *     const fieldErrors = extractValidationErrors(error)
+ *     if (fieldErrors) {
+ *       // Handle validation errors
+ *       Object.entries(fieldErrors).forEach(([field, message]) => {
+ *         form.setError(field, { message })
+ *       })
+ *     } else {
+ *       // Handle other errors
+ *       console.error(error)
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare function extractValidationErrors(error: unknown): FieldErrors | null;
+/**
+ * React hook-friendly error handler that extracts validation errors.
+ * Returns a callback suitable for onError handlers.
+ *
+ * @example
+ * ```tsx
+ * const [fieldErrors, setFieldErrors] = useState<FieldErrors>({})
+ *
+ * const { mutate } = useActorMutation({
+ *   functionName: "transfer",
+ *   onError: handleValidationError(setFieldErrors),
+ * })
+ *
+ * // In JSX
+ * <input name="to" />
+ * {fieldErrors.to && <span className="error">{fieldErrors.to}</span>}
+ * ```
+ */
+export declare function handleValidationError(setFieldErrors: (errors: FieldErrors) => void, onOtherError?: (error: Error) => void): (error: Error) => void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEhD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,CAAA;AACxE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GAC1B,mBAAmB,CAAA;AACtB,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAA;CAAE,GAC3B,WAAW,CAAA;AA2Bd;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAIV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAK1E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,EAC7C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GACpC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CASxB"}

package/dist/validation.js

@@ -0,0 +1,125 @@
+/**
+ * Validation utilities for React
+ *
+ * Helpers for working with ValidationError in React components,
+ * especially for form integration.
+ */
+import { ValidationError, isValidationError, } from "@ic-reactor/core";
+// Re-export for convenience
+export { isValidationError, ValidationError };
+export function mapValidationErrors(error, options) {
+    if (options?.multiple) {
+        const result = {};
+        for (const issue of error.issues) {
+            const fieldName = String(issue.path[0] ?? "");
+            if (!result[fieldName]) {
+                result[fieldName] = [];
+            }
+            result[fieldName].push(issue.message);
+        }
+        return result;
+    }
+    const result = {};
+    for (const issue of error.issues) {
+        const fieldName = String(issue.path[0] ?? "");
+        if (!result[fieldName]) {
+            result[fieldName] = issue.message;
+        }
+    }
+    return result;
+}
+/**
+ * Gets error message for a specific field from a ValidationError.
+ * Returns undefined if no error exists for that field.
+ *
+ * @example
+ * ```tsx
+ * if (isValidationError(error)) {
+ *   const toError = getFieldError(error, "to")
+ *   const amountError = getFieldError(error, "amount")
+ * }
+ * ```
+ */
+export function getFieldError(error, fieldName) {
+    const issue = error.issues.find((i) => String(i.path[0]) === fieldName);
+    return issue?.message;
+}
+/**
+ * Gets all error messages for a specific field from a ValidationError.
+ * Returns empty array if no errors exist for that field.
+ *
+ * @example
+ * ```tsx
+ * if (isValidationError(error)) {
+ *   const amountErrors = getFieldErrors(error, "amount")
+ *   // ["Amount is required", "Amount must be positive"]
+ * }
+ * ```
+ */
+export function getFieldErrors(error, fieldName) {
+    return error.issues
+        .filter((i) => String(i.path[0]) === fieldName)
+        .map((i) => i.message);
+}
+/**
+ * Checks if a given error is a ValidationError and optionally
+ * extracts field errors in one step.
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync } = useActorMutation({ functionName: "transfer" })
+ *
+ * const handleSubmit = async (data) => {
+ *   try {
+ *     await mutateAsync([data])
+ *   } catch (error) {
+ *     const fieldErrors = extractValidationErrors(error)
+ *     if (fieldErrors) {
+ *       // Handle validation errors
+ *       Object.entries(fieldErrors).forEach(([field, message]) => {
+ *         form.setError(field, { message })
+ *       })
+ *     } else {
+ *       // Handle other errors
+ *       console.error(error)
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export function extractValidationErrors(error) {
+    if (isValidationError(error)) {
+        return mapValidationErrors(error);
+    }
+    return null;
+}
+/**
+ * React hook-friendly error handler that extracts validation errors.
+ * Returns a callback suitable for onError handlers.
+ *
+ * @example
+ * ```tsx
+ * const [fieldErrors, setFieldErrors] = useState<FieldErrors>({})
+ *
+ * const { mutate } = useActorMutation({
+ *   functionName: "transfer",
+ *   onError: handleValidationError(setFieldErrors),
+ * })
+ *
+ * // In JSX
+ * <input name="to" />
+ * {fieldErrors.to && <span className="error">{fieldErrors.to}</span>}
+ * ```
+ */
+export function handleValidationError(setFieldErrors, onOtherError) {
+    return (error) => {
+        const fieldErrors = extractValidationErrors(error);
+        if (fieldErrors) {
+            setFieldErrors(fieldErrors);
+        }
+        else if (onOtherError) {
+            onOtherError(error);
+        }
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,iBAAiB,GAElB,MAAM,kBAAkB,CAAA;AAEzB,4BAA4B;AAC5B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAA;AAyD7C,MAAM,UAAU,mBAAmB,CACjC,KAAsB,EACtB,OAAoC;IAEpC,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,MAAM,MAAM,GAAwB,EAAE,CAAA;QACtC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;YAC7C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAA;YACxB,CAAC;YACD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACvC,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,MAAM,GAAgB,EAAE,CAAA;IAC9B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC7C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,OAAO,CAAA;QACnC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAsB,EACtB,SAAiB;IAEjB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAA;IACvE,OAAO,KAAK,EAAE,OAAO,CAAA;AACvB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAsB,EACtB,SAAiB;IAEjB,OAAO,KAAK,CAAC,MAAM;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;SAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CACnC,cAA6C,EAC7C,YAAqC;IAErC,OAAO,CAAC,KAAY,EAAE,EAAE;QACtB,MAAM,WAAW,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAA;QAClD,IAAI,WAAW,EAAE,CAAC;YAChB,cAAc,CAAC,WAAW,CAAC,CAAA;QAC7B,CAAC;aAAM,IAAI,YAAY,EAAE,CAAC;YACxB,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -1,52 +1,87 @@
 {
   "name": "@ic-reactor/react",
-  "version": "2.0.1",
-  "description": "A React library for interacting with Internet Computer canisters",
+  "version": "3.0.0-beta.2",
+  "description": "IC Reactor React Library",
   "main": "dist/index.js",
+  "module": "dist/index.js",
   "types": "dist/index.d.ts",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
   "files": [
-    "dist/*"
+    "dist",
+    "README.md"
   ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "size": "size-limit",
+    "analyze": "size-limit --why"
+  },
   "repository": {
     "type": "git",
-    "url": "git@github.com:b3hr4d/ic-reactor.git"
+    "url": "https://github.com/B3Pay/ic-reactor",
+    "directory": "packages/react"
   },
+  "bugs": {
+    "url": "https://github.com/B3Pay/ic-reactor/issues"
+  },
+  "homepage": "https://ic-reactor.dev",
   "keywords": [
-    "actor",
-    "react",
-    "candid",
+    "internet-computer",
+    "icp",
     "dfinity",
+    "react",
+    "hooks",
     "web3",
-    "dapp"
+    "blockchain",
+    "canister",
+    "tanstack-query"
   ],
-  "author": "b3hr4d",
+  "author": "Behrad Deylami",
   "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/b3hr4d/ic-reactor/issues"
-  },
-  "homepage": "https://b3pay.github.io/ic-reactor/modules/react.html",
-  "scripts": {
-    "test": "bun test",
-    "start": "bun run tsc watch",
-    "build": "bun run tsc",
-    "clean": "bun run rimraf dist && bun run rimraf umd"
-  },
-  "engines": {
-    "node": ">=22.0.0"
-  },
-  "dependencies": {
-    "@ic-reactor/core": "2.0.1",
-    "zustand": "^5.0.6",
-    "zustand-utils": "^2.1.0"
-  },
   "peerDependencies": {
-    "@dfinity/agent": "^3.1.0",
-    "@dfinity/auth-client": "^3.1.0",
-    "@dfinity/candid": "^3.1.0",
-    "@dfinity/identity": "^3.1.0",
-    "@dfinity/principal": "^3.1.0",
-    "react": ">=19.0.0",
-    "zustand": "^5.0.6"
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "@ic-reactor/core": "workspace:^",
+    "@tanstack/react-query": "^5.0.0"
+  },
+  "devDependencies": {
+    "@icp-sdk/auth": "^5.0.0",
+    "@icp-sdk/core": "^5.0.0",
+    "@ic-reactor/core": "workspace:^",
+    "@size-limit/preset-small-lib": "^11.2.0",
+    "@tanstack/react-query": "^5.90",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.1",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "fake-indexeddb": "^6.2.5",
+    "jsdom": "^27.4.0",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "size-limit": "^11.2.0",
+    "vitest": "^4.0.16"
   },
-  "gitHead": "1c8f5bfc6b0fea9347602beeebd6443f79d7d54e"
+  "size-limit": [
+    {
+      "name": "React Library",
+      "path": "dist/index.js",
+      "limit": "30 KB",
+      "gzip": true,
+      "ignore": [
+        "react",
+        "react-dom",
+        "@ic-reactor/core",
+        "@tanstack/react-query"
+      ]
+    }
+  ]
 }

package/LICENSE.md

@@ -1,8 +0,0 @@
-The MIT License (MIT)
-Copyright © 2023 B3Pay
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

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

@@ -1,63 +0,0 @@
-import type { BaseActor } from "../../types";
-import type { CreateActorContextParameters, CreateActorContextReturnType } from "./types";
-/**
- * Creates a React context specifically designed for managing the state and interactions with an actor on the Internet Computer (IC) blockchain.
- * This context facilitates the dynamic creation and management of IC actors within React applications, leveraging the provided configuration options.
- *
- * @param reactorParameters A partial configuration object for the actor context, allowing customization and specification of actor-related settings.
- * - `canisterId`: The default Canister ID to be used if not overridden in the `ActorProvider` component.
- * - Other configurations can include properties related to the actor's interaction, such as agent options or authentication requirements.
- *
- * @returns An object containing the `ActorProvider` component and various hooks for interacting with the actor.
- * - `ActorProvider`: A context provider component that allows child components to access and interact with the configured actor.
- * - Hooks: Custom hooks derived from the actor context, facilitating interactions like querying or updating the actor's state.
- *
- * @example
- * ```jsx
- * import React from 'react';
- * import { createActorContext } from '@ic-reactor/react';
- * import { backend, canisterId, idlFactory } from './declarations/candid'; // Assuming 'declarations/candid' is where your actor interface is defined.
- *
- * // Initialize the actor context with configuration options
- * const { ActorProvider, useActorState, useQueryCall, useUpdateCall } = createActorContext<typeof backend>({
- *   canisterId,
- *   idlFactory, // Optional, wrap the ActorProvider with CandidAdapterProvider
- * });
- *
- * // A sample component that utilizes the actor context
- * const App = () => (
- *   <AgentProvider>
- *     <ActorProvider>
- *       <div>
- *         <h1>IC Actor Interaction Example</h1>
- *         <ActorComponent />
- *       </div>
- *     </ActorProvider>
- *   </AgentProvider>
- * );
- *
- * export default App;
- *
- * // A sample component that uses the actor hooks
- * const ActorComponent = () => {
- *   const { data, loading, error } = useQueryCall({
- *      functionName: 'backendMethodName',
- *      args: [],
- *      refetchInterval: 10000,
- *      refetchOnMount: true,
- *   });
-  
- *   return (
- *     <div>
- *        {loading && <p>Loading...</p>}
- *        {error && <p>Error: {error.message}</p>}
- *        {data && <p>Actor data: {data}</p>}
- *     </div>
- *   );
- * };
- * ```
- *
- * This function streamlines the process of setting up a context for IC actor interactions within a React app,
- * it provides a type-safe and efficient way to manage actor state and interactions.
- */
-export declare function createActorContext<A = BaseActor>(contextConfig?: CreateActorContextParameters): CreateActorContextReturnType<A>;

package/dist/context/actor/create.js

@@ -1,119 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createActorContext = createActorContext;
-const react_1 = __importDefault(require("react"));
-const useActor_1 = require("../../hooks/useActor");
-const extractActorContext_1 = require("../../helpers/extractActorContext");
-const useActorManager_1 = require("../../hooks/useActorManager");
-/**
- * Creates a React context specifically designed for managing the state and interactions with an actor on the Internet Computer (IC) blockchain.
- * This context facilitates the dynamic creation and management of IC actors within React applications, leveraging the provided configuration options.
- *
- * @param reactorParameters A partial configuration object for the actor context, allowing customization and specification of actor-related settings.
- * - `canisterId`: The default Canister ID to be used if not overridden in the `ActorProvider` component.
- * - Other configurations can include properties related to the actor's interaction, such as agent options or authentication requirements.
- *
- * @returns An object containing the `ActorProvider` component and various hooks for interacting with the actor.
- * - `ActorProvider`: A context provider component that allows child components to access and interact with the configured actor.
- * - Hooks: Custom hooks derived from the actor context, facilitating interactions like querying or updating the actor's state.
- *
- * @example
- * ```jsx
- * import React from 'react';
- * import { createActorContext } from '@ic-reactor/react';
- * import { backend, canisterId, idlFactory } from './declarations/candid'; // Assuming 'declarations/candid' is where your actor interface is defined.
- *
- * // Initialize the actor context with configuration options
- * const { ActorProvider, useActorState, useQueryCall, useUpdateCall } = createActorContext<typeof backend>({
- *   canisterId,
- *   idlFactory, // Optional, wrap the ActorProvider with CandidAdapterProvider
- * });
- *
- * // A sample component that utilizes the actor context
- * const App = () => (
- *   <AgentProvider>
- *     <ActorProvider>
- *       <div>
- *         <h1>IC Actor Interaction Example</h1>
- *         <ActorComponent />
- *       </div>
- *     </ActorProvider>
- *   </AgentProvider>
- * );
- *
- * export default App;
- *
- * // A sample component that uses the actor hooks
- * const ActorComponent = () => {
- *   const { data, loading, error } = useQueryCall({
- *      functionName: 'backendMethodName',
- *      args: [],
- *      refetchInterval: 10000,
- *      refetchOnMount: true,
- *   });
-  
- *   return (
- *     <div>
- *        {loading && <p>Loading...</p>}
- *        {error && <p>Error: {error.message}</p>}
- *        {data && <p>Actor data: {data}</p>}
- *     </div>
- *   );
- * };
- * ```
- *
- * This function streamlines the process of setting up a context for IC actor interactions within a React app,
- * it provides a type-safe and efficient way to manage actor state and interactions.
- */
-function createActorContext(contextConfig = {}) {
-    const { canisterId: defaultCanisterId, ...defaultConfig } = contextConfig;
-    const ActorContext = react_1.default.createContext(null);
-    const ActorProvider = ({ children, fetchingComponent, canisterId = defaultCanisterId, errorComponent = (error) => react_1.default.createElement("div", null, error), loadingComponent = react_1.default.createElement("div", null, "Loading canister..."), authenticatingComponent = react_1.default.createElement("div", null, "Authenticating..."), ...restConfig }) => {
-        if (!canisterId) {
-            throw new Error("canisterId is required");
-        }
-        const config = react_1.default.useMemo(() => ({
-            ...defaultConfig,
-            ...restConfig,
-        }), [defaultConfig, restConfig]);
-        const { fetchError, isAuthenticating: authenticating, initializeActor, hooks, } = (0, useActor_1.useActor)({
-            canisterId,
-            ...config,
-        });
-        const useInitializeActor = react_1.default.useCallback(() => {
-            return initializeActor;
-        }, [initializeActor]);
-        const ActorChildren = ({ useActorState }) => {
-            const { isInitializing, isInitialized, error } = useActorState();
-            return isInitializing
-                ? loadingComponent
-                : isInitialized
-                    ? children
-                    : error
-                        ? errorComponent(error.message)
-                        : null;
-        };
-        return (react_1.default.createElement(ActorContext.Provider, { value: { ...hooks, useInitializeActor } },
-            fetchingComponent,
-            hooks === null ? (fetchError ? (errorComponent(fetchError)) : authenticating ? (authenticatingComponent) : (loadingComponent)) : (react_1.default.createElement(ActorChildren, { useActorState: hooks.useActorState }, children))));
-    };
-    ActorProvider.displayName = "ActorProvider";
-    const ActorHookProvider = ({ hooks, children, }) => {
-        return (react_1.default.createElement(ActorContext.Provider, { value: hooks }, children));
-    };
-    const ActorManagerProvider = ({ actorManager, children, }) => {
-        const { hooks } = (0, useActorManager_1.useActorManager)({
-            actorManager,
-        });
-        return (react_1.default.createElement(ActorContext.Provider, { value: hooks }, children));
-    };
-    return {
-        ActorProvider,
-        ActorHookProvider,
-        ActorManagerProvider,
-        ...(0, extractActorContext_1.extractActorContext)(ActorContext),
-    };
-}

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

@@ -1,4 +0,0 @@
-/**
- *
- */
-export declare function useActorInterface(): import("@dfinity/candid/lib/esm/idl").ServiceClass;

package/dist/context/actor/hooks/useActorInterface.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useActorInterface = useActorInterface;
-const __1 = require("..");
-/**
- *
- */
-function useActorInterface() {
-    return __1.ActorHooks.useActorInterface();
-}