@bluxcc/core 0.3.1 → 0.3.3

package/dist/pages/Onboarding/Passkey/index.d.ts

@@ -1,9 +1,2 @@
-export type PasskeyFlowResult = {
-    step: 'login';
-    credential: PublicKeyCredential;
-} | {
-    step: 'register';
-    credential: PublicKeyCredential;
-};
 declare const PasskeyOnboardingPage: () => import("react/jsx-runtime").JSX.Element;
 export default PasskeyOnboardingPage;

package/dist/pages/Onboarding/Socials/OtherSocials.d.ts

@@ -0,0 +1,2 @@
+declare const OtherSocials: () => import("react/jsx-runtime").JSX.Element;
+export default OtherSocials;

package/dist/pages/Onboarding/Socials/SocialLoginButton.d.ts

@@ -0,0 +1,7 @@
+type SocialLoginButtonProps = {
+    provider: string;
+    onClick: (provider: string) => void;
+    nameOnly?: boolean;
+};
+declare const SocialLoginButton: ({ provider, onClick, nameOnly, }: SocialLoginButtonProps) => import("react/jsx-runtime").JSX.Element;
+export default SocialLoginButton;

package/dist/pages/Onboarding/Socials/TelegramWidget.d.ts

@@ -0,0 +1,6 @@
+type TelegramWidgetProps = {
+    botUsername: string;
+    onAuth: (user: Record<string, unknown>) => void;
+};
+declare const TelegramWidget: ({ botUsername, onAuth }: TelegramWidgetProps) => import("react/jsx-runtime").JSX.Element;
+export default TelegramWidget;

package/dist/stellar/processes/connectWalletProcess.d.ts

@@ -1,4 +1,12 @@
 import { IWallet } from '../../types';
-import { IStore } from '../../store';
-declare const connectWalletProcess: (store: IStore, wallet: IWallet) => Promise<void>;
+import { IStore, IUser } from '../../store';
+export type ConnectWalletProcessOptions = {
+    /**
+     * Skip Blux waiting/success/failed screens and persist the session as soon
+     * as the wallet returns a signed challenge. Wallet extension / hardware
+     * prompts still appear.
+     */
+    headless?: boolean;
+};
+declare const connectWalletProcess: (store: IStore, wallet: IWallet, options?: ConnectWalletProcessOptions) => Promise<IUser | void>;
 export default connectWalletProcess;

package/dist/stellar/processes/hydrateUserFromJwt.d.ts

@@ -0,0 +1,8 @@
+import { IUser } from '../../store';
+/**
+ * Loads the user for a freshly issued session JWT and writes them into the
+ * store without persisting the session. Callers then either show the terms /
+ * success UI ({@link continueLoginProcess}) or persist immediately
+ * ({@link completeLoginProcess}) for headless / whitelabel logins.
+ */
+export declare const hydrateUserFromJwt: (jwt: string, authMethod: string, authValue?: string) => Promise<IUser>;

package/dist/store.d.ts

@@ -67,6 +67,11 @@ export interface IStoreProperties {
         };
     };
     showAllWallets: boolean;
+    /**
+     * When true, onboarding shows only the scrollable wallet list (no email /
+     * SMS / social / passkey). Set by loginWallet() with no wallet name.
+     */
+    walletOnlyOnboarding: boolean;
     waitingStatus: WaitingStatus;
     wallets: IWallet[];
     stellar?: IStellarConfig;
