@react-native-kakao/user 3.1.0-next.0 → 3.1.0-next.2

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Change Log
 
+## 3.1.0-next.2
+
+### Minor Changes
+
+- f466ffa: Expose the iOS Kakao Talk launch method for login and reject web-only token helpers on native platforms.
+- 23ca142: Expose consent revocation results, service-term consent sources, Talk profile IDs, friend pagination links, and masked picker nicknames. Forward Android scope filters, preserve nullable friend nicknames, and return iOS friend thumbnails as URL strings.
+- 845f1f2: Expose original user properties and property-key filters on Android, iOS, and web.
+
+### Patch Changes
+
+- f466ffa: Normalize APIs without success data to resolve without a value across platforms, while preserving friend-message results.
+- @react-native-kakao/core@3.1.0-next.2
+
+## 3.1.0-next.1
+
+### Minor Changes
+
+- 250d066: Expose group user tokens consistently on Android, iOS, and web.
+- 3d92882: Expose the iOS token refresh request logging option without changing global SDK logging or Android behavior.
+- f1fd1e2: Add manual signup and profile connection state on Android, iOS, and web.
+- f6e0207: Add a shared loginHint option for Kakao Account login on Android, iOS, and web.
+- a8a2e24: Expose partner legal identity fields and consent flags on Android, iOS, and web.
+- d81f9b7: Expose iOS authorization-code and certification-code token exchange with PKCE options, normalized web token issuance, and explicit unsupported-platform errors.
+- 7fe7820: Add native login method selection and explicit refresh of stored OAuth tokens.
+- 524be2c: Expose profile image defaults, leap-month flags, and the user's KakaoTalk UUID on Android, iOS, and web.
+- e25e428: Allow explicit native tokens when refreshing and normalize remaining token lifetimes across native responses.
+- 97a99b5: Add updateProfile to store registered custom user properties on Android, iOS, and web.
+- b6ff8a9: Add channel selection to login on Android, iOS, and web.
+- bd1bb64: Add the secureResource profile image URL option on Android, iOS, and web.
+- 87e8aa7: Allow a custom Android KakaoTalk login request code while preserving the SDK default when omitted. Accept the SDK's full 32-bit request code range for regular and certification login.
+
+### Patch Changes
+
+- dfd32ca: Upgrade all Kakao Android SDK modules to 2.25.1 and preserve web shipping-address queries with JavaScript SDK 2.8.4.
+- da4db1c: Return canonical profile enum strings on Android and preserve birthday type strings on iOS.
+- Updated dependencies [d5c5fb8]
+- Updated dependencies [3027207]
+- Updated dependencies [dfd32ca]
+- Updated dependencies [2b223bf]
+- Updated dependencies [67cd4e2]
+- Updated dependencies [d81f9b7]
+  - @react-native-kakao/core@3.1.0-next.1
+
 ## 3.1.0-next.0
 
 ### Minor Changes

package/android/src/main/java/net/mjstudio/rnkakao/user/RNCKakaoUserModule.kt

@@ -5,8 +5,11 @@ import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.ReadableArray
+import com.facebook.react.bridge.ReadableMap
 import com.kakao.sdk.auth.AuthApiClient
+import com.kakao.sdk.auth.AuthCodeClient
 import com.kakao.sdk.auth.model.OAuthToken
+import com.kakao.sdk.auth.model.Prompt
 import com.kakao.sdk.auth.model.Prompt.CERT
 import com.kakao.sdk.auth.model.Prompt.CREATE
 import com.kakao.sdk.auth.model.Prompt.LOGIN
@@ -14,8 +17,15 @@ import com.kakao.sdk.auth.model.Prompt.SELECT_ACCOUNT
 import com.kakao.sdk.common.model.ClientError
 import com.kakao.sdk.common.model.ClientErrorCause
 import com.kakao.sdk.user.UserApiClient
+import com.kakao.sdk.user.model.AccountLoginParams
+import com.kakao.sdk.user.model.AgeRange
+import com.kakao.sdk.user.model.BirthdayType
+import com.kakao.sdk.user.model.Gender
+import com.kakao.sdk.user.model.LoginUiMode
+import com.kakao.sdk.user.model.Scope
 import com.kakao.sdk.user.model.UserShippingAddresses
 import net.mjstudio.rnkakao.core.util.RNCKakaoResponseNotFoundException
