@bluxcc/core 0.3.0 → 0.3.2

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/getTransactionDetails.d.ts

@@ -1,5 +1,5 @@
 declare const getTransactionDetails: (xdr: string, network: string) => {
-    action: "accountMerge" | "allowTrust" | "beginSponsoringFutureReserves" | "bumpSequence" | "changeTrust" | "claimClaimableBalance" | "clawbackClaimableBalance" | "clawback" | "createAccount" | "createClaimableBalance" | "createPassiveSellOffer" | "endSponsoringFutureReserves" | "extendFootprintTtl" | "inflation" | "invokeHostFunction" | "liquidityPoolDeposit" | "liquidityPoolWithdraw" | "manageBuyOffer" | "manageData" | "manageSellOffer" | "pathPaymentStrictReceive" | "pathPaymentStrictSend" | "payment" | "restoreFootprint" | "revokeAccountSponsorship" | "revokeClaimableBalanceSponsorship" | "revokeDataSponsorship" | "revokeLiquidityPoolSponsorship" | "revokeOfferSponsorship" | "revokeSignerSponsorship" | "revokeTrustlineSponsorship" | "setOptions" | "setTrustLineFlags";
+    action: "pathPaymentStrictSend" | "pathPaymentStrictReceive" | "payment" | "createAccount" | "createClaimableBalance" | "accountMerge" | "allowTrust" | "beginSponsoringFutureReserves" | "bumpSequence" | "changeTrust" | "claimClaimableBalance" | "clawbackClaimableBalance" | "clawback" | "createPassiveSellOffer" | "endSponsoringFutureReserves" | "extendFootprintTtl" | "inflation" | "invokeHostFunction" | "liquidityPoolDeposit" | "liquidityPoolWithdraw" | "manageBuyOffer" | "manageData" | "manageSellOffer" | "restoreFootprint" | "revokeAccountSponsorship" | "revokeClaimableBalanceSponsorship" | "revokeDataSponsorship" | "revokeLiquidityPoolSponsorship" | "revokeOfferSponsorship" | "revokeSignerSponsorship" | "revokeTrustlineSponsorship" | "setOptions" | "setTrustLineFlags";
     operations: number;
     sender: string;
     receiver: string;

package/dist/stellar/moneygram.d.ts

@@ -0,0 +1,26 @@
+import { Horizon } from '@stellar/stellar-sdk';
+import { IAsset } from '../types';
+export type MoneygramMemoType = 'text' | 'id' | 'hash';
+export type MoneygramSession = {
+    url: string;
+    id: string;
+    token: string;
+    transferServer: string;
+};
+export type MoneygramWithdrawDetails = {
+    amount: string;
+    destination: string;
+    memo: string;
+    memoType: MoneygramMemoType;
+};
+export declare const isMoneygramNetwork: (network: string) => boolean;
+export declare const moneygramUsdc: (network: string) => IAsset;
+export declare const startMoneygramWithdraw: ({ address, network, lang, sign, signal, }: {
+    address: string;
+    network: string;
+    lang?: string;
+    sign: (xdr: string) => Promise<string>;
+    signal?: AbortSignal;
+}) => Promise<MoneygramSession>;
+export declare const waitForMoneygramTransfer: (session: MoneygramSession, signal?: AbortSignal) => Promise<MoneygramWithdrawDetails>;
+export declare const assertHorizon: (horizon?: Horizon.Server) => Horizon.Server;

package/dist/stellar/paymentTransaction.d.ts

@@ -1,4 +1,4 @@
-import { Horizon } from "@stellar/stellar-sdk";
-import { IAsset } from "../types";
-declare const paymentTransaction: (memo: string, amount: string, destinationAddress: string, asset: IAsset, sourceAddress: string, server: Horizon.Server, networkPassphrase: string) => Promise<string>;
+import { Horizon } from '@stellar/stellar-sdk';
+import { IAsset } from '../types';
+declare const paymentTransaction: (memo: string, amount: string, destinationAddress: string, asset: IAsset, sourceAddress: string, server: Horizon.Server, networkPassphrase: string, memoType?: "text" | "id" | "hash") => Promise<string>;
 export default paymentTransaction;

package/dist/store.d.ts

@@ -1,8 +1,7 @@
 import { Horizon, rpc } from '@stellar/stellar-sdk';
 import { SignClient } from '@walletconnect/sign-client/dist/types/client';
 import { Route } from './enums';
-import { UseBalancesResult } from './hooks/useBalances';
-import { UseTransactionsResult } from './hooks/useTransactions';
+import type { UseBalancesResult } from './hooks/useBalances';
 import Emitter, { BluxEventMap } from './utils/events';
 import { IAsset, IWallet, IAppearance, AssetMetaMap, ICustomToken, ICustomTokens, ISignMessage, IInternalConfig, ISendTransaction, AuthenticateApiResponse, ISignAuthEntry } from './types';
 export type AlertType = 'error' | 'success' | 'warn' | 'none' | 'copy';
@@ -78,7 +77,7 @@ export interface IStoreProperties {
     loginError?: string;
     balances: UseBalancesResult;
     balanceValues: Record<string, string>;
-    transactions: UseTransactionsResult;
+    accountRefreshNonce: number;
     selectAsset: ISelectAsset;
     detailsAsset?: IAsset;
     customTokens: ICustomTokens;
@@ -93,6 +92,7 @@ export interface IStoreProperties {
 }
 export interface IStoreMethods {
     connectEmail: (email: string) => void;
+    connectSms: (phone: string) => void;
     connectSocial: (provider: string) => void;
     connectWallet: (walletName: string) => void;
     connectWalletSuccessful: (publicKey: string, passphrase: string) => void;
@@ -120,7 +120,7 @@ export interface IStoreMethods {
     setCustomTokenBalances: (network: 'mainnet' | 'testnet', balances: Record<number, string>) => void;
     setBalancesTab: (tab: 'assets' | 'tokens') => void;
     setDetailsToken: (token: ICustomToken | undefined) => void;
-    setTransactions: (transactions: UseTransactionsResult) => void;
+    bumpAccountRefresh: () => void;
     setWalletConnectClient: (client: SignClient, connection: any) => void;
     cleanUp: (method: 'sendTransaction' | 'signMessage' | 'signAuthEntry') => void;
     setNetworkSyncDisabled: (isDisabled: boolean) => 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. */
@@ -42,7 +42,7 @@ export interface ITrezorMetaData {
 }
 /** Configuration passed to {@link createConfig}. */
 export interface IConfig {
-    /** Your Blux app id, from the Blux dashboard. Required for email/passkey/social login. */
+    /** Your Blux app id, from the Blux dashboard. Required for email/SMS/passkey/social login. */
     appId: string;
     /** Display name of your app, shown in wallet prompts and UI. */
     appName: string;
@@ -56,11 +56,11 @@ export interface IConfig {
     lang?: LanguageKey;
     /** Block explorer used for links. Defaults to `'stellarchain'`. */
     explorer?: IExplorer;
-    /** Persist the session across reloads. Defaults to `false`. */
+    /** 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`. */
     showWalletUIs?: boolean;
-    /** Login methods to offer. Defaults to `['wallet']`. */
+    /** Login methods to offer. Defaults to `['wallet']`. `'sms'` is shown only when `/auth/validate` reports a paid plan. */
     loginMethods?: Array<ILoginMethods[number] | LooseString>;
     /** Custom Horizon/Soroban endpoints per network; required for custom networks. */
     transports?: ITransports;
@@ -259,6 +259,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;
@@ -267,5 +273,9 @@ export interface AuthenticateApiResponse {
     terms: string;
     socials: string[];
     socialsConfig: ISocialConfigEntry[];
+    /** Entitled billing plan of the account that owns this app. */
+    plan: string;
+    /** True when the account is on a paid plan and may offer SMS login. */
+    smsEnabled: boolean;
 }
 export {};

package/dist/utils/api.d.ts

@@ -9,7 +9,7 @@ type ApiPasskeyChallenge = {
 export declare const authenticateAppId: (appId: string) => Promise<AuthenticateApiResponse>;
 export declare const apiPasskeyChallenge: (appId: string, authValue: string) => Promise<ApiPasskeyChallenge>;
 export declare const apiPasskeyVerify: (appId: string, challenge: ApiPasskeyChallenge, passkeyResult: PasskeyFlowResult) => Promise<string>;
-export declare const apiSendOtp: (appId: string, authValue: string) => Promise<boolean>;
+export declare const apiSendOtp: (appId: string, authValue: string, authMethod?: "email" | "sms") => Promise<boolean>;
 type ApiWalletChallenge = {
     challenge_xdr?: 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/helpers.d.ts

@@ -2,7 +2,6 @@ import { Asset, Horizon } from '@stellar/stellar-sdk';
 import translations from '../constants/locales';
 import { Route, SupportedWallet } from '../enums';
 import { IAsset, IWallet, IExplorer, LanguageKey, ITransports, IWalletNames, ILoginMethods } from '../types';
-import { INetworkTransports } from '../constants/networkDetails';
 export declare const bufferToBase64Url: (buf: ArrayBuffer) => string;
 export declare const base64UrlToBuffer: (value: string) => ArrayBuffer;
 export declare const getAssetTitle: (asset: Horizon.HorizonApi.BalanceLineNative | Horizon.HorizonApi.BalanceLineAsset<"credit_alphanum4"> | Horizon.HorizonApi.BalanceLineAsset<"credit_alphanum12"> | Horizon.HorizonApi.BalanceLineLiquidityPool) => string;
@@ -34,7 +33,7 @@ export declare const getExplorerUrl: (networkPassphrase: string, explorerProvide
 export declare const getMappedWallets: (walletNames: IWalletNames) => Promise<IWallet[]>;
 export declare const getRecentConnectionMethod: () => SupportedWallet[];
 export declare const getNetworkByPassphrase: (passphrase: string) => string;
-export declare const getNetworkRpc: (network: string, transports: ITransports) => INetworkTransports;
+export { getNetworkRpc } from './networkRpc';
 export declare const canonicalWalletName: (name: string) => string;
 export declare const loginMethodsIncludeWallet: (loginMethods: ILoginMethods | string[] | undefined) => boolean;
 export declare const getSortedCheckedWallets: (wallets: IWallet[], priorityNames?: string[]) => IWallet[];
@@ -55,3 +54,4 @@ export declare const getNetworkNamesFromPassphrase: (userNetworks: string[]) =>
 export declare const validateOrderWallets: (orderWallets: string[] | undefined) => string[];
 export declare const validateNetworkOptions: (networks: string[], defaultNetwork: string | undefined, transports: ITransports | undefined) => void;
 export declare const validateInput: (type: string, value: string) => boolean;
+export declare const isUSCanadaPhone: (raw: string) => boolean;

package/dist/utils/networkRpc.d.ts

@@ -0,0 +1,7 @@
+import { ITransports } from '../types';
+import { INetworkTransports } from '../constants/networkDetails';
+/**
+ * Resolves Horizon and Soroban URLs for a passphrase, overlaying any custom
+ * transports from config.
+ */
+export declare const getNetworkRpc: (network: string, transports: ITransports) => INetworkTransports;

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.0",
+  "version": "0.3.2",
   "homepage": "https://blux.cc",
   "description": "Blux is a wallet infra for the Stellar network",
   "type": "module",