@mamindom/contracts 1.0.49 → 1.0.51

package/dist/proto/calculation.proto

@@ -0,0 +1,66 @@
+syntax = "proto3";
+
+package promo.v1;
+
+import "common_promo.proto";
+
+
+service PromoCalculationService {
+  
+  rpc ValidateAndCalculate (ValidateAndCalculateRequest) returns (ValidateAndCalculateResponse);
+
+  
+  rpc ApplyPromotion (ApplyPromotionRequest) returns (SuccessResponse);
+}
+
+
+message CartItem {
+  string product_id  = 1;
+  string category_id = 2;
+  string brand_id    = 3;
+  int32  quantity    = 4;
+  double price       = 5; 
+}
+
+
+message ValidateAndCalculateRequest {
+  string          user_id      = 1;
+  repeated CartItem items      = 2;
+  double          order_total  = 3; 
+  optional string coupon_code  = 4; 
+  bool            is_first_order = 5; 
+  int32           order_count  = 6; 
+}
+
+message ValidateAndCalculateResponse {
+  bool   is_valid        = 1; 
+  double discount_amount = 2; 
+  double final_total     = 3;
+
+  repeated AppliedPromotion applied_promotions = 4;
+  optional AppliedCoupon    applied_coupon     = 5;
+
+  optional string error_message = 6; 
+}
+
+message AppliedPromotion {
+  string promotion_id   = 1;
+  string promotion_name = 2;
+  double discount_amount = 3;
+}
+
+message AppliedCoupon {
+  string coupon_id      = 1;
+  string code           = 2;
+  string promotion_id   = 3;
+  double discount_amount = 4;
+}
+
+
+message ApplyPromotionRequest {
+  string          user_id        = 1;
+  string          order_id       = 2;
+  double          discount_amount = 3;
+  optional string coupon_code    = 4;
+  repeated string promotion_ids  = 5;
+}

package/dist/proto/common_promo.proto

@@ -0,0 +1,23 @@
+syntax = "proto3";
+
+package promo.v1;
+
+message SuccessResponse {
+  bool success = 1;
+}
+
+message DeleteResponse {
+  bool success = 1;
+}
+
+message PaginationRequest {
+  int32 page = 1;
+  int32 limit = 2;
+}
+
+message PaginationMeta {
+  int32 total_items = 1;
+  int32 total_pages = 2;
+  int32 current_page = 3;
+  int32 per_page = 4;
+}

package/dist/proto/coupon.proto

@@ -0,0 +1,121 @@
+syntax = "proto3";
+
+package promo.v1;
+
+import "common_promo.proto";
+
+
+service CouponService {
+  rpc GetCoupons      (GetCouponsRequest)      returns (GetCouponsResponse);
+  rpc GetCoupon       (GetCouponRequest)       returns (CouponResponse);
+  rpc CreateCoupon    (CreateCouponRequest)    returns (CouponResponse);
+  rpc UpdateCoupon    (UpdateCouponRequest)    returns (CouponResponse);
+  rpc DeactivateCoupon (DeactivateCouponRequest) returns (SuccessResponse);
+
+  
+  rpc GenerateCoupons (GenerateCouponsRequest) returns (GenerateCouponsResponse);
+
+  
+  rpc ExportCoupons   (ExportCouponsRequest)   returns (ExportCouponsResponse);
+  rpc ImportCoupons   (ImportCouponsRequest)   returns (ImportCouponsResponse);
+}
+
+
+message CouponResponse {
+  string id           = 1;
+  string promotion_id = 2;
+  string code         = 3;
+
+  optional int32 usage_limit_total    = 4;
+  optional int32 usage_limit_per_user = 5;
+  int32          usage_count          = 6;
+
+  bool            is_active  = 7;
+  optional string expires_at = 8; 
+
+  string created_at = 9;
+}
+
+
+message GetCouponsRequest {
+  PaginationRequest pagination   = 1;
+  optional string   promotion_id = 2;
+  optional bool     is_active    = 3;
+  optional string   search       = 4; 
+}
+
+message GetCouponsResponse {
+  repeated CouponResponse items = 1;
+  PaginationMeta          meta  = 2;
+}
+
+
+message GetCouponRequest {
+  string id = 1;
+  optional string code = 2; 
+}
+
+
+message CreateCouponRequest {
+  string promotion_id = 1;
+  string code         = 2; 
+
+  optional int32  usage_limit_total    = 3;
+  optional int32  usage_limit_per_user = 4;
+  optional string expires_at           = 5;
+  bool            is_active            = 6;
+}
+
+
+message UpdateCouponRequest {
+  string id = 1;
+
+  optional int32  usage_limit_total    = 2;
+  optional int32  usage_limit_per_user = 3;
+  optional string expires_at           = 4;
+  optional bool   is_active            = 5;
+}
+
+
+message DeactivateCouponRequest {
+  string id = 1;
+}
+
+
+message GenerateCouponsRequest {
+  string promotion_id = 1;
+  int32  count        = 2; 
+
+  
+  optional string prefix       = 3;
+  optional int32  random_length = 4;
+
+  optional int32  usage_limit_per_user = 5;
+  optional string expires_at           = 6;
+}
+
+message GenerateCouponsResponse {
+  int32 generated = 1; 
+}
+
+
+message ExportCouponsRequest {
+  string promotion_id = 1;
+  optional bool active_only = 2; 
+}
+
+message ExportCouponsResponse {
+  string csv_content = 1; 
+}
+
+
+message ImportCouponsRequest {
+  string promotion_id = 1;
+  string csv_content  = 2; 
+}
+
+message ImportCouponsResponse {
+  int32 imported = 1; 
+  int32 skipped  = 2; 
+  repeated string errors = 3; 
+}

