@zeniai/client-epic-state 5.1.32 → 5.1.34-betaAK0

package/lib/view/invoicing/invoiceList/invoiceListState.d.ts

@@ -0,0 +1,26 @@
+import { FetchStateAndError, FetchedState, ID } from '../../../commonStateTypes/common';
+import { InvoicingInvoiceKPIs } from '../../../entity/invoicing/invoice/invoicePayload';
+import { InvoicingListCounts } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingListSort } from '../invoicingApiHelper';
+/** Filters that drive the invoice list query (mirrors the Invoices hooks). */
+export interface InvoiceListFilters {
+    customerId?: ID;
+    dateFrom?: string;
+    dateTo?: string;
+    search?: string;
+    status?: string;
+    subscriptionId?: ID;
+}
+export interface InvoiceListState extends FetchedState {
+    counts: InvoicingListCounts;
+    countsFetchState: FetchStateAndError;
+    filters: InvoiceListFilters;
+    /** Ordered invoice IDs for the current list view. */
+    invoiceIds: ID[];
+    kpisFetchState: FetchStateAndError;
+    /** Cursor for the next page (null when there are no more pages). */
+    nextCursor: string | null;
+    kpis?: InvoicingInvoiceKPIs;
+    /** Active server-side sort (undefined = backend default order). */
+    sort?: InvoicingListSort;
+}

package/lib/view/invoicing/invoiceList/invoiceListState.js

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

package/lib/view/invoicing/invoicePdf/invoicePdfEpic.d.ts