+import net.mjstudio.rnkakao.core.util.RNCKakaoUnsupportedPlatformException
 import net.mjstudio.rnkakao.core.util.RNCKakaoUtil
 import net.mjstudio.rnkakao.core.util.argArr
 import net.mjstudio.rnkakao.core.util.argMap
@@ -28,9 +38,12 @@ import net.mjstudio.rnkakao.core.util.putD
 import net.mjstudio.rnkakao.core.util.putI
 import net.mjstudio.rnkakao.core.util.putL
 import net.mjstudio.rnkakao.core.util.rejectWith
+import net.mjstudio.rnkakao.core.util.toStringMap
 import net.mjstudio.rnkakao.core.util.unix
 import java.util.Date
 
+private const val MILLISECONDS_PER_SECOND = 1000.0
+
 class RNCKakaoUserModule internal constructor(
   context: ReactApplicationContext,
 ) : NativeKakaoUserSpec(context) {
@@ -39,8 +52,12 @@ class RNCKakaoUserModule internal constructor(
     serviceTerms: ReadableArray?,
     prompts: ReadableArray?,
     useKakaoAccountLogin: Boolean,
+    iosLaunchMethod: String,
     scopes: ReadableArray?,
     nonce: String?,
+    loginHint: String?,
+    channelPublicIds: ReadableArray?,
+    androidRequestCode: Double?,
     promise: Promise,
   ) = onMain {
     val context =
@@ -48,63 +65,18 @@ class RNCKakaoUserModule internal constructor(
         promise.rejectWith(ActivityNotFoundException())
         return@onMain
       }
-    val callback: (OAuthToken?, Throwable?) -> Unit = { token, error ->
-      if (error != null) {
-        promise.rejectWith(error)
-      } else if (token == null) {
-        promise.rejectWith(RNCKakaoResponseNotFoundException("token"))
-      } else {
-        promise.resolve(
-          argMap().apply {
-            putString("accessToken", token.accessToken)
-            putString("refreshToken", token.refreshToken)
-            putString("tokenType", null)
-            putString("idToken", token.idToken)
-            putDouble(
-              "accessTokenExpiresAt",
-              token.accessTokenExpiresAt.unix.toDouble(),
-            )
-            putDouble(
-              "refreshTokenExpiresAt",
-              token.refreshTokenExpiresAt.unix.toDouble(),
-            )
-            putDouble(
-              "accessTokenExpiresIn",
-              RNCKakaoUtil.diffSec(token.accessTokenExpiresAt, Date()).toDouble(),
-            )
-            putDouble(
-              "refreshTokenExpiresIn",
-              RNCKakaoUtil.diffSec(token.refreshTokenExpiresAt, Date()).toDouble(),
-            )
-            putArray(
-              "scopes",
-              argArr().apply {
-                pushStringList(token.scopes ?: listOf())
-              },
-            )
-          },
-        )
-      }
-    }
+    val callback = tokenCallback(promise)
     val requestedServiceTerms = serviceTerms?.filterIsInstance<String>()?.ifEmpty { null }
-    val requestedPrompts =
-      prompts
-        ?.filterIsInstance<String>()
-        ?.mapNotNull {
-          when (it) {
-            "Login" -> LOGIN
-            "Create" -> CREATE
-            "Cert" -> CERT
-            "SelectAccount" -> SELECT_ACCOUNT
-            else -> null
-          }
-        }?.ifEmpty { null }
+    val requestedChannelPublicIds = channelPublicIds?.filterIsInstance<String>()?.ifEmpty { null }
+    val requestedPrompts = loginPrompts(prompts)
     val accountLogin = {
       UserApiClient.instance.loginWithKakaoAccount(
         context,
         prompts = requestedPrompts,
+        loginHint = loginHint,
         nonce = nonce,
         serviceTerms = requestedServiceTerms,
+        channelPublicIds = requestedChannelPublicIds,
         callback = callback,
       )
     }
@@ -134,8 +106,10 @@ class RNCKakaoUserModule internal constructor(
 
       UserApiClient.instance.loginWithKakaoTalk(
         context,
+        requestCode = androidRequestCode?.toInt() ?: AuthCodeClient.DEFAULT_REQUEST_CODE,
         nonce = nonce,
         serviceTerms = requestedServiceTerms,
+        channelPublicIds = requestedChannelPublicIds,
         callback = talkCallback,
       )
     } else {
@@ -143,12 +117,92 @@ class RNCKakaoUserModule internal constructor(
     }
   }
 
+  @ReactMethod
+  override fun loginWithKakao(
+    uiMode: String,
+    orientation: String,
+    launchMethod: String,
+    prompts: ReadableArray,
+    loginHint: String?,
+    nonce: String?,
+    channelPublicIds: ReadableArray?,
+    serviceTerms: ReadableArray?,
+    promise: Promise,
+  ) = onMain {
+    val context =
+      reactApplicationContext.currentActivity ?: run {
+        promise.rejectWith(ActivityNotFoundException())
+        return@onMain
+      }
+    UserApiClient.instance.loginWithKakao(
+      context,
+      uiMode = LoginUiMode.entries.firstOrNull { it.name.equals(uiMode, ignoreCase = true) } ?: LoginUiMode.AUTO,
+      accountParams = AccountLoginParams(prompts = loginPrompts(prompts), loginHint = loginHint),
+      nonce = nonce,
+      channelPublicIds = channelPublicIds?.filterIsInstance<String>()?.ifEmpty { null },
+      serviceTerms = serviceTerms?.filterIsInstance<String>()?.ifEmpty { null },
+      callback = tokenCallback(promise),
+    )
+  }
+
+  @ReactMethod
+  override fun issueAccessTokenWithCode(
+    code: String,
+    codeVerifier: String?,
+    redirectUri: String?,
+    promise: Promise,
+  ) {
+    promise.rejectWith(RNCKakaoUnsupportedPlatformException("issueAccessTokenWithCode", "iOS and web"))
+  }
+
+  @ReactMethod
+  override fun refreshToken(
+    token: ReadableMap?,
+    iosLoggingEnabled: Boolean?,
+    promise: Promise,
+  ) = onMain {
+    try {
+      val oldToken =
+        token?.let {
+          OAuthToken(
+            accessToken = requireNotNull(it.getString("accessToken")),
+            accessTokenExpiresAt = Date((it.getDouble("accessTokenExpiresAt") * MILLISECONDS_PER_SECOND).toLong()),
+            refreshToken = requireNotNull(it.getString("refreshToken")),
+            refreshTokenExpiresAt = Date((it.getDouble("refreshTokenExpiresAt") * MILLISECONDS_PER_SECOND).toLong()),
+            idToken = it.getString("idToken"),
+            scopes = it.getArray("scopes")?.filterIsInstance<String>(),
+          )
+        }
+      if (oldToken == null) {
+        AuthApiClient.instance.refreshToken(callback = tokenCallback(promise))
+      } else {
+        AuthApiClient.instance.refreshToken(oldToken = oldToken, callback = tokenCallback(promise))
+      }
+    } catch (error: Exception) {
+      promise.rejectWith(error)
+    }
+  }
+
   @ReactMethod
   override fun isKakaoTalkLoginAvailable(promise: Promise) =
     onMain {
       promise.resolve(UserApiClient.instance.isKakaoTalkLoginAvailable(reactApplicationContext))
     }
 
+  @ReactMethod
+  override fun signup(
+    properties: ReadableMap?,
+    promise: Promise,
+  ) = onMain {
+    UserApiClient.instance.signup(properties?.toStringMap()) { error ->
+      if (error != null) {
+        promise.rejectWith(error)
+      } else {
+        promise.resolve(null)
+      }
+    }
+  }
+
   @ReactMethod
   override fun logout(promise: Promise) =
     onMain {
@@ -156,7 +210,7 @@ class RNCKakaoUserModule internal constructor(
         if (it != null) {
           promise.rejectWith(it)
         } else {
-          promise.resolve(42)
+          promise.resolve(null)
         }
       }
     }
@@ -168,7 +222,7 @@ class RNCKakaoUserModule internal constructor(
         if (it != null) {
           promise.rejectWith(it)
         } else {
-          promise.resolve(42)
+          promise.resolve(null)
         }
       }
     }
@@ -200,29 +254,13 @@ class RNCKakaoUserModule internal constructor(
     scopes: ReadableArray?,
     promise: Promise,
   ) = onMain {
-    UserApiClient.instance.scopes { scopeInfo, error ->
+    UserApiClient.instance.scopes(scopes = scopes?.filterIsInstance<String>()?.ifEmpty { null }) { scopeInfo, error ->
       if (error != null) {
         promise.rejectWith(error)
-      } else if (scopeInfo?.scopes == null) {
+      } else if (scopeInfo == null) {
         promise.rejectWith(RNCKakaoResponseNotFoundException("scopes"))
       } else {
-        promise.resolve(
-          argArr().also { arr ->
-            scopeInfo.scopes!!.forEach { scope ->
-              arr.pushMap(
-                argMap().also { map ->
-                  map.putString("id", scope.id)
-                  map.putString("displayName", scope.displayName)
-                  map.putString("type", scope.type.name)
-                  map.putBoolean("using", scope.using)
-                  map.putB("delegated", scope.delegated)
-                  map.putBoolean("agreed", scope.agreed)
-                  map.putB("revocable", scope.revocable)
-                },
-              )
-            }
-          },
-        )
+        promise.resolve(mapScopes(scopeInfo.scopes))
       }
     }
   }
@@ -240,7 +278,7 @@ class RNCKakaoUserModule internal constructor(
       } else if (scopeInfo == null) {
         promise.rejectWith(RNCKakaoResponseNotFoundException("scopeInfo"))
       } else {
-        promise.resolve(42)
+        promise.resolve(mapScopes(scopeInfo.scopes))
       }
     }
   }
