gotrip-fx-transaction-form 1.0.192-dev → 1.0.192

package/types/types/coupon.d.ts

@@ -0,0 +1,70 @@
+export declare enum ECouponProductType {
+    BIKE_COMPULSORY = "bike_compulsory",
+    CAR_COMPULSORY = "car_compulsory",
+    TRAVEL_DOMESTIC = "travel_domestic",
+    TRAVEL_INTERNATIONAL = "travel_international",
+    ESIM = "esim"
+}
+export type TCouponStatus = 'active' | 'inactive';
+export type TCampaignStatus = 'active' | 'inactive';
+export type TCampaignRef = {
+    id: number;
+    name: string;
+    status: TCampaignStatus;
+};
+export type TCouponConditions = {
+    minOrderValue: number | null;
+    firstOrderOnly: boolean;
+    flashSaleStart: string | null;
+    flashSaleEnd: string | null;
+};
+export type TCouponRow = {
+    id: number;
+    code: string;
+    name: string | null;
+    campaignId?: number | null;
+    campaign?: TCampaignRef | null;
+    status: string;
+    usedCount: number;
+    totalUsageLimit: number | null;
+    expireAt: string;
+    startAt?: string;
+    createdAt?: string;
+    discountType: string;
+    discountValue: number;
+    maxDiscountAmount?: number | null;
+    productTypes?: string[] | null;
+    providers?: string[] | null;
+};
+export type TCampaignRow = {
+    id: number;
+    name: string;
+    status: TCampaignStatus;
+    totalCoupons: number;
+    usedCoupons: number;
+    createdAt: string;
+};
+export type TCouponAdminSummary = {
+    totalCoupons: number;
+    activeCoupons: number;
+    usageToday: number;
+    totalDiscountAmountThisMonth: number;
+};
+export type TCouponDetail = {
+    campaignId?: number | null;
+    code: string;
+    name: string | null;
+    description?: string | null;
+    status?: TCouponStatus;
+    startAt: string;
+    expireAt: string;
+    totalUsageLimit: number | null;
+    tenantIds?: number[] | null;
+    userIds?: number[] | null;
+    discountType: string;
+    discountValue: number;
+    maxDiscountAmount: number | null;
+    conditions?: TCouponConditions;
+    productTypes: string[] | null;
+    providers: string[] | null;
+};

package/types/types/enum.d.ts