@@ -0,0 +1,7 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { downloadInvoicePdf, downloadInvoicePdfFailure, downloadInvoicePdfSuccess } from './invoicePdfReducer';
+export type ActionType = ReturnType<typeof downloadInvoicePdf> | ReturnType<typeof downloadInvoicePdfSuccess> | ReturnType<typeof downloadInvoicePdfFailure>;
+export declare const downloadInvoicePdfEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/invoicing/invoicePdf/invoicePdfEpic.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadInvoicePdfEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../responsePayload");
+const invoicePdfReducer_1 = require("./invoicePdfReducer");
+/**
+ * Turn the auth-fetched PDF bytes into a browser download. The invoicing PDF
+ * endpoint requires the zeni-* auth headers, so the blob must be fetched via
+ * ZeniAPI (a plain <a href>/<iframe> cannot attach them) and then handed to the
+ * browser as an object URL.
+ */
+const triggerBrowserDownload = (data, fileName) => {
+    if (typeof document === 'undefined' || typeof URL === 'undefined') {
+        return;
+    }
+    const blob = new Blob([data], { type: 'application/pdf' });
+    const objectUrl = URL.createObjectURL(blob);
+    const anchor = document.createElement('a');
+    anchor.href = objectUrl;
+    anchor.download = fileName;
+    document.body.appendChild(anchor);
+    anchor.click();
+    anchor.remove();
+    URL.revokeObjectURL(objectUrl);
+};
+const downloadInvoicePdfEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoicePdfReducer_1.downloadInvoicePdf.match), (0, operators_1.mergeMap)((action) => {
+    const { fileName, invoiceId } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${encodeURIComponent(invoiceId)}/pdf`;
+    return zeniAPI.getFile(apiUrl).pipe((0, operators_1.map)((data) => {
+        triggerBrowserDownload(data, fileName != null && fileName !== '' ? fileName : `${invoiceId}.pdf`);
+        return (0, invoicePdfReducer_1.downloadInvoicePdfSuccess)({ invoiceId });
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoicePdfReducer_1.downloadInvoicePdfFailure)({
+        error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Invoice PDF download REST API call errored out ' +
+            JSON.stringify(error)),
+        invoiceId,
+    }))));
+}));
+exports.downloadInvoicePdfEpic = downloadInvoicePdfEpic;

package/lib/view/invoicing/invoicePdf/invoicePdfReducer.d.ts

@@ -0,0 +1,17 @@
+import { ID } from '../../../commonStateTypes/common';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoicingInvoicePdfState } from './invoicePdfState';
+export interface DownloadInvoicePdfPayload {
+    invoiceId: ID;
+    /** Optional download file name; defaults to `{invoiceId}.pdf`. */
+    fileName?: string;
+}
+export declare const initialState: InvoicingInvoicePdfState;
+export declare const downloadInvoicePdf: import("@reduxjs/toolkit").ActionCreatorWithPayload<DownloadInvoicePdfPayload, "invoicingInvoicePdf/downloadInvoicePdf">, downloadInvoicePdfSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    invoiceId: ID;
+}, "invoicingInvoicePdf/downloadInvoicePdfSuccess">, downloadInvoicePdfFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    error: ZeniAPIStatus;
+    invoiceId: ID;
+}, "invoicingInvoicePdf/downloadInvoicePdfFailure">, clearAllInvoicingInvoicePdf: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingInvoicePdf/clearAllInvoicingInvoicePdf">;
+declare const _default: import("redux").Reducer<InvoicingInvoicePdfState>;
+export default _default;

package/lib/view/invoicing/invoicePdf/invoicePdfReducer.js

@@ -0,0 +1,37 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearAllInvoicingInvoicePdf = exports.downloadInvoicePdfFailure = exports.downloadInvoicePdfSuccess = exports.downloadInvoicePdf = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+exports.initialState = {
+    byInvoiceId: {},
+};
+const invoicePdf = (0, toolkit_1.createSlice)({
+    name: 'invoicingInvoicePdf',
+    initialState: exports.initialState,
+    reducers: {
+        downloadInvoicePdf(draft, action) {
+            draft.byInvoiceId[action.payload.invoiceId] = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        downloadInvoicePdfSuccess(draft, action) {
+            draft.byInvoiceId[action.payload.invoiceId] = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        downloadInvoicePdfFailure(draft, action) {
+            draft.byInvoiceId[action.payload.invoiceId] = {
+                fetchState: 'Error',
+                error: action.payload.error,
+            };
+        },
+        clearAllInvoicingInvoicePdf(draft) {
+            draft.byInvoiceId = {};
+        },
+    },
+});
+_a = invoicePdf.actions, exports.downloadInvoicePdf = _a.downloadInvoicePdf, exports.downloadInvoicePdfSuccess = _a.downloadInvoicePdfSuccess, exports.downloadInvoicePdfFailure = _a.downloadInvoicePdfFailure, exports.clearAllInvoicingInvoicePdf = _a.clearAllInvoicingInvoicePdf;
+exports.default = invoicePdf.reducer;

package/lib/view/invoicing/invoicePdf/invoicePdfSelector.d.ts

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

package/lib/view/invoicing/invoicePdf/invoicePdfSelector.js

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

package/lib/view/invoicing/invoicePdf/invoicePdfState.d.ts

@@ -0,0 +1,5 @@
+import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
+/** Per-invoice PDF download fetch state keyed by invoice id. */
+export interface InvoicingInvoicePdfState {
+    byInvoiceId: Record<ID, FetchStateAndError>;
+}

package/lib/view/invoicing/invoicePdf/invoicePdfState.js

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

package/lib/view/invoicing/invoicingApiHelper.d.ts

@@ -0,0 +1,15 @@
+/** Default page size for invoicing list / infinite-scroll requests. */
+export declare const INVOICING_LIST_PAGE_SIZE = 50;
+/** Append a query string (with leading `?`) when params are present. */
+export declare const withQuery: (path: string, params: URLSearchParams) => string;
+/**
+ * Server-side sort descriptor shared by all invoicing list views. `field` is the
+ * backend sort key (validated against a per-entity whitelist); `dir` mirrors the
+ * DataListTable sort direction.
+ */
+export interface InvoicingListSort {
+    dir: 'asc' | 'desc';
+    field: string;
+}
+/** Attach `sort_field`/`sort_dir` to a list query when a sort is active. */
+export declare const applyListSortParams: (params: URLSearchParams, sort?: InvoicingListSort) => void;

package/lib/view/invoicing/invoicingApiHelper.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyListSortParams = exports.withQuery = exports.INVOICING_LIST_PAGE_SIZE = void 0;
+/** Default page size for invoicing list / infinite-scroll requests. */
+exports.INVOICING_LIST_PAGE_SIZE = 50;
+/** Append a query string (with leading `?`) when params are present. */
+const withQuery = (path, params) => {
+    const qs = params.toString();
+    return qs.length > 0 ? `${path}?${qs}` : path;
+};
+exports.withQuery = withQuery;
+/** Attach `sort_field`/`sort_dir` to a list query when a sort is active. */
+const applyListSortParams = (params, sort) => {
+    if (sort != null && sort.field !== '') {
+        params.set('sort_field', sort.field);
+        params.set('sort_dir', sort.dir);
+    }
+};
+exports.applyListSortParams = applyListSortParams;

package/lib/view/invoicing/invoicingCustomerDetailView/fetchInvoicingCustomerDetailEpic.d.ts

@@ -0,0 +1,8 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateInvoicingCustomers } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { fetchInvoicingCustomerDetail, updateInvoicingCustomerDetail, updateInvoicingCustomerDetailFailure } from './invoicingCustomerDetailViewReducer';
+export type ActionType = ReturnType<typeof fetchInvoicingCustomerDetail> | ReturnType<typeof updateInvoicingCustomerDetail> | ReturnType<typeof updateInvoicingCustomerDetailFailure> | ReturnType<typeof updateInvoicingCustomers>;
+export declare const fetchInvoicingCustomerDetailEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/invoicing/invoicingCustomerDetailView/fetchInvoicingCustomerDetailEpic.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoicingCustomerDetailEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const invoicingCustomerReducer_1 = require("../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer");
+const responsePayload_1 = require("../../../responsePayload");
+const invoicingCustomerDetailViewReducer_1 = require("./invoicingCustomerDetailViewReducer");
+const fetchInvoicingCustomerDetailEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoicingCustomerDetailViewReducer_1.fetchInvoicingCustomerDetail.match), (0, operators_1.switchMap)((action) => {
+    const { id } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/customers/${id}`;
+    return zeniAPI.getJSON(apiUrl).pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return [
+                (0, invoicingCustomerReducer_1.updateInvoicingCustomers)([response.data], 'merge'),
+                (0, invoicingCustomerDetailViewReducer_1.updateInvoicingCustomerDetail)({ id: response.data.id }),
+            ];
+        }
+        return (0, rxjs_1.of)((0, invoicingCustomerDetailViewReducer_1.updateInvoicingCustomerDetailFailure)({ id, status: response.status }));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoicingCustomerDetailViewReducer_1.updateInvoicingCustomerDetailFailure)({
+        id,
+        status: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch customer detail REST API call errored out ' +
+            JSON.stringify(error)),
+    }))));
+}));
+exports.fetchInvoicingCustomerDetailEpic = fetchInvoicingCustomerDetailEpic;

