@getpara/core-sdk 2.0.0-alpha.31 → 2.0.0-alpha.33

package/dist/cjs/ParaCore.js

@@ -99,7 +99,7 @@ var import_recovery = require("./shares/recovery.js");
 var import_utils2 = require("./utils/index.js");
 var import_errors = require("./errors.js");
 var constants = __toESM(require("./constants.js"));
-var _authInfo, _partner, _ParaCore_instances, assertPartner_fn, guestWalletIds_get, guestWalletIdsArray_get, toAuthInfo_fn, setAuthInfo_fn, getPartner_fn, assertIsLinkingAccount_fn, assertIsLinkingAccountOrStart_fn, getOAuthUrl_fn, createPregenWallet_fn, _isCreateGuestWalletsPending, prepareAuthState_fn, prepareLogin_fn, prepareLoginState_fn, prepareSignUpState_fn;
+var _authInfo, _partner, _ParaCore_instances, assertPartner_fn, guestWalletIds_get, guestWalletIdsArray_get, toAuthInfo_fn, setAuthInfo_fn, getPartner_fn, assertIsLinkingAccount_fn, assertIsLinkingAccountOrStart_fn, getOAuthUrl_fn, createPregenWallet_fn, _isCreateGuestWalletsPending, prepareAuthState_fn, prepareLoginState_fn, prepareSignUpState_fn;
 if (typeof global !== "undefined") {
   global.Buffer = global.Buffer || import_buffer.Buffer;
 } else if (typeof window !== "undefined") {
@@ -935,11 +935,59 @@ const _ParaCore = class _ParaCore {
    */
   setExternalWallet(externalWallet) {
     return __async(this, null, function* () {
+      const { id: partnerId, supportedWalletTypes } = yield __privateMethod(this, _ParaCore_instances, assertPartner_fn).call(this);
       this.externalWallets = (Array.isArray(externalWallet) ? externalWallet : [externalWallet]).reduce(
+        (acc, {
+          partnerId: wPartnerId,
+          address,
+          type,
+          provider,
+          providerId,
+          addressBech32,
+          withFullParaAuth,
+          isConnectionOnly,
+          withVerification
+        }) => {
+          if (partnerId === wPartnerId && supportedWalletTypes.some(({ type: supportedType }) => supportedType === type)) {
+            return __spreadProps(__spreadValues({}, acc), {
+              [address]: {
+                id: address,
+                partnerId,
+                address: addressBech32 != null ? addressBech32 : address,
+                type,
+                name: provider,
+                isExternal: true,
+                isExternalWithParaAuth: withFullParaAuth,
+                externalProviderId: providerId,
+                signer: "",
+                isExternalConnectionOnly: isConnectionOnly,
+                isExternalWithVerification: withVerification
+              }
+            });
+          }
+          return acc;
+        },
+        {}
+      ), this.setExternalWallets(this.externalWallets);
+      (0, import_utils2.dispatchEvent)(import_types.ParaEvent.EXTERNAL_WALLET_CHANGE_EVENT, null);
+    });
+  }
+  addExternalWallets(externalWallets) {
+    return __async(this, null, function* () {
+      const { id: partnerId, supportedWalletTypes } = yield __privateMethod(this, _ParaCore_instances, assertPartner_fn).call(this);
+      this.externalWallets = __spreadValues(__spreadValues({}, Object.entries(this.externalWallets).reduce((acc, [address, wallet]) => {
+        if (partnerId === wallet.partnerId && supportedWalletTypes.some(({ type }) => type === wallet.type)) {
+          return __spreadProps(__spreadValues({}, acc), {
+            [address]: wallet
+          });
+        }
+        return acc;
+      }, {})), externalWallets.reduce(
         (acc, { address, type, provider, providerId, addressBech32, withFullParaAuth, isConnectionOnly, withVerification }) => {
           return __spreadProps(__spreadValues({}, acc), {
             [address]: {
               id: address,
+              partnerId,
               address: addressBech32 != null ? addressBech32 : address,
               type,
               name: provider,
@@ -953,7 +1001,7 @@ const _ParaCore = class _ParaCore {
           });
         },
         {}
-      );
+      ));
       this.setExternalWallets(this.externalWallets);
       (0, import_utils2.dispatchEvent)(import_types.ParaEvent.EXTERNAL_WALLET_CHANGE_EVENT, null);
     });
@@ -1307,7 +1355,7 @@ const _ParaCore = class _ParaCore {
       ]);
       const externalWallets = Array.isArray(externalWallet) ? externalWallet : [externalWallet];
       if (this.externalWalletConnectionOnly || externalWallets.every((wallet) => wallet.isConnectionOnly)) {
-        yield this.setExternalWallet(
+        yield this.addExternalWallets(
           externalWallets.map((wallet) => __spreadProps(__spreadValues({}, wallet), {
             withFullParaAuth: false
           }))
@@ -1510,6 +1558,9 @@ const _ParaCore = class _ParaCore {
   isFullyLoggedIn() {
     return __async(this, null, function* () {
       if (this.externalWalletConnectionType === "CONNECTION_ONLY") {
+        if (!this.isReady) {
+          yield this.ready();
+        }
         return true;
       }
       if (this.isGuestMode) {
@@ -1714,9 +1765,14 @@ const _ParaCore = class _ParaCore {
   }
   getOAuthUrl(opts) {
     return __async(this, null, function* () {
-      return __privateMethod(this, _ParaCore_instances, getOAuthUrl_fn).call(this, opts);
+      var _a;
+      const sessionLookupId = (_a = opts.sessionLookupId) != null ? _a : yield this.prepareLogin();
+      return __privateMethod(this, _ParaCore_instances, getOAuthUrl_fn).call(this, __spreadProps(__spreadValues({}, opts), { sessionLookupId }));
     });
   }
+  getOAuthUrlSync(opts) {
+    return __privateMethod(this, _ParaCore_instances, getOAuthUrl_fn).call(this, opts);
+  }
   /**
    * 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.
@@ -1725,9 +1781,9 @@ const _ParaCore = class _ParaCore {
    * @param {Window} [opts.popupWindow] the popup window being used for login.
    * @return {Object} `{ email?: string; isError?: boolean; userExists: boolean; }` the result data
    */
-  verifyOAuthProcess(_k) {
+  verifyOAuthProcess(_i) {
     return __async(this, null, function* () {
-      var _l = _k, {
+      var _j = _i, {
         method,
         appScheme,
         isCanceled = () => false,
@@ -1735,7 +1791,7 @@ const _ParaCore = class _ParaCore {
         onPoll,
         onOAuthUrl,
         isLinkAccount
-      } = _l, urlOptions = __objRest(_l, [
+      } = _j, urlOptions = __objRest(_j, [
         "method",
         "appScheme",
         "isCanceled",
@@ -1750,7 +1806,7 @@ const _ParaCore = class _ParaCore {
           accountLinkInProgress = yield __privateMethod(this, _ParaCore_instances, assertIsLinkingAccountOrStart_fn).call(this, method);
           sessionLookupId = (yield this.touchSession()).sessionLookupId;
         } else {
-          sessionLookupId = yield __privateMethod(this, _ParaCore_instances, prepareLogin_fn).call(this);
+          sessionLookupId = yield this.prepareLogin();
         }
         const oAuthUrl = yield __privateMethod(this, _ParaCore_instances, getOAuthUrl_fn).call(this, { method, appScheme, sessionLookupId, accountLinkInProgress });
         onOAuthUrl(oAuthUrl);
@@ -2433,12 +2489,12 @@ const _ParaCore = class _ParaCore {
       });
     });
   }
-  getOnRampTransactionUrl(_m) {
+  getOnRampTransactionUrl(_k) {
     return __async(this, null, function* () {
-      var _n = _m, {
+      var _l = _k, {
         purchaseId,
         providerKey
-      } = _n, walletParams = __objRest(_n, [
+      } = _l, walletParams = __objRest(_l, [
         "purchaseId",
         "providerKey"
       ]);
@@ -2924,9 +2980,19 @@ const _ParaCore = class _ParaCore {
       });
     });
   }
-  signUpOrLogIn(_o) {
+  prepareLogin() {
     return __async(this, null, function* () {
-      var _p = _o, { auth } = _p, urlOptions = __objRest(_p, ["auth"]);
+      yield this.logout();
+      const { sessionLookupId } = yield this.touchSession(true);
+      if (!this.loginEncryptionKeyPair) {
+        yield this.setLoginEncryptionKeyPair();
+      }
+      return sessionLookupId;
+    });
+  }
+  signUpOrLogIn(_m) {
+    return __async(this, null, function* () {
+      var _n = _m, { auth } = _n, urlOptions = __objRest(_n, ["auth"]);
       const serverAuthState = yield this.ctx.client.signUpOrLogIn(__spreadValues(__spreadValues({}, auth), this.getVerificationEmailProps()));
       const authInfo = serverAuthState.auth;
       if (this.fetchPregenWalletsOverride && (0, import_user_management_client.isPregenAuth)(authInfo)) {
@@ -2938,11 +3004,11 @@ const _ParaCore = class _ParaCore {
       return __privateMethod(this, _ParaCore_instances, prepareAuthState_fn).call(this, serverAuthState, urlOptions);
     });
   }
-  verifyNewAccount(_q) {
+  verifyNewAccount(_o) {
     return __async(this, null, function* () {
-      var _r = _q, {
+      var _p = _o, {
         verificationCode
-      } = _r, urlOptions = __objRest(_r, [
+      } = _p, urlOptions = __objRest(_p, [
         "verificationCode"
       ]);
       this.assertIsAuthSet(["email", "phone"]);
@@ -3036,10 +3102,10 @@ const _ParaCore = class _ParaCore {
     });
   }
   verifyLink() {
-    return __async(this, arguments, function* (_s = {}) {
-      var _t = _s, {
+    return __async(this, arguments, function* (_q = {}) {
+      var _r = _q, {
         accountLinkInProgress = __privateMethod(this, _ParaCore_instances, assertIsLinkingAccount_fn).call(this)
-      } = _t, opts = __objRest(_t, [
+      } = _r, opts = __objRest(_r, [
         "accountLinkInProgress"
       ]);
       try {
@@ -3176,30 +3242,30 @@ assertIsLinkingAccountOrStart_fn = function(type) {
     return yield this.linkAccount({ type });
   });
 };
-getOAuthUrl_fn = function(_i) {
-  return __async(this, null, function* () {
-    var _j = _i, {
-      method,
-      appScheme,
-      accountLinkInProgress
-    } = _j, params = __objRest(_j, [
-      "method",
-      "appScheme",
-      "accountLinkInProgress"
-    ]);
-    var _a;
-    const sessionLookupId = (_a = params.sessionLookupId) != null ? _a : yield __privateMethod(this, _ParaCore_instances, prepareLogin_fn).call(this);
-    return (0, import_utils2.constructUrl)({
-      base: (0, import_userManagementClient.getBaseOAuthUrl)(this.ctx.env),
-      path: `/auth/${method}`,
-      params: __spreadValues({
-        apiKey: this.ctx.apiKey,
-        sessionLookupId,
-        appScheme
-      }, accountLinkInProgress ? {
-        linkedAccountId: this.accountLinkInProgress.id
-      } : {})
-    });
+/**
+ * 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.appScheme] the app scheme 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_fn = function({
+  method,
+  appScheme,
+  accountLinkInProgress,
+  sessionLookupId
+}) {
+  return (0, import_utils2.constructUrl)({
+    base: (0, import_userManagementClient.getBaseOAuthUrl)(this.ctx.env),
+    path: `/auth/${method}`,
+    params: __spreadValues({
+      apiKey: this.ctx.apiKey,
+      sessionLookupId,
+      appScheme
+    }, accountLinkInProgress ? {
+      linkedAccountId: this.accountLinkInProgress.id
+    } : {})
   });
 };
 createPregenWallet_fn = function(opts) {
@@ -3253,7 +3319,7 @@ _isCreateGuestWalletsPending = new WeakMap();
 prepareAuthState_fn = function(_0) {
   return __async(this, arguments, function* (serverAuthState, opts = {}) {
     if (!opts.sessionLookupId && serverAuthState.stage === "login") {
-      opts.sessionLookupId = yield __privateMethod(this, _ParaCore_instances, prepareLogin_fn).call(this);
+      opts.sessionLookupId = yield this.prepareLogin();
     }
     const { auth, externalWallet, userId, displayName, pfpUrl, username } = serverAuthState;
     const authInfo = __spreadValues(__spreadValues({}, (0, import_user_management_client.extractAuthInfo)(auth, { isRequired: true })), Object.fromEntries(
@@ -3295,16 +3361,6 @@ prepareAuthState_fn = function(_0) {
     return authState;
   });
 };
-prepareLogin_fn = function() {
-  return __async(this, null, function* () {
-    yield this.logout();
-    const { sessionLookupId } = yield this.touchSession(true);
-    if (!this.loginEncryptionKeyPair) {
-      yield this.setLoginEncryptionKeyPair();
-    }
-    return sessionLookupId;
-  });
-};
 prepareLoginState_fn = function(_0, _1) {
   return __async(this, arguments, function* (loginState, {
     useShortUrls: shorten = false,

package/dist/cjs/constants.js

@@ -40,7 +40,7 @@ __export(constants_exports, {
   SHORT_POLLING_INTERVAL_MS: () => SHORT_POLLING_INTERVAL_MS
 });
 module.exports = __toCommonJS(constants_exports);
-const PARA_CORE_VERSION = "2.0.0-alpha.31";
+const PARA_CORE_VERSION = "2.0.0-alpha.33";
 const PREFIX = "@CAPSULE/";
 const LOCAL_STORAGE_AUTH_INFO = `${PREFIX}authInfo`;
 const LOCAL_STORAGE_EMAIL = `${PREFIX}e-mail`;

package/dist/cjs/types/coreApi.js

@@ -80,7 +80,8 @@ const PARA_INTERNAL_METHODS = [
   "verifyFarcasterLink",
   "verifyTelegramLink",
   "verifyExternalWalletLink",
-  "accountLinkInProgress"
+  "accountLinkInProgress",
+  "prepareLogin"
 ];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/esm/ParaCore.js

@@ -8,7 +8,7 @@ import {
   __spreadProps,
   __spreadValues
 } from "./chunk-7B52C2XE.js";
-var _authInfo, _partner, _ParaCore_instances, assertPartner_fn, guestWalletIds_get, guestWalletIdsArray_get, toAuthInfo_fn, setAuthInfo_fn, getPartner_fn, assertIsLinkingAccount_fn, assertIsLinkingAccountOrStart_fn, getOAuthUrl_fn, createPregenWallet_fn, _isCreateGuestWalletsPending, prepareAuthState_fn, prepareLogin_fn, prepareLoginState_fn, prepareSignUpState_fn;
+var _authInfo, _partner, _ParaCore_instances, assertPartner_fn, guestWalletIds_get, guestWalletIdsArray_get, toAuthInfo_fn, setAuthInfo_fn, getPartner_fn, assertIsLinkingAccount_fn, assertIsLinkingAccountOrStart_fn, getOAuthUrl_fn, createPregenWallet_fn, _isCreateGuestWalletsPending, prepareAuthState_fn, prepareLoginState_fn, prepareSignUpState_fn;
 import { Buffer as NodeBuffer } from "buffer";
 if (typeof global !== "undefined") {
   global.Buffer = global.Buffer || NodeBuffer;
@@ -901,11 +901,59 @@ const _ParaCore = class _ParaCore {
    */
   setExternalWallet(externalWallet) {
     return __async(this, null, function* () {
+      const { id: partnerId, supportedWalletTypes } = yield __privateMethod(this, _ParaCore_instances, assertPartner_fn).call(this);
       this.externalWallets = (Array.isArray(externalWallet) ? externalWallet : [externalWallet]).reduce(
+        (acc, {
+          partnerId: wPartnerId,
+          address,
+          type,
+          provider,
+          providerId,
+          addressBech32,
+          withFullParaAuth,
+          isConnectionOnly,
+          withVerification
+        }) => {
+          if (partnerId === wPartnerId && supportedWalletTypes.some(({ type: supportedType }) => supportedType === type)) {
+            return __spreadProps(__spreadValues({}, acc), {
+              [address]: {
+                id: address,
+                partnerId,
+                address: addressBech32 != null ? addressBech32 : address,
+                type,
+                name: provider,
+                isExternal: true,
+                isExternalWithParaAuth: withFullParaAuth,
+                externalProviderId: providerId,
+                signer: "",
+                isExternalConnectionOnly: isConnectionOnly,
+                isExternalWithVerification: withVerification
+              }
+            });
+          }
+          return acc;
+        },
+        {}
+      ), this.setExternalWallets(this.externalWallets);
+      dispatchEvent(ParaEvent.EXTERNAL_WALLET_CHANGE_EVENT, null);
+    });
+  }
+  addExternalWallets(externalWallets) {
+    return __async(this, null, function* () {
+      const { id: partnerId, supportedWalletTypes } = yield __privateMethod(this, _ParaCore_instances, assertPartner_fn).call(this);
+      this.externalWallets = __spreadValues(__spreadValues({}, Object.entries(this.externalWallets).reduce((acc, [address, wallet]) => {
+        if (partnerId === wallet.partnerId && supportedWalletTypes.some(({ type }) => type === wallet.type)) {
+          return __spreadProps(__spreadValues({}, acc), {
+            [address]: wallet
+          });
+        }
+        return acc;
+      }, {})), externalWallets.reduce(
         (acc, { address, type, provider, providerId, addressBech32, withFullParaAuth, isConnectionOnly, withVerification }) => {
           return __spreadProps(__spreadValues({}, acc), {
             [address]: {
               id: address,
+              partnerId,
               address: addressBech32 != null ? addressBech32 : address,
               type,
               name: provider,
@@ -919,7 +967,7 @@ const _ParaCore = class _ParaCore {
           });
         },
         {}
-      );
+      ));
       this.setExternalWallets(this.externalWallets);
       dispatchEvent(ParaEvent.EXTERNAL_WALLET_CHANGE_EVENT, null);
     });
@@ -1273,7 +1321,7 @@ const _ParaCore = class _ParaCore {
       ]);
       const externalWallets = Array.isArray(externalWallet) ? externalWallet : [externalWallet];
       if (this.externalWalletConnectionOnly || externalWallets.every((wallet) => wallet.isConnectionOnly)) {
-        yield this.setExternalWallet(
+        yield this.addExternalWallets(
           externalWallets.map((wallet) => __spreadProps(__spreadValues({}, wallet), {
             withFullParaAuth: false
           }))
@@ -1476,6 +1524,9 @@ const _ParaCore = class _ParaCore {
   isFullyLoggedIn() {
     return __async(this, null, function* () {
       if (this.externalWalletConnectionType === "CONNECTION_ONLY") {
+        if (!this.isReady) {
+          yield this.ready();
+        }
         return true;
       }
       if (this.isGuestMode) {
@@ -1680,9 +1731,14 @@ const _ParaCore = class _ParaCore {
   }
   getOAuthUrl(opts) {
     return __async(this, null, function* () {
-      return __privateMethod(this, _ParaCore_instances, getOAuthUrl_fn).call(this, opts);
+      var _a;
+      const sessionLookupId = (_a = opts.sessionLookupId) != null ? _a : yield this.prepareLogin();
+      return __privateMethod(this, _ParaCore_instances, getOAuthUrl_fn).call(this, __spreadProps(__spreadValues({}, opts), { sessionLookupId }));
     });
   }
+  getOAuthUrlSync(opts) {
+    return __privateMethod(this, _ParaCore_instances, getOAuthUrl_fn).call(this, opts);
+  }
   /**
    * 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.
@@ -1691,9 +1747,9 @@ const _ParaCore = class _ParaCore {
    * @param {Window} [opts.popupWindow] the popup window being used for login.
    * @return {Object} `{ email?: string; isError?: boolean; userExists: boolean; }` the result data
    */
-  verifyOAuthProcess(_k) {
+  verifyOAuthProcess(_i) {
     return __async(this, null, function* () {
-      var _l = _k, {
+      var _j = _i, {
         method,
         appScheme,
         isCanceled = () => false,
@@ -1701,7 +1757,7 @@ const _ParaCore = class _ParaCore {
         onPoll,
         onOAuthUrl,
         isLinkAccount
-      } = _l, urlOptions = __objRest(_l, [
+      } = _j, urlOptions = __objRest(_j, [
         "method",
         "appScheme",
         "isCanceled",
@@ -1716,7 +1772,7 @@ const _ParaCore = class _ParaCore {
           accountLinkInProgress = yield __privateMethod(this, _ParaCore_instances, assertIsLinkingAccountOrStart_fn).call(this, method);
           sessionLookupId = (yield this.touchSession()).sessionLookupId;
         } else {
-          sessionLookupId = yield __privateMethod(this, _ParaCore_instances, prepareLogin_fn).call(this);
+          sessionLookupId = yield this.prepareLogin();
         }
         const oAuthUrl = yield __privateMethod(this, _ParaCore_instances, getOAuthUrl_fn).call(this, { method, appScheme, sessionLookupId, accountLinkInProgress });
         onOAuthUrl(oAuthUrl);
@@ -2399,12 +2455,12 @@ const _ParaCore = class _ParaCore {
       });
     });
   }
-  getOnRampTransactionUrl(_m) {
+  getOnRampTransactionUrl(_k) {
     return __async(this, null, function* () {
-      var _n = _m, {
+      var _l = _k, {
         purchaseId,
         providerKey
-      } = _n, walletParams = __objRest(_n, [
+      } = _l, walletParams = __objRest(_l, [
         "purchaseId",
         "providerKey"
       ]);
@@ -2890,9 +2946,19 @@ const _ParaCore = class _ParaCore {
       });
     });
   }
-  signUpOrLogIn(_o) {
+  prepareLogin() {
     return __async(this, null, function* () {
-      var _p = _o, { auth } = _p, urlOptions = __objRest(_p, ["auth"]);
+      yield this.logout();
+      const { sessionLookupId } = yield this.touchSession(true);
+      if (!this.loginEncryptionKeyPair) {
+        yield this.setLoginEncryptionKeyPair();
+      }
+      return sessionLookupId;
+    });
+  }
+  signUpOrLogIn(_m) {
+    return __async(this, null, function* () {
+      var _n = _m, { auth } = _n, urlOptions = __objRest(_n, ["auth"]);
       const serverAuthState = yield this.ctx.client.signUpOrLogIn(__spreadValues(__spreadValues({}, auth), this.getVerificationEmailProps()));
       const authInfo = serverAuthState.auth;
       if (this.fetchPregenWalletsOverride && isPregenAuth(authInfo)) {
@@ -2904,11 +2970,11 @@ const _ParaCore = class _ParaCore {
       return __privateMethod(this, _ParaCore_instances, prepareAuthState_fn).call(this, serverAuthState, urlOptions);
     });
   }
-  verifyNewAccount(_q) {
+  verifyNewAccount(_o) {
     return __async(this, null, function* () {
-      var _r = _q, {
+      var _p = _o, {
         verificationCode
-      } = _r, urlOptions = __objRest(_r, [
+      } = _p, urlOptions = __objRest(_p, [
         "verificationCode"
       ]);
       this.assertIsAuthSet(["email", "phone"]);
@@ -3002,10 +3068,10 @@ const _ParaCore = class _ParaCore {
     });
   }
   verifyLink() {
-    return __async(this, arguments, function* (_s = {}) {
-      var _t = _s, {
+    return __async(this, arguments, function* (_q = {}) {
+      var _r = _q, {
         accountLinkInProgress = __privateMethod(this, _ParaCore_instances, assertIsLinkingAccount_fn).call(this)
-      } = _t, opts = __objRest(_t, [
+      } = _r, opts = __objRest(_r, [
         "accountLinkInProgress"
       ]);
       try {
@@ -3142,30 +3208,30 @@ assertIsLinkingAccountOrStart_fn = function(type) {
     return yield this.linkAccount({ type });
   });
 };
-getOAuthUrl_fn = function(_i) {
-  return __async(this, null, function* () {
-    var _j = _i, {
-      method,
-      appScheme,
-      accountLinkInProgress
-    } = _j, params = __objRest(_j, [
-      "method",
-      "appScheme",
-      "accountLinkInProgress"
-    ]);
-    var _a;
-    const sessionLookupId = (_a = params.sessionLookupId) != null ? _a : yield __privateMethod(this, _ParaCore_instances, prepareLogin_fn).call(this);
-    return constructUrl({
-      base: getBaseOAuthUrl(this.ctx.env),
-      path: `/auth/${method}`,
-      params: __spreadValues({
-        apiKey: this.ctx.apiKey,
-        sessionLookupId,
-        appScheme
-      }, accountLinkInProgress ? {
-        linkedAccountId: this.accountLinkInProgress.id
-      } : {})
-    });
+/**
+ * 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.appScheme] the app scheme 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_fn = function({
+  method,
+  appScheme,
+  accountLinkInProgress,
+  sessionLookupId
+}) {
+  return constructUrl({
+    base: getBaseOAuthUrl(this.ctx.env),
+    path: `/auth/${method}`,
+    params: __spreadValues({
+      apiKey: this.ctx.apiKey,
+      sessionLookupId,
+      appScheme
+    }, accountLinkInProgress ? {
+      linkedAccountId: this.accountLinkInProgress.id
+    } : {})
   });
 };
 createPregenWallet_fn = function(opts) {
@@ -3219,7 +3285,7 @@ _isCreateGuestWalletsPending = new WeakMap();
 prepareAuthState_fn = function(_0) {
   return __async(this, arguments, function* (serverAuthState, opts = {}) {
     if (!opts.sessionLookupId && serverAuthState.stage === "login") {
-      opts.sessionLookupId = yield __privateMethod(this, _ParaCore_instances, prepareLogin_fn).call(this);
+      opts.sessionLookupId = yield this.prepareLogin();
     }
     const { auth, externalWallet, userId, displayName, pfpUrl, username } = serverAuthState;
     const authInfo = __spreadValues(__spreadValues({}, extractAuthInfo(auth, { isRequired: true })), Object.fromEntries(
@@ -3261,16 +3327,6 @@ prepareAuthState_fn = function(_0) {
     return authState;
   });
 };
-prepareLogin_fn = function() {
-  return __async(this, null, function* () {
-    yield this.logout();
-    const { sessionLookupId } = yield this.touchSession(true);
-    if (!this.loginEncryptionKeyPair) {
-      yield this.setLoginEncryptionKeyPair();
-    }
-    return sessionLookupId;
-  });
-};
 prepareLoginState_fn = function(_0, _1) {
   return __async(this, arguments, function* (loginState, {
     useShortUrls: shorten = false,

package/dist/esm/constants.js

@@ -1,5 +1,5 @@
 import "./chunk-7B52C2XE.js";
-const PARA_CORE_VERSION = "2.0.0-alpha.31";
+const PARA_CORE_VERSION = "2.0.0-alpha.33";
 const PREFIX = "@CAPSULE/";
 const LOCAL_STORAGE_AUTH_INFO = `${PREFIX}authInfo`;
 const LOCAL_STORAGE_EMAIL = `${PREFIX}e-mail`;

package/dist/esm/types/coreApi.js

@@ -58,7 +58,8 @@ const PARA_INTERNAL_METHODS = [
   "verifyFarcasterLink",
   "verifyTelegramLink",
   "verifyExternalWalletLink",
-  "accountLinkInProgress"
+  "accountLinkInProgress",
+  "prepareLogin"
 ];
 export {
   PARA_CORE_METHODS,

package/dist/types/ParaCore.d.ts

@@ -206,7 +206,12 @@ export declare abstract class ParaCore implements CoreInterface {
      * Init only needs to be called for storage that is async.
      */
     init(): Promise<void>;
-    protected abstract ready(): Promise<void>;
+    /**
+     * Call this method to perform initial setup for the `ParaCore` instance.
+     *
+     * This method will be called automatically if you use the React `ParaProvider` or when you call any methods that request an updated session.
+     */
+    abstract ready(): Promise<void>;
     protected setAuth(auth: PrimaryAuth, { extras, userId }?: {
         extras?: AuthExtras;
         userId?: string;
@@ -240,6 +245,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * @param externalType - Type of external wallet to set.
      */
     setExternalWallet(externalWallet: ExternalWalletInfo[] | ExternalWalletInfo): Promise<void>;
+    protected addExternalWallets(externalWallets: ExternalWalletInfo[]): Promise<void>;
     /**
      * Sets the user id associated with the `ParaCore` instance.
      * @param userId - User id to set.
@@ -423,6 +429,9 @@ export declare abstract class ParaCore implements CoreInterface {
     verifyFarcaster(opts: CoreMethodParams<'verifyFarcaster'>): CoreMethodResponse<'verifyFarcaster'>;
     protected verifyFarcasterLink(opts: InternalMethodParams<'verifyFarcasterLink'>): InternalMethodResponse<'verifyFarcasterLink'>;
     getOAuthUrl(opts: CoreMethodParams<'getOAuthUrl'>): CoreMethodResponse<'getOAuthUrl'>;
+    getOAuthUrlSync(opts: Omit<CoreMethodParams<'getOAuthUrl'>, 'sessionLookupId'> & {
+        sessionLookupId: string;
+    }): Awaited<CoreMethodResponse<'getOAuthUrl'>>;
     protected verifyOAuthProcess(_: InternalMethodParams<'verifyOAuthLink'> & {
         isLinkAccount: true;
     }): InternalMethodResponse<'verifyOAuthLink'>;
@@ -676,6 +685,7 @@ export declare abstract class ParaCore implements CoreInterface {
      * @returns {SignUpOrLogInResponse} an object in the form of either: `{ stage: 'verify' }` or `{ stage: 'login'; passkeyUrl?: string; passwordUrl?: string; biometricHints?: BiometricLocationHint[] }`
      */
     protected getLoginUrl({ authMethod, shorten, portalTheme, sessionId, }: LoginUrlParams): Promise<string>;
+    protected prepareLogin(): InternalMethodResponse<'prepareLogin'>;
     signUpOrLogIn({ auth, ...urlOptions }: CoreMethodParams<'signUpOrLogIn'>): CoreMethodResponse<'signUpOrLogIn'>;
     verifyNewAccount({ verificationCode, ...urlOptions }: CoreMethodParams<'verifyNewAccount'>): CoreMethodResponse<'verifyNewAccount'>;
     getLinkedAccounts({ withMetadata, }?: CoreMethodParams<'getLinkedAccounts'>): CoreMethodResponse<'getLinkedAccounts'>;

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

@@ -4,7 +4,7 @@ import { ParaCore } from '../ParaCore.js';
 import { FullSignatureRes, Wallet } from './wallet.js';
 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 declare const PARA_INTERNAL_METHODS: readonly ["linkAccount", "unlinkAccount", "verifyEmailOrPhoneLink", "verifyOAuthLink", "verifyFarcasterLink", "verifyTelegramLink", "verifyExternalWalletLink", "accountLinkInProgress", "prepareLogin"];
 export type CoreMethodName = (typeof PARA_CORE_METHODS)[number];
 export type CoreMethodParams<method extends CoreMethodName & keyof CoreMethods> = CoreMethods[method] extends {
     params: infer P;
@@ -522,6 +522,10 @@ export type InternalMethods = {
         params: Omit<VerifyExternalWalletParams, 'externalWallet'>;
         response: LinkedAccounts;
     };
+    prepareLogin: {
+        params: void;
+        response: string;
+    };
 };
 export type CoreInterface = {
     [key in keyof CoreMethods]: Partial<CoreMethod<key>>;

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@getpara/core-sdk",
-  "version": "2.0.0-alpha.31",
+  "version": "2.0.0-alpha.33",
   "dependencies": {
     "@celo/utils": "^8.0.2",
     "@cosmjs/encoding": "^0.32.4",
     "@ethereumjs/util": "^9.1.0",
-    "@getpara/user-management-client": "2.0.0-alpha.31",
+    "@getpara/user-management-client": "2.0.0-alpha.33",
     "@noble/hashes": "^1.5.0",
     "base64url": "^3.0.1",
     "libphonenumber-js": "^1.11.7",
@@ -27,7 +27,7 @@
     "dist",
     "package.json"
   ],
-  "gitHead": "54aac22b2d0b4cc730ab7f2e82cdd8a96729b039",
+  "gitHead": "f338306fa30497d2190f8da2ff72ddd8d9d9032f",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "scripts": {