@getpara/core-sdk 2.0.0-alpha.20 → 2.0.0-alpha.21

package/dist/esm/types/coreApi.js

@@ -46,8 +46,21 @@ const PARA_CORE_METHODS = [
   "signTransaction",
   "initiateOnRampTransaction",
   "getWalletBalance",
-  "issueJwt"
+  "issueJwt",
+  "getLinkedAccounts",
+  "accountLinkInProgress"
+];
+const PARA_INTERNAL_METHODS = [
+  "linkAccount",
+  "unlinkAccount",
+  "verifyEmailOrPhoneLink",
+  "verifyOAuthLink",
+  "verifyFarcasterLink",
+  "verifyTelegramLink",
+  "verifyExternalWalletLink",
+  "accountLinkInProgress"
 ];
 export {
-  PARA_CORE_METHODS
+  PARA_CORE_METHODS,
+  PARA_INTERNAL_METHODS
 };

package/dist/esm/types/index.js

@@ -1,4 +1,5 @@
 import "../chunk-7B52C2XE.js";
+export * from "./auth.js";
 export * from "./config.js";
 export * from "./coreApi.js";
 export * from "./wallet.js";

package/dist/types/ParaCore.d.ts

@@ -1,6 +1,6 @@
-import { AuthMethod, AuthExtras, CurrentWalletIds, EmailTheme, TWalletType, PregenIds, BiometricLocationHint, Auth, SupportedWalletTypes, AuthIdentifier, AuthType, ExternalWalletInfo, PrimaryAuthInfo, SessionInfo, PrimaryAuth, PrimaryAuthType, AccountMetadata } from '@getpara/user-management-client';
+import { AuthMethod, AuthExtras, CurrentWalletIds, EmailTheme, TWalletType, PregenIds, BiometricLocationHint, Auth, SupportedWalletTypes, AuthIdentifier, AuthType, ExternalWalletInfo, PrimaryAuthInfo, SessionInfo, PrimaryAuth, PrimaryAuthType, AccountMetadata, LinkedAccounts, VerifyLinkParams, VerifyExternalWalletParams, SupportedAccountLinks } from '@getpara/user-management-client';
 import type { pki as pkiType } from 'node-forge';
