@pooflabs/web 0.0.1

package/README.md

@@ -0,0 +1,130 @@
+# @tarobase/web
+
+Web SDK for Tarobase API - Browser/Frontend implementation. This package provides identical functionality to the original `@tarobase/js-sdk` package, but uses a modular architecture with shared functionality in `@tarobase/core`.
+
+## Installation
+
+```bash
+npm install @tarobase/web
+```
+
+## Usage
+
+```typescript
+import { init, login, getCurrentUser, set, get } from '@tarobase/web';
+
+// Initialize the SDK
+await init({
+  appId: 'your-app-id',
+  authMethod: 'phantom',  // or 'privy'
+});
+
+// Log in
+await login();
+
+// Get the current user
+const user = getCurrentUser();
+console.log(user.address);
+
+// Set data
+await set('todos/123', { text: 'Buy milk', completed: false });
+
+// Get data
+const todo = await get('todos/123');
+console.log(todo);
+```
+
+### React Hook
+
+```typescript
+import { useAuth } from '@tarobase/web';
+
+function MyComponent() {
+  const { user, isLoading, isLoggedIn, login, logout } = useAuth();
+
+  if (isLoading) {
+    return <div>Loading...</div>;
+  }
+
+  if (!isLoggedIn) {
+    return <button onClick={login}>Login</button>;
+  }
+
+  return (
+    <div>
+      <p>Logged in as: {user.address}</p>
+      <button onClick={logout}>Logout</button>
+    </div>
+  );
+}
+```
+
+## Authentication Methods
+
+### Phantom Wallet
+
+```typescript
+await init({
+  appId: 'your-app-id',
+  authMethod: 'phantom'
+});
+```
+
+### Privy Wallet
+
+```typescript
+await init({
+  appId: 'your-app-id',
+  authMethod: 'privy',
+  privyConfig: {
+    appId: 'your-privy-app-id',
+    config: {
+      // Privy configuration options
+      embeddedWallets: {
+        solana: {
+          createOnLogin: "users-without-wallets"
+        }
+      }
+    }
+  }
+});
+```
+
+## API Reference
+
+### Initialization
+
+```typescript
+function init(newConfig: Partial<ClientConfig>): Promise<void>;
+```
+
+### Authentication
+
+```typescript
+function login(): Promise<User | null>;
+function logout(): Promise<void>;
+function getCurrentUser(): User | null;
+function onAuthStateChanged(callback: (user: User | null) => void): void;
+```
+
+### Data Operations
+
+```typescript
+function get(path: string): Promise<any>;
+function set(path: string, data: any, options?: SetOptions): Promise<any>;
+function setMany(paths: { [key: string]: any }, options?: SetOptions): Promise<any>;
+function setFile(path: string, file: File, metadata?: any): Promise<any>;
+function getFiles(path: string): Promise<any>;
+function runQuery(queryString: string, variables?: any): Promise<any>;
+function runQueryMany(queryString: string, variables?: any): Promise<any>;
+```
+
+### Subscriptions
+
+```typescript
+function subscribe(path: string, options?: SubscriptionOptions): Promise<() => void>;
+```
+
+## Contributing
+
+Please see the main repository for contribution guidelines.

package/dist/auth/hooks/useAuth.d.ts

@@ -0,0 +1,8 @@
+import { User } from '@tarobase/core';
+export interface UseAuthResult {
+    login: () => Promise<void>;
+    logout: () => Promise<void>;
+    loading: boolean;
+    user: User | null;
+}
+export declare function useAuth(): UseAuthResult;

package/dist/auth/index.d.ts

@@ -0,0 +1,5 @@
+import { AuthProvider, User } from '@tarobase/core';
+export declare function getAuthProvider(): Promise<AuthProvider>;
+export declare function matchAuthProvider(appName: string | null, appLogoUrl: string | null, authMethod: string, rpcUrl: string, privyConfig?: any): Promise<AuthProvider>;
+export declare function login(): Promise<User | null>;
+export declare function logout(): Promise<void>;

package/dist/auth/providers/phantom-wallet-provider.d.ts