@@ -98,10 +103,13 @@ export interface IStoreMethods {
     connectWalletSuccessful: (publicKey: string, passphrase: string) => void;
     closeModal: () => void;
     logoutAction: () => void;
-    openModal: (route: Route) => void;
+    openModal: (route: Route, options?: {
+        walletOnly?: boolean;
+    }) => void;
     setConfig: (config: IInternalConfig) => void;
     setIsReady: (isReady: boolean) => void;
     setShowAllWallets: (showAllWallets: boolean) => void;
+    setWalletOnlyOnboarding: (walletOnlyOnboarding: boolean) => void;
     setRoute: (route: Route) => void;
     setSendTransaction: (sendTransaction: ISendTransaction, isOpen: boolean, route?: Route) => void;
     setSignMessage: (messageDetails: ISignMessage, isOpen: boolean, route?: Route) => void;

package/dist/types.d.ts

@@ -10,7 +10,7 @@ type LooseString = string & {};
 /** Block explorer used to build account/transaction links. */
 export type IExplorer = 'steexp' | 'stellarchain' | 'stellarexpert' | 'lumenscan';
 /** Social login providers supported by Blux. */
-export type ISocialProvider = 'google';
+export type ISocialProvider = 'google' | 'apple' | 'discord' | 'telegram' | 'meta' | 'github' | 'farcaster' | 'tiktok' | 'linkedin' | 'twitch' | 'kick' | 'spotify' | 'instagram' | 'microsoft' | 'gitlab' | 'twitter' | 'steam';
 /** Login methods to offer in the modal. */
 export type ILoginMethods = Array<'wallet' | 'sms' | 'email' | 'passkey' | ISocialProvider>;
 /** Canonical names of the wallets Blux can integrate with. */
@@ -58,7 +58,13 @@ export interface IConfig {
     explorer?: IExplorer;
     /** Persist the session across page reloads. Defaults to `false` and should remain `false` in most scenarios. */
     isPersistent?: boolean;
-    /** Show Blux's built-in signing/approval UIs. When `false`, signing happens headlessly. Defaults to `true`. */
+    /**
+     * Show Blux's built-in signing/approval UIs. When `false`, signing happens
+     * headlessly so you can render your own confirmation UI. Login is independent:
+     * `login()` still opens the Blux modal, while `loginEmail` / `loginSms` /
+     * `loginOAuth` / `loginPasskey` / `loginWallet(name)` never do (WalletConnect
+     * still uses the Blux QR). Defaults to `true`.
+     */
     showWalletUIs?: boolean;
     /** Login methods to offer. Defaults to `['wallet']`. `'sms'` is shown only when `/auth/validate` reports a paid plan. */
     loginMethods?: Array<ILoginMethods[number] | LooseString>;
@@ -259,6 +265,12 @@ export interface ISignAuthEntry {
 export interface ISocialConfigEntry {
     provider: string;
     displayName: string;
+    /** Login mechanism from /auth/validate: oauth2, steam, farcaster, or telegram. */
+    kind?: string;
+    /** Telegram bot username the on-page widget needs; empty for other providers. */
+    publicId?: string;
+    /** Telegram Mini App / in-app login is enabled for this project. */
+    miniApps?: boolean;
 }
 export interface AuthenticateApiResponse {
     isValid: boolean;

package/dist/utils/api.d.ts

@@ -1,6 +1,6 @@
 import { IUser } from '../store';
 import { AuthenticateApiResponse, WalletProofType } from '../types';
-import { PasskeyFlowResult } from '../pages/Onboarding/Passkey';
+import type { PasskeyFlowResult } from './passkey';
 type ApiPasskeyChallenge = {
     user_id: string;
     challenge: string;
@@ -48,4 +48,5 @@ export type ApiGroupedTokens = {
 export declare const apiGetTokens: (JWT: string) => Promise<ApiGroupedTokens>;
 export declare const apiAddToken: (JWT: string, contractAddress: string, network: "mainnet" | "testnet") => Promise<ApiTokenView>;
 export declare const apiDeleteToken: (JWT: string, tokenId: number) => Promise<boolean>;
+export declare const apiTelegramLogin: (appId: string, payload: Record<string, unknown>) => Promise<string>;
 export {};

package/dist/utils/passkey.d.ts

@@ -0,0 +1,14 @@
+export type PasskeyFlowResult = {
+    step: 'login';
+    credential: PublicKeyCredential;
+} | {
+    step: 'register';
+    credential: PublicKeyCredential;
+};
+export declare function ensurePasskeySupport(): Promise<void>;
+export declare function runPasskeyCeremony(challenge: string, userId: string, mode: 'login' | 'register', credentialId?: string): Promise<PasskeyFlowResult>;
+/**
+ * Runs the full passkey register-or-login ceremony and returns a session JWT.
+ * Does not persist the session; the caller hydrates the user and completes login.
+ */
+export declare function authenticateWithPasskey(appId: string): Promise<string>;

package/dist/utils/socialLogin.d.ts

@@ -1,12 +1,21 @@
+import type { ComponentType } from 'react';
 import CDNFiles from '../constants/cdnFiles';
 import { ILoginMethods, AuthenticateApiResponse } from '../types';
 type SocialProviderMeta = {
     displayName: string;
-    icon: CDNFiles;
+    icon: CDNFiles | ComponentType<{
+        fill?: string;
+    }>;
 };
 export declare const SOCIAL_PROVIDERS: Record<string, SocialProviderMeta>;
+export declare const canonicalSocialName: (method: string) => string;
 export declare const isSocialProvider: (method: string) => boolean;
+export declare const getSocialDisplayName: (provider: string) => string;
 export declare const getEnabledSocials: (loginMethods: ILoginMethods | string[], apiResponse?: AuthenticateApiResponse) => string[];
+export declare const telegramBotUsername: (apiResponse?: AuthenticateApiResponse) => string;
+export declare const telegramMiniAppsEnabled: (apiResponse?: AuthenticateApiResponse) => boolean;
+export declare const telegramWebAppInitData: () => string;
+export declare const isTelegramLogin: (provider: string, apiResponse?: AuthenticateApiResponse) => boolean;
 export type ISocialSession = {
     provider: string;
     popup: Window | null;
@@ -15,5 +24,6 @@ export type ISocialSession = {
 export declare const getActiveSocialSession: () => ISocialSession | null;
 export declare const cancelActiveSocialSession: () => void;
 export declare const beginSocialLogin: (provider: string, appId: string) => ISocialSession;
+export declare const startSocialLogin: (provider: string, appId: string, apiResponse?: AuthenticateApiResponse) => void;
 export declare const awaitSocialLogin: (session: ISocialSession) => Promise<string>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluxcc/core",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "homepage": "https://blux.cc",
   "description": "Blux is a wallet infra for the Stellar network",
   "type": "module",