package/lib/view/invoicing/invoicingCustomerDetailView/fetchInvoicingCustomerDetailPageEpic.d.ts

@@ -0,0 +1,18 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../reducer';
+import { fetchInvoiceList } from '../invoiceList/invoiceListReducer';
+import { fetchInvoicingSettings } from '../settingsView/settingsViewReducer';
+import { fetchInvoicingCustomerDetail, fetchInvoicingCustomerDetailPage } from './invoicingCustomerDetailViewReducer';
+/**
+ * Aggregate of every action emitted across the customer detail page epic.
+ * Wired into the root action union for this view.
+ */
+export type ActionType = ReturnType<typeof fetchInvoicingCustomerDetail> | ReturnType<typeof fetchInvoicingCustomerDetailPage> | ReturnType<typeof fetchInvoiceList> | ReturnType<typeof fetchInvoicingSettings>;
+/**
+ * Orchestrates the customer detail page: on `fetchInvoicingCustomerDetailPage`,
+ * fans out to the customer detail, the customer's invoice list and the invoicing
+ * settings, skipping any whose data is already cached unless `cacheOverride` is
+ * set (e.g. on a manual refresh).
+ */
+export declare const fetchInvoicingCustomerDetailPageEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>) => Observable<ActionType>;

package/lib/view/invoicing/invoicingCustomerDetailView/fetchInvoicingCustomerDetailPageEpic.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoicingCustomerDetailPageEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const invoiceListReducer_1 = require("../invoiceList/invoiceListReducer");
+const settingsViewReducer_1 = require("../settingsView/settingsViewReducer");
+const invoicingCustomerDetailViewReducer_1 = require("./invoicingCustomerDetailViewReducer");
+/**
+ * Fetch unless the endpoint is already loaded or in flight — or always when the
+ * caller forces a refresh via `cacheOverride` (e.g. on a manual refresh).
+ */
+const shouldFetch = (fetchStateAndError, cacheOverride) => cacheOverride ||
+    (fetchStateAndError.fetchState !== 'Completed' &&
+        fetchStateAndError.fetchState !== 'In-Progress');
+/**
+ * Orchestrates the customer detail page: on `fetchInvoicingCustomerDetailPage`,
+ * fans out to the customer detail, the customer's invoice list and the invoicing
+ * settings, skipping any whose data is already cached unless `cacheOverride` is
+ * set (e.g. on a manual refresh).
+ */
+const fetchInvoicingCustomerDetailPageEpic = (actions$, state$) => actions$.pipe((0, operators_1.filter)(invoicingCustomerDetailViewReducer_1.fetchInvoicingCustomerDetailPage.match), (0, operators_1.mergeMap)((action) => {
+    const { cacheOverride, id } = action.payload;
+    const customerDetail = state$.value.invoicingCustomerDetailViewState.detailById[id];
+    const invoiceListState = state$.value.invoicingInvoiceListState;
+    const settingsState = state$.value.invoicingSettingsViewState;
+    const pageActions = [];
+    if (shouldFetch({
+        fetchState: customerDetail?.fetchState ?? 'Not-Started',
+        error: customerDetail?.error,
+    }, cacheOverride)) {
+        pageActions.push((0, invoicingCustomerDetailViewReducer_1.fetchInvoicingCustomerDetail)({ id }));
+    }
+    if (shouldFetch({
+        fetchState: invoiceListState.fetchState,
+        error: invoiceListState.error,
+    }, cacheOverride)) {
+        pageActions.push((0, invoiceListReducer_1.fetchInvoiceList)({ filters: { customerId: id } }));
+    }
+    if (shouldFetch({ fetchState: settingsState.fetchState, error: settingsState.error }, cacheOverride)) {
+        pageActions.push((0, settingsViewReducer_1.fetchInvoicingSettings)());
+    }
+    return (0, rxjs_1.concat)((0, rxjs_1.from)(pageActions));
+}));
+exports.fetchInvoicingCustomerDetailPageEpic = fetchInvoicingCustomerDetailPageEpic;

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewPayload.d.ts