@@ -269,6 +307,9 @@ class RNCKakaoUserModule internal constructor(
                 putBoolean("agreed", term.agreed)
                 putBoolean("required", term.required)
                 putBoolean("revocable", term.revocable)
+                term.referer?.let {
+                  putString("agreedBy", if (it.name == "KAUTH" || it.name == "KAPI") it.name else "unknown")
+                }
               }
             } ?: listOf(),
           ),
@@ -378,87 +419,123 @@ class RNCKakaoUserModule internal constructor(
     }
 
   @ReactMethod
-  override fun me(promise: Promise) =
-    onMain {
-      UserApiClient.instance.me { user, error ->
-        if (error != null) {
-          promise.rejectWith(error)
-        } else if (user == null) {
-          promise.rejectWith(RNCKakaoResponseNotFoundException("user"))
-        } else {
-          promise.resolve(
-            argMap().apply {
-              putD("id", user.id?.toDouble())
-              putL("connectedAt", user.connectedAt?.unix)
-              putL("synchedAt", user.synchedAt?.unix)
-              putString("name", user.kakaoAccount?.name)
+  override fun updateProfile(
+    properties: ReadableMap,
+    promise: Promise,
+  ) = onMain {
+    UserApiClient.instance.updateProfile(properties.toStringMap()) { error ->
+      if (error != null) {
+        promise.rejectWith(error)
+      } else {
+        promise.resolve(null)
+      }
+    }
+  }
 
-              putString("email", user.kakaoAccount?.email)
-              putString("nickname", user.kakaoAccount?.profile?.nickname)
-              putString("profileImageUrl", user.kakaoAccount?.profile?.profileImageUrl)
-              putString("thumbnailImageUrl", user.kakaoAccount?.profile?.thumbnailImageUrl)
-              putString("phoneNumber", user.kakaoAccount?.phoneNumber)
-              putString("ageRange", user.kakaoAccount?.ageRange?.name)
-              putString("birthday", user.kakaoAccount?.birthday)
-              putString("birthdayType", user.kakaoAccount?.birthdayType?.name)
-              putString("birthyear", user.kakaoAccount?.birthyear)
-              putString("gender", user.kakaoAccount?.gender?.name)
-              putB("isEmailValid", user.kakaoAccount?.isEmailValid)
-              putB("isEmailVerified", user.kakaoAccount?.isEmailVerified)
-              putB("isKorean", user.kakaoAccount?.isKorean)
-              putB(
-                "ageRangeNeedsAgreement",
-                user.kakaoAccount?.ageRangeNeedsAgreement,
-              )
-              putB(
-                "birthdayNeedsAgreement",
-                user.kakaoAccount?.birthdayNeedsAgreement,
-              )
-              putB(
-                "birthyearNeedsAgreement",
-                user.kakaoAccount?.birthyearNeedsAgreement,
-              )
-              putB(
-                "emailNeedsAgreement",
-                user.kakaoAccount?.emailNeedsAgreement,
-              )
-              putB(
-                "genderNeedsAgreement",
-                user.kakaoAccount?.genderNeedsAgreement,
-              )
-              putB(
-                "isKoreanNeedsAgreement",
-                user.kakaoAccount?.isKoreanNeedsAgreement,
-              )
-              putB(
-                "phoneNumberNeedsAgreement",
-                user.kakaoAccount?.phoneNumberNeedsAgreement,
-              )
-              putB(
-                "profileNeedsAgreement",
-                user.kakaoAccount?.profileNeedsAgreement,
-              )
-              putB(
-                "nameNeedsAgreement",
-                user.kakaoAccount?.nameNeedsAgreement,
-              )
-              putB(
-                "profileImageNeedsAgreement",
-                user.kakaoAccount?.profileImageNeedsAgreement,
-              )
-              putB(
-                "profileNicknameNeedsAgreement",
-                user.kakaoAccount?.profileNicknameNeedsAgreement,
-              )
-              putB(
-                "legalBirthDateNeedsAgreement",
-                user.kakaoAccount?.legalBirthDateNeedsAgreement,
-              )
-            },
-          )
-        }
+  @ReactMethod
+  override fun me(
+    propertyKeys: ReadableArray?,
+    secureResource: Boolean?,
+    promise: Promise,
+  ) = onMain {
+    UserApiClient.instance.me(
+      propertyKeys?.filterIsInstance<String>(),
+      secureResource = secureResource ?: true,
+    ) { user, error ->
+      if (error != null) {
+        promise.rejectWith(error)
+      } else if (user == null) {
+        promise.rejectWith(RNCKakaoResponseNotFoundException("user"))
+      } else {
+        promise.resolve(
+          argMap().apply {
+            putD("id", user.id?.toDouble())
+            putMap(
+              "properties",
+              argMap().apply {
+                user.properties?.forEach { (key, value) -> putString(key, value) }
+              },
+            )
+            putB("hasSignedUp", user.hasSignedUp)
+            putString("uuid", user.uuid)
+            putString("groupUserToken", user.groupUserToken)
+            putL("connectedAt", user.connectedAt?.unix)
+            putL("synchedAt", user.synchedAt?.unix)
+            putString("name", user.kakaoAccount?.name)
+
+            putString("email", user.kakaoAccount?.email)
+            putString("nickname", user.kakaoAccount?.profile?.nickname)
+            putString("profileImageUrl", user.kakaoAccount?.profile?.profileImageUrl)
+            putString("thumbnailImageUrl", user.kakaoAccount?.profile?.thumbnailImageUrl)
+            putB("isDefaultImage", user.kakaoAccount?.profile?.isDefaultImage)
+            putString("phoneNumber", user.kakaoAccount?.phoneNumber)
+            putString("ageRange", user.kakaoAccount?.ageRange.toBridgeValue())
+            putString("birthday", user.kakaoAccount?.birthday)
+            putString("birthdayType", user.kakaoAccount?.birthdayType.toBridgeValue())
+            putB("isLeapMonth", user.kakaoAccount?.isLeapMonth)
+            putString("birthyear", user.kakaoAccount?.birthyear)
+            putString("gender", user.kakaoAccount?.gender.toBridgeValue())
+            putB("isEmailValid", user.kakaoAccount?.isEmailValid)
+            putB("isEmailVerified", user.kakaoAccount?.isEmailVerified)
+            putB("isKorean", user.kakaoAccount?.isKorean)
+            putB(
+              "ageRangeNeedsAgreement",
+              user.kakaoAccount?.ageRangeNeedsAgreement,
+            )
+            putB(
+              "birthdayNeedsAgreement",
+              user.kakaoAccount?.birthdayNeedsAgreement,
+            )
+            putB(
+              "birthyearNeedsAgreement",
+              user.kakaoAccount?.birthyearNeedsAgreement,
+            )
+            putB(
+              "emailNeedsAgreement",
+              user.kakaoAccount?.emailNeedsAgreement,
+            )
+            putB(
+              "genderNeedsAgreement",
+              user.kakaoAccount?.genderNeedsAgreement,
+            )
+            putB(
+              "isKoreanNeedsAgreement",
+              user.kakaoAccount?.isKoreanNeedsAgreement,
+            )
+            putB(
+              "phoneNumberNeedsAgreement",
+              user.kakaoAccount?.phoneNumberNeedsAgreement,
+            )
+            putB(
+              "profileNeedsAgreement",
+              user.kakaoAccount?.profileNeedsAgreement,
+            )
+            putB(
+              "nameNeedsAgreement",
+              user.kakaoAccount?.nameNeedsAgreement,
+            )
+            putB(
+              "profileImageNeedsAgreement",
+              user.kakaoAccount?.profileImageNeedsAgreement,
+            )
+            putB(
+              "profileNicknameNeedsAgreement",
+              user.kakaoAccount?.profileNicknameNeedsAgreement,
+            )
+            putB(
+              "legalBirthDateNeedsAgreement",
+              user.kakaoAccount?.legalBirthDateNeedsAgreement,
+            )
+            putString("legalName", user.kakaoAccount?.legalName)
+            putB("legalNameNeedsAgreement", user.kakaoAccount?.legalNameNeedsAgreement)
+            putString("legalBirthDate", user.kakaoAccount?.legalBirthDate)
+            putString("legalGender", user.kakaoAccount?.legalGender.toBridgeValue())
+            putB("legalGenderNeedsAgreement", user.kakaoAccount?.legalGenderNeedsAgreement)
+          },
+        )
       }
     }
+  }
 
   @ReactMethod
   override fun getAccessToken(promise: Promise) =
@@ -479,4 +556,102 @@ class RNCKakaoUserModule internal constructor(
         }
       }
     }
