protobuf-platform 1.2.341 → 1.2.343

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "protobuf-platform",
-  "version": "1.2.341",
+  "version": "1.2.343",
   "description": "Protobuf structures",
   "main": "index.js",
   "scripts": {

package/user/user.proto

@@ -67,6 +67,8 @@ service User {
     rpc readListCategories(PaginationRequest) returns (CategoryItemsResponse);
     //Verification Statuses
     rpc readListVerificationStatuses(PaginationRequest) returns (VerificationStatusItemsResponse);
+    // KYC: `kyc_status` is a platform canonical status (string). Typical values include none, pending, in_review, approved, rejected, resubmission_required, expired, failed, requiresReview, blocked — not enforced as enums here (for now).
+    // `provider_status` where present is a safe provider status code or label, not a raw provider payload. Raw provider payloads must not be exposed through these messages.
     //User KYC profile
     rpc readUserKycProfile(ReadUserKycProfileRequest) returns (UserKycProfileResponse);
     rpc updateUserKycProfile(UpdateUserKycProfileRequest) returns (UserKycProfileResponse);
@@ -78,6 +80,12 @@ service User {
     rpc readUserKycDocument(ReadUserKycDocumentRequest) returns (UserKycDocumentItem);
     rpc readListUserKycDocuments(ReadListUserKycDocumentsRequest) returns (UserKycDocumentListResponse);
     rpc readUserKycDocumentOptions(ReadUserKycDocumentOptionsRequest) returns (UserKycDocumentOptionsResponse);
+    // Provider-agnostic KYC: start a provider-hosted or provider-driven verification session.
+    rpc startUserKycVerification(StartUserKycVerificationRequest) returns (StartUserKycVerificationResponse);
+    // Single internal entrypoint for provider webhook processing (`raw_body` / `headers` are internal-only).
+    rpc processUserKycProviderWebhook(ProcessUserKycProviderWebhookRequest) returns (ProcessUserKycProviderWebhookResponse);
+    // Optional operational support: refresh or poll provider verification status where the provider supports it.
+    rpc syncUserKycProviderStatus(SyncUserKycProviderStatusRequest) returns (UserKycProfileResponse);
     //Dashboard
     rpc getDashboardInfo(DashboardRequest) returns (DashboardResponse);
     //Notes
@@ -89,6 +97,7 @@ service User {
     //User`s Limits
     rpc setUserLimits(UserLimitsRequest) returns (LimitStatusResponse);
     rpc readUserLimits(GetUserLimitsRequest) returns (UserLimitsResponse);
+    // Legacy provider-specific KYC RPCs. Do not use for new provider-agnostic KYC flows; use startUserKycVerification and related RPCs instead. Do not extend these contracts.
     //KYC
     rpc createSumSubApplicant(SumSubApplicantRequest) returns (SumSubResponse);
     rpc uploadSumSubDocument(stream SumSubDocumentRequest) returns (SumSubResponse);
@@ -841,6 +850,61 @@ message UserKycProfileResponse {
     optional int32 updated_by = 5;
     optional string created_at = 6;
     optional string updated_at = 7;
+    optional string kyc_provider = 8;
+    optional string provider_applicant_id = 9;
+    optional string provider_session_id = 10;
+    optional string provider_check_id = 11;
+    optional string provider_status = 12;
+    optional string provider_reason_code = 13;
+    optional string provider_last_event_id = 14;
+    optional string provider_last_event_at = 15;
+    optional string provider_updated_at = 16;
+}
+message StartUserKycVerificationRequest {
+    int32 user_id = 1;
+    optional string user_public_id = 2;
+    optional string level = 3;
+    optional string locale = 4;
+    optional string return_url = 5;
+    optional string callback_url = 6;
+    optional string correlation_id = 7;
+}
+message StartUserKycVerificationResponse {
+    int32 user_id = 1;
+    optional string user_public_id = 2;
+    string kyc_status = 3;
+    optional string kyc_provider = 4;
+    optional string provider_applicant_id = 5;
+    optional string provider_session_id = 6;
+    optional string verification_url = 7;
+    optional string verification_token = 8;
+    optional string expires_at = 9;
+    optional string created_at = 10;
+    optional string updated_at = 11;
+}
+message ProcessUserKycProviderWebhookRequest {
+    // Internal webhook processing only; not for public client APIs.
+    string raw_body = 1;
+    // JSON-encoded HTTP header map (or equivalent) for internal signature verification.
+    string headers = 2;
+    optional string correlation_id = 3;
+}
+message ProcessUserKycProviderWebhookResponse {
+    string status = 1;
+    optional int32 user_id = 2;
+    optional string user_public_id = 3;
+    optional string kyc_status = 4;
+    optional string kyc_provider = 5;
+    optional string provider_applicant_id = 6;
+    optional string provider_event_id = 7;
+    optional string provider_event_at = 8;
+    optional string reason_code = 9;
+}
+message SyncUserKycProviderStatusRequest {
+    int32 user_id = 1;
+    optional string user_public_id = 2;
+    optional string provider_applicant_id = 3;
+    optional string correlation_id = 4;
 }
 message ReadListRiskPlayersRequest {
     int32 limit = 1;
@@ -910,6 +974,12 @@ message UserKycDocumentItem {
     optional string uploaded_by_email = 17;
     // Backend-derived actor email resolved from reviewer_id; omitted when user-service cannot resolve.
     optional string reviewer_email = 18;
+    optional string kyc_provider = 19;
+    optional string provider_document_id = 20;
+    optional string provider_document_type = 21;
+    optional string provider_status = 22;
+    optional string provider_reason_code = 23;
+    optional string provider_updated_at = 24;
 }
 message UserKycDocumentsResponse {
     int32 user_id = 1;
@@ -958,6 +1028,12 @@ message UserKycDocumentListItem {
     optional string risk_level = 22;
     optional string uploaded_by_email = 23;
     optional string reviewer_email = 24;
+    optional string kyc_provider = 25;
+    optional string provider_document_id = 26;
+    optional string provider_document_type = 27;
+    optional string provider_status = 28;
+    optional string provider_reason_code = 29;
+    optional string provider_updated_at = 30;
 }
 message UserKycDocumentListResponse {
     repeated UserKycDocumentListItem items = 1;
@@ -1007,6 +1083,7 @@ message NoteStatusResponse {
 message GetNoteRequest {
     optional int32 id = 1;
 }
+// Legacy provider-specific KYC messages. New integrations must use provider-agnostic KYC RPCs and messages. Do not extend these contracts.
 //KYC | SumSub
 message SumSubApplicantRequest {
     string user_public_id = 1;

package/user/user_grpc_pb.js

@@ -389,6 +389,28 @@ function deserialize_user_PongResponse(buffer_arg) {
   return user_pb.PongResponse.deserializeBinary(new Uint8Array(buffer_arg));
 }
 
+function serialize_user_ProcessUserKycProviderWebhookRequest(arg) {
+  if (!(arg instanceof user_pb.ProcessUserKycProviderWebhookRequest)) {
+    throw new Error('Expected argument of type user.ProcessUserKycProviderWebhookRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_user_ProcessUserKycProviderWebhookRequest(buffer_arg) {
+  return user_pb.ProcessUserKycProviderWebhookRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_user_ProcessUserKycProviderWebhookResponse(arg) {
+  if (!(arg instanceof user_pb.ProcessUserKycProviderWebhookResponse)) {
+    throw new Error('Expected argument of type user.ProcessUserKycProviderWebhookResponse');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_user_ProcessUserKycProviderWebhookResponse(buffer_arg) {
+  return user_pb.ProcessUserKycProviderWebhookResponse.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
 function serialize_user_ReadListRiskPlayersRequest(arg) {
   if (!(arg instanceof user_pb.ReadListRiskPlayersRequest)) {
     throw new Error('Expected argument of type user.ReadListRiskPlayersRequest');
@@ -719,6 +741,28 @@ function deserialize_user_SetNewPasswordConfirmedRequest(buffer_arg) {
   return user_pb.SetNewPasswordConfirmedRequest.deserializeBinary(new Uint8Array(buffer_arg));
 }
 
+function serialize_user_StartUserKycVerificationRequest(arg) {
+  if (!(arg instanceof user_pb.StartUserKycVerificationRequest)) {
+    throw new Error('Expected argument of type user.StartUserKycVerificationRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_user_StartUserKycVerificationRequest(buffer_arg) {
+  return user_pb.StartUserKycVerificationRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_user_StartUserKycVerificationResponse(arg) {
+  if (!(arg instanceof user_pb.StartUserKycVerificationResponse)) {
+    throw new Error('Expected argument of type user.StartUserKycVerificationResponse');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_user_StartUserKycVerificationResponse(buffer_arg) {
+  return user_pb.StartUserKycVerificationResponse.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
 function serialize_user_SumSubApplicantRequest(arg) {
   if (!(arg instanceof user_pb.SumSubApplicantRequest)) {
     throw new Error('Expected argument of type user.SumSubApplicantRequest');
@@ -752,6 +796,17 @@ function deserialize_user_SumSubResponse(buffer_arg) {
   return user_pb.SumSubResponse.deserializeBinary(new Uint8Array(buffer_arg));
 }
 
+function serialize_user_SyncUserKycProviderStatusRequest(arg) {
+  if (!(arg instanceof user_pb.SyncUserKycProviderStatusRequest)) {
+    throw new Error('Expected argument of type user.SyncUserKycProviderStatusRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_user_SyncUserKycProviderStatusRequest(buffer_arg) {
+  return user_pb.SyncUserKycProviderStatusRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
 function serialize_user_TelegramLoginRequest(arg) {
   if (!(arg instanceof user_pb.TelegramLoginRequest)) {
     throw new Error('Expected argument of type user.TelegramLoginRequest');
@@ -1799,7 +1854,9 @@ readListVerificationStatuses: {
     responseSerialize: serialize_user_VerificationStatusItemsResponse,
     responseDeserialize: deserialize_user_VerificationStatusItemsResponse,
   },
-  // User KYC profile
+  // KYC: `kyc_status` is a platform canonical status (string). Typical values include none, pending, in_review, approved, rejected, resubmission_required, expired, failed, requiresReview, blocked — not enforced as enums here (for now).
+// `provider_status` where present is a safe provider status code or label, not a raw provider payload. Raw provider payloads must not be exposed through these messages.
+// User KYC profile
 readUserKycProfile: {
     path: '/user.User/readUserKycProfile',
     requestStream: false,
@@ -1900,6 +1957,42 @@ readUserKycDocuments: {
     responseSerialize: serialize_user_UserKycDocumentOptionsResponse,
     responseDeserialize: deserialize_user_UserKycDocumentOptionsResponse,
   },
+  // Provider-agnostic KYC: start a provider-hosted or provider-driven verification session.
+startUserKycVerification: {
+    path: '/user.User/startUserKycVerification',
+    requestStream: false,
+    responseStream: false,
+    requestType: user_pb.StartUserKycVerificationRequest,
+    responseType: user_pb.StartUserKycVerificationResponse,
+    requestSerialize: serialize_user_StartUserKycVerificationRequest,
+    requestDeserialize: deserialize_user_StartUserKycVerificationRequest,
+    responseSerialize: serialize_user_StartUserKycVerificationResponse,
+    responseDeserialize: deserialize_user_StartUserKycVerificationResponse,
+  },
+  // Single internal entrypoint for provider webhook processing (`raw_body` / `headers` are internal-only).
+processUserKycProviderWebhook: {
+    path: '/user.User/processUserKycProviderWebhook',
+    requestStream: false,
+    responseStream: false,
+    requestType: user_pb.ProcessUserKycProviderWebhookRequest,
+    responseType: user_pb.ProcessUserKycProviderWebhookResponse,
+    requestSerialize: serialize_user_ProcessUserKycProviderWebhookRequest,
+    requestDeserialize: deserialize_user_ProcessUserKycProviderWebhookRequest,
+    responseSerialize: serialize_user_ProcessUserKycProviderWebhookResponse,
+    responseDeserialize: deserialize_user_ProcessUserKycProviderWebhookResponse,
+  },
+  // Optional operational support: refresh or poll provider verification status where the provider supports it.
+syncUserKycProviderStatus: {
+    path: '/user.User/syncUserKycProviderStatus',
+    requestStream: false,
+    responseStream: false,
+    requestType: user_pb.SyncUserKycProviderStatusRequest,
+    responseType: user_pb.UserKycProfileResponse,
+    requestSerialize: serialize_user_SyncUserKycProviderStatusRequest,
+    requestDeserialize: deserialize_user_SyncUserKycProviderStatusRequest,
+    responseSerialize: serialize_user_UserKycProfileResponse,
+    responseDeserialize: deserialize_user_UserKycProfileResponse,
+  },
   // Dashboard
 getDashboardInfo: {
     path: '/user.User/getDashboardInfo',
@@ -1991,7 +2084,8 @@ setUserLimits: {
     responseSerialize: serialize_user_UserLimitsResponse,
     responseDeserialize: deserialize_user_UserLimitsResponse,
   },
-  // KYC
+  // Legacy provider-specific KYC RPCs. Do not use for new provider-agnostic KYC flows; use startUserKycVerification and related RPCs instead. Do not extend these contracts.
+// KYC
 createSumSubApplicant: {
     path: '/user.User/createSumSubApplicant',
     requestStream: false,