@zeniai/client-epic-state 5.1.60 → 5.1.61

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

@@ -0,0 +1,146 @@
+import { toAmount } from '../../../commonStateTypes/amount';
+import { defaultCustomerCurrency } from '../../../commonStateTypes/currencyHelper';
+import { date } from '../../../zeniDayJS';
+// ── Payload → State mappers (snake_case wire shape → camelCase domain shape) ──
+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,
+    productCode: payload.product_code,
+    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,
+});
+const mapInvoiceDiscount = (payload, currencyCode, currencySymbol) => ({
+    entityType: payload.entity_type,
+    entityID: payload.entity_id,
+    amount: toAmount(payload.amount, currencyCode, currencySymbol),
+    description: payload.description,
+    lineItemID: payload.line_item_id ?? undefined,
+});
+/**
+ * Collect the embedded billing + shipping addresses from invoice payloads so they
+ * can be pushed into the shared address store (`updateAddresses`), while the
+ * invoice entity keeps only the address ids — mirrors the vendor flow.
+ */
+export const extractInvoicingInvoiceAddresses = (payloads) => payloads
+    .flatMap((payload) => [payload.billing_address, payload.shipping_address])
+    .filter((address) => address != null);
+export const mapInvoicingInvoicePayloadToState = (payload) => {
+    const currencyCode = payload.currency_code ?? defaultCustomerCurrency.currencyCode;
+    const currencySymbol = payload.currency_symbol ?? defaultCustomerCurrency.currencySymbol;
+    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,
+        billingAddressId: payload.billing_address != null
+            ? payload.billing_address.address_id
+            : undefined,
+        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,
+        discounts: payload.discounts?.map((discount) => mapInvoiceDiscount(discount, currencyCode, currencySymbol)),
+        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,
+        grossSubTotal: payload.gross_sub_total != null
+            ? toAmt(payload.gross_sub_total)
+            : 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,
+        shippingAddressId: payload.shipping_address != null
+            ? payload.shipping_address.address_id
+            : undefined,
+        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, defaultCustomerCurrency.currencyCode, defaultCustomerCurrency.currencySymbol),
+    paidTotal: toAmount(payload.paid_total, defaultCustomerCurrency.currencyCode, defaultCustomerCurrency.currencySymbol),
+    pendingTotal: toAmount(payload.pending_total, defaultCustomerCurrency.currencyCode, defaultCustomerCurrency.currencySymbol),
+    totalInvoiced: toAmount(payload.total_invoiced, defaultCustomerCurrency.currencyCode, defaultCustomerCurrency.currencySymbol),
+});

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,9 @@
+import recordGet from 'lodash/get';
+export function getInvoicesByIds(invoiceState, invoiceIds) {
+    return invoiceIds
+        .map((id) => getInvoiceById(invoiceState, id))
+        .filter((invoice) => invoice != null);
+}
+export function getInvoiceById(invoiceState, invoiceId) {
+    return recordGet(invoiceState.invoiceByID, invoiceId);
+}

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

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

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

