@bluxcc/core 0.3.2 → 0.3.3

package/dist/constants/assets.d.ts

@@ -23,4 +23,13 @@ export declare const MAINNET_EURC: {
     assetBalance: string;
     assetType: string;
 };
-export declare const getSuggestedAssets: (networkPassphrase: string) => IAsset[];
+export declare const isPublicNetwork: (network: string) => boolean;
+export declare const isTestnetNetwork: (network: string) => boolean;
+/** Circle USDC for the active network. Testnet uses Circle's test issuer. */
+export declare const usdcForNetwork: (network: string) => IAsset;
+/**
+ * Curated logos are pubnet-only. Map a well-known testnet (or same-network)
+ * issuer to the pubnet issuer whose icon we should reuse.
+ */
+export declare const pubnetLogoIssuer: (assetCode: string, assetIssuer: string) => string | undefined;
+export declare const getSuggestedAssets: (network: string) => IAsset[];

package/dist/exports/blux.d.ts

@@ -1,18 +1,7 @@
-import { IUser } from '../store';
-/**
- * Internal login driver. Prefer the public {@link login}.
- *
- * @param isSilent - When `true`, tries to restore a recent session without opening the modal.
- * @returns A promise that resolves to the authenticated user.
- */
-export declare const _login: (isSilent: boolean) => Promise<IUser>;
-/**
- * Opens the Blux modal so the user can connect a wallet or sign in, resolving
- * once authenticated. Waits for the SDK to finish initializing first.
- *
- * @returns The authenticated user.
- */
-export declare const login: () => Promise<IUser>;
+import { loginWallet } from './loginMethods';
+export { _login } from './loginMethods';
+export { login, loginEmail, loginOAuth, loginPasskey, loginSms, loginWallet, } from './loginMethods';
+export type { LoginCodeApi, LoginCodeFn, LoginOAuthOptions, } from './loginMethods';
 /**
  * Signs a transaction XDR with the connected wallet, without submitting it.
  *
@@ -59,7 +48,12 @@ export declare const signAuthEntry: (authEntry: string, options?: {
  * Each method carries its own documentation; the getters expose live auth state.
  */
 export declare const blux: {
-    login: () => Promise<IUser>;
+    login: () => Promise<import("../store").IUser>;
+    loginEmail: import("./loginMethods").LoginCodeFn;
+    loginSms: import("./loginMethods").LoginCodeFn;
+    loginOAuth: (provider: import("../types").ISocialProvider | string, options?: import("./loginMethods").LoginOAuthOptions) => Promise<import("../store").IUser>;
+    loginPasskey: () => Promise<import("../store").IUser>;
+    loginWallet: typeof loginWallet;
     logout: () => void;
     fundMe: () => void;
     profile: () => void;
@@ -79,5 +73,5 @@ export declare const blux: {
     /** Whether a user is currently authenticated. */
     readonly isAuthenticated: boolean;
     /** The currently authenticated user, or `undefined` when logged out. */
-    readonly user: IUser | undefined;
+    readonly user: import("../store").IUser | undefined;
 };

package/dist/exports/exportedStore.d.ts

@@ -8,6 +8,10 @@ export interface IExportedStore {
         isAuthenticated: boolean;
     };
     stellar?: IStellarConfig;
+    /** Installed wallets currently offered in the picker. */
+    wallets: Array<{
+        name: string;
+    }>;
 }
 export declare const exportedStore: import("zustand").StoreApi<IExportedStore>;
 export declare const syncExportedStore: (mainStore: typeof store) => () => void;

package/dist/exports/index.d.ts

@@ -2,11 +2,12 @@ import { BluxEventMap, ReadOnlyEmitter } from '../utils/events';
 export type { IAppearance, IConfig, IExplorer, ILoginMethods, IServers, ISocialProvider, ITrezorMetaData, ITransports, IWalletConnectMetaData, IWalletNames, LanguageKey, } from '../types';
 export type { IUser } from '../store';
 export type { IExportedStore } from './exportedStore';
+export type { LoginCodeApi, LoginCodeFn, LoginOAuthOptions } from './blux';
 export { Asset } from '@stellar/stellar-sdk';
 export * as StellarSdk from '@stellar/stellar-sdk';
 export * from './core';
 export * as core from './core';
