@getpara/user-management-client 1.7.1 → 2.0.0-alpha.3

package/dist/cjs/index.js

@@ -78,6 +78,7 @@ var __async = (__this, __arguments, generator) => {
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  AUTH_TYPES: () => AUTH_TYPES,
   AuthMethod: () => AuthMethod,
   Chain: () => Chain,
   EmailTheme: () => EmailTheme,
@@ -91,6 +92,7 @@ __export(src_exports, {
   OnRampPurchaseStatus: () => OnRampPurchaseStatus,
   OnRampPurchaseType: () => OnRampPurchaseType,
   PREGEN_IDENTIFIER_TYPES: () => PREGEN_IDENTIFIER_TYPES,
+  ParaApiError: () => ParaApiError,
   PasswordStatus: () => PasswordStatus,
   PublicKeyStatus: () => PublicKeyStatus,
   PublicKeyType: () => PublicKeyType,
@@ -101,14 +103,23 @@ __export(src_exports, {
   extractWalletRef: () => extractWalletRef,
   handleResponseError: () => handleResponseError,
   handleResponseSuccess: () => handleResponseSuccess,
+  isCustomId: () => isCustomId,
+  isDiscord: () => isDiscord,
   isEmail: () => isEmail,
   isExternalWallet: () => isExternalWallet,
   isExternalWalletAddress: () => isExternalWalletAddress,
   isFarcaster: () => isFarcaster,
   isPhone: () => isPhone,
+  isPhoneLegacy: () => isPhoneLegacy,
+  isPregenAuth: () => isPregenAuth,
+  isPrimary: () => isPrimary,
   isTelegram: () => isTelegram,
   isUserId: () => isUserId,
-  isWalletId: () => isWalletId
+  isVerifiedAuth: () => isVerifiedAuth,
+  isWalletId: () => isWalletId,
+  isX: () => isX,
+  toPregenIds: () => toPregenIds,
+  toPregenTypeAndId: () => toPregenTypeAndId
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -117,6 +128,7 @@ var import_axios = __toESM(require("axios"));
 var import_qs = __toESM(require("qs"));
 
 // src/utils.ts
+var import_libphonenumber_js = __toESM(require("libphonenumber-js"));
 function isWalletId(params) {
   return !!params.walletId && !params.externalWalletAddress;
 }
@@ -135,63 +147,143 @@ function isValid(s) {
   return !!s && s !== "null" && s !== "undefined" && s !== "";
 }
 function isEmail(params) {
-  return isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId) && !isValid(params.externalWalletUserId);
+  return !!params && isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId) && !isValid(params.xUsername) && !isValid(params.discordUsername) && !isValid(params.customId) && !isValid(params.externalWalletAddress);
 }
 function isPhone(params) {
-  return isValid(params.phone) && isValid(params.countryCode) && !isValid(params.email) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId) && !isValid(params.externalWalletUserId);
+  return !!params && isValid(params.phone) && /^\+\d+$/.test(params.phone) && !isValid(params.countryCode) && !isValid(params.email) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId) && !isValid(params.xUsername) && !isValid(params.discordUsername) && !isValid(params.customId) && !isValid(params.userId) && !isValid(params.externalWalletAddress);
+}
+function isPhoneLegacy(params) {
+  return !!params && isValid(params.phone) && isValid(params.countryCode) && !isValid(params.email) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId) && !isValid(params.xUsername) && !isValid(params.discordUsername) && !isValid(params.customId) && !isValid(params.externalWalletAddress);
 }
 function isFarcaster(params) {
-  return isValid(params.farcasterUsername) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.telegramUserId) && !isValid(params.externalWalletUserId);
+  return !!params && isValid(params.farcasterUsername) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.telegramUserId) && !isValid(params.xUsername) && !isValid(params.discordUsername) && !isValid(params.customId) && !isValid(params.externalWalletAddress);
 }
 function isTelegram(params) {
-  return isValid(params.telegramUserId) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.externalWalletUserId);
+  return !!params && isValid(params.telegramUserId) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.xUsername) && !isValid(params.discordUsername) && !isValid(params.customId) && !isValid(params.externalWalletAddress);
+}
+function isExternalWallet(params) {
+  return !!params && isValid(params.externalWalletAddress) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId) && !isValid(params.xUsername) && !isValid(params.discordUsername) && !isValid(params.customId);
+}
+function isX(params) {
+  return !!params && isValid(params.xUsername) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId) && !isValid(params.discordUsername) && !isValid(params.customId) && !isValid(params.externalWalletAddress);
+}
+function isDiscord(params) {
+  return !!params && isValid(params.discordUsername) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId) && !isValid(params.xUsername) && !isValid(params.customId) && !isValid(params.externalWalletAddress);
+}
+function isCustomId(params) {
+  return !!params && isValid(params.customId) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId) && !isValid(params.xUsername) && !isValid(params.discordUsername) && !isValid(params.externalWalletAddress);
 }
 function isUserId(params) {
-  return isValid(params.userId) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId) && !isValid(params.externalWalletUserId);
+  return !!params && isValid(params.userId) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.xUsername) && !isValid(params.discordUsername) && !isValid(params.customId) && !isValid(params.telegramUserId) && !isValid(params.externalWalletAddress);
 }
