@zeniai/client-epic-state 5.1.49 → 5.1.50-betaAK0

package/lib/esm/view/invoicing/invoicingTransactionListView/invoicingTransactionListViewState.js

@@ -0,0 +1,39 @@
+import { stringToUnion } from '../../../commonStateTypes/stringToUnion';
+export const ALL_INVOICING_TRANSACTION_SORT_KEYS = [
+    'transaction',
+    'customer',
+    'method',
+    'date',
+    'type',
+    'gateway',
+    'status',
+    'amount',
+];
+export const toInvoicingTransactionSortKey = (v) => stringToUnion(v, ALL_INVOICING_TRANSACTION_SORT_KEYS);
+export const INVOICING_TRANSACTION_COLUMNS = [
+    { key: 'transaction', sortable: true },
+    { key: 'customer', sortable: true },
+    { key: 'method', sortable: true },
+    { key: 'date', sortable: true },
+    { key: 'type', sortable: true },
+    { key: 'gateway', sortable: true },
+    { key: 'status', sortable: true },
+    { key: 'amount', sortable: true },
+];
+export const ALL_INVOICING_TRANSACTION_TAB_IDS = [
+    'all',
+    'payment',
+    'refund',
+    'authorization',
+    'payment_reversal',
+];
+export const toInvoicingTransactionTabId = (v) => stringToUnion(v, ALL_INVOICING_TRANSACTION_TAB_IDS);
+/**
+ * Ordered filter-tab id set owned by CES so the transaction-list tabs live next
+ * to the model rather than being hardcoded in web-components. Tab labels and the
+ * per-tab count lookup stay in the view layer; this only carries the id set and
+ * display order.
+ */
+export const INVOICING_TRANSACTION_TABS = [
+    ...ALL_INVOICING_TRANSACTION_TAB_IDS,
+];

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/recordPayment/recordPaymentEpic.js

@@ -0,0 +1,24 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { updateInvoicingTransactions } from '../../../entity/invoicing/invoicingTransaction/invoicingTransactionReducer';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { localDataToRecordPaymentPayload, } from './recordPaymentPayload';
+import { recordPaymentFailure, recordPaymentSuccess, submitRecordPayment, } from './recordPaymentReducer';
+export const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(submitRecordPayment.match), mergeMap(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/payments`;
+    const data = localDataToRecordPaymentPayload(state$.value.invoicingRecordPaymentState.newPaymentDraft);
+    return zeniAPI
+        .postAndGetJSON(apiUrl, {
+        ...data,
+    })
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return [
+                updateInvoicingTransactions([response.data], 'merge'),
+                recordPaymentSuccess({ transactionId: response.data.id }),
+            ];
+        }
+        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,32 @@
+const trimOrUndefined = (value) => value.trim() !== '' ? value.trim() : undefined;
+/**
+ * Build the Record Payment request body from the form draft. Amount is converted
+ * to minor units; 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 amountCents = Math.round(Number.parseFloat(localData.amount) * 100);
+    const amount = Number.isNaN(amountCents) ? 0 : amountCents;
+    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 } : {}),
+    };
+};

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

@@ -0,0 +1,42 @@
+import { createSlice } from '@reduxjs/toolkit';
+import { initialRecordPaymentFormLocalData } from './recordPaymentFormConfig';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    newPaymentDraft: { ...initialRecordPaymentFormLocalData },
+    recordedTransactionId: undefined,
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const recordPaymentSlice = createSlice({
+    name: 'invoicingRecordPayment',
+    initialState,
+    reducers: {
+        updateRecordPaymentFormDraft(draft, action) {
+            draft.newPaymentDraft = action.payload.localData;
+        },
+        submitRecordPayment(draft) {
+            draft.fetchState = 'In-Progress';
+            draft.error = undefined;
+            draft.recordedTransactionId = undefined;
+        },
+        recordPaymentSuccess(draft, action) {
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+            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.recordedTransactionId = undefined;
+            draft.newPaymentDraft = { ...initialRecordPaymentFormLocalData };
+        },
+    },
+});
+export const { updateRecordPaymentFormDraft, submitRecordPayment, recordPaymentSuccess, recordPaymentFailure, resetRecordPayment, } = recordPaymentSlice.actions;
+export default recordPaymentSlice.reducer;

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

@@ -0,0 +1,17 @@
+import { INVOICING_PAYMENT_GATEWAY_VALUES, INVOICING_PAYMENT_METHOD_VALUES, } from './recordPaymentFormConfig';
+export const getRecordPaymentFetchState = (state) => ({
+    fetchState: state.invoicingRecordPaymentState.fetchState,
+    error: state.invoicingRecordPaymentState.error,
+});
+export const getRecordedTransactionId = (state) => state.invoicingRecordPaymentState.recordedTransactionId;
+export const getRecordPaymentFormView = (state) => {
+    const { error, fetchState, newPaymentDraft } = state.invoicingRecordPaymentState;
+    return {
+        gatewayValues: [...INVOICING_PAYMENT_GATEWAY_VALUES],
+        localData: newPaymentDraft,
+        paymentMethodValues: [...INVOICING_PAYMENT_METHOD_VALUES],
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};

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

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

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

@@ -0,0 +1,59 @@
+/** `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 persisted as the formatted one-line
+ * `address` string (+ `address_enabled`).
+ */
+export const brandingLocalDataToSettingsPayload = (localData, addressLabel) => {
+    const address = addressLabel != null ? addressLabel.trim() : '';
+    return {
+        accent_color: trimOrUndefined(localData.accentColor),
+        address: address !== '' ? address : undefined,
+        address_enabled: address !== '',
+        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),
+    };
+};
+/**
+ * Best-effort seed of the shared Address screen from the existing freeform
+ * `settings.address` string (placed in the first street line so the user can
+ * restructure it).
+ */
+export const invoicingBusinessAddressToUpdatableInfo = (address) => ({
+    city: '',
+    country: '',
+    postalCode: '',
+    state: '',
+    street: address.trim() !== '' ? [address.trim()] : [],
+});

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

