@zeniai/client-epic-state 5.1.34 → 5.1.35-betaAK1

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;

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

@@ -0,0 +1,9 @@
+import { UpdateType } from '../../../commonStateTypes/common';
+import { InvoicingCreditNotePayload } from './creditNotePayload';
+import { InvoicingCreditNoteState } from './creditNoteState';
+export declare const initialState: InvoicingCreditNoteState;
+export declare const updateInvoicingCreditNotes: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: InvoicingCreditNotePayload[], updateType?: UpdateType | undefined], InvoicingCreditNotePayload[], "invoicingCreditNote/updateInvoicingCreditNotes", never, {
+    updateType: UpdateType;
+}>, removeInvoicingCreditNote: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "invoicingCreditNote/removeInvoicingCreditNote">, clearAllInvoicingCreditNotes: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingCreditNote/clearAllInvoicingCreditNotes">;
+declare const _default: import("redux").Reducer<InvoicingCreditNoteState>;
+export default _default;

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

@@ -0,0 +1,49 @@
+"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.clearAllInvoicingCreditNotes = exports.removeInvoicingCreditNote = exports.updateInvoicingCreditNotes = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const assignWith_1 = __importDefault(require("lodash/assignWith"));
+const creditNotePayload_1 = require("./creditNotePayload");
+exports.initialState = {
+    creditNoteByID: {},
+};
+const creditNote = (0, toolkit_1.createSlice)({
+    name: 'invoicingCreditNote',
+    initialState: exports.initialState,
+    reducers: {
+        updateInvoicingCreditNotes: {
+            reducer(draft, action) {
+                doUpdateInvoicingCreditNotes(draft.creditNoteByID, action.payload, action.meta.updateType);
+            },
+            prepare(payload, updateType = 'replace') {
+                return { payload, meta: { updateType } };
+            },
+        },
+        removeInvoicingCreditNote(draft, action) {
+            delete draft.creditNoteByID[action.payload];
+        },
+        clearAllInvoicingCreditNotes(draft) {
+            Object.assign(draft, exports.initialState);
+        },
+    },
+});
+_a = creditNote.actions, exports.updateInvoicingCreditNotes = _a.updateInvoicingCreditNotes, exports.removeInvoicingCreditNote = _a.removeInvoicingCreditNote, exports.clearAllInvoicingCreditNotes = _a.clearAllInvoicingCreditNotes;
+exports.default = creditNote.reducer;
+/**
+ * Helper functions.
+ */
+function doUpdateInvoicingCreditNotes(draft, payload, updateType) {
+    payload.forEach((creditNotePayload) => {
+        const latestCreditNote = (0, creditNotePayload_1.mapInvoicingCreditNotePayloadToState)(creditNotePayload);
+        if (latestCreditNote.id in draft && updateType === 'merge') {
+            (0, assignWith_1.default)(draft[latestCreditNote.id], latestCreditNote, (objValue, srcValue) => (srcValue == null ? objValue : srcValue));
+        }
+        else {
+            draft[latestCreditNote.id] = latestCreditNote;
+        }
+    });
+}

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

@@ -0,0 +1,4 @@
+import { ID } from '../../../commonStateTypes/common';
+import { InvoicingCreditNote, InvoicingCreditNoteState } from './creditNoteState';
+export declare function getInvoicingCreditNotesByIds(creditNoteState: InvoicingCreditNoteState, ids: ID[]): InvoicingCreditNote[];
+export declare function getInvoicingCreditNoteById(creditNoteState: InvoicingCreditNoteState, id: ID): InvoicingCreditNote | undefined;

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

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingCreditNotesByIds = getInvoicingCreditNotesByIds;
+exports.getInvoicingCreditNoteById = getInvoicingCreditNoteById;
+const get_1 = __importDefault(require("lodash/get"));
+function getInvoicingCreditNotesByIds(creditNoteState, ids) {
+    const creditNotes = ids
+        .map((id) => getInvoicingCreditNoteById(creditNoteState, id))
+        .filter((value) => value != null);
+    return creditNotes;
+}
+function getInvoicingCreditNoteById(creditNoteState, id) {
+    return (0, get_1.default)(creditNoteState.creditNoteByID, id);
+}

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

