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

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInvoicingPaymentActionEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const invoicingTransactionReducer_1 = require("../../../entity/invoicing/invoicingTransaction/invoicingTransactionReducer");
+const responsePayload_1 = require("../../../responsePayload");
+const paymentActionReducer_1 = require("./paymentActionReducer");
+const runInvoicingPaymentActionEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(paymentActionReducer_1.runInvoicingPaymentAction.match), (0, operators_1.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((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return [
+                (0, invoicingTransactionReducer_1.updateInvoicingTransactions)([response.data], 'merge'),
+                (0, paymentActionReducer_1.runInvoicingPaymentActionSuccess)({ id }),
+            ];
+        }
+        return (0, rxjs_1.of)((0, paymentActionReducer_1.runInvoicingPaymentActionFailure)({
+            error: response.status,
+            id,
+        }));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, paymentActionReducer_1.runInvoicingPaymentActionFailure)({
+        error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Payment action REST API call errored out ' +
+            JSON.stringify(error)),
+        id,
+    }))));
+}));
+exports.runInvoicingPaymentActionEpic = runInvoicingPaymentActionEpic;

package/lib/view/invoicing/paymentAction/paymentActionPayload.d.ts

@@ -0,0 +1,3 @@
+import { InvoicingTransactionPayload } from '../../../entity/invoicing/invoicingTransaction/invoicingTransactionPayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+export type InvoicingPaymentActionResponse = ZeniAPIResponse<InvoicingTransactionPayload>;

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

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

package/lib/view/invoicing/paymentAction/paymentActionReducer.d.ts

@@ -0,0 +1,19 @@
+import { ID } from '../../../commonStateTypes/common';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoicingPaymentActionBody } from './paymentActionRequestPayload';
+import { InvoicingPaymentActionState } from './paymentActionState';
+export interface RunInvoicingPaymentActionPayload {
+    action: string;
+    id: ID;
+    /** Optional JSON body for actions that take parameters. */
+    body?: InvoicingPaymentActionBody;
+}
+export declare const initialState: InvoicingPaymentActionState;
+export declare const runInvoicingPaymentAction: import("@reduxjs/toolkit").ActionCreatorWithPayload<RunInvoicingPaymentActionPayload, "invoicingPaymentAction/runInvoicingPaymentAction">, runInvoicingPaymentActionSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    id: ID;
+}, "invoicingPaymentAction/runInvoicingPaymentActionSuccess">, runInvoicingPaymentActionFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    error: ZeniAPIStatus;
+    id: ID;
+}, "invoicingPaymentAction/runInvoicingPaymentActionFailure">, clearInvoicingPaymentAction: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "invoicingPaymentAction/clearInvoicingPaymentAction">, clearAllInvoicingPaymentActions: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingPaymentAction/clearAllInvoicingPaymentActions">;
+declare const _default: import("redux").Reducer<InvoicingPaymentActionState>;
+export default _default;

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

@@ -0,0 +1,40 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearAllInvoicingPaymentActions = exports.clearInvoicingPaymentAction = exports.runInvoicingPaymentActionFailure = exports.runInvoicingPaymentActionSuccess = exports.runInvoicingPaymentAction = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+exports.initialState = {
+    byId: {},
+};
+const paymentAction = (0, toolkit_1.createSlice)({
+    name: 'invoicingPaymentAction',
+    initialState: exports.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 = {};
+        },
+    },
+});
+_a = paymentAction.actions, exports.runInvoicingPaymentAction = _a.runInvoicingPaymentAction, exports.runInvoicingPaymentActionSuccess = _a.runInvoicingPaymentActionSuccess, exports.runInvoicingPaymentActionFailure = _a.runInvoicingPaymentActionFailure, exports.clearInvoicingPaymentAction = _a.clearInvoicingPaymentAction, exports.clearAllInvoicingPaymentActions = _a.clearAllInvoicingPaymentActions;
+exports.default = paymentAction.reducer;

