@zeniai/client-epic-state 5.1.34-betaRD1 → 5.1.35-betaAK0

package/lib/commonStateTypes/viewAndReport/agingReportStateTypes.d.ts

@@ -8,7 +8,7 @@ import { SortOrder } from '../selectorTypes/sortOrderTypes';
 import { ReportID } from './viewAndReport';
 export type AgingDateSelectionType = 'last_month' | 'last_quarter' | 'custom_date';
 export type AgingReportId = Extract<ReportID, 'accounts_payable_aging' | 'accounts_receivable_aging'>;
-declare const toAgingReportSortKey: (v: string) => "vendor" | "customer" | "current_due" | "due_1-30_days" | "due_31-60_days" | "due_61-90_days" | "due_over_90_days" | "total";
+declare const toAgingReportSortKey: (v: string) => "vendor" | "customer" | "total" | "current_due" | "due_1-30_days" | "due_31-60_days" | "due_61-90_days" | "due_over_90_days";
 export type AgingReportSortKey = ReturnType<typeof toAgingReportSortKey>;
 export interface AgingReportInvoice {
     amount: Amount;

package/lib/entity/accountRecon/accountReconPayload.d.ts

@@ -7,6 +7,23 @@ export interface StatementMetaDataPayload {
     file_id: string;
     statement_upload_id: string;
 }
+export interface LastReconciledByPayload {
+    user_email: string;
+    user_id: ID;
+}
+export interface LastReconciledPayload {
+    at: string;
+    by: LastReconciledByPayload;
+    for_period_end_date: string;
+}
+export interface MatchProgressPayload {
+    ai_percentage_share: number;
+    complete_percentage: number;
+    human_percentage_share: number;
+    matched: number;
+    remaining_percentage: number;
+    total: number;
+}
 export interface ReconciliationDataPayload {
     account_id: ID;
     balance_data_status: StatusCodeWithLabelPayload | null;
@@ -21,6 +38,10 @@ export interface ReconciliationDataPayload {
         error_message: string;
     } | null;
     initial_cleared_balance: number | null;
+    last_reconciled: LastReconciledPayload | null;
+    match_progress: MatchProgressPayload | null;
+    needs_review_count: number;
+    opening_balance: number | null;
     payment_account_updated_at: string | null;
     reconciliation_id: string | null;
     retry_count: number | null;
@@ -34,6 +55,7 @@ export interface ReconciliationDataPayload {
     update_time: string | null;
     user_id: ID | null;
     variance: number | null;
+    auto_matched_count?: number;
 }
 export interface RecommendedReviewTransactionPayload {
     amount: number;

package/lib/entity/accountRecon/accountReconPayload.js

@@ -65,7 +65,7 @@ const toAccountReconciliationData = (payload) => {
     return {
         reconciliationId: payload.reconciliation_id ?? undefined,
         accountId: payload.account_id,
-        reconciliationStatus: payload.status
+        reconciliationStatus: payload.status != null
             ? {
                 code: (0, accountReconState_1.toReconciliationStatusCodeType)(payload.status.code),
                 label: payload.status.label,
@@ -111,6 +111,31 @@ const toAccountReconciliationData = (payload) => {
         initialClearedBalance: payload.initial_cleared_balance != null
             ? (0, amount_1.toAmount)(payload.initial_cleared_balance, payload.currency.currency_code, payload.currency.currency_symbol)
             : undefined,
+        lastReconciled: payload.last_reconciled != null
+            ? {
+                at: (0, zeniDayJS_1.date)(payload.last_reconciled.at),
+                by: {
+                    userEmail: payload.last_reconciled.by.user_email,
+                    userId: payload.last_reconciled.by.user_id,
+                },
+                forPeriodEndDate: (0, zeniDayJS_1.date)(payload.last_reconciled.for_period_end_date),
+            }
+            : undefined,
+        matchProgress: payload.match_progress != null
+            ? {
+                aiPercentageShare: payload.match_progress.ai_percentage_share,
+                completePercentage: payload.match_progress.complete_percentage,
+                humanPercentageShare: payload.match_progress.human_percentage_share,
+                matched: payload.match_progress.matched,
+                remainingPercentage: payload.match_progress.remaining_percentage,
+                total: payload.match_progress.total,
+            }
+            : undefined,
+        autoMatchedCount: payload.auto_matched_count,
+        needsReview: payload.needs_review_count,
+        openingBalance: payload.opening_balance != null
+            ? (0, amount_1.toAmount)(payload.opening_balance, payload.currency.currency_code, payload.currency.currency_symbol)
+            : undefined,
         startDate: (0, zeniDayJS_1.date)(payload.start_date),
         endDate: (0, zeniDayJS_1.date)(payload.end_date),
         accountUpdatedAt: payload.payment_account_updated_at != null

package/lib/entity/accountRecon/accountReconReducer.d.ts

@@ -1,5 +1,5 @@
 import { MonthYearPeriod } from '../../commonStateTypes/timePeriod';
-import { DeleteStatementResponsePayload, UploadStatementResponsePayload } from '../../view/expenseAutomationView/payload/reconciliationPayload';
+import { DeleteStatementResponsePayload, ReparseStatementResponsePayload, UploadStatementResponsePayload } from '../../view/expenseAutomationView/payload/reconciliationPayload';
 import { ReconciliationDataPayload } from './accountReconPayload';
 import { AccountReconState } from './accountReconState';
 export declare const initialState: AccountReconState;
@@ -15,7 +15,10 @@ export declare const updateAccountRecon: import("@reduxjs/toolkit").ActionCreato
 }, "accountRecon/addTransactionToReconcileList", never, never>, updateAccountReconDeleteStatement: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[accountReconKey: string, statementDataPayload: DeleteStatementResponsePayload], {
     accountReconKey: string;
     statementDataPayload: DeleteStatementResponsePayload;
-}, "accountRecon/updateAccountReconDeleteStatement", never, never>, updateAccountReconUploadStatement: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[accountReconKey: string, payload: UploadStatementResponsePayload], {
+}, "accountRecon/updateAccountReconDeleteStatement", never, never>, updateAccountReconReparseStatement: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[accountReconKey: string, payload: ReparseStatementResponsePayload], {
+    accountReconKey: string;
+    payload: ReparseStatementResponsePayload;
+}, "accountRecon/updateAccountReconReparseStatement", never, never>, updateAccountReconUploadStatement: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[accountReconKey: string, payload: UploadStatementResponsePayload], {
     accountReconKey: string;
     payload: UploadStatementResponsePayload;
 }, "accountRecon/updateAccountReconUploadStatement", never, never>;

package/lib/entity/accountRecon/accountReconReducer.js

@@ -1,7 +1,7 @@
 "use strict";
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateAccountReconUploadStatement = exports.updateAccountReconDeleteStatement = exports.addTransactionToReconcileList = exports.clearAllAccountRecon = exports.excludeReconReviewTransaction = exports.updateAccountRecon = exports.initialState = void 0;
+exports.updateAccountReconUploadStatement = exports.updateAccountReconReparseStatement = exports.updateAccountReconDeleteStatement = exports.addTransactionToReconcileList = exports.clearAllAccountRecon = exports.excludeReconReviewTransaction = exports.updateAccountRecon = exports.initialState = void 0;
 const toolkit_1 = require("@reduxjs/toolkit");
 const accountReconPayload_1 = require("./accountReconPayload");
 const accountReconState_1 = require("./accountReconState");
@@ -53,6 +53,40 @@ const accountRecon = (0, toolkit_1.createSlice)({
                 };
             },
         },
+        updateAccountReconReparseStatement: {
+            prepare(accountReconKey, payload) {
+                return {
+                    payload: {
+                        accountReconKey,
+                        payload,
+                    },
+                };
+            },
+            reducer(draft, action) {
+                const { accountReconKey, payload } = action.payload;
+                const existing = draft.accountReconByAccountReconKey[accountReconKey];
+                if (existing == null) {
+                    return;
+                }
+                draft.accountReconByAccountReconKey[accountReconKey] = {
+                    ...existing,
+                    statementStatus: {
+                        code: (0, accountReconState_1.toStatementStatusCodeType)(payload.statement_upload.statement_status.code),
+                        label: payload.statement_upload.statement_status.label,
+                    },
+                    statementDataStatus: {
+                        code: (0, accountReconState_1.toStatementDataStatusCodeType)(payload.statement_upload.statement_data_status.code),
+                        label: payload.statement_upload.statement_data_status.label,
+                    },
+                    // Re-parse creates a new statement upload; adopt the new id so all
+                    // subsequent actions (parse, update, delete) target the latest one.
+                    statementMetaData: {
+                        ...existing.statementMetaData,
+                        statementUploadId: payload.statement_upload.statement_upload_id,
+                    },
+                };
+            },
+        },
         updateAccountReconDeleteStatement: {
             prepare(accountReconKey, statementDataPayload) {
                 return {
@@ -132,7 +166,7 @@ const accountRecon = (0, toolkit_1.createSlice)({
         },
     },
 });
-_a = accountRecon.actions, exports.updateAccountRecon = _a.updateAccountRecon, exports.excludeReconReviewTransaction = _a.excludeReconReviewTransaction, exports.clearAllAccountRecon = _a.clearAllAccountRecon, exports.addTransactionToReconcileList = _a.addTransactionToReconcileList, exports.updateAccountReconDeleteStatement = _a.updateAccountReconDeleteStatement, exports.updateAccountReconUploadStatement = _a.updateAccountReconUploadStatement;
+_a = accountRecon.actions, exports.updateAccountRecon = _a.updateAccountRecon, exports.excludeReconReviewTransaction = _a.excludeReconReviewTransaction, exports.clearAllAccountRecon = _a.clearAllAccountRecon, exports.addTransactionToReconcileList = _a.addTransactionToReconcileList, exports.updateAccountReconDeleteStatement = _a.updateAccountReconDeleteStatement, exports.updateAccountReconReparseStatement = _a.updateAccountReconReparseStatement, exports.updateAccountReconUploadStatement = _a.updateAccountReconUploadStatement;
 exports.default = accountRecon.reducer;
 const doUpdateAccountRecon = (draft, selectedPeriod, accountReconDataPayload) => {
     accountReconDataPayload.forEach((accountReconData) => {

package/lib/entity/accountRecon/accountReconSelector.d.ts

@@ -7,7 +7,7 @@ import { AccountBase } from '../account/accountState';
 import { File } from '../file/fileState';
 import { MatchedTransaction } from '../transaction/stateTypes/reconciliationTransaction';
 import { User } from '../user/userState';
-import { BalanceDataStatusCodeType, ReconciliationStatusCodeType, StatementDataStatusCodeType, StatementStatusCodeType, TransactionsToReview } from './accountReconState';
+import { BalanceDataStatusCodeType, LastReconciled, MatchProgress, ReconciliationStatusCodeType, StatementDataStatusCodeType, StatementStatusCodeType, TransactionsToReview } from './accountReconState';
 export interface AccountReconciliationEntity {
     account: AccountBase;
     currency: Currency;
@@ -20,6 +20,7 @@ export interface AccountReconciliationEntity {
     transactionsToReconcile: MatchedTransaction[];
     transactionsToReview: TransactionsToReview[];
     accountUpdatedAt?: ZeniDate;
+    autoMatchedCount?: number;
     balance?: Amount;
     balanceDataStatus?: {
         code: BalanceDataStatusCodeType;
@@ -31,6 +32,10 @@ export interface AccountReconciliationEntity {
         errorShort: string;
     };
     initialClearedBalance?: Amount;
+    lastReconciled?: LastReconciled;
+    matchProgress?: MatchProgress;
+    needsReview?: number;
+    openingBalance?: Amount;
     reconciliationId?: ID;
     reconciliationStatus?: {
         code: ReconciliationStatusCodeType;

package/lib/entity/accountRecon/accountReconSelector.js

@@ -36,6 +36,11 @@ exports.getAccountReconByAccountIdAndSelectedPeriod = (0, toolkit_1.createSelect
         variance: accountRecon.variance,
         clearedBalance: accountRecon.clearedBalance,
         initialClearedBalance: accountRecon.initialClearedBalance,
+        lastReconciled: accountRecon.lastReconciled,
+        autoMatchedCount: accountRecon.autoMatchedCount,
+        matchProgress: accountRecon.matchProgress,
+        needsReview: accountRecon.needsReview,
+        openingBalance: accountRecon.openingBalance,
         reconciliationId: accountRecon.reconciliationId,
         user,
         statementStatus: accountRecon.statementStatus,

package/lib/entity/accountRecon/accountReconState.d.ts

@@ -18,6 +18,23 @@ export declare const toStatementStatusCodeType: (v: string) => "not_found" | "up
 export type StatementStatusCodeType = ReturnType<typeof toStatementStatusCodeType>;
 export declare const toAccountReconKey: (accountId: ID, selectedPeriod: MonthYearPeriod) => string;
 export type AccountReconKey = ReturnType<typeof toAccountReconKey>;
+export interface LastReconciledByUser {
+    userEmail: string;
+    userId: ID;
+}
+export interface LastReconciled {
+    at: ZeniDate;
+    by: LastReconciledByUser;
+    forPeriodEndDate: ZeniDate;
+}
+export interface MatchProgress {
+    aiPercentageShare: number;
+    completePercentage: number;
+    humanPercentageShare: number;
+    matched: number;
+    remainingPercentage: number;
+    total: number;
+}
 export interface AccountReconState {
     accountReconByAccountReconKey: Record<AccountReconKey, AccountReconciliationData>;
 }
@@ -33,6 +50,7 @@ export interface AccountReconciliationData {
     transactionsToReconcile: ID[];
     transactionsToReview: TransactionsToReview[];
     accountUpdatedAt?: ZeniDate;
+    autoMatchedCount?: number;
     balanceDataStatus?: {
         code: BalanceDataStatusCodeType;
         label: string;
@@ -44,6 +62,10 @@ export interface AccountReconciliationData {
         errorShort: string;
     };
     initialClearedBalance?: Amount;
+    lastReconciled?: LastReconciled;
+    matchProgress?: MatchProgress;
+    needsReview?: number;
+    openingBalance?: Amount;
     reconciliationId?: ID;
     reconciliationStatus?: {
         code: ReconciliationStatusCodeType;

package/lib/entity/invoicing/coupon/couponConstants.d.ts

@@ -0,0 +1,11 @@
+import { InvoicingFormOption } from '../invoicingCommonPayload';
+import { InvoicingCouponApplyOn, InvoicingCouponDurationType, InvoicingCouponPeriodUnit, InvoicingDiscountType } from './couponPayload';
+/**
+ * Coupon form select options. Single source of truth (CES-owned) for the value
+ * sets that back the coupon's string-union domain fields; surfaced to the form
+ * via `getInvoicingCouponFormView` so web-components need not hardcode them.
+ */
+export declare const INVOICING_DISCOUNT_TYPE_OPTIONS: readonly InvoicingFormOption<InvoicingDiscountType>[];
+export declare const INVOICING_COUPON_DURATION_TYPE_OPTIONS: readonly InvoicingFormOption<InvoicingCouponDurationType>[];
+export declare const INVOICING_COUPON_PERIOD_UNIT_OPTIONS: readonly InvoicingFormOption<InvoicingCouponPeriodUnit>[];
+export declare const INVOICING_COUPON_APPLY_ON_OPTIONS: readonly InvoicingFormOption<InvoicingCouponApplyOn>[];

package/lib/entity/invoicing/coupon/couponConstants.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVOICING_COUPON_APPLY_ON_OPTIONS = exports.INVOICING_COUPON_PERIOD_UNIT_OPTIONS = exports.INVOICING_COUPON_DURATION_TYPE_OPTIONS = exports.INVOICING_DISCOUNT_TYPE_OPTIONS = void 0;
+/**
+ * Coupon form select options. Single source of truth (CES-owned) for the value
+ * sets that back the coupon's string-union domain fields; surfaced to the form
+ * via `getInvoicingCouponFormView` so web-components need not hardcode them.
+ */
+exports.INVOICING_DISCOUNT_TYPE_OPTIONS = [
+    { label: 'Percentage', value: 'percentage' },
+    { label: 'Fixed amount', value: 'fixed_amount' },
+    { label: 'Offer quantity', value: 'offer_quantity' },
+];
+exports.INVOICING_COUPON_DURATION_TYPE_OPTIONS = [
+    { label: 'One time', value: 'one_time' },
+    { label: 'Forever', value: 'forever' },
+    { label: 'Limited period', value: 'limited_period' },
+];
+exports.INVOICING_COUPON_PERIOD_UNIT_OPTIONS = [
+    { label: 'Day', value: 'day' },
+    { label: 'Week', value: 'week' },
+    { label: 'Month', value: 'month' },
+    { label: 'Year', value: 'year' },
+];
+exports.INVOICING_COUPON_APPLY_ON_OPTIONS = [
+    { label: 'Invoice amount', value: 'invoice_amount' },
+    { label: 'Each specified item', value: 'each_specified_item' },
+    { label: 'Specified items total', value: 'specified_items_total' },
+];

package/lib/entity/invoicing/coupon/couponPayload.d.ts

@@ -0,0 +1,55 @@
+import { InvoicingCoupon, InvoicingDiscountKPIs } from './couponState';
+export type InvoicingDiscountType = 'percentage' | 'fixed_amount' | 'offer_quantity';
+export type InvoicingCouponDurationType = 'one_time' | 'forever' | 'limited_period';
+export type InvoicingCouponStatus = 'active' | 'expired' | 'archived';
+export type InvoicingCouponApplyOn = 'invoice_amount' | 'each_specified_item' | 'specified_items_total';
+export type InvoicingCouponPeriodUnit = 'day' | 'week' | 'month' | 'year';
+export interface InvoicingCouponPayload {
+    id: string;
+    apply_on?: InvoicingCouponApplyOn;
+    coupon_code?: string;
+    created_at?: string;
+    currency_code?: string;
+    discount_amount?: number;
+    discount_percentage?: number;
+    discount_quantity?: number;
+    discount_type?: InvoicingDiscountType;
+    duration_type?: InvoicingCouponDurationType;
+    invoice_name?: string;
+    invoice_notes?: string;
+    item_constraints?: Record<string, unknown>[];
+    max_redemptions?: number;
+    name?: string;
+    period?: number;
+    period_unit?: InvoicingCouponPeriodUnit;
+    redemptions?: number;
+    restricted_products?: string[];
+    rev_rec_treatment?: string;
+    status?: InvoicingCouponStatus;
+    updated_at?: string;
+    valid_from?: string;
+    valid_till?: string;
+}
+export interface InvoicingCouponCode {
+    code: string;
+    coupon_id?: string;
+    coupon_set_id?: string;
+    status?: string;
+}
+export interface InvoicingCouponSet {
+    id: string;
+    archived_count?: number;
+    codes?: InvoicingCouponCode[];
+    coupon_id?: string;
+    name?: string;
+    redeemed_count?: number;
+    total_count?: number;
+}
+export interface InvoicingDiscountKPIsPayload {
+    total_active: number;
+    total_discounted_amount: number;
+    total_expired: number;
+    total_redemptions: number;
+}
+export declare const mapInvoicingCouponPayloadToState: (payload: InvoicingCouponPayload) => InvoicingCoupon;
+export declare const mapInvoicingDiscountKPIsPayloadToState: (payload: InvoicingDiscountKPIsPayload) => InvoicingDiscountKPIs;

package/lib/entity/invoicing/coupon/couponPayload.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapInvoicingDiscountKPIsPayloadToState = exports.mapInvoicingCouponPayloadToState = void 0;
+const amount_1 = require("../../../commonStateTypes/amount");
+const zeniDayJS_1 = require("../../../zeniDayJS");
+// ── Payload → State mappers (snake_case wire shape → camelCase domain shape) ──
+const DEFAULT_CURRENCY_CODE = 'USD';
+const DEFAULT_CURRENCY_SYMBOL = '$';
+const mapInvoicingCouponPayloadToState = (payload) => {
+    const currencyCode = payload.currency_code ?? DEFAULT_CURRENCY_CODE;
+    const currencySymbol = DEFAULT_CURRENCY_SYMBOL;
+    return {
+        id: payload.id,
+        applyOn: payload.apply_on,
+        couponCode: payload.coupon_code,
+        createdAt: payload.created_at != null ? (0, zeniDayJS_1.date)(payload.created_at) : undefined,
+        currencyCode: payload.currency_code,
+        discountAmount: payload.discount_amount != null
+            ? (0, amount_1.toAmount)(payload.discount_amount, currencyCode, currencySymbol)
+            : undefined,
+        discountPercentage: payload.discount_percentage,
+        discountQuantity: payload.discount_quantity,
+        discountType: payload.discount_type,
+        durationType: payload.duration_type,
+        invoiceName: payload.invoice_name,
+        invoiceNotes: payload.invoice_notes,
+        itemConstraints: payload.item_constraints,
+        maxRedemptions: payload.max_redemptions,
+        name: payload.name,
+        period: payload.period,
+        periodUnit: payload.period_unit,
+        redemptions: payload.redemptions,
+        restrictedProducts: payload.restricted_products,
+        revRecTreatment: payload.rev_rec_treatment,
+        status: payload.status,
+        updatedAt: payload.updated_at != null ? (0, zeniDayJS_1.date)(payload.updated_at) : undefined,
+        validFrom: payload.valid_from != null ? (0, zeniDayJS_1.date)(payload.valid_from) : undefined,
+        validTill: payload.valid_till != null ? (0, zeniDayJS_1.date)(payload.valid_till) : undefined,
+    };
+};
+exports.mapInvoicingCouponPayloadToState = mapInvoicingCouponPayloadToState;
+const mapInvoicingDiscountKPIsPayloadToState = (payload) => ({
+    totalActive: payload.total_active,
+    totalDiscountedAmount: (0, amount_1.toAmount)(payload.total_discounted_amount, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    totalExpired: payload.total_expired,
+    totalRedemptions: payload.total_redemptions,
+});
+exports.mapInvoicingDiscountKPIsPayloadToState = mapInvoicingDiscountKPIsPayloadToState;

package/lib/entity/invoicing/coupon/couponReducer.d.ts

@@ -0,0 +1,9 @@
+import { UpdateType } from '../../../commonStateTypes/common';
+import { InvoicingCouponPayload } from './couponPayload';
+import { InvoicingCouponState } from './couponState';
+export declare const initialState: InvoicingCouponState;
+export declare const updateInvoicingCoupons: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: InvoicingCouponPayload[], updateType?: UpdateType | undefined], InvoicingCouponPayload[], "invoicingCoupon/updateInvoicingCoupons", never, {
+    updateType: UpdateType;
+}>, removeInvoicingCoupon: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "invoicingCoupon/removeInvoicingCoupon">, clearAllInvoicingCoupons: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingCoupon/clearAllInvoicingCoupons">;
+declare const _default: import("redux").Reducer<InvoicingCouponState>;
+export default _default;

package/lib/entity/invoicing/coupon/couponReducer.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearAllInvoicingCoupons = exports.removeInvoicingCoupon = exports.updateInvoicingCoupons = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const assignWith_1 = __importDefault(require("lodash/assignWith"));
+const couponPayload_1 = require("./couponPayload");
+exports.initialState = { couponByID: {} };
+const coupon = (0, toolkit_1.createSlice)({
+    name: 'invoicingCoupon',
+    initialState: exports.initialState,
+    reducers: {
+        updateInvoicingCoupons: {
+            reducer(draft, action) {
+                doUpdateInvoicingCoupons(draft.couponByID, action.payload, action.meta.updateType);
+            },
+            prepare(payload, updateType = 'replace') {
+                return { payload, meta: { updateType } };
+            },
+        },
+        removeInvoicingCoupon(draft, action) {
+            delete draft.couponByID[action.payload];
+        },
+        clearAllInvoicingCoupons(draft) {
+            Object.assign(draft, exports.initialState);
+        },
+    },
+});
+_a = coupon.actions, exports.updateInvoicingCoupons = _a.updateInvoicingCoupons, exports.removeInvoicingCoupon = _a.removeInvoicingCoupon, exports.clearAllInvoicingCoupons = _a.clearAllInvoicingCoupons;
+exports.default = coupon.reducer;
+/**
+ * Helper functions.
+ */
+function doUpdateInvoicingCoupons(draft, payload, updateType) {
+    payload.forEach((couponPayload) => {
+        const latestCoupon = (0, couponPayload_1.mapInvoicingCouponPayloadToState)(couponPayload);
+        if (latestCoupon.id in draft && updateType === 'merge') {
+            (0, assignWith_1.default)(draft[latestCoupon.id], latestCoupon, (objValue, srcValue) => (srcValue == null ? objValue : srcValue));
+        }
+        else {
+            draft[latestCoupon.id] = latestCoupon;
+        }
+    });
+}

package/lib/entity/invoicing/coupon/couponSelector.d.ts

@@ -0,0 +1,5 @@
+import { ID } from '../../../commonStateTypes/common';
+import { RootState } from '../../../reducer';
+import { InvoicingCoupon } from './couponState';
+export declare const getInvoicingCouponById: (state: RootState, id: ID) => InvoicingCoupon | undefined;
+export declare const getInvoicingCouponsByIds: (state: RootState, ids: ID[]) => InvoicingCoupon[];

package/lib/entity/invoicing/coupon/couponSelector.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingCouponsByIds = exports.getInvoicingCouponById = void 0;
+const getInvoicingCouponById = (state, id) => state.invoicingCouponState.couponByID[id];
+exports.getInvoicingCouponById = getInvoicingCouponById;
+const getInvoicingCouponsByIds = (state, ids) => ids
+    .map((id) => state.invoicingCouponState.couponByID[id])
+    .filter((coupon) => coupon != null);
+exports.getInvoicingCouponsByIds = getInvoicingCouponsByIds;

package/lib/entity/invoicing/coupon/couponState.d.ts

@@ -0,0 +1,39 @@
+import { Amount } from '../../../commonStateTypes/amount';
+import { ID } from '../../../commonStateTypes/common';
+import { ZeniDate } from '../../../zeniDayJS';
+import { InvoicingCouponApplyOn, InvoicingCouponDurationType, InvoicingCouponPeriodUnit, InvoicingCouponStatus, InvoicingDiscountType } from './couponPayload';
+export interface InvoicingCoupon {
+    id: ID;
+    applyOn?: InvoicingCouponApplyOn;
+    couponCode?: string;
+    createdAt?: ZeniDate;
+    currencyCode?: string;
+    discountAmount?: Amount;
+    discountPercentage?: number;
+    discountQuantity?: number;
+    discountType?: InvoicingDiscountType;
+    durationType?: InvoicingCouponDurationType;
+    invoiceName?: string;
+    invoiceNotes?: string;
+    itemConstraints?: Record<string, unknown>[];
+    maxRedemptions?: number;
+    name?: string;
+    period?: number;
+    periodUnit?: InvoicingCouponPeriodUnit;
+    redemptions?: number;
+    restrictedProducts?: ID[];
+    revRecTreatment?: string;
+    status?: InvoicingCouponStatus;
+    updatedAt?: ZeniDate;
+    validFrom?: ZeniDate;
+    validTill?: ZeniDate;
+}
+export interface InvoicingDiscountKPIs {
+    totalActive: number;
+    totalDiscountedAmount: Amount;
+    totalExpired: number;
+    totalRedemptions: number;
+}
+export interface InvoicingCouponState {
+    couponByID: Record<ID, InvoicingCoupon>;
+}

package/lib/entity/invoicing/coupon/couponState.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/entity/invoicing/creditNote/creditNotePayload.d.ts

@@ -0,0 +1,52 @@
+import { InvoicingPriceType } from '../invoicingCommonPayload';
+import { InvoicingCreditKPIs, InvoicingCreditNote, InvoicingCreditNoteAllocation, InvoicingCreditNoteLineItem } from './creditNoteState';
+export type InvoicingCreditNoteStatus = 'adjusted' | 'refunded' | 'refund_due' | 'voided' | 'open' | 'closed' | 'partially_used';
+export type InvoicingCreditNoteType = 'adjustment' | 'refundable' | 'store' | 'referral';
+export interface InvoicingCreditNoteLineItemPayload {
+    amount: number;
+    description: string;
+    quantity: number;
+    unit_amount: number;
+    entity_type?: string;
+    id?: string;
+}
+export interface InvoicingCreditNoteAllocationPayload {
+    allocated_amount: number;
+    invoice_id: string;
+    allocated_at?: string;
+}
+export interface InvoicingCreditNotePayload {
+    id: string;
+    allocations?: InvoicingCreditNoteAllocationPayload[];
+    amount_allocated?: number;
+    amount_available?: number;
+    amount_refunded?: number;
+    create_reason_code?: string;
+    created_at?: string;
+    credit_note_number?: string;
+    currency_code?: string;
+    customer_id?: string;
+    customer_name?: string;
+    date?: string;
+    line_items?: InvoicingCreditNoteLineItemPayload[];
+    linked_refunds?: string[];
+    notes?: string;
+    price_type?: InvoicingPriceType;
+    reason_code?: string;
+    reference_invoice_id?: string;
+    status?: InvoicingCreditNoteStatus;
+    sub_total?: number;
+    subscription_id?: string;
+    total?: number;
+    type?: InvoicingCreditNoteType;
+}
+export interface InvoicingCreditKPIsPayload {
+    total_allocated: number;
+    total_available: number;
+    total_open: number;
+    total_refunded: number;
+}
+export declare const mapInvoicingCreditNoteLineItemPayloadToState: (payload: InvoicingCreditNoteLineItemPayload, currencyCode: string, currencySymbol: string) => InvoicingCreditNoteLineItem;
+export declare const mapInvoicingCreditNoteAllocationPayloadToState: (payload: InvoicingCreditNoteAllocationPayload, currencyCode: string, currencySymbol: string) => InvoicingCreditNoteAllocation;
+export declare const mapInvoicingCreditNotePayloadToState: (payload: InvoicingCreditNotePayload) => InvoicingCreditNote;
+export declare const mapInvoicingCreditKPIsPayloadToState: (payload: InvoicingCreditKPIsPayload) => InvoicingCreditKPIs;

package/lib/entity/invoicing/creditNote/creditNotePayload.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapInvoicingCreditKPIsPayloadToState = exports.mapInvoicingCreditNotePayloadToState = exports.mapInvoicingCreditNoteAllocationPayloadToState = exports.mapInvoicingCreditNoteLineItemPayloadToState = void 0;
+const amount_1 = require("../../../commonStateTypes/amount");
+const zeniDayJS_1 = require("../../../zeniDayJS");
+// ── Payload → State mappers (snake_case wire shape → camelCase domain shape) ──
+const DEFAULT_CURRENCY_CODE = 'USD';
+const DEFAULT_CURRENCY_SYMBOL = '$';
+const mapInvoicingCreditNoteLineItemPayloadToState = (payload, currencyCode, currencySymbol) => ({
+    amount: (0, amount_1.toAmount)(payload.amount, currencyCode, currencySymbol),
+    description: payload.description,
+    quantity: payload.quantity,
+    unitAmount: (0, amount_1.toAmount)(payload.unit_amount, currencyCode, currencySymbol),
+    entityType: payload.entity_type,
+    id: payload.id,
+});
+exports.mapInvoicingCreditNoteLineItemPayloadToState = mapInvoicingCreditNoteLineItemPayloadToState;
+const mapInvoicingCreditNoteAllocationPayloadToState = (payload, currencyCode, currencySymbol) => ({
+    allocatedAmount: (0, amount_1.toAmount)(payload.allocated_amount, currencyCode, currencySymbol),
+    invoiceID: payload.invoice_id,
+    allocatedAt: payload.allocated_at != null ? (0, zeniDayJS_1.date)(payload.allocated_at) : undefined,
+});
+exports.mapInvoicingCreditNoteAllocationPayloadToState = mapInvoicingCreditNoteAllocationPayloadToState;
+const mapInvoicingCreditNotePayloadToState = (payload) => {
+    const currencyCode = payload.currency_code ?? DEFAULT_CURRENCY_CODE;
+    const currencySymbol = DEFAULT_CURRENCY_SYMBOL;
+    const toAmt = (value) => (0, amount_1.toAmount)(value, currencyCode, currencySymbol);
+    return {
+        id: payload.id,
+        allocations: payload.allocations?.map((allocation) => (0, exports.mapInvoicingCreditNoteAllocationPayloadToState)(allocation, currencyCode, currencySymbol)),
+        amountAllocated: payload.amount_allocated != null
+            ? toAmt(payload.amount_allocated)
+            : undefined,
+        amountAvailable: payload.amount_available != null
+            ? toAmt(payload.amount_available)
+            : undefined,
+        amountRefunded: payload.amount_refunded != null
+            ? toAmt(payload.amount_refunded)
+            : undefined,
+        createReasonCode: payload.create_reason_code,
+        createdAt: payload.created_at != null ? (0, zeniDayJS_1.date)(payload.created_at) : undefined,
+        creditNoteNumber: payload.credit_note_number,
+        currencyCode: payload.currency_code,
+        customerID: payload.customer_id,
+        customerName: payload.customer_name,
+        date: payload.date != null ? (0, zeniDayJS_1.date)(payload.date) : undefined,
+        lineItems: payload.line_items?.map((lineItem) => (0, exports.mapInvoicingCreditNoteLineItemPayloadToState)(lineItem, currencyCode, currencySymbol)),
+        linkedRefunds: payload.linked_refunds,
+        notes: payload.notes,
+        priceType: payload.price_type,
+        reasonCode: payload.reason_code,
+        referenceInvoiceID: payload.reference_invoice_id,
+        status: payload.status,
+        subTotal: payload.sub_total != null ? toAmt(payload.sub_total) : undefined,
+        subscriptionID: payload.subscription_id,
+        total: payload.total != null ? toAmt(payload.total) : undefined,
+        type: payload.type,
+    };
+};
+exports.mapInvoicingCreditNotePayloadToState = mapInvoicingCreditNotePayloadToState;
+const mapInvoicingCreditKPIsPayloadToState = (payload) => ({
+    totalAllocated: (0, amount_1.toAmount)(payload.total_allocated, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    totalAvailable: (0, amount_1.toAmount)(payload.total_available, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    totalOpen: (0, amount_1.toAmount)(payload.total_open, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    totalRefunded: (0, amount_1.toAmount)(payload.total_refunded, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+});
+exports.mapInvoicingCreditKPIsPayloadToState = mapInvoicingCreditKPIsPayloadToState;