+
+  private fun mapScopes(scopes: List<Scope>?) =
+    argArr().pushMapList(
+      scopes.orEmpty().map { scope ->
+        argMap().apply {
+          putString("id", scope.id)
+          putString("displayName", scope.displayName)
+          putString("type", scope.type.name)
+          putBoolean("using", scope.using)
+          putB("delegated", scope.delegated)
+          putBoolean("agreed", scope.agreed)
+          putB("revocable", scope.revocable)
+        }
+      },
+    )
+
+  private fun tokenCallback(promise: Promise): (OAuthToken?, Throwable?) -> Unit =
+    { token, error ->
+      if (error != null) {
+        promise.rejectWith(error)
+      } else if (token == null) {
+        promise.rejectWith(RNCKakaoResponseNotFoundException("token"))
+      } else {
+        promise.resolve(
+          argMap().apply {
+            putString("accessToken", token.accessToken)
+            putString("refreshToken", token.refreshToken)
+            putString("tokenType", null)
+            putString("idToken", token.idToken)
+            putDouble(
+              "accessTokenExpiresAt",
+              token.accessTokenExpiresAt.unix.toDouble(),
+            )
+            putDouble(
+              "refreshTokenExpiresAt",
+              token.refreshTokenExpiresAt.unix.toDouble(),
+            )
+            putDouble(
+              "accessTokenExpiresIn",
+              RNCKakaoUtil.diffSec(token.accessTokenExpiresAt, Date()).toDouble(),
+            )
+            putDouble(
+              "refreshTokenExpiresIn",
+              RNCKakaoUtil.diffSec(token.refreshTokenExpiresAt, Date()).toDouble(),
+            )
+            putArray(
+              "scopes",
+              argArr().apply {
+                pushStringList(token.scopes ?: listOf())
+              },
+            )
+          },
+        )
+      }
+    }
+
+  private fun loginPrompts(prompts: ReadableArray?): List<Prompt>? =
+    prompts
+      ?.filterIsInstance<String>()
+      ?.mapNotNull {
+        when (it) {
+          "Login" -> LOGIN
+          "Create" -> CREATE
+          "Cert" -> CERT
+          "SelectAccount" -> SELECT_ACCOUNT
+          else -> null
+        }
+      }?.ifEmpty { null }
 }
