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

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

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeRecordPaymentDraftFromInvoice = exports.localDataToRecordPaymentPayload = exports.localDataToInvoiceRecordPaymentBody = void 0;
+const zeniDayJS_1 = require("../../../zeniDayJS");
+const recordPaymentFormConfig_1 = require("./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.
+ */
+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 } : {}),
+    };
+};
+exports.localDataToInvoiceRecordPaymentBody = localDataToInvoiceRecordPaymentBody;
+/**
+ * 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.
+ */
+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 } : {}),
+    };
+};
+exports.localDataToRecordPaymentPayload = localDataToRecordPaymentPayload;
+const initializeRecordPaymentDraftFromInvoice = (invoice) => ({
+    ...recordPaymentFormConfig_1.initialRecordPaymentFormLocalData,
+    amount: amountDueDollarsFromInvoice(invoice),
+    customerId: invoice.customerID,
+    date: (0, zeniDayJS_1.dateNow)().format('YYYY-MM-DD'),
+    invoiceToLink: invoice.id,
+});
+exports.initializeRecordPaymentDraftFromInvoice = initializeRecordPaymentDraftFromInvoice;

package/lib/view/invoicing/recordPayment/recordPaymentReducer.d.ts

@@ -0,0 +1,17 @@
+import { ID } from '../../../commonStateTypes/common';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { RecordPaymentFormLocalData, RecordPaymentState } from './recordPaymentState';
+export declare const initialState: RecordPaymentState;
+export declare const initializeRecordPaymentDraft: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    localData: RecordPaymentFormLocalData;
+    contextInvoiceId?: ID;
+}, "invoicingRecordPayment/initializeRecordPaymentDraft">, updateRecordPaymentFormDraft: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    localData: RecordPaymentFormLocalData;
+}, "invoicingRecordPayment/updateRecordPaymentFormDraft">, submitRecordPayment: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[invoiceId?: string | undefined], {
+    invoiceId: string | undefined;
+}, "invoicingRecordPayment/submitRecordPayment", never, never>, recordPaymentSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    invoiceId?: ID;
+    transactionId?: ID;
+}, "invoicingRecordPayment/recordPaymentSuccess">, recordPaymentFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingRecordPayment/recordPaymentFailure">, resetRecordPayment: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingRecordPayment/resetRecordPayment">;
+declare const _default: import("redux").Reducer<RecordPaymentState>;
+export default _default;

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

@@ -0,0 +1,65 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetRecordPayment = exports.recordPaymentFailure = exports.recordPaymentSuccess = exports.submitRecordPayment = exports.updateRecordPaymentFormDraft = exports.initializeRecordPaymentDraft = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const recordPaymentFormConfig_1 = require("./recordPaymentFormConfig");
+exports.initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    contextInvoiceId: undefined,
+    newPaymentDraft: { ...recordPaymentFormConfig_1.initialRecordPaymentFormLocalData },
+    recordedInvoiceId: undefined,
+    recordedTransactionId: undefined,
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const recordPaymentSlice = (0, toolkit_1.createSlice)({
+    name: 'invoicingRecordPayment',
+    initialState: exports.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 = { ...recordPaymentFormConfig_1.initialRecordPaymentFormLocalData };
+        },
+    },
+});
+_a = recordPaymentSlice.actions, exports.initializeRecordPaymentDraft = _a.initializeRecordPaymentDraft, exports.updateRecordPaymentFormDraft = _a.updateRecordPaymentFormDraft, exports.submitRecordPayment = _a.submitRecordPayment, exports.recordPaymentSuccess = _a.recordPaymentSuccess, exports.recordPaymentFailure = _a.recordPaymentFailure, exports.resetRecordPayment = _a.resetRecordPayment;
+exports.default = recordPaymentSlice.reducer;

package/lib/view/invoicing/recordPayment/recordPaymentSelector.d.ts

