@avalabs/avacloud-waas-react 1.3.0 → 1.4.0

package/README.md

@@ -89,13 +89,36 @@ The main provider component that wraps your application and provides wallet cont
 | Prop | Type | Description |
 |------|------|-------------|
 | `orgId` | `string` | **Required** - Your AvaCloud organization ID used to fetch wallet configuration |
-| `env` | `'local' \| 'development' \| 'prod'` | Environment to use (default: `'prod'`) |
+| `env` | `'development' \| 'staging' \| 'production'` | Environment to use (default: `'production'`) |
 | `chainId` | `number` | EVM chain ID (default: `43113` - Avalanche Fuji Testnet) |
 | `darkMode` | `boolean` | Enable dark mode for UI components (default: `false`) |
+| `authServiceUrl` | `string` | Optional custom auth service URL. Overrides default environment-based URLs |
 | `onAuthSuccess` | `(user: Auth0User) => void` | Callback on successful authentication |
 | `onAuthError` | `(error: Error) => void` | Callback on authentication error |
 | `onWalletUpdate` | `(wallet: WalletInfo) => void` | Callback when wallet information updates |
 
+#### Configuring Auth Service URL
+
+The auth service URL can be configured in three ways (in order of precedence):
+
+1. **Direct prop**: Pass `authServiceUrl` directly to the provider
+   ```tsx
+   <AvaCloudWalletProvider
+     orgId="your-org-id"
+     authServiceUrl="https://your-custom-auth-service.com"
+   >
+   ```
+
+2. **Environment variable**: Set `NEXT_PUBLIC_AUTH_SERVICE_URL` in your `.env` file
+   ```bash
+   NEXT_PUBLIC_AUTH_SERVICE_URL=https://your-custom-auth-service.com
+   ```
+
+3. **Default URLs**: Falls back to environment-based defaults
+   - `development`: `http://localhost:3000`
+   - `staging`: `https://ac-auth-service-env-staging-ava-labs.vercel.app`
+   - `production`: `https://ac-auth-service.vercel.app`
+
 ### UI Components
 
 - `LoginButton`: Button component for initiating the login flow

package/dist/index.d.mts