package/lib/view/invoicing/paymentAction/paymentActionRequestPayload.d.ts

@@ -0,0 +1,7 @@
+/** Snake_case request bodies for payment action endpoints. */
+export type RefundPaymentBody = {
+    amount?: number;
+    reason?: string;
+    refund_method?: string;
+};
+export type InvoicingPaymentActionBody = RefundPaymentBody | Record<string, never>;

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

@@ -0,0 +1,3 @@
+"use strict";
+/** Snake_case request bodies for payment action endpoints. */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/view/invoicing/paymentAction/paymentActionSelector.d.ts

@@ -0,0 +1,3 @@
+import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
+import { RootState } from '../../../reducer';
+export declare const getInvoicingPaymentActionState: (id: ID) => (state: RootState) => FetchStateAndError;

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

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingPaymentActionState = void 0;
+const NOT_STARTED = {
+    fetchState: 'Not-Started',
+    error: undefined,
+};
+const getInvoicingPaymentActionState = (id) => (state) => state.invoicingPaymentActionState.byId[id] ?? NOT_STARTED;
+exports.getInvoicingPaymentActionState = getInvoicingPaymentActionState;

package/lib/view/invoicing/paymentAction/paymentActionState.d.ts

@@ -0,0 +1,5 @@
+import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
+/** Per-payment action fetch state keyed by payment id. */
+export interface InvoicingPaymentActionState {
+    byId: Record<ID, FetchStateAndError>;
+}

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

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

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