@@ -0,0 +1,30 @@
+import { ID } from '../../../commonStateTypes/common';
+import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { RootState } from '../../../reducer';
+import { RecordPaymentFormLocalData } from './recordPaymentState';
+export interface InvoicingRecordPaymentView extends SelectorView {
+    recordedInvoiceId?: ID;
+    recordedTransactionId?: ID;
+}
+/**
+ * Single bundled view for the record-payment submit lifecycle — carries the
+ * submit fetch state/error and the ids produced on success.
+ */
+export declare const getRecordPaymentView: (state: RootState) => InvoicingRecordPaymentView;
+/**
+ * Bundled view for the Record Payment form screen: the draft `localData`, the
+ * CES-owned payment-method / gateway value sets, and the submit fetch state.
+ */
+export interface RecordPaymentFormView extends SelectorView {
+    gatewayValues: string[];
+    localData: RecordPaymentFormLocalData;
+    paymentMethodValues: string[];
+    contextInvoiceId?: ID;
+}
+export declare const getRecordPaymentFormView: (state: RootState) => RecordPaymentFormView;
+export interface RecordPaymentInvoiceOption {
+    amountDue: number;
+    id: ID;
+    invoiceNumber: string;
+}
+export declare const getRecordPaymentInvoiceOptions: (state: RootState, customerId: ID) => RecordPaymentInvoiceOption[];

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

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRecordPaymentInvoiceOptions = exports.getRecordPaymentFormView = exports.getRecordPaymentView = void 0;
+const invoiceListSelector_1 = require("../invoiceList/invoiceListSelector");
+const recordPaymentFormConfig_1 = require("./recordPaymentFormConfig");
+/**
+ * Single bundled view for the record-payment submit lifecycle — carries the
+ * submit fetch state/error and the ids produced on success.
+ */
+const getRecordPaymentView = (state) => {
+    const { error, fetchState, recordedInvoiceId, recordedTransactionId } = state.invoicingRecordPaymentState;
+    return {
+        recordedInvoiceId,
+        recordedTransactionId,
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};
+exports.getRecordPaymentView = getRecordPaymentView;
+const getRecordPaymentFormView = (state) => {
+    const { contextInvoiceId, error, fetchState, newPaymentDraft } = state.invoicingRecordPaymentState;
+    return {
+        contextInvoiceId,
+        gatewayValues: [...recordPaymentFormConfig_1.INVOICING_PAYMENT_GATEWAY_VALUES],
+        localData: newPaymentDraft,
+        paymentMethodValues: [...recordPaymentFormConfig_1.INVOICING_PAYMENT_METHOD_VALUES],
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};
+exports.getRecordPaymentFormView = getRecordPaymentFormView;
+const UNPAID_INVOICE_STATUSES = new Set([
+    'not_paid',
+    'partially_paid',
+    'payment_due',
+]);
+const getRecordPaymentInvoiceOptions = (state, customerId) => {
+    if (customerId === '') {
+        return [];
+    }
+    const listView = (0, invoiceListSelector_1.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,
+    }));
+};
+exports.getRecordPaymentInvoiceOptions = getRecordPaymentInvoiceOptions;

package/lib/view/invoicing/recordPayment/recordPaymentState.d.ts

@@ -0,0 +1,25 @@
+import { FetchedState, ID } from '../../../commonStateTypes/common';
+/**
+ * Draft form state for the Record Payment form. Held in CES so the form flows
+ * its data from here (mirrors the customer form pattern). Record payment is
+ * create-only, so there is a single draft (no per-id edit tree). The date is an
+ * ISO `YYYY-MM-DD` string; amount is a raw string.
+ */
+export interface RecordPaymentFormLocalData {
+    amount: string;
+    comment: string;
+    customerId: string;
+    date: string;
+    gateway: string;
+    invoiceToLink: string;
+    paymentMethod: string;
+    referenceNumber: string;
+    transactionId: string;
+}
+export interface RecordPaymentState extends FetchedState {
+    newPaymentDraft: RecordPaymentFormLocalData;
+    /** Set when the form is opened from an invoice (invoice-level record payment). */
+    contextInvoiceId?: ID;
+    recordedInvoiceId?: ID;
+    recordedTransactionId?: ID;
+}

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

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