@@ -0,0 +1,52 @@
+import { Amount } from '../../../commonStateTypes/amount';
+import { ID } from '../../../commonStateTypes/common';
+import { ZeniDate } from '../../../zeniDayJS';
+import { InvoicingPriceType } from '../invoicingCommonPayload';
+import { InvoicingCreditNoteStatus, InvoicingCreditNoteType } from './creditNotePayload';
+export interface InvoicingCreditNoteLineItem {
+    amount: Amount;
+    description: string;
+    quantity: number;
+    unitAmount: Amount;
+    entityType?: string;
+    id?: ID;
+}
+export interface InvoicingCreditNoteAllocation {
+    allocatedAmount: Amount;
+    invoiceID: ID;
+    allocatedAt?: ZeniDate;
+}
+export interface InvoicingCreditNote {
+    id: ID;
+    allocations?: InvoicingCreditNoteAllocation[];
+    amountAllocated?: Amount;
+    amountAvailable?: Amount;
+    amountRefunded?: Amount;
+    createdAt?: ZeniDate;
+    createReasonCode?: string;
+    creditNoteNumber?: string;
+    currencyCode?: string;
+    customerID?: ID;
+    customerName?: string;
+    date?: ZeniDate;
+    lineItems?: InvoicingCreditNoteLineItem[];
+    linkedRefunds?: ID[];
+    notes?: string;
+    priceType?: InvoicingPriceType;
+    reasonCode?: string;
+    referenceInvoiceID?: ID;
+    status?: InvoicingCreditNoteStatus;
+    subscriptionID?: ID;
+    subTotal?: Amount;
+    total?: Amount;
+    type?: InvoicingCreditNoteType;
+}
+export interface InvoicingCreditKPIs {
+    totalAllocated: Amount;
+    totalAvailable: Amount;
+    totalOpen: Amount;
+    totalRefunded: Amount;
+}
+export interface InvoicingCreditNoteState {
+    creditNoteByID: Record<ID, InvoicingCreditNote>;
+}

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

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

package/lib/entity/invoicing/dunningCase/dunningCasePayload.d.ts

@@ -0,0 +1,32 @@
+import { InvoicingDunningCase, InvoicingDunningKPIs } from './dunningCaseState';
+export type InvoicingDunningStatus = 'Retrying' | 'Scheduled' | 'Manual Review' | 'Resolved' | 'Cancelled' | 'Paused';
+export interface InvoicingDunningCasePayload {
+    id: string;
+    status: InvoicingDunningStatus;
+    amount?: number;
+    attempts?: number;
+    created_at?: string;
+    currency_code?: string;
+    customer?: string;
+    customer_email?: string;
+    customer_id?: string;
+    days_past_due?: number;
+    failure_reason?: string;
+    initials?: string;
+    invoice_id?: string;
+    last_attempt?: string;
+    max_attempts?: number;
+    next_retry?: string;
+    paused_reason?: string;
+    paused_until?: string;
+    subscription_id?: string;
+}
+export interface InvoicingDunningKPIsPayload {
+    active_cases: number;
+    at_risk_amount: number;
+    recovery_rate: number;
+    total_cases: number;
+    avg_days_to_resolve?: number | null;
+}
+export declare const mapInvoicingDunningCasePayloadToState: (payload: InvoicingDunningCasePayload) => InvoicingDunningCase;
+export declare const mapInvoicingDunningKPIsPayloadToState: (payload: InvoicingDunningKPIsPayload) => InvoicingDunningKPIs;

