@tuwaio/satellite-siwe-next-auth 1.0.0-fix-watcher-alpha.3.b979b45 → 1.0.0-fix-error-handling-alpha.2.5165cfe

package/README.md

@@ -6,7 +6,7 @@
 
 A robust connector module for enabling secure Web3 authentication (Sign-In with Ethereum, SIWE) in Next.js App Router using **Iron Session** for state management.
 
------
+---
 
 ## 🏛️ What is `@tuwaio/satellite-siwe-next-auth`?
 
@@ -14,9 +14,9 @@ A robust connector module for enabling secure Web3 authentication (Sign-In with
 
 It replaces the complexity of traditional NextAuth setup by leveraging **Iron Session** for robust, encrypted, server-side session management, ensuring a seamless and fully decentralized authentication experience.
 
-Built on top of **Wagmi/Viem** for signature generation.
+Built on top of **Wagmi/Viem** for signature generation and verification.
 
------
+---
 
 ## ✨ Key Features
 
@@ -25,24 +25,21 @@ Built on top of **Wagmi/Viem** for signature generation.
 - **Auto-Session Management:** Handles automatic re-authentication and session cleanup upon wallet disconnection or address/chain change.
 - **Flexible Configuration:** Allows custom configuration of Iron Session settings (password, cookie name) and support for **Async Hooks** (e.g., `afterVerify`, `afterLogout`).
 
------
+---
 
 ## 💾 Installation
 
 ### Requirements
 
-- Node.js 20+
+- Node.js 20-24
 - TypeScript 5.9+
 - Wagmi v2+
 - Viem v2+
 - Iron Session v8+
 
 ```bash
-# Using pnpm (recommended)
+# Using pnpm (recommended), but you can use npm, yarn or bun as well
 pnpm add @tuwaio/satellite-siwe-next-auth siwe iron-session wagmi @wagmi/core viem
-
-# Using npm
-npm install @tuwaio/satellite-siwe-next-auth siwe iron-session wagmi @wagmi/core viem
 ```
 
 ### Environment Setup
@@ -54,23 +51,23 @@ This package requires two **private** server environment variables for security:
 | `SIWE_SESSION_SECRET` | **Required.** A cryptographically secure secret (minimum 32 characters) used by Iron Session to encrypt the session cookie. |
 | `SIWE_SESSION_URL` | **Required.** The full base URL of your application (e.g., `http://localhost:3000` or `https://myapp.com`). Used for SIWE domain verification. |
 
-**Example `.env.local`:**
+**Example `.env`:**
 
 ```env
 SIWE_SESSION_SECRET="oowX51fBPYHSVQxPbktPrfM8Lb3Kbeg3oQ6aCKdeLLo="
 SIWE_SESSION_URL="http://localhost:3000"
 ```
 
------
+---
 
 ## 🚀 Quick Start
 
 ### 1. Server Setup (API Route)
 
-Create the dynamic API route file at **`src/api/siwe/[...siwe]/route.ts`** and export the handler from the package. This handles `/login`, `/logout`, and `/session` requests.
+Create the dynamic API route file at **`app/api/siwe/[...siwe]/route.ts`** and export the handler from the package. This handles `/login`, `/logout`, and `/session` requests.
 
 ```typescript
-// src/api/siwe/[...siwe]/route.ts
+// app/api/siwe/[...siwe]/route.ts
 
 import { createSiweApiHandler } from '@tuwaio/satellite-siwe-next-auth/server';
 
@@ -81,22 +78,40 @@ const siweApiHandler = createSiweApiHandler();
 export const { GET, POST, DELETE } = siweApiHandler;
 ```
 
-### 2. Client Setup (Provider)
+### 2. Client Setup (Providers)
 
 Wrap your application in the `SiweNextAuthProvider`. This provider manages the authentication state, session fetching, and handles auto-sign-out/re-authentication on wallet changes.
 
 ```tsx
 // src/providers/Providers.tsx
 
+'use client';
+
+import { ReactNode, useState } from 'react';
+import { WagmiProvider, createConfig, http } from 'wagmi';
+import { mainnet, sepolia } from 'viem/chains';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { SiweNextAuthProvider } from '@tuwaio/satellite-siwe-next-auth';
-// ... other imports (WagmiProvider, QueryClientProvider)
 
-export function Providers({ children }: { children: React.ReactNode }) {
+// 1. Configure Wagmi
+export const wagmiConfig = createConfig({
+  chains: [mainnet, sepolia],
+  transports: {
+    [mainnet.id]: http(),
+    [sepolia.id]: http(),
+  },
+});
+
+// 2. Create Query Client
+const queryClient = new QueryClient();
+
+export function Providers({ children }: { children: ReactNode }) {
   return (
     <WagmiProvider config={wagmiConfig}>
       <QueryClientProvider client={queryClient}>
-        {/* WAGMI AND REACT-QUERY MUST WRAP THE SIWE PROVIDER */}
+        {/* SiweNextAuthProvider must be inside Wagmi and QueryClient providers */}
         <SiweNextAuthProvider
+          wagmiConfig={wagmiConfig}
           enabled={true}
           onSignOut={() => console.log('User signed out')}
           onSignIn={(session) => console.log('User signed in:', session)}
@@ -109,37 +124,43 @@ export function Providers({ children }: { children: React.ReactNode }) {
 }
 ```
 
-### 3. Usage (Login Component)
+### 3. Integrating with Satellite Connect
 
-Use the `useSiweAuth` hook to access the sign-in function and state.
+Use the `useSiweAuth` hook to integrate SIWE authentication into the `SatelliteConnectProvider`.
 
 ```tsx
-// src/components/WalletConnect.tsx
+// src/providers/SatelliteSiweProvider.tsx
+
+'use client';
 
+import { ReactNode } from 'react';
+import { SatelliteConnectProvider, EVMConnectorsWatcher } from '@tuwaio/satellite-react';
+import { satelliteEVMAdapter } from '@tuwaio/satellite-evm';
 import { useSiweAuth } from '@tuwaio/satellite-siwe-next-auth';
-// ... other imports (Wagmi hooks, etc.)
+import { wagmiConfig } from './Providers'; // Your Wagmi config
+
+export function SatelliteSiweProvider({ children }: { children: ReactNode }) {
+  // Get SIWE auth state and methods
+  const { signInWithSiwe, enabled: siweEnabled, isSignedIn, isRejected } = useSiweAuth();
 
-export function SatelliteConnectProviders({ children }: { children: React.ReactNode }) {
-  const { signInWithSiwe, isSignedIn, isRejected, enabled } = useSiweAuth();
-  
-  // Example usage: Pass signInWithSiwe as the connection handler to a wallet adapter
-  // The adapter will call signInWithSiwe() after a wallet connection is established.
   return (
     <SatelliteConnectProvider
-      adapter={[
-        // Pass signInWithSiwe to your EVM adapter
-        satelliteEVMAdapter(wagmiConfig, enabled ? signInWithSiwe : undefined), 
-        // ...
-      ]}
+      // Pass the EVM adapter with SIWE integration
+      adapter={satelliteEVMAdapter(wagmiConfig, siweEnabled ? signInWithSiwe : undefined)}
       autoConnect={true}
     >
-      {/* ... your components */}
+      {/* EVMConnectorsWatcher handles disconnections and account changes */}
+      <EVMConnectorsWatcher 
+        wagmiConfig={wagmiConfig} 
+        siwe={{ isSignedIn, isRejected, enabled: siweEnabled }} 
+      />
+      {children}
     </SatelliteConnectProvider>
   );
 }
 ```
 
------
+---
 
 ## ⚙️ Custom Configuration
 
@@ -158,34 +179,34 @@ The `createSiweApiHandler` accepts an optional configuration object to override
 ### Example Custom Initialization
 
 ```typescript
-// src/api/siwe/[...siwe]/route.ts
+// app/api/siwe/[...siwe]/route.ts
 
 import { createSiweApiHandler } from '@tuwaio/satellite-siwe-next-auth/server';
 
 const siweApiHandler = createSiweApiHandler({
-    // Custom Session Settings
-    session: {
-        cookieName: "my_app_session",
-        cookieOptions: {
-            maxAge: 60 * 60 * 24 * 7, // 7 days
-        }
+  // Custom Session Settings
+  session: {
+    cookieName: "my_app_session",
+    cookieOptions: {
+      maxAge: 60 * 60 * 24 * 7, // 7 days
+    }
+  },
+  // Custom Hooks
+  options: {
+    afterVerify: async () => {
+      // This logic runs on the server side after a valid signature is confirmed.
+      console.log("User verified, ready to create DB record.");
     },
-    // Custom Hooks
-    options: {
-        afterVerify: async () => {
-            // This logic runs on the server side after a valid signature is confirmed.
-            console.log("User verified, ready to create DB record.");
-        },
-        afterLogout: () => {
-            console.log("User session destroyed.");
-        }
+    afterLogout: () => {
+      console.log("User session destroyed.");
     }
+  }
 });
 
 export const { GET, POST, DELETE } = siweApiHandler;
 ```
 
------
+---
 
 ## 🤝 Contributing & Support
 

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { S as SIWESession, a as SiweAuthContextType, b as SiweNextAuthProviderProps, U as UseSiweSignatureResult } from './types-D5pX4B-f.mjs';
-export { C as ConfigurableMessageOptions, G as GetSiweMessageOptions, h as Session, f as SiweApiConfig, e as SiweApiHooks, c as SiweCookieOptions, g as SiweSessionData, d as SiweSessionSettings, i as UnconfigurableMessageOptions } from './types-D5pX4B-f.mjs';
+import { S as SIWESession, a as SiweAuthContextType, b as SiweNextAuthProviderProps, U as UseSiweSignatureResult } from './types-DYvmUmv4.mjs';
+export { C as ConfigurableMessageOptions, G as GetSiweMessageOptions, c as Session, d as SiweApiConfig, e as SiweApiHooks, f as SiweCookieOptions, g as SiweSessionData, h as SiweSessionSettings, i as UnconfigurableMessageOptions } from './types-DYvmUmv4.mjs';
 import { Config } from '@wagmi/core';
 import * as react from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as SIWESession, a as SiweAuthContextType, b as SiweNextAuthProviderProps, U as UseSiweSignatureResult } from './types-D5pX4B-f.js';