package/dist/proto/promotion.proto

@@ -0,0 +1,257 @@
+syntax = "proto3";
+
+package promo.v1;
+
+import "common_promo.proto";
+
+
+service PromotionService {
+  
+  rpc GetPromotions       (GetPromotionsRequest)       returns (GetPromotionsResponse);
+  rpc GetPromotion        (GetPromotionRequest)        returns (PromotionResponse);
+  rpc CreatePromotion     (CreatePromotionRequest)     returns (PromotionResponse);
+  rpc UpdatePromotion     (UpdatePromotionRequest)     returns (PromotionResponse);
+  rpc DeletePromotion     (DeletePromotionRequest)     returns (DeleteResponse);
+
+ 
+  rpc BulkApplyToCategories (BulkApplyToCategoriesRequest) returns (SuccessResponse);
+
+  
+  rpc GetActivePromotions (GetActivePromotionsRequest) returns (GetActivePromotionsResponse);
+}
+
+
+enum PromotionType {
+  PROMOTION_TYPE_UNSPECIFIED  = 0;
+  PROMOTION_TYPE_FIXED        = 1; 
+  PROMOTION_TYPE_PERCENTAGE   = 2; 
+  PROMOTION_TYPE_COUPON       = 3;
+  PROMOTION_TYPE_BUY_N_GET_M  = 4; 
+  PROMOTION_TYPE_FIRST_ORDER  = 5; 
+  PROMOTION_TYPE_LOYALTY      = 6;
+  PROMOTION_TYPE_PROMO_PERIOD = 7; 
+}
+
+enum DiscountType {
+  DISCOUNT_TYPE_UNSPECIFIED = 0;
+  DISCOUNT_TYPE_FIXED       = 1; 
+  DISCOUNT_TYPE_PERCENTAGE  = 2; 
+}
+
+enum PromotionStatus {
+  PROMOTION_STATUS_UNSPECIFIED = 0;
+  PROMOTION_STATUS_DRAFT       = 1;
+  PROMOTION_STATUS_ACTIVE      = 2;
+  PROMOTION_STATUS_INACTIVE    = 3;
+  PROMOTION_STATUS_EXPIRED     = 4;
+}
+
+enum ConditionLogic {
+  CONDITION_LOGIC_UNSPECIFIED = 0;
+  CONDITION_LOGIC_AND         = 1;
+  CONDITION_LOGIC_OR          = 2;
+}
+
+enum ConditionType {
+  CONDITION_TYPE_UNSPECIFIED      = 0;
+  CONDITION_TYPE_PRODUCT          = 1;
+  CONDITION_TYPE_CATEGORY         = 2;
+  CONDITION_TYPE_BRAND            = 3;
+  CONDITION_TYPE_USER_GROUP       = 4;
+  CONDITION_TYPE_FIRST_ORDER      = 5;
+  CONDITION_TYPE_MIN_ORDER_COUNT  = 6;
+  CONDITION_TYPE_MIN_AMOUNT       = 7;
+}
+
+enum ExclusionEntityType {
+  EXCLUSION_ENTITY_UNSPECIFIED = 0;
+  EXCLUSION_ENTITY_PRODUCT     = 1;
+  EXCLUSION_ENTITY_CATEGORY    = 2;
+  EXCLUSION_ENTITY_BRAND       = 3;
+}
+
+
+message PromotionConditionPayload {
+  ConditionLogic logic_type     = 1;
+  ConditionType  condition_type = 2;
+  string         value          = 3; 
+}
+
+message PromotionExclusionPayload {
+  ExclusionEntityType entity_type = 1;
+  string              entity_id   = 2;
+}
+
+message PromotionConditionResponse {
+  string         id             = 1;
+  ConditionLogic logic_type     = 2;
+  ConditionType  condition_type = 3;
+  string         value          = 4;
+}
+
+message PromotionExclusionResponse {
+  string              id          = 1;
+  ExclusionEntityType entity_type = 2;
+  string              entity_id   = 3;
+}
+
+
+message PromotionResponse {
+  string          id           = 1;
+  map<string, string> name     = 2;
+  map<string, string> description = 3;
+
+  PromotionType   type         = 4;
+  DiscountType    discount_type = 5;
+  PromotionStatus status       = 6;
+
+  double discount_value        = 7;
+
+  optional string starts_at    = 8;  
+  optional string ends_at      = 9;
+
+  optional double min_order_amount     = 10;
+  optional int32  usage_limit_total    = 11;
+  optional int32  usage_limit_per_user = 12;
+  int32           usage_count          = 13;
+
+  bool is_active    = 14;
+  bool is_exclusive = 15;
+
+ 
+  optional int32 buy_quantity = 16;
+  optional int32 get_quantity = 17;
+
+
+  optional string             seo_slug        = 18;
+  map<string, string>         seo_title       = 19;
+  map<string, string>         seo_description = 20;
+
+  string created_by_id = 21;
+  string created_at    = 22;
+  string updated_at    = 23;
+
+  repeated PromotionConditionResponse conditions = 24;
+  repeated PromotionExclusionResponse exclusions = 25;
+}
+
+
+message GetPromotionsRequest {
+  PaginationRequest pagination = 1;
+
+  optional PromotionType   type       = 2;
+  optional PromotionStatus status     = 3;
+  optional string          search     = 4;
+  optional string          category_id = 5;
+  optional string          date_from  = 6; 
+  optional string          date_to    = 7;
+}
+
+message GetPromotionsResponse {
+  repeated PromotionListItem items = 1;
+  PaginationMeta             meta  = 2;
+}
+
+message PromotionListItem {
+  string          id           = 1;
+  map<string, string> name     = 2;
+  PromotionType   type         = 3;
+  PromotionStatus status       = 4;
+  optional string starts_at    = 5;
+  optional string ends_at      = 6;
+  int32           usage_count  = 7;
+  bool            is_active    = 8;
+  string          created_at   = 9;
+}
+
+
+message GetPromotionRequest {
+  string id = 1;
+}
+
+
+message CreatePromotionRequest {
+  map<string, string> name        = 1;
+  map<string, string> description = 2;
+
+  PromotionType  type          = 3;
+  DiscountType   discount_type = 4;
+  double         discount_value = 5;
+
+  optional string starts_at = 6;
+  optional string ends_at   = 7;
+
+  optional double min_order_amount     = 8;
+  optional int32  usage_limit_total    = 9;
+  optional int32  usage_limit_per_user = 10;
+
+  bool is_active    = 11;
+  bool is_exclusive = 12;
+
+  optional int32 buy_quantity = 13;
+  optional int32 get_quantity = 14;
+
+  optional string     seo_slug        = 15;
+  map<string, string> seo_title       = 16;
+  map<string, string> seo_description = 17;
+
+  string created_by_id = 18;
+
+  repeated PromotionConditionPayload conditions = 19;
+  repeated PromotionExclusionPayload exclusions = 20;
+}
+
+
+message UpdatePromotionRequest {
+  string id = 1;
+
+  map<string, string> name        = 2;
+  map<string, string> description = 3;
+
+  optional PromotionType   type          = 4;
+  optional DiscountType    discount_type = 5;
+  optional double          discount_value = 6;
+
+  optional string starts_at = 7;
+  optional string ends_at   = 8;
+
+  optional double min_order_amount     = 9;
+  optional int32  usage_limit_total    = 10;
+  optional int32  usage_limit_per_user = 11;
+
+  optional bool is_active    = 12;
+  optional bool is_exclusive = 13;
+
+  optional int32 buy_quantity = 14;
+  optional int32 get_quantity = 15;
+
+  optional string     seo_slug        = 16;
+  map<string, string> seo_title       = 17;
+  map<string, string> seo_description = 18;
+
+  
+  repeated PromotionConditionPayload conditions = 19;
+  repeated PromotionExclusionPayload exclusions = 20;
+}
+
+
+message DeletePromotionRequest {
+  string id = 1;
+}
+
+
+message BulkApplyToCategoriesRequest {
+  string          promotion_id = 1;
+  repeated string category_ids = 2;
+}
+
+
+message GetActivePromotionsRequest {
+  PaginationRequest pagination = 1;
+  optional string   lang       = 2;
+}
+
+message GetActivePromotionsResponse {
+  repeated PromotionListItem items = 1;
+  PaginationMeta             meta  = 2;
+}