package/lib/entity/invoicing/dunningCase/dunningCasePayload.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapInvoicingDunningKPIsPayloadToState = exports.mapInvoicingDunningCasePayloadToState = 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 mapInvoicingDunningCasePayloadToState = (payload) => {
+    const currencyCode = payload.currency_code ?? DEFAULT_CURRENCY_CODE;
+    const currencySymbol = DEFAULT_CURRENCY_SYMBOL;
+    return {
+        id: payload.id,
+        status: payload.status,
+        amount: payload.amount != null
+            ? (0, amount_1.toAmount)(payload.amount, currencyCode, currencySymbol)
+            : undefined,
+        attempts: payload.attempts,
+        createdAt: payload.created_at != null ? (0, zeniDayJS_1.date)(payload.created_at) : undefined,
+        currencyCode: payload.currency_code,
+        customer: payload.customer,
+        customerEmail: payload.customer_email,
+        customerID: payload.customer_id,
+        daysPastDue: payload.days_past_due,
+        failureReason: payload.failure_reason,
+        initials: payload.initials,
+        invoiceID: payload.invoice_id,
+        lastAttempt: payload.last_attempt != null ? (0, zeniDayJS_1.date)(payload.last_attempt) : undefined,
+        maxAttempts: payload.max_attempts,
+        nextRetry: payload.next_retry != null ? (0, zeniDayJS_1.date)(payload.next_retry) : undefined,
+        pausedReason: payload.paused_reason,
+        pausedUntil: payload.paused_until != null ? (0, zeniDayJS_1.date)(payload.paused_until) : undefined,
+        subscriptionID: payload.subscription_id,
+    };
+};
+exports.mapInvoicingDunningCasePayloadToState = mapInvoicingDunningCasePayloadToState;
+const mapInvoicingDunningKPIsPayloadToState = (payload) => ({
+    activeCases: payload.active_cases,
+    atRiskAmount: (0, amount_1.toAmount)(payload.at_risk_amount, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    recoveryRate: payload.recovery_rate,
+    totalCases: payload.total_cases,
+    avgDaysToResolve: payload.avg_days_to_resolve,
+});
+exports.mapInvoicingDunningKPIsPayloadToState = mapInvoicingDunningKPIsPayloadToState;

package/lib/entity/invoicing/dunningCase/dunningCaseReducer.d.ts

@@ -0,0 +1,9 @@
+import { UpdateType } from '../../../commonStateTypes/common';
+import { InvoicingDunningCasePayload } from './dunningCasePayload';
+import { InvoicingDunningCaseState } from './dunningCaseState';
+export declare const initialState: InvoicingDunningCaseState;
+export declare const updateInvoicingDunningCases: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: InvoicingDunningCasePayload[], updateType?: UpdateType | undefined], InvoicingDunningCasePayload[], "invoicingDunningCase/updateInvoicingDunningCases", never, {
+    updateType: UpdateType;
+}>, removeInvoicingDunningCase: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "invoicingDunningCase/removeInvoicingDunningCase">, clearAllInvoicingDunningCases: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingDunningCase/clearAllInvoicingDunningCases">;
+declare const _default: import("redux").Reducer<InvoicingDunningCaseState>;
+export default _default;

package/lib/entity/invoicing/dunningCase/dunningCaseReducer.js

