@getpara/core-sdk 2.12.0 → 2.13.0

package/dist/types/PlatformUtils.d.ts

@@ -1,6 +1,12 @@
 import { BackupKitEmailProps, TPregenIdentifierType, TWalletType, SDKType } from '@getpara/user-management-client';
 import { Ctx, PopupType, SignatureRes } from './types/index.js';
 import { StorageUtils } from './StorageUtils.js';
+export type EventType = 'TELEGRAM_LOGIN' | 'TELEGRAM_SUCCESS' | 'TELEGRAM_FAILED' | 'FARCASTER_LOGIN' | 'FARCASTER_SUCCESS' | 'FARCASTER_FAILED' | string;
+export interface EventData<T = any> {
+    type: EventType;
+    payload?: T;
+}
+export type EventHandler<T = any> = (data: T) => void;
 export interface PlatformUtils {
     sdkType: SDKType;
     getPrivateKey(ctx: Ctx, userId: string, walletId: string, share: string, sessionCookie: string): Promise<string>;
@@ -44,4 +50,21 @@ export interface PlatformUtils {
         type: PopupType;
     }): Promise<Window>;
     initializeWorker(ctx: Ctx): Promise<void>;
+    addEventListener<T = EventData>(_: {
+        ctx: Ctx;
+        event: string;
+        handler: EventHandler<T>;
+    }): void;
+    removeEventListener<T = EventData>(_: {
+        event: string;
+        handler: EventHandler<T>;
+    }): void;
+    postMessage?(_: {
+        data: EventData;
+        target?: string;
+    }): void;
+    emitEvent?<T = EventData>(_: {
+        event: string;
+        data: T;
+    }): void;
 }

package/dist/types/constants.d.ts

@@ -18,6 +18,7 @@ export declare const LOCAL_STORAGE_ENCLAVE_JWT = "@CAPSULE/enclaveJwt";
 export declare const LOCAL_STORAGE_ENCLAVE_REFRESH_JWT = "@CAPSULE/enclaveRefreshJwt";
 export declare const LOCAL_STORAGE_IS_ENCLAVE_USER = "@CAPSULE/isEnclaveUser";
 export declare const SESSION_STORAGE_LOGIN_ENCRYPTION_KEY_PAIR = "@CAPSULE/loginEncryptionKeyPair";
+export declare const LOCAL_STORAGE_IS_IMPORTED_SESSION = "@CAPSULE/isImportedSession";
 export declare const POLLING_INTERVAL_MS = 1000;
 export declare const SHORT_POLLING_INTERVAL_MS = 750;
 export declare const POLLING_TIMEOUT_MS = 300000;

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 import { ParaCore } from './ParaCore.js';
 export { type Auth, type AuthInfo, type PrimaryAuthInfo, type VerifiedAuthInfo, type VerifiedAuth, AuthMethod, type TAuthMethod, AuthMethodStatus, type AuthExtras, type CurrentWalletIds, EmailTheme, type PartnerEntity, type WalletEntity, Network, type TNetwork, WalletType, type TWalletType, WalletScheme, type TWalletScheme, OnRampAsset, type TOnRampAsset, OnRampPurchaseType, OnRampProvider, OnRampPurchaseStatus, type OnRampConfig, type OnRampAssets, type OnRampPurchase, type OnRampAssetInfo, type ProviderAssetInfo, OnRampMethod, type Theme, OAuthMethod, type TOAuthMethod, type TLinkedAccountType, type SupportedAccountLinks, type SupportedWalletTypes, type TPregenIdentifierType, type PregenIds, type LinkedAccount, type LinkedAccounts, type TExternalWallet, type ExternalWalletInfo, type PregenAuth, type Setup2faResponse, type TelegramAuthResponse, type VerifyExternalWalletParams, type AssetMetadata, type AssetMetadataIndexed, type AssetValue, type BalancesConfig, type WalletBalance, type ProfileBalance, type OfframpDepositRequest, type WalletWithMetadata, RecoveryStatus, ThemeMode, NON_ED25519, PREGEN_IDENTIFIER_TYPES, WALLET_TYPES, WALLET_SCHEMES, OAUTH_METHODS, LINKED_ACCOUNT_TYPES, EXTERNAL_WALLET_TYPES, EVM_WALLETS, SOLANA_WALLETS, COSMOS_WALLETS, formatAssetQuantity, formatCurrency, type EstimateTransactionOpts, type EstimateTransactionResult, type BroadcastTransactionOpts, type BroadcastTransactionResult, } from '@getpara/user-management-client';