@@ -0,0 +1,35 @@
+import { EMPTY, of } from 'rxjs';
+import { filter, mergeMap } from 'rxjs/operators';
+import { newAddressInLocalStore } from '../../addressView/addressViewReducer';
+import { getFormattedAddress } from '../../addressView/addressViewSelector';
+import { INVOICING_BUSINESS_ADDRESS_TYPE, brandingLocalDataToSettingsPayload, entityToInvoicingBrandingFormLocalData, invoicingBusinessAddressToUpdatableInfo, } from './invoicingBrandingFormConfig';
+import { saveInvoicingSettings, submitInvoicingBrandingForm, updateInvoicingSettings, } from './settingsViewReducer';
+/**
+ * On `submitInvoicingBrandingForm`, build the settings PUT body from the branding
+ * draft + the business address captured via the shared Address screen (persisted
+ * as the formatted one-line `address` string) and dispatch `saveInvoicingSettings`.
+ */
+export const submitInvoicingBrandingFormEpic = (actions$, state$) => actions$.pipe(filter(submitInvoicingBrandingForm.match), mergeMap(() => {
+    const state = state$.value;
+    const { brandingDraft, settings } = state.invoicingSettingsViewState;
+    const localData = brandingDraft ?? entityToInvoicingBrandingFormLocalData(settings);
+    const stashed = state.addressViewState.newAddressState?.[INVOICING_BUSINESS_ADDRESS_TYPE]?.addressToCreate;
+    const addressLabel = stashed != null ? getFormattedAddress(stashed) : settings?.address;
+    return of(saveInvoicingSettings(brandingLocalDataToSettingsPayload(localData, addressLabel)));
+}));
+/**
+ * Seed the shared Address screen with the existing (freeform) business address
+ * when settings load, so opening the Address screen shows the current value.
+ * Skips when an in-progress draft already exists.
+ */
+export const initializeInvoicingBrandingAddressEpic = (actions$, state$) => actions$.pipe(filter(updateInvoicingSettings.match), mergeMap((action) => {
+    const existing = state$.value.addressViewState.newAddressState?.[INVOICING_BUSINESS_ADDRESS_TYPE]?.addressToCreate;
+    const address = action.payload.address;
+    if (existing != null || address == null || address.trim() === '') {
+        return EMPTY;
+    }
+    return of(newAddressInLocalStore({
+        addressType: INVOICING_BUSINESS_ADDRESS_TYPE,
+        addressToCreate: invoicingBusinessAddressToUpdatableInfo(address),
+    }));
+}));

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

@@ -0,0 +1,7 @@
+export const isStripeConnectedFromSettings = (settings) => {
+    const stripePublishableKey = settings?.stripe_publishable_key ?? '';
+    const stripeConnectedAccountId = settings?.stripe_connected_account_id ?? '';
+    return (settings?.stripe_connected === true ||
+        stripePublishableKey !== '' ||
+        stripeConnectedAccountId !== '');
+};

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