@@ -0,0 +1,3 @@
+import { InvoicingCustomerPayload } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerPayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+export type InvoicingCustomerDetailResponse = ZeniAPIResponse<InvoicingCustomerPayload>;

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewPayload.js

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

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewReducer.d.ts

@@ -0,0 +1,22 @@
+import { FetchState, ID } from '../../../commonStateTypes/common';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoicingCustomerDetail, InvoicingCustomerDetailViewState } from './invoicingCustomerDetailViewState';
+export declare const initialState: InvoicingCustomerDetailViewState;
+/** Build a per-customer detail fetch-state entry. */
+export declare function buildInvoicingCustomerDetail(id: ID, fetchState: FetchState, error?: ZeniAPIStatus): InvoicingCustomerDetail;
+export declare const fetchInvoicingCustomerDetail: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    id: ID;
+}, "invoicingCustomerDetailView/fetchInvoicingCustomerDetail">, fetchInvoicingCustomerDetailPage: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: {
+    id: ID;
+    cacheOverride?: boolean;
+}], {
+    cacheOverride: boolean;
+    id: string;
+}, "invoicingCustomerDetailView/fetchInvoicingCustomerDetailPage", never, never>, updateInvoicingCustomerDetail: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    id: ID;
+}, "invoicingCustomerDetailView/updateInvoicingCustomerDetail">, updateInvoicingCustomerDetailFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    id: ID;
+    status: ZeniAPIStatus;
+}, "invoicingCustomerDetailView/updateInvoicingCustomerDetailFailure">, clearInvoicingCustomerDetailView: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingCustomerDetailView/clearInvoicingCustomerDetailView">;
+declare const _default: import("redux").Reducer<InvoicingCustomerDetailViewState>;
+export default _default;

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewReducer.js

