@zeniai/client-epic-state 5.1.59 → 5.1.60-betaAK0

package/lib/esm/view/invoicing/issueCreditNote/issueCreditNotePayload.js

@@ -0,0 +1,51 @@
+const dollarsFromAmountString = (value) => {
+    const parsed = Number.parseFloat(value);
+    if (Number.isNaN(parsed)) {
+        return 0;
+    }
+    return parsed;
+};
+export const computeIssueCreditNoteTotal = (lineItems) => lineItems
+    .filter((lineItem) => lineItem.selected)
+    .reduce((total, lineItem) => {
+    const quantity = Number.parseFloat(lineItem.quantity);
+    const unitAmount = dollarsFromAmountString(lineItem.unitAmount);
+    if (Number.isNaN(quantity) || quantity <= 0 || unitAmount <= 0) {
+        return total;
+    }
+    return total + Math.round(quantity) * unitAmount;
+}, 0);
+export const localDataToIssueCreditNotePayload = (localData) => {
+    const lineItems = localData.lineItems
+        .filter((lineItem) => lineItem.selected)
+        .map((lineItem) => {
+        const quantity = Math.round(Number.parseFloat(lineItem.quantity));
+        const unitAmount = dollarsFromAmountString(lineItem.unitAmount);
+        return {
+            description: lineItem.description,
+            quantity,
+            unit_amount: unitAmount,
+            amount: quantity * unitAmount,
+            ...(lineItem.id != null && lineItem.id !== '' ? { id: lineItem.id } : {}),
+        };
+    });
+    const reasonCode = localData.reasonCode.trim();
+    return {
+        line_items: lineItems,
+        type: 'adjustment',
+        ...(reasonCode !== '' ? { reason_code: reasonCode } : {}),
+    };
+};
+export const initializeIssueCreditNoteDraftFromInvoice = (invoice) => ({
+    invoiceId: invoice.id,
+    reasonCode: '',
+    lineItems: (invoice.lineItems ?? []).map((lineItem) => ({
+        description: lineItem.description,
+        id: lineItem.id,
+        maxQuantity: lineItem.quantity,
+        maxUnitAmount: lineItem.unitAmount.amount,
+        quantity: String(lineItem.quantity),
+        selected: true,
+        unitAmount: lineItem.unitAmount.amount.toFixed(2),
+    })),
+});

package/lib/esm/view/invoicing/issueCreditNote/issueCreditNoteReducer.js