@@ -0,0 +1,74 @@
+import type { EVMTransaction, SolTransaction, TransactionResult, User, AuthProvider } from '@tarobase/core';
+import { PublicKey, Transaction, VersionedTransaction } from '@solana/web3.js';
+import { CreatePhantomConfig } from '@phantom/wallet-sdk';
+import { SetOptions } from '@tarobase/core';
+export declare class PhantomWalletProvider implements AuthProvider {
+    private connection;
+    private initialized;
+    private networkUrl;
+    private embeddedWallet;
+    private embeddedConfig;
+    constructor(networkUrl?: string, embeddedConfig?: CreatePhantomConfig);
+    private init;
+    /**
+     * Shows the embedded wallet UI
+     */
+    showWallet(): void;
+    /**
+     * Hides the embedded wallet UI
+     */
+    hideWallet(): void;
+    /**
+     * Opens the swap screen in the embedded wallet
+     * @param options Swap options (buy token, sell token, amount)
+     */
+    openSwap(options: {
+        buy: string;
+        sell?: string;
+        amount?: string;
+    }): void;
+    /**
+     * Opens the buy screen in the embedded wallet
+     * @param options Buy options (token to buy, amount in USD)
+     */
+    openBuy(options: {
+        amount?: number;
+        buy: string;
+    }): void;
+    private getProvider;
+    /**
+     * Ensures the wallet is connected and returns the provider
+     * This method will attempt to connect if not already connected
+     */
+    private ensureConnected;
+    login(): Promise<User | null>;
+    restoreSession(): Promise<User | null>;
+    address(): Promise<string | null>;
+    runTransaction(evmTransactionData?: EVMTransaction, solTransactionData?: SolTransaction, options?: SetOptions): Promise<TransactionResult>;
+    signMessage(message: string): Promise<string>;
+    logout(): Promise<void>;
+    getNativeMethods(): Promise<any>;
+}
+declare global {
+    interface Window {
+        phantom?: {
+            solana?: {
+                isPhantom: boolean;
+                isConnected: boolean;
+                publicKey: PublicKey;
+                connect: () => Promise<{
+                    publicKey: PublicKey;
+                }>;
+                disconnect: () => Promise<void>;
+                signMessage: (message: Uint8Array, encoding: string) => Promise<{
+                    signature: Uint8Array;
+                }>;
+                signTransaction: (transaction: Transaction | VersionedTransaction) => Promise<Transaction>;
+                signAndSendTransaction: (transaction: Transaction | VersionedTransaction) => Promise<{
+                    signature: string;
+                }>;
+            };
+        };
+        CUSTOM_TAROBASE_APP_ID_HEADER?: string;
+    }
+}

package/dist/auth/providers/privy-wallet-provider.d.ts

@@ -0,0 +1,27 @@
+import type { EVMTransaction, SolTransaction, TransactionResult } from '@tarobase/core';
+import { AuthProvider, User } from '@tarobase/core';
+import { SetOptions } from '@tarobase/core';
+export declare class PrivyWalletProvider implements AuthProvider {
+    private static instance;
+    private containerElement;
+    private networkUrl;
+    private root;
+    private privyMethods;
+    private privyConfig;
+    private pendingLogin;
+    private pendingTransaction;
+    constructor(appName: string | null, appLogoUrl: string | null, privyConfig?: {
+        appId: string;
+        config: any;
+    }, networkUrl?: string);
+    static getInstance(appName: string | null, appLogoUrl: string | null, privyConfig: any): PrivyWalletProvider;
+    private initialize;
+    login(): Promise<User | null>;
+    getNativeMethods(): Promise<any>;
+    logout(): Promise<void>;
+    runTransaction(_evmTransactionData?: EVMTransaction, solTransactionData?: SolTransaction, options?: SetOptions): Promise<TransactionResult>;
+    signMessage(message: string): Promise<string>;
+    restoreSession(): Promise<User | null>;
+    private createSession;
+    private ensureReady;
+}

package/dist/global.d.ts

@@ -0,0 +1,8 @@
+import { User } from '@tarobase/core';
+import { ClientConfig } from '@tarobase/core';
+export declare function init(newConfig: Partial<ClientConfig>): Promise<void>;
+export declare function onAuthStateChanged(callback: (user: User | null) => void): void;
+export declare function login(): Promise<User | null>;
+export declare function logout(): Promise<void>;
+export declare function setCurrentUser(user: User | null): void;
+export declare function getCurrentUser(): User | null;

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { init, getCurrentUser, onAuthStateChanged, login, logout } from "./global";
+export { getConfig } from '@tarobase/core';
+export { getAuthProvider } from './auth';
+export { get, set, setMany, setFile, getFiles, runQuery, runQueryMany } from '@tarobase/core';
+export { subscribe } from '@tarobase/core';
+export * from '@tarobase/core';
+export { useAuth } from './auth/hooks/useAuth';
+export { getIdToken } from '@tarobase/core';