@rentbase/common 1.0.5

package/build/events/types/payment-events.d.ts

@@ -0,0 +1,287 @@
+/**
+ * Payment Events
+ * Published by payments-wallets-service for payment lifecycle events
+ */
+export interface WalletCreatedEvent {
+    id: string;
+    owner_auth_user_id: string;
+    owner_profile_user_id?: string;
+    owner_type: "rider" | "driver" | "fleet" | "corporate" | "platform";
+    currency: string;
+    balance_available: number;
+    balance_pending: number;
+    balance_reserved: number;
+    status: "active" | "frozen" | "closed";
+    fleet_id?: string;
+    corporate_id?: string;
+    label?: string;
+    created_at: Date;
+}
+export interface WalletAdjustedEvent {
+    id: string;
+    wallet_id: string;
+    owner_auth_user_id: string;
+    type: "credit" | "debit";
+    reason: "adjustment_manual" | "promo_credit" | "fee" | "other";
+    amount: number;
+    currency: string;
+    balance_available_before: number;
+    balance_available_after: number;
+    description: string;
+    admin_auth_user_id?: string;
+    adjusted_at: Date;
+}
+export interface WalletBalanceUpdatedEvent {
+    wallet_id: string;
+    owner_auth_user_id: string;
+    currency: string;
+    balance_available: number;
+    balance_pending: number;
+    balance_reserved: number;
+    previous_balance_available: number;
+    updated_at: Date;
+}
+export interface WalletStatusChangedEvent {
+    wallet_id: string;
+    owner_auth_user_id: string;
+    previous_status: "active" | "frozen" | "closed";
+    new_status: "active" | "frozen" | "closed";
+    reason?: string;
+    changed_by_auth_user_id?: string;
+    changed_at: Date;
+}
+export interface WalletTransactionCreatedEvent {
+    id: string;
+    wallet_id: string;
+    owner_auth_user_id: string;
+    owner_type: "rider" | "driver" | "fleet" | "corporate" | "platform";
+    type: "credit" | "debit";
+    reason: "trip_fare_charge" | "trip_fare_refund" | "driver_earnings" | "platform_commission" | "topup_card" | "topup_mobile_money" | "withdraw_payout" | "adjustment_manual" | "promo_credit" | "fee" | "other";
+    amount: number;
+    currency: string;
+    balance_available_after: number;
+    balance_pending_after: number;
+    balance_reserved_after: number;
+    status: "pending" | "completed" | "failed" | "reversed";
+    trip_id?: string;
+    seat_booking_id?: string;
+    payout_id?: string;
+    payment_intent_id?: string;
+    external_reference?: string;
+    provider_name?: string;
+    description?: string;
+    created_at: Date;
+}
+export interface TransactionStatusChangedEvent {
+    transaction_id: string;
+    wallet_id: string;
+    owner_auth_user_id: string;
+    previous_status: "pending" | "completed" | "failed" | "reversed";
+    new_status: "pending" | "completed" | "failed" | "reversed";
+    reason?: string;
+    changed_at: Date;
+}
+export interface TripRiderChargedEvent {
+    trip_id: string;
+    transaction_id: string;
+    wallet_id: string;
+    rider_auth_user_id: string;
+    amount: number;
+    currency: string;
+    payment_method: "wallet" | "cash" | "card" | "mobile_money";
+    payment_intent_id?: string;
+    seat_booking_id?: string;
+    status: "pending" | "completed";
+    charged_at: Date;
+}
+export interface TripRiderRefundedEvent {
+    trip_id: string;
+    transaction_id: string;
+    wallet_id: string;
+    rider_auth_user_id: string;
+    amount: number;
+    currency: string;
+    reason: string;
+    original_transaction_id?: string;
+    refunded_at: Date;
+}
+export interface TripDriverSettledEvent {
+    trip_id: string;
+    driver_transaction_id: string;
+    driver_wallet_id: string;
+    driver_auth_user_id: string;
+    driver_amount: number;
+    currency: string;
+    fleet_id?: string;
+    fleet_transaction_id?: string;
+    fleet_amount?: number;
+    settled_at: Date;
+}
+export interface TripCommissionAppliedEvent {
+    trip_id: string;
+    transaction_id: string;
+    platform_wallet_id: string;
+    amount: number;
+    currency: string;
+    details?: {
+        base_fare?: number;
+        commission_rate?: number;
+        driver_earnings?: number;
+    };
+    applied_at: Date;
+}
+export interface PaymentIntentCreatedEvent {
+    id: string;
+    auth_user_id: string;
+    profile_user_id?: string;
+    purpose: "trip_fare" | "wallet_topup" | "seat_booking" | "subscription" | "other";
+    amount: number;
+    currency: string;
+    payment_method_type: "card" | "mobile_money" | "bank_transfer" | "cash" | "wallet";
+    payment_provider: string;
+    provider_intent_id?: string;
+    status: "created" | "pending" | "requires_action" | "succeeded" | "failed" | "cancelled" | "expired";
+    trip_id?: string;
+    seat_booking_id?: string;
+    wallet_id?: string;
+    created_at: Date;
+}
+export interface PaymentIntentSucceededEvent {
+    payment_intent_id: string;
+    auth_user_id: string;
+    purpose: "trip_fare" | "wallet_topup" | "seat_booking" | "subscription" | "other";
+    amount: number;
+    currency: string;
+    payment_provider: string;
+    provider_intent_id?: string;
+    wallet_id?: string;
+    wallet_transaction_id?: string;
+    trip_id?: string;
+    seat_booking_id?: string;
+    succeeded_at: Date;
+}
+export interface PaymentIntentFailedEvent {
+    payment_intent_id: string;
+    auth_user_id: string;
+    purpose: "trip_fare" | "wallet_topup" | "seat_booking" | "subscription" | "other";
+    amount: number;
+    currency: string;
+    payment_provider: string;
+    provider_intent_id?: string;
+    failure_code?: string;
+    failure_message?: string;
+    failed_at: Date;
+}
+export interface PaymentIntentCancelledEvent {
+    payment_intent_id: string;
+    auth_user_id: string;
+    amount: number;
+    currency: string;
+    reason?: string;
+    cancelled_at: Date;
+}
+export interface PaymentChargeRefundedEvent {
+    payment_intent_id: string;
+    auth_user_id: string;
+    wallet_id: string;
+    original_amount: number;
+    refund_amount: number;
+    currency: string;
+    payment_provider: string;
+    provider_charge_id?: string;
+    provider_refund_id?: string;
+    transaction_id: string;
+    refunded_at: Date;
+}
+export interface PayoutRequestedEvent {
+    id: string;
+    wallet_id: string;
+    owner_auth_user_id: string;
+    owner_type: "driver" | "fleet" | "corporate";
+    amount: number;
+    currency: string;
+    destination: {
+        method_type: "mobile_money" | "bank_transfer" | "card_refund" | "cash_manual";
+        provider: string;
+        account_name?: string;
+        account_number?: string;
+        mobile_number?: string;
+    };
+    provider_name: string;
+    status: "created" | "pending" | "processing" | "succeeded" | "failed" | "cancelled";
+    requested_by_auth_user_id: string;
+    requested_at: Date;
+}
+export interface PayoutApprovedEvent {
+    payout_id: string;
+    wallet_id: string;
+    owner_auth_user_id: string;
+    amount: number;
+    currency: string;
+    approved_by_auth_user_id: string;
+    notes?: string;
+    approved_at: Date;
+}
+export interface PayoutProcessingEvent {
+    payout_id: string;
+    wallet_id: string;
+    owner_auth_user_id: string;
+    amount: number;
+    currency: string;
+    provider_name: string;
+    provider_payout_id?: string;
+    provider_batch_id?: string;
+    processing_at: Date;
+}
+export interface PayoutSucceededEvent {
+    payout_id: string;
+    wallet_id: string;
+    owner_auth_user_id: string;
+    amount: number;
+    currency: string;
+    provider_name: string;
+    provider_payout_id?: string;
+    provider_status?: string;
+    debit_transaction_id?: string;
+    succeeded_at: Date;
+}
+export interface PayoutFailedEvent {
+    payout_id: string;
+    wallet_id: string;
+    owner_auth_user_id: string;
+    amount: number;
+    currency: string;
+    provider_name: string;
+    provider_error_code?: string;
+    provider_error_message?: string;
+    failed_at: Date;
+}
+export interface PayoutCancelledEvent {
+    payout_id: string;
+    wallet_id: string;
+    owner_auth_user_id: string;
+    amount: number;
+    currency: string;
+    reason?: string;
+    cancelled_by_auth_user_id?: string;
+    cancelled_at: Date;
+}
+export interface WebhookReceivedEvent {
+    provider: string;
+    event_type: string;
+    provider_event_id?: string;
+    payment_intent_id?: string;
+    payout_id?: string;
+    status: "processing" | "succeeded" | "failed";
+    received_at: Date;
+}
+export interface WebhookProcessedEvent {
+    provider: string;
+    event_type: string;
+    provider_event_id?: string;
+    payment_intent_id?: string;
+    payout_id?: string;
+    processing_result: "success" | "failed" | "skipped";
+    error_message?: string;
+    processed_at: Date;
+}