+
+private fun AgeRange?.toBridgeValue(): String? =
+  when (this) {
+    AgeRange.AGE_0_9 -> "0~9"
+    AgeRange.AGE_10_14 -> "10~14"
+    AgeRange.AGE_15_19 -> "15~19"
+    AgeRange.AGE_20_29 -> "20~29"
+    AgeRange.AGE_30_39 -> "30~39"
+    AgeRange.AGE_40_49 -> "40~49"
+    AgeRange.AGE_50_59 -> "50~59"
+    AgeRange.AGE_60_69 -> "60~69"
+    AgeRange.AGE_70_79 -> "70~79"
+    AgeRange.AGE_80_89 -> "80~89"
+    AgeRange.AGE_90_ABOVE -> "90~"
+    AgeRange.UNKNOWN, null -> null
+  }
+
+private fun Gender?.toBridgeValue(): String? =
+  when (this) {
+    Gender.FEMALE -> "female"
+    Gender.MALE -> "male"
+    Gender.UNKNOWN, null -> null
+  }
+
+private fun BirthdayType?.toBridgeValue(): String? =
+  when (this) {
+    BirthdayType.SOLAR -> "SOLAR"
+    BirthdayType.LUNAR -> "LUNAR"
+    BirthdayType.UNKNOWN, null -> null
+  }