package/lib/view/invoicing/settingsView/invoicingBrandingFormConfig.d.ts

@@ -0,0 +1,32 @@
+import { InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { AddressUpdatableInfo } from '../../addressView/addressViewState';
+/** `AddressType` key used when the branding form opens the shared Address screen. */
+export declare const INVOICING_BUSINESS_ADDRESS_TYPE: "invoicing_business_address";
+/**
+ * Draft form state for the invoicing branding settings form. Held in CES so the
+ * form flows its data from here (mirrors the customer form pattern). The business
+ * address is NOT part of this draft — it is captured via the shared Address
+ * screen and saved as the formatted `address` string on the settings.
+ */
+export interface InvoicingBrandingFormLocalData {
+    accentColor: string;
+    companyName: string;
+    dateFormat: string;
+    defaultMemo: string;
+    email: string;
+    invoicePrefix: string;
+    logoFileId: string;
+    phone: string;
+    taxId: string;
+}
+export declare const initialInvoicingBrandingFormLocalData: InvoicingBrandingFormLocalData;
+/** Seed the form draft from the existing invoicing settings. */
+export declare const entityToInvoicingBrandingFormLocalData: (settings?: InvoicingSettingsPayload) => InvoicingBrandingFormLocalData;
+/**
+ * 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 declare const brandingLocalDataToSettingsPayload: (localData: InvoicingBrandingFormLocalData, address?: AddressUpdatableInfo) => Record<string, unknown>;

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

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.brandingLocalDataToSettingsPayload = exports.entityToInvoicingBrandingFormLocalData = exports.initialInvoicingBrandingFormLocalData = exports.INVOICING_BUSINESS_ADDRESS_TYPE = void 0;
+const addressViewPayload_1 = require("../../addressView/addressViewPayload");
+/** `AddressType` key used when the branding form opens the shared Address screen. */
+exports.INVOICING_BUSINESS_ADDRESS_TYPE = 'invoicing_business_address';
+exports.initialInvoicingBrandingFormLocalData = {
+    accentColor: '#162324',
+    companyName: '',
+    dateFormat: '',
+    defaultMemo: '',
+    email: '',
+    invoicePrefix: '',
+    logoFileId: '',
+    phone: '',
+    taxId: '',
+};
+/** Seed the form draft from the existing invoicing settings. */
+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 ?? '',
+});
+exports.entityToInvoicingBrandingFormLocalData = entityToInvoicingBrandingFormLocalData;
+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.
+ */
+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: (0, addressViewPayload_1.toAddressUpdatableInfoPayload)(address) } : {}),
+});
+exports.brandingLocalDataToSettingsPayload = brandingLocalDataToSettingsPayload;

package/lib/view/invoicing/settingsView/invoicingBrandingFormEpics.d.ts