-export { C as ConfigurableMessageOptions, G as GetSiweMessageOptions, h as Session, f as SiweApiConfig, e as SiweApiHooks, c as SiweCookieOptions, g as SiweSessionData, d as SiweSessionSettings, i as UnconfigurableMessageOptions } from './types-D5pX4B-f.js';
+import { S as SIWESession, a as SiweAuthContextType, b as SiweNextAuthProviderProps, U as UseSiweSignatureResult } from './types-DYvmUmv4.js';
+export { C as ConfigurableMessageOptions, G as GetSiweMessageOptions, c as Session, d as SiweApiConfig, e as SiweApiHooks, f as SiweCookieOptions, g as SiweSessionData, h as SiweSessionSettings, i as UnconfigurableMessageOptions } from './types-DYvmUmv4.js';
 import { Config } from '@wagmi/core';
 import * as react from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';

package/dist/server/index.d.mts

@@ -1,5 +1,5 @@
 import { SessionOptions } from 'iron-session';
-import { f as SiweApiConfig } from '../types-D5pX4B-f.mjs';
+import { d as SiweApiConfig } from '../types-DYvmUmv4.mjs';
 import { NextRequest } from 'next/server';
 import '@wagmi/core';
 import 'react';

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
 import { SessionOptions } from 'iron-session';