package/build/events/types/payment-events.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Payment Events
+ * Published by payments-wallets-service for payment lifecycle events
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/events/types/promotion-events.d.ts

@@ -0,0 +1,236 @@
+/**
+ * Promotions & Referrals Events
+ * Published by promotions-referrals-service for promotion lifecycle events
+ */
+export interface CampaignCreatedEvent {
+    campaign_id: string;
+    name: string;
+    type: "generic_promo" | "referral_program" | "welcome_bonus" | "retention_offer" | "fleet_promo" | "other";
+    status: "draft" | "active" | "paused" | "expired";
+    discount_type: "flat" | "percentage";
+    discount_value: number;
+    max_discount_amount?: number;
+    starts_at?: string;
+    ends_at?: string;
+    max_total_redemptions?: number;
+    max_per_user_redemptions?: number;
+    fleet_id?: string;
+    created_by_auth_user_id?: string;
+    created_at: string;
+}
+export interface CampaignActivatedEvent {
+    campaign_id: string;
+    name: string;
+    type: string;
+    discount_type: "flat" | "percentage";
+    discount_value: number;
+    starts_at?: string;
+    ends_at?: string;
+    max_total_redemptions?: number;
+    activated_at: string;
+}
+export interface CampaignStatusChangedEvent {
+    campaign_id: string;
+    name: string;
+    previous_status: "draft" | "active" | "paused" | "expired";
+    new_status: "draft" | "active" | "paused" | "expired";
+    changed_by_auth_user_id?: string;
+    changed_at: string;
+}
+export interface CampaignExpiredEvent {
+    campaign_id: string;
+    name: string;
+    type: string;
+    total_redemptions: number;
+    max_total_redemptions?: number;
+    expired_at: string;
+}
+export interface PromoCodeCreatedEvent {
+    promo_code_id: string;
+    code: string;
+    campaign_id?: string;
+    status: "active" | "inactive" | "expired" | "exhausted";
+    max_total_redemptions?: number;
+    max_per_user_redemptions?: number;
+    owner_auth_user_id?: string;
+    owner_role?: "rider" | "driver";
+    valid_from?: string;
+    valid_until?: string;
+    is_referral_code: boolean;
+    created_by_auth_user_id?: string;
+    created_at: string;
+}
+export interface PromoCodeBulkCreatedEvent {
+    campaign_id: string;
+    count: number;
+    prefix: string;
+    codes_generated: string[];
+    created_by_auth_user_id?: string;
+    created_at: string;
+}
+export interface PromoCodeAppliedEvent {
+    promo_code_id: string;
+    code: string;
+    campaign_id?: string;
+    auth_user_id: string;
+    trip_estimate_amount?: number;
+    discount_amount: number;
+    currency: string;
+    applied_at: string;
+}
+export interface PromoCodeStatusChangedEvent {
+    promo_code_id: string;
+    code: string;
+    previous_status: "active" | "inactive" | "expired" | "exhausted";
+    new_status: "active" | "inactive" | "expired" | "exhausted";
+    current_redemptions: number;
+    max_total_redemptions?: number;
+    changed_by_auth_user_id?: string;
+    changed_at: string;
+}
+export interface ReferralCodeGeneratedEvent {
+    promo_code_id: string;
+    code: string;
+    referrer_auth_user_id: string;
+    referrer_role?: "rider" | "driver";
+    campaign_id?: string;
+    generated_at: string;
+}
+export interface ReferralClaimedEvent {
+    referral_id: string;
+    promo_code_id: string;
+    code: string;
+    campaign_id?: string;
+    referrer_auth_user_id: string;
+    referrer_role?: "rider" | "driver";
+    referee_auth_user_id: string;
+    referee_role?: "rider" | "driver";
+    status: "pending";
+    created_from_ip?: string;
+    created_from_device_id?: string;
+    claimed_at: string;
+}
+export interface ReferralQualifiedEvent {
+    referral_id: string;
+    campaign_id?: string;
+    referrer_auth_user_id: string;
+    referee_auth_user_id: string;
+    qualification_reason: "trip_completed" | "multiple_trips_completed" | "wallet_topped_up" | "other";
+    required_trips?: number;
+    completed_trips: number;
+    qualified_at: string;
+}
+export interface ReferralRewardsGrantedEvent {
+    referral_id: string;
+    campaign_id?: string;
+    referrer_auth_user_id: string;
+    referee_auth_user_id: string;
+    referrer_reward_credit_id: string;
+    referee_reward_credit_id: string;
+    reward_amount: number;
+    currency: string;
+    granted_at: string;
+}
+export interface ReferralStatusChangedEvent {
+    referral_id: string;
+    referrer_auth_user_id: string;
+    referee_auth_user_id: string;
+    previous_status: "pending" | "qualified" | "rewards_granted" | "expired" | "cancelled";
+    new_status: "pending" | "qualified" | "rewards_granted" | "expired" | "cancelled";
+    changed_by_auth_user_id?: string;
+    changed_at: string;
+}
+export interface RewardCreditIssuedEvent {
+    reward_credit_id: string;
+    auth_user_id: string;
+    role?: "rider" | "driver";
+    amount: number;
+    currency: string;
+    is_percentage: boolean;
+    percentage_value?: number;
+    max_discount_amount?: number;
+    source_type: "promo_code" | "referral_referrer" | "referral_referee" | "welcome_bonus" | "retention_offer" | "manual_adjustment" | "other";
+    campaign_id?: string;
+    promo_code_id?: string;
+    referral_id?: string;
+    valid_from?: string;
+    valid_until?: string;
+    issued_by_auth_user_id?: string;
+    issued_at: string;
+}
+export interface RewardCreditUsedEvent {
+    reward_credit_id: string;
+    auth_user_id: string;
+    amount: number;
+    currency: string;
+    source_type: string;
+    trip_id: string;
+    payment_intent_id: string;
+    discount_applied: number;
+    used_at: string;
+}
+export interface RewardCreditExpiredEvent {
+    reward_credit_id: string;
+    auth_user_id: string;
+    amount: number;
+    currency: string;
+    source_type: string;
+    valid_until: string;
+    expired_at: string;
+}
+export interface RewardCreditCancelledEvent {
+    reward_credit_id: string;
+    auth_user_id: string;
+    amount: number;
+    currency: string;
+    source_type: string;
+    reason?: string;
+    cancelled_by_auth_user_id?: string;
+    cancelled_at: string;
+}
+export interface DiscountCalculatedEvent {
+    auth_user_id: string;
+    trip_estimate_amount: number;
+    currency: string;
+    discount_type: "reward" | "promo" | "none";
+    discount_amount: number;
+    final_amount: number;
+    applied_reward_credit_id?: string;
+    applied_promo_code?: string;
+    calculated_at: string;
+}
+export interface DiscountAppliedEvent {
+    auth_user_id: string;
+    trip_id: string;
+    payment_intent_id: string;
+    original_amount: number;
+    discount_amount: number;
+    final_amount: number;
+    currency: string;
+    discount_source: "reward_credit" | "promo_code";
+    reward_credit_id?: string;
+    promo_code_id?: string;
+    promo_code?: string;
+    applied_at: string;
+}
+export interface CampaignRedemptionEvent {
+    campaign_id: string;
+    campaign_name: string;
+    campaign_type: string;
+    auth_user_id: string;
+    promo_code_id?: string;
+    promo_code?: string;
+    discount_amount: number;
+    currency: string;
+    trip_id?: string;
+    redeemed_at: string;
+}
+export interface ReferralConversionEvent {
+    referral_id: string;
+    campaign_id?: string;
+    referrer_auth_user_id: string;
+    referee_auth_user_id: string;
+    conversion_type: "signup" | "first_trip" | "qualified" | "rewards_granted";
+    days_to_convert: number;
+    converted_at: string;
+}

package/build/events/types/promotion-events.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Promotions & Referrals Events
+ * Published by promotions-referrals-service for promotion lifecycle events
+ */
+Object.defineProperty(exports, "__esModule", { value: true });