@@ -0,0 +1,22 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateAddresses } from '../../../entity/address/addressReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { newAddressInLocalStore, resetNewAddressDataInLocalStore } from '../../addressView/addressViewReducer';
+import { saveInvoicingSettingsFailure, saveInvoicingSettingsSuccess, submitInvoicingBrandingForm, updateInvoicingSettings } from './settingsViewReducer';
+export type SubmitActionType = ReturnType<typeof submitInvoicingBrandingForm> | ReturnType<typeof saveInvoicingSettingsSuccess> | ReturnType<typeof saveInvoicingSettingsFailure> | ReturnType<typeof resetNewAddressDataInLocalStore> | ReturnType<typeof updateAddresses>;
+/**
+ * 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 declare const submitInvoicingBrandingFormEpic: (actions$: ActionsObservable<SubmitActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<SubmitActionType>;
+export type SeedActionType = ReturnType<typeof updateInvoicingSettings> | ReturnType<typeof newAddressInLocalStore>;
+/**
+ * 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 declare const initializeInvoicingBrandingAddressEpic: (actions$: ActionsObservable<SeedActionType>, state$: StateObservable<RootState>) => Observable<SeedActionType>;

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

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeInvoicingBrandingAddressEpic = exports.submitInvoicingBrandingFormEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const addressReducer_1 = require("../../../entity/address/addressReducer");
+const addressSelector_1 = require("../../../entity/address/addressSelector");
+const responsePayload_1 = require("../../../responsePayload");
+const addressViewReducer_1 = require("../../addressView/addressViewReducer");
+const invoicingBrandingFormConfig_1 = require("./invoicingBrandingFormConfig");
+const settingsViewReducer_1 = require("./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`.
+ */
+const submitInvoicingBrandingFormEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(settingsViewReducer_1.submitInvoicingBrandingForm.match), (0, operators_1.mergeMap)(() => {
+    const state = state$.value;
+    const { brandingDraft, settings } = state.invoicingSettingsViewState;
+    const localData = brandingDraft ?? (0, invoicingBrandingFormConfig_1.entityToInvoicingBrandingFormLocalData)(settings);
+    const address = state.addressViewState.newAddressState?.[invoicingBrandingFormConfig_1.INVOICING_BUSINESS_ADDRESS_TYPE]?.addressToCreate;
+    const data = (0, invoicingBrandingFormConfig_1.brandingLocalDataToSettingsPayload)(localData, address);
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
+    return zeniAPI
+        .putAndGetJSON(apiUrl, { ...data })
+        .pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            const savedAddress = response.data.address;
+            return [
+                ...(savedAddress != null
+                    ? [(0, addressReducer_1.updateAddresses)([savedAddress])]
+                    : []),
+                (0, settingsViewReducer_1.saveInvoicingSettingsSuccess)(response.data),
+                (0, addressViewReducer_1.resetNewAddressDataInLocalStore)(invoicingBrandingFormConfig_1.INVOICING_BUSINESS_ADDRESS_TYPE),
+            ];
+        }
+        return (0, rxjs_1.of)((0, settingsViewReducer_1.saveInvoicingSettingsFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, settingsViewReducer_1.saveInvoicingSettingsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Save branding settings REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.submitInvoicingBrandingFormEpic = submitInvoicingBrandingFormEpic;
+/**
+ * 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.
+ */
+const initializeInvoicingBrandingAddressEpic = (actions$, state$) => actions$.pipe((0, operators_1.filter)(settingsViewReducer_1.updateInvoicingSettings.match), (0, operators_1.mergeMap)((action) => {
+    const rootState = state$.value;
+    const existing = rootState.addressViewState.newAddressState?.[invoicingBrandingFormConfig_1.INVOICING_BUSINESS_ADDRESS_TYPE]?.addressToCreate;
+    const addressId = action.payload.address?.address_id;
+    if (existing != null || addressId == null) {
+        return rxjs_1.EMPTY;
+    }
+    const address = (0, addressSelector_1.getAddressByAddressId)(rootState.addressState, addressId);
+    return address != null
+        ? (0, rxjs_1.of)((0, addressViewReducer_1.newAddressInLocalStore)({
+            addressType: invoicingBrandingFormConfig_1.INVOICING_BUSINESS_ADDRESS_TYPE,
+            addressToCreate: address,
+        }))
+        : rxjs_1.EMPTY;
+}));
+exports.initializeInvoicingBrandingAddressEpic = initializeInvoicingBrandingAddressEpic;

package/lib/view/invoicing/settingsView/invoicingSettingsHelpers.d.ts

@@ -0,0 +1,2 @@
+import { InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+export declare const isStripeConnectedFromSettings: (settings?: InvoicingSettingsPayload) => boolean;

package/lib/view/invoicing/settingsView/invoicingSettingsHelpers.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isStripeConnectedFromSettings = void 0;
+const isStripeConnectedFromSettings = (settings) => {
+    const stripePublishableKey = settings?.stripe_publishable_key ?? '';
+    const stripeConnectedAccountId = settings?.stripe_connected_account_id ?? '';
+    return (settings?.stripe_connected === true ||
+        stripePublishableKey !== '' ||
+        stripeConnectedAccountId !== '');
+};
+exports.isStripeConnectedFromSettings = isStripeConnectedFromSettings;

package/lib/view/invoicing/settingsView/settingsViewEpics.d.ts

@@ -0,0 +1,11 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateAddresses } from '../../../entity/address/addressReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, invoicingStripeConnectionFailure, saveInvoicingSettings, saveInvoicingSettingsFailure, saveInvoicingSettingsSuccess, updateInvoicingSettings, updateInvoicingSettingsFailure, updateInvoicingStripeConnection } from './settingsViewReducer';
+export type ActionType = ReturnType<typeof fetchInvoicingSettings> | ReturnType<typeof updateInvoicingSettings> | ReturnType<typeof updateInvoicingSettingsFailure> | ReturnType<typeof saveInvoicingSettings> | ReturnType<typeof saveInvoicingSettingsSuccess> | ReturnType<typeof saveInvoicingSettingsFailure> | ReturnType<typeof connectInvoicingStripe> | ReturnType<typeof disconnectInvoicingStripe> | ReturnType<typeof updateInvoicingStripeConnection> | ReturnType<typeof invoicingStripeConnectionFailure> | ReturnType<typeof updateAddresses>;
+export declare const fetchInvoicingSettingsEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;
+export declare const connectInvoicingStripeEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;
+export declare const disconnectInvoicingStripeEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;
+export declare const saveInvoicingSettingsEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/invoicing/settingsView/settingsViewEpics.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveInvoicingSettingsEpic = exports.disconnectInvoicingStripeEpic = exports.connectInvoicingStripeEpic = exports.fetchInvoicingSettingsEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const addressReducer_1 = require("../../../entity/address/addressReducer");
+const responsePayload_1 = require("../../../responsePayload");
+const settingsViewReducer_1 = require("./settingsViewReducer");
+const fetchInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(settingsViewReducer_1.fetchInvoicingSettings.match), (0, operators_1.switchMap)(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
+    return zeniAPI.getJSON(apiUrl).pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            const address = response.data.address;
+            return [
+                ...(address != null ? [(0, addressReducer_1.updateAddresses)([address])] : []),
+                (0, settingsViewReducer_1.updateInvoicingSettings)(response.data),
+            ];
+        }
+        return (0, rxjs_1.of)((0, settingsViewReducer_1.updateInvoicingSettingsFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, settingsViewReducer_1.updateInvoicingSettingsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch settings REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.fetchInvoicingSettingsEpic = fetchInvoicingSettingsEpic;
+const connectInvoicingStripeEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(settingsViewReducer_1.connectInvoicingStripe.match), (0, operators_1.switchMap)((action) => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings/stripe-connect/setup`;
+    const { api_key, publishable_key, webhook_secret } = action.payload;
+    const body = {
+        api_key,
+        publishable_key,
+        ...(webhook_secret != null && webhook_secret !== ''
+            ? { webhook_secret }
+            : {}),
+    };
+    return zeniAPI
+        .postAndGetJSON(apiUrl, body)
+        .pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return (0, rxjs_1.of)((0, settingsViewReducer_1.updateInvoicingStripeConnection)({
+                stripe_connected: response.data.stripe_connected,
+                publishable_key: response.data.publishable_key,
+            }), (0, settingsViewReducer_1.fetchInvoicingSettings)());
+        }
+        return (0, rxjs_1.of)((0, settingsViewReducer_1.invoicingStripeConnectionFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, settingsViewReducer_1.invoicingStripeConnectionFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Stripe connect setup REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.connectInvoicingStripeEpic = connectInvoicingStripeEpic;
+const disconnectInvoicingStripeEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(settingsViewReducer_1.disconnectInvoicingStripe.match), (0, operators_1.switchMap)(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings/stripe-connect/callback`;
+    return zeniAPI
+        .deleteAndGetJSON(apiUrl)
+        .pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response)) {
+            return (0, rxjs_1.of)((0, settingsViewReducer_1.updateInvoicingStripeConnection)({
+                stripe_connected: false,
+                publishable_key: '',
+            }), (0, settingsViewReducer_1.fetchInvoicingSettings)());
+        }
+        return (0, rxjs_1.of)((0, settingsViewReducer_1.invoicingStripeConnectionFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, settingsViewReducer_1.invoicingStripeConnectionFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Stripe disconnect REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.disconnectInvoicingStripeEpic = disconnectInvoicingStripeEpic;
+const saveInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(settingsViewReducer_1.saveInvoicingSettings.match), (0, operators_1.switchMap)((action) => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
+    return zeniAPI
+        .putAndGetJSON(apiUrl, {
+        ...action.payload,
+    })
+        .pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return (0, rxjs_1.of)((0, settingsViewReducer_1.saveInvoicingSettingsSuccess)(response.data));
+        }
+        return (0, rxjs_1.of)((0, settingsViewReducer_1.saveInvoicingSettingsFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, settingsViewReducer_1.saveInvoicingSettingsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Save settings REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.saveInvoicingSettingsEpic = saveInvoicingSettingsEpic;

package/lib/view/invoicing/settingsView/settingsViewPayload.d.ts

@@ -0,0 +1,18 @@
+import { InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+/** Credentials the merchant pastes to connect their own Stripe account (BYOK). */
+export interface StripeConnectCredentials {
+    /** Restricted/secret key (rk_/sk_) used server-side for all charges. */
+    api_key: string;
+    /** Publishable key (pk_) used by Stripe.js in the browser card flow. */
+    publishable_key: string;
+    /** Optional webhook signing secret (whsec_) for verifying this account's events. */
+    webhook_secret?: string;
+}
+interface StripeConnectResponse {
+    publishable_key: string;
+    stripe_connected: boolean;
+}
+export type InvoicingSettingsResponse = ZeniAPIResponse<InvoicingSettingsPayload>;
+export type InvoicingStripeConnectResponse = ZeniAPIResponse<StripeConnectResponse>;
+export {};

package/lib/view/invoicing/settingsView/settingsViewPayload.js

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

package/lib/view/invoicing/settingsView/settingsViewReducer.d.ts

@@ -0,0 +1,15 @@
+import { InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoicingBrandingFormLocalData } from './invoicingBrandingFormConfig';
+import { StripeConnectCredentials } from './settingsViewPayload';
+import { InvoicingSettingsViewState } from './settingsViewState';
+export interface InvoicingStripeConnectionUpdate {
+    stripe_connected: boolean;
+    publishable_key?: string;
+}
+export declare const initialState: InvoicingSettingsViewState;
+export declare const fetchInvoicingSettings: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/fetchInvoicingSettings">, updateInvoicingSettings: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingSettingsPayload, "invoicingSettingsView/updateInvoicingSettings">, updateInvoicingSettingsFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingSettingsView/updateInvoicingSettingsFailure">, saveInvoicingSettings: import("@reduxjs/toolkit").ActionCreatorWithPayload<Partial<InvoicingSettingsPayload>, "invoicingSettingsView/saveInvoicingSettings">, saveInvoicingSettingsSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingSettingsPayload, "invoicingSettingsView/saveInvoicingSettingsSuccess">, saveInvoicingSettingsFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingSettingsView/saveInvoicingSettingsFailure">, resetSaveInvoicingSettings: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/resetSaveInvoicingSettings">, updateInvoicingBrandingFormDraft: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    localData: InvoicingBrandingFormLocalData;
+}, "invoicingSettingsView/updateInvoicingBrandingFormDraft">, submitInvoicingBrandingForm: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/submitInvoicingBrandingForm">, resetInvoicingBrandingFormDraft: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/resetInvoicingBrandingFormDraft">, connectInvoicingStripe: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[credentials: StripeConnectCredentials], StripeConnectCredentials, "invoicingSettingsView/connectInvoicingStripe", never, never>, disconnectInvoicingStripe: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/disconnectInvoicingStripe">, updateInvoicingStripeConnection: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingStripeConnectionUpdate, "invoicingSettingsView/updateInvoicingStripeConnection">, invoicingStripeConnectionFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingSettingsView/invoicingStripeConnectionFailure">, clearInvoicingSettings: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/clearInvoicingSettings">;
+declare const _default: import("redux").Reducer<InvoicingSettingsViewState>;
+export default _default;