-import { f as SiweApiConfig } from '../types-D5pX4B-f.js';
+import { d as SiweApiConfig } from '../types-DYvmUmv4.js';
 import { NextRequest } from 'next/server';
 import '@wagmi/core';
 import 'react';

package/dist/{types-D5pX4B-f.d.mts → types-DYvmUmv4.d.mts}

@@ -155,4 +155,4 @@ interface SiweNextAuthProviderProps {
     children: ReactNode;
 }
 
-export type { ConfigurableMessageOptions as C, GetSiweMessageOptions as G, SIWESession as S, UseSiweSignatureResult as U, SiweAuthContextType as a, SiweNextAuthProviderProps as b, SiweCookieOptions as c, SiweSessionSettings as d, SiweApiHooks as e, SiweApiConfig as f, SiweSessionData as g, Session as h, UnconfigurableMessageOptions as i };
+export type { ConfigurableMessageOptions as C, GetSiweMessageOptions as G, SIWESession as S, UseSiweSignatureResult as U, SiweAuthContextType as a, SiweNextAuthProviderProps as b, Session as c, SiweApiConfig as d, SiweApiHooks as e, SiweCookieOptions as f, SiweSessionData as g, SiweSessionSettings as h, UnconfigurableMessageOptions as i };

package/dist/{types-D5pX4B-f.d.ts → types-DYvmUmv4.d.ts}

@@ -155,4 +155,4 @@ interface SiweNextAuthProviderProps {
     children: ReactNode;
 }
 
-export type { ConfigurableMessageOptions as C, GetSiweMessageOptions as G, SIWESession as S, UseSiweSignatureResult as U, SiweAuthContextType as a, SiweNextAuthProviderProps as b, SiweCookieOptions as c, SiweSessionSettings as d, SiweApiHooks as e, SiweApiConfig as f, SiweSessionData as g, Session as h, UnconfigurableMessageOptions as i };
+export type { ConfigurableMessageOptions as C, GetSiweMessageOptions as G, SIWESession as S, UseSiweSignatureResult as U, SiweAuthContextType as a, SiweNextAuthProviderProps as b, Session as c, SiweApiConfig as d, SiweApiHooks as e, SiweCookieOptions as f, SiweSessionData as g, SiweSessionSettings as h, UnconfigurableMessageOptions as i };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/satellite-siwe-next-auth",
-  "version": "1.0.0-fix-watcher-alpha.3.b979b45",
+  "version": "1.0.0-fix-error-handling-alpha.2.5165cfe",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -60,16 +60,16 @@
     "wagmi": "3.x.x"
   },
   "devDependencies": {
-    "@wagmi/core": "^3.1.0",
-    "@types/react": "^19.2.7",
+    "@wagmi/core": "^3.3.1",
+    "@types/react": "^19.2.10",
     "siwe": "^3.0.0",
-    "next": "16.1.1",
+    "next": "16.1.6",
     "iron-session": "^8.0.4",
-    "react": "^19.2.3",
+    "react": "^19.2.4",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "viem": "^2.43.5",
-    "wagmi": "^3.2.0"
+    "viem": "^2.45.0",
+    "wagmi": "^3.4.1"
   },
   "scripts": {
     "start": "tsup src/index.ts --watch",