@@ -0,0 +1,56 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearInvoicingCustomerDetailView = exports.updateInvoicingCustomerDetailFailure = exports.updateInvoicingCustomerDetail = exports.fetchInvoicingCustomerDetailPage = exports.fetchInvoicingCustomerDetail = exports.initialState = void 0;
+exports.buildInvoicingCustomerDetail = buildInvoicingCustomerDetail;
+const toolkit_1 = require("@reduxjs/toolkit");
+exports.initialState = {
+    detailById: {},
+};
+/**
+ * Shared `hasValidState` implementation so every `detailById` entry references
+ * the same function (keeps entries reference-stable for equality checks).
+ */
+function hasCompletedFetch() {
+    return this.fetchState === 'Completed';
+}
+/** Build a per-customer detail fetch-state entry. */
+function buildInvoicingCustomerDetail(id, fetchState, error) {
+    return { id, fetchState, error, hasValidState: hasCompletedFetch };
+}
+const invoicingCustomerDetailView = (0, toolkit_1.createSlice)({
+    name: 'invoicingCustomerDetailView',
+    initialState: exports.initialState,
+    reducers: {
+        fetchInvoicingCustomerDetail(draft, action) {
+            const { id } = action.payload;
+            draft.detailById[id] = buildInvoicingCustomerDetail(id, 'In-Progress');
+        },
+        fetchInvoicingCustomerDetailPage: {
+            reducer() {
+                // Orchestrator trigger only — the individual fetches own the state.
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        cacheOverride: payload.cacheOverride ?? false,
+                        id: payload.id,
+                    },
+                };
+            },
+        },
+        updateInvoicingCustomerDetail(draft, action) {
+            const { id } = action.payload;
+            draft.detailById[id] = buildInvoicingCustomerDetail(id, 'Completed');
+        },
+        updateInvoicingCustomerDetailFailure(draft, action) {
+            const { id, status } = action.payload;
+            draft.detailById[id] = buildInvoicingCustomerDetail(id, 'Error', status);
+        },
+        clearInvoicingCustomerDetailView(draft) {
+            draft.detailById = {};
+        },
+    },
+});
+_a = invoicingCustomerDetailView.actions, exports.fetchInvoicingCustomerDetail = _a.fetchInvoicingCustomerDetail, exports.fetchInvoicingCustomerDetailPage = _a.fetchInvoicingCustomerDetailPage, exports.updateInvoicingCustomerDetail = _a.updateInvoicingCustomerDetail, exports.updateInvoicingCustomerDetailFailure = _a.updateInvoicingCustomerDetailFailure, exports.clearInvoicingCustomerDetailView = _a.clearInvoicingCustomerDetailView;
+exports.default = invoicingCustomerDetailView.reducer;

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewSelector.d.ts

