better-near-auth 1.2.1 → 1.4.0

package/dist/client.d.ts

@@ -27,6 +27,8 @@ export interface SIWNClientActions {
             publicKey: string | null;
             networkId: string;
         } | null;
+        isWalletConnected: () => boolean;
+        ensureConnected: () => Promise<boolean>;
         disconnect: () => Promise<void>;
         link: (callbacks?: AuthCallbacks) => Promise<void>;
         unlink: (params: {
@@ -63,6 +65,7 @@ export interface SIWNClientPlugin extends BetterAuthClientPlugin {
             publicKey: string | null;
             networkId: string;
         } | null>>;
+        walletConnected: ReturnType<typeof atom<boolean>>;
     };
     getActions: ($fetch: BetterFetch, $store: ClientStore, options: BetterAuthClientOptions | undefined) => SIWNClientActions;
 }

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -5,12 +5,11 @@ import { atom } from "nanostores";
 import {} from "./types.js";
 export const siwnClient = (config) => {
     const nearState = atom(null);
+    const walletConnected = atom(false);
     const network = config.networkId || "mainnet";
-    const connector = new NearConnector({ network });
-    const near = new Near({
-        network,
-        wallet: fromNearConnect(connector),
-    });
+    let connector = null;
+    let near = null;
+    let clientInitialized = false;
     const handleAccountConnection = async (accountId, publicKey) => {
         if (!accountId)
             return;
@@ -19,44 +18,134 @@ export const siwnClient = (config) => {
             publicKey: publicKey || null,
             networkId: network,
         });
+        walletConnected.set(true);
     };