-export { blux } from './blux';
+export { blux, loginEmail, loginSms, loginOAuth, loginPasskey, loginWallet, } from './blux';
 export { BluxEvent } from '../utils/events';
 export { getState, subscribe, getInitialState, useExportedStore, } from './exportedStore';
 export declare const setAppearance: (newAppearance: Partial<import("../types").IAppearance>) => void;

package/dist/exports/loginMethods.d.ts

@@ -0,0 +1,93 @@
+import { ISocialProvider } from '../types';
+import { IUser } from '../store';
+/** sendCode + loginWithCode pair returned by {@link loginEmail} / {@link loginSms}. */
+export type LoginCodeApi = {
+    /** Send a one-time code to the identifier (email address or phone number). */
+    sendCode: (identifier: string) => Promise<void>;
+    /**
+     * Verify the one-time code and complete login.
+     *
+     * @returns The authenticated user.
+     */
+    loginWithCode: (identifier: string, code: string) => Promise<IUser>;
+};
+/** {@link loginEmail} / {@link loginSms}: call it for the hook-shaped pair, or use the methods directly. */
+export type LoginCodeFn = (() => LoginCodeApi) & LoginCodeApi;
+/**
+ * Internal login driver. Prefer the public {@link login}.
+ *
+ * @param isSilent - When `true`, tries to restore a recent session without opening the modal.
+ * @returns A promise that resolves to the authenticated user.
+ */
+export declare const _login: (isSilent: boolean) => Promise<IUser>;
+/**
+ * Opens the Blux modal so the user can connect a wallet or sign in, resolving
+ * once authenticated. Waits for the SDK to finish initializing first.
+ *
+ * @returns The authenticated user.
+ */
+export declare const login: () => Promise<IUser>;
+/**
+ * Headless email login. Mirrors Privy's `sendCode` + `loginWithCode` so a React
+ * hook can wrap this directly:
+ *
+ * ```ts
+ * const { sendCode, loginWithCode } = blux.loginEmail();
+ * await sendCode('user@example.com');
+ * const user = await loginWithCode('user@example.com', '123456');
+ * ```
+ *
+ * `blux.loginEmail.sendCode(...)` works the same way without calling the function.
+ * Does not open the Blux modal; render your own email / OTP UI.
+ */
+export declare const loginEmail: LoginCodeFn;
+/**
+ * Headless SMS login. Same shape as {@link loginEmail}:
+ *
+ * ```ts
+ * const { sendCode, loginWithCode } = blux.loginSms();
+ * await sendCode('+15555555555');
+ * const user = await loginWithCode('+15555555555', '123456');
+ * ```
+ *
+ * Does not open the Blux modal. SMS must be in `loginMethods` and the app must
+ * be on a paid plan (`smsEnabled` from `/auth/validate`).
+ */
+export declare const loginSms: LoginCodeFn;
+export type LoginOAuthOptions = {
+    /**
+     * Telegram Login Widget user object, or `{ init_data }` from a Telegram Mini
+     * App. Required for Telegram unless Mini App init data is already on `window`.
+     */
+    telegramUser?: Record<string, unknown>;
+};
+/**
+ * Headless social login. Opens the provider popup (must run from a click
+ * handler so the browser does not block it) and resolves with the user.
+ *
+ * Telegram cannot use that popup (the bot is bound to this origin). Pass the
+ * widget payload as `options.telegramUser`, or call this from a Mini App where
+ * init data is present. To show Blux's Telegram widget instead, use {@link login}.
+ *
+ * @param provider - A social name from {@link ISocialProvider} (`'google'`, `'apple'`, ...).
+ * @param options - Telegram-only extras.
+ */
+export declare const loginOAuth: (provider: ISocialProvider | string, options?: LoginOAuthOptions) => Promise<IUser>;
+/**
+ * Headless passkey login. Triggers the WebAuthn ceremony (register on first
+ * visit, assert on later visits) and resolves with the user. Must run from a
+ * user gesture. Does not open the Blux modal.
+ */
+export declare const loginPasskey: () => Promise<IUser>;
+/**
+ * Wallet login.
+ *
+ * - No argument: opens the Blux onboarding modal showing only the scrollable
+ *   wallet list (email / SMS / social / passkey rows are hidden).
+ * - With a wallet name (`'freighter'`, `'rabet'`, ...): opens that wallet's
+ *   own prompt and never the Blux modal. WalletConnect is the exception and
+ *   still uses the Blux QR screen.
+ *
+ * @returns The authenticated user.
+ */
+export declare function loginWallet(walletName?: string): Promise<IUser>;