-export { PopupType, PregenIdentifierType, type AuthStateSignup, type AuthStateVerify, type AuthStateLogin, type AuthState, type OAuthResponse, type CoreAuthInfo, type SignatureRes, type FullSignatureRes, type SuccessfulSignatureRes, type DeniedSignatureRes, type DeniedSignatureResWithUrl, type Wallet, type AvailableWallet, type GetWalletBalanceParams, type AccountLinkInProgress, AccountLinkError, type InternalInterface, } from './types/index.js';
+export { PopupType, PregenIdentifierType, type AuthStateSignup, type AuthStateVerify, type AuthStateLogin, type AuthState, type OAuthResponse, type CoreAuthInfo, type SignatureRes, type FullSignatureRes, type SuccessfulSignatureRes, type DeniedSignatureRes, type DeniedSignatureResWithUrl, type Wallet, type AvailableWallet, type AccountLinkInProgress, AccountLinkError, type InternalInterface, type Verify2faParams, type Verify2faResponse, type StorageType, type TelegramParams, } from './types/index.js';
 export * from './types/coreApi.js';
 export * from './types/events.js';
 export * from './types/config.js';
@@ -8,7 +8,7 @@ export { getPortalDomain, dispatchEvent, entityToWallet, constructUrl, shortenUr
 export { PREFIX as STORAGE_PREFIX, PARA_PREFIX as PARA_STORAGE_PREFIX, LOCAL_STORAGE_CURRENT_WALLET_IDS, LOCAL_STORAGE_WALLETS, } from './constants.js';
 export { distributeNewShare } from './shares/shareDistribution.js';
 export { KeyContainer } from './shares/KeyContainer.js';
-export type { PlatformUtils } from './PlatformUtils.js';
+export type { PlatformUtils, EventData, EventHandler, EventType } from './PlatformUtils.js';
 export type { StorageUtils } from './StorageUtils.js';
 export { getBaseUrl, initClient } from './external/userManagementClient.js';
 export * as mpcComputationClient from './external/mpcComputationClient.js';
@@ -24,5 +24,7 @@ export { getNetworkPrefix, getOnRampAssets, getOnRampNetworks, toAssetInfoArray
 export { getPortalBaseURL } from './utils/url.js';
 export { retrieve as transmissionUtilsRetrieve } from './transmission/transmissionUtils.js';
 export type { ShareData } from './shares/enclave.js';
+export type { StateSnapshot, AuthStateInfo } from './state/types/core';
+export type * from './services/types';
 export declare const paraVersion: string;
 export default ParaCore;

package/dist/types/services/AuthService.d.ts

@@ -0,0 +1,72 @@
+import { CoreAuthInfo } from '../types/index.js';
+import { ParaCore } from '../ParaCore.js';
+import { CoreStateManager } from '../state/CoreStateManager.js';
+import { PortalUrlService } from './PortalUrlService.js';
+import { ExternalWalletService } from './ExternalWalletService.js';
+import { SessionManagementService } from './SessionManagementService.js';
+import { PregenWalletService } from './PregenWalletService.js';
+import { WalletService } from './WalletService.js';
+import type { WaitForLoginMethod } from './types/LoginFlowServiceTypes';
+import type { WaitForSignupMethod, WaitForWalletCreationMethod } from './types/SignupFlowServiceTypes';
+import { PerformVerifyExternalWalletMethod, PerformVerifyFarcasterMethod, PerformVerifyNewAccountMethod, PerformVerifyTelegramMethod, RetryVerifyExternalWalletMethod, VerifyExternalWalletMethod, VerifyFarcasterMethod, VerifyNewAccountMethod, VerifyTelegramMethod } from './types/VerificationFlowServiceTypes.js';
+import type { AddCredentialMethod, AssertIsAuthSetMethod, AssertUserIdMethod, AuthenticateWithEmailOrPhoneMethod, AuthenticateWithOAuthMethod, ConnectExternalWalletMethod, GetNewCredentialAndUrlMethod, LoginExternalWalletMethod, PerformLoginExternalWalletMethod, PerformSignUpOrLogInMethod, PrepareAuthStateMethod, PrepareLoginStateMethod, ResendVerificationCodeMethod, SetAuthMethod, SignExternalWalletVerificationMethod, SignUpOrLogInMethod, SupportedUserAuthMethodsMethod, VerifyOAuthProcessMethod } from './types/AuthServiceTypes.js';
+export declare class AuthService {
+    #private;
+    userId?: string;
+    get isEnclaveUser(): boolean;
+    set isEnclaveUser(value: boolean);
+    get email(): string | undefined;
+    get phone(): `+${number}` | undefined;
+    get farcasterUsername(): string | undefined;
+    get telegramUserId(): string | undefined;
+    get isEmail(): boolean;
+    get isPhone(): boolean;
+    get isFarcaster(): boolean;
+    get isTelegram(): boolean;
+    get isExternalWalletAuth(): boolean;
+    get isExternalWalletWithVerification(): boolean;
+    get authInfo(): CoreAuthInfo | undefined;
+    set authInfo(authInfo: CoreAuthInfo | undefined);
+    constructor(paraCore: ParaCore);
+    init: ({ stateManager, portalUrlService, externalWalletService, sessionManagementService, pregenWalletService, walletService, }: {
+        stateManager: CoreStateManager;
+        portalUrlService: PortalUrlService;
+        externalWalletService: ExternalWalletService;
+        sessionManagementService: SessionManagementService;
+        pregenWalletService: PregenWalletService;
+        walletService: WalletService;
+    }) => void;
+    prepareLogin: () => Promise<string>;
+    setAuth: SetAuthMethod;
+    setAuthInfo: (authInfo: CoreAuthInfo) => Promise<void>;
+    setUserId: (userId: string) => Promise<void>;
+    assertIsAuthSet: AssertIsAuthSetMethod;
+    assertUserId: AssertUserIdMethod;
+    prepareAuthState: PrepareAuthStateMethod;
+    prepareLoginState: PrepareLoginStateMethod;
+    performSignUpOrLogIn: PerformSignUpOrLogInMethod;
+    signUpOrLogIn: SignUpOrLogInMethod;
+    authenticateWithEmailOrPhone: AuthenticateWithEmailOrPhoneMethod;
+    performVerifyNewAccount: PerformVerifyNewAccountMethod;
+    verifyNewAccount: VerifyNewAccountMethod;
+    waitForLogin: WaitForLoginMethod;
+    waitForSignup: WaitForSignupMethod;
+    waitForWalletCreation: WaitForWalletCreationMethod;
+    performVerifyExternalWallet: PerformVerifyExternalWalletMethod;
+    verifyExternalWallet: VerifyExternalWalletMethod;
+    retryVerifyExternalWallet: RetryVerifyExternalWalletMethod;
+    performLoginExternalWallet: PerformLoginExternalWalletMethod;
+    loginExternalWallet: LoginExternalWalletMethod;
+    connectExternalWallet: ConnectExternalWalletMethod;
+    signExternalWalletVerification: SignExternalWalletVerificationMethod;
+    verifyOAuthProcess: VerifyOAuthProcessMethod;
+    authenticateWithOAuth: AuthenticateWithOAuthMethod;
+    performVerifyTelegram: PerformVerifyTelegramMethod;
+    verifyTelegram: VerifyTelegramMethod;
+    performVerifyFarcaster: PerformVerifyFarcasterMethod;
+    verifyFarcaster: VerifyFarcasterMethod;
+    supportedUserAuthMethods: SupportedUserAuthMethodsMethod;
+    getNewCredentialAndUrl: GetNewCredentialAndUrlMethod;
+    addCredential: AddCredentialMethod;
+    resendVerificationCode: ResendVerificationCodeMethod;
+}

package/dist/types/services/BaseAuthFlowService.d.ts

@@ -0,0 +1,28 @@
+import { ParaCore } from '../ParaCore.js';
+import { CoreStateManager } from '../state/CoreStateManager.js';
+import { PortalUrlService } from './PortalUrlService.js';
+import { AuthService } from './AuthService.js';
+import { WalletService } from './WalletService.js';
+import { SessionManagementService } from './SessionManagementService.js';
+import { PrepareStateMethod, SetupAuthFromServerStateMethod } from './types/BaseAuthFlowServiceTypes.js';
+import { ExternalWalletService } from './ExternalWalletService.js';
+export declare abstract class BaseAuthFlowService {
+    protected paraCoreInterface: ReturnType<ParaCore['getAuthServiceInterface']>;
+    protected stateManager: CoreStateManager;
+    protected services: {
+        portalUrlService: PortalUrlService;
+        walletService: WalletService;
+        sessionManagementService: SessionManagementService;
+        externalWalletService: ExternalWalletService;
+        authService: AuthService;
+    };
+    constructor(paraCoreInterface: ReturnType<ParaCore['getAuthServiceInterface']>, stateManager: CoreStateManager, services: {
+        portalUrlService: PortalUrlService;
+        walletService: WalletService;
+        sessionManagementService: SessionManagementService;
+        externalWalletService: ExternalWalletService;
+        authService: AuthService;
+    });
+    protected setupAuthFromServerState: SetupAuthFromServerStateMethod;
+    abstract prepareState: PrepareStateMethod;
+}

package/dist/types/services/ExternalWalletService.d.ts

@@ -0,0 +1,44 @@
+import { ParaCore } from '../ParaCore.js';
+import { Wallet } from '../types/wallet.js';
+import { AuthService } from './AuthService.js';
+import { WalletService } from './WalletService.js';
+import { AddExternalWalletsMethod, BaseExternalWalletProviderInterface, ExternalWalletConnectionType, ExternalWallets, InitExternalWalletProviderMethod, PerformConnectExternalWalletMethod, PerformSwitchExternalWalletMethod, SetExternalWalletMethod, SetExternalWalletsMethod, SignMessageMethod, SwitchExternalWalletMethod } from './types/ExternalWalletServiceTypes.js';
+import { TExternalWalletType } from '@getpara/user-management-client';
+import { CoreStateManager } from '../state/CoreStateManager.js';
+export declare class ExternalWalletService {
+    #private;
+    externalWalletProviderInterfaces: {
+        EVM?: BaseExternalWalletProviderInterface;
+        SOLANA?: BaseExternalWalletProviderInterface;
+        COSMOS?: BaseExternalWalletProviderInterface;
+    };
+    get externalWalletWithParaAuth(): Wallet | undefined;
+    get externalWallets(): ExternalWallets;
+    set externalWallets(value: ExternalWallets);
+    get externalWalletConnectionType(): ExternalWalletConnectionType;
+    constructor(paraCore: ParaCore);
+    init: ({ authService, walletService, stateManager, }: {
+        authService: AuthService;
+        walletService: WalletService;
+        stateManager: CoreStateManager;
+    }) => void;
+    initExternalWalletProvider: InitExternalWalletProviderMethod;
+    waitForProvidersLoading: () => Promise<boolean>;
+    assertValidConnection: () => Promise<void>;
+    /**
+     * Function to perform signing a message with an external wallet
+     */
+    signMessage: SignMessageMethod;
+    connectParaConnectors: () => Promise<void>;
+    performSwitchExternalWallet: PerformSwitchExternalWalletMethod;
+    switchExternalWallet: SwitchExternalWalletMethod;
+    /**
+     * Function to perform connecting an external wallet
+     */
+    performConnectExternalWallet: PerformConnectExternalWalletMethod;
+    disconnectExternalWallet: (type: TExternalWalletType) => Promise<void>;
+    disconnectAllExternalWallets: () => Promise<void>;
+    setExternalWallet: SetExternalWalletMethod;
+    setExternalWallets: SetExternalWalletsMethod;
+    addExternalWallets: AddExternalWalletsMethod;
+}

package/dist/types/services/LoginFlowService.d.ts

@@ -0,0 +1,9 @@
+import { ServerAuthStateLogin } from '@getpara/user-management-client';
+import { BaseAuthFlowService } from './BaseAuthFlowService.js';
+import type { PrepareStateMethod } from './types/BaseAuthFlowServiceTypes';
+import type { WaitForLoginMethod } from './types/LoginFlowServiceTypes';
+import type { AuthStateLogin } from '../types';
+export declare class LoginFlowService extends BaseAuthFlowService {
+    prepareState: PrepareStateMethod<ServerAuthStateLogin, AuthStateLogin>;
+    waitForLogin: WaitForLoginMethod;
+}

package/dist/types/services/PollingService.d.ts

@@ -0,0 +1,35 @@
+import { ParaCore } from '../ParaCore.js';
+import { AuthService } from './AuthService.js';
+import { PregenWalletService } from './PregenWalletService.js';
+import { WalletService } from './WalletService.js';
+import { PortalUrlService } from './PortalUrlService.js';
+import { SessionManagementService } from './SessionManagementService.js';
+import { InitOAuthPollingMethod, PollFunction, PollingConfig, PollingResult, WaitForFarcasterEventMethod, WaitForOAuthEventMethod, WaitForOAuthMethod, WaitForPregenWalletAddressMethod, WaitForTelegramEventMethod, WaitForWalletAddressMethod, WaitForWalletsMethod } from './types/PollingServiceTypes.js';
+import { WaitForFarcasterAuthMethod } from '../index.js';
+export declare class PollingService {
+    #private;
+    constructor(paraCore: ParaCore);
+    init: ({ authService, pregenWalletService, walletService, portalUrlService, sessionManagementService, }: {
+        authService: AuthService;
+        pregenWalletService: PregenWalletService;
+        walletService: WalletService;
+        portalUrlService: PortalUrlService;
+        sessionManagementService: SessionManagementService;
+    }) => void;
+    /**
+     * Cancels all active polling operations
+     * Useful for cleanup during logout or app shutdown
+     */
+    cancelAllPolling: () => void;
+    poll: <T>(config: PollingConfig<T>) => Promise<PollingResult<T>>;
+    waitForOAuthEvent: WaitForOAuthEventMethod;
+    waitForTelegramEvent: WaitForTelegramEventMethod;
+    waitForFarcasterEvent: WaitForFarcasterEventMethod;
+    waitForFarcasterAuth: WaitForFarcasterAuthMethod;
+    initOAuthPolling: InitOAuthPollingMethod;
+    waitForOAuth: WaitForOAuthMethod;
+    waitForSession: PollFunction<null>;
+    waitForWallets: WaitForWalletsMethod;
+    waitForWalletAddress: WaitForWalletAddressMethod;
+    waitForPregenWalletAddress: WaitForPregenWalletAddressMethod;
+}

package/dist/types/services/PortalUrlService.d.ts

@@ -0,0 +1,26 @@
+import { ParaCore } from '../ParaCore.js';
+import { AuthService } from './AuthService.js';
+import { PregenWalletService } from './PregenWalletService.js';
+import { WalletService } from './WalletService.js';
+import { SessionManagementService } from './SessionManagementService.js';
+import type { ConstructPortalUrlMethod, GetLoginUrlMethod, GetOAuthUrlMethod } from './types/PortalUrlServiceTypes.js';
+export declare class PortalUrlService {
+    #private;
+    constructor(paraCore: ParaCore);
+    init: ({ authService, pregenWalletService, walletService, sessionManagementService, }: {
+        authService: AuthService;
+        pregenWalletService: PregenWalletService;
+        walletService: WalletService;
+        sessionManagementService: SessionManagementService;
+    }) => void;
+    getPartnerURL: () => Promise<string | undefined>;
+    /**
+     * URL of the portal, which can be associated with a partner id
+     * @param partnerId: string - id of the partner to get the portal URL for
+     * @returns - portal URL
+     */
+    getPortalURL: (isLegacy?: boolean) => Promise<string>;
+    constructPortalUrl: ConstructPortalUrlMethod;
+    getLoginUrl: GetLoginUrlMethod;
+    getOAuthUrl: GetOAuthUrlMethod;
+}

package/dist/types/services/PregenWalletService.d.ts

@@ -0,0 +1,38 @@
+import { CurrentWalletIds, PregenIds, TWalletType } from '@getpara/user-management-client';
+import { ParaCore } from '../ParaCore.js';
+import { Wallet } from '../types/wallet.js';
+import { AuthService } from './AuthService.js';
+import { WalletService } from './WalletService.js';
+import { PollingService } from './PollingService.js';
+import type { ClaimPregenWalletsMethod, CreateGuestWalletsMethod, CreatePregenWalletMethod, CreatePregenWalletPerTypeMethod, FetchPregenWalletsFromOverrideMethod, GetPregenWalletsMethod, HasPregenWalletMethod, PerformClaimPregenWalletsMethod, UpdatePregenWalletIdentifierMethod } from './types/PregenWalletServiceTypes.js';
+import { CoreStateManager } from '../state/CoreStateManager.js';
+export declare class PregenWalletService {
+    #private;
+    /**
+     * A map of pre-generated wallet identifiers that can be claimed in the current instance.
+     */
+    get pregenIds(): PregenIds;
+    get guestWalletIds(): CurrentWalletIds;
+    get guestWalletIdsArray(): [string, TWalletType][];
+    get isGuestMode(): boolean;
+    constructor(paraCore: ParaCore);
+    init: ({ authService, walletService, pollingService, stateManager, }: {
+        authService: AuthService;
+        walletService: WalletService;
+        pollingService: PollingService;
+        stateManager: CoreStateManager;
+    }) => void;
+    isPregenWalletUnclaimed: (wallet: Wallet) => boolean;
+    isPregenWalletClaimable: (wallet: Wallet) => boolean;
+    fetchPregenWalletsFromOverride: FetchPregenWalletsFromOverrideMethod;
+    performClaimPregenWallets: PerformClaimPregenWalletsMethod;
+    claimPregenWallets: ClaimPregenWalletsMethod;
+    getPregenWallets: GetPregenWalletsMethod;
+    private populatePregenWalletAddresses;
+    createPregenWallet: CreatePregenWalletMethod;
+    createPregenWalletPerType: CreatePregenWalletPerTypeMethod;
+    updatePregenWalletIdentifier: UpdatePregenWalletIdentifierMethod;
+    hasPregenWallet: HasPregenWalletMethod;
+    performCreateGuestWallets: CreateGuestWalletsMethod;
+    createGuestWallets: CreateGuestWalletsMethod;
+}

package/dist/types/services/SessionManagementService.d.ts

@@ -0,0 +1,28 @@
+import { ParaCore } from '../ParaCore.js';
+import { AuthService } from './AuthService.js';
+import { PortalUrlService } from './PortalUrlService.js';
+import { WalletService } from './WalletService.js';
+import { ExternalWalletService } from './ExternalWalletService.js';
+import { PregenWalletService } from './PregenWalletService.js';
+import type { GetVerificationTokenMethod, IsFullyLoggedInMethod, IsSessionActiveMethod, IssueJwtMethod, KeepSessionAliveMethod, RefreshSessionMethod, TouchSessionMethod } from './types/SessionManagementServiceTypes.js';
+export declare class SessionManagementService {
+    #private;
+    sessionCookie?: string;
+    get isImportedSession(): boolean;
+    set isImportedSession(value: boolean);
+    constructor(paraCore: ParaCore);
+    init: ({ authService, portalUrlService, walletService, externalWalletService, pregenWalletService, }: {
+        authService: AuthService;
+        portalUrlService: PortalUrlService;
+        walletService: WalletService;
+        externalWalletService: ExternalWalletService;
+        pregenWalletService: PregenWalletService;
+    }) => void;
+    touchSession: TouchSessionMethod;
+    isSessionActive: IsSessionActiveMethod;
+    isFullyLoggedIn: IsFullyLoggedInMethod;
+    refreshSession: RefreshSessionMethod;
+    keepSessionAlive: KeepSessionAliveMethod;
+    getVerificationToken: GetVerificationTokenMethod;
+    issueJwt: IssueJwtMethod;
+}

package/dist/types/services/SignupFlowService.d.ts

@@ -0,0 +1,10 @@
+import { ServerAuthStateSignup } from '@getpara/user-management-client';
+import { BaseAuthFlowService } from './BaseAuthFlowService.js';
+import { AuthStateSignup } from '../types/index.js';
+import type { PrepareStateMethod } from './types/BaseAuthFlowServiceTypes';
+import { WaitForSignupMethod, WaitForWalletCreationMethod } from './types/SignupFlowServiceTypes.js';
+export declare class SignupFlowService extends BaseAuthFlowService {
+    prepareState: PrepareStateMethod<ServerAuthStateSignup, AuthStateSignup>;
+    waitForSignup: WaitForSignupMethod;
+    waitForWalletCreation: WaitForWalletCreationMethod;
+}

package/dist/types/services/VerificationFlowService.d.ts

@@ -0,0 +1,17 @@
+import { ServerAuthStateVerify } from '@getpara/user-management-client';
+import { BaseAuthFlowService } from './BaseAuthFlowService.js';
+import type { AuthStateVerify } from '../types/index.js';
+import type { PrepareStateMethod } from './types/BaseAuthFlowServiceTypes';
+import { PerformVerifyExternalWalletMethod, PerformVerifyFarcasterMethod, PerformVerifyNewAccountMethod, PerformVerifyTelegramMethod, RetryVerifyExternalWalletMethod, VerifyExternalWalletMethod, VerifyFarcasterMethod, VerifyNewAccountMethod, VerifyTelegramMethod } from './types/VerificationFlowServiceTypes.js';
+export declare class VerificationFlowService extends BaseAuthFlowService {
+    prepareState: PrepareStateMethod<ServerAuthStateVerify, AuthStateVerify>;
+    performVerifyNewAccount: PerformVerifyNewAccountMethod;
+    verifyNewAccount: VerifyNewAccountMethod;
+    performVerifyExternalWallet: PerformVerifyExternalWalletMethod;
+    verifyExternalWallet: VerifyExternalWalletMethod;
+    retryVerifyExternalWallet: RetryVerifyExternalWalletMethod;
+    performVerifyTelegram: PerformVerifyTelegramMethod;
+    verifyTelegram: VerifyTelegramMethod;
+    performVerifyFarcaster: PerformVerifyFarcasterMethod;
+    verifyFarcaster: VerifyFarcasterMethod;
+}

package/dist/types/services/WalletService.d.ts

@@ -0,0 +1,54 @@
+import { CurrentWalletIds, TWalletType } from '@getpara/user-management-client';
+import { ParaCore } from '../ParaCore.js';
+import { AvailableWallet, Wallet } from '../types/wallet.js';
+import { AuthService } from './AuthService.js';
+import { PollingService } from './PollingService.js';
+import { PregenWalletService } from './PregenWalletService.js';
+import { ExternalWalletService } from './ExternalWalletService.js';
+import type { AssertIsValidWalletIdMethod, AssertIsValidWalletTypeMethod, CreateWalletMethod, CreateWalletPerTypeMethod, DistributeNewWalletShareMethod, FetchWalletsMethod, FindWalletByAddressMethod, FindWalletIdMethod, FindWalletMethod, GetDisplayAddressMethod, GetIdenticonHashMethod, GetTypesToCreateMethod, GetUserShareMethod, GetWalletBalanceMethod, GetWalletsByTypeMethod, IsWalletOwnedMethod, IsWalletSupportedMethod, IsWalletUsableMethod, RefreshShareMethod, SetCurrentWalletIdsMethod, SetUserShareMethod, SetWalletsMethod } from './types/WalletServiceTypes.js';
+export declare class WalletService {
+    #private;
+    get wallets(): Record<string, Wallet>;
+    set wallets(value: Record<string, Wallet>);
+    get currentWalletIds(): CurrentWalletIds;
+    set currentWalletIds(value: CurrentWalletIds);
+    get currentWalletIdsArray(): [string, TWalletType][];
+    get currentWalletIdsUnique(): string[];
+    get isWalletTypeEnabled(): Partial<Record<TWalletType, boolean>>;
+    get availableWallets(): AvailableWallet[];
+    constructor(paraCore: ParaCore);
+    init: ({ authService, pollingService, pregenWalletService, externalWalletService, }: {
+        authService: AuthService;
+        pollingService: PollingService;
+        pregenWalletService: PregenWalletService;
+        externalWalletService: ExternalWalletService;
+    }) => void;
+    setWallets: SetWalletsMethod;
+    refreshShare: RefreshShareMethod;
+    getTypesToCreate: GetTypesToCreateMethod;
+    populateWalletAddresses: () => Promise<void>;
+    addToCurrentWalletIds: (walletIds: CurrentWalletIds, options?: {
+        needsWallet?: boolean;
+        sessionLookupId?: string;
+        newDeviceSessionLookupId?: string;
+    }) => Promise<void>;
+    setCurrentWalletIds: SetCurrentWalletIdsMethod;
+    createWallet: CreateWalletMethod;
+    createWalletPerType: CreateWalletPerTypeMethod;
+    findWalletId: FindWalletIdMethod;
+    findWalletByAddress: FindWalletByAddressMethod;
+    findWallet: FindWalletMethod;
+    getDisplayAddress: GetDisplayAddressMethod;
+    getIdenticonHash: GetIdenticonHashMethod;
+    isWalletSupported: IsWalletSupportedMethod;
+    isWalletOwned: IsWalletOwnedMethod;
+    isWalletUsable: IsWalletUsableMethod;
+    getWalletsByType: GetWalletsByTypeMethod;
+    assertIsValidWalletId: AssertIsValidWalletIdMethod;
+    assertIsValidWalletType: AssertIsValidWalletTypeMethod;
+    fetchWallets: FetchWalletsMethod;
+    getWalletBalance: GetWalletBalanceMethod;
+    getUserShare: GetUserShareMethod;
+    setUserShare: SetUserShareMethod;
+    distributeNewWalletShare: DistributeNewWalletShareMethod;
+}

package/dist/types/services/types/AuthServiceTypes.d.ts

@@ -0,0 +1,147 @@
+import type { Auth, AuthExtras, AuthMethod, AuthType, ExternalWalletInfo, PrimaryAuth, PrimaryAuthInfo, ServerAuthState, ServerAuthStateLogin, TAuthMethod, Theme, TOAuthMethod } from '@getpara/user-management-client';
+import type { AuthState, AuthStateDone, AuthStateLogin, AuthStateSignup, AuthStateVerify, CoreAuthInfo, WithCustomTheme, WithSessionLookupId, WithShorten, WithUseShortUrls } from '../../types/index.js';
+import type { InitOAuthPollingParams, PollingCallbacks } from './PollingServiceTypes.js';
+import { PerformConnectExternalWalletResponse, ExternalSignMessageParams } from './ExternalWalletServiceTypes.js';
+import { BaseVerifyExternalWalletParams } from './VerificationFlowServiceTypes.js';
+export type AuthFlow = 'signup' | 'login';
+export type AuthenticateResponse = {
+    authInfo: CoreAuthInfo;
+    hasCreatedWallets: boolean;
+    recoverySecret?: string;
+};
+export interface OAuthRedirectCallbacks {
+    /**
+     * Called when an OAuth popup window is opened.
+     * If this is provided onOAuthUrl will not be called.
+     */
+    onOAuthPopup?: (window: Window) => void;
+    /**
+     * Called when an OAuth URL is generated for redirect.
+     * If this is provided onOAuthPopup will not be called.
+     */
+    onOAuthUrl?: (url: string) => void;
+}
+export type SetAuthMethod = (_: PrimaryAuth, __?: {
+    extras?: AuthExtras;
+    userId?: string;
+}) => Promise<CoreAuthInfo>;
+export type AssertIsAuthSetMethod = (allowed?: AuthType[]) => PrimaryAuthInfo;
+export type AssertUserIdMethod = (options?: {
+    allowGuestMode?: boolean;
+}) => string;
+export type PrepareAuthStateMethod = <T extends ServerAuthState>(serverAuthState: T, opts?: WithCustomTheme & WithUseShortUrls & WithSessionLookupId & {
+    isFromExternalWallet?: boolean;
+}) => Promise<AuthState>;
+export type PrepareLoginStateMethod = (loginState: ServerAuthStateLogin, options: {
+    useShortUrls?: boolean;
+    portalTheme?: Theme;
+    sessionLookupId: string;
+}) => Promise<AuthStateLogin>;
+export interface AuthenticateWithEmailOrPhoneParams extends SignUpOrLogInParams {
+    /**
+     * Callbacks fired while polling for session status.
+     */
+    sessionPollingCallbacks?: PollingCallbacks;
+}
+export type AuthenticateWithEmailOrPhoneResponse = AuthenticateResponse;
+export type AuthenticateWithEmailOrPhoneMethod = (_: AuthenticateWithEmailOrPhoneParams) => Promise<AuthenticateWithEmailOrPhoneResponse>;
+export interface SignUpOrLogInParams extends WithCustomTheme, WithUseShortUrls {
+    /**
+     * The user's email address or phone number, in the form `{ email: '...' } | { phone: '+1...' }`}
+     */
+    auth: Auth<'email'> | Auth<'phone'>;
+}
+export type SignUpOrLogInResponse = AuthStateVerify | AuthStateLogin;
+export type SignUpOrLogInMethod = (_: SignUpOrLogInParams) => Promise<SignUpOrLogInResponse>;
+export interface PerformSignUpOrLogInParams extends SignUpOrLogInParams {
+}
+export interface PerformSignUpOrLogInResponse {
+    authState: ServerAuthState;
+    opts: WithCustomTheme & WithUseShortUrls;
+}
+export type PerformSignUpOrLogInMethod = (_: PerformSignUpOrLogInParams) => Promise<PerformSignUpOrLogInResponse>;
+export interface BaseLoginExternalWalletParams {
+    /**
+     * The external wallet information to use for login.
+     */
+    externalWallet: ExternalWalletInfo | ExternalWalletInfo[];
+    /**
+     * The chain ID used to generate the SIWE message.
+     */
+    chainId?: string;
+    /**
+     * The URI used to generate the SIWE message.
+     */
+    uri?: string;
+}
+export interface LoginExternalWalletParams extends WithCustomTheme, WithUseShortUrls, BaseLoginExternalWalletParams {
+}
+export type LoginExternalWalletResponse = AuthStateVerify | AuthStateLogin;
+export type LoginExternalWalletMethod = (_: LoginExternalWalletParams) => Promise<LoginExternalWalletResponse>;
+export interface ConnectExternalWalletParams {
+    /**
+     * The callback that is called to connect to the external wallet.
+     */
+    connect: () => Promise<PerformConnectExternalWalletResponse>;
+}
+export type ConnectExternalWalletResponse = AuthStateVerify | AuthStateLogin;
+export type ConnectExternalWalletMethod = (_: ConnectExternalWalletParams) => Promise<ConnectExternalWalletResponse>;
+export type SignExternalWalletVerificationMethod = (_: ExternalSignMessageParams) => Promise<BaseVerifyExternalWalletParams>;
+interface PerformLoginExternalWalletResponse {
+    authState: ServerAuthState;
+    opts: WithCustomTheme & WithUseShortUrls;
+}
+export type PerformLoginExternalWalletMethod = (_: LoginExternalWalletParams) => Promise<PerformLoginExternalWalletResponse>;
+export interface VerifyOAuthProcessParams extends PollingCallbacks, InitOAuthPollingParams {
+}
+export type VerifyOAuthProcessResponse = AuthStateLogin | AuthStateSignup | AuthStateDone;
+export type VerifyOAuthProcessMethod = (_: VerifyOAuthProcessParams) => Promise<VerifyOAuthProcessResponse>;
+export interface AuthenticateWithOAuthParams extends WithCustomTheme, WithUseShortUrls {
+    /**
+     * The third-party OAuth service.
+     */
+    method: TOAuthMethod;
+    /**
+     * The app scheme to redirect to after OAuth is complete.
+     */
+    appScheme?: string;
+    /**
+     * Callbacks for OAuth popup/redirect handling.
+     */
+    redirectCallbacks?: OAuthRedirectCallbacks;
+    /**
+     * Callbacks fired while polling for session status.
+     */
+    sessionPollingCallbacks?: PollingCallbacks;
+    /**
+     * Callbacks fired while polling for OAuth status.
+     */
+    oAuthPollingCallbacks?: PollingCallbacks;
+}
+export type AuthenticateWithOAuthResponse = AuthenticateResponse;
+export type AuthenticateWithOAuthMethod = (_: AuthenticateWithOAuthParams) => Promise<AuthenticateWithOAuthResponse>;
+export interface GetNewCredentialAndUrlParams extends WithCustomTheme, WithShorten {
+    /**
+     * Whether the URL is meant to add a passkey for a previous user on a new device. Defaults to `false`.
+     */
+    isForNewDevice?: boolean;
+    /**
+     * The authentication method to add.
+     */
+    authMethod?: TAuthMethod;
+}
+export interface GetNewCredentialAndUrlResponse {
+    credentialId: string;
+    url?: string;
+}
+export type GetNewCredentialAndUrlMethod = (_?: GetNewCredentialAndUrlParams) => Promise<GetNewCredentialAndUrlResponse>;
+export interface AddCredentialParams {
+    authMethod?: TAuthMethod;
+}
+export type AddCredentialMethod = (_: AddCredentialParams) => Promise<string | undefined>;
+export type SupportedUserAuthMethodsMethod = () => Promise<Set<AuthMethod>>;
+export interface ResendVerificationCodeParams {
+    type?: 'SIGNUP' | 'LINK_ACCOUNT' | 'LOGIN';
+}
+export type ResendVerificationCodeMethod = (_: ResendVerificationCodeParams) => Promise<void>;
+export {};

package/dist/types/services/types/BaseAuthFlowServiceTypes.d.ts

@@ -0,0 +1,4 @@
+import type { ServerAuthState } from '@getpara/user-management-client';
+import type { AuthState, WithCustomTheme, WithSessionLookupId, WithUseShortUrls } from '../../types/index';
+export type SetupAuthFromServerStateMethod = (_: ServerAuthState) => Promise<void>;
+export type PrepareStateMethod<P = ServerAuthState, R = AuthState> = (serverState: P, opts: WithUseShortUrls & WithCustomTheme & WithSessionLookupId) => Promise<R>;