@@ -0,0 +1,25 @@
+import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
+import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { InvoicingInvoice } from '../../../entity/invoicing/invoice/invoicePayload';
+import { InvoicingCustomer } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerState';
+import { RootState } from '../../../reducer';
+import { InvoicingSetupIntent } from '../customerPaymentMethod/customerPaymentMethodState';
+/**
+ * Read-only view for the customer detail page: the customer entity + its fetch
+ * state, plus everything the page renders in view mode — recent invoices, the
+ * Add-Payment-Method dialog state (setup intent / Plaid token / save), the
+ * payment-link send state, and whether Stripe is connected. Lets the detail
+ * screen depend on this single read selector.
+ */
+export interface InvoicingCustomerDetailView extends SelectorView {
+    invoices: InvoicingInvoice[];
+    paymentMethodSaveState: FetchStateAndError;
+    sendLinkState: FetchStateAndError;
+    setupIntentFetchState: FetchStateAndError;
+    stripeConnected: boolean;
+    invoicingCustomer?: InvoicingCustomer;
+    plaidLinkToken?: string;
+    sentPaymentLinkEmail?: string;
+    setupIntent?: InvoicingSetupIntent;
+}
+export declare const getInvoicingCustomerDetail: (state: RootState, invoicingCustomerID: ID) => InvoicingCustomerDetailView;

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewSelector.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingCustomerDetail = void 0;
+const get_1 = __importDefault(require("lodash/get"));
+const invoicingCustomerSelector_1 = require("../../../entity/invoicing/invoicingCustomer/invoicingCustomerSelector");
+const customerPaymentMethodSelector_1 = require("../customerPaymentMethod/customerPaymentMethodSelector");
+const invoiceListSelector_1 = require("../invoiceList/invoiceListSelector");
+const settingsViewSelector_1 = require("../settingsView/settingsViewSelector");
+const getInvoicingCustomerDetail = (state, invoicingCustomerID) => {
+    const { invoicingCustomerState, invoicingCustomerDetailViewState } = state;
+    const invoicingCustomerDetail = (0, get_1.default)(invoicingCustomerDetailViewState.detailById, invoicingCustomerID, undefined);
+    const settings = (0, settingsViewSelector_1.getInvoicingSettings)(state);
+    return {
+        invoicingCustomer: (0, invoicingCustomerSelector_1.getInvoicingCustomerById)(invoicingCustomerState, invoicingCustomerID),
+        invoices: (0, invoiceListSelector_1.getInvoiceListItems)(state),
+        setupIntent: (0, customerPaymentMethodSelector_1.getInvoicingSetupIntent)(state),
+        setupIntentFetchState: (0, customerPaymentMethodSelector_1.getInvoicingSetupIntentFetchState)(state),
+        plaidLinkToken: (0, customerPaymentMethodSelector_1.getInvoicingPlaidLinkToken)(state),
+        paymentMethodSaveState: (0, customerPaymentMethodSelector_1.getInvoicingPaymentMethodSaveState)(state),
+        sendLinkState: (0, customerPaymentMethodSelector_1.getInvoicingPaymentLinkSendState)(state),
+        sentPaymentLinkEmail: (0, customerPaymentMethodSelector_1.getInvoicingSentPaymentLinkEmail)(state),
+        stripeConnected: settings?.stripe_connected_account_id != null &&
+            settings.stripe_connected_account_id !== '',
+        fetchState: invoicingCustomerDetail?.fetchState ?? 'Not-Started',
+        error: invoicingCustomerDetail?.error,
+        version: 1.0,
+    };
+};
+exports.getInvoicingCustomerDetail = getInvoicingCustomerDetail;

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewState.d.ts

@@ -0,0 +1,7 @@
+import { FetchedState, ID } from '../../../commonStateTypes/common';
+export interface InvoicingCustomerDetailViewState {
+    detailById: Record<ID, InvoicingCustomerDetail>;
+}
+export interface InvoicingCustomerDetail extends FetchedState {
+    id: ID;
+}

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewState.js

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

package/lib/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerCountsEpic.d.ts