@@ -0,0 +1,8 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateInvoicingTransactions } from '../../../entity/invoicing/invoicingTransaction/invoicingTransactionReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { recordPaymentFailure, recordPaymentSuccess, submitRecordPayment } from './recordPaymentReducer';
+export type ActionType = ReturnType<typeof submitRecordPayment> | ReturnType<typeof recordPaymentSuccess> | ReturnType<typeof recordPaymentFailure> | ReturnType<typeof updateInvoicingTransactions>;
+export declare const recordPaymentEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordPaymentEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const invoicingTransactionReducer_1 = require("../../../entity/invoicing/invoicingTransaction/invoicingTransactionReducer");
+const responsePayload_1 = require("../../../responsePayload");
+const recordPaymentPayload_1 = require("./recordPaymentPayload");
+const recordPaymentReducer_1 = require("./recordPaymentReducer");
+const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(recordPaymentReducer_1.submitRecordPayment.match), (0, operators_1.mergeMap)(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/payments`;
+    const data = (0, recordPaymentPayload_1.localDataToRecordPaymentPayload)(state$.value.invoicingRecordPaymentState.newPaymentDraft);
+    return zeniAPI
+        .postAndGetJSON(apiUrl, {
+        ...data,
+    })
+        .pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return [
+                (0, invoicingTransactionReducer_1.updateInvoicingTransactions)([response.data], 'merge'),
+                (0, recordPaymentReducer_1.recordPaymentSuccess)({ transactionId: response.data.id }),
+            ];
+        }
+        return (0, rxjs_1.of)((0, recordPaymentReducer_1.recordPaymentFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, recordPaymentReducer_1.recordPaymentFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Record payment REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.recordPaymentEpic = recordPaymentEpic;

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

@@ -0,0 +1,8 @@
+import { RecordPaymentFormLocalData } from './recordPaymentState';
+/**
+ * Canonical value sets for the Record Payment form. CES owns the values;
+ * web-components maps each value to a localized label.
+ */
+export declare const INVOICING_PAYMENT_METHOD_VALUES: readonly ["card", "cash", "check", "bank_transfer", "direct_debit", "paypal_express_checkout", "apple_pay", "google_pay", "ach_credit", "sepa_credit", "other"];
+export declare const INVOICING_PAYMENT_GATEWAY_VALUES: readonly ["stripe", "chargebee", "braintree", "paypal", "adyen", "razorpay", "other"];
+export declare const initialRecordPaymentFormLocalData: RecordPaymentFormLocalData;

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

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

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

@@ -0,0 +1,30 @@
+import { InvoicingTransactionPayload } from '../../../entity/invoicing/invoicingTransaction/invoicingTransactionPayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+import { RecordPaymentFormLocalData } from './recordPaymentState';
+/** Invoice reference linked to a recorded payment (amounts in minor units). */
+export interface RecordPaymentLinkedInvoice {
+    applied_amount: number;
+    invoice_id: string;
+}
+/** Request body for recording a manual payment; mirrors the Invoicing backend. */
+export interface RecordPaymentRequest {
+    amount: number;
+    customer_id: string;
+    payment_method: string;
+    currency_code?: string;
+    date?: string;
+    gateway?: string;
+    id_at_gateway?: string;
+    linked_invoices?: RecordPaymentLinkedInvoice[];
+    notes?: string;
+    reference_number?: string;
+    status?: string;
+    type?: string;
+}
+export type RecordPaymentResponse = ZeniAPIResponse<InvoicingTransactionPayload>;
+/**
+ * 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 declare const localDataToRecordPaymentPayload: (localData: RecordPaymentFormLocalData) => RecordPaymentRequest;

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localDataToRecordPaymentPayload = void 0;
+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.
+ */
+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 } : {}),
+    };
+};
+exports.localDataToRecordPaymentPayload = localDataToRecordPaymentPayload;

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

@@ -0,0 +1,11 @@
+import { ID } from '../../../commonStateTypes/common';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { RecordPaymentFormLocalData, RecordPaymentState } from './recordPaymentState';
+export declare const initialState: RecordPaymentState;
+export declare const updateRecordPaymentFormDraft: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    localData: RecordPaymentFormLocalData;
+}, "invoicingRecordPayment/updateRecordPaymentFormDraft">, submitRecordPayment: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingRecordPayment/submitRecordPayment">, recordPaymentSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    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,46 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetRecordPayment = exports.recordPaymentFailure = exports.recordPaymentSuccess = exports.submitRecordPayment = exports.updateRecordPaymentFormDraft = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const recordPaymentFormConfig_1 = require("./recordPaymentFormConfig");
+exports.initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    newPaymentDraft: { ...recordPaymentFormConfig_1.initialRecordPaymentFormLocalData },
+    recordedTransactionId: undefined,
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const recordPaymentSlice = (0, toolkit_1.createSlice)({
+    name: 'invoicingRecordPayment',
+    initialState: exports.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 = { ...recordPaymentFormConfig_1.initialRecordPaymentFormLocalData };
+        },
+    },
+});
+_a = recordPaymentSlice.actions, 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,16 @@
+import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
+import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { RootState } from '../../../reducer';
+import { RecordPaymentFormLocalData } from './recordPaymentState';
+export declare const getRecordPaymentFetchState: (state: RootState) => FetchStateAndError;
+export declare const getRecordedTransactionId: (state: RootState) => ID | undefined;
+/**
+ * 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[];
+}
+export declare const getRecordPaymentFormView: (state: RootState) => RecordPaymentFormView;

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRecordPaymentFormView = exports.getRecordedTransactionId = exports.getRecordPaymentFetchState = void 0;
+const recordPaymentFormConfig_1 = require("./recordPaymentFormConfig");
+const getRecordPaymentFetchState = (state) => ({
+    fetchState: state.invoicingRecordPaymentState.fetchState,
+    error: state.invoicingRecordPaymentState.error,
+});
+exports.getRecordPaymentFetchState = getRecordPaymentFetchState;
+const getRecordedTransactionId = (state) => state.invoicingRecordPaymentState.recordedTransactionId;
+exports.getRecordedTransactionId = getRecordedTransactionId;
+const getRecordPaymentFormView = (state) => {
+    const { error, fetchState, newPaymentDraft } = state.invoicingRecordPaymentState;
+    return {
+        gatewayValues: [...recordPaymentFormConfig_1.INVOICING_PAYMENT_GATEWAY_VALUES],
+        localData: newPaymentDraft,
+        paymentMethodValues: [...recordPaymentFormConfig_1.INVOICING_PAYMENT_METHOD_VALUES],
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};
+exports.getRecordPaymentFormView = getRecordPaymentFormView;

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

@@ -0,0 +1,22 @@
+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;
+    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,36 @@
+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 persisted as the formatted one-line
+ * `address` string (+ `address_enabled`).
+ */
+export declare const brandingLocalDataToSettingsPayload: (localData: InvoicingBrandingFormLocalData, addressLabel?: string) => Partial<InvoicingSettingsPayload>;
+/**
+ * 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 declare const invoicingBusinessAddressToUpdatableInfo: (address: string) => AddressUpdatableInfo;

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

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invoicingBusinessAddressToUpdatableInfo = exports.brandingLocalDataToSettingsPayload = exports.entityToInvoicingBrandingFormLocalData = exports.initialInvoicingBrandingFormLocalData = exports.INVOICING_BUSINESS_ADDRESS_TYPE = void 0;
+/** `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 persisted as the formatted one-line
+ * `address` string (+ `address_enabled`).
+ */
+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),
+    };
+};
+exports.brandingLocalDataToSettingsPayload = brandingLocalDataToSettingsPayload;
+/**
+ * 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).
+ */
+const invoicingBusinessAddressToUpdatableInfo = (address) => ({
+    city: '',
+    country: '',
+    postalCode: '',
+    state: '',
+    street: address.trim() !== '' ? [address.trim()] : [],
+});
+exports.invoicingBusinessAddressToUpdatableInfo = invoicingBusinessAddressToUpdatableInfo;

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

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

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