@@ -0,0 +1,48 @@
+import { createSlice } from '@reduxjs/toolkit';
+import { initialIssueCreditNoteFormLocalData } from './issueCreditNoteFormConfig';
+export const initialState = {
+    draft: initialIssueCreditNoteFormLocalData(),
+    error: undefined,
+    fetchState: 'Not-Started',
+    issuedCreditNoteId: undefined,
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const issueCreditNoteSlice = createSlice({
+    name: 'invoicingIssueCreditNote',
+    initialState,
+    reducers: {
+        initializeIssueCreditNoteDraft(draft, action) {
+            draft.draft = action.payload.localData;
+            draft.fetchState = 'Not-Started';
+            draft.error = undefined;
+            draft.issuedCreditNoteId = undefined;
+        },
+        updateIssueCreditNoteFormDraft(draft, action) {
+            draft.draft = action.payload.localData;
+        },
+        submitIssueCreditNote(draft) {
+            draft.fetchState = 'In-Progress';
+            draft.error = undefined;
+            draft.issuedCreditNoteId = undefined;
+        },
+        issueCreditNoteSuccess(draft, action) {
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+            draft.issuedCreditNoteId = action.payload.creditNoteId;
+        },
+        issueCreditNoteFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        resetIssueCreditNote(draft) {
+            draft.draft = initialIssueCreditNoteFormLocalData();
+            draft.error = undefined;
+            draft.fetchState = 'Not-Started';
+            draft.issuedCreditNoteId = undefined;
+        },
+    },
+});
+export const { initializeIssueCreditNoteDraft, issueCreditNoteFailure, issueCreditNoteSuccess, resetIssueCreditNote, submitIssueCreditNote, updateIssueCreditNoteFormDraft, } = issueCreditNoteSlice.actions;
+export default issueCreditNoteSlice.reducer;

package/lib/esm/view/invoicing/issueCreditNote/issueCreditNoteSelector.js

@@ -0,0 +1,20 @@
+import { INVOICING_CREDIT_NOTE_REASON_CODES } from './issueCreditNoteFormConfig';
+export const getIssueCreditNoteView = (state) => {
+    const { error, fetchState, issuedCreditNoteId } = state.invoicingIssueCreditNoteState;
+    return {
+        error,
+        fetchState,
+        issuedCreditNoteId,
+        version: 1.0,
+    };
+};
+export const getIssueCreditNoteFormView = (state) => {
+    const { draft, error, fetchState } = state.invoicingIssueCreditNoteState;
+    return {
+        localData: draft,
+        reasonCodeValues: [...INVOICING_CREDIT_NOTE_REASON_CODES],
+        error,
+        fetchState,
+        version: 1.0,
+    };
+};

package/lib/esm/view/invoicing/issueCreditNote/issueCreditNoteState.js

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

package/lib/esm/view/invoicing/paymentAction/paymentActionEpic.js

@@ -0,0 +1,27 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { updateInvoicingTransactions } from '../../../entity/invoicing/invoicingTransaction/invoicingTransactionReducer';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { runInvoicingPaymentAction, runInvoicingPaymentActionFailure, runInvoicingPaymentActionSuccess, } from './paymentActionReducer';
+export const runInvoicingPaymentActionEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(runInvoicingPaymentAction.match), mergeMap((action) => {
+    const { action: kind, body, id } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/payments/${encodeURIComponent(id)}/${kind}`;
+    return zeniAPI
+        .postAndGetJSON(apiUrl, (body ?? {}))
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return [
+                updateInvoicingTransactions([response.data], 'merge'),
+                runInvoicingPaymentActionSuccess({ id }),
+            ];
+        }
+        return of(runInvoicingPaymentActionFailure({
+            error: response.status,
+            id,
+        }));
+    }), catchError((error) => of(runInvoicingPaymentActionFailure({
+        error: createZeniAPIStatus('Unexpected Error', 'Payment action REST API call errored out ' +
+            JSON.stringify(error)),
+        id,
+    }))));
+}));

package/lib/esm/view/invoicing/paymentAction/paymentActionPayload.js

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

package/lib/esm/view/invoicing/paymentAction/paymentActionReducer.js

@@ -0,0 +1,36 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    byId: {},
+};
+const paymentAction = createSlice({
+    name: 'invoicingPaymentAction',
+    initialState,
+    reducers: {
+        runInvoicingPaymentAction(draft, action) {
+            draft.byId[action.payload.id] = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        runInvoicingPaymentActionSuccess(draft, action) {
+            draft.byId[action.payload.id] = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        runInvoicingPaymentActionFailure(draft, action) {
+            draft.byId[action.payload.id] = {
+                fetchState: 'Error',
+                error: action.payload.error,
+            };
+        },
+        clearInvoicingPaymentAction(draft, action) {
+            delete draft.byId[action.payload];
+        },
+        clearAllInvoicingPaymentActions(draft) {
+            draft.byId = {};
+        },
+    },
+});
+export const { runInvoicingPaymentAction, runInvoicingPaymentActionSuccess, runInvoicingPaymentActionFailure, clearInvoicingPaymentAction, clearAllInvoicingPaymentActions, } = paymentAction.actions;
+export default paymentAction.reducer;

package/lib/esm/view/invoicing/paymentAction/paymentActionRequestPayload.js

@@ -0,0 +1,2 @@
+/** Snake_case request bodies for payment action endpoints. */
+export {};

package/lib/esm/view/invoicing/paymentAction/paymentActionSelector.js

@@ -0,0 +1,5 @@
+const NOT_STARTED = {
+    fetchState: 'Not-Started',
+    error: undefined,
+};
+export const getInvoicingPaymentActionState = (id) => (state) => state.invoicingPaymentActionState.byId[id] ?? NOT_STARTED;

package/lib/esm/view/invoicing/paymentAction/paymentActionState.js

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

package/lib/esm/view/invoicing/promotionalCreditAction/promotionalCreditActionEpic.js

@@ -0,0 +1,25 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { fetchInvoicingCustomerDetail } from '../invoicingCustomerDetailView/invoicingCustomerDetailViewReducer';
+import { addPromotionalCreditsFailure, addPromotionalCreditsSuccess, submitAddPromotionalCredits, } from './promotionalCreditActionReducer';
+export const addPromotionalCreditsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(submitAddPromotionalCredits.match), mergeMap((action) => {
+    const { amount, currencyCode, customerId, description } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/customers/${encodeURIComponent(customerId)}/promotional-credits`;
+    const body = { amount, description };
+    if (currencyCode != null && currencyCode !== '') {
+        body.currency_code = currencyCode;
+    }
+    return zeniAPI
+        .postAndGetJSON(apiUrl, body)
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return [
+                addPromotionalCreditsSuccess(),
+                fetchInvoicingCustomerDetail({ id: customerId }),
+            ];
+        }
+        return of(addPromotionalCreditsFailure(response.status));
+    }), catchError((error) => of(addPromotionalCreditsFailure(createZeniAPIStatus('Unexpected Error', 'Add promotional credits REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/promotionalCreditAction/promotionalCreditActionPayload.js

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

package/lib/esm/view/invoicing/promotionalCreditAction/promotionalCreditActionReducer.js

@@ -0,0 +1,31 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    customerId: undefined,
+    submitFetchState: { fetchState: 'Not-Started', error: undefined },
+    hasValidState() {
+        return true;
+    },
+};
+const promotionalCreditAction = createSlice({
+    name: 'invoicingPromotionalCreditAction',
+    initialState,
+    reducers: {
+        submitAddPromotionalCredits(draft, action) {
+            draft.customerId = action.payload.customerId;
+            draft.submitFetchState = { fetchState: 'In-Progress', error: undefined };
+        },
+        addPromotionalCreditsSuccess(draft) {
+            draft.submitFetchState = { fetchState: 'Completed', error: undefined };
+        },
+        addPromotionalCreditsFailure(draft, action) {
+            draft.submitFetchState = { fetchState: 'Error', error: action.payload };
+        },
+        resetPromotionalCreditAction(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { submitAddPromotionalCredits, addPromotionalCreditsSuccess, addPromotionalCreditsFailure, resetPromotionalCreditAction, } = promotionalCreditAction.actions;
+export default promotionalCreditAction.reducer;

package/lib/esm/view/invoicing/promotionalCreditAction/promotionalCreditActionState.js

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

package/lib/esm/view/invoicing/recordPayment/recordPaymentEpic.js

@@ -0,0 +1,57 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { updateInvoices } from '../../../entity/invoicing/invoice/invoiceReducer';
+import { updateInvoicingTransactions } from '../../../entity/invoicing/invoicingTransaction/invoicingTransactionReducer';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { fetchInvoiceDetail } from '../invoiceDetail/invoiceDetailReducer';
+import { addInvoicingTransactionToList } from '../invoicingTransactionListView/invoicingTransactionListViewReducer';
+import { localDataToInvoiceRecordPaymentBody, localDataToRecordPaymentPayload, } from './recordPaymentPayload';
+import { recordPaymentFailure, recordPaymentSuccess, submitRecordPayment, } from './recordPaymentReducer';
+const trimOrUndefined = (value) => value.trim() !== '' ? value.trim() : undefined;
+const linkedInvoiceIdFromDraft = (state) => {
+    const linkedInvoice = trimOrUndefined(state.invoicingRecordPaymentState.newPaymentDraft.invoiceToLink);
+    return linkedInvoice;
+};
+export const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(submitRecordPayment.match), mergeMap((action) => {
+    const draft = state$.value.invoicingRecordPaymentState.newPaymentDraft;
+    const invoiceId = action.payload.invoiceId;
+    if (invoiceId != null && invoiceId !== '') {
+        const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${encodeURIComponent(invoiceId)}/record-payment`;
+        const body = localDataToInvoiceRecordPaymentBody(draft);
+        return zeniAPI
+            .postAndGetJSON(apiUrl, body)
+            .pipe(mergeMap((response) => {
+            if (isSuccessResponse(response) && response.data != null) {
+                return [
+                    updateInvoices([response.data], 'merge'),
+                    fetchInvoiceDetail({ invoiceId }),
+                    recordPaymentSuccess({ invoiceId }),
+                ];
+            }
+            return of(recordPaymentFailure(response.status));
+        }), catchError((error) => of(recordPaymentFailure(createZeniAPIStatus('Unexpected Error', 'Record payment REST API call errored out ' +
+            JSON.stringify(error))))));
+    }
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/payments`;
+    const data = localDataToRecordPaymentPayload(draft);
+    const linkedInvoiceId = linkedInvoiceIdFromDraft(state$.value);
+    return zeniAPI
+        .postAndGetJSON(apiUrl, {
+        ...data,
+    })
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            const successActions = [
+                updateInvoicingTransactions([response.data], 'merge'),
+                addInvoicingTransactionToList(response.data.id),
+                recordPaymentSuccess({ transactionId: response.data.id }),
+            ];
+            if (linkedInvoiceId != null) {
+                successActions.push(fetchInvoiceDetail({ invoiceId: linkedInvoiceId }));
+            }
+            return successActions;
+        }
+        return of(recordPaymentFailure(response.status));
+    }), catchError((error) => of(recordPaymentFailure(createZeniAPIStatus('Unexpected Error', 'Record payment REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/recordPayment/recordPaymentFormConfig.js

@@ -0,0 +1,37 @@
+/**
+ * Canonical value sets for the Record Payment form. CES owns the values;
+ * web-components maps each value to a localized label.
+ */
+export const INVOICING_PAYMENT_METHOD_VALUES = [
+    'card',
+    'cash',
+    'check',
+    'bank_transfer',
+    'direct_debit',
+    'paypal_express_checkout',
+    'apple_pay',
+    'google_pay',
+    'ach_credit',
+    'sepa_credit',
+    'other',
+];
+export const INVOICING_PAYMENT_GATEWAY_VALUES = [
+    'stripe',
+    'chargebee',
+    'braintree',
+    'paypal',
+    'adyen',
+    'razorpay',
+    'other',
+];
+export const initialRecordPaymentFormLocalData = {
+    amount: '',
+    comment: '',
+    customerId: '',
+    date: '',
+    gateway: '',
+    invoiceToLink: '',
+    paymentMethod: '',
+    referenceNumber: '',
+    transactionId: '',
+};

package/lib/esm/view/invoicing/recordPayment/recordPaymentPayload.js

@@ -0,0 +1,67 @@
+import { dateNow } from '../../../zeniDayJS';
+import { initialRecordPaymentFormLocalData } from './recordPaymentFormConfig';
+const trimOrUndefined = (value) => value.trim() !== '' ? value.trim() : undefined;
+const dollarsFromAmountString = (value) => {
+    const parsed = Number.parseFloat(value);
+    if (Number.isNaN(parsed)) {
+        return 0;
+    }
+    return parsed;
+};
+const amountDueDollarsFromInvoice = (invoice) => {
+    const amountDue = invoice.amountDue?.amount ?? 0;
+    return amountDue.toFixed(2);
+};
+/**
+ * Build the invoice-scoped Record Payment body from the form draft. Amount stays
+ * in dollars for the invoice endpoint.
+ */
+export const localDataToInvoiceRecordPaymentBody = (localData) => {
+    const gateway = trimOrUndefined(localData.gateway);
+    const date = localData.date.trim();
+    const referenceNumber = trimOrUndefined(localData.referenceNumber);
+    return {
+        amount: dollarsFromAmountString(localData.amount),
+        payment_method: localData.paymentMethod,
+        ...(gateway != null ? { gateway } : {}),
+        ...(date !== '' ? { date } : {}),
+        ...(referenceNumber != null ? { reference_number: referenceNumber } : {}),
+    };
+};
+/**
+ * Build the Record Payment request body from the form draft. Amount stays in
+ * dollars; the comment maps to `notes`, transaction id to `id_at_gateway`,
+ * and the linked invoice into `linked_invoices`. Currency is locked to USD.
+ */
+export const localDataToRecordPaymentPayload = (localData) => {
+    const amount = dollarsFromAmountString(localData.amount);
+    const gateway = trimOrUndefined(localData.gateway);
+    const date = localData.date.trim();
+    const transactionId = trimOrUndefined(localData.transactionId);
+    const referenceNumber = trimOrUndefined(localData.referenceNumber);
+    const linkedInvoice = trimOrUndefined(localData.invoiceToLink);
+    const notes = trimOrUndefined(localData.comment);
+    return {
+        amount,
+        currency_code: 'USD',
+        customer_id: localData.customerId,
+        payment_method: localData.paymentMethod,
+        status: 'success',
+        type: 'payment',
+        ...(gateway != null ? { gateway } : {}),
+        ...(date !== '' ? { date } : {}),
+        ...(transactionId != null ? { id_at_gateway: transactionId } : {}),
+        ...(referenceNumber != null ? { reference_number: referenceNumber } : {}),
+        ...(linkedInvoice != null
+            ? { linked_invoices: [{ applied_amount: amount, invoice_id: linkedInvoice }] }
+            : {}),
+        ...(notes != null ? { notes } : {}),
+    };
+};
+export const initializeRecordPaymentDraftFromInvoice = (invoice) => ({
+    ...initialRecordPaymentFormLocalData,
+    amount: amountDueDollarsFromInvoice(invoice),
+    customerId: invoice.customerID,
+    date: dateNow().format('YYYY-MM-DD'),
+    invoiceToLink: invoice.id,
+});

package/lib/esm/view/invoicing/recordPayment/recordPaymentReducer.js

@@ -0,0 +1,61 @@
+import { createSlice } from '@reduxjs/toolkit';
+import { initialRecordPaymentFormLocalData } from './recordPaymentFormConfig';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    contextInvoiceId: undefined,
+    newPaymentDraft: { ...initialRecordPaymentFormLocalData },
+    recordedInvoiceId: undefined,
+    recordedTransactionId: undefined,
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const recordPaymentSlice = createSlice({
+    name: 'invoicingRecordPayment',
+    initialState,
+    reducers: {
+        initializeRecordPaymentDraft(draft, action) {
+            draft.contextInvoiceId = action.payload.contextInvoiceId;
+            draft.newPaymentDraft = action.payload.localData;
+            draft.fetchState = 'Not-Started';
+            draft.error = undefined;
+            draft.recordedInvoiceId = undefined;
+            draft.recordedTransactionId = undefined;
+        },
+        updateRecordPaymentFormDraft(draft, action) {
+            draft.newPaymentDraft = action.payload.localData;
+        },
+        submitRecordPayment: {
+            prepare(invoiceId) {
+                return { payload: { invoiceId } };
+            },
+            reducer(draft) {
+                draft.fetchState = 'In-Progress';
+                draft.error = undefined;
+                draft.recordedInvoiceId = undefined;
+                draft.recordedTransactionId = undefined;
+            },
+        },
+        recordPaymentSuccess(draft, action) {
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+            draft.recordedInvoiceId = action.payload.invoiceId;
+            draft.recordedTransactionId = action.payload.transactionId;
+        },
+        recordPaymentFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        resetRecordPayment(draft) {
+            draft.fetchState = 'Not-Started';
+            draft.error = undefined;
+            draft.contextInvoiceId = undefined;
+            draft.recordedInvoiceId = undefined;
+            draft.recordedTransactionId = undefined;
+            draft.newPaymentDraft = { ...initialRecordPaymentFormLocalData };
+        },
+    },
+});
+export const { initializeRecordPaymentDraft, updateRecordPaymentFormDraft, submitRecordPayment, recordPaymentSuccess, recordPaymentFailure, resetRecordPayment, } = recordPaymentSlice.actions;
+export default recordPaymentSlice.reducer;

package/lib/esm/view/invoicing/recordPayment/recordPaymentSelector.js

@@ -0,0 +1,50 @@
+import { getInvoiceListView } from '../invoiceList/invoiceListSelector';
+import { INVOICING_PAYMENT_GATEWAY_VALUES, INVOICING_PAYMENT_METHOD_VALUES, } from './recordPaymentFormConfig';
+/**
+ * Single bundled view for the record-payment submit lifecycle — carries the
+ * submit fetch state/error and the ids produced on success.
+ */
+export const getRecordPaymentView = (state) => {
+    const { error, fetchState, recordedInvoiceId, recordedTransactionId } = state.invoicingRecordPaymentState;
+    return {
+        recordedInvoiceId,
+        recordedTransactionId,
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};
+export const getRecordPaymentFormView = (state) => {
+    const { contextInvoiceId, error, fetchState, newPaymentDraft } = state.invoicingRecordPaymentState;
+    return {
+        contextInvoiceId,
+        gatewayValues: [...INVOICING_PAYMENT_GATEWAY_VALUES],
+        localData: newPaymentDraft,
+        paymentMethodValues: [...INVOICING_PAYMENT_METHOD_VALUES],
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};
+const UNPAID_INVOICE_STATUSES = new Set([
+    'not_paid',
+    'partially_paid',
+    'payment_due',
+]);
+export const getRecordPaymentInvoiceOptions = (state, customerId) => {
+    if (customerId === '') {
+        return [];
+    }
+    const listView = getInvoiceListView(state);
+    if (listView.filters.customerId !== customerId) {
+        return [];
+    }
+    return listView.invoices
+        .filter((invoice) => UNPAID_INVOICE_STATUSES.has(invoice.status))
+        .filter((invoice) => (invoice.amountDue?.amount ?? 0) > 0)
+        .map((invoice) => ({
+        amountDue: invoice.amountDue?.amount ?? 0,
+        id: invoice.id,
+        invoiceNumber: invoice.invoiceNumber ?? invoice.id,
+    }));
+};

package/lib/esm/view/invoicing/recordPayment/recordPaymentState.js

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

package/lib/esm/view/invoicing/settingsView/invoicingBrandingFormConfig.js

@@ -0,0 +1,47 @@
+import { toAddressUpdatableInfoPayload } from '../../addressView/addressViewPayload';
+/** `AddressType` key used when the branding form opens the shared Address screen. */
+export const INVOICING_BUSINESS_ADDRESS_TYPE = 'invoicing_business_address';
+export const initialInvoicingBrandingFormLocalData = {
+    accentColor: '#162324',
+    companyName: '',
+    dateFormat: '',
+    defaultMemo: '',
+    email: '',
+    invoicePrefix: '',
+    logoFileId: '',
+    phone: '',
+    taxId: '',
+};
+/** Seed the form draft from the existing invoicing settings. */
+export const entityToInvoicingBrandingFormLocalData = (settings) => ({
+    accentColor: settings?.accent_color ?? '#162324',
+    companyName: settings?.company_name ?? '',
+    dateFormat: settings?.date_format ?? '',
+    defaultMemo: settings?.default_memo ?? '',
+    email: settings?.email ?? '',
+    invoicePrefix: settings?.invoice_prefix ?? '',
+    logoFileId: settings?.logo_file_id ?? '',
+    phone: settings?.phone ?? '',
+    taxId: settings?.tax_id ?? '',
+});
+const trimOrUndefined = (value) => value.trim() !== '' ? value.trim() : undefined;
+/**
+ * Build the settings PUT body from the branding draft. The business address is
+ * captured via the shared Address screen and sent as a structured object (same
+ * shape as the customer save flow, `toAddressUpdatableInfoPayload`); the backend
+ * persists it. Returns a loose record so the address object isn't constrained by
+ * the string-typed `InvoicingSettingsPayload.address` read model.
+ */
+export const brandingLocalDataToSettingsPayload = (localData, address) => ({
+    accent_color: trimOrUndefined(localData.accentColor),
+    address_enabled: address != null,
+    company_name: trimOrUndefined(localData.companyName),
+    date_format: trimOrUndefined(localData.dateFormat),
+    default_memo: trimOrUndefined(localData.defaultMemo),
+    email: trimOrUndefined(localData.email),
+    invoice_prefix: trimOrUndefined(localData.invoicePrefix),
+    logo_file_id: localData.logoFileId,
+    phone: trimOrUndefined(localData.phone),
+    tax_id: trimOrUndefined(localData.taxId),
+    ...(address != null ? { address: toAddressUpdatableInfoPayload(address) } : {}),
+});

package/lib/esm/view/invoicing/settingsView/invoicingBrandingFormEpics.js

@@ -0,0 +1,58 @@
+import { EMPTY, of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { updateAddresses } from '../../../entity/address/addressReducer';
+import { getAddressByAddressId } from '../../../entity/address/addressSelector';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { newAddressInLocalStore, resetNewAddressDataInLocalStore, } from '../../addressView/addressViewReducer';
+import { INVOICING_BUSINESS_ADDRESS_TYPE, brandingLocalDataToSettingsPayload, entityToInvoicingBrandingFormLocalData, } from './invoicingBrandingFormConfig';
+import { saveInvoicingSettingsFailure, saveInvoicingSettingsSuccess, submitInvoicingBrandingForm, updateInvoicingSettings, } from './settingsViewReducer';
+/**
+ * On `submitInvoicingBrandingForm`, PUT the settings body built from the branding
+ * draft + the business address captured via the shared Address screen. The
+ * address is sent as a structured object (same shape as the customer save flow);
+ * state is updated from the response — mirroring `saveInvoicingCustomerEpic`.
+ */
+export const submitInvoicingBrandingFormEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(submitInvoicingBrandingForm.match), mergeMap(() => {
+    const state = state$.value;
+    const { brandingDraft, settings } = state.invoicingSettingsViewState;
+    const localData = brandingDraft ?? entityToInvoicingBrandingFormLocalData(settings);
+    const address = state.addressViewState.newAddressState?.[INVOICING_BUSINESS_ADDRESS_TYPE]?.addressToCreate;
+    const data = brandingLocalDataToSettingsPayload(localData, address);
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
+    return zeniAPI
+        .putAndGetJSON(apiUrl, { ...data })
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            const savedAddress = response.data.address;
+            return [
+                ...(savedAddress != null
+                    ? [updateAddresses([savedAddress])]
+                    : []),
+                saveInvoicingSettingsSuccess(response.data),
+                resetNewAddressDataInLocalStore(INVOICING_BUSINESS_ADDRESS_TYPE),
+            ];
+        }
+        return of(saveInvoicingSettingsFailure(response.status));
+    }), catchError((error) => of(saveInvoicingSettingsFailure(createZeniAPIStatus('Unexpected Error', 'Save branding settings REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+/**
+ * Seed the shared Address screen with the existing business address when settings
+ * load — looked up in the shared address store by `address_id`, same as the
+ * customer billing-address flow. Skips when an in-progress draft already exists.
+ */
+export const initializeInvoicingBrandingAddressEpic = (actions$, state$) => actions$.pipe(filter(updateInvoicingSettings.match), mergeMap((action) => {
+    const rootState = state$.value;
+    const existing = rootState.addressViewState.newAddressState?.[INVOICING_BUSINESS_ADDRESS_TYPE]?.addressToCreate;
+    const addressId = action.payload.address?.address_id;
+    if (existing != null || addressId == null) {
+        return EMPTY;
+    }
+    const address = getAddressByAddressId(rootState.addressState, addressId);
+    return address != null
+        ? of(newAddressInLocalStore({
+            addressType: INVOICING_BUSINESS_ADDRESS_TYPE,
+            addressToCreate: address,
+        }))
+        : EMPTY;
+}));