@zeniai/client-epic-state 5.1.35 → 5.1.37-betaAK0

package/lib/esm/entity/invoicing/invoice/invoicePayload.js

@@ -0,0 +1,123 @@
+import { toAmount } from '../../../commonStateTypes/amount';
+import { date } from '../../../zeniDayJS';
+// ── Payload → State mappers (snake_case wire shape → camelCase domain shape) ──
+const DEFAULT_CURRENCY_CODE = 'USD';
+const DEFAULT_CURRENCY_SYMBOL = '$';
+const mapLineItem = (payload, currencyCode, currencySymbol) => ({
+    amount: toAmount(payload.amount, currencyCode, currencySymbol),
+    description: payload.description,
+    quantity: payload.quantity,
+    unitAmount: toAmount(payload.unit_amount, currencyCode, currencySymbol),
+    dateFrom: payload.date_from != null ? date(payload.date_from) : undefined,
+    dateTo: payload.date_to != null ? date(payload.date_to) : undefined,
+    discountAmount: payload.discount_amount != null
+        ? toAmount(payload.discount_amount, currencyCode, currencySymbol)
+        : undefined,
+    entityDescription: payload.entity_description,
+    entityType: payload.entity_type,
+    id: payload.id,
+    isTaxed: payload.is_taxed,
+    itemLevelDiscountAmount: payload.item_level_discount_amount != null
+        ? toAmount(payload.item_level_discount_amount, currencyCode, currencySymbol)
+        : undefined,
+    subscriptionID: payload.subscription_id,
+    taxAmount: payload.tax_amount != null
+        ? toAmount(payload.tax_amount, currencyCode, currencySymbol)
+        : undefined,
+    taxExemptReason: payload.tax_exempt_reason,
+    taxRate: payload.tax_rate,
+    usagePercentage: payload.usage_percentage,
+});
+const mapLinkedPayment = (payload, currencyCode, currencySymbol) => ({
+    appliedAmount: toAmount(payload.applied_amount, currencyCode, currencySymbol),
+    txnID: payload.txn_id,
+    appliedAt: payload.applied_at != null ? date(payload.applied_at) : undefined,
+    txnAmount: payload.txn_amount != null
+        ? toAmount(payload.txn_amount, currencyCode, currencySymbol)
+        : undefined,
+    txnDate: payload.txn_date != null ? date(payload.txn_date) : undefined,
+    txnStatus: payload.txn_status,
+});
+const mapIssuedCreditNote = (payload, currencyCode, currencySymbol) => ({
+    cnID: payload.cn_id,
+    cnStatus: payload.cn_status,
+    cnTotal: toAmount(payload.cn_total, currencyCode, currencySymbol),
+});
+const mapDunningAttempt = (payload) => ({
+    attempt: payload.attempt,
+    createdAt: payload.created_at != null ? date(payload.created_at) : undefined,
+    dunningType: payload.dunning_type,
+    transactionID: payload.transaction_id,
+});
+const mapInvoiceNote = (payload) => ({
+    note: payload.note,
+    entityID: payload.entity_id,
+    entityType: payload.entity_type,
+});
+export const mapInvoicingInvoicePayloadToState = (payload) => {
+    const currencyCode = payload.currency_code ?? DEFAULT_CURRENCY_CODE;
+    const currencySymbol = DEFAULT_CURRENCY_SYMBOL;
+    const toAmt = (value) => toAmount(value, currencyCode, currencySymbol);
+    return {
+        customerID: payload.customer_id,
+        date: date(payload.date),
+        id: payload.id,
+        status: payload.status,
+        total: toAmt(payload.total),
+        adjustmentCreditNotes: payload.adjustment_credit_notes,
+        amountAdjusted: payload.amount_adjusted != null
+            ? toAmt(payload.amount_adjusted)
+            : undefined,
+        amountDue: payload.amount_due != null ? toAmt(payload.amount_due) : undefined,
+        amountPaid: payload.amount_paid != null ? toAmt(payload.amount_paid) : undefined,
+        amountToCollect: payload.amount_to_collect != null
+            ? toAmt(payload.amount_to_collect)
+            : undefined,
+        billingAddress: payload.billing_address,
+        createdAt: payload.created_at != null ? date(payload.created_at) : undefined,
+        creditsApplied: payload.credits_applied != null
+            ? toAmt(payload.credits_applied)
+            : undefined,
+        currencyCode: payload.currency_code,
+        customerEmail: payload.customer_email,
+        customerName: payload.customer_name,
+        dueDate: payload.due_date != null ? date(payload.due_date) : undefined,
+        dunningAttempts: payload.dunning_attempts?.map(mapDunningAttempt),
+        dunningStatus: payload.dunning_status,
+        firstInvoice: payload.first_invoice,
+        generatedAt: payload.generated_at != null ? date(payload.generated_at) : undefined,
+        hasAdvanceCharges: payload.has_advance_charges,
+        issuedCreditNotes: payload.issued_credit_notes?.map((note) => mapIssuedCreditNote(note, currencyCode, currencySymbol)),
+        lineItems: payload.line_items?.map((item) => mapLineItem(item, currencyCode, currencySymbol)),
+        linkedPayments: payload.linked_payments?.map((payment) => mapLinkedPayment(payment, currencyCode, currencySymbol)),
+        netTermDays: payload.net_term_days,
+        nextRetryAt: payload.next_retry_at != null ? date(payload.next_retry_at) : undefined,
+        notes: payload.notes?.map(mapInvoiceNote),
+        paidAt: payload.paid_at != null ? date(payload.paid_at) : undefined,
+        pdfFileId: payload.pdf_file_id,
+        pdfUrl: payload.pdf_url,
+        invoiceNumber: payload.invoice_number,
+        poNumber: payload.po_number,
+        priceType: payload.price_type,
+        invoiceType: payload.invoice_type,
+        recurring: payload.recurring,
+        roundOffAmount: payload.round_off_amount != null
+            ? toAmt(payload.round_off_amount)
+            : undefined,
+        shippingAddress: payload.shipping_address,
+        subscriptionID: payload.subscription_id,
+        subscriptionName: payload.subscription_name,
+        subTotal: payload.sub_total != null ? toAmt(payload.sub_total) : undefined,
+        tax: payload.tax != null ? toAmt(payload.tax) : undefined,
+        updatedAt: payload.updated_at != null ? date(payload.updated_at) : undefined,
+        writeOffAmount: payload.write_off_amount != null
+            ? toAmt(payload.write_off_amount)
+            : undefined,
+    };
+};
+export const mapInvoicingInvoiceKPIsPayloadToState = (payload) => ({
+    dueTotal: toAmount(payload.due_total, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    paidTotal: toAmount(payload.paid_total, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    pendingTotal: toAmount(payload.pending_total, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    totalInvoiced: toAmount(payload.total_invoiced, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+});

package/lib/esm/entity/invoicing/invoice/invoiceReducer.js

@@ -0,0 +1,42 @@
+import { createSlice } from '@reduxjs/toolkit';
+import assignWith from 'lodash/assignWith';
+import { mapInvoicingInvoicePayloadToState, } from './invoicePayload';
+export const initialState = {
+    invoiceByID: {},
+};
+const invoice = createSlice({
+    name: 'invoicingInvoice',
+    initialState,
+    reducers: {
+        updateInvoices: {
+            reducer(draft, action) {
+                doUpdateInvoices(draft.invoiceByID, action.payload, action.meta.updateType);
+            },
+            prepare(payload, updateType = 'replace') {
+                return { payload, meta: { updateType } };
+            },
+        },
+        removeInvoice(draft, action) {
+            delete draft.invoiceByID[action.payload];
+        },
+        clearAllInvoices(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { updateInvoices, removeInvoice, clearAllInvoices } = invoice.actions;
+export default invoice.reducer;
+/**
+ * Helper functions.
+ */
+function doUpdateInvoices(draft, payload, updateType) {
+    payload.forEach((invoicePayload) => {
+        const latestInvoice = mapInvoicingInvoicePayloadToState(invoicePayload);
+        if (latestInvoice.id in draft && updateType === 'merge') {
+            assignWith(draft[latestInvoice.id], latestInvoice, (objValue, srcValue) => (srcValue == null ? objValue : srcValue));
+        }
+        else {
+            draft[latestInvoice.id] = latestInvoice;
+        }
+    });
+}

package/lib/esm/entity/invoicing/invoice/invoiceSelector.js

@@ -0,0 +1,4 @@
+export const getInvoiceById = (state, invoiceId) => state.invoicingInvoiceState.invoiceByID[invoiceId];
+export const getInvoicesByIds = (state, invoiceIds) => invoiceIds
+    .map((id) => state.invoicingInvoiceState.invoiceByID[id])
+    .filter((invoice) => invoice != null);

package/lib/esm/entity/invoicing/invoice/invoiceState.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/entity/invoicing/invoicingCommonPayload.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/entity/invoicing/invoicingCommonState.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/entity/invoicing/invoicingCustomer/invoicingCustomerPayload.js

@@ -0,0 +1,67 @@
+import { toAmount } from '../../../commonStateTypes/amount';
+import { defaultCustomerCurrency } from '../../../commonStateTypes/currencyHelper';
+import { date } from '../../../zeniDayJS';
+import { mapInvoicingSubscriptionPayloadToState, } from '../invoicingSubscription/invoicingSubscriptionPayload';
+// ── Payload → State mappers (snake_case wire shape → camelCase domain shape) ──
+export const mapInvoicingCustomerPayloadToState = (payload) => {
+    const currencyCode = payload.preferred_currency_code ?? defaultCustomerCurrency.currencyCode;
+    const currencySymbol = payload.preferred_currency_symbol ?? defaultCustomerCurrency.currencySymbol;
+    return {
+        id: payload.id,
+        allowDirectDebit: payload.allow_direct_debit,
+        arr: payload.arr != null
+            ? toAmount(payload.arr, currencyCode, currencySymbol)
+            : undefined,
+        autoCollection: payload.auto_collection,
+        billingAddress: payload.billing_address,
+        cardStatus: payload.card_status,
+        company: payload.company,
+        consolidatedInvoicing: payload.consolidated_invoicing,
+        createdAt: payload.created_at != null ? date(payload.created_at) : undefined,
+        customerType: payload.customer_type,
+        defaultPaymentMethodID: payload.default_payment_method_id,
+        email: payload.email,
+        excessPayments: payload.excess_payments != null
+            ? toAmount(payload.excess_payments, currencyCode, currencySymbol)
+            : undefined,
+        firstName: payload.first_name,
+        fraudFlag: payload.fraud_flag,
+        initials: payload.initials,
+        invoiceNotes: payload.invoice_notes,
+        isAtRisk: payload.is_at_risk,
+        lastName: payload.last_name,
+        lifetimeValue: payload.lifetime_value != null
+            ? toAmount(payload.lifetime_value, currencyCode, currencySymbol)
+            : undefined,
+        locale: payload.locale,
+        mrr: payload.mrr != null
+            ? toAmount(payload.mrr, currencyCode, currencySymbol)
+            : undefined,
+        netTermDays: payload.net_term_days,
+        paymentMethod: payload.payment_method,
+        paymentMethodLast4: payload.payment_method_last4,
+        paymentMethodType: payload.payment_method_type,
+        phone: payload.phone,
+        plan: payload.plan,
+        planName: payload.plan_name,
+        preferredCurrencyCode: payload.preferred_currency_code,
+        promotionalCredits: payload.promotional_credits != null
+            ? toAmount(payload.promotional_credits, currencyCode, currencySymbol)
+            : undefined,
+        refundableCredits: payload.refundable_credits != null
+            ? toAmount(payload.refundable_credits, currencyCode, currencySymbol)
+            : undefined,
+        status: payload.status,
+        stripeCustomerID: payload.stripe_customer_id,
+        subscriptions: payload.subscriptions?.map(mapInvoicingSubscriptionPayloadToState),
+        taxability: payload.taxability,
+        totalReceivable: payload.total_receivable != null
+            ? toAmount(payload.total_receivable, currencyCode, currencySymbol)
+            : undefined,
+        unbilledCharges: payload.unbilled_charges != null
+            ? toAmount(payload.unbilled_charges, currencyCode, currencySymbol)
+            : undefined,
+        updatedAt: payload.updated_at != null ? date(payload.updated_at) : undefined,
+        vatNumber: payload.vat_number,
+    };
+};

package/lib/esm/entity/invoicing/invoicingCustomer/invoicingCustomerReducer.js

@@ -0,0 +1,40 @@
+import { createSlice } from '@reduxjs/toolkit';
+import assignWith from 'lodash/assignWith';
+import { mapInvoicingCustomerPayloadToState, } from './invoicingCustomerPayload';
+export const initialState = { customerByID: {} };
+const customer = createSlice({
+    name: 'invoicingCustomer',
+    initialState,
+    reducers: {
+        updateInvoicingCustomers: {
+            reducer(draft, action) {
+                doUpdateInvoicingCustomers(draft.customerByID, action.payload, action.meta.updateType);
+            },
+            prepare(payload, updateType = 'replace') {
+                return { payload, meta: { updateType } };
+            },
+        },
+        removeInvoicingCustomer(draft, action) {
+            delete draft.customerByID[action.payload];
+        },
+        clearAllInvoicingCustomers(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { updateInvoicingCustomers, removeInvoicingCustomer, clearAllInvoicingCustomers, } = customer.actions;
+export default customer.reducer;
+/**
+ * Helper functions.
+ */
+function doUpdateInvoicingCustomers(draft, payload, updateType) {
+    payload.forEach((customerPayload) => {
+        const latestCustomer = mapInvoicingCustomerPayloadToState(customerPayload);
+        if (latestCustomer.id in draft && updateType === 'merge') {
+            assignWith(draft[latestCustomer.id], latestCustomer, (objValue, srcValue) => (srcValue == null ? objValue : srcValue));
+        }
+        else {
+            draft[latestCustomer.id] = latestCustomer;
+        }
+    });
+}

package/lib/esm/entity/invoicing/invoicingCustomer/invoicingCustomerSelector.js

@@ -0,0 +1,10 @@
+import recordGet from 'lodash/get';
+export function getInvoicingCustomersByIds(invoicingCustomerState, ids) {
+    const invoicingCustomers = ids
+        .map((id) => getInvoicingCustomerById(invoicingCustomerState, id))
+        .filter((value) => value != null);
+    return invoicingCustomers;
+}
+export function getInvoicingCustomerById(invoicingCustomerState, id) {
+    return recordGet(invoicingCustomerState.customerByID, id);
+}

package/lib/esm/entity/invoicing/invoicingCustomer/invoicingCustomerState.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload.js

@@ -0,0 +1,97 @@
+import { toAmount } from '../../../commonStateTypes/amount';
+import { defaultCustomerCurrency } from '../../../commonStateTypes/currencyHelper';
+import { date } from '../../../zeniDayJS';
+// ── Payload → State mappers (snake_case wire shape → camelCase domain shape) ──
+export const mapInvoicingSubscriptionItemPayloadToState = (payload, currencyCode, currencySymbol) => ({
+    amount: payload.amount != null
+        ? toAmount(payload.amount, currencyCode, currencySymbol)
+        : undefined,
+    billingCycles: payload.billing_cycles,
+    catalogItemID: payload.catalog_item_id,
+    itemName: payload.item_name,
+    itemPriceID: payload.item_price_id,
+    itemType: payload.item_type,
+    quantity: payload.quantity,
+    unitPrice: payload.unit_price != null
+        ? toAmount(payload.unit_price, currencyCode, currencySymbol)
+        : undefined,
+});
+export const mapInvoicingSubscriptionCouponPayloadToState = (payload) => ({
+    couponID: payload.coupon_id,
+    appliedCount: payload.applied_count,
+    applyTill: payload.apply_till != null ? date(payload.apply_till) : undefined,
+    couponCode: payload.coupon_code,
+});
+export const mapInvoicingContractTermPayloadToState = (payload, currencyCode, currencySymbol) => ({
+    id: payload.id,
+    actionAtTermEnd: payload.action_at_term_end,
+    autoRenew: payload.auto_renew,
+    billingCycle: payload.billing_cycle,
+    cancellationNoticeDays: payload.cancellation_notice_days,
+    contractEnd: payload.contract_end != null ? date(payload.contract_end) : undefined,
+    contractStart: payload.contract_start != null ? date(payload.contract_start) : undefined,
+    status: payload.status,
+    totalContractValue: payload.total_contract_value != null
+        ? toAmount(payload.total_contract_value, currencyCode, currencySymbol)
+        : undefined,
+});
+export const mapInvoicingSubscriptionPayloadToState = (payload) => {
+    const currencyCode = payload.currency_code ?? defaultCustomerCurrency.currencyCode;
+    const currencySymbol = payload.currency_symbol ?? defaultCustomerCurrency.currencySymbol;
+    return {
+        customerID: payload.customer_id,
+        id: payload.id,
+        status: payload.status,
+        activatedAt: payload.activated_at != null ? date(payload.activated_at) : undefined,
+        autoCollection: payload.auto_collection,
+        autoCollectionCount: payload.auto_collection_count,
+        billingPeriod: payload.billing_period,
+        billingPeriodUnit: payload.billing_period_unit,
+        cancelReason: payload.cancel_reason,
+        cancelledAt: payload.cancelled_at != null ? date(payload.cancelled_at) : undefined,
+        catalogItemID: payload.catalog_item_id,
+        contractTerm: payload.contract_term != null
+            ? mapInvoicingContractTermPayloadToState(payload.contract_term, currencyCode, currencySymbol)
+            : undefined,
+        coupons: payload.coupons?.map(mapInvoicingSubscriptionCouponPayloadToState),
+        createdAt: payload.created_at != null ? date(payload.created_at) : undefined,
+        currencyCode: payload.currency_code,
+        currentTermEnd: payload.current_term_end != null
+            ? date(payload.current_term_end)
+            : undefined,
+        currentTermStart: payload.current_term_start != null
+            ? date(payload.current_term_start)
+            : undefined,
+        customerName: payload.customer_name,
+        dueInvoicesCount: payload.due_invoices_count,
+        dueSince: payload.due_since != null ? date(payload.due_since) : undefined,
+        hasScheduledChanges: payload.has_scheduled_changes,
+        mrr: payload.mrr != null
+            ? toAmount(payload.mrr, currencyCode, currencySymbol)
+            : undefined,
+        nextBillingAt: payload.next_billing_at != null
+            ? date(payload.next_billing_at)
+            : undefined,
+        pauseDate: payload.pause_date != null ? date(payload.pause_date) : undefined,
+        planAmount: payload.plan_amount != null
+            ? toAmount(payload.plan_amount, currencyCode, currencySymbol)
+            : undefined,
+        planID: payload.plan_id,
+        planName: payload.plan_name,
+        poNumber: payload.po_number,
+        remainingBillingCycles: payload.remaining_billing_cycles,
+        resumeDate: payload.resume_date != null ? date(payload.resume_date) : undefined,
+        setupFee: payload.setup_fee != null
+            ? toAmount(payload.setup_fee, currencyCode, currencySymbol)
+            : undefined,
+        shippingAddress: payload.shipping_address,
+        startedAt: payload.started_at != null ? date(payload.started_at) : undefined,
+        subscriptionItems: payload.subscription_items?.map((item) => mapInvoicingSubscriptionItemPayloadToState(item, currencyCode, currencySymbol)),
+        totalDues: payload.total_dues != null
+            ? toAmount(payload.total_dues, currencyCode, currencySymbol)
+            : undefined,
+        trialEnd: payload.trial_end != null ? date(payload.trial_end) : undefined,
+        trialStart: payload.trial_start != null ? date(payload.trial_start) : undefined,
+        updatedAt: payload.updated_at != null ? date(payload.updated_at) : undefined,
+    };
+};

package/lib/esm/entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer.js

@@ -0,0 +1,42 @@
+import { createSlice } from '@reduxjs/toolkit';
+import assignWith from 'lodash/assignWith';
+import { mapInvoicingSubscriptionPayloadToState, } from './invoicingSubscriptionPayload';
+export const initialState = {
+    invoicingSubscriptionByID: {},
+};
+const invoicingSubscription = createSlice({
+    name: 'invoicingSubscription',
+    initialState,
+    reducers: {
+        updateInvoicingSubscriptions: {
+            reducer(draft, action) {
+                doUpdateInvoicingSubscriptions(draft.invoicingSubscriptionByID, action.payload, action.meta.updateType);
+            },
+            prepare(payload, updateType = 'replace') {
+                return { payload, meta: { updateType } };
+            },
+        },
+        removeInvoicingSubscription(draft, action) {
+            delete draft.invoicingSubscriptionByID[action.payload];
+        },
+        clearAllInvoicingSubscriptions(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { updateInvoicingSubscriptions, removeInvoicingSubscription, clearAllInvoicingSubscriptions, } = invoicingSubscription.actions;
+export default invoicingSubscription.reducer;
+/**
+ * Helper functions.
+ */
+function doUpdateInvoicingSubscriptions(draft, payload, updateType) {
+    payload.forEach((subscriptionPayload) => {
+        const latestSubscription = mapInvoicingSubscriptionPayloadToState(subscriptionPayload);
+        if (latestSubscription.id in draft && updateType === 'merge') {
+            assignWith(draft[latestSubscription.id], latestSubscription, (objValue, srcValue) => (srcValue == null ? objValue : srcValue));
+        }
+        else {
+            draft[latestSubscription.id] = latestSubscription;
+        }
+    });
+}

package/lib/esm/entity/invoicing/invoicingSubscription/invoicingSubscriptionSelector.js

@@ -0,0 +1,10 @@
+import recordGet from 'lodash/get';
+export function getInvoicingSubscriptionsByIds(invoicingSubscriptionState, ids) {
+    const invoicingSubscriptions = ids
+        .map((id) => getInvoicingSubscriptionById(invoicingSubscriptionState, id))
+        .filter((value) => value != null);
+    return invoicingSubscriptions;
+}
+export function getInvoicingSubscriptionById(invoicingSubscriptionState, id) {
+    return recordGet(invoicingSubscriptionState.invoicingSubscriptionByID, id);
+}

package/lib/esm/entity/invoicing/invoicingSubscription/invoicingSubscriptionState.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/entity/invoicing/invoicingTransaction/invoicingTransactionPayload.js

@@ -0,0 +1,58 @@
+import { toAmount } from '../../../commonStateTypes/amount';
+import { date } from '../../../zeniDayJS';
+// ── Payload → State mappers (snake_case wire shape → camelCase domain shape) ──
+const DEFAULT_CURRENCY_CODE = 'USD';
+const DEFAULT_CURRENCY_SYMBOL = '$';
+const mapLinkedInvoiceRef = (payload, currencyCode, currencySymbol) => ({
+    appliedAmount: toAmount(payload.applied_amount, currencyCode, currencySymbol),
+    invoiceID: payload.invoice_id,
+    invoiceStatus: payload.invoice_status,
+});
+const mapLinkedRefund = (payload, currencyCode, currencySymbol) => ({
+    txnAmount: toAmount(payload.txn_amount, currencyCode, currencySymbol),
+    txnID: payload.txn_id,
+    txnStatus: payload.txn_status,
+});
+const mapLinkedCreditNoteRef = (payload, currencyCode, currencySymbol) => ({
+    appliedAmount: toAmount(payload.applied_amount, currencyCode, currencySymbol),
+    cnID: payload.cn_id,
+});
+export const mapInvoicingTransactionPayloadToState = (payload) => {
+    const currencyCode = payload.currency_code ?? DEFAULT_CURRENCY_CODE;
+    const currencySymbol = DEFAULT_CURRENCY_SYMBOL;
+    const toAmt = (value) => toAmount(value, currencyCode, currencySymbol);
+    return {
+        amount: toAmt(payload.amount),
+        id: payload.id,
+        amountCapturable: payload.amount_capturable != null
+            ? toAmt(payload.amount_capturable)
+            : undefined,
+        amountUnused: payload.amount_unused != null ? toAmt(payload.amount_unused) : undefined,
+        currencyCode: payload.currency_code,
+        customer: payload.customer,
+        customerID: payload.customer_id,
+        customerName: payload.customer_name,
+        date: payload.date != null ? date(payload.date) : undefined,
+        errorCode: payload.error_code,
+        errorText: payload.error_text,
+        fraudFlag: payload.fraud_flag,
+        fraudReason: payload.fraud_reason,
+        gateway: payload.gateway,
+        gatewayAccountID: payload.gateway_account_id,
+        idAtGateway: payload.id_at_gateway,
+        invoiceID: payload.invoice_id,
+        linkedCreditNotes: payload.linked_credit_notes?.map((ref) => mapLinkedCreditNoteRef(ref, currencyCode, currencySymbol)),
+        linkedInvoices: payload.linked_invoices?.map((ref) => mapLinkedInvoiceRef(ref, currencyCode, currencySymbol)),
+        linkedRefunds: payload.linked_refunds?.map((ref) => mapLinkedRefund(ref, currencyCode, currencySymbol)),
+        maskedCardNumber: payload.masked_card_number,
+        paymentMethod: payload.payment_method,
+        paymentSourceID: payload.payment_source_id,
+        referenceNumber: payload.reference_number,
+        refundedTxnID: payload.refunded_txn_id,
+        settledAt: payload.settled_at != null ? date(payload.settled_at) : undefined,
+        status: payload.status,
+        subscriptionID: payload.subscription_id,
+        threeDSecure: payload.three_d_secure,
+        type: payload.type,
+    };
+};

package/lib/esm/entity/invoicing/invoicingTransaction/invoicingTransactionReducer.js

@@ -0,0 +1,42 @@
+import { createSlice } from '@reduxjs/toolkit';
+import assignWith from 'lodash/assignWith';
+import { mapInvoicingTransactionPayloadToState, } from './invoicingTransactionPayload';
+export const initialState = {
+    invoicingTransactionByID: {},
+};
+const invoicingTransaction = createSlice({
+    name: 'invoicingTransaction',
+    initialState,
+    reducers: {
+        updateInvoicingTransactions: {
+            reducer(draft, action) {
+                doUpdateInvoicingTransactions(draft.invoicingTransactionByID, action.payload, action.meta.updateType);
+            },
+            prepare(payload, updateType = 'replace') {
+                return { payload, meta: { updateType } };
+            },
+        },
+        removeInvoicingTransaction(draft, action) {
+            delete draft.invoicingTransactionByID[action.payload];
+        },
+        clearAllInvoicingTransactions(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { updateInvoicingTransactions, removeInvoicingTransaction, clearAllInvoicingTransactions, } = invoicingTransaction.actions;
+export default invoicingTransaction.reducer;
+/**
+ * Helper functions.
+ */
+function doUpdateInvoicingTransactions(draft, payload, updateType) {
+    payload.forEach((invoicingTransactionPayload) => {
+        const latestInvoicingTransaction = mapInvoicingTransactionPayloadToState(invoicingTransactionPayload);
+        if (latestInvoicingTransaction.id in draft && updateType === 'merge') {
+            assignWith(draft[latestInvoicingTransaction.id], latestInvoicingTransaction, (objValue, srcValue) => (srcValue == null ? objValue : srcValue));
+        }
+        else {
+            draft[latestInvoicingTransaction.id] = latestInvoicingTransaction;
+        }
+    });
+}

package/lib/esm/entity/invoicing/invoicingTransaction/invoicingTransactionSelector.js

@@ -0,0 +1,10 @@
+import recordGet from 'lodash/get';
+export function getInvoicingTransactionsByIds(invoicingTransactionState, ids) {
+    const invoicingTransactions = ids
+        .map((id) => getInvoicingTransactionById(invoicingTransactionState, id))
+        .filter((value) => value != null);
+    return invoicingTransactions;
+}
+export function getInvoicingTransactionById(invoicingTransactionState, id) {
+    return recordGet(invoicingTransactionState.invoicingTransactionByID, id);
+}

package/lib/esm/entity/invoicing/invoicingTransaction/invoicingTransactionState.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/entity/invoicing/plan/planPayload.js

@@ -0,0 +1,45 @@
+import { toAmount } from '../../../commonStateTypes/amount';
+import { defaultCustomerCurrency } from '../../../commonStateTypes/currencyHelper';
+import { date } from '../../../zeniDayJS';
+import { mapInvoicingPlanTierPayloadToState, mapInvoicingProductPayloadToState, } from '../product/productPayload';
+// ── Payload → State mappers (snake_case wire shape → camelCase domain shape) ──
+export const mapInvoicingPlanPayloadToState = (payload) => {
+    const currencyCode = payload.currency_code ?? defaultCustomerCurrency.currencyCode;
+    const currencySymbol = payload.currency_symbol ?? defaultCustomerCurrency.currencySymbol;
+    return {
+        id: payload.id,
+        applicableItems: payload.applicable_items,
+        archivedAt: payload.archived_at != null ? date(payload.archived_at) : undefined,
+        billingCycles: payload.billing_cycles,
+        createdAt: payload.created_at != null ? date(payload.created_at) : undefined,
+        currencyCode: payload.currency_code,
+        description: payload.description,
+        enabledForCheckout: payload.enabled_for_checkout,
+        enabledInPortal: payload.enabled_in_portal,
+        externalName: payload.external_name,
+        giftClaimRedirectUrl: payload.gift_claim_redirect_url,
+        includedInMrr: payload.included_in_mrr,
+        isGiftable: payload.is_giftable,
+        isShippable: payload.is_shippable,
+        itemApplicability: payload.item_applicability,
+        itemFamilyID: payload.item_family_id,
+        itemType: payload.item_type,
+        metadata: payload.metadata,
+        metered: payload.metered,
+        name: payload.name,
+        period: payload.period,
+        periodUnit: payload.period_unit,
+        price: payload.price != null
+            ? toAmount(payload.price, currencyCode, currencySymbol)
+            : undefined,
+        prices: payload.prices?.map(mapInvoicingProductPayloadToState),
+        status: payload.status,
+        tiers: payload.tiers?.map((tier) => mapInvoicingPlanTierPayloadToState(tier, currencyCode, currencySymbol)),
+        trialPeriod: payload.trial_period,
+        trialPeriodUnit: payload.trial_period_unit,
+        type: payload.type,
+        unit: payload.unit,
+        updatedAt: payload.updated_at != null ? date(payload.updated_at) : undefined,
+        usageCalculation: payload.usage_calculation,
+    };
+};

package/lib/esm/entity/invoicing/plan/planReducer.js

@@ -0,0 +1,40 @@
+import { createSlice } from '@reduxjs/toolkit';
+import assignWith from 'lodash/assignWith';
+import { mapInvoicingPlanPayloadToState, } from './planPayload';
+export const initialState = { planByID: {} };
+const plan = createSlice({
+    name: 'invoicingPlan',
+    initialState,
+    reducers: {
+        updateInvoicingPlans: {
+            reducer(draft, action) {
+                doUpdateInvoicingPlans(draft.planByID, action.payload, action.meta.updateType);
+            },
+            prepare(payload, updateType = 'replace') {
+                return { payload, meta: { updateType } };
+            },
+        },
+        removeInvoicingPlan(draft, action) {
+            delete draft.planByID[action.payload];
+        },
+        clearAllInvoicingPlans(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { updateInvoicingPlans, removeInvoicingPlan, clearAllInvoicingPlans, } = plan.actions;
+export default plan.reducer;
+/**
+ * Helper functions.
+ */
+function doUpdateInvoicingPlans(draft, payload, updateType) {
+    payload.forEach((planPayload) => {
+        const latestPlan = mapInvoicingPlanPayloadToState(planPayload);
+        if (latestPlan.id in draft && updateType === 'merge') {
+            assignWith(draft[latestPlan.id], latestPlan, (objValue, srcValue) => srcValue == null ? objValue : srcValue);
+        }
+        else {
+            draft[latestPlan.id] = latestPlan;
+        }
+    });
+}