package/dist/src/proto/paths.d.ts

@@ -10,4 +10,8 @@ export declare const PROTO_PATHS: {
     readonly MEDIA: string;
     readonly SIZE_CHART: string;
     readonly STICKER: string;
+    readonly COMMON_PROMO: string;
+    readonly CALCULATION: string;
+    readonly COUPON: string;
+    readonly PROMOTION: string;
 };

package/dist/src/proto/paths.js

@@ -13,5 +13,9 @@ exports.PROTO_PATHS = {
     PRODUCT: (0, node_path_1.join)(__dirname, '../../proto/product.proto'),
     MEDIA: (0, node_path_1.join)(__dirname, '../../proto/media.proto'),
     SIZE_CHART: (0, node_path_1.join)(__dirname, '../../proto/size_chart.proto'),
-    STICKER: (0, node_path_1.join)(__dirname, '../../proto/sticker.proto')
+    STICKER: (0, node_path_1.join)(__dirname, '../../proto/sticker.proto'),
+    COMMON_PROMO: (0, node_path_1.join)(__dirname, '../../proto/common_promo.proto'),
+    CALCULATION: (0, node_path_1.join)(__dirname, '../../proto/calculation.proto'),
+    COUPON: (0, node_path_1.join)(__dirname, '../../proto/coupon.proto'),
+    PROMOTION: (0, node_path_1.join)(__dirname, '../../proto/promotion.proto')
 };

