@just-education-org/rpc-contracts 1.17.2 → 1.18.1

package/dist/generated/ts/payment.d.ts

@@ -8,12 +8,16 @@ export interface CreatePaymentRequest {
     savePaymentMethod: boolean;
     /** ISO 4217, lowercase (e.g. "usd or uah"), as required by Stripe */
     currency: string;
+    bookingId: string;
 }
 export interface CreatePaymentResponse {
     url: string;
 }
 export interface ProcessPaymentEventRequest {
-    /** Payment Success | Cancelled | Waiting for Captured? */
+    /**
+     * Our own normalized event type (PAYMENT_SUCCEEDED | PAYMENT_FAILED),
+     * not the provider's raw event type — keeps payment-service provider-agnostic
+     */
     event: string;
     paymentId: string;
     bookingId: string;
@@ -23,6 +27,13 @@ export interface ProcessPaymentEventRequest {
     /** bin */
     cardFirst6?: string | undefined;
     cardLast4?: string | undefined;
+    bank?: string | undefined;
+    brand?: string | undefined;
+    /**
+     * Final payment id at the provider (e.g. Stripe PaymentIntent) —
+     * written to Payment.providerId, replacing the intermediate id (e.g. Checkout Session)
+     */
+    providerIntentId?: string | undefined;
 }
 export interface ProcessPaymentEventResponse {
     ok: boolean;

package/dist/generated/ts/payment_method.d.ts

@@ -0,0 +1,60 @@
+import { Observable } from "rxjs";
+export declare const protobufPackage = "payment_method.v1";
+export interface GetUserPaymentMethodsRequest {
+    userId: string;
+}
+export interface GetUserPaymentMethodsResponse {
+    methods: PaymentMethodItem[];
+}
+export interface CreatePaymentMethodRequest {
+    userId: string;
+}
+export interface CreatePaymentMethodResponse {
+    id: string;
+    url: string;
+}
+/**
+ * - What is verify for?
+ * - The provider doesn't send a webhook when a payment method gets linked.
+ * We have to check this ourselves: on creation we make a PaymentMethod row
+ * in our DB (no card data yet) linked to the user, and once the user
+ * finishes linking it on the provider's page, the frontend redirects back
+ * with our internal payment method id as a query param — that's when we
+ * call VerifyPaymentMethod to look it up and confirm the link.
+ */
+export interface VerifyPaymentMethodRequest {
+    userId: string;
+    methodId: string;
+}
+export interface VerifyPaymentMethodResponse {
+    ok: boolean;
+}
+export interface DeletePaymentMethodRequest {
+    userId: string;
+    methodId: string;
+}
+export interface DeletePaymentMethodResponse {
+    ok: boolean;
+}
+export interface PaymentMethodItem {
+    id: string;
+    bank?: string | undefined;
+    brand?: string | undefined;
+    first6?: string | undefined;
+    last4?: string | undefined;
+}
+export declare const PAYMENT_METHOD_V1_PACKAGE_NAME = "payment_method.v1";
+export interface PaymentMethodServiceClient {
+    getUserPaymentMethods(request: GetUserPaymentMethodsRequest): Observable<GetUserPaymentMethodsResponse>;
+    createPaymentMethod(request: CreatePaymentMethodRequest): Observable<CreatePaymentMethodResponse>;
+    verifyPaymentMethod(request: VerifyPaymentMethodRequest): Observable<VerifyPaymentMethodResponse>;
+    deletePaymentMethod(request: DeletePaymentMethodRequest): Observable<DeletePaymentMethodResponse>;
+}
+export interface PaymentMethodServiceController {
+    getUserPaymentMethods(request: GetUserPaymentMethodsRequest): Promise<GetUserPaymentMethodsResponse> | Observable<GetUserPaymentMethodsResponse> | GetUserPaymentMethodsResponse;
+    createPaymentMethod(request: CreatePaymentMethodRequest): Promise<CreatePaymentMethodResponse> | Observable<CreatePaymentMethodResponse> | CreatePaymentMethodResponse;
+    verifyPaymentMethod(request: VerifyPaymentMethodRequest): Promise<VerifyPaymentMethodResponse> | Observable<VerifyPaymentMethodResponse> | VerifyPaymentMethodResponse;
+    deletePaymentMethod(request: DeletePaymentMethodRequest): Promise<DeletePaymentMethodResponse> | Observable<DeletePaymentMethodResponse> | DeletePaymentMethodResponse;
+}
+export declare function PaymentMethodServiceControllerMethods(): (constructor: Function) => void;
+export declare const PAYMENT_METHOD_SERVICE_NAME = "PaymentMethodService";

package/dist/generated/ts/payment_method.js

@@ -0,0 +1,33 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.0
+//   protoc               v3.21.12
+// source: payment_method.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYMENT_METHOD_SERVICE_NAME = exports.PAYMENT_METHOD_V1_PACKAGE_NAME = exports.protobufPackage = void 0;
+exports.PaymentMethodServiceControllerMethods = PaymentMethodServiceControllerMethods;
+/* eslint-disable */
+const microservices_1 = require("@nestjs/microservices");
+exports.protobufPackage = "payment_method.v1";
+exports.PAYMENT_METHOD_V1_PACKAGE_NAME = "payment_method.v1";
+function PaymentMethodServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = [
+            "getUserPaymentMethods",
+            "createPaymentMethod",
+            "verifyPaymentMethod",
+            "deletePaymentMethod",
+        ];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("PaymentMethodService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("PaymentMethodService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.PAYMENT_METHOD_SERVICE_NAME = "PaymentMethodService";

package/dist/generated/ts/refund.d.ts

@@ -0,0 +1,28 @@
+import { Observable } from "rxjs";
+export declare const protobufPackage = "refund.v1";
+export interface CreateRefundRequest {
+    bookingId: string;
+    userId: string;
+}
+export interface CreateRefundResponse {
+    ok: boolean;
+}
+export interface ProcessRefundEventRequest {
+    event: string;
+    providerRefundId: string;
+    status: string;
+}
+export interface ProcessRefundEventResponse {
+    ok: boolean;
+}
+export declare const REFUND_V1_PACKAGE_NAME = "refund.v1";
+export interface RefundServiceClient {
+    createRefund(request: CreateRefundRequest): Observable<CreateRefundResponse>;
+    processRefundEvent(request: ProcessRefundEventRequest): Observable<ProcessRefundEventResponse>;
+}
+export interface RefundServiceController {
+    createRefund(request: CreateRefundRequest): Promise<CreateRefundResponse> | Observable<CreateRefundResponse> | CreateRefundResponse;
+    processRefundEvent(request: ProcessRefundEventRequest): Promise<ProcessRefundEventResponse> | Observable<ProcessRefundEventResponse> | ProcessRefundEventResponse;
+}
+export declare function RefundServiceControllerMethods(): (constructor: Function) => void;
+export declare const REFUND_SERVICE_NAME = "RefundService";

package/dist/generated/ts/refund.js

@@ -0,0 +1,28 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.0
+//   protoc               v3.21.12
+// source: refund.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REFUND_SERVICE_NAME = exports.REFUND_V1_PACKAGE_NAME = exports.protobufPackage = void 0;
+exports.RefundServiceControllerMethods = RefundServiceControllerMethods;
+/* eslint-disable */
+const microservices_1 = require("@nestjs/microservices");
+exports.protobufPackage = "refund.v1";
+exports.REFUND_V1_PACKAGE_NAME = "refund.v1";
+function RefundServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = ["createRefund", "processRefundEvent"];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("RefundService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("RefundService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.REFUND_SERVICE_NAME = "RefundService";

package/dist/proto/paths.d.ts

@@ -10,4 +10,6 @@ export declare const PROTO_PATHS: {
     readonly SEAT: string;
     readonly SCREENING: string;
     readonly PAYMENT: string;
+    readonly PAYMENT_METHOD: string;
+    readonly REFUND: string;
 };

package/dist/proto/paths.js

@@ -14,4 +14,6 @@ exports.PROTO_PATHS = {
     SEAT: (0, path_1.join)(__dirname, "../../proto/seat.proto"),
     SCREENING: (0, path_1.join)(__dirname, "../../proto/screening.proto"),
     PAYMENT: (0, path_1.join)(__dirname, "../../proto/payment.proto"),
+    PAYMENT_METHOD: (0, path_1.join)(__dirname, "../../proto/payment_method.proto"),
+    REFUND: (0, path_1.join)(__dirname, "../../proto/refund.proto"),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@just-education-org/rpc-contracts",
-  "version": "1.17.2",
+  "version": "1.18.1",
   "description": "Protobuf definitions and generated TS types",
   "main": "dist/index.js",
   "types": "./dist/index.d.ts",

package/proto/payment.proto

@@ -14,6 +14,7 @@ message CreatePaymentRequest {
   optional string payment_method_id = 4;
   bool save_payment_method = 5;
   string currency = 6; // ISO 4217, lowercase (e.g. "usd or uah"), as required by Stripe
+  string booking_id = 7;
 }
 
 message CreatePaymentResponse {
@@ -21,14 +22,24 @@ message CreatePaymentResponse {
 }
 
 message ProcessPaymentEventRequest {
-  string event = 1; // Payment Success | Cancelled | Waiting for Captured?
+  // Our own normalized event type (PAYMENT_SUCCEEDED | PAYMENT_FAILED),
+  // not the provider's raw event type — keeps payment-service provider-agnostic
+  string event = 1;
   string payment_id = 2;
   string booking_id = 3;
   string user_id = 4;
   bool save_payment_method = 5;
   optional string provider_method_id = 6;
+
   optional string card_first6 = 7; // bin
   optional string card_last4 = 8;
+
+  optional string bank = 9;
+  optional string brand = 10;
+
+  // Final payment id at the provider (e.g. Stripe PaymentIntent) —
+  // written to Payment.providerId, replacing the intermediate id (e.g. Checkout Session)
+  optional string provider_intent_id = 11;
 }
 
 message ProcessPaymentEventResponse {

package/proto/payment_method.proto

@@ -0,0 +1,60 @@
+syntax = "proto3";
+
+package payment_method.v1;
+
+service PaymentMethodService {
+  rpc GetUserPaymentMethods(GetUserPaymentMethodsRequest) returns(GetUserPaymentMethodsResponse);
+  rpc CreatePaymentMethod(CreatePaymentMethodRequest) returns(CreatePaymentMethodResponse);
+  rpc VerifyPaymentMethod(VerifyPaymentMethodRequest) returns(VerifyPaymentMethodResponse);
+  rpc DeletePaymentMethod(DeletePaymentMethodRequest) returns(DeletePaymentMethodResponse);
+}
+message GetUserPaymentMethodsRequest {
+  string user_id = 1;
+}
+
+message GetUserPaymentMethodsResponse {
+  repeated PaymentMethodItem methods = 1;
+}
+
+message CreatePaymentMethodRequest {
+  string user_id = 1;
+}
+
+message CreatePaymentMethodResponse {
+  string id = 1;
+  string url = 2;
+}
+
+message VerifyPaymentMethodRequest {
+  // - What is verify for?
+  // - The provider doesn't send a webhook when a payment method gets linked.
+  // We have to check this ourselves: on creation we make a PaymentMethod row
+  // in our DB (no card data yet) linked to the user, and once the user
+  // finishes linking it on the provider's page, the frontend redirects back
+  // with our internal payment method id as a query param — that's when we
+  // call VerifyPaymentMethod to look it up and confirm the link.
+
+  string user_id = 1;
+  string method_id = 2;
+}
+
+message VerifyPaymentMethodResponse {
+  bool ok = 1;
+}
+
+message DeletePaymentMethodRequest {
+  string user_id = 1;
+  string method_id = 2;
+}
+
+message DeletePaymentMethodResponse {
+  bool ok = 1;
+}
+
+message PaymentMethodItem {
+  string id = 1;
+  optional string bank = 2;
+  optional string brand = 3;
+  optional string first6 = 4;
+  optional string last4 = 5;
+}

package/proto/refund.proto

@@ -0,0 +1,27 @@
+syntax = "proto3";
+
+package refund.v1;
+
+service RefundService {
+  rpc CreateRefund(CreateRefundRequest) returns(CreateRefundResponse);
+  rpc ProcessRefundEvent(ProcessRefundEventRequest) returns(ProcessRefundEventResponse);
+}
+
+message CreateRefundRequest {
+  string booking_id = 1;
+  string user_id = 2;
+}
+
+message CreateRefundResponse {
+  bool ok = 1;
+}
+
+message ProcessRefundEventRequest {
+  string event = 1;
+  string provider_refund_id = 2;
+  string status = 3;
+}
+
+message ProcessRefundEventResponse {
+  bool ok = 1;
+}