@@ -0,0 +1,150 @@
+export const INVOICING_DUNNING_ACTIONS = [
+    'email_only',
+    'email_and_retry',
+    'do_nothing',
+    'retry_only',
+];
+export function toInvoicingDunningAction(value) {
+    switch (value) {
+        case 'email_only':
+        case 'email_and_retry':
+        case 'do_nothing':
+        case 'retry_only':
+            return value;
+        default:
+            throw new Error(`Unknown InvoicingDunningAction: ${value}`);
+    }
+}
+export const INVOICING_SUBSCRIPTION_LIFECYCLE_ACTIONS = [
+    'pause',
+    'resume',
+    'cancel',
+    'reactivate',
+    'set_non_renewing',
+    'activate',
+    'remove_scheduled_cancellation',
+    'change_term_end',
+];
+export function toInvoicingSubscriptionLifecycleAction(value) {
+    switch (value) {
+        case 'pause':
+        case 'resume':
+        case 'cancel':
+        case 'reactivate':
+        case 'set_non_renewing':
+        case 'activate':
+        case 'remove_scheduled_cancellation':
+        case 'change_term_end':
+            return value;
+        default:
+            throw new Error(`Unknown InvoicingSubscriptionLifecycleAction: ${value}`);
+    }
+}
+export function toInvoicingSubscriptionLifecycleActionOption(option) {
+    return {
+        allowedFromStatuses: option.allowed_from_statuses,
+        code: toInvoicingSubscriptionLifecycleAction(option.code),
+        name: option.name,
+    };
+}
+export const INVOICING_CATALOG_ITEM_LIFECYCLE_ACTIONS = [
+    'archive',
+    'reactivate',
+    'delete',
+    'clone',
+];
+export function toInvoicingCatalogItemLifecycleAction(value) {
+    switch (value) {
+        case 'archive':
+        case 'reactivate':
+        case 'delete':
+        case 'clone':
+            return value;
+        default:
+            throw new Error(`Unknown InvoicingCatalogItemLifecycleAction: ${value}`);
+    }
+}
+export const INVOICING_CATALOG_PRODUCT_LIFECYCLE_ACTIONS = [
+    'archive',
+    'reactivate',
+    'delete',
+];
+export function toInvoicingCatalogProductLifecycleAction(value) {
+    switch (value) {
+        case 'archive':
+        case 'reactivate':
+        case 'delete':
+            return value;
+        default:
+            throw new Error(`Unknown InvoicingCatalogProductLifecycleAction: ${value}`);
+    }
+}
+export function toInvoicingCatalogItemLifecycleActionOption(option) {
+    return {
+        allowedFromStatuses: option.allowed_from_statuses,
+        code: toInvoicingCatalogItemLifecycleAction(option.code),
+        name: option.name,
+    };
+}
+export function toInvoicingCatalogProductLifecycleActionOption(option) {
+    return {
+        allowedFromStatuses: option.allowed_from_statuses,
+        code: toInvoicingCatalogProductLifecycleAction(option.code),
+        name: option.name,
+    };
+}
+export const INVOICING_DISCOUNT_LIFECYCLE_ACTIONS = [
+    'archive',
+    'unarchive',
+    'delete',
+];
+export function toInvoicingDiscountLifecycleAction(value) {
+    switch (value) {
+        case 'archive':
+        case 'unarchive':
+        case 'delete':
+            return value;
+        default:
+            throw new Error(`Unknown InvoicingDiscountLifecycleAction: ${value}`);
+    }
+}
+export function toInvoicingDiscountLifecycleActionOption(option) {
+    return {
+        allowedFromStatuses: option.allowed_from_statuses,
+        code: toInvoicingDiscountLifecycleAction(option.code),
+        name: option.name,
+    };
+}
+export function toInvoicingNamedOption(option) {
+    return { code: option.code, name: option.name };
+}
+export function toInvoicingSubscriptionEditFieldOption(option) {
+    return {
+        code: option.code,
+        group: option.group,
+        name: option.name,
+    };
+}
+export function toAuditLogEntityRouteOption(option) {
+    return {
+        entityType: option.entity_type,
+        routeSegment: option.route_segment,
+        idParam: option.id_param,
+        linkable: option.linkable,
+    };
+}
+/**
+ * Build an invoicing detail path from backend config route options.
+ * Returns null when the entity type is not linkable or has no route segment.
+ */
+export function buildInvoicingEntityPath(tenantBase, entityType, entityId, routeOptions) {
+    const option = routeOptions.find((row) => row.entityType === entityType);
+    if (option == null || !option.linkable || option.routeSegment === '') {
+        return null;
+    }
+    return `${tenantBase}/${option.routeSegment}/${encodeURIComponent(entityId)}`;
+}
+export function isInvoicingEntityLinkable(entityType, routeOptions) {
+    const option = routeOptions.find((row) => row.entityType === entityType);
+    return option?.linkable === true && option.routeSegment !== '';
+}

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

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

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

@@ -0,0 +1,76 @@
+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) ──
+/**
+ * Collect the embedded billing addresses from customer payloads so they can be
+ * pushed into the shared address store (`updateAddresses`), while the customer
+ * entity keeps only `billingAddressId` — mirrors the vendor flow.
+ */
+export const extractInvoicingCustomerAddresses = (payloads) => payloads
+    .map((payload) => payload.billing_address)
+    .filter((address) => address != null);
+export const mapInvoicingCustomerPayloadToState = (payload) => {
+    const currencyCode = payload.preferred_currency_code ?? defaultCustomerCurrency.currencyCode;
+    const currencySymbol = payload.preferred_currency_symbol ?? defaultCustomerCurrency.currencySymbol;
+    return {
+        id: payload.id,
+        arr: payload.arr != null
+            ? toAmount(payload.arr, currencyCode, currencySymbol)
+            : undefined,
+        autoCollection: payload.auto_collection,
+        billingAddressId: payload.billing_address_id ?? payload.billing_address?.address_id,
+        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,
+        notes: payload.notes,
+        paymentMethod: payload.payment_method,
+        paymentMethodLast4: payload.payment_method_last4,
+        paymentMethodType: payload.payment_method_type,
+        phone: payload.phone,
+        plan: payload.plan,
+        planName: payload.plan_name,
+        productCode: payload.product_code,
+        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,110 @@
+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,
+    itemPriceCode: payload.item_price_code,
+    itemPriceID: payload.item_price_id,
+    itemType: payload.item_type,
+    productCode: payload.product_code,
+    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,
+});
+/**
+ * Collect the embedded shipping addresses from subscription payloads so they can
+ * be pushed into the shared address store (via `updateAddresses`), while the
+ * subscription entity keeps only `shippingAddressId` — mirrors the vendor flow.
+ */
+export const extractInvoicingSubscriptionAddresses = (payloads) => payloads
+    .map((payload) => payload.shipping_address)
+    .filter((address) => address != null);
+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,
+        productCode: payload.product_code,
+        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,
+        shippingAddressId: payload.shipping_address != null
+            ? payload.shipping_address.address_id
+            : undefined,
+        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 {};