feat(phone): update protos and scaffold LinkForPayment RPC

Update flipcash protobuf definitions and add service layer stubs for the
new LinkForPayment RPC which links a verified phone number for payment.

Signed-off-by: Brandon McAnsh <git@bmcreations.dev>

Author: bmc08gt

definitions/flipcash/protos/src/main/proto/phone/v1/phone_verification_service.proto

@@ -22,6 +22,9 @@ service PhoneVerification {
 
      // Unlink removes the link of a phone number from a user.
     rpc Unlink(UnlinkRequest) returns (UnlinkResponse);
+
+    // LinkForPayment links the verified phone number for the requesting user for payment.
+    rpc LinkForPayment(LinkForPaymentRequest) returns (LinkForPaymentResponse);
 }
 
 message SendVerificationCodeRequest {
@@ -94,3 +97,20 @@ message UnlinkResponse {
 		DENIED = 1;
 	}
 }
+
+
+message LinkForPaymentRequest {
+    // The phone number to link for payment
+    PhoneNumber phone_number = 1 [(validate.rules).message.required = true];
+
+    common.v1.Auth auth = 2 [(validate.rules).message.required = true];
+}
+
+message LinkForPaymentResponse {
+    Result result = 1;
+	enum Result {
+		OK             = 0;
+		DENIED         = 1;
+        NOT_ASSOCIATED = 2;
+	}
+}

services/flipcash/src/main/kotlin/com/flipcash/services/controllers/ContactVerificationController.kt

@@ -36,4 +36,11 @@ class ContactVerificationController @Inject constructor(
             userManager.set(updated)
         }
     }
+
+    suspend fun linkForPayment(method: ContactMethod.Phone): Result<Unit> {
+        val owner = userManager.accountCluster?.authority?.keyPair
+            ?: return Result.failure(Throwable("No account cluster in UserManager"))
+
+        return repository.linkForPayment(method, owner)
+    }
 }

services/flipcash/src/main/kotlin/com/flipcash/services/internal/network/api/PhoneVerificationApi.kt

@@ -87,4 +87,20 @@ internal class PhoneVerificationApi @Inject constructor(
             api.unlink(request)
         }
     }
+
+    suspend fun linkForPayment(
+        request: ContactMethod.Phone,
+        owner: Ed25519.KeyPair
+    ): PhoneVerificationService.LinkForPaymentResponse {
+        val request = PhoneVerificationService.LinkForPaymentRequest.newBuilder()
+            .setPhoneNumber(Model.PhoneNumber.newBuilder().setValue(request.phoneNumber).build())
+            .apply { setAuth(authenticate(owner)) }
+            .build()
+
+        request.validate().orThrow()
+
+        return withContext(Dispatchers.IO) {
+            api.linkForPayment(request)
+        }
+    }
 }

services/flipcash/src/main/kotlin/com/flipcash/services/internal/network/services/PhoneVerificationService.kt

@@ -3,6 +3,7 @@ package com.flipcash.services.internal.network.services
 import com.flipcash.services.internal.network.api.PhoneVerificationApi
 import com.getcode.opencode.utils.toValidationOrElse
 import com.flipcash.services.models.ContactMethod
+import com.flipcash.services.models.LinkForPaymentError
 import com.flipcash.services.models.PhoneVerificationError
 import com.getcode.ed25519.Ed25519
 import com.getcode.opencode.internal.network.extensions.foldWithSuppression
@@ -111,4 +112,32 @@ internal class PhoneVerificationService @Inject constructor(
             }
         )
     }
+
+    suspend fun linkForPayment(
+        request: ContactMethod.Phone,
+        owner: Ed25519.KeyPair
+    ): Result<Unit> {
+        return runCatching {
+            api.linkForPayment(request, owner)
+        }.foldWithSuppression(
+            onSuccess = { response ->
+                when (response.result) {
+                    RpcPhoneService.LinkForPaymentResponse.Result.OK -> Result.success(Unit)
+                    RpcPhoneService.LinkForPaymentResponse.Result.DENIED -> {
+                        Result.failure(LinkForPaymentError.Denied())
+                    }
+                    RpcPhoneService.LinkForPaymentResponse.Result.NOT_ASSOCIATED -> {
+                        Result.failure(LinkForPaymentError.NotAssociated())
+                    }
+                    RpcPhoneService.LinkForPaymentResponse.Result.UNRECOGNIZED -> {
+                        Result.failure(LinkForPaymentError.Unrecognized())
+                    }
+                    else -> Result.failure(LinkForPaymentError.Other())
+                }
+            },
+            onFailure = { cause ->
+                Result.failure(cause.toValidationOrElse { LinkForPaymentError.Other(it) })
+            }
+        )
+    }
 }

services/flipcash/src/main/kotlin/com/flipcash/services/internal/repositories/InternalContactVerificationRepository.kt

@@ -38,4 +38,9 @@ internal class InternalContactVerificationRepository(
             is ContactMethod.Phone -> phoneService.unlink(method, owner)
         }.onFailure { ErrorUtils.handleError(it) }
     }
+
+    override suspend fun linkForPayment(method: ContactMethod.Phone, owner: Ed25519.KeyPair): Result<Unit> {
+        return phoneService.linkForPayment(method, owner)
+            .onFailure { ErrorUtils.handleError(it) }
+    }
 }

services/flipcash/src/main/kotlin/com/flipcash/services/models/Errors.kt

@@ -175,6 +175,16 @@ sealed class PhoneVerificationError(
     data class Other(override val cause: Throwable? = null) : PhoneVerificationError(message = cause?.message, cause = cause), NotifiableError
 }
 
+sealed class LinkForPaymentError(
+    override val message: String? = null,
+    override val cause: Throwable? = null
+): CodeServerError(message, cause) {
+    class Denied: LinkForPaymentError("Denied")
+    class NotAssociated: LinkForPaymentError("Not associated")
+    class Unrecognized : LinkForPaymentError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : LinkForPaymentError(message = cause?.message, cause = cause), NotifiableError
+}
+
 sealed class GetUserProfileError(
     override val message: String? = null,
     override val cause: Throwable? = null

services/flipcash/src/main/kotlin/com/flipcash/services/repository/ContactVerificationRepository.kt

@@ -7,5 +7,5 @@ interface ContactVerificationRepository {
     suspend fun sendVerificationCode(method: ContactMethod, owner: Ed25519.KeyPair): Result<Unit>
     suspend fun checkVerificationCode(method: ContactMethod, code: String, owner: Ed25519.KeyPair): Result<Unit>
     suspend fun unlink(method: ContactMethod, owner: Ed25519.KeyPair): Result<Unit>
-
+    suspend fun linkForPayment(method: ContactMethod.Phone, owner: Ed25519.KeyPair): Result<Unit>
 }