@@ -0,0 +1,7 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../../reducer';
+import { ZeniAPI } from '../../../../zeniAPI';
+import { fetchInvoicingCustomerCounts, updateInvoicingCustomerCounts, updateInvoicingCustomerCountsFailure } from '../invoicingCustomerListViewReducer';
+export type ActionType = ReturnType<typeof fetchInvoicingCustomerCounts> | ReturnType<typeof updateInvoicingCustomerCounts> | ReturnType<typeof updateInvoicingCustomerCountsFailure>;
+export declare const fetchInvoicingCustomerCountsEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerCountsEpic.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoicingCustomerCountsEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../../responsePayload");
+const invoicingApiHelper_1 = require("../../invoicingApiHelper");
+const invoicingCustomerListViewReducer_1 = require("../invoicingCustomerListViewReducer");
+const fetchInvoicingCustomerCountsEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoicingCustomerListViewReducer_1.fetchInvoicingCustomerCounts.match), (0, operators_1.switchMap)(() => {
+    const { filters } = state$.value.invoicingCustomerListViewState;
+    const params = new URLSearchParams();
+    if (filters.search != null && filters.search.length > 0) {
+        params.set('search', filters.search);
+    }
+    const apiUrl = (0, invoicingApiHelper_1.withQuery)(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/customers/counts`, params);
+    return zeniAPI.getJSON(apiUrl).pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return (0, rxjs_1.of)((0, invoicingCustomerListViewReducer_1.updateInvoicingCustomerCounts)(response.data));
+        }
+        return (0, rxjs_1.of)((0, invoicingCustomerListViewReducer_1.updateInvoicingCustomerCountsFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoicingCustomerListViewReducer_1.updateInvoicingCustomerCountsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch customer counts REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.fetchInvoicingCustomerCountsEpic = fetchInvoicingCustomerCountsEpic;

package/lib/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerListEpic.d.ts

@@ -0,0 +1,8 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateInvoicingCustomers } from '../../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { RootState } from '../../../../reducer';
+import { ZeniAPI } from '../../../../zeniAPI';
+import { fetchInvoicingCustomerList, updateInvoicingCustomerList, updateInvoicingCustomerListFailure } from '../invoicingCustomerListViewReducer';
+export type ActionType = ReturnType<typeof fetchInvoicingCustomerList> | ReturnType<typeof updateInvoicingCustomerList> | ReturnType<typeof updateInvoicingCustomerListFailure> | ReturnType<typeof updateInvoicingCustomers>;
+export declare const fetchInvoicingCustomerListEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerListEpic.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoicingCustomerListEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const invoicingCustomerReducer_1 = require("../../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer");
+const responsePayload_1 = require("../../../../responsePayload");
+const invoicingApiHelper_1 = require("../../invoicingApiHelper");
+const invoicingCustomerListViewReducer_1 = require("../invoicingCustomerListViewReducer");
+const buildQuery = (filters, cursor, sort) => {
+    const params = new URLSearchParams();
+    if (filters.search != null && filters.search.length > 0) {
+        params.set('search', filters.search);
+    }
+    if (filters.status != null && filters.status.length > 0) {
+        params.set('status', filters.status);
+    }
+    params.set('limit', String(invoicingApiHelper_1.INVOICING_LIST_PAGE_SIZE));
+    if (cursor != null) {
+        params.set('cursor', cursor);
+    }
+    (0, invoicingApiHelper_1.applyListSortParams)(params, sort);
+    return params;
+};
+const fetchInvoicingCustomerListEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoicingCustomerListViewReducer_1.fetchInvoicingCustomerList.match), (0, operators_1.switchMap)((action) => {
+    const { filters, cursor, keepExistingListItems, sort } = action.payload;
+    const apiUrl = (0, invoicingApiHelper_1.withQuery)(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/customers`, buildQuery(filters, cursor, sort));
+    return zeniAPI.getJSON(apiUrl).pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response)) {
+            const items = response.data?.items ?? [];
+            return [
+                (0, invoicingCustomerReducer_1.updateInvoicingCustomers)(items, 'merge'),
+                (0, invoicingCustomerListViewReducer_1.updateInvoicingCustomerList)({
+                    ids: items.map((item) => item.id),
+                    nextCursor: response.data?.next_cursor ?? null,
+                    keepExistingListItems,
+                }),
+            ];
+        }
+        return (0, rxjs_1.of)((0, invoicingCustomerListViewReducer_1.updateInvoicingCustomerListFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoicingCustomerListViewReducer_1.updateInvoicingCustomerListFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch customer list REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.fetchInvoicingCustomerListEpic = fetchInvoicingCustomerListEpic;

package/lib/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerListPageEpic.d.ts

@@ -0,0 +1,16 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateInvoicingCustomers } from '../../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { RootState } from '../../../../reducer';
+import { fetchInvoicingCustomerCounts, fetchInvoicingCustomerList, fetchInvoicingCustomerListPage, updateInvoicingCustomerCounts, updateInvoicingCustomerCountsFailure, updateInvoicingCustomerList, updateInvoicingCustomerListFailure } from '../invoicingCustomerListViewReducer';
+/**
+ * Aggregate of every action emitted across the customer list view epics.
+ * Wired into the root action union for this view.
+ */
+export type ActionType = ReturnType<typeof fetchInvoicingCustomerList> | ReturnType<typeof fetchInvoicingCustomerListPage> | ReturnType<typeof fetchInvoicingCustomerCounts> | ReturnType<typeof updateInvoicingCustomerList> | ReturnType<typeof updateInvoicingCustomerListFailure> | ReturnType<typeof updateInvoicingCustomerCounts> | ReturnType<typeof updateInvoicingCustomerCountsFailure> | ReturnType<typeof updateInvoicingCustomers>;
+/**
+ * Orchestrates the customers list page: on `fetchInvoicingCustomerListPage`,
+ * fans out to the list and counts fetches, skipping either one whose data is
+ * already cached unless `cacheOverride` is set (e.g. on a filter/sort change).
+ */
+export declare const fetchInvoicingCustomerListPageEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>) => Observable<ActionType>;