@@ -90,6 +90,8 @@ interface OrgConfig {
     SKey?: string;
     /** Organization ID */
     orgID?: string;
+    /** Cubist organization ID returned by the auth service */
+    cubistOrgId?: string;
     /** Wallet provider organization ID used for Cubist */
     walletProviderOrgID?: string;
     /** Admin portal settings */
@@ -295,6 +297,7 @@ interface AvaCloudWalletProviderProps {
     chainId?: number;
     darkMode?: boolean;
     env?: AvaCloudEnvironment;
+    authServiceUrl?: string;
     onAuthSuccess?: (user: UserInfo) => void;
     onAuthError?: (error: Error) => void;
     onWalletUpdate?: (wallet: WalletInfo) => void;
@@ -312,7 +315,11 @@ interface AvaCloudWalletContextType {
     loginWithCubist: (oidcToken?: string) => Promise<void>;
     cubistClient: CubeSignerClient | null;
     cubistError: Error | null;
-    login: () => void;
+    login: (params?: {
+        email?: string;
+        password?: string;
+        connection?: string;
+    }) => void;
     signup: (email: string, password: string) => void;
     addAccount: (accountIndex: number) => Promise<void>;
     queryClient: QueryClient;
@@ -322,7 +329,7 @@ interface AvaCloudWalletContextType {
     environment: AvaCloudEnvironment;
 }
 
-declare function AvaCloudWalletProvider({ children, orgId, chainId, darkMode, env, onAuthSuccess, onAuthError, onWalletUpdate, }: AvaCloudWalletProviderProps): react_jsx_runtime.JSX.Element;
+declare function AvaCloudWalletProvider({ children, orgId, chainId, darkMode, env, authServiceUrl: customAuthServiceUrl, onAuthSuccess, onAuthError, onWalletUpdate, }: AvaCloudWalletProviderProps): react_jsx_runtime.JSX.Element;
 declare function useAvaCloudWallet(): AvaCloudWalletContextType;
 
 interface ThemeContextType {
@@ -572,6 +579,11 @@ interface GaslessConfig {
     /** Suffix for the request in format "type name" (e.g. "bytes32 XMKUCJONOFSUSFCYHTYHCLX") */
     suffix?: string;
 }
+interface GaslessContextType {
+    isLoading: boolean;
+    error: Error | null;
+    config: GaslessConfig | null;
+}
 interface FetchGaslessConfigParams {
     orgId: string;
     subnetId: string;
@@ -593,6 +605,7 @@ interface GaslessProviderProps {
  *        (relayer URL, forwarder address, etc.) to the browser.
  */
 declare function GaslessProvider({ children, config, fetchParams }: GaslessProviderProps): react_jsx_runtime.JSX.Element;
+declare function useGaslessConfig(): GaslessContextType;
 
 interface GaslessTxState {
     isLoading: boolean;
@@ -619,4 +632,4 @@ interface UseGaslessTransactionOptions {
 }
 declare function useGaslessTransaction({ gaslessConfig, contractAddress: defaultContractAddress, abi: defaultAbi }: UseGaslessTransactionOptions): UseGaslessTransactionReturn;
 
-export { type AddAccountMessage, type AdminPortalSettings, type Auth0User, type AuthMessage, type AuthMessagePayload, type AuthStateUpdateMessage, type AuthStatusMessage, type AvaCloudEnvironment, type AvaCloudWalletContextType, AvaCloudWalletProvider, type AvaCloudWalletProviderProps, type BaseAuthMessage, type CheckAuthStatusMessage, type CubistWalletInfo, type ErrorMessage, ExportView, GaslessProvider, type GetOidcMessage, type IframeReadyMessage, LoginButton, type LoginRequestMessage, type LogoutRequestMessage, type MessageType, type OrgConfig, type ReceiveOidcMessage, ReceiveView, type RegisterMessage, type RegisterPayload, type RegisterSuccessMessage, SendView, type SignupRequestMessage, ThemeProvider, TokensView, type UserInfo, UserProfile, VM, WalletButton, WalletCard, WalletDisplay, type WalletInfo, type WalletKeysErrorMessage, type WalletKeysUpdateMessage, avaCloudWallet, useAuth, useAvaCloudWallet, useBlockchain, useChainId, useGaslessTransaction, useGlacier, usePostMessage, useSignMessage, useSignTransaction, useThemeMode, useTransferTokens, useUserWallets };
+export { type AddAccountMessage, type AdminPortalSettings, type Auth0User, type AuthMessage, type AuthMessagePayload, type AuthStateUpdateMessage, type AuthStatusMessage, type AvaCloudEnvironment, type AvaCloudWalletContextType, AvaCloudWalletProvider, type AvaCloudWalletProviderProps, type BaseAuthMessage, type CheckAuthStatusMessage, type CubistWalletInfo, type ErrorMessage, ExportView, type FetchGaslessConfigParams, type GaslessConfig, GaslessProvider, type GaslessProviderProps, type GetOidcMessage, type IframeReadyMessage, LoginButton, type LoginRequestMessage, type LogoutRequestMessage, type MessageType, type OrgConfig, type ReceiveOidcMessage, ReceiveView, type RegisterMessage, type RegisterPayload, type RegisterSuccessMessage, SendView, type SignupRequestMessage, ThemeProvider, TokensView, type UseGaslessTransactionOptions, type UserInfo, UserProfile, VM, WalletButton, WalletCard, WalletDisplay, type WalletInfo, type WalletKeysErrorMessage, type WalletKeysUpdateMessage, avaCloudWallet, useAuth, useAvaCloudWallet, useBlockchain, useChainId, useGaslessConfig, useGaslessTransaction, useGlacier, usePostMessage, useSignMessage, useSignTransaction, useThemeMode, useTransferTokens, useUserWallets };

package/dist/index.d.ts

@@ -90,6 +90,8 @@ interface OrgConfig {
     SKey?: string;
     /** Organization ID */
     orgID?: string;
+    /** Cubist organization ID returned by the auth service */
+    cubistOrgId?: string;
     /** Wallet provider organization ID used for Cubist */
     walletProviderOrgID?: string;
     /** Admin portal settings */
@@ -295,6 +297,7 @@ interface AvaCloudWalletProviderProps {
     chainId?: number;
     darkMode?: boolean;
     env?: AvaCloudEnvironment;
+    authServiceUrl?: string;
     onAuthSuccess?: (user: UserInfo) => void;
     onAuthError?: (error: Error) => void;
     onWalletUpdate?: (wallet: WalletInfo) => void;
@@ -312,7 +315,11 @@ interface AvaCloudWalletContextType {
     loginWithCubist: (oidcToken?: string) => Promise<void>;
     cubistClient: CubeSignerClient | null;
     cubistError: Error | null;
-    login: () => void;
+    login: (params?: {
+        email?: string;
+        password?: string;
+        connection?: string;
+    }) => void;
     signup: (email: string, password: string) => void;
     addAccount: (accountIndex: number) => Promise<void>;
     queryClient: QueryClient;
@@ -322,7 +329,7 @@ interface AvaCloudWalletContextType {
     environment: AvaCloudEnvironment;
 }
 
-declare function AvaCloudWalletProvider({ children, orgId, chainId, darkMode, env, onAuthSuccess, onAuthError, onWalletUpdate, }: AvaCloudWalletProviderProps): react_jsx_runtime.JSX.Element;
+declare function AvaCloudWalletProvider({ children, orgId, chainId, darkMode, env, authServiceUrl: customAuthServiceUrl, onAuthSuccess, onAuthError, onWalletUpdate, }: AvaCloudWalletProviderProps): react_jsx_runtime.JSX.Element;
 declare function useAvaCloudWallet(): AvaCloudWalletContextType;
 
 interface ThemeContextType {
@@ -572,6 +579,11 @@ interface GaslessConfig {
     /** Suffix for the request in format "type name" (e.g. "bytes32 XMKUCJONOFSUSFCYHTYHCLX") */
     suffix?: string;
 }
+interface GaslessContextType {
+    isLoading: boolean;
+    error: Error | null;
+    config: GaslessConfig | null;
+}
 interface FetchGaslessConfigParams {
     orgId: string;
     subnetId: string;
@@ -593,6 +605,7 @@ interface GaslessProviderProps {
  *        (relayer URL, forwarder address, etc.) to the browser.
  */
 declare function GaslessProvider({ children, config, fetchParams }: GaslessProviderProps): react_jsx_runtime.JSX.Element;
+declare function useGaslessConfig(): GaslessContextType;
 
 interface GaslessTxState {
     isLoading: boolean;
@@ -619,4 +632,4 @@ interface UseGaslessTransactionOptions {
 }
 declare function useGaslessTransaction({ gaslessConfig, contractAddress: defaultContractAddress, abi: defaultAbi }: UseGaslessTransactionOptions): UseGaslessTransactionReturn;
 
-export { type AddAccountMessage, type AdminPortalSettings, type Auth0User, type AuthMessage, type AuthMessagePayload, type AuthStateUpdateMessage, type AuthStatusMessage, type AvaCloudEnvironment, type AvaCloudWalletContextType, AvaCloudWalletProvider, type AvaCloudWalletProviderProps, type BaseAuthMessage, type CheckAuthStatusMessage, type CubistWalletInfo, type ErrorMessage, ExportView, GaslessProvider, type GetOidcMessage, type IframeReadyMessage, LoginButton, type LoginRequestMessage, type LogoutRequestMessage, type MessageType, type OrgConfig, type ReceiveOidcMessage, ReceiveView, type RegisterMessage, type RegisterPayload, type RegisterSuccessMessage, SendView, type SignupRequestMessage, ThemeProvider, TokensView, type UserInfo, UserProfile, VM, WalletButton, WalletCard, WalletDisplay, type WalletInfo, type WalletKeysErrorMessage, type WalletKeysUpdateMessage, avaCloudWallet, useAuth, useAvaCloudWallet, useBlockchain, useChainId, useGaslessTransaction, useGlacier, usePostMessage, useSignMessage, useSignTransaction, useThemeMode, useTransferTokens, useUserWallets };
+export { type AddAccountMessage, type AdminPortalSettings, type Auth0User, type AuthMessage, type AuthMessagePayload, type AuthStateUpdateMessage, type AuthStatusMessage, type AvaCloudEnvironment, type AvaCloudWalletContextType, AvaCloudWalletProvider, type AvaCloudWalletProviderProps, type BaseAuthMessage, type CheckAuthStatusMessage, type CubistWalletInfo, type ErrorMessage, ExportView, type FetchGaslessConfigParams, type GaslessConfig, GaslessProvider, type GaslessProviderProps, type GetOidcMessage, type IframeReadyMessage, LoginButton, type LoginRequestMessage, type LogoutRequestMessage, type MessageType, type OrgConfig, type ReceiveOidcMessage, ReceiveView, type RegisterMessage, type RegisterPayload, type RegisterSuccessMessage, SendView, type SignupRequestMessage, ThemeProvider, TokensView, type UseGaslessTransactionOptions, type UserInfo, UserProfile, VM, WalletButton, WalletCard, WalletDisplay, type WalletInfo, type WalletKeysErrorMessage, type WalletKeysUpdateMessage, avaCloudWallet, useAuth, useAvaCloudWallet, useBlockchain, useChainId, useGaslessConfig, useGaslessTransaction, useGlacier, usePostMessage, useSignMessage, useSignTransaction, useThemeMode, useTransferTokens, useUserWallets };