@@ -0,0 +1,49 @@
+"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.clearAllInvoicingDunningCases = exports.removeInvoicingDunningCase = exports.updateInvoicingDunningCases = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const assignWith_1 = __importDefault(require("lodash/assignWith"));
+const dunningCasePayload_1 = require("./dunningCasePayload");
+exports.initialState = {
+    dunningCaseByID: {},
+};
+const dunningCase = (0, toolkit_1.createSlice)({
+    name: 'invoicingDunningCase',
+    initialState: exports.initialState,
+    reducers: {
+        updateInvoicingDunningCases: {
+            reducer(draft, action) {
+                doUpdateInvoicingDunningCases(draft.dunningCaseByID, action.payload, action.meta.updateType);
+            },
+            prepare(payload, updateType = 'replace') {
+                return { payload, meta: { updateType } };
+            },
+        },
+        removeInvoicingDunningCase(draft, action) {
+            delete draft.dunningCaseByID[action.payload];
+        },
+        clearAllInvoicingDunningCases(draft) {
+            Object.assign(draft, exports.initialState);
+        },
+    },
+});
+_a = dunningCase.actions, exports.updateInvoicingDunningCases = _a.updateInvoicingDunningCases, exports.removeInvoicingDunningCase = _a.removeInvoicingDunningCase, exports.clearAllInvoicingDunningCases = _a.clearAllInvoicingDunningCases;
+exports.default = dunningCase.reducer;
+/**
+ * Helper functions.
+ */
+function doUpdateInvoicingDunningCases(draft, payload, updateType) {
+    payload.forEach((dunningCasePayload) => {
+        const latestDunningCase = (0, dunningCasePayload_1.mapInvoicingDunningCasePayloadToState)(dunningCasePayload);
+        if (latestDunningCase.id in draft && updateType === 'merge') {
+            (0, assignWith_1.default)(draft[latestDunningCase.id], latestDunningCase, (objValue, srcValue) => (srcValue == null ? objValue : srcValue));
+        }
+        else {
+            draft[latestDunningCase.id] = latestDunningCase;
+        }
+    });
+}

package/lib/entity/invoicing/dunningCase/dunningCaseSelector.d.ts

@@ -0,0 +1,4 @@
+import { ID } from '../../../commonStateTypes/common';
+import { InvoicingDunningCase, InvoicingDunningCaseState } from './dunningCaseState';
+export declare function getInvoicingDunningCasesByIds(dunningCaseState: InvoicingDunningCaseState, ids: ID[]): InvoicingDunningCase[];
+export declare function getInvoicingDunningCaseById(dunningCaseState: InvoicingDunningCaseState, id: ID): InvoicingDunningCase | undefined;

package/lib/entity/invoicing/dunningCase/dunningCaseSelector.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingDunningCasesByIds = getInvoicingDunningCasesByIds;
+exports.getInvoicingDunningCaseById = getInvoicingDunningCaseById;
+const get_1 = __importDefault(require("lodash/get"));
+function getInvoicingDunningCasesByIds(dunningCaseState, ids) {
+    const dunningCases = ids
+        .map((id) => getInvoicingDunningCaseById(dunningCaseState, id))
+        .filter((value) => value != null);
+    return dunningCases;
+}
+function getInvoicingDunningCaseById(dunningCaseState, id) {
+    return (0, get_1.default)(dunningCaseState.dunningCaseByID, id);
+}

package/lib/entity/invoicing/dunningCase/dunningCaseState.d.ts

@@ -0,0 +1,35 @@
+import { Amount } from '../../../commonStateTypes/amount';
+import { ID } from '../../../commonStateTypes/common';
+import { ZeniDate } from '../../../zeniDayJS';
+import { InvoicingDunningStatus } from './dunningCasePayload';
+export interface InvoicingDunningCase {
+    id: ID;
+    status: InvoicingDunningStatus;
+    amount?: Amount;
+    attempts?: number;
+    createdAt?: ZeniDate;
+    currencyCode?: string;
+    customer?: string;
+    customerEmail?: string;
+    customerID?: ID;
+    daysPastDue?: number;
+    failureReason?: string;
+    initials?: string;
+    invoiceID?: ID;
+    lastAttempt?: ZeniDate;
+    maxAttempts?: number;
+    nextRetry?: ZeniDate;
+    pausedReason?: string;
+    pausedUntil?: ZeniDate;
+    subscriptionID?: ID;
+}
+export interface InvoicingDunningKPIs {
+    activeCases: number;
+    atRiskAmount: Amount;
+    recoveryRate: number;
+    totalCases: number;
+    avgDaysToResolve?: number | null;
+}
+export interface InvoicingDunningCaseState {
+    dunningCaseByID: Record<ID, InvoicingDunningCase>;
+}

package/lib/entity/invoicing/dunningCase/dunningCaseState.js

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

package/lib/entity/invoicing/invoice/invoicePayload.d.ts