-function isExternalWallet(params) {
-  return isValid(params.externalWalletAddress) && !isValid(params.email) && !isValid(params.phone) && !isValid(params.countryCode) && !isValid(params.farcasterUsername) && !isValid(params.telegramUserId);
+function isPrimary(params) {
+  return isEmail(params) || isPhone(params) || isFarcaster(params) || isTelegram(params) || isExternalWallet(params);
+}
+function isVerifiedAuth(params) {
+  return isEmail(params) || isPhone(params);
 }
-function extractAuthInfo(obj, { allowUserId = false, isRequired = false } = {}) {
+function isPregenAuth(params) {
+  return isPrimary(params) && !isExternalWallet(params) || isX(params) || isDiscord(params) || isCustomId(params);
+}
+function extractAuthInfo(obj, { allowUserId = false, allowPregen = false, isRequired = false } = {}) {
+  obj = Object.entries(obj || {}).reduce((acc, [k, v]) => {
+    return __spreadValues(__spreadValues({}, acc), !!v && v !== "null" && v !== "undefined" && v !== "" ? { [k]: v } : {});
+  }, {});
+  let error;
   switch (true) {
     case isEmail(obj):
-      return { auth: { email: obj.email }, authType: "email", identifier: obj.email, publicKeyIdentifier: obj.email };
+      return {
+        auth: { email: obj.email },
+        authType: "email",
+        identifier: obj.email
+      };
     case isPhone(obj):
+      if (!(0, import_libphonenumber_js.default)(obj.phone)) {
+        error = "invalid phone number";
+        break;
+      }
       return {
-        auth: { phone: obj.phone, countryCode: obj.countryCode },
+        auth: { phone: obj.phone },
         authType: "phone",
-        identifier: `${obj.countryCode}${obj.phone}`,
-        publicKeyIdentifier: `${obj.countryCode}${obj.phone}`
+        identifier: obj.phone
+      };
+    case isPhoneLegacy(obj):
+      const identifier = `${obj.countryCode.startsWith("+") ? "" : "+"}${obj.countryCode}${obj.phone}`;
+      if (!(0, import_libphonenumber_js.default)(identifier)) {
+        error = "invalid phone number";
+        break;
+      }
+      return {
+        auth: { phone: identifier },
+        authType: "phone",
+        identifier
       };
     case isFarcaster(obj):
       return {
         auth: { farcasterUsername: obj.farcasterUsername },
         authType: "farcaster",
-        identifier: obj.farcasterUsername,
-        publicKeyIdentifier: `${obj.farcasterUsername}-farcaster`
+        identifier: obj.farcasterUsername
       };
     case isTelegram(obj):
       return {
         auth: { telegramUserId: obj.telegramUserId },
         authType: "telegram",
-        identifier: obj.telegramUserId,
-        publicKeyIdentifier: `${obj.telegramUserId}-telegram`
+        identifier: obj.telegramUserId
       };
     case isExternalWallet(obj):
       return {
         auth: { externalWalletAddress: obj.externalWalletAddress },
         authType: "externalWallet",
-        identifier: obj.externalWalletAddress,
-        publicKeyIdentifier: `${obj.externalWalletAddress}-external-wallet`
+        identifier: obj.externalWalletAddress
+      };
+    case (allowPregen && isX(obj)):
+      return {
+        auth: { xUsername: obj.xUsername },
+        authType: "x",
+        identifier: obj.xUsername
+      };
+    case (allowPregen && isDiscord(obj)):
+      return {
+        auth: { discordUsername: obj.discordUsername },
+        authType: "discord",
+        identifier: obj.discordUsername
+      };
+    case (allowPregen && isCustomId(obj)):
+      return {
+        auth: { customId: obj.customId },
+        authType: "customId",
+        identifier: obj.customId
       };
     case (isUserId(obj) && allowUserId):
-      return { auth: { userId: obj.userId }, authType: "userId", identifier: obj.userId, publicKeyIdentifier: obj.userId };
+      return {
+        auth: { userId: obj.userId },
+        authType: "userId",
+        identifier: obj.userId
+      };
     default:
-      if (isRequired) {
-        throw new Error("invalid auth object");
-      }
-      return void 0;
+      break;
+  }
+  if (isRequired) {
+    throw new Error(error != null ? error : "invalid auth object");
   }
+  return void 0;
+}
+function toPregenTypeAndId(auth) {
+  const { authType, identifier: pregenIdentifier } = extractAuthInfo(auth, { isRequired: true, allowPregen: true });
+  const pregenIdentifierType = {
+    email: "EMAIL",
+    phone: "PHONE",
+    farcaster: "FARCASTER",
+    telegram: "TELEGRAM",
+    discord: "DISCORD",
+    x: "TWITTER",
+    customId: "CUSTOM_ID"
+  }[authType];
+  return [pregenIdentifierType, pregenIdentifier];
+}
+function toPregenIds(auth) {
+  const [pregenIdentifierType, pregenIdentifier] = toPregenTypeAndId(auth);
+  return { [pregenIdentifierType]: [pregenIdentifier] };
 }
 
 // src/consts.ts
@@ -248,6 +340,13 @@ var Client = class {
     retrieveSessionCookie,
     persistSessionCookie
   }) {
+    this.signUpOrLogIn = (body) => __async(this, null, function* () {
+      const res = yield this.baseRequest.post(`/users/init`, body);
+      return res.data;
+    });
+    /**
+     * @deprecated
+     */
     this.createUser = (body) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/users`, body);
       return res.data;
@@ -259,26 +358,46 @@ var Client = class {
       return res;
     });
     this.verifyTelegram = (authObject) => __async(this, null, function* () {
-      return (yield this.baseRequest.post("/users/telegram", {
+      return (yield this.baseRequest.post("/users/telegram/v2", {
         authObject
       })).data;
     });
-    this.externalWalletLogin = (body) => __async(this, null, function* () {
-      const res = yield this.baseRequest.post(`/users/external-wallets/login`, body);
+    this.verifyOAuth = () => __async(this, null, function* () {
+      const res = yield this.baseRequest.post("/users/verify-oauth");
+      return res.data;
+    });
+    this.loginExternalWallet = (_0) => __async(this, [_0], function* ({
+      externalWallet,
+      shouldTrackUser
+    }) {
+      const res = yield this.baseRequest.post(`/users/external-wallets/login/v2`, {
+        externalWallet,
+        shouldTrackUser
+      });
+      return res.data;
+    });
+    this.verifyNewAccount = (userId, body) => __async(this, null, function* () {
+      const res = yield this.baseRequest.post(`/users/${userId}/verify`, body);
       return res.data;
     });
     // POST /users/:userId/verify-email
+    /**
+     * @deprecated
+     */
     this.verifyEmail = (userId, body) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/users/${userId}/verify-email`, body);
       return res;
     });