@@ -0,0 +1,40 @@
+"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 addressViewReducer_1 = require("../../addressView/addressViewReducer");
+const addressViewSelector_1 = require("../../addressView/addressViewSelector");
+const invoicingBrandingFormConfig_1 = require("./invoicingBrandingFormConfig");
+const settingsViewReducer_1 = require("./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`.
+ */
+const submitInvoicingBrandingFormEpic = (actions$, state$) => 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 stashed = state.addressViewState.newAddressState?.[invoicingBrandingFormConfig_1.INVOICING_BUSINESS_ADDRESS_TYPE]?.addressToCreate;
+    const addressLabel = stashed != null ? (0, addressViewSelector_1.getFormattedAddress)(stashed) : settings?.address;
+    return (0, rxjs_1.of)((0, settingsViewReducer_1.saveInvoicingSettings)((0, invoicingBrandingFormConfig_1.brandingLocalDataToSettingsPayload)(localData, addressLabel)));
+}));
+exports.submitInvoicingBrandingFormEpic = submitInvoicingBrandingFormEpic;
+/**
+ * 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.
+ */
+const initializeInvoicingBrandingAddressEpic = (actions$, state$) => actions$.pipe((0, operators_1.filter)(settingsViewReducer_1.updateInvoicingSettings.match), (0, operators_1.mergeMap)((action) => {
+    const existing = state$.value.addressViewState.newAddressState?.[invoicingBrandingFormConfig_1.INVOICING_BUSINESS_ADDRESS_TYPE]?.addressToCreate;
+    const address = action.payload.address;
+    if (existing != null || address == null || address.trim() === '') {
+        return rxjs_1.EMPTY;
+    }
+    return (0, rxjs_1.of)((0, addressViewReducer_1.newAddressInLocalStore)({
+        addressType: invoicingBrandingFormConfig_1.INVOICING_BUSINESS_ADDRESS_TYPE,
+        addressToCreate: (0, invoicingBrandingFormConfig_1.invoicingBusinessAddressToUpdatableInfo)(address),
+    }));
+}));
+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,10 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+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>;
+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>;