-    connector.on("wallet:signIn", async (data) => {
-        const accountId = data.accounts?.[0]?.accountId;
-        const publicKey = data.accounts?.[0]?.publicKey;
-        if (accountId) {
-            await handleAccountConnection(accountId, publicKey);
+    const initClient = ($fetch) => {
+        if (clientInitialized)
+            return true;
+        if (typeof globalThis.window === "undefined")
+            return false;
+        connector = new NearConnector({ network });
+        near = new Near({
+            network,
+            wallet: fromNearConnect(connector),
+        });
+        connector.on("wallet:signIn", async (data) => {
+            const accountId = data.accounts?.[0]?.accountId;
+            const publicKey = data.accounts?.[0]?.publicKey;
+            if (accountId) {
+                await handleAccountConnection(accountId, publicKey);
+            }
+        });
+        connector.on("wallet:signOut", () => {
+            walletConnected.set(false);
+            const state = nearState.get();
+            if (state) {
+                nearState.set({ accountId: state.accountId, publicKey: null, networkId: state.networkId });
+            }
+        });
+        connector.getConnectedWallet().then(({ accounts }) => {
+            const account = accounts?.[0];
+            if (account?.accountId && !nearState.get()) {
+                nearState.set({
+                    accountId: account.accountId,
+                    publicKey: account.publicKey ?? null,
+                    networkId: network,
+                });
+            }
+            if (account?.accountId) {
+                walletConnected.set(true);
+            }
+        }).catch(() => { });
+        if ($fetch) {
+            restoreFromSession($fetch);
         }
-    });
-    connector.on("wallet:signOut", () => {
-        nearState.set(null);
-    });
-    connector.getConnectedWallet().then(({ accounts }) => {
-        const account = accounts?.[0];
-        if (account?.accountId && !nearState.get()) {
-            nearState.set({
-                accountId: account.accountId,
-                publicKey: account.publicKey ?? null,
-                networkId: network,
-            });
+        clientInitialized = true;
+        return true;
+    };
+    let sessionRestored = false;
+    const restoreFromSession = async ($fetch) => {
+        if (sessionRestored)
+            return;
+        const state = nearState.get();
+        if (state?.accountId) {
+            sessionRestored = true;
+            return;
         }
-    }).catch(() => { });
+        try {
+            const res = await $fetch("/near/list-accounts", { method: "GET" });
+            const accounts = res.data?.accounts;
+            if (accounts?.length) {
+                const primary = accounts.find((a) => a.isPrimary) || accounts[0];
+                if (primary) {
+                    nearState.set({
+                        accountId: primary.accountId,
+                        publicKey: primary.publicKey ?? null,
+                        networkId: primary.network,
+                    });
+                }
+            }
+        }
+        catch { }
+        sessionRestored = true;
+    };
+    const requireConnector = () => {
+        if (!connector)
+            throw new Error("Wallet not initialized — this operation requires a browser environment");
+        return connector;
+    };
+    const requireNear = () => {
+        if (!near)
+            throw new Error("Wallet not initialized — this operation requires a browser environment");
+        return near;
+    };
+    const ensureWalletConnected = async () => {
+        const conn = requireConnector();
+        if (walletConnected.get()) {
+            try {
+                const { accounts } = await conn.getConnectedWallet();
+                if (accounts?.length)
+                    return true;
+            }
+            catch { }
+        }
+        return new Promise((resolve) => {
+            const signInHandler = (data) => {
+                const accountId = data.accounts?.[0]?.accountId;
+                const publicKey = data.accounts?.[0]?.publicKey;
+                if (accountId) {
+                    handleAccountConnection(accountId, publicKey);
+                    resolve(true);
+                }
+            };
+            conn.on("wallet:signIn", signInHandler);
+            conn.connect().catch(() => { }).finally(() => {
+                conn.off("wallet:signIn", signInHandler);
+                if (!walletConnected.get()) {
+                    resolve(false);
+                }
+            });
+        });
+    };
     const signWithWallet = async () => {
+        const conn = requireConnector();
+        const nearClient = requireNear();
         const nonceBytes = generateNonce();
         const nonceHex = hex.encode(nonceBytes);
         const message = `Sign in to ${config.recipient}`;
         let connectedWallet = null;
         try {
-            connectedWallet = await connector.getConnectedWallet();
+            connectedWallet = await conn.getConnectedWallet();
         }
         catch { }
         if (connectedWallet?.accounts?.length) {
-            const signedMessage = await near.signMessage({
+            const signedMessage = await nearClient.signMessage({
                 message,
                 recipient: config.recipient,
                 nonce: nonceBytes,
             });
             if (!signedMessage?.accountId) {
-                throw new Error("Wallet not connected");
+                throw new Error("Wallet sign-in was cancelled or failed");
             }
             return {
                 signedMessage,
@@ -76,9 +165,9 @@ export const siwnClient = (config) => {
                 };
             }
         };
-        connector.on("wallet:signInAndSignMessage", handler);
+        conn.on("wallet:signInAndSignMessage", handler);
         try {
-            await connector.connect({
+            await conn.connect({
                 signMessageParams: {
                     message,
                     recipient: config.recipient,
@@ -87,10 +176,10 @@ export const siwnClient = (config) => {
             });
         }
         finally {
-            connector.off("wallet:signInAndSignMessage", handler);
+            conn.off("wallet:signInAndSignMessage", handler);
         }
         if (!result.value) {
-            throw new Error("Wallet not connected");
+            throw new Error("Wallet sign-in was cancelled or failed");
         }
         return {
             signedMessage: result.value.signedMessage,
@@ -102,9 +191,16 @@ export const siwnClient = (config) => {
     const buildSignedDelegateActionInternal = async (receiverId, buildActions) => {
         const state = nearState.get();
         if (!state?.accountId) {
-            throw new Error("No wallet connected — cannot sign delegate action");
+            throw new Error("No NEAR account found — please sign in with your NEAR wallet");
+        }
+        if (!walletConnected.get()) {
+            const reconnected = await ensureWalletConnected();
+            if (!reconnected) {
+                throw new Error("Wallet connection required — please approve the connection to sign");
+            }
         }
-        const builder = buildActions(near.transaction(state.accountId), receiverId);
+        const nearClient = requireNear();
+        const builder = buildActions(nearClient.transaction(state.accountId), receiverId);
         const { payload } = await builder.delegate();
         return payload;
     };
@@ -113,8 +209,10 @@ export const siwnClient = (config) => {
         $InferServerPlugin: {},
         getAtoms: (_$fetch) => ({
             nearState,
+            walletConnected,
         }),
         getActions: ($fetch, _$store, _options) => {
+            initClient($fetch);
             return {
                 near: {
                     nonce: async (params, fetchOptions) => {
@@ -150,8 +248,28 @@ export const siwnClient = (config) => {
                         return state?.accountId || null;
                     },
                     getState: () => nearState.get(),
+                    isWalletConnected: () => walletConnected.get(),
+                    ensureConnected: async () => {
+                        if (!clientInitialized) {
+                            if (!initClient())
+                                return false;
+                        }
+                        if (walletConnected.get()) {
+                            try {
+                                const { accounts } = await requireConnector().getConnectedWallet();
+                                if (accounts?.length)
+                                    return true;
+                            }
+                            catch (err) {
+                                console.error("[siwn] restoreFromSession failed:", err instanceof Error ? err.message : err);
+                            }
+                        }
+                        return ensureWalletConnected();
+                    },
                     disconnect: async () => {
-                        await connector.disconnect();
+                        if (connector)
+                            await connector.disconnect();
+                        walletConnected.set(false);
                         nearState.set(null);
                     },
                     link: async (callbacks) => {
@@ -216,7 +334,11 @@ export const siwnClient = (config) => {
                             method: "GET",
                         });
                     },
-                    client: near,
+                    get client() {
+                        if (!near)
+                            throw new Error("Wallet not initialized — this operation requires a browser environment");
+                        return near;
+                    },
                 },
                 signIn: {
                     near: async (callbacks) => {

package/dist/client.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-near-auth",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "Sign in with NEAR (SIWN) plugin for Better Auth",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/skills/client/SKILL.md

@@ -8,7 +8,7 @@ description: >
   using authClient.near.* methods, or building delegate actions for gasless relay.
 type: core
 library: better-near-auth
-library_version: "1.1.0"
+library_version: "1.2.1"
 sources:
   - "elliotBraem/better-near-auth:src/client.ts"
   - "elliotBraem/better-near-auth:src/types.ts"
@@ -20,8 +20,21 @@ sources:
 
 Client-side plugin for NEAR wallet authentication and gasless relay. Connects to NEAR wallets via NearConnect, provides `authClient.near.*` actions for sign-in, account management, profile lookup, and delegate action building.
 
+## SSR Behavior
+
+`siwnClient()` is SSR-safe. Wallet resources (`NearConnector`, `Near`, event listeners) are lazily initialized on first client-side access — they do not run at construction time. On the server:
+
+- `getAccountId()` returns `null` (no session restore yet)
+- `getState()` returns `null`
+- `isWalletConnected()` returns `false`
+- `buildSignedDelegateAction`, `signWithWallet`, `ensureConnected` throw "Wallet not initialized — this operation requires a browser environment"
+- `near.client` getter throws on access
+- HTTP-only methods (`nonce`, `verify`, `view`, `relayTransaction`, etc.) work normally via `$fetch`
+
 ## Setup
 
+### Simple app (module singleton)
+
 ```typescript
 import { createAuthClient } from "better-auth/client";
 import { siwnClient } from "better-near-auth/client";
@@ -36,6 +49,36 @@ export const authClient = createAuthClient({
 });
 ```
 
+### SSR app (router context)
+
+For TanStack Router with server rendering, create the auth client once in your router setup and access via context:
+
+```typescript
+// auth.ts
+import { createAuthClient as createBetterAuthClient } from "better-auth/react";
+import { siwnClient } from "better-near-auth/client";
+import { useRouter } from "@tanstack/react-router";
+
+export function createAuthClient() {
+  return createBetterAuthClient({
+    plugins: [siwnClient({ recipient: getAccount(), networkId: getNetworkId() })],
+  });
+}
+
+export type AuthClient = ReturnType<typeof createAuthClient>;
+
+export function useAuthClient(): AuthClient {
+  return useRouter().options.context.authClient;
+}
+
+// hydrate.tsx — create once, put in router context
+const { router } = createRouter({
+  context: { authClient: createAuthClient() },
+});
+```
+
+A module-level singleton is shared across SSR requests, causing data leaks. Router context gives one client per request on server, one per app on client.
+
 The `recipient` must match the server's `siwn()` recipient exactly. `networkId` defaults to `"mainnet"`.
 
 ## Core Patterns
@@ -77,12 +120,36 @@ console.log("Status:", status.data.status);
 
 The `buildSignedDelegateAction` callback receives a `TransactionBuilder` from near-kit and the `receiverId`. Use `builder.functionCall()` to construct actions. The builder calls `.delegate()` internally and returns a base64 payload string.
 
+`buildSignedDelegateAction` automatically calls `ensureConnected()` if the wallet is disconnected, prompting the user to reconnect.
+
+### Direct send (user pays gas)
+
+```typescript
+// Must ensure wallet is connected before .send()
+await authClient.near.ensureConnected();
+return authClient.near.client
+  .transaction(accountId)
+  .functionCall(contractId, "method", args, {
+    gas: Gas.Tgas(30),
+    attachedDeposit: BigInt(0),
+  })
+  .send({ waitUntil: "FINAL" });
+```
+
+Wallet extensions (Meteor, HERE) may disconnect after the initial sign-in popup. Always call `ensureConnected()` before `.send()` — it opens a reconnection prompt if needed. `buildSignedDelegateAction` does this automatically, but direct `.send()` does not.
+
 ### Wallet state and profile management
 
 ```typescript
-// Get current account
+// Get current account (persists across wallet disconnects)
 const accountId = authClient.near.getAccountId(); // string | null
 
+// Check if signing operations are available
+const canSign = authClient.near.isWalletConnected(); // boolean
+
+// Prompt wallet reconnection if disconnected
+const connected = await authClient.near.ensureConnected(); // Promise<boolean>
+
 // Get full wallet state
 const state = authClient.near.getState(); // { accountId, publicKey, networkId } | null
 
@@ -94,6 +161,8 @@ const aliceProfile = await authClient.near.getProfile("alice.near");
 await authClient.near.disconnect();
 ```
 
+When the wallet disconnects externally (user signs out from wallet UI), `nearState` preserves `accountId` but clears `publicKey`. Use `isWalletConnected()` to check if signing operations are available, and `getAccountId()` for display purposes (works even when disconnected).
+
 ### Account linking and contract view calls
 
 ```typescript
@@ -127,8 +196,10 @@ const result = await authClient.near.view({
 | `verify(params)` | `Promise<Response<VerifyResponse>>` | Verify NEP-413 signature |
 | `getProfile(accountId?)` | `Promise<Response<Profile>>` | Get NEAR profile |
 | `view(params)` | `Promise<Response<ViewResponse>>` | Server-side contract view call |
-| `getAccountId()` | `string \| null` | Currently connected account ID |
+| `getAccountId()` | `string \| null` | Currently connected account ID (persists across disconnects) |
 | `getState()` | `{ accountId, publicKey, networkId } \| null` | Wallet state |
+| `isWalletConnected()` | `boolean` | Whether wallet is actively connected |
+| `ensureConnected()` | `Promise<boolean>` | Reconnect wallet if disconnected |
 | `disconnect()` | `Promise<void>` | Disconnect wallet |
 | `link(callbacks?)` | `Promise<void>` | Link NEAR account to session |
 | `unlink(params)` | `Promise<Response>` | Unlink NEAR account |
@@ -138,7 +209,7 @@ const result = await authClient.near.view({
 | `getRelayStatus(txHash)` | `Promise<Response<RelayStatusResponse>>` | Check relayed tx status |
 | `getRelayerInfo()` | `Promise<Response<RelayerInfo>>` | Get relayer info and balance |
 | `relayHistory()` | `Promise<Response<RelayHistoryResponse>>` | List relayed transactions |
-| `client` | `Near` | Access near-kit Near instance directly |
+| `client` | `Near` | Access near-kit Near instance (throws on server) |
 
 ### authClient.signIn
 
@@ -157,6 +228,41 @@ interface AuthCallbacks {
 
 ## Common Mistakes
 
+### CRITICAL Creating multiple siwnClient instances
+
+Wrong:
+
+```typescript
+// Factory that creates new client each call
+function getAuthClient(config) {
+  return createAuthClient({
+    plugins: [siwnClient({ recipient: getAccount(config) })],
+  });
+}
+// Each call = new nearState atom = wallet state lost
+```
+
+Correct:
+
+```typescript
+// Single module-level instance (simple apps)
+export const authClient = createAuthClient({
+  plugins: [siwnClient({ recipient: "myapp.near" })],
+});
+
+// OR: router context singleton (SSR apps)
+export function createAuthClient() {
+  return createBetterAuthClient({
+    plugins: [siwnClient({ recipient: getAccount() })],
+  });
+}
+// Create once in router setup, access via context
+```
+
+`siwnClient()` creates stateful singletons: a `nearState` atom, a `walletConnected` atom, a `NearConnector` with event listeners, and a `Near` instance. Multiple instances means wallet sign-in populates one atom while your app reads from another. Always create exactly one `siwnClient()` per app lifecycle.
+
+Source: src/client.ts:64-72
+
 ### CRITICAL Recipient mismatch between server and client
 
 Wrong:
@@ -181,39 +287,32 @@ siwnClient({ recipient: "myapp.com" });
 
 The client embeds the recipient in the signed message. The server verifies against its own recipient. A mismatch causes the verify endpoint to reject the signature with "Unauthorized: Invalid signature" — which is confusing because the signature is valid, just for a different recipient.
 
-Source: src/client.ts:17, src/index.ts:225
+Source: src/client.ts:108, src/index.ts:225
 
 See also: siwn/SKILL.md — server plugin recipient configuration
 
-### HIGH Calling buildSignedDelegateAction without connected wallet
+### HIGH Using near.client.send() without ensuring wallet connection
 
 Wrong:
 
 ```typescript
-// No wallet connected yet
-const payload = await authClient.near.buildSignedDelegateAction(
-  "myapp.near",
-  (builder, receiverId) => builder.functionCall(receiverId, "method", {})
-);
+authClient.near.client.transaction(accountId)
+  .functionCall(contract, "method", args, opts)
+  .send(); // fails if wallet disconnected after sign-in
 ```
 
 Correct:
 
 ```typescript
-// Check wallet state before building delegate action
-const accountId = authClient.near.getAccountId();
-if (!accountId) {
-  await authClient.signIn.near();
-}
-const payload = await authClient.near.buildSignedDelegateAction(
-  "myapp.near",
-  (builder, receiverId) => builder.functionCall(receiverId, "method", {})
-);
+await authClient.near.ensureConnected(); // reconnects wallet if needed
+authClient.near.client.transaction(accountId)
+  .functionCall(contract, "method", args, opts)
+  .send();
 ```
 
-`buildSignedDelegateAction` reads `accountId` from the `nearState` atom. If the wallet is not connected, nearState is null and the function throws "No wallet connected — cannot sign delegate action" with no user-facing prompt to connect.
+Wallet extensions (Meteor, HERE) may disconnect after the initial sign-in popup. `ensureConnected()` opens a reconnection prompt if needed. `buildSignedDelegateAction` calls this automatically, but direct `.send()` does not.
 
-Source: src/client.ts:176-179
+Source: src/client.ts:249-253, src/client.ts:310-317
 
 ### HIGH Constructing transactions with wrong builder pattern
 
@@ -242,7 +341,7 @@ const result = await authClient.near.relayTransaction({ payload });
 
 Delegate actions must be built through `buildSignedDelegateAction`, which uses near-kit's `TransactionBuilder.delegate()` method. Direct `.send()` broadcasts from the client account and requires the user to pay gas — defeating the gasless relay purpose.
 
-Source: src/client.ts:172-185, maintainer interview
+Source: src/client.ts:240-260
 
 See also: relay/SKILL.md — relay endpoint validation and whitelisting
 
@@ -273,7 +372,7 @@ await authClient.signIn.near({
 
 `signIn.near()` handles wallet connection, NEP-413 message signing, nonce management, and server verification in a single call. Calling `verify` directly requires manually constructing all parameters and does not handle wallet connection.
 
-Source: src/client.ts:314-348
+Source: src/client.ts:402-437
 
 ### MEDIUM Not subscribing to wallet disconnect events
 
@@ -291,11 +390,13 @@ Correct:
 import { useStore } from "nanostores/react";
 const { nearState } = authClient.$store;
 const state = useStore(nearState);
-// state is null when wallet disconnects externally
-```
+// state preserves accountId when wallet disconnects
+// publicKey becomes null, walletConnected becomes false
 
-When the wallet disconnects externally (user signs out from wallet UI), the `nearState` atom is set to null. UI components that only read `getAccountId()` once will show stale account info.
+// Or check signing availability:
+const canSign = authClient.near.isWalletConnected();
+```
 
-Source: src/client.ts:62,82-92
+When the wallet disconnects externally (user signs out from wallet UI), `nearState` preserves `accountId` but clears `publicKey` and sets `walletConnected` to false. Use `isWalletConnected()` to check if signing operations are available, and `getAccountId()` for display purposes (works even when disconnected).
 
-See also: siwn/SKILL.md — server-side nonce and verify endpoints
+Source: src/client.ts:65-66, src/client.ts:102-108

package/skills/relay/SKILL.md

@@ -8,7 +8,7 @@ description: >
   configuring RotatingKeyStore for high-throughput relay.
 type: core
 library: better-near-auth
-library_version: "1.1.0"
+library_version: "1.2.1"
 sources:
   - "elliotBraem/better-near-auth:src/index.ts"
   - "elliotBraem/better-near-auth:src/utils.ts"
@@ -189,7 +189,7 @@ siwn({
 // Send NEAR to that account ID to fund the relayer
 ```
 
-The ephemeral mode generates an implicit account (hex of public key) with zero balance. Without funding, every relay attempt fails with an insufficient balance error from the NEAR RPC. Alternatively, use explicit mode with a pre-funded named account.
+The ephemeral mode generates an implicit account (hex of public key) with zero balance. Without funding, every relay attempt fails with an insufficient balance error from the NEAR RPC. The server catches this at src/index.ts:952-958 and surfaces it as `"Relay failed"` — check server logs for the actual RPC error. Alternatively, use explicit mode with a pre-funded named account.
 
 Source: src/index.ts:179-181, maintainer interview
 
@@ -250,7 +250,7 @@ const payload = await authClient.near.buildSignedDelegateAction(
 const result = await authClient.near.relayTransaction({ payload });
 ```
 
-Delegate actions must be built using the near-kit `TransactionBuilder` with `.delegate()`, not `.send()` directly. The wallet signs a delegate action; the relayer submits it on-chain. External code should construct the transaction object using the builder API, not attempt to broadcast directly.
+Delegate actions must be built using the near-kit `TransactionBuilder` with `.delegate()`, not `.send()` directly. The wallet signs a delegate action; the relayer submits it on-chain. For direct sends (user pays gas), call `authClient.near.ensureConnected()` first — wallet extensions may disconnect between sign-in and signing.
 
 Source: src/client.ts:172-185, maintainer interview
 

package/skills/siwn/SKILL.md

@@ -8,7 +8,7 @@ description: >
   or debugging NEP-413 verify or nonce issues.
 type: core
 library: better-near-auth
-library_version: "1.1.0"
+library_version: "1.2.1"
 sources:
   - "elliotBraem/better-near-auth:src/index.ts"
   - "elliotBraem/better-near-auth:src/profile.ts"

package/skills/tanstack/SKILL.md

@@ -0,0 +1,356 @@
+---
+name: tanstack
+description: >
+  Integrate better-near-auth with TanStack Router (SSR or CSR). Set up auth
+  client as a router context singleton, useAuthClient hook, session query
+  options, inferred types from AuthClient, and ensureConnected before signing.
+  Load when scaffolding a new TanStack Router app with better-near-auth,
+  wiring auth into router context, or debugging wallet state loss after
+  sign-in in SSR/CSR TanStack apps.
+type: framework
+library: better-near-auth
+library_version: "1.2.1"
+sources:
+  - "elliotBraem/better-near-auth:src/client.ts"
+  - "elliotBraem/better-near-auth:examples/auth.everything.dev/ui/src/auth.ts"
+  - "elliotBraem/better-near-auth:examples/auth.everything.dev/ui/src/app.ts"
+  - "elliotBraem/better-near-auth:examples/auth.everything.dev/ui/src/hydrate.tsx"
+  - "elliotBraem/better-near-auth:examples/auth.everything.dev/ui/src/router.tsx"
+  - "elliotBraem/better-near-auth:examples/auth.everything.dev/ui/src/router.server.tsx"
+  - "elliotBraem/better-near-auth:examples/browser-2-server/apps/web/src/lib/auth-client.ts"
+---
+
+# Better-Near-Auth — TanStack Router Integration
+
+Integration pattern for better-near-auth with TanStack Router apps, covering both CSR (client-side only) and SSR (server-rendered) setups. Establishes the auth client as a router context singleton, provides hooks and query options, and ensures wallet state survives page navigation and hydration.
+
+## Architecture: Two Patterns
+
+### Pattern A: Module singleton (CSR only)
+
+For apps without SSR — config is known at build time or from env vars:
+
+```typescript
+// lib/auth-client.ts
+import { createAuthClient } from "better-auth/react";
+import { siwnClient } from "better-near-auth/client";
+
+export const authClient = createAuthClient({
+  baseURL: import.meta.env.VITE_SERVER_URL || "http://localhost:3000",
+  plugins: [
+    siwnClient({ recipient: "myapp.near", networkId: "mainnet" }),
+  ],
+});
+```
+
+Import directly in any component or route. Simple, correct for CSR.
+
+### Pattern B: Router context singleton (SSR or CSR with runtime config)
+
+For TanStack Router apps with SSR, Module Federation, or runtime config (`window.__RUNTIME_CONFIG__`):
+
+```typescript
+// auth.ts — single file for client factory, types, hooks, and query options
+import { createAuthClient as createBetterAuthClient } from "better-auth/react";
+import { siwnClient } from "better-near-auth/client";
+import { useRouter } from "@tanstack/react-router";
+import { useQuery } from "@tanstack/react-query";
+import type { Auth } from "./auth-types.gen";
+import { getAccount, getHostUrl, getNetworkId } from "@/app";
+
+export function createAuthClient() {
+  return createBetterAuthClient({
+    baseURL: getHostUrl(),
+    fetchOptions: { credentials: "include" },
+    plugins: [
+      siwnClient({ recipient: getAccount(), networkId: getNetworkId() }),
+    ],
+  });
+}
+
+export type AuthClient = ReturnType<typeof createAuthClient>;
+export type SessionData = AuthClient["$Infer"]["Session"];
+
+export function useAuthClient(): AuthClient {
+  return useRouter().options.context.authClient;
+}
+```
+
+The auth client is created once in the router setup (not per component call) and accessed via context:
+
+```typescript
+// hydrate.tsx
+import { createAuthClient } from "./auth";
+
+const { router } = createRouter({
+  context: {
+    authClient: createAuthClient(),
+  },
+});
+
+// router.server.tsx — same pattern
+context: {
+  authClient: createAuthClient(),
+}
+```
+
+## Type Inference from AuthClient
+
+Don't manually define `Organization`, `Passkey`, or other entity types. Infer them from the client's API responses:
+
+```typescript
+type UnwrapListResponse<T> = T extends (...args: any[]) => Promise<{
+  data: (infer U)[] | null; error: any
+}> ? U : never;
+
+export type Organization = UnwrapListResponse<AuthClient["organization"]["list"]>;
+export type Passkey = UnwrapListResponse<AuthClient["passkey"]["listUserPasskeys"]>;
+```
+
+This automatically includes any additional fields the server configured. Single source of truth: the `AuthClient` type, which is itself derived from the plugin list.
+
+## Session Query Options
+
+Always pass the auth client directly — never thread `runtimeConfig` through query options:
+
+```typescript
+export function sessionQueryOptions(
+  authClient: AuthClient,
+  initialSession?: SessionData | null,
+) {
+  return {
+    queryKey: ["session"],
+    queryFn: async () => {
+      const { data: session } = await authClient.getSession();
+      return session ?? null;
+    },
+    staleTime: 60 * 1000,
+    gcTime: 10 * 60 * 1000,
+    initialData: initialSession,
+  };
+}
+```
+
+In `beforeLoad`/`loader` (not components), use `context.authClient`:
+
+```typescript
+beforeLoad: async ({ context }) => {
+  const session = await context.queryClient.ensureQueryData(
+    sessionQueryOptions(context.authClient, context.session),
+  );
+  if (!session?.user) {
+    throw redirect({ to: "/login" });
+  }
+  return { session };
+},
+```
+
+In components, use `useAuthClient()`:
+
+```typescript
+const auth = useAuthClient();
+const { data } = await auth.organization.list();
+```
+
+## Router Context Setup
+
+### Define RouterContext with authClient
+
+```typescript
+// app.ts
+import type { AuthClient, SessionData } from "./auth";
+
+export interface RouterContext extends BaseRouterContext {
+  apiClient: ApiClient;
+  authClient: AuthClient;
+}
+```
+
+### Wire in router files
+
+Both `router.tsx` (client) and `router.server.tsx` (server) must include `authClient` in context:
+
+```typescript
+context: {
+  queryClient,
+  authClient: opts.context.authClient,
+  apiClient: opts.context.apiClient,
+  runtimeConfig: opts.context.runtimeConfig,
+  session: opts.context.session,
+},
+```
+
+### Remove runtimeConfig from component props
+
+Components no longer need `runtimeConfig` props for auth. They use `useAuthClient()` instead. Remove `runtimeConfig` prop threading from:
+- Route components that pass it to child components
+- Shared components like `UserNav`, `OrgSwitcher`, `RelayFeed`, `NearProfile`
+
+## Wallet State and Signing
+
+### ensureConnected before signing
+
+Wallet extensions (Meteor, HERE) may disconnect after the initial sign-in popup. Always call `ensureConnected()` before any signing operation:
+
+```typescript
+// Relay mode — automatic (buildSignedDelegateAction calls ensureConnected internally)
+const payload = await authClient.near.buildSignedDelegateAction(...);
+
+// Direct mode — manual
+await authClient.near.ensureConnected();
+authClient.near.client.transaction(accountId)
+  .functionCall(contract, "method", args, opts)
+  .send({ waitUntil: "FINAL" });
+```
+
+### nearState persists accountId across disconnects
+
+When the wallet disconnects externally:
+- `getAccountId()` still returns the accountId (from session restore)
+- `isWalletConnected()` returns false
+- `publicKey` is cleared from state
+
+This means UI can display the user's NEAR account even when the wallet is disconnected. Signing operations automatically prompt reconnection.
+
+## SSR Safety
+
+`siwnClient()` is SSR-safe — wallet resources are lazily initialized on first client-side access. On the server they sit dormant. This means `createAuthClient()` can safely run in `router.server.tsx` without accessing browser APIs.
+
+Methods that work on server (via `$fetch` only): `nonce`, `verify`, `view`, `relayTransaction`, `getRelayStatus`, `getRelayerInfo`, `relayHistory`, `getProfile`, `listAccounts`.
+
+Methods that throw on server: `buildSignedDelegateAction`, `ensureConnected`, `signIn.near`, `link`, `disconnect`.
+
+Properties that return defaults on server: `getAccountId()` → `null`, `getState()` → `null`, `isWalletConnected()` → `false`.
+
+## File Consolidation
+
+Replace three separate files with one `auth.ts`:
+
+| Before | After |
+| ------ | ----- |
+| `lib/auth-client.ts` (factory + types) | `auth.ts` (factory + types + hooks + queries) |
+| `lib/session.ts` (query options) | `auth.ts` |
+| `lib/auth-hooks.ts` (relay history hook) | `auth.ts` |
+
+The consolidated `auth.ts` is ~80 lines and eliminates all `runtimeConfig` parameter threading.
+
+## Common Mistakes
+
+### CRITICAL Creating multiple siwnClient instances via factory
+
+Wrong:
+
+```typescript
+function getAuthClient(config) {
+  return createAuthClient({
+    plugins: [siwnClient({ recipient: getAccount(config) })],
+  });
+}
+// Every call creates new nearState atom — wallet state lost
+```
+
+Correct:
+
+```typescript
+// Module singleton (CSR)
+export const authClient = createAuthClient({
+  plugins: [siwnClient({ recipient: "myapp.near" })],
+});
+
+// OR: Router context singleton (SSR)
+export function createAuthClient() {
+  return createBetterAuthClient({
+    plugins: [siwnClient({ recipient: getAccount() })],
+  });
+}
+// Create once in router setup, access via useAuthClient()
+```
+
+`siwnClient()` creates stateful singletons: `nearState` atom, `walletConnected` atom, `NearConnector` with event listeners, `Near` instance. Multiple instances means wallet sign-in populates one atom while your app reads from another. Always create exactly one per app lifecycle.
+
+Source: src/client.ts:64-72
+
+See also: client/SKILL.md — CRITICAL singleton requirement
+
+### HIGH Threading runtimeConfig through query options and component props
+
+Wrong:
+
+```typescript
+// session.ts
+export const sessionQueryOptions = (initialSession, runtimeConfig) => ({
+  queryFn: () => getAuthClient(runtimeConfig).getSession(),
+});
+
+// Component
+<UserNav runtimeConfig={runtimeConfig} />
+// Inside UserNav: const auth = getAuthClient(runtimeConfig);
+```
+
+Correct:
+
+```typescript
+// auth.ts
+export const sessionQueryOptions = (authClient, initialSession?) => ({
+  queryFn: () => authClient.getSession(),
+});
+
+// Component
+function UserNav() {
+  const auth = useAuthClient();
+}
+```
+
+`runtimeConfig` was threaded through props and query options solely to create auth client instances. With router context, the auth client is a singleton accessed via `useAuthClient()`. No config threading needed.
+
+Source: auth.ts:54-67
+
+### HIGH Using near.client.send() without ensureConnected
+
+Wrong:
+
+```typescript
+authClient.near.client.transaction(accountId)
+  .functionCall(contract, "method", args, opts)
+  .send(); // fails if wallet disconnected after sign-in
+```
+
+Correct:
+
+```typescript
+await authClient.near.ensureConnected();
+authClient.near.client.transaction(accountId)
+  .functionCall(contract, "method", args, opts)
+  .send();
+```
+
+Wallet extensions disconnect between sign-in and subsequent signing. `buildSignedDelegateAction` calls `ensureConnected` automatically, but direct `.send()` does not.
+
+Source: src/client.ts:249-253
+
+### MEDIUM Module-level singleton in SSR causes cross-request state leaks
+
+Wrong (SSR):
+
+```typescript
+// Module-level singleton — shared across all server requests
+export const authClient = createAuthClient({
+  plugins: [siwnClient({ recipient: "myapp.near" })],
+});
+```
+
+Correct (SSR):
+
+```typescript
+// Factory — one instance per router/request
+export function createAuthClient() {
+  return createBetterAuthClient({
+    plugins: [siwnClient({ recipient: getAccount() })],
+  });
+}
+// Created in createRouter() context
+```
+
+On the server, a module-level singleton's `$fetch` and session state would be shared across concurrent requests. Router context isolates one client per request on server, one per app on client.
+
+Source: router.server.tsx:60-71