+    /**
+     * @deprecated
+     */
     this.verifyPhone = (userId, body) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/users/${userId}/verify-identifier`, body);
       return res;
     });
     this.verifyExternalWallet = (userId, body) => __async(this, null, function* () {
-      const res = yield this.baseRequest.post(`/users/${userId}/external-wallets/verify`, body);
-      return res;
+      const res = yield this.baseRequest.post(`/users/${userId}/external-wallets/verify/v2`, body);
+      return res.data;
     });
     // POST /users/:userId/biometrics/key
     this.addSessionPublicKey = (userId, body) => __async(this, null, function* () {
@@ -291,8 +410,10 @@ var Client = class {
       return res;
     });
     // GET /biometrics/location-hints
-    this.getBiometricLocationHints = (params) => __async(this, null, function* () {
-      const res = yield this.baseRequest.get(`/biometrics/location-hints`, { params });
+    this.getBiometricLocationHints = (auth) => __async(this, null, function* () {
+      const res = yield this.baseRequest.get(`/biometrics/location-hints`, {
+        params: auth
+      });
       return res.data.hints;
     });
     // GET /users/:userId/biometrics/:biometricId
@@ -318,10 +439,8 @@ var Client = class {
     });
     // POST /touch
     this.touchSession = (regenerate) => __async(this, null, function* () {
-      const res = yield this.baseRequest.post(
-        `/touch?regenerate=${!!regenerate}`
-      );
-      return res;
+      const res = yield this.baseRequest.post(`/touch?regenerate=${!!regenerate}`);
+      return res.data;
     });
     // GET /session/origin
     this.sessionOrigin = (sessionLookupId) => __async(this, null, function* () {
@@ -357,14 +476,12 @@ var Client = class {
       const res = yield this.baseRequest.post(`/wallets/pregen`, body);
       return res.data;
     });
-    // GET /wallets/pregen?pregenIdentifier={pregenIdentifier}&pregenIdentifierType={pregenIdentifierType}
     this.getPregenWallets = (pregenIds, isPortal = false, userId) => __async(this, null, function* () {
       const res = yield this.baseRequest.get("/wallets/pregen", {
         params: { ids: pregenIds, expand: isPortal, userId }
       });
       return res.data;
     });
-    // POST /wallets/pregen/claim
     this.claimPregenWallets = (body) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/wallets/pregen/claim`, body);
       return res.data;