@@ -16,6 +16,8 @@ export declare enum TransactionStatus {
 }
 export declare enum EsimTransactionStatus {
     CREATED = "created",
+    PENDING_PAYMENT = "pending_payment",
+    PAID = "paid",
     WAITING_FOR_RETURN = "waiting_for_return",
     RETURNED = "returned",
     OUT_OF_STOCK = "out_of_stock",
@@ -93,7 +95,18 @@ export declare const E_TOP_UP_VALUES: {
 export declare enum EPaymentMethod {
     PRIMARY_BALANCE = "primary_balance",
     TOPUP_BALANCE = "topup_balance",
-    BANK_TRANSFER = "bank_transfer"
+    BANK_TRANSFER = "bank_transfer",
+    ADMIN_PAYMENT = "admin_payment"
+}
+/** Wallet vs bank QR; matches API `EPaymentMode` (eSIM create / list). */
+export declare enum EPaymentMode {
+    TOPUP_BALANCE = "topup_balance",
+    BANK_TRANSFER = "bank_transfer",
+    ADMIN_PAYMENT = "admin_payment"
+}
+export declare enum EOrderPaymentType {
+    UP_FRONT = "up_front",
+    DEFERRED = "deferred"
 }
 export declare enum EInsuranceTransactionStatus {
     PENDING = "pending",

package/types/types/insurance-transaction.dto.d.ts

@@ -1,4 +1,5 @@
-import { EGender, EIdType, EInsuranceType, EPersonType, EPolicyStatus, EPolicyType, EQuoteStatus, ERelationToPrimary, ETravelType } from './insurance';
+import { EGender, EIdType, EInsuranceType, EApprovalStatus, EPersonType, EPolicyStatus, EPolicyType, EQuoteStatus, ERelationToPrimary, ETravelScope, ETravelType } from './insurance';
+import { EOrderPaymentType } from './enum';
 import { ITransaction } from './response.dto';
 export interface InsuranceQuoteInsured {
     id: number;
@@ -36,6 +37,8 @@ export interface InsuranceQuote {
     travelType: ETravelType;
     destination?: string;
     destinationId?: number;
+    provinceFromId?: number;
+    provinceToId?: number;
     basePremium: number;
     taxAmount: number;
     totalPremium: number;
@@ -84,8 +87,13 @@ export interface InsuranceTransaction {
     type: EInsuranceType;
     policyType: EPolicyType;
     travelType: ETravelType;
+    travelScope: ETravelScope;
     status: EPolicyStatus;
     totalAmount: number;
+    premiumBeforeDiscount?: number;
+    couponId?: number;
+    couponCode?: string;
+    couponDiscountAmount?: number;
     providerPolicyId?: string;
     providerPolicyNumber?: string;
     providerData?: Record<string, any>;
@@ -94,6 +102,18 @@ export interface InsuranceTransaction {
     documents?: InsurancePolicyDocument[];
     userId?: number;
     tenantId?: number;
+    paymentTypeApplied?: EOrderPaymentType;
+    paidAmount?: number;
+    unpaidAmount?: number;
+    isBypassed?: boolean;
+    approvalStatus?: EApprovalStatus | null;
+    approvalBypassed?: boolean;
+    createdByAdminId?: number | null;
+    updatedByAdminId?: number | null;
+    approvedAt?: string | null;
+    rejectedAt?: string | null;
+    rejectionReasonCode?: string | null;
+    rejectionReasonText?: string | null;
     createdAt: string;
     updatedAt: string;
     quote?: InsuranceQuote;

package/types/types/insurance.d.ts

@@ -2,6 +2,10 @@ export declare enum ETravelType {
     SINGLE = "single",
     ANNUAL = "annual"
 }
+export declare enum ETravelScope {
+    INTERNATIONAL = "international",
+    DOMESTIC = "domestic"
+}
 export declare enum ERelationToPrimary {
     SELF = "self",
     SPOUSE = "spouse",
@@ -20,13 +24,16 @@ export declare enum ERelationToPrimary {
 }
 export declare enum EIdType {
     PASSPORT = "passport",
-    ID_CARD = "id_card"
+    ID_CARD = "id_card",
+    TAX_CODE = "tax_code"
 }
 export declare enum EInsuranceProviderType {
     TMIV = "TMIV",
     MSIG = "MSIG",
-    PVI = "PVI"
+    PVI = "PVI",
+    MIC = "MIC"
 }
+export declare const INSURANCE_PROVIDER_LABELS: Record<EInsuranceProviderType, string>;
 export declare enum EInsuranceType {
     INDIVIDUAL = "individual",
     FAMILY = "family",
@@ -55,6 +62,11 @@ export declare enum EPolicyStatus {
     PENDING = "pending",
     FAILED = "failed"
 }
+export declare enum EApprovalStatus {
+    PENDING_APPROVAL = "pending_approval",
+    APPROVED = "approved",
+    REJECTED = "rejected"
+}
 export declare enum EDestination {
     WORLDWIDE = "worldwide",
     ASIA = "asia",
@@ -62,6 +74,7 @@ export declare enum EDestination {
 }
 export declare enum EPersonType {
     ADULT = "adult",
+    TEENAGER = "teenager",
     CHILDREN = "children"
 }
 export declare enum EPersonValidationStatus {
@@ -69,3 +82,7 @@ export declare enum EPersonValidationStatus {
     NEEDS_CHECK = "needs_check",
     NOT_ENTERED = "not_entered"
 }
+export declare enum EBuyerType {
+    INDIVIDUAL = "individual",
+    COMPANY = "company"
+}

package/types/types/notification.d.ts

@@ -0,0 +1,23 @@
+export declare enum ENotificationType {
+    INSURANCE_PENDING_APPROVAL = "insurance_pending_approval",
+    INSURANCE_APPROVED = "insurance_approved",
+    INSURANCE_REJECTED = "insurance_rejected",
+    INSURANCE_UPDATED = "insurance_updated",
+    MOTOR_INSURANCE_PENDING_APPROVAL = "motor_insurance_pending_approval",
+    MOTOR_INSURANCE_APPROVED = "motor_insurance_approved",
+    MOTOR_INSURANCE_REJECTED = "motor_insurance_rejected",
+    MOTOR_INSURANCE_UPDATED = "motor_insurance_updated"
+}
+export interface INotification {
+    id: number;
+    type: ENotificationType;
+    title: string;
+    message: string;
+    isRead: boolean;
+    readAt: string | null;
+    metadata: {
+        path?: string;
+        publicId?: string;
+    } | null;
+    createdAt: string;
+}

package/types/types/response.dto.d.ts

@@ -1,4 +1,5 @@
-import { ECommissionPolicyCalculationType, ECommissionPolicyType, ESimDomesticServices, EsimTransactionStatus, ETenantType, EUseCaseses, TransactionStatus } from './enum';
+import { ECommissionPolicyType, EPaymentMode, EOrderPaymentType, ESimDomesticServices, EsimTransactionStatus, ETenantType, EUseCaseses, TransactionStatus } from './enum';
+import { EPolicyActionType } from '../constants/policy-enums';
 import { EPermissionKey, EUserRole, EUserStatus } from './user';
 export type LoginRespDto = {
     accessToken: string;
@@ -105,6 +106,20 @@ export type ITransaction = {
     fileUrls?: IFileUrls;
     cancelledAt?: string;
     cancelledResponse?: Record<string, any>;
+    cancelledBy?: string;
+    cancelledUser?: {
+        id: number;
+        email?: string;
+        firstName?: string;
+        lastName?: string;
+    };
+    approvedBy?: string;
+    approvedUser?: {
+        id: number;
+        email?: string;
+        firstName?: string;
+        lastName?: string;
+    };
     assignedUserId?: number;
     assignedUser?: {
         id: number;
@@ -117,6 +132,10 @@ export type IESimTransaction = {
     id: number;
     esimTransactionId: number;
     vndAmount?: number;
+    paymentAmount?: number;
+    couponId?: number;
+    couponCode?: string;
+    couponDiscountAmount?: number;
     originalVndAmount?: number;
     amount?: number;
     packageId?: number;
@@ -125,6 +144,11 @@ export type IESimTransaction = {
     agencyOrderId?: number;
     orderCode?: string;
     status: EsimTransactionStatus;
+    paymentMode?: EPaymentMode;
+    paymentTypeApplied?: EOrderPaymentType;
+    paidAmount?: number;
+    unpaidAmount?: number;
+    isBypassed?: boolean;
     lastSyncedAt?: Date;
     publicId: string;
     createdResponseLog?: Record<string, any>;
@@ -226,6 +250,7 @@ export interface ITravelAgencyTenantSettings {
         esimInbound: boolean;
         simDomestic: boolean;
         insurance: boolean;
+        motorInsurance: boolean;
     };
     fx: {
         useCases: EUseCaseses[];
@@ -238,6 +263,10 @@ export interface ITravelAgencyTenantSettings {
     insurance: {
         providers: string[];
     };
+    motorInsurance: {
+        providers: string[];
+    };
+    paymentType?: EOrderPaymentType;
 }
 export interface IBankTenantSettings {
     availableCurrencies: string[];
@@ -266,6 +295,19 @@ export type GetESimTransactionListRespDto = {
     page: number;
     limit: number;
 };
+export type BankTransferInfo = {
+    bankAccount: string;
+    accountName: string;
+    amount: number;
+    transferContent: string;
+    bankCode: string;
+};
+export type CreateEsimTransactionBankTransferResponse = {
+    qrCodeUrl: string;
+    transactionPublicId: string;
+    totalAmount: number;
+    bankTransferInfo?: BankTransferInfo;
+};
 export type GetUserListRespDto = {
     users: IUser[];
     total: number;
@@ -351,6 +393,7 @@ export type IUser = {
     departments?: IDepartment[];
     roles?: IRole[];
     tenant?: ITenant;
+    tenantId?: number;
     permissions?: EPermissionKey[];
     balance?: {
         amount: number;
@@ -401,6 +444,27 @@ export type IPermission = {
     description: string;
     globalPermission: IGlobalPermission;
 };
+export interface IRemappedCommissionPolicy {
+    userId: number | null;
+    tenantId: number;
+    departmentId: number | null;
+    bankCode: string;
+    currencyCode: string;
+    action: {
+        direct: {
+            type: string;
+            value: number;
+        };
+        viaRef: {
+            type: string;
+            value: number;
+        };
+        indirect: {
+            type: string;
+            value: number;
+        };
+    };
+}
 export interface ICommissionPolicy {
     currencyCode?: string;
     userId?: number;
@@ -409,9 +473,9 @@ export interface ICommissionPolicy {
     memberId?: number;
     bankId?: number;
     type: ECommissionPolicyType;
-    directType: ECommissionPolicyCalculationType;
-    viaRefType: ECommissionPolicyCalculationType;
-    indirectType: ECommissionPolicyCalculationType;
+    directType: EPolicyActionType;
+    viaRefType: EPolicyActionType;
+    indirectType: EPolicyActionType;
     byFixedAmountDirect?: number;
     byPercentDirect?: number;
     byFixedAmountViaRef?: number;
@@ -489,7 +553,9 @@ export declare enum EDebtReportStatus {
 }
 export declare enum ETransactionReportType {
     FX = "fx",
-    ESIM = "esim"
+    ESIM = "esim",
+    INSURANCE = "insurance",
+    MOTOR_INSURANCE = "motor_insurance"
 }
 export declare enum ESimType {
     ESIM = "esim",
@@ -507,10 +573,13 @@ export type IDebtReportTransaction = {
     customerEmail?: string;
     amount: number;
     amountVnd: number;
-    currency: string;
-    bankName: string;
-    publicId: string;
+    currency?: string;
+    bankName?: string;
+    publicId?: string;
     bankTransactionId?: string;
+    insuranceProvider?: string;
+    insuranceType?: string;
+    policyId?: string;
     createdAt: string;
     commissionAmount: number;
 };
@@ -522,6 +591,7 @@ export type IDebtReport = {
     endDate: string;
     transactionType: ETransactionReportType;
     totalCommissionVnd: number;
+    totalAmountVnd: number;
     totalCommissionByBank: Record<string, number>;
     numSuccessfulTransactions: number;
     status: EDebtReportStatus;

package/types/types/sdk.d.ts

@@ -1,4 +1,8 @@
 export declare enum ESdkFormType {
     FX = "fx",
-    INSURANCE = "insurance"
+    INTERNATIONAL_INSURANCE = "international_insurance",
+    DOMESTIC_INSURANCE = "domestic_insurance",
+    MOTOR_INSURANCE_CAR = "motor_insurance_car",
+    MOTOR_INSURANCE_BIKE = "motor_insurance_bike",
+    EXCHANGE_RATE_TABLE = "exchange_rate_table"
 }

package/types/types/tracking.dto.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tracking DTO interface for tracking user behavior
+ * This interface can be extended with additional tracking fields in the future
+ */
+export interface TrackingDto {
+    /** Anonymous user ID for tracking unauthenticated users */
+    anonymousId?: string;
+    /** Google Click ID for tracking Google Ads campaigns */
+    gclid?: string;
+    /** Facebook Click ID for tracking Facebook Ads campaigns */
+    fbid?: string;
+    /** Campaign identifier */
+    campaign?: string;
+}
+/**
+ * Type helper to extend any DTO with tracking fields
+ * Usage: type MyDtoWithTracking = WithTracking<MyDto>
+ */
+export type WithTracking<T> = T & TrackingDto;

package/types/util/booker-display.d.ts

@@ -0,0 +1,6 @@
+import { IUser } from '../types/response.dto';
+export declare function formatBookerHeadingWithEmail(user: IUser): string;
+export declare function getBookerSelectionButtonLabel(selectedUser: IUser | null): string;
+export declare function getSelectedUserDisplay(selectedUser: IUser | null): string;
+/** Clickable hint when admin must pick / re-pick booker */
+export declare const BOOKER_SELECT_GUIDE_VI = "ch\u01B0a ch\u1ECDn ng\u01B0\u1EDDi d\u00F9ng";

package/types/util/couponErrorMessages.d.ts

@@ -0,0 +1,2 @@
+export declare function getBusinessMessageFromCode(code: string | undefined | null): string;
+export declare function getCouponErrorCodeFromAxios(err: unknown): string | undefined;

package/types/util/debt-report-display.d.ts

@@ -0,0 +1,4 @@
+import { ETransactionReportType } from '../types/response.dto';
+export declare const getDebtReportTransactionTypeText: (type: ETransactionReportType) => string;
+export declare const isFxDebtReportType: (type: ETransactionReportType) => boolean;
+export declare const getDebtReportInsuranceTypeText: (insuranceType?: string | null) => string;

package/types/util/formatter.d.ts

@@ -2,3 +2,9 @@ export declare const formatter: Intl.NumberFormat;
 export declare const formatCurrencyWithoutVND: (value: number | string) => string;
 export declare const formatCurrency: (value: number | string) => string;
 export declare const upperFirstLetter: (str: string) => string;
+/**
+ * Parse a locale-formatted number string (e.g. "100,000") to a number for filter/API use.
+ * Returns undefined for empty input or invalid numbers.
+ */
+export declare const parseFilterNumber: (s: string) => number | undefined;
+export declare const formatDate: (date: string | Date | null | undefined, format?: string) => string;

package/types/util/fx-travelling-messages.d.ts

@@ -0,0 +1 @@
+export declare function normalizeSelectingBankMessages(config: string | string[] | null | undefined, fallback: string | null): string[];

package/types/util/fx.d.ts

@@ -0,0 +1,15 @@
+import { IBankFxTravellingSetting } from '../types/app-settings';
+/**
+ * Returns the effective max amount for the given currency and destination country.
+ * If max_amount_by_country is set: visa countries use visa_max_amount, else non_visa_max_amount.
+ * Falls back to max_amount when max_amount_by_country is not configured or has no value for the currency.
+ *
+ * CMS config (use alpha2 codes in visa_countries; form sends alpha2):
+ *   "max_amount_by_country": {
+ *     "visa_countries": ["US", "GB", "FR", "CN", "JP", "KR"],
+ *     "visa_max_amount": 10000,
+ *     "non_visa_max_amount": 2000
+ *   }
+ * Or per-currency: "visa_max_amount": { "USD": 10000, "EUR": 8000 }
+ */
+export declare function getEffectiveConfiguredMaxAmount(travellingConfig: IBankFxTravellingSetting | undefined, currencyKey: string, countryCodeDes: string | undefined): number | null | undefined;

package/types/util/order-payment-display.d.ts

@@ -0,0 +1,13 @@
+import { EOrderPaymentType } from '../types/enum';
+export declare function getOrderPaymentStatusShortLabel(params: {
+    paymentTypeApplied?: EOrderPaymentType;
+    paidAmount?: number;
+    unpaidAmount?: number;
+    isBypassed?: boolean;
+}): string;
+export declare function getOrderPaymentStatusDetailLabel(params: {
+    paymentTypeApplied?: EOrderPaymentType;
+    paidAmount?: number;
+    unpaidAmount?: number;
+    isBypassed?: boolean;
+}): string;

package/types/util/sim-display.d.ts

@@ -1,7 +1,9 @@
 import { EOrderType } from '../hooks/useSimTransactionGrouped';
+import { EPaymentMode } from '../types/enum';
 export declare const getSimTypeDisplay: (simType?: string) => string;
 export declare const getSimPaymentTypeDisplay: (paymentType?: string) => string;
 export declare const getSimTransactionTypeDisplay: (type?: EOrderType) => string;
+export declare const getEsimPaymentModeDisplay: (mode?: EPaymentMode | string) => string;
 export declare const getSimProviderDisplay: (provider?: string) => string;
 export declare const getSimStatusDisplay: (status?: string) => {
     text: string;

package/types/util/tracking.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generate a new anonymous user ID (15 chars, url-safe).
+ * @see https://alex7kom.github.io/nano-nanoid-cc/
+ */
+export declare const generateAnonymousUid: (size?: number) => string;
+/**
+ * Save anonymous UID to both cookie and localStorage
+ * This ensures persistence across different storage mechanisms
+ */
+export declare const saveAnonymousUid: (uid: string) => void;
+/**
+ * Get anonymous UID with priority: cookie first, then localStorage
+ * If not found, generates a new one and saves it
+ */
+export declare const getAnonymousUid: () => string;
+/**
+ * Parse tracking parameters from URL query string
+ * Extracts gclid, fbid, campaign, etc. from URL
+ */
+export declare const parseTrackingParamsFromUrl: () => {
+    gclid?: string;
+    fbid?: string;
+    campaign?: string;
+    [key: string]: string | undefined;
+};
+/**
+ * Validate tracking data
+ */
+export declare const validateTrackingData: (data: any) => boolean;

package/types/util/transaction.util.d.ts

@@ -1,4 +1,4 @@
 import { ESimPackageDataLimitTimeframe, ESimPackageDataLimitUnit, ESimPackageValidityType, ETransactionType } from '../types/response.dto';
-export declare const getTransactionType: (type: ETransactionType) => ETransactionType.STUDY | "Du học" | "Du lịch" | "Du lịch (Nhóm)" | "Kinh doanh" | "Di trú";
+export declare const getTransactionType: (type: ETransactionType) => ETransactionType.STUDY | "Du học" | "Kinh doanh" | "Du lịch" | "Du lịch (Nhóm)" | "Di trú";
 export declare const formatDataLimit: (dataLimit: number, dataLimitUnit: ESimPackageDataLimitUnit, dataLimitTimeframe: ESimPackageDataLimitTimeframe) => string;
 export declare const formatValidity: (validityPeriod: number, validityType: ESimPackageValidityType) => string;