@zeniai/client-epic-state 5.1.60-betaDI1 → 5.1.61-betaDI0

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.mergeMap)((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.mergeMap)(() => {
+    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.mergeMap)((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;

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

@@ -0,0 +1,90 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearInvoicingSettings = exports.invoicingStripeConnectionFailure = exports.updateInvoicingStripeConnection = exports.disconnectInvoicingStripe = exports.connectInvoicingStripe = exports.resetInvoicingBrandingFormDraft = exports.submitInvoicingBrandingForm = exports.updateInvoicingBrandingFormDraft = exports.resetSaveInvoicingSettings = exports.saveInvoicingSettingsFailure = exports.saveInvoicingSettingsSuccess = exports.saveInvoicingSettings = exports.updateInvoicingSettingsFailure = exports.updateInvoicingSettings = exports.fetchInvoicingSettings = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+exports.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 = (0, toolkit_1.createSlice)({
+    name: 'invoicingSettingsView',
+    initialState: exports.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, exports.initialState);
+        },
+    },
+});
+_a = settingsView.actions, exports.fetchInvoicingSettings = _a.fetchInvoicingSettings, exports.updateInvoicingSettings = _a.updateInvoicingSettings, exports.updateInvoicingSettingsFailure = _a.updateInvoicingSettingsFailure, exports.saveInvoicingSettings = _a.saveInvoicingSettings, exports.saveInvoicingSettingsSuccess = _a.saveInvoicingSettingsSuccess, exports.saveInvoicingSettingsFailure = _a.saveInvoicingSettingsFailure, exports.resetSaveInvoicingSettings = _a.resetSaveInvoicingSettings, exports.updateInvoicingBrandingFormDraft = _a.updateInvoicingBrandingFormDraft, exports.submitInvoicingBrandingForm = _a.submitInvoicingBrandingForm, exports.resetInvoicingBrandingFormDraft = _a.resetInvoicingBrandingFormDraft, exports.connectInvoicingStripe = _a.connectInvoicingStripe, exports.disconnectInvoicingStripe = _a.disconnectInvoicingStripe, exports.updateInvoicingStripeConnection = _a.updateInvoicingStripeConnection, exports.invoicingStripeConnectionFailure = _a.invoicingStripeConnectionFailure, exports.clearInvoicingSettings = _a.clearInvoicingSettings;
+exports.default = settingsView.reducer;

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

@@ -0,0 +1,42 @@
+import { FetchState, FetchStateAndError } from '../../../commonStateTypes/common';
+import { InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { RootState } from '../../../reducer';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoicingBrandingFormLocalData } from './invoicingBrandingFormConfig';
+/**
+ * Shared primitive: the raw invoicing settings. Consumed internally by other
+ * CES selectors (create-invoice, customer-detail, overview) and by non-settings
+ * screens — kept standalone rather than folded into the settings view.
+ */
+export declare const getInvoicingSettings: (state: RootState) => InvoicingSettingsPayload | undefined;
+/**
+ * Shared primitive: the settings fetch state. Consumed internally by the
+ * invoicing overview selector/epic for `shouldFetch` gating — kept standalone.
+ */
+export declare const getInvoicingSettingsFetchState: (state: RootState) => FetchStateAndError;
+export interface InvoicingSettingsView {
+    fetchState: FetchState;
+    saveState: FetchStateAndError;
+    stripeConnectState: FetchStateAndError;
+    error?: ZeniAPIStatus;
+    settings?: InvoicingSettingsPayload;
+}
+/**
+ * Single bundled view for the invoicing settings screen — carries the raw
+ * `settings`, the load fetch (`fetchState`/`error`), the `saveState`, and the
+ * Stripe-connect fetch state.
+ */
+export declare const getInvoicingSettingsView: (state: RootState) => InvoicingSettingsView;
+export interface InvoicingBrandingFormView {
+    localData: InvoicingBrandingFormLocalData;
+    saveState: FetchStateAndError;
+    addressLabel?: string;
+    settings?: InvoicingSettingsPayload;
+}
+/**
+ * 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, seeded on load from `address_id`), the raw
+ * settings (for the logo/preview) and the save fetch state.
+ */
+export declare const getInvoicingBrandingFormView: (state: RootState) => InvoicingBrandingFormView;

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingBrandingFormView = exports.getInvoicingSettingsView = exports.getInvoicingSettingsFetchState = exports.getInvoicingSettings = void 0;
+const addressViewSelector_1 = require("../../addressView/addressViewSelector");
+const invoicingBrandingFormConfig_1 = require("./invoicingBrandingFormConfig");
+/**
+ * Shared primitive: the raw invoicing settings. Consumed internally by other
+ * CES selectors (create-invoice, customer-detail, overview) and by non-settings
+ * screens — kept standalone rather than folded into the settings view.
+ */
+const getInvoicingSettings = (state) => state.invoicingSettingsViewState.settings;
+exports.getInvoicingSettings = getInvoicingSettings;
+/**
+ * Shared primitive: the settings fetch state. Consumed internally by the
+ * invoicing overview selector/epic for `shouldFetch` gating — kept standalone.
+ */
+const getInvoicingSettingsFetchState = (state) => ({
+    fetchState: state.invoicingSettingsViewState.fetchState,
+    error: state.invoicingSettingsViewState.error,
+});
+exports.getInvoicingSettingsFetchState = getInvoicingSettingsFetchState;
+/**
+ * Single bundled view for the invoicing settings screen — carries the raw
+ * `settings`, the load fetch (`fetchState`/`error`), the `saveState`, and the
+ * Stripe-connect fetch state.
+ */
+const getInvoicingSettingsView = (state) => {
+    const { error, fetchState, saveFetchState, settings, stripeFetchState } = state.invoicingSettingsViewState;
+    return {
+        error,
+        fetchState,
+        saveState: saveFetchState,
+        settings,
+        stripeConnectState: stripeFetchState,
+    };
+};
+exports.getInvoicingSettingsView = getInvoicingSettingsView;
+/**
+ * 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, seeded on load from `address_id`), the raw
+ * settings (for the logo/preview) and the save fetch state.
+ */
+const getInvoicingBrandingFormView = (state) => {
+    const { brandingDraft, saveFetchState, settings } = state.invoicingSettingsViewState;
+    const newAddress = state.addressViewState.newAddressState?.[invoicingBrandingFormConfig_1.INVOICING_BUSINESS_ADDRESS_TYPE];
+    const addressLabel = newAddress?.addressToCreate != null
+        ? (0, addressViewSelector_1.getFormattedAddress)(newAddress.addressToCreate)
+        : undefined;
+    return {
+        addressLabel,
+        localData: brandingDraft ?? (0, invoicingBrandingFormConfig_1.entityToInvoicingBrandingFormLocalData)(settings),
+        saveState: saveFetchState,
+        settings,
+    };
+};
+exports.getInvoicingBrandingFormView = getInvoicingBrandingFormView;

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

@@ -0,0 +1,9 @@
+import { FetchStateAndError, FetchedState } from '../../../commonStateTypes/common';
+import { InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingBrandingFormLocalData } from './invoicingBrandingFormConfig';
+export interface InvoicingSettingsViewState extends FetchedState {
+    saveFetchState: FetchStateAndError;
+    stripeFetchState: FetchStateAndError;
+    brandingDraft?: InvoicingBrandingFormLocalData;
+    settings?: InvoicingSettingsPayload;
+}

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

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

package/lib/view/invoicing/subscriptionAction/subscriptionActionEpic.d.ts

@@ -0,0 +1,9 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateAddresses } from '../../../entity/address/addressReducer';
+import { updateInvoicingSubscriptions } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { runInvoicingSubscriptionAction, runInvoicingSubscriptionActionFailure, runInvoicingSubscriptionActionSuccess } from './subscriptionActionReducer';
+export type ActionType = ReturnType<typeof runInvoicingSubscriptionAction> | ReturnType<typeof runInvoicingSubscriptionActionSuccess> | ReturnType<typeof runInvoicingSubscriptionActionFailure> | ReturnType<typeof updateAddresses> | ReturnType<typeof updateInvoicingSubscriptions>;
+export declare const runInvoicingSubscriptionActionEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;