@@ -0,0 +1,66 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, invoicingStripeConnectionFailure, saveInvoicingSettings, saveInvoicingSettingsFailure, saveInvoicingSettingsSuccess, updateInvoicingSettings, updateInvoicingSettingsFailure, updateInvoicingStripeConnection, } from './settingsViewReducer';
+export const fetchInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingSettings.match), switchMap(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return of(updateInvoicingSettings(response.data));
+        }
+        return of(updateInvoicingSettingsFailure(response.status));
+    }), catchError((error) => of(updateInvoicingSettingsFailure(createZeniAPIStatus('Unexpected Error', 'Fetch settings REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+export const connectInvoicingStripeEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(connectInvoicingStripe.match), 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(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return of(updateInvoicingStripeConnection({
+                stripe_connected: response.data.stripe_connected,
+                publishable_key: response.data.publishable_key,
+            }), fetchInvoicingSettings());
+        }
+        return of(invoicingStripeConnectionFailure(response.status));
+    }), catchError((error) => of(invoicingStripeConnectionFailure(createZeniAPIStatus('Unexpected Error', 'Stripe connect setup REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+export const disconnectInvoicingStripeEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(disconnectInvoicingStripe.match), switchMap(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings/stripe-connect/callback`;
+    return zeniAPI
+        .deleteAndGetJSON(apiUrl)
+        .pipe(switchMap((response) => {
+        if (isSuccessResponse(response)) {
+            return of(updateInvoicingStripeConnection({
+                stripe_connected: false,
+                publishable_key: '',
+            }), fetchInvoicingSettings());
+        }
+        return of(invoicingStripeConnectionFailure(response.status));
+    }), catchError((error) => of(invoicingStripeConnectionFailure(createZeniAPIStatus('Unexpected Error', 'Stripe disconnect REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+export const saveInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(saveInvoicingSettings.match), switchMap((action) => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
+    return zeniAPI
+        .putAndGetJSON(apiUrl, {
+        ...action.payload,
+    })
+        .pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return of(saveInvoicingSettingsSuccess(response.data));
+        }
+        return of(saveInvoicingSettingsFailure(response.status));
+    }), catchError((error) => of(saveInvoicingSettingsFailure(createZeniAPIStatus('Unexpected Error', 'Save settings REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

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

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

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

@@ -0,0 +1,86 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    saveFetchState: { fetchState: 'Not-Started', error: undefined },
+    stripeFetchState: { fetchState: 'Not-Started', error: undefined },
+    settings: undefined,
+    hasValidState() {
+        return this.fetchState === 'Completed' && this.settings != null;
+    },
+};
+const settingsView = createSlice({
+    name: 'invoicingSettingsView',
+    initialState,
+    reducers: {
+        fetchInvoicingSettings(draft) {
+            draft.fetchState = 'In-Progress';
+            draft.error = undefined;
+        },
+        updateInvoicingSettings(draft, action) {
+            draft.settings = action.payload;
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+        },
+        updateInvoicingSettingsFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        saveInvoicingSettings(draft, action) {
+            draft.saveFetchState = { fetchState: 'In-Progress', error: undefined };
+            if (draft.settings != null) {
+                draft.settings = { ...draft.settings, ...action.payload };
+            }
+        },
+        saveInvoicingSettingsSuccess(draft, action) {
+            draft.settings = action.payload;
+            draft.saveFetchState = { fetchState: 'Completed', error: undefined };
+        },
+        saveInvoicingSettingsFailure(draft, action) {
+            draft.saveFetchState = { fetchState: 'Error', error: action.payload };
+        },
+        resetSaveInvoicingSettings(draft) {
+            draft.saveFetchState = { fetchState: 'Not-Started', error: undefined };
+        },
+        updateInvoicingBrandingFormDraft(draft, action) {
+            draft.brandingDraft = action.payload.localData;
+        },
+        // Trigger only — handled by submitInvoicingBrandingFormEpic (reads the draft
+        // + the stashed Address-screen address and dispatches saveInvoicingSettings).
+        submitInvoicingBrandingForm(draft) {
+            draft.saveFetchState = { fetchState: 'In-Progress', error: undefined };
+        },
+        resetInvoicingBrandingFormDraft(draft) {
+            draft.brandingDraft = undefined;
+        },
+        connectInvoicingStripe: {
+            reducer(draft) {
+                draft.stripeFetchState = { fetchState: 'In-Progress', error: undefined };
+            },
+            prepare(credentials) {
+                return { payload: credentials };
+            },
+        },
+        disconnectInvoicingStripe(draft) {
+            draft.stripeFetchState = { fetchState: 'In-Progress', error: undefined };
+        },
+        updateInvoicingStripeConnection(draft, action) {
+            draft.stripeFetchState = { fetchState: 'Completed', error: undefined };
+            if (draft.settings != null) {
+                draft.settings = {
+                    ...draft.settings,
+                    stripe_connected: action.payload.stripe_connected,
+                    stripe_publishable_key: action.payload.publishable_key ?? '',
+                };
+            }
+        },
+        invoicingStripeConnectionFailure(draft, action) {
+            draft.stripeFetchState = { fetchState: 'Error', error: action.payload };
+        },
+        clearInvoicingSettings(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { fetchInvoicingSettings, updateInvoicingSettings, updateInvoicingSettingsFailure, saveInvoicingSettings, saveInvoicingSettingsSuccess, saveInvoicingSettingsFailure, resetSaveInvoicingSettings, updateInvoicingBrandingFormDraft, submitInvoicingBrandingForm, resetInvoicingBrandingFormDraft, connectInvoicingStripe, disconnectInvoicingStripe, updateInvoicingStripeConnection, invoicingStripeConnectionFailure, clearInvoicingSettings, } = settingsView.actions;
+export default settingsView.reducer;

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

@@ -0,0 +1,28 @@
+import { getFormattedAddress } from '../../addressView/addressViewSelector';
+import { INVOICING_BUSINESS_ADDRESS_TYPE, entityToInvoicingBrandingFormLocalData, } from './invoicingBrandingFormConfig';
+export const getInvoicingSettings = (state) => state.invoicingSettingsViewState.settings;
+export const getInvoicingSettingsFetchState = (state) => ({
+    fetchState: state.invoicingSettingsViewState.fetchState,
+    error: state.invoicingSettingsViewState.error,
+});
+export const getInvoicingSettingsSaveState = (state) => state.invoicingSettingsViewState.saveFetchState;
+export const getInvoicingStripeConnectState = (state) => state.invoicingSettingsViewState.stripeFetchState;
+/**
+ * Bundled view for the branding settings form: the draft `localData` (seeded
+ * from the existing settings until the user edits), the business-address label
+ * (from the shared Address screen, else the saved settings address), the raw
+ * settings (for the logo/preview) and the save fetch state.
+ */
+export const getInvoicingBrandingFormView = (state) => {
+    const { brandingDraft, saveFetchState, settings } = state.invoicingSettingsViewState;
+    const newAddress = state.addressViewState.newAddressState?.[INVOICING_BUSINESS_ADDRESS_TYPE];
+    const addressLabel = newAddress?.addressToCreate != null
+        ? getFormattedAddress(newAddress.addressToCreate)
+        : (settings?.address ?? undefined);
+    return {
+        addressLabel,
+        localData: brandingDraft ?? entityToInvoicingBrandingFormLocalData(settings),
+        saveState: saveFetchState,
+        settings,
+    };
+};

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

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

package/lib/esm/view/invoicing/subscriptionAction/subscriptionActionEpic.js

@@ -0,0 +1,27 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { updateInvoicingSubscriptions } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { runInvoicingSubscriptionAction, runInvoicingSubscriptionActionFailure, runInvoicingSubscriptionActionSuccess, } from './subscriptionActionReducer';
+export const runInvoicingSubscriptionActionEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(runInvoicingSubscriptionAction.match), mergeMap((action) => {
+    const { action: kind, body, id } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/subscriptions/${encodeURIComponent(id)}/${kind}`;
+    return zeniAPI
+        .postAndGetJSON(apiUrl, (body ?? {}))
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return [
+                updateInvoicingSubscriptions([response.data], 'merge'),
+                runInvoicingSubscriptionActionSuccess({ id }),
+            ];
+        }
+        return of(runInvoicingSubscriptionActionFailure({
+            error: response.status,
+            id,
+        }));
+    }), catchError((error) => of(runInvoicingSubscriptionActionFailure({
+        error: createZeniAPIStatus('Unexpected Error', 'Subscription action REST API call errored out ' +
+            JSON.stringify(error)),
+        id,
+    }))));
+}));

package/lib/esm/view/invoicing/subscriptionAction/subscriptionActionPayload.js

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

package/lib/esm/view/invoicing/subscriptionAction/subscriptionActionReducer.js

@@ -0,0 +1,36 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    byId: {},
+};
+const subscriptionAction = createSlice({
+    name: 'invoicingSubscriptionAction',
+    initialState,
+    reducers: {
+        runInvoicingSubscriptionAction(draft, action) {
+            draft.byId[action.payload.id] = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        runInvoicingSubscriptionActionSuccess(draft, action) {
+            draft.byId[action.payload.id] = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        runInvoicingSubscriptionActionFailure(draft, action) {
+            draft.byId[action.payload.id] = {
+                fetchState: 'Error',
+                error: action.payload.error,
+            };
+        },
+        clearInvoicingSubscriptionAction(draft, action) {
+            delete draft.byId[action.payload];
+        },
+        clearAllInvoicingSubscriptionActions(draft) {
+            draft.byId = {};
+        },
+    },
+});
+export const { runInvoicingSubscriptionAction, runInvoicingSubscriptionActionSuccess, runInvoicingSubscriptionActionFailure, clearInvoicingSubscriptionAction, clearAllInvoicingSubscriptionActions, } = subscriptionAction.actions;
+export default subscriptionAction.reducer;

package/lib/esm/view/invoicing/subscriptionAction/subscriptionActionRequestPayload.js

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