-import { Ctx, Environment, Theme, WalletFilters, Wallet, PortalUrlOptions, ConstructorOpts, CoreAuthInfo, PortalUrlType, CoreMethodParams, CoreMethodResponse, NewCredentialUrlParams, LoginUrlParams, CoreInterface, ExternalWalletConnectionType } from './types/index.js';
+import { Ctx, Environment, Theme, WalletFilters, Wallet, PortalUrlOptions, ConstructorOpts, CoreAuthInfo, PortalUrlType, CoreMethodParams, CoreMethodResponse, NewCredentialUrlParams, LoginUrlParams, CoreInterface, ExternalWalletConnectionType, AccountLinkInProgress, InternalMethodParams, InternalMethodResponse } from './types/index.js';
 import { PlatformUtils } from './PlatformUtils.js';
 export declare abstract class ParaCore implements CoreInterface {
     #private;
@@ -15,6 +15,7 @@ export declare abstract class ParaCore implements CoreInterface {
     get externalWalletWithParaAuth(): Wallet | undefined;
     get externalWalletConnectionType(): ExternalWalletConnectionType;
     userId?: string;
+    accountLinkInProgress: AccountLinkInProgress | undefined;
     private sessionCookie?;
     private isAwaitingAccountCreation;
     private isAwaitingLogin;
@@ -124,6 +125,7 @@ export declare abstract class ParaCore implements CoreInterface {
     get isNoWalletConfig(): boolean;
     get supportedWalletTypes(): SupportedWalletTypes;
     get cosmosPrefix(): string | undefined;
+    get supportedAccountLinks(): SupportedAccountLinks;
     get isWalletTypeEnabled(): Partial<Record<TWalletType, boolean>>;
     private platformUtils;
     private localStorageGetItem;
@@ -234,7 +236,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * @param externalAddress - External wallet address to set.
      * @param externalType - Type of external wallet to set.
      */
-    setExternalWallet({ address, type, provider, addressBech32, withFullParaAuth, isConnectionOnly, withVerification, }: ExternalWalletInfo): Promise<void>;
+    setExternalWallet({ address, type, provider, providerId, addressBech32, withFullParaAuth, isConnectionOnly, withVerification, }: ExternalWalletInfo): Promise<void>;
     /**
      * Sets the user id associated with the `ParaCore` instance.
      * @param userId - User id to set.
@@ -305,7 +307,7 @@ export declare abstract class ParaCore implements CoreInterface {
      */
     findWalletByAddress(address: string, filter?: WalletFilters | undefined): any;
     findWallet(idOrAddress?: string, overrideType?: TWalletType, filter?: WalletFilters): Omit<Wallet, 'signer'> | undefined;
-    get availableWallets(): Pick<Wallet, 'id' | 'type' | 'name' | 'address' | 'isExternal'>[];
+    get availableWallets(): Pick<Wallet, 'id' | 'type' | 'name' | 'address' | 'isExternal' | 'externalProviderId'>[];
     /**
      * Retrieves all usable wallets with the provided type (`'EVM' | 'COSMOS' | 'SOLANA'`)
      * @param {string} type the wallet type to filter by.
@@ -345,13 +347,15 @@ export declare abstract class ParaCore implements CoreInterface {
      */
     loginExternalWallet({ externalWallet, ...urlOptions }: CoreMethodParams<'loginExternalWallet'>): CoreMethodResponse<'loginExternalWallet'>;
     verifyExternalWallet({ externalWallet, signedMessage, cosmosPublicKeyHex, cosmosSigner, ...urlOptions }: CoreMethodParams<'verifyExternalWallet'>): CoreMethodResponse<'verifyExternalWallet'>;
-    /**
-     * Validates the response received from an attempted Telegram login for authenticity, then
-     * creates or retrieves the corresponding Para user and prepares the Para instance to sign in with that user.
-     * @param authResponse - the response JSON object received from the Telegram widget.
-     * @returns `{ isValid: boolean; telegramUserId?: string; userId?: string; isNewUser?: boolean; supportedAuthMethods?: AuthMethod[]; biometricHints?: BiometricLocationHint[] }`
-     */
-    verifyTelegram({ telegramAuthResponse, ...urlOptions }: CoreMethodParams<'verifyTelegram'>): CoreMethodResponse<'verifyTelegram'>;
+    protected verifyExternalWalletLink(opts: InternalMethodParams<'verifyExternalWalletLink'>): InternalMethodResponse<'verifyExternalWalletLink'>;
+    protected verifyTelegramProcess(opts: CoreMethodParams<'verifyTelegram'> & {
+        isLinkAccount: false;
+    }): CoreMethodResponse<'verifyTelegram'>;
+    protected verifyTelegramProcess(opts: InternalMethodParams<'verifyTelegramLink'> & {
+        isLinkAccount: true;
+    }): InternalMethodResponse<'verifyTelegramLink'>;
+    verifyTelegram(opts: CoreMethodParams<'verifyTelegram'>): CoreMethodResponse<'verifyTelegram'>;
+    protected verifyTelegramLink(opts: InternalMethodParams<'verifyTelegramLink'>): InternalMethodResponse<'verifyTelegramLink'>;
     /**
      * Performs 2FA verification.
      * @param {Object} opts the options object
@@ -374,7 +378,7 @@ export declare abstract class ParaCore implements CoreInterface {
     /**
      * Resend a verification email for the current user.
      */
-    resendVerificationCode(): CoreMethodResponse<'resendVerificationCode'>;
+    resendVerificationCode({ type: reason, }: CoreMethodParams<'resendVerificationCode'>): CoreMethodResponse<'resendVerificationCode'>;
     /**
      * Checks if the current session is active.
      * @returns `true` if active, `false` otherwise
@@ -406,30 +410,23 @@ export declare abstract class ParaCore implements CoreInterface {
     getFarcasterConnectUri({ appScheme }?: {
         appScheme?: string;
     }): CoreMethodResponse<'getFarcasterConnectUri'>;
-    /**
-     * Awaits the response from a user's attempt to log in with Farcaster.
-     * If successful, this returns the user's Farcaster username and profile picture and indicates whether the user already exists.
-     * @return {Object} `{userExists: boolean; username: string; pfpUrl?: string | null }` - the user's information and whether the user already exists.
-     */
-    verifyFarcaster({ isCanceled, onConnectUri, onCancel, onPoll, ...urlOptions }: CoreMethodParams<'verifyFarcaster'>): CoreMethodResponse<'verifyFarcaster'>;
-    /**
-     * Generates a URL for the user to log in with OAuth using a desire method.
-     *
-     * @param {Object} opts the options object
-     * @param {TOAuthMethod} opts.method the third-party service to use for OAuth.
-     * @param {string} [opts.deeplinkUrl] the deeplink to redirect to after the OAuth flow. This is for mobile only.
-     * @returns {string} the URL for the user to log in with OAuth.
-     */
-    getOAuthUrl({ method, deeplinkUrl, ...params }: CoreMethodParams<'getOAuthUrl'>): CoreMethodResponse<'getOAuthUrl'>;
-    /**
-     * Awaits the response from a user's attempt to log in with OAuth.
-     * If successful, this returns the user's email address and indicates whether the user already exists.
-     *
-     * @param {Object} opts the options object.
-     * @param {Window} [opts.popupWindow] the popup window being used for login.
-     * @return {Object} `{ email?: string; isError?: boolean; userExists: boolean; }` the result data
-     */
-    verifyOAuth({ method, deeplinkUrl, isCanceled, onCancel, onPoll, onOAuthUrl, ...urlOptions }: CoreMethodParams<'verifyOAuth'>): CoreMethodResponse<'verifyOAuth'>;
+    protected verifyFarcasterProcess(opts: CoreMethodParams<'verifyFarcaster'> & {
+        isLinkAccount: false;
+    }): CoreMethodResponse<'verifyFarcaster'>;
+    protected verifyFarcasterProcess(opts: InternalMethodParams<'verifyFarcasterLink'> & {
+        isLinkAccount: true;
+    }): InternalMethodResponse<'verifyFarcasterLink'>;
+    verifyFarcaster(opts: CoreMethodParams<'verifyFarcaster'>): CoreMethodResponse<'verifyFarcaster'>;
+    protected verifyFarcasterLink(opts: InternalMethodParams<'verifyFarcasterLink'>): InternalMethodResponse<'verifyFarcasterLink'>;
+    getOAuthUrl(opts: CoreMethodParams<'getOAuthUrl'>): CoreMethodResponse<'getOAuthUrl'>;
+    protected verifyOAuthProcess(_: InternalMethodParams<'verifyOAuthLink'> & {
+        isLinkAccount: true;
+    }): InternalMethodResponse<'verifyOAuthLink'>;
+    protected verifyOAuthProcess(_: CoreMethodParams<'verifyOAuth'> & {
+        isLinkAccount: false;
+    }): CoreMethodResponse<'verifyOAuth'>;
+    verifyOAuth(opts: CoreMethodParams<'verifyOAuth'>): CoreMethodResponse<'verifyOAuth'>;
+    protected verifyOAuthLink(opts: InternalMethodParams<'verifyOAuthLink'>): InternalMethodResponse<'verifyOAuthLink'>;
     /**
      * Waits for the session to be active and sets up the user.
      *
@@ -654,8 +651,6 @@ export declare abstract class ParaCore implements CoreInterface {
     logout({ clearPregenWallets }?: {
         clearPregenWallets?: boolean;
     }): Promise<void>;
-    /** @deprecated */
-    protected getSupportedCreateAuthMethods(): Promise<Set<AuthMethod>>;
     /**
      * Converts to a string, removing sensitive data when logging this class.
      *
@@ -677,4 +672,11 @@ export declare abstract class ParaCore implements CoreInterface {
     protected getLoginUrl({ authMethod, shorten, portalTheme, sessionId, }: LoginUrlParams): Promise<string>;
     signUpOrLogIn({ auth, ...urlOptions }: CoreMethodParams<'signUpOrLogIn'>): CoreMethodResponse<'signUpOrLogIn'>;
     verifyNewAccount({ verificationCode, ...urlOptions }: CoreMethodParams<'verifyNewAccount'>): CoreMethodResponse<'verifyNewAccount'>;
+    getLinkedAccounts(): CoreMethodResponse<'getLinkedAccounts'>;
+    protected linkAccount(opts: InternalMethodParams<'linkAccount'>): InternalMethodResponse<'linkAccount'>;
+    protected unlinkAccount({ linkedAccountId, }: InternalMethodParams<'unlinkAccount'>): InternalMethodResponse<'unlinkAccount'>;
+    protected verifyLink({ accountLinkInProgress, ...opts }?: {
+        accountLinkInProgress?: AccountLinkInProgress;
+    } & Partial<Pick<VerifyLinkParams, 'verificationCode' | 'telegramAuthResponse'> & VerifyExternalWalletParams>): Promise<LinkedAccounts>;
+    protected verifyEmailOrPhoneLink({ verificationCode, }: InternalMethodParams<'verifyEmailOrPhoneLink'>): InternalMethodResponse<'verifyEmailOrPhoneLink'>;
 }

package/dist/types/constants.d.ts

@@ -18,3 +18,4 @@ export declare const POLLING_INTERVAL_MS = 2000;
 export declare const SHORT_POLLING_INTERVAL_MS = 1000;
 export declare const POLLING_TIMEOUT_MS = 300000;
 export declare const EXTERNAL_WALLET_CONNECTION_ONLY_USER_ID = "EXTERNAL_WALLET_CONNECTION_ONLY";
+export declare const ACCOUNT_LINK_CONFLICT = "Account already linked";

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 import { ParaCore } from './ParaCore.js';
-export { type AuthInfo, type PrimaryAuthInfo, type VerifiedAuthInfo, AuthMethod, type AuthExtras, type CurrentWalletIds, EmailTheme, type PartnerEntity, type WalletEntity, Network, WalletType, type TWalletType, WalletScheme, type TWalletScheme, OnRampAsset, OnRampPurchaseType, OnRampProvider, OnRampPurchaseStatus, type OnRampConfig, type OnRampAllowedAssets, type OnRampPurchase, OAuthMethod, type TOAuthMethod, type SupportedWalletTypes, type TPregenIdentifierType, type PregenIds, type PregenAuth, NON_ED25519, PREGEN_IDENTIFIER_TYPES, WALLET_TYPES, WALLET_SCHEMES, OAUTH_METHODS, } from '@getpara/user-management-client';
-export { OnRampMethod, PopupType, PregenIdentifierType, RecoveryStatus, type AuthStateSignup, type AuthStateVerify, type AuthStateLogin, type AuthState, type OAuthResponse, type CoreAuthInfo, type ProviderAssetInfo, type SignatureRes, type FullSignatureRes, type SuccessfulSignatureRes, type DeniedSignatureRes, type DeniedSignatureResWithUrl, type OnRampAssetInfo, type Theme, type Wallet, type GetWalletBalanceParams, } from './types/index.js';
+export { type Auth, type AuthInfo, type PrimaryAuthInfo, type VerifiedAuthInfo, type VerifiedAuth, AuthMethod, type AuthExtras, type CurrentWalletIds, EmailTheme, type PartnerEntity, type WalletEntity, Network, WalletType, type TWalletType, WalletScheme, type TWalletScheme, OnRampAsset, OnRampPurchaseType, OnRampProvider, OnRampPurchaseStatus, type OnRampConfig, type OnRampAllowedAssets, type OnRampPurchase, 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, NON_ED25519, PREGEN_IDENTIFIER_TYPES, WALLET_TYPES, WALLET_SCHEMES, OAUTH_METHODS, LINKED_ACCOUNT_TYPES, EXTERNAL_WALLET_TYPES, EVM_WALLETS, SOLANA_WALLETS, COSMOS_WALLETS, } from '@getpara/user-management-client';
+export { OnRampMethod, PopupType, PregenIdentifierType, RecoveryStatus, type AuthStateSignup, type AuthStateVerify, type AuthStateLogin, type AuthState, type OAuthResponse, type CoreAuthInfo, type ProviderAssetInfo, type SignatureRes, type FullSignatureRes, type SuccessfulSignatureRes, type DeniedSignatureRes, type DeniedSignatureResWithUrl, type OnRampAssetInfo, type Theme, type Wallet, type GetWalletBalanceParams, type AccountLinkInProgress, AccountLinkError, type InternalInterface, } from './types/index.js';
 export * from './types/coreApi.js';
 export * from './types/events.js';
 export * from './types/config.js';

package/dist/types/types/auth.d.ts

@@ -0,0 +1,16 @@
+import { ExternalWalletInfo, TLinkedAccountType } from '@getpara/user-management-client';
+export type AccountLinkInProgress = {
+    id: string;
+    type: TLinkedAccountType;
+    identifier?: string;
+    isComplete: boolean;
+    externalWallet?: ExternalWalletInfo & {
+        signatureVerificationMessage: string;
+    };
+};
+export declare enum AccountLinkError {
+    NotAuthenticated = "No user is currently authenticated",
+    Conflict = "Account already linked",
+    Canceled = "Account linking was canceled",
+    Unknown = "An unknown error occurred"
+}

package/dist/types/types/coreApi.d.ts

@@ -1,24 +1,48 @@
-import { BackupKitEmailProps, CurrentWalletIds, ExternalWalletInfo, OnRampPurchase, OnRampPurchaseCreateParams, PregenAuth, Setup2faResponse, TelegramAuthResponse, VerifiedAuth, VerifyExternalWalletParams, WalletEntity, WalletParams, TWalletType, IssueJwtParams, IssueJwtResponse } from '@getpara/user-management-client';
-import { AuthStateLogin, AuthStateVerify, OAuthResponse, AuthStateBaseParams, WithCustomTheme, WithUseShortUrls, Verify2faResponse, AuthStateSignup, AuthStateVerifyOrLogin, OAuthUrlParams, StorageType, PollParams, CoreAuthInfo, GetWalletBalanceParams, GetWalletBalanceResponse } from './methods.js';
+import { BackupKitEmailProps, CurrentWalletIds, ExternalWalletInfo, OnRampPurchase, OnRampPurchaseCreateParams, PregenAuth, Setup2faResponse, VerifiedAuth, VerifyExternalWalletParams, WalletEntity, WalletParams, TWalletType, IssueJwtParams, IssueJwtResponse, TLinkedAccountType, LinkedAccounts } from '@getpara/user-management-client';
+import { AuthStateLogin, AuthStateVerify, OAuthResponse, AuthStateBaseParams, WithCustomTheme, WithUseShortUrls, Verify2faResponse, AuthStateSignup, AuthStateVerifyOrLogin, OAuthUrlParams, StorageType, PollParams, CoreAuthInfo, GetWalletBalanceParams, GetWalletBalanceResponse, FarcasterParams, TelegramParams, OAuthParams } from './methods.js';
 import { ParaCore } from '../ParaCore.js';
 import { FullSignatureRes, Wallet } from './wallet.js';
-export declare const PARA_CORE_METHODS: readonly ["getAuthInfo", "signUpOrLogIn", "verifyNewAccount", "waitForLogin", "waitForSignup", "waitForWalletCreation", "getOAuthUrl", "verifyOAuth", "getFarcasterConnectUri", "verifyFarcaster", "verifyTelegram", "resendVerificationCode", "loginExternalWallet", "verifyExternalWallet", "setup2fa", "enable2fa", "verify2fa", "logout", "clearStorage", "isSessionActive", "isFullyLoggedIn", "refreshSession", "keepSessionAlive", "exportSession", "importSession", "getVerificationToken", "getWallets", "getWalletsByType", "fetchWallets", "createWallet", "createWalletPerType", "getPregenWallets", "hasPregenWallet", "updatePregenWalletIdentifier", "createPregenWallet", "createPregenWalletPerType", "claimPregenWallets", "createGuestWallets", "distributeNewWalletShare", "getUserShare", "setUserShare", "refreshShare", "signMessage", "signTransaction", "initiateOnRampTransaction", "getWalletBalance", "issueJwt"];
+import { AccountLinkInProgress } from './auth.js';
+export declare const PARA_CORE_METHODS: readonly ["getAuthInfo", "signUpOrLogIn", "verifyNewAccount", "waitForLogin", "waitForSignup", "waitForWalletCreation", "getOAuthUrl", "verifyOAuth", "getFarcasterConnectUri", "verifyFarcaster", "verifyTelegram", "resendVerificationCode", "loginExternalWallet", "verifyExternalWallet", "setup2fa", "enable2fa", "verify2fa", "logout", "clearStorage", "isSessionActive", "isFullyLoggedIn", "refreshSession", "keepSessionAlive", "exportSession", "importSession", "getVerificationToken", "getWallets", "getWalletsByType", "fetchWallets", "createWallet", "createWalletPerType", "getPregenWallets", "hasPregenWallet", "updatePregenWalletIdentifier", "createPregenWallet", "createPregenWalletPerType", "claimPregenWallets", "createGuestWallets", "distributeNewWalletShare", "getUserShare", "setUserShare", "refreshShare", "signMessage", "signTransaction", "initiateOnRampTransaction", "getWalletBalance", "issueJwt", "getLinkedAccounts", "accountLinkInProgress"];
+export declare const PARA_INTERNAL_METHODS: readonly ["linkAccount", "unlinkAccount", "verifyEmailOrPhoneLink", "verifyOAuthLink", "verifyFarcasterLink", "verifyTelegramLink", "verifyExternalWalletLink", "accountLinkInProgress"];
 export type CoreMethodName = (typeof PARA_CORE_METHODS)[number];
 export type CoreMethodParams<method extends CoreMethodName & keyof CoreMethods> = CoreMethods[method] extends {
     params: infer P;
 } ? P : never;
+export type CoreMethodIsGetter<method extends CoreMethodName & keyof CoreMethods> = CoreMethods[method] extends {
+    isGetter: true;
+} ? true : false;
 export type CoreMethodResponse<method extends CoreMethodName & keyof CoreMethods> = CoreMethods[method] extends {
     response: infer R;
 } ? CoreMethods[method] extends {
     sync: true;
 } ? R : Promise<R> : void;
-export type CoreMethod<method extends CoreMethodName & keyof CoreMethods> = CoreMethodParams<method> extends void | never ? () => CoreMethodResponse<method> : (_?: CoreMethodParams<method>) => CoreMethodResponse<method>;
+export type CoreMethod<method extends CoreMethodName & keyof CoreMethods> = CoreMethodIsGetter<method> extends true ? Awaited<CoreMethodResponse<method>> : CoreMethodParams<method> extends void | never ? () => CoreMethodResponse<method> : (_?: CoreMethodParams<method>) => CoreMethodResponse<method>;
 export type CoreAction<method extends CoreMethodName & keyof CoreMethods> = CoreMethodParams<method> extends void | never ? (_?: ParaCore) => CoreMethodResponse<method> : (_?: ParaCore, __?: CoreMethodParams<method>) => CoreMethodResponse<method>;
+export type InternalMethodName = (typeof PARA_INTERNAL_METHODS)[number];
+export type InternalMethodParams<method extends InternalMethodName & keyof InternalMethods> = InternalMethods[method] extends {
+    params: infer P;
+} ? P : never;
+export type InternalMethodIsGetter<method extends InternalMethodName & keyof InternalMethods> = InternalMethods[method] extends {
+    isGetter: true;
+} ? true : false;
+export type InternalMethodResponse<method extends InternalMethodName & keyof InternalMethods> = InternalMethods[method] extends {
+    response: infer R;
+} ? InternalMethods[method] extends {
+    sync: true;
+} ? R : Promise<R> : void;
+export type InternalMethod<method extends InternalMethodName & keyof InternalMethods> = InternalMethodIsGetter<method> extends true ? Awaited<InternalMethodResponse<method>> : InternalMethodParams<method> extends void | never ? () => InternalMethodResponse<method> : (_?: InternalMethodParams<method>) => InternalMethodResponse<method>;
+export type InternalAction<method extends InternalMethodName & keyof InternalMethods> = InternalMethodParams<method> extends void | never ? (_?: ParaCore) => InternalMethodResponse<method> : (_?: ParaCore, __?: InternalMethodParams<method>) => InternalMethodResponse<method>;
 export type CoreMethods = Record<CoreMethodName, {
     params?: unknown;
     response?: unknown;
     sync?: true;
 }> & {
+    accountLinkInProgress: {
+        params: never;
+        response: AccountLinkInProgress;
+        isGetter: true;
+    };
     getAuthInfo: {
         params: void;
         response: CoreAuthInfo | undefined;
@@ -98,17 +122,7 @@ export type CoreMethods = Record<CoreMethodName, {
         response: string;
     };
     verifyOAuth: {
-        params: AuthStateBaseParams & OAuthUrlParams & PollParams & {
-            /**
-             * A function returning a boolean, indicating whether the OAuth process should be cancelled.
-             */
-            isCanceled?: () => boolean;
-            /**
-             * A callback function that will be invoked with the OAuth URL when it is available.
-             * For example, you can use this to open the URL in a new window or tab.
-             */
-            onOAuthUrl?: (url: string) => void;
-        };
+        params: AuthStateBaseParams & OAuthParams;
         response: OAuthResponse;
     };
     getFarcasterConnectUri: {
@@ -116,26 +130,11 @@ export type CoreMethods = Record<CoreMethodName, {
         response: string;
     };
     verifyFarcaster: {
-        params: AuthStateBaseParams & PollParams & {
-            /**
-             * A function returning a boolean, indicating whether the Farcaster login process should be cancelled.
-             */
-            isCanceled?: () => boolean;
-            /**
-             * A callback function that will be invoked with the Farcaster Connect URI when it is available.
-             * You will need to display the URI as a QR code.
-             */
-            onConnectUri?: (uri: string) => void;
-        };
+        params: AuthStateBaseParams & FarcasterParams;
         response: OAuthResponse;
     };
     verifyTelegram: {
-        params: AuthStateBaseParams & {
-            /**
-             * The response received from the Telegram login bot.
-             */
-            telegramAuthResponse: TelegramAuthResponse;
-        };
+        params: AuthStateBaseParams & TelegramParams;
         response: OAuthResponse;
     };
     loginExternalWallet: {
@@ -152,7 +151,9 @@ export type CoreMethods = Record<CoreMethodName, {
         response: AuthStateSignup;
     };
     resendVerificationCode: {
-        params: void;
+        params: {
+            type?: 'SIGNUP' | 'LINK_ACCOUNT';
+        } | undefined;
         response: void;
     };
     logout: {
@@ -473,7 +474,54 @@ export type CoreMethods = Record<CoreMethodName, {
         params: IssueJwtParams;
         response: IssueJwtResponse;
     };
+    getLinkedAccounts: {
+        params: void;
+        response: LinkedAccounts;
+    };
+};
+export type InternalMethods = {
+    linkAccount: {
+        params: {
+            auth: VerifiedAuth;
+        } | {
+            externalWallet: ExternalWalletInfo;
+        } | {
+            type: TLinkedAccountType | 'X';
+        };
+        response: AccountLinkInProgress;
+    };
+    unlinkAccount: {
+        params: {
+            linkedAccountId: string;
+        };
+        response: LinkedAccounts;
+    };
+    verifyEmailOrPhoneLink: {
+        params: {
+            verificationCode?: string;
+        };
+        response: LinkedAccounts;
+    };
+    verifyOAuthLink: {
+        params: OAuthParams;
+        response: LinkedAccounts;
+    };
+    verifyFarcasterLink: {
+        params: FarcasterParams;
+        response: LinkedAccounts;
+    };
+    verifyTelegramLink: {
+        params: TelegramParams;
+        response: LinkedAccounts;
+    };
+    verifyExternalWalletLink: {
+        params: Omit<VerifyExternalWalletParams, 'externalWallet'>;
+        response: LinkedAccounts;
+    };
 };
 export type CoreInterface = {
-    [key in keyof CoreMethods]: CoreMethod<key>;
+    [key in keyof CoreMethods]: Partial<CoreMethod<key>>;
+};
+export type InternalInterface = {
+    [key in keyof InternalMethods]: Partial<InternalMethod<key>>;
 };

package/dist/types/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from './auth.js';
 export * from './config.js';
 export * from './coreApi.js';
 export * from './wallet.js';

package/dist/types/types/methods.d.ts

@@ -1,4 +1,4 @@
-import { PrimaryAuthInfo, ServerAuthStateLogin, ServerAuthStateSignup, AuthMethod, ServerAuthStateVerify, VerifiedAuth, AuthExtras, TOAuthMethod, TWalletType } from '@getpara/user-management-client';
+import { PrimaryAuthInfo, ServerAuthStateLogin, ServerAuthStateSignup, AuthMethod, ServerAuthStateVerify, VerifiedAuth, AuthExtras, TOAuthMethod, TWalletType, TelegramAuthResponse } from '@getpara/user-management-client';
 import { Theme } from './theme.js';
 import { RecoveryStatus } from './recovery.js';
 import { Wallet } from './wallet.js';
@@ -14,7 +14,7 @@ export type VerifyExternalWalletV1 = {
     cosmosPublicKeyHex?: string;
     cosmosSigner?: string;
 };
-export type PortalUrlType = 'createAuth' | 'createPassword' | 'loginAuth' | 'loginPassword' | 'txReview' | 'onRamp';
+export type PortalUrlType = 'createAuth' | 'createPassword' | 'loginAuth' | 'loginPassword' | 'txReview' | 'onRamp' | 'telegramLogin';
 export type PortalUrlOptions = {
     params?: Record<string, string | undefined | null>;
     isForNewDevice?: boolean;
@@ -66,6 +66,23 @@ export type PollParams = {
      */
     onCancel?: () => void;
 };
+export type FarcasterParams = PollParams & {
+    /**
+     * A function returning a boolean, indicating whether the Farcaster login process should be cancelled.
+     */
+    isCanceled?: () => boolean;
+    /**
+     * A callback function that will be invoked with the Farcaster Connect URI when it is available.
+     * You will need to display the URI as a QR code.
+     */
+    onConnectUri?: (uri: string) => void;
+};
+export type TelegramParams = {
+    /**
+     * The response received from the Telegram login bot.
+     */
+    telegramAuthResponse: TelegramAuthResponse;
+};
 export type LoginUrlParams = WithAuthMethod & WithCustomTheme & WithShorten & {
     sessionId?: string;
 };
@@ -85,6 +102,17 @@ export type OAuthUrlParams = {
      */
     deeplinkUrl?: string;
 };
+export type OAuthParams = OAuthUrlParams & PollParams & {
+    /**
+     * A function returning a boolean, indicating whether the OAuth process should be cancelled.
+     */
+    isCanceled?: () => boolean;
+    /**
+     * A callback function that will be invoked with the OAuth URL when it is available.
+     * For example, you can use this to open the URL in a new window or tab.
+     */
+    onOAuthUrl?: (url: string) => void;
+};
 export type AuthStateBaseParams = WithCustomTheme & WithUseShortUrls;
 export type AuthStateVerify = ServerAuthStateVerify;
 export type AuthStateLogin = Omit<ServerAuthStateLogin, 'loginAuthMethods'> & WithIsPasskeySupported & {

package/dist/types/types/wallet.d.ts

@@ -1,4 +1,4 @@
-import { EmbeddedWalletType, ExternalWalletType, PartnerEntity, TPregenIdentifierType, TWalletScheme } from '@getpara/user-management-client';
+import { EmbeddedWalletType, ExternalWalletType, PartnerEntity, TExternalWallet, TPregenIdentifierType, TWalletScheme } from '@getpara/user-management-client';
 export interface Wallet {
     createdAt?: string;
     id: string;
@@ -20,6 +20,7 @@ export interface Wallet {
     lastUsedPartnerId?: string;
     isExternal?: boolean;
     isExternalWithParaAuth?: boolean;
+    externalProviderId?: TExternalWallet;
     isExternalWithVerification?: boolean;
     isExternalConnectionOnly?: boolean;
     ensName?: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpara/core-sdk",
-  "version": "2.0.0-alpha.20",
+  "version": "2.0.0-alpha.21",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -10,7 +10,7 @@
     "@celo/utils": "^8.0.2",
     "@cosmjs/encoding": "^0.32.4",
     "@ethereumjs/util": "^9.1.0",
-    "@getpara/user-management-client": "2.0.0-alpha.20",
+    "@getpara/user-management-client": "2.0.0-alpha.21",
     "@noble/hashes": "^1.5.0",
     "base64url": "^3.0.1",
     "libphonenumber-js": "1.11.2",
@@ -41,5 +41,5 @@
       "require": "./dist/cjs/index.js"
     }
   },
-  "gitHead": "4c8d918b9fc387476968bfc08524fe1a8b6ec83b"
+  "gitHead": "03daa3537312bc52e0640225c8abdbf8047c15da"
 }