@@ -457,11 +574,9 @@ var Client = class {
       const res = yield this.baseRequest.get(`/users/${userId}/wallets/${walletId}/capsule-share`);
       return res.data.share;
     });
-    // GET /users/:userId/wallets/:walletId/download-backup-kit
-    this.getBackupKit = (userId, walletId) => __async(this, null, function* () {
-      const res = yield this.baseRequest.get(`/users/${userId}/wallets/${walletId}/download-backup-kit`, {
-        responseType: "blob"
-      });
+    // GET /download-backup-kit/:userId
+    this.getBackupKit = (userId) => __async(this, null, function* () {
+      const res = yield this.baseRequest.get(`/download-backup-kit/${userId}`, { responseType: "blob" });
       return res;
     });
     // PATCH /users/:userId/biometrics/:biometricId
@@ -627,11 +742,10 @@ var Client = class {
       return res;
     });
   }
-  // POST '/2fa/users/:userId/setup'
   setup2FA(userId) {
     return __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/2fa/users/${userId}/setup`);
-      return res;
+      return res.data;
     });
   }
   // POST /recovery/init
@@ -648,11 +762,10 @@ var Client = class {
       return res;
     });
   }
-  // POST /auth/farcaster/status
   getFarcasterAuthStatus() {
     return __async(this, null, function* () {
-      const res = yield this.baseRequest.post(`/auth/farcaster/status`);
-      return res;
+      const res = yield this.baseRequest.post(`/auth/farcaster/status/v2`);
+      return res.data;
     });
   }
   // POST /recovery/init
@@ -692,18 +805,20 @@ var Client = class {
       return res;
     });
   }
-  // POST /2fa/verify
-  verify2FA(email, verificationCode) {
+  verify2FA(auth, verificationCode) {
     return __async(this, null, function* () {
-      const body = { email, verificationCode };
+      const body = __spreadProps(__spreadValues({}, auth), { verificationCode });
       const res = yield this.baseRequest.post("/2fa/verify", body);
-      return res;
+      return res.data;
     });
   }
   // POST /2fa/phone/verify
-  verify2FAForPhone(phone, countryCode, verificationCode) {
+  /**
+   * @deprecated
+   */
+  verify2FAForPhone(phone, verificationCode) {
     return __async(this, null, function* () {
-      const body = { phone, countryCode, verificationCode };
+      const body = { phone, verificationCode };
       const res = yield this.baseRequest.post("/2fa/verify", body);
       return res;
     });
@@ -1019,28 +1134,22 @@ var Client = class {
       return res.data;
     });
   }
-  // GET /users/:userId/accounts
-  getAccountMetadata(userId, partnerId) {
-    return __async(this, null, function* () {
-      const res = yield this.baseRequest.get(`/users/${userId}/oauth/accounts`, {
-        params: { partnerId }
-      });
-      return {
-        accountMetadata: Object.entries(res.data.accountMetadata || {}).reduce(
-          (acc, [method, obj]) => __spreadProps(__spreadValues({}, acc), {
-            [method]: __spreadProps(__spreadValues({}, obj), {
-              date: new Date(obj.date)
-            })
-          }),
-          {}
-        )
-      };
-    });
-  }
 };
 var client_default = Client;
 
 // src/types/auth.ts
+var AUTH_TYPES = [
+  "email",
+  "phone",
+  "phoneLegacy",
+  "farcaster",
+  "telegram",
+  "userId",
+  "externalWallet",
+  "discord",
+  "x",
+  "customId"
+];
 var EncryptorType = /* @__PURE__ */ ((EncryptorType2) => {
   EncryptorType2["USER"] = "USER";
   EncryptorType2["RECOVERY"] = "RECOVERY";
@@ -1159,9 +1268,10 @@ var PREGEN_IDENTIFIER_TYPES = [
   "EMAIL",
   "PHONE",
   "CUSTOM_ID",
-  "DISCORD" /* DISCORD */,
-  "TWITTER" /* TWITTER */,
-  "TELEGRAM" /* TELEGRAM */
+  "DISCORD",
+  "TWITTER",
+  "TELEGRAM",
+  "FARCASTER"
 ];
 var NON_ED25519 = ["DKLS" /* DKLS */, "CGGMP" /* CGGMP */];
 
@@ -1169,6 +1279,7 @@ var NON_ED25519 = ["DKLS" /* DKLS */, "CGGMP" /* CGGMP */];
 var src_default = client_default;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AUTH_TYPES,
   AuthMethod,
   Chain,
   EmailTheme,
@@ -1182,6 +1293,7 @@ var src_default = client_default;
   OnRampPurchaseStatus,
   OnRampPurchaseType,
   PREGEN_IDENTIFIER_TYPES,
+  ParaApiError,
   PasswordStatus,
   PublicKeyStatus,
   PublicKeyType,
@@ -1191,12 +1303,21 @@ var src_default = client_default;
   extractWalletRef,
   handleResponseError,
   handleResponseSuccess,
+  isCustomId,
+  isDiscord,
   isEmail,
   isExternalWallet,
   isExternalWalletAddress,
   isFarcaster,
   isPhone,
+  isPhoneLegacy,
+  isPregenAuth,
+  isPrimary,
   isTelegram,
   isUserId,
-  isWalletId
+  isVerifiedAuth,
+  isWalletId,
+  isX,
+  toPregenIds,
+  toPregenTypeAndId
 });