package/gen/calculation.ts

@@ -0,0 +1,94 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.4
+//   protoc               v3.21.12
+// source: calculation.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+import { SuccessResponse } from "./common_promo";
+
+export const protobufPackage = "promo.v1";
+
+export interface CartItem {
+  productId: string;
+  categoryId: string;
+  brandId: string;
+  quantity: number;
+  price: number;
+}
+
+export interface ValidateAndCalculateRequest {
+  userId: string;
+  items: CartItem[];
+  orderTotal: number;
+  couponCode?: string | undefined;
+  isFirstOrder: boolean;
+  orderCount: number;
+}
+
+export interface ValidateAndCalculateResponse {
+  isValid: boolean;
+  discountAmount: number;
+  finalTotal: number;
+  appliedPromotions: AppliedPromotion[];
+  appliedCoupon?: AppliedCoupon | undefined;
+  errorMessage?: string | undefined;
+}
+
+export interface AppliedPromotion {
+  promotionId: string;
+  promotionName: string;
+  discountAmount: number;
+}
+
+export interface AppliedCoupon {
+  couponId: string;
+  code: string;
+  promotionId: string;
+  discountAmount: number;
+}
+
+export interface ApplyPromotionRequest {
+  userId: string;
+  orderId: string;
+  discountAmount: number;
+  couponCode?: string | undefined;
+  promotionIds: string[];
+}
+
+export const PROMO_V1_PACKAGE_NAME = "promo.v1";
+
+export interface PromoCalculationServiceClient {
+  validateAndCalculate(request: ValidateAndCalculateRequest): Observable<ValidateAndCalculateResponse>;
+
+  applyPromotion(request: ApplyPromotionRequest): Observable<SuccessResponse>;
+}
+
+export interface PromoCalculationServiceController {
+  validateAndCalculate(
+    request: ValidateAndCalculateRequest,
+  ): Promise<ValidateAndCalculateResponse> | Observable<ValidateAndCalculateResponse> | ValidateAndCalculateResponse;
+
+  applyPromotion(
+    request: ApplyPromotionRequest,
+  ): Promise<SuccessResponse> | Observable<SuccessResponse> | SuccessResponse;
+}
+
+export function PromoCalculationServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = ["validateAndCalculate", "applyPromotion"];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("PromoCalculationService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("PromoCalculationService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const PROMO_CALCULATION_SERVICE_NAME = "PromoCalculationService";

package/gen/common_promo.ts

@@ -0,0 +1,31 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.4
+//   protoc               v3.21.12
+// source: common_promo.proto
+
+/* eslint-disable */
+
+export const protobufPackage = "promo.v1";
+
+export interface SuccessResponse {
+  success: boolean;
+}
+
+export interface DeleteResponse {
+  success: boolean;
+}
+
+export interface PaginationRequest {
+  page: number;
+  limit: number;
+}
+
+export interface PaginationMeta {
+  totalItems: number;
+  totalPages: number;
+  currentPage: number;
+  perPage: number;
+}
+
+export const PROMO_V1_PACKAGE_NAME = "promo.v1";