@near-kit/react 0.8.3

package/README.md

@@ -0,0 +1,385 @@
+# @near-kit/react
+
+React bindings for [near-kit](https://github.com/r-near/near-kit) — a simple, intuitive TypeScript library for interacting with NEAR Protocol.
+
+## Installation
+
+```bash
+npm install @near-kit/react near-kit
+# or
+bun add @near-kit/react near-kit
+```
+
+## Quick Start
+
+```tsx
+import { NearProvider, useNear, useView, useCall } from "@near-kit/react"
+
+function App() {
+  return (
+    <NearProvider config={{ network: "testnet" }}>
+      <Counter />
+    </NearProvider>
+  )
+}
+
+function Counter() {
+  const { data: count, isLoading } = useView<{}, number>({
+    contractId: "counter.testnet",
+    method: "get_count",
+  })
+
+  const { mutate: increment, isPending } = useCall({
+    contractId: "counter.testnet",
+    method: "increment",
+  })
+
+  if (isLoading) return <div>Loading...</div>
+
+  return (
+    <button onClick={() => increment({})} disabled={isPending}>
+      Count: {count}
+    </button>
+  )
+}
+```
+
+## Philosophy
+
+This package provides **thin, ergonomic wrappers** around `near-kit`. The hooks handle basic React state (loading, error, data) without reimplementing caching, deduplication, or advanced features.
+
+**For simple apps:** Use the built-in hooks directly.
+
+**For advanced use cases:** Use `useNear()` with [React Query](#react-query-integration) or [SWR](#swr-integration) for caching, polling, optimistic updates, and more.
+
+## API Reference
+
+### Provider & Context
+
+#### `<NearProvider>`
+
+Provides a `Near` client to all child components.
+
+```tsx
+// Option 1: Pass configuration (creates Near instance internally)
+<NearProvider config={{ network: "testnet" }}>
+  <App />
+</NearProvider>
+
+// Option 2: Pass an existing Near instance
+const near = new Near({ network: "testnet", privateKey: "..." })
+<NearProvider near={near}>
+  <App />
+</NearProvider>
+```
+
+#### `useNear()`
+
+Returns the `Near` client from context. Use this for direct access or integration with React Query/SWR.
+
+```tsx
+function MyComponent() {
+  const near = useNear()
+  // near.view(), near.call(), near.send(), near.transaction(), etc.
+}
+```
+
+### View Hooks
+
+#### `useView<TArgs, TResult>(params)`
+
+Calls a view method on a contract.
+
+```tsx
+const { data, isLoading, error, refetch } = useView<{ account_id: string }, string>({
+  contractId: "token.testnet",
+  method: "ft_balance_of",
+  args: { account_id: "alice.testnet" },
+  enabled: true, // optional, default: true
+})
+```
+
+#### `useBalance(params)`
+
+Fetches an account's NEAR balance.
+
+```tsx
+const { data: balance, isLoading } = useBalance({
+  accountId: "alice.testnet",
+})
+```
+
+#### `useAccountExists(params)`
+
+Checks if an account exists.
+
+```tsx
+const { data: exists } = useAccountExists({
+  accountId: "alice.testnet",
+})
+```
+
+### Mutation Hooks
+
+#### `useCall<TArgs, TResult>(params)`
+
+Calls a change method on a contract.
+
+```tsx
+const { mutate, data, isPending, isSuccess, isError, error, reset } = useCall<
+  { amount: number },
+  void
+>({
+  contractId: "counter.testnet",
+  method: "increment",
+  options: { gas: "30 Tgas" }, // optional defaults
+})
+
+// Execute the call
+await mutate({ amount: 1 })
+
+// Override options per-call
+await mutate({ amount: 1 }, { attachedDeposit: "0.1 NEAR" })
+```
+
+#### `useSend()`
+
+Sends NEAR tokens.
+
+```tsx
+const { mutate: send, isPending, isSuccess, isError, error, reset } = useSend()
+
+await send("bob.testnet", "1 NEAR")
+```
+
+### Account Hook
+
+#### `useAccount()`
+
+Returns the current connected account state.
+
+```tsx
+const { accountId, isConnected, isLoading, refetch } = useAccount()
+```
+
+### Typed Contract Hook
+
+#### `useContract<T>(contractId)`
+
+Returns a typed contract instance for full TypeScript inference.
+
+```tsx
+import type { Contract } from "near-kit"
+
+type MyContract = Contract<{
+  view: {
+    get_balance: (args: { account_id: string }) => Promise<string>
+  }
+  call: {
+    transfer: (args: { to: string; amount: string }) => Promise<void>
+  }
+}>
+
+function TokenBalance() {
+  const contract = useContract<MyContract>("token.testnet")
+
+  // Fully typed!
+  const balance = await contract.view.get_balance({ account_id: "..." })
+}
+```
+
+## React Query Integration
+
+For caching, polling, background refetching, and devtools, use React Query with `useNear()`:
+
+```tsx
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query"
+import { useNear } from "@near-kit/react"
+
+function useContractView<TArgs extends object, TResult>(
+  contractId: string,
+  method: string,
+  args: TArgs
+) {
+  const near = useNear()
+
+  return useQuery({
+    queryKey: ["near", "view", contractId, method, args],
+    queryFn: () => near.view<TResult>(contractId, method, args),
+  })
+}
+
+function useContractCall<TArgs extends object, TResult>(
+  contractId: string,
+  method: string
+) {
+  const near = useNear()
+  const queryClient = useQueryClient()
+
+  return useMutation({
+    mutationFn: (args: TArgs) => near.call<TResult>(contractId, method, args),
+    onSuccess: () => {
+      // Invalidate relevant queries after mutation
+      queryClient.invalidateQueries({ queryKey: ["near", "view", contractId] })
+    },
+  })
+}
+
+// Usage
+function Counter() {
+  const { data: count, isLoading } = useContractView<{}, number>(
+    "counter.testnet",
+    "get_count",
+    {}
+  )
+
+  const { mutate: increment } = useContractCall<{}, void>(
+    "counter.testnet",
+    "increment"
+  )
+
+  return (
+    <button onClick={() => increment({})}>
+      Count: {isLoading ? "..." : count}
+    </button>
+  )
+}
+```
+
+### With Polling
+
+```tsx
+const { data: balance } = useQuery({
+  queryKey: ["near", "balance", accountId],
+  queryFn: () => near.getBalance(accountId),
+  refetchInterval: 5000, // Poll every 5 seconds
+})
+```
+
+## SWR Integration
+
+For a lighter alternative, use SWR with `useNear()`:
+
+```tsx
+import useSWR from "swr"
+import useSWRMutation from "swr/mutation"
+import { useNear } from "@near-kit/react"
+
+function useContractView<TArgs extends object, TResult>(
+  contractId: string,
+  method: string,
+  args: TArgs
+) {
+  const near = useNear()
+  const key = ["near", "view", contractId, method, JSON.stringify(args)]
+
+  return useSWR(key, () => near.view<TResult>(contractId, method, args))
+}
+
+function useContractCall<TArgs extends object, TResult>(
+  contractId: string,
+  method: string
+) {
+  const near = useNear()
+  const key = ["near", "call", contractId, method]
+
+  return useSWRMutation(key, (_key, { arg }: { arg: TArgs }) =>
+    near.call<TResult>(contractId, method, arg)
+  )
+}
+
+// Usage
+function Counter() {
+  const { data: count, isLoading } = useContractView<{}, number>(
+    "counter.testnet",
+    "get_count",
+    {}
+  )
+
+  const { trigger: increment, isMutating } = useContractCall<{}, void>(
+    "counter.testnet",
+    "increment"
+  )
+
+  return (
+    <button onClick={() => increment({})} disabled={isMutating}>
+      Count: {isLoading ? "..." : count}
+    </button>
+  )
+}
+```
+
+### With Polling
+
+```tsx
+const { data: balance } = useSWR(
+  ["near", "balance", accountId],
+  () => near.getBalance(accountId),
+  { refreshInterval: 5000 }
+)
+```
+
+## Wallet Integration
+
+### With Wallet Selector
+
+```tsx
+import { setupWalletSelector } from "@near-wallet-selector/core"
+import { fromWalletSelector } from "near-kit"
+
+const selector = await setupWalletSelector({
+  network: "testnet",
+  modules: [/* your wallet modules */],
+})
+const wallet = await selector.wallet()
+
+<NearProvider
+  config={{
+    network: "testnet",
+    wallet: fromWalletSelector(wallet),
+  }}
+>
+  <App />
+</NearProvider>
+```
+
+### With HOT Connect
+
+```tsx
+import { setupNearConnect } from "@hot-labs/near-connect"
+import { fromHotConnect } from "near-kit"
+
+const connect = await setupNearConnect({ network: "testnet" })
+
+<NearProvider
+  config={{
+    network: "testnet",
+    wallet: fromHotConnect(connect),
+  }}
+>
+  <App />
+</NearProvider>
+```
+
+## SSR / Next.js
+
+This package is marked with `"use client"` and is designed for client-side use only. In Next.js App Router, wrap the provider in a client component:
+
+```tsx
+// app/providers.tsx
+"use client"
+
+import { NearProvider } from "@near-kit/react"
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  return (
+    <NearProvider config={{ network: "testnet" }}>
+      {children}
+    </NearProvider>
+  )
+}
+```
+
+## License
+
+MIT

package/dist/account.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Account state returned by useAccount
+ */
+export interface AccountState {
+    /** The connected account ID, if any */
+    accountId: string | undefined;
+    /** Whether any account is connected */
+    isConnected: boolean;
+    /** Whether the account state is still being fetched */
+    isLoading: boolean;
+    /** Function to refresh the account state */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to get the current account state.
+ *
+ * Derives state from whichever signer/wallet was passed to the Near client
+ * (via wallet, privateKey, keyStore, etc.).
+ *
+ * Note: This hook accesses internal Near client state which may change between versions.
+ *
+ * @example
+ * ```tsx
+ * function Header() {
+ *   const { accountId, isConnected, isLoading } = useAccount()
+ *
+ *   if (isLoading) return <>Loading...</>
+ *   if (!isConnected) return <>Not connected</>
+ *   return <>Connected as {accountId}</>
+ * }
+ * ```
+ */
+export declare function useAccount(): AccountState;
+//# sourceMappingURL=account.d.ts.map

package/dist/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.tsx"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,uCAAuC;IACvC,WAAW,EAAE,OAAO,CAAA;IACpB,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAA;IAClB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAuDzC"}

package/dist/account.js

@@ -0,0 +1,69 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { useNear } from "./provider.js";
+/**
+ * Hook to get the current account state.
+ *
+ * Derives state from whichever signer/wallet was passed to the Near client
+ * (via wallet, privateKey, keyStore, etc.).
+ *
+ * Note: This hook accesses internal Near client state which may change between versions.
+ *
+ * @example
+ * ```tsx
+ * function Header() {
+ *   const { accountId, isConnected, isLoading } = useAccount()
+ *
+ *   if (isLoading) return <>Loading...</>
+ *   if (!isConnected) return <>Not connected</>
+ *   return <>Connected as {accountId}</>
+ * }
+ * ```
+ */
+export function useAccount() {
+    const near = useNear();
+    const [accountId, setAccountId] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(true);
+    const fetchAccount = useCallback(async () => {
+        setIsLoading(true);
+        try {
+            // Access internal wallet/signer state via type assertion
+            // This is intentionally coupling to Near internals
+            const nearInternal = near;
+            // First, check if there's a wallet connection
+            if (nearInternal.wallet) {
+                const accounts = await nearInternal.wallet.getAccounts();
+                const firstAccount = accounts[0];
+                if (firstAccount) {
+                    setAccountId(firstAccount.accountId);
+                    setIsLoading(false);
+                    return;
+                }
+            }
+            // Fall back to default signer ID if set
+            if (nearInternal.defaultSignerId) {
+                setAccountId(nearInternal.defaultSignerId);
+                setIsLoading(false);
+                return;
+            }
+            // No account found
+            setAccountId(undefined);
+        }
+        catch {
+            setAccountId(undefined);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [near]);
+    useEffect(() => {
+        void fetchAccount();
+    }, [fetchAccount]);
+    return {
+        accountId,
+        isConnected: accountId !== undefined,
+        isLoading,
+        refetch: fetchAccount,
+    };
+}
+//# sourceMappingURL=account.js.map

package/dist/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../src/account.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAgBvC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;IAEtB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAqB,SAAS,CAAC,CAAA;IACzE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAEhD,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC1C,YAAY,CAAC,IAAI,CAAC,CAAA;QAClB,IAAI,CAAC;YACH,yDAAyD;YACzD,mDAAmD;YACnD,MAAM,YAAY,GAAG,IAKpB,CAAA;YAED,8CAA8C;YAC9C,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;gBACxD,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;gBAChC,IAAI,YAAY,EAAE,CAAC;oBACjB,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;oBACpC,YAAY,CAAC,KAAK,CAAC,CAAA;oBACnB,OAAM;gBACR,CAAC;YACH,CAAC;YAED,wCAAwC;YACxC,IAAI,YAAY,CAAC,eAAe,EAAE,CAAC;gBACjC,YAAY,CAAC,YAAY,CAAC,eAAe,CAAC,CAAA;gBAC1C,YAAY,CAAC,KAAK,CAAC,CAAA;gBACnB,OAAM;YACR,CAAC;YAED,mBAAmB;YACnB,YAAY,CAAC,SAAS,CAAC,CAAA;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,CAAC,SAAS,CAAC,CAAA;QACzB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IAEV,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,YAAY,EAAE,CAAA;IACrB,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IAElB,OAAO;QACL,SAAS;QACT,WAAW,EAAE,SAAS,KAAK,SAAS;QACpC,SAAS;QACT,OAAO,EAAE,YAAY;KACtB,CAAA;AACH,CAAC"}

package/dist/contract.d.ts

@@ -0,0 +1,29 @@
+import type { ContractMethods } from "near-kit";
+/**
+ * Hook to get a typed contract instance.
+ *
+ * This provides full TypeScript inference for contract methods.
+ *
+ * @example
+ * ```tsx
+ * import type { Contract } from "near-kit"
+ *
+ * type MyContract = Contract<{
+ *   view: {
+ *     get_balance: (args: { account_id: string }) => Promise<string>
+ *   }
+ *   call: {
+ *     transfer: (args: { to: string; amount: string }) => Promise<void>
+ *   }
+ * }>
+ *
+ * function WalletBalance() {
+ *   const contract = useContract<MyContract>("token.testnet")
+ *
+ *   // Fully typed!
+ *   const balance = await contract.view.get_balance({ account_id: "..." })
+ * }
+ * ```
+ */
+export declare function useContract<T extends ContractMethods>(contractId: string): T;
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,CAG5E"}

package/dist/contract.js

@@ -0,0 +1,33 @@
+"use client";
+import { useNear } from "./provider.js";
+/**
+ * Hook to get a typed contract instance.
+ *
+ * This provides full TypeScript inference for contract methods.
+ *
+ * @example
+ * ```tsx
+ * import type { Contract } from "near-kit"
+ *
+ * type MyContract = Contract<{
+ *   view: {
+ *     get_balance: (args: { account_id: string }) => Promise<string>
+ *   }
+ *   call: {
+ *     transfer: (args: { to: string; amount: string }) => Promise<void>
+ *   }
+ * }>
+ *
+ * function WalletBalance() {
+ *   const contract = useContract<MyContract>("token.testnet")
+ *
+ *   // Fully typed!
+ *   const balance = await contract.view.get_balance({ account_id: "..." })
+ * }
+ * ```
+ */
+export function useContract(contractId) {
+    const near = useNear();
+    return near.contract(contractId);
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAGZ,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,WAAW,CAA4B,UAAkB;IACvE,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;IACtB,OAAO,IAAI,CAAC,QAAQ,CAAI,UAAU,CAAC,CAAA;AACrC,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,96 @@
+import type { NearError } from "near-kit";
+/**
+ * Result shape for view hooks
+ */
+export interface ViewResult<T> {
+    /** The data returned from the view call */
+    data: T | undefined;
+    /** Any error that occurred */
+    error: NearError | Error | undefined;
+    /** Whether the view call is in progress */
+    isLoading: boolean;
+    /** Manually trigger a refetch */
+    refetch: () => Promise<void>;
+}
+/**
+ * Parameters for useView hook
+ */
+export interface UseViewParams<TArgs extends object = object> {
+    /** Contract account ID */
+    contractId: string;
+    /** View method name */
+    method: string;
+    /** Arguments to pass to the method */
+    args?: TArgs;
+    /** Whether the query is enabled (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Hook for calling view functions on NEAR contracts.
+ *
+ * This is a thin wrapper around `near.view()` that provides React state management.
+ * For advanced features like caching, polling, or deduplication, use React Query or SWR
+ * with the `useNear()` hook directly.
+ *
+ * @example
+ * ```tsx
+ * function Counter() {
+ *   const { data: count, isLoading, error, refetch } = useView<{}, number>({
+ *     contractId: "counter.testnet",
+ *     method: "get_count",
+ *   })
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (error) return <div>Error: {error.message}</div>
+ *   return <div>Count: {count}</div>
+ * }
+ * ```
+ */
+export declare function useView<TArgs extends object = object, TResult = unknown>(params: UseViewParams<TArgs>): ViewResult<TResult>;
+/**
+ * Parameters for useBalance hook
+ */
+export interface UseBalanceParams {
+    /** Account ID to check balance for */
+    accountId: string;
+    /** Whether the query is enabled (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Hook for fetching an account's NEAR balance.
+ *
+ * @example
+ * ```tsx
+ * function Balance({ accountId }: { accountId: string }) {
+ *   const { data: balance, isLoading } = useBalance({ accountId })
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   return <div>Balance: {balance}</div>
+ * }
+ * ```
+ */
+export declare function useBalance(params: UseBalanceParams): ViewResult<string>;
+/**
+ * Parameters for useAccountExists hook
+ */
+export interface UseAccountExistsParams {
+    /** Account ID to check */
+    accountId: string;
+    /** Whether the query is enabled (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Hook for checking if a NEAR account exists.
+ *
+ * @example
+ * ```tsx
+ * function AccountCheck({ accountId }: { accountId: string }) {
+ *   const { data: exists, isLoading } = useAccountExists({ accountId })
+ *
+ *   if (isLoading) return <div>Checking...</div>
+ *   return <div>{exists ? "Account exists" : "Account not found"}</div>
+ * }
+ * ```
+ */
+export declare function useAccountExists(params: UseAccountExistsParams): ViewResult<boolean>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAIzC;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,CAAC,GAAG,SAAS,CAAA;IACnB,8BAA8B;IAC9B,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,CAAA;IACpC,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAA;IAClB,iCAAiC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IAC1D,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,IAAI,CAAC,EAAE,KAAK,CAAA;IACZ,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,GAAG,OAAO,EACtE,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,GAC3B,UAAU,CAAC,OAAO,CAAC,CAsDrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC,CAuCvE;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,sBAAsB,GAC7B,UAAU,CAAC,OAAO,CAAC,CAuCrB"}

package/dist/hooks.js

@@ -0,0 +1,171 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useNear } from "./provider.js";
+/**
+ * Hook for calling view functions on NEAR contracts.
+ *
+ * This is a thin wrapper around `near.view()` that provides React state management.
+ * For advanced features like caching, polling, or deduplication, use React Query or SWR
+ * with the `useNear()` hook directly.
+ *
+ * @example
+ * ```tsx
+ * function Counter() {
+ *   const { data: count, isLoading, error, refetch } = useView<{}, number>({
+ *     contractId: "counter.testnet",
+ *     method: "get_count",
+ *   })
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (error) return <div>Error: {error.message}</div>
+ *   return <div>Count: {count}</div>
+ * }
+ * ```
+ */
+export function useView(params) {
+    const { contractId, method, args, enabled = true } = params;
+    const near = useNear();
+    const [data, setData] = useState(undefined);
+    const [error, setError] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(enabled);
+    // Serialize args for dependency comparison
+    const argsKey = JSON.stringify(args ?? {});
+    // Track current request to ignore stale responses
+    const requestIdRef = useRef(0);
+    // Store args in a ref to avoid dependency issues
+    const argsRef = useRef(args);
+    argsRef.current = args;
+    // biome-ignore lint/correctness/useExhaustiveDependencies: argsKey intentionally triggers refetch when args change
+    const fetchData = useCallback(async () => {
+        if (!enabled) {
+            setIsLoading(false);
+            return;
+        }
+        const currentRequestId = ++requestIdRef.current;
+        setIsLoading(true);
+        setError(undefined);
+        try {
+            const result = await near.view(contractId, method, argsRef.current ?? {});
+            // Ignore if a newer request has started
+            if (currentRequestId !== requestIdRef.current)
+                return;
+            setData(result);
+        }
+        catch (err) {
+            // Ignore if a newer request has started
+            if (currentRequestId !== requestIdRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            if (currentRequestId === requestIdRef.current) {
+                setIsLoading(false);
+            }
+        }
+    }, [near, contractId, method, argsKey, enabled]);
+    useEffect(() => {
+        void fetchData();
+    }, [fetchData]);
+    return { data, error, isLoading, refetch: fetchData };
+}
+/**
+ * Hook for fetching an account's NEAR balance.
+ *
+ * @example
+ * ```tsx
+ * function Balance({ accountId }: { accountId: string }) {
+ *   const { data: balance, isLoading } = useBalance({ accountId })
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   return <div>Balance: {balance}</div>
+ * }
+ * ```
+ */
+export function useBalance(params) {
+    const { accountId, enabled = true } = params;
+    const near = useNear();
+    const [data, setData] = useState(undefined);
+    const [error, setError] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(enabled);
+    const requestIdRef = useRef(0);
+    const fetchData = useCallback(async () => {
+        if (!enabled || !accountId) {
+            setIsLoading(false);
+            return;
+        }
+        const currentRequestId = ++requestIdRef.current;
+        setIsLoading(true);
+        setError(undefined);
+        try {
+            const result = await near.getBalance(accountId);
+            if (currentRequestId !== requestIdRef.current)
+                return;
+            setData(result);
+        }
+        catch (err) {
+            if (currentRequestId !== requestIdRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            if (currentRequestId === requestIdRef.current) {
+                setIsLoading(false);
+            }
+        }
+    }, [near, accountId, enabled]);
+    useEffect(() => {
+        void fetchData();
+    }, [fetchData]);
+    return { data, error, isLoading, refetch: fetchData };
+}
+/**
+ * Hook for checking if a NEAR account exists.
+ *
+ * @example
+ * ```tsx
+ * function AccountCheck({ accountId }: { accountId: string }) {
+ *   const { data: exists, isLoading } = useAccountExists({ accountId })
+ *
+ *   if (isLoading) return <div>Checking...</div>
+ *   return <div>{exists ? "Account exists" : "Account not found"}</div>
+ * }
+ * ```
+ */
+export function useAccountExists(params) {
+    const { accountId, enabled = true } = params;
+    const near = useNear();
+    const [data, setData] = useState(undefined);
+    const [error, setError] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(enabled);
+    const requestIdRef = useRef(0);
+    const fetchData = useCallback(async () => {
+        if (!enabled || !accountId) {
+            setIsLoading(false);
+            return;
+        }
+        const currentRequestId = ++requestIdRef.current;
+        setIsLoading(true);
+        setError(undefined);
+        try {
+            const result = await near.accountExists(accountId);
+            if (currentRequestId !== requestIdRef.current)
+                return;
+            setData(result);
+        }
+        catch (err) {
+            if (currentRequestId !== requestIdRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            if (currentRequestId === requestIdRef.current) {
+                setIsLoading(false);
+            }
+        }
+    }, [near, accountId, enabled]);
+    useEffect(() => {
+        void fetchData();
+    }, [fetchData]);
+    return { data, error, isLoading, refetch: fetchData };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @near-kit/react - React bindings for near-kit
+ *
+ * A thin React layer on top of near-kit providing:
+ * - NearProvider and useNear for context management
+ * - Simple hooks for view calls and mutations
+ * - Full TypeScript support
+ *
+ * For advanced features like caching, polling, or optimistic updates,
+ * use React Query or SWR with the useNear() hook directly.
+ */
+export { type AccountState, useAccount } from "./account.js";
+export { useContract } from "./contract.js";
+export { type UseAccountExistsParams, type UseBalanceParams, type UseViewParams, useAccountExists, useBalance, useView, type ViewResult, } from "./hooks.js";
+export { type AmountInput, type UseCallParams, type UseCallResult, type UseSendResult, useCall, useSend, } from "./mutations.js";
+export { NearProvider, type NearProviderProps, useNear } from "./provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,gBAAgB,EAChB,UAAU,EACV,OAAO,EACP,KAAK,UAAU,GAChB,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,OAAO,EACP,OAAO,GACR,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use client";
+/**
+ * @near-kit/react - React bindings for near-kit
+ *
+ * A thin React layer on top of near-kit providing:
+ * - NearProvider and useNear for context management
+ * - Simple hooks for view calls and mutations
+ * - Full TypeScript support
+ *
+ * For advanced features like caching, polling, or optimistic updates,
+ * use React Query or SWR with the useNear() hook directly.
+ */
+// Account hook
+export { useAccount } from "./account.js";
+// Typed contract hook
+export { useContract } from "./contract.js";
+// View/query hooks
+export { useAccountExists, useBalance, useView, } from "./hooks.js";
+// Mutation hooks
+export { useCall, useSend, } from "./mutations.js";
+// Provider and context
+export { NearProvider, useNear } from "./provider.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;GAUG;AAEH,eAAe;AACf,OAAO,EAAqB,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5D,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,mBAAmB;AACnB,OAAO,EAIL,gBAAgB,EAChB,UAAU,EACV,OAAO,GAER,MAAM,YAAY,CAAA;AACnB,iBAAiB;AACjB,OAAO,EAKL,OAAO,EACP,OAAO,GACR,MAAM,gBAAgB,CAAA;AACvB,uBAAuB;AACvB,OAAO,EAAE,YAAY,EAA0B,OAAO,EAAE,MAAM,eAAe,CAAA"}

package/dist/mutations.d.ts

@@ -0,0 +1,99 @@
+import type { CallOptions, NearError } from "near-kit";
+/**
+ * Amount input for NEAR transfers.
+ * Accepts "10 NEAR", "1000 yocto", or raw bigint.
+ */
+export type AmountInput = `${number} NEAR` | `${bigint} yocto` | bigint;
+/**
+ * Parameters for useCall hook
+ */
+export interface UseCallParams {
+    /** Contract account ID */
+    contractId: string;
+    /** Change method name */
+    method: string;
+    /** Default options (gas, attachedDeposit, etc.) */
+    options?: CallOptions;
+}
+/**
+ * Result type for useCall hook
+ */
+export interface UseCallResult<TArgs extends object, TResult> {
+    /** Execute the contract call */
+    mutate: (args: TArgs, options?: CallOptions) => Promise<TResult>;
+    /** The result data from the last successful call */
+    data: TResult | undefined;
+    /** Any error from the last call */
+    error: NearError | Error | undefined;
+    /** Whether a call is currently in progress */
+    isPending: boolean;
+    /** Whether the last call was successful */
+    isSuccess: boolean;
+    /** Whether the last call failed */
+    isError: boolean;
+    /** Reset the mutation state */
+    reset: () => void;
+}
+/**
+ * Hook for calling change methods on NEAR contracts.
+ *
+ * This is a thin wrapper around `near.call()` that provides React state management.
+ * For advanced features like optimistic updates or mutation queuing, use React Query
+ * or SWR with the `useNear()` hook directly.
+ *
+ * @example
+ * ```tsx
+ * function IncrementButton() {
+ *   const { mutate, isPending, isError, error } = useCall<{}, void>({
+ *     contractId: "counter.testnet",
+ *     method: "increment",
+ *   })
+ *
+ *   return (
+ *     <button onClick={() => mutate({})} disabled={isPending}>
+ *       {isPending ? "Sending..." : "Increment"}
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+export declare function useCall<TArgs extends object = object, TResult = unknown>(params: UseCallParams): UseCallResult<TArgs, TResult>;
+/**
+ * Result type for useSend hook
+ */
+export interface UseSendResult {
+    /** Execute the NEAR transfer */
+    mutate: (to: string, amount: AmountInput) => Promise<void>;
+    /** Any error from the last transfer */
+    error: NearError | Error | undefined;
+    /** Whether a transfer is currently in progress */
+    isPending: boolean;
+    /** Whether the last transfer was successful */
+    isSuccess: boolean;
+    /** Whether the last transfer failed */
+    isError: boolean;
+    /** Reset the mutation state */
+    reset: () => void;
+}
+/**
+ * Hook for sending NEAR tokens.
+ *
+ * @example
+ * ```tsx
+ * function SendButton() {
+ *   const { mutate: send, isPending } = useSend()
+ *
+ *   const handleSend = () => {
+ *     send("bob.testnet", "1 NEAR")
+ *   }
+ *
+ *   return (
+ *     <button onClick={handleSend} disabled={isPending}>
+ *       {isPending ? "Sending..." : "Send 1 NEAR"}
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+export declare function useSend(): UseSendResult;
+//# sourceMappingURL=mutations.d.ts.map

package/dist/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../src/mutations.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAItD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,MAAM,OAAO,GAAG,GAAG,MAAM,QAAQ,GAAG,MAAM,CAAA;AAEvE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,OAAO;IAC1D,gCAAgC;IAChC,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAChE,oDAAoD;IACpD,IAAI,EAAE,OAAO,GAAG,SAAS,CAAA;IACzB,mCAAmC;IACnC,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,CAAA;IACpC,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAA;IAClB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAA;IAClB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,GAAG,OAAO,EACtE,MAAM,EAAE,aAAa,GACpB,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAqE/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,uCAAuC;IACvC,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,CAAA;IACpC,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAA;IAClB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAA;IAChB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,IAAI,aAAa,CAkDvC"}

package/dist/mutations.js

@@ -0,0 +1,137 @@
+"use client";
+import { useCallback, useRef, useState } from "react";
+import { useNear } from "./provider.js";
+/**
+ * Hook for calling change methods on NEAR contracts.
+ *
+ * This is a thin wrapper around `near.call()` that provides React state management.
+ * For advanced features like optimistic updates or mutation queuing, use React Query
+ * or SWR with the `useNear()` hook directly.
+ *
+ * @example
+ * ```tsx
+ * function IncrementButton() {
+ *   const { mutate, isPending, isError, error } = useCall<{}, void>({
+ *     contractId: "counter.testnet",
+ *     method: "increment",
+ *   })
+ *
+ *   return (
+ *     <button onClick={() => mutate({})} disabled={isPending}>
+ *       {isPending ? "Sending..." : "Increment"}
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+export function useCall(params) {
+    const { contractId, method, options: defaultOptions } = params;
+    const near = useNear();
+    const [data, setData] = useState(undefined);
+    const [error, setError] = useState(undefined);
+    const [isPending, setIsPending] = useState(false);
+    const [isSuccess, setIsSuccess] = useState(false);
+    const [isError, setIsError] = useState(false);
+    // Track the latest mutation to handle parallel calls (last write wins)
+    const mutationIdRef = useRef(0);
+    const mutate = useCallback(async (args, options) => {
+        const currentMutationId = ++mutationIdRef.current;
+        setIsPending(true);
+        setIsSuccess(false);
+        setIsError(false);
+        setError(undefined);
+        try {
+            const mergedOptions = {
+                ...defaultOptions,
+                ...options,
+            };
+            const result = await near.call(contractId, method, args, mergedOptions);
+            // Only update state if this is still the latest mutation
+            if (currentMutationId === mutationIdRef.current) {
+                setData(result);
+                setIsSuccess(true);
+                setIsPending(false);
+            }
+            return result;
+        }
+        catch (err) {
+            const normalizedError = err instanceof Error ? err : new Error(String(err));
+            // Only update state if this is still the latest mutation
+            if (currentMutationId === mutationIdRef.current) {
+                setError(normalizedError);
+                setIsError(true);
+                setIsPending(false);
+            }
+            throw normalizedError;
+        }
+    }, [near, contractId, method, defaultOptions]);
+    const reset = useCallback(() => {
+        setData(undefined);
+        setError(undefined);
+        setIsPending(false);
+        setIsSuccess(false);
+        setIsError(false);
+        mutationIdRef.current++;
+    }, []);
+    return { mutate, data, error, isPending, isSuccess, isError, reset };
+}
+/**
+ * Hook for sending NEAR tokens.
+ *
+ * @example
+ * ```tsx
+ * function SendButton() {
+ *   const { mutate: send, isPending } = useSend()
+ *
+ *   const handleSend = () => {
+ *     send("bob.testnet", "1 NEAR")
+ *   }
+ *
+ *   return (
+ *     <button onClick={handleSend} disabled={isPending}>
+ *       {isPending ? "Sending..." : "Send 1 NEAR"}
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+export function useSend() {
+    const near = useNear();
+    const [error, setError] = useState(undefined);
+    const [isPending, setIsPending] = useState(false);
+    const [isSuccess, setIsSuccess] = useState(false);
+    const [isError, setIsError] = useState(false);
+    const mutationIdRef = useRef(0);
+    const mutate = useCallback(async (to, amount) => {
+        const currentMutationId = ++mutationIdRef.current;
+        setIsPending(true);
+        setIsSuccess(false);
+        setIsError(false);
+        setError(undefined);
+        try {
+            await near.send(to, amount);
+            if (currentMutationId === mutationIdRef.current) {
+                setIsSuccess(true);
+                setIsPending(false);
+            }
+        }
+        catch (err) {
+            const normalizedError = err instanceof Error ? err : new Error(String(err));
+            if (currentMutationId === mutationIdRef.current) {
+                setError(normalizedError);
+                setIsError(true);
+                setIsPending(false);
+            }
+            throw normalizedError;
+        }
+    }, [near]);
+    const reset = useCallback(() => {
+        setError(undefined);
+        setIsPending(false);
+        setIsSuccess(false);
+        setIsError(false);
+        mutationIdRef.current++;
+    }, []);
+    return { mutate, error, isPending, isSuccess, isError, reset };
+}
+//# sourceMappingURL=mutations.js.map

package/dist/mutations.js.map

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

package/dist/provider.d.ts

@@ -0,0 +1,48 @@
+import { Near, type NearConfig } from "near-kit";
+import { type ReactNode } from "react";
+/**
+ * Props for NearProvider - either pass config or an existing Near instance
+ */
+export type NearProviderProps = {
+    config: NearConfig;
+    near?: never;
+    children: ReactNode;
+} | {
+    near: Near;
+    config?: never;
+    children: ReactNode;
+};
+/**
+ * Provider that creates or wraps a Near client instance and makes it
+ * available to all child components via React context.
+ *
+ * @example
+ * ```tsx
+ * // Using configuration (creates Near instance internally)
+ * <NearProvider config={{ network: "testnet" }}>
+ *   <App />
+ * </NearProvider>
+ *
+ * // Using an existing Near instance
+ * const near = new Near({ network: "testnet" })
+ * <NearProvider near={near}>
+ *   <App />
+ * </NearProvider>
+ * ```
+ */
+export declare function NearProvider(props: NearProviderProps): ReactNode;
+/**
+ * Hook to access the Near client instance from context.
+ *
+ * @throws Error if called outside of a NearProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const near = useNear()
+ *   // Use near.view(), near.call(), near.transaction(), etc.
+ * }
+ * ```
+ */
+export declare function useNear(): Near;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,EAAiB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAA;AAY1E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,CAAA;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAqChE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAS9B"}

package/dist/provider.js

@@ -0,0 +1,78 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Near } from "near-kit";
+import { createContext, useContext, useMemo } from "react";
+/**
+ * Context for the Near client instance
+ */
+const NearContext = createContext(null);
+/**
+ * Internal context to detect nested providers
+ */
+const NearProviderDetectionContext = createContext(false);
+/**
+ * Provider that creates or wraps a Near client instance and makes it
+ * available to all child components via React context.
+ *
+ * @example
+ * ```tsx
+ * // Using configuration (creates Near instance internally)
+ * <NearProvider config={{ network: "testnet" }}>
+ *   <App />
+ * </NearProvider>
+ *
+ * // Using an existing Near instance
+ * const near = new Near({ network: "testnet" })
+ * <NearProvider near={near}>
+ *   <App />
+ * </NearProvider>
+ * ```
+ */
+export function NearProvider(props) {
+    const { children } = props;
+    // Detect nested providers
+    const isNested = useContext(NearProviderDetectionContext);
+    if (isNested) {
+        throw new Error("Nested <NearProvider> detected. Only one NearProvider is allowed per React tree. " +
+            "If you need multiple networks, create separate Near instances and pass them explicitly.");
+    }
+    // Extract the Near instance or config for stable dependency tracking
+    const nearProp = "near" in props ? props.near : undefined;
+    const configProp = "config" in props ? props.config : undefined;
+    // Serialize config for dependency comparison (only used when config is provided)
+    const configKey = configProp ? JSON.stringify(configProp) : undefined;
+    // Create or use the provided Near instance
+    // biome-ignore lint/correctness/useExhaustiveDependencies: configKey is derived from configProp for stable comparison
+    const nearInstance = useMemo(() => {
+        if (nearProp) {
+            return nearProp;
+        }
+        if (configProp) {
+            return new Near(configProp);
+        }
+        throw new Error("NearProvider requires either 'near' or 'config' prop");
+    }, [nearProp, configKey]);
+    return (_jsx(NearProviderDetectionContext.Provider, { value: true, children: _jsx(NearContext.Provider, { value: nearInstance, children: children }) }));
+}
+/**
+ * Hook to access the Near client instance from context.
+ *
+ * @throws Error if called outside of a NearProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const near = useNear()
+ *   // Use near.view(), near.call(), near.transaction(), etc.
+ * }
+ * ```
+ */
+export function useNear() {
+    const near = useContext(NearContext);
+    if (!near) {
+        throw new Error("useNear must be used within a <NearProvider>. " +
+            "Wrap your component tree with <NearProvider config={{ network: 'testnet' }}>.");
+    }
+    return near;
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,IAAI,EAAmB,MAAM,UAAU,CAAA;AAChD,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE1E;;GAEG;AACH,MAAM,WAAW,GAAG,aAAa,CAAc,IAAI,CAAC,CAAA;AAEpD;;GAEG;AACH,MAAM,4BAA4B,GAAG,aAAa,CAAU,KAAK,CAAC,CAAA;AASlE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAA;IAE1B,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,4BAA4B,CAAC,CAAA;IACzD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,mFAAmF;YACjF,yFAAyF,CAC5F,CAAA;IACH,CAAC;IAED,qEAAqE;IACrE,MAAM,QAAQ,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;IACzD,MAAM,UAAU,GAAG,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;IAC/D,iFAAiF;IACjF,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAErE,2CAA2C;IAC3C,sHAAsH;IACtH,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE;QAChC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,CAAA;QAC7B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;IACzE,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAA;IAEzB,OAAO,CACL,KAAC,4BAA4B,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAChD,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YACtC,QAAQ,GACY,GACe,CACzC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,gDAAgD;YAC9C,+EAA+E,CAClF,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@near-kit/react",
+  "version": "0.8.3",
+  "description": "React bindings for near-kit - hooks and providers for NEAR Protocol",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "lint": "biome check . --write",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "near",
+    "near-protocol",
+    "blockchain",
+    "react",
+    "hooks",
+    "web3"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "near-kit": ">=0.8.3",
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.0.6",
+    "@testing-library/react": "^16.2.0",
+    "@types/react": "^19.0.0",
+    "jsdom": "^26.0.0",
+    "near-kit": "0.8.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.10"
+  }
+}