@edcalderon/auth 1.1.3 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [1.2.0] - 2026-03-02
+
+### Added
+
+- 🔗 Added agnostic Web3 support to the core `SignInOptions` (`options.provider === 'web3'`).
+- 🔗 Upgraded `SupabaseClient` and `HybridClient` adapters to natively call Supabase's `signInWithWeb3` standard.
+- 📝 Documented Wagmi and `@solana/wallet-adapter` implementation examples in README.
+
 ## [1.1.3] - 2026-03-02
 
 ### Docs

package/README.md

@@ -10,11 +10,13 @@ Swap between Supabase, Firebase, Hybrid, or any custom provider without changing
 
 ---
 
-## 📋 Latest Changes (v1.1.3)
+## 📋 Latest Changes (v1.2.0)
 
-### Docs
+### Added
 
-- 📝 Fully rewrote README to document the new `v1.1.0` Universal Compatibility (Web + Next.js + React Native/Expo) APIs and export paths.
+- 🔗 Added agnostic Web3 support to the core `SignInOptions` (`options.provider === 'web3'`).
+- 🔗 Upgraded `SupabaseClient` and `HybridClient` adapters to natively call Supabase's `signInWithWeb3` standard.
+- 📝 Documented Wagmi and `@solana/wallet-adapter` implementation examples in README.
 
 For full version history, see [CHANGELOG.md](./CHANGELOG.md) and [GitHub releases](https://github.com/edcalderon/my-second-brain/releases)
 
@@ -114,7 +116,36 @@ export default function Dashboard() {
 }
 ```
 
-### 2. Provider Top-Level App Injectors
+### 2. Web3 Crypto Wallets (Wagmi / Solana)
+
+Because the orchestration is provider-blind, you can easily pair it with libraries like `wagmi` or `@solana/wallet-adapter-react`.
+
+```tsx
+"use client";
+import { useAuth } from "@edcalderon/auth";
+import { useWallet } from "@solana/wallet-adapter-react";
+
+export function SolanaLogin() {
+    const { signIn } = useAuth();
+    const wallet = useWallet();
+
+    const handleWeb3SignIn = () => {
+        if (!wallet.connected) return;
+        
+        signIn({ 
+            provider: "web3", 
+            web3: { 
+                chain: "solana", 
+                wallet: wallet.wallet?.adapter // Pass the raw wallet adapter
+            } 
+        });
+    }
+
+    return <button onClick={handleWeb3SignIn}>Sign In with Solana</button>;
+}
+```
+
+### 3. Provider Top-Level App Injectors
 
 Wire the environment appropriate class up at your app root.
 
@@ -208,10 +239,18 @@ The core strength of `@edcalderon/auth` is that **any authentication service** c
 type AuthRuntime = "web" | "native" | "server";
 type OAuthFlow = "popup" | "redirect" | "native";
 
+export interface Web3SignInOptions {
+    chain: "ethereum" | "solana" | "bitcoin";
+    wallet?: any;
+    message?: string;
+    signature?: string;
+}
+
 export interface SignInOptions {
-    provider?: "google" | "apple" | "github" | string;
+    provider?: "google" | "apple" | "github" | "web3" | string;
     flow?: OAuthFlow;
     redirectUri?: string;
+    web3?: Web3SignInOptions;
 }
 
 export interface AuthClient {

package/dist/providers/HybridNativeClient.js

@@ -48,6 +48,20 @@ export class HybridNativeClient {
     }
     async signIn(options) {
         const provider = options.provider || "google";
+        if (provider === "web3") {
+            if (!options.web3)
+                throw new Error("CONFIG_ERROR: options.web3 is required when provider is 'web3'");
+            const { error } = await this.supabase.auth.signInWithWeb3({
+                // @ts-ignore - Supabase TS types might be strict (e.g. 0x${string}), bypass for agnostic adapter
+                chain: options.web3.chain,
+                message: options.web3.message,
+                signature: options.web3.signature,
+                wallet: options.web3.wallet,
+            });
+            if (error)
+                throw new Error(`PROVIDER_ERROR: ${error.message}`);
+            return;
+        }
         // Pure Supabase route
         if (!this.firebaseAuth || !this.methods || !this.oauthHandlers[provider]) {
             console.warn(`Native OAuth via Hybrid fallback for '${provider}' targeting Supabase purely`);

package/dist/providers/HybridWebClient.js

@@ -48,6 +48,20 @@ export class HybridWebClient {
     }
     async signIn(options) {
         const provider = options.provider || "google";
+        if (provider === "web3") {
+            if (!options.web3)
+                throw new Error("CONFIG_ERROR: options.web3 is required when provider is 'web3'");
+            const { error } = await this.supabase.auth.signInWithWeb3({
+                // @ts-ignore - Supabase TS types might be strict (e.g. 0x${string}), bypass for agnostic adapter
+                chain: options.web3.chain,
+                message: options.web3.message,
+                signature: options.web3.signature,
+                wallet: options.web3.wallet,
+            });
+            if (error)
+                throw new Error(`PROVIDER_ERROR: ${error.message}`);
+            return;
+        }
         if (!this.firebaseAuth || !this.methods || !this.googleProvider) {
             console.warn("Firebase not configured on Hybrid fallback, using Supabase pure auth");
             const { error } = await this.supabase.auth.signInWithOAuth({

package/dist/providers/SupabaseClient.js

@@ -50,7 +50,22 @@ export class SupabaseClient {
     }
     async signIn(options) {
         if (!options.provider) {
-            throw new Error("CONFIG_ERROR: options.provider is required for Supabase OAuth");
+            throw new Error("CONFIG_ERROR: options.provider is required for Supabase OAuth or Web3");
+        }
+        if (options.provider === "web3") {
+            if (!options.web3) {
+                throw new Error("CONFIG_ERROR: options.web3 is required when provider is 'web3'");
+            }
+            const { error } = await this.supabase.auth.signInWithWeb3({
+                // @ts-ignore - Supabase TS types might be strict (e.g. 0x${string}), bypass for agnostic adapter
+                chain: options.web3.chain,
+                message: options.web3.message,
+                signature: options.web3.signature,
+                wallet: options.web3.wallet,
+            });
+            if (error)
+                throw new Error(`PROVIDER_ERROR: ${error.message}`);
+            return;
         }
         let redirectTo = options.redirectUri;
         // Apply web assumption ONLY if strictly web

package/dist/types.d.ts

@@ -1,9 +1,16 @@
 export type AuthRuntime = "web" | "native" | "server";
 export type OAuthFlow = "popup" | "redirect" | "native";
+export interface Web3SignInOptions {
+    chain: "ethereum" | "solana" | "bitcoin";
+    wallet?: any;
+    message?: string;
+    signature?: string;
+}
 export interface SignInOptions {
-    provider?: "google" | "apple" | "github" | string;
+    provider?: "google" | "apple" | "github" | "web3" | string;
     flow?: OAuthFlow;
     redirectUri?: string;
+    web3?: Web3SignInOptions;
 }
 export type AuthErrorCode = "CONFIG_ERROR" | "UNSUPPORTED_FLOW" | "NETWORK_ERROR" | "PROVIDER_ERROR" | "SESSION_ERROR";
 export interface User {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edcalderon/auth",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "A universal, provider-agnostic authentication package (Web + Next.js + Expo/React Native)",
   "exports": {
     ".": {