@@ -0,0 +1,96 @@
+import { InvoicingBillingAddressPayload, InvoicingPriceType } from '../invoicingCommonPayload';
+import { InvoicingInvoice, InvoicingInvoiceKPIs } from './invoiceState';
+export type InvoicingInvoiceStatus = 'paid' | 'partially_paid' | 'posted' | 'payment_due' | 'not_paid' | 'voided' | 'pending' | 'draft';
+export interface InvoicingLineItemPayload {
+    amount: number;
+    description: string;
+    quantity: number;
+    unit_amount: number;
+    date_from?: string;
+    date_to?: string;
+    discount_amount?: number;
+    entity_description?: string;
+    entity_type?: string;
+    id?: string;
+    is_taxed?: boolean;
+    item_level_discount_amount?: number;
+    subscription_id?: string;
+    tax_amount?: number;
+    tax_exempt_reason?: string;
+    tax_rate?: number;
+    usage_percentage?: number;
+}
+export interface InvoicingLinkedPaymentPayload {
+    applied_amount: number;
+    txn_id: string;
+    applied_at?: string;
+    txn_amount?: number;
+    txn_date?: string;
+    txn_status?: string;
+}
+export interface InvoicingIssuedCreditNotePayload {
+    cn_id: string;
+    cn_status: string;
+    cn_total: number;
+}
+export interface InvoicingDunningAttemptPayload {
+    attempt: number;
+    created_at?: string;
+    dunning_type?: string;
+    transaction_id?: string;
+}
+export interface InvoicingInvoiceNotePayload {
+    note: string;
+    entity_id?: string;
+    entity_type?: string;
+}
+export interface InvoicingInvoicePayload {
+    customer_id: string;
+    date: string;
+    id: string;
+    status: InvoicingInvoiceStatus;
+    total: number;
+    adjustment_credit_notes?: string[];
+    amount_adjusted?: number;
+    amount_due?: number;
+    amount_paid?: number;
+    amount_to_collect?: number;
+    billing_address?: InvoicingBillingAddressPayload;
+    created_at?: string;
+    credits_applied?: number;
+    currency_code?: string;
+    customer_email?: string;
+    customer_name?: string;
+    due_date?: string;
+    dunning_attempts?: InvoicingDunningAttemptPayload[];
+    dunning_status?: string;
+    first_invoice?: boolean;
+    generated_at?: string;
+    has_advance_charges?: boolean;
+    issued_credit_notes?: InvoicingIssuedCreditNotePayload[];
+    line_items?: InvoicingLineItemPayload[];
+    linked_payments?: InvoicingLinkedPaymentPayload[];
+    net_term_days?: number;
+    next_retry_at?: string;
+    notes?: InvoicingInvoiceNotePayload[];
+    paid_at?: string;
+    po_number?: string;
+    price_type?: InvoicingPriceType;
+    recurring?: boolean;
+    round_off_amount?: number;
+    shipping_address?: InvoicingBillingAddressPayload;
+    sub_total?: number;
+    subscription_id?: string;
+    subscription_name?: string;
+    tax?: number;
+    updated_at?: string;
+    write_off_amount?: number;
+}
+export interface InvoicingInvoiceKPIsPayload {
+    due_total: number;
+    paid_total: number;
+    pending_total: number;
+    total_invoiced: number;
+}
+export declare const mapInvoicingInvoicePayloadToState: (payload: InvoicingInvoicePayload) => InvoicingInvoice;
+export declare const mapInvoicingInvoiceKPIsPayloadToState: (payload: InvoicingInvoiceKPIsPayload) => InvoicingInvoiceKPIs;

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

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapInvoicingInvoiceKPIsPayloadToState = exports.mapInvoicingInvoicePayloadToState = 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 mapLineItem = (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),
+    dateFrom: payload.date_from != null ? (0, zeniDayJS_1.date)(payload.date_from) : undefined,
+    dateTo: payload.date_to != null ? (0, zeniDayJS_1.date)(payload.date_to) : undefined,
+    discountAmount: payload.discount_amount != null
+        ? (0, amount_1.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
+        ? (0, amount_1.toAmount)(payload.item_level_discount_amount, currencyCode, currencySymbol)
+        : undefined,
+    subscriptionID: payload.subscription_id,
+    taxAmount: payload.tax_amount != null
+        ? (0, amount_1.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: (0, amount_1.toAmount)(payload.applied_amount, currencyCode, currencySymbol),
+    txnID: payload.txn_id,
+    appliedAt: payload.applied_at != null ? (0, zeniDayJS_1.date)(payload.applied_at) : undefined,
+    txnAmount: payload.txn_amount != null
+        ? (0, amount_1.toAmount)(payload.txn_amount, currencyCode, currencySymbol)
+        : undefined,
+    txnDate: payload.txn_date != null ? (0, zeniDayJS_1.date)(payload.txn_date) : undefined,
+    txnStatus: payload.txn_status,
+});
+const mapIssuedCreditNote = (payload, currencyCode, currencySymbol) => ({
+    cnID: payload.cn_id,
+    cnStatus: payload.cn_status,
+    cnTotal: (0, amount_1.toAmount)(payload.cn_total, currencyCode, currencySymbol),
+});
+const mapDunningAttempt = (payload) => ({
+    attempt: payload.attempt,
+    createdAt: payload.created_at != null ? (0, zeniDayJS_1.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 mapInvoicingInvoicePayloadToState = (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 {
+        customerID: payload.customer_id,
+        date: (0, zeniDayJS_1.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 ? (0, zeniDayJS_1.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 ? (0, zeniDayJS_1.date)(payload.due_date) : undefined,
+        dunningAttempts: payload.dunning_attempts?.map(mapDunningAttempt),
+        dunningStatus: payload.dunning_status,
+        firstInvoice: payload.first_invoice,
+        generatedAt: payload.generated_at != null ? (0, zeniDayJS_1.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 ? (0, zeniDayJS_1.date)(payload.next_retry_at) : undefined,
+        notes: payload.notes?.map(mapInvoiceNote),
+        paidAt: payload.paid_at != null ? (0, zeniDayJS_1.date)(payload.paid_at) : undefined,
+        poNumber: payload.po_number,
+        priceType: payload.price_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 ? (0, zeniDayJS_1.date)(payload.updated_at) : undefined,
+        writeOffAmount: payload.write_off_amount != null
+            ? toAmt(payload.write_off_amount)
+            : undefined,
+    };
+};
+exports.mapInvoicingInvoicePayloadToState = mapInvoicingInvoicePayloadToState;
+const mapInvoicingInvoiceKPIsPayloadToState = (payload) => ({
+    dueTotal: (0, amount_1.toAmount)(payload.due_total, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    paidTotal: (0, amount_1.toAmount)(payload.paid_total, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    pendingTotal: (0, amount_1.toAmount)(payload.pending_total, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+    totalInvoiced: (0, amount_1.toAmount)(payload.total_invoiced, DEFAULT_CURRENCY_CODE, DEFAULT_CURRENCY_SYMBOL),
+});
+exports.mapInvoicingInvoiceKPIsPayloadToState = mapInvoicingInvoiceKPIsPayloadToState;

package/lib/entity/invoicing/invoice/invoiceReducer.d.ts

@@ -0,0 +1,9 @@
+import { UpdateType } from '../../../commonStateTypes/common';
+import { InvoicingInvoicePayload } from './invoicePayload';
+import { InvoiceState } from './invoiceState';
+export declare const initialState: InvoiceState;
+export declare const updateInvoices: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: InvoicingInvoicePayload[], updateType?: UpdateType | undefined], InvoicingInvoicePayload[], "invoicingInvoice/updateInvoices", never, {
+    updateType: UpdateType;
+}>, removeInvoice: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "invoicingInvoice/removeInvoice">, clearAllInvoices: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingInvoice/clearAllInvoices">;
+declare const _default: import("redux").Reducer<InvoiceState>;
+export default _default;