package/lib/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerListPageEpic.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoicingCustomerListPageEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const invoicingCustomerListViewReducer_1 = require("../invoicingCustomerListViewReducer");
+/**
+ * Fetch unless the endpoint is already loaded or in flight — or always when the
+ * caller forces a refresh via `cacheOverride` (e.g. on a filter/sort change).
+ */
+const shouldFetch = (fetchStateAndError, cacheOverride) => cacheOverride ||
+    (fetchStateAndError.fetchState !== 'Completed' &&
+        fetchStateAndError.fetchState !== 'In-Progress');
+/**
+ * Orchestrates the customers list page: on `fetchInvoicingCustomerListPage`,
+ * fans out to the list and counts fetches, skipping either one whose data is
+ * already cached unless `cacheOverride` is set (e.g. on a filter/sort change).
+ */
+const fetchInvoicingCustomerListPageEpic = (actions$, state$) => actions$.pipe((0, operators_1.filter)(invoicingCustomerListViewReducer_1.fetchInvoicingCustomerListPage.match), (0, operators_1.mergeMap)((action) => {
+    const { cacheOverride, filters, sort } = action.payload;
+    const state = state$.value.invoicingCustomerListViewState;
+    const pageActions = [];
+    if (shouldFetch({ fetchState: state.fetchState, error: state.error }, cacheOverride)) {
+        pageActions.push((0, invoicingCustomerListViewReducer_1.fetchInvoicingCustomerList)({ filters, sort }));
+    }
+    if (shouldFetch(state.countsFetchState, cacheOverride)) {
+        pageActions.push((0, invoicingCustomerListViewReducer_1.fetchInvoicingCustomerCounts)());
+    }
+    return (0, rxjs_1.concat)((0, rxjs_1.from)(pageActions));
+}));
+exports.fetchInvoicingCustomerListPageEpic = fetchInvoicingCustomerListPageEpic;

package/lib/view/invoicing/invoicingCustomerListView/invoicingCustomerListViewPayload.d.ts

@@ -0,0 +1,5 @@
+import { InvoicingListCounts, InvoicingPaginatedList } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingCustomerPayload } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerPayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+export type InvoicingCustomerListResponse = ZeniAPIResponse<InvoicingPaginatedList<InvoicingCustomerPayload>>;
+export type InvoicingCustomerCountsResponse = ZeniAPIResponse<InvoicingListCounts>;

package/lib/view/invoicing/invoicingCustomerListView/invoicingCustomerListViewPayload.js

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