@phantom/browser-sdk 0.2.1 → 0.2.3

package/README.md

@@ -83,6 +83,10 @@ const sdk = new BrowserSDK({
   apiBaseUrl: "https://api.phantom.com",
   organizationId: "your-org-id",
   embeddedWalletType: "app-wallet", // or 'user-wallet'
+  authOptions: {
+    authUrl: "https://auth.phantom.app", // optional, defaults to "https://connect.phantom.app"
+    redirectUrl: "https://yourapp.com/callback", // optional, defaults to current page
+  },
 });
 ```
 
@@ -170,7 +174,10 @@ interface BrowserSDKConfig {
   addressTypes?: AddressType[]; // Networks to enable
   apiBaseUrl?: string; // Phantom API base URL
   organizationId?: string; // Your organization ID
-  authUrl?: string; // Custom auth URL (optional)
+  authOptions?: {
+    authUrl?: string; // Custom auth URL (default: "https://connect.phantom.app")
+    redirectUrl?: string; // Custom redirect URL after authentication
+  };
   embeddedWalletType?: "app-wallet" | "user-wallet"; // Wallet type
   solanaProvider?: "web3js" | "kit"; // Solana library choice (default: 'web3js')
 }
@@ -188,6 +195,58 @@ const result = await sdk.connect();
 // addresses only includes types from addressTypes config
 ```
 
+For embedded user-wallets, you can specify authentication options:
+
+```typescript
+// Phantom Connect with provider selection (default)
+const result = await sdk.connect();
+
+// Phantom Connect with Google authentication (skips provider selection)
+const result = await sdk.connect({
+  authOptions: {
+    provider: "google",
+  },
+});
+
+// Phantom Connect with Apple authentication (skips provider selection)
+const result = await sdk.connect({
+  authOptions: {
+    provider: "apple",
+  },
+});
+
+// JWT authentication (direct API call)
+const result = await sdk.connect({
+  authOptions: {
+    provider: "jwt",
+    jwtToken: "your-jwt-token",
+    customAuthData: { userId: "user123" },
+  },
+});
+```
+
+**Authentication Options:**
+
+- `provider` - Authentication method: `"google"`, `"apple"`, or `"jwt"`
+  - If not specified: Shows provider selection screen on Phantom Connect
+  - If `"google"` or `"apple"`: Skips provider selection and uses specified provider
+  - If `"jwt"`: Uses JWT authentication flow via API call
+- `jwtToken` - Required when `provider` is `"jwt"`. Your JWT token for authentication
+- `customAuthData` - Additional data to pass to authentication service
+
+**Authentication Flow Types:**
+
+1. **Phantom Connect (Redirect-based)**: Used when `provider` is undefined, `"google"`, or `"apple"`
+
+   - Redirects to `https://connect.phantom.app` (or custom `authOptions.authUrl` from config)
+   - Handles OAuth flow with selected provider
+   - Returns to your app with authentication result using `authOptions.redirectUrl` or current page
+
+2. **JWT Authentication (API-based)**: Used when `provider` is `"jwt"`
+   - Makes direct API call to `/api/auth/jwt` endpoint
+   - Validates JWT token server-side
+   - Returns wallet immediately without redirect
+
 #### signAndSendTransaction(transaction)
 
 Sign and send a native transaction object.

package/dist/index.d.ts

@@ -1,5 +1,51 @@
-import { AddressType, NetworkId } from '@phantom/client';
+import { AddressType } from '@phantom/client';
 export { AddressType, NetworkId } from '@phantom/client';
+import { AuthOptions, ConnectResult, SignMessageParams, SignAndSendTransactionParams, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
+export { AuthOptions, ConnectResult, SignAndSendTransactionParams, SignMessageParams, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
+
+declare enum DebugLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+interface DebugMessage {
+    timestamp: number;
+    level: DebugLevel;
+    category: string;
+    message: string;
+    data?: any;
+}
+type DebugCallback = (message: DebugMessage) => void;
+declare class Debug {
+    private static instance;
+    private callback?;
+    private level;
+    private enabled;
+    private constructor();
+    static getInstance(): Debug;
+    setCallback(callback: DebugCallback): void;
+    setLevel(level: DebugLevel): void;
+    enable(): void;
+    disable(): void;
+    private writeLog;
+    error(category: string, message: string, data?: any): void;
+    warn(category: string, message: string, data?: any): void;
+    info(category: string, message: string, data?: any): void;
+    debug(category: string, message: string, data?: any): void;
+    log(category: string, message: string, data?: any): void;
+}
+declare const debug: Debug;
+declare const DebugCategory: {
+    readonly BROWSER_SDK: "BrowserSDK";
+    readonly PROVIDER_MANAGER: "ProviderManager";
+    readonly EMBEDDED_PROVIDER: "EmbeddedProvider";
+    readonly INJECTED_PROVIDER: "InjectedProvider";
+    readonly PHANTOM_CONNECT_AUTH: "PhantomConnectAuth";
+    readonly JWT_AUTH: "JWTAuth";
+    readonly STORAGE: "Storage";
+    readonly SESSION: "Session";
+};
 
 interface BrowserSDKConfig {
     providerType: "injected" | "embedded" | (string & Record<never, never>);
@@ -7,29 +53,18 @@ interface BrowserSDKConfig {
     addressTypes?: AddressType[];
     apiBaseUrl?: string;
     organizationId?: string;
-    authUrl?: string;
+    authOptions?: {
+        authUrl?: string;
+        redirectUrl?: string;
+    };
     embeddedWalletType?: "app-wallet" | "user-wallet" | (string & Record<never, never>);
     solanaProvider?: "web3js" | "kit";
     serverUrl?: string;
-}
-interface WalletAddress {
-    addressType: AddressType;
-    address: string;
-}
-interface ConnectResult {
-    walletId?: string;
-    addresses: WalletAddress[];
-}
-interface SignMessageParams {
-    message: string;
-    networkId: NetworkId;
-}
-interface SignAndSendTransactionParams {
-    transaction: any;
-    networkId: NetworkId;
-}
-interface SignedTransaction {
-    rawTransaction: string;
+    debug?: {
+        enabled?: boolean;
+        level?: DebugLevel;
+        callback?: DebugCallback;
+    };
 }
 interface CreateUserOrganizationParams {
     userId: string;
@@ -38,8 +73,9 @@ interface CreateUserOrganizationParams {
 interface CreateUserOrganizationResult {
     organizationId: string;
 }
+
 interface Provider {
-    connect(): Promise<ConnectResult>;
+    connect(authOptions?: AuthOptions): Promise<ConnectResult>;
     disconnect(): Promise<void>;
     signMessage(params: SignMessageParams): Promise<string>;
     signAndSendTransaction(params: SignAndSendTransactionParams): Promise<SignedTransaction>;
@@ -65,6 +101,7 @@ declare class BrowserSDK {
     connect(options?: {
         providerType?: "injected" | "embedded" | (string & Record<never, never>);
         embeddedWalletType?: "app-wallet" | "user-wallet" | (string & Record<never, never>);
+        authOptions?: AuthOptions;
     }): Promise<ConnectResult>;
     /**
      * Switch to a different provider type
@@ -115,4 +152,10 @@ declare class BrowserSDK {
     createUserOrganization(params: CreateUserOrganizationParams): Promise<CreateUserOrganizationResult>;
 }
 
-export { BrowserSDK, BrowserSDKConfig, ConnectResult, CreateUserOrganizationParams, CreateUserOrganizationResult, Provider, SignAndSendTransactionParams, SignMessageParams, SignedTransaction, WalletAddress };
+/**
+ * Constants used throughout the browser SDK
+ */
+declare const DEFAULT_AUTH_URL = "https://connect.phantom.app";
+declare const DEFAULT_WALLET_API_URL = "https://api.phantom.app/v1/wallets";
+
+export { BrowserSDK, BrowserSDKConfig, CreateUserOrganizationParams, CreateUserOrganizationResult, DEFAULT_AUTH_URL, DEFAULT_WALLET_API_URL, DebugCallback, DebugCategory, DebugLevel, DebugMessage, Provider, debug };