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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,50 @@
+import { getFormattedAddress } from '../../addressView/addressViewSelector';
+import { INVOICING_BUSINESS_ADDRESS_TYPE, entityToInvoicingBrandingFormLocalData, } 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 const getInvoicingSettings = (state) => state.invoicingSettingsViewState.settings;
+/**
+ * Shared primitive: the settings fetch state. Consumed internally by the
+ * invoicing overview selector/epic for `shouldFetch` gating — kept standalone.
+ */
+export const getInvoicingSettingsFetchState = (state) => ({
+    fetchState: state.invoicingSettingsViewState.fetchState,
+    error: state.invoicingSettingsViewState.error,
+});
+/**
+ * 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 const getInvoicingSettingsView = (state) => {
+    const { error, fetchState, saveFetchState, settings, stripeFetchState } = state.invoicingSettingsViewState;
+    return {
+        error,
+        fetchState,
+        saveState: saveFetchState,
+        settings,
+        stripeConnectState: stripeFetchState,
+    };
+};
+/**
+ * Bundled view for the branding settings form: the draft `localData` (seeded
+ * from the existing settings until the user edits), the business-address label
+ * (from the shared Address screen, seeded on load from `address_id`), the raw
+ * settings (for the logo/preview) and the save fetch state.
+ */
+export const getInvoicingBrandingFormView = (state) => {
+    const { brandingDraft, saveFetchState, settings } = state.invoicingSettingsViewState;
+    const newAddress = state.addressViewState.newAddressState?.[INVOICING_BUSINESS_ADDRESS_TYPE];
+    const addressLabel = newAddress?.addressToCreate != null
+        ? getFormattedAddress(newAddress.addressToCreate)
+        : undefined;
+    return {
+        addressLabel,
+        localData: brandingDraft ?? entityToInvoicingBrandingFormLocalData(settings),
+        saveState: saveFetchState,
+        settings,
+    };
+};

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,5 @@
+const NOT_STARTED = {
+    fetchState: 'Not-Started',
+    error: undefined,
+};
+export const getInvoicingSubscriptionActionState = (id) => (state) => state.invoicingSubscriptionActionState.byId[id] ?? NOT_STARTED;

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

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

package/lib/esm/view/notificationPreferencesView/epics/saveNotificationPreferencesEpic.js

@@ -0,0 +1,116 @@
+import { EMPTY, concat, of } from 'rxjs';
+import { catchError, debounceTime, filter, finalize, mergeMap, switchMap, takeUntil, withLatestFrom, } from 'rxjs/operators';
+import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
+import { notificationPreferencesUrl } from '../notificationPreferencesEndpoint';
+import { mapPreferencesToPayload, } from '../notificationPreferencesViewPayload';
+import { clearAllNotificationPreferencesView, clearNotificationPreferencesLocalOverrides, saveNotificationPreferences, saveNotificationPreferencesFailure, saveNotificationPreferencesSuccess, setGroupFrequency, toggleEventChannel, } from '../notificationPreferencesViewReducer';
+import { getNotificationLocalOverrides } from '../notificationPreferencesViewSelector';
+const DEBOUNCE_MS = 300;
+export const saveNotificationPreferencesEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter((action) => toggleEventChannel.match(action) || setGroupFrequency.match(action)), 
+// Coalesce bursts of toggles into a single PUT. Trade-off: rapid clickers
+// defer saves until they pause. Consider a max-wait wrapper if this
+// becomes a UX problem.
+debounceTime(DEBOUNCE_MS), withLatestFrom(state$), 
+// `switchMap` unsubscribes from any in-flight PUT observable when a new
+// debounced batch fires. The prior HTTP request has already left the
+// client — the network call is NOT cancelled — but its response is
+// ignored, so stale success/failure actions cannot clobber the newer
+// batch's state. Server-side ordering is arrival-order LWW.
+switchMap(([, state]) => {
+    const overrides = getNotificationLocalOverrides(state);
+    const preferencesPatch = mapPreferencesToPayload(overrides);
+    if (Object.keys(preferencesPatch).length === 0) {
+        // No diff → do not dispatch a synthetic success (that would wipe
+        // stored preferences via the reducer). Simply no-op.
+        return EMPTY;
+    }
+    // Snapshot the Cancel epoch at PUT-dispatch time. Every Cancel bumps
+    // `cancelEpoch`; the reducer compares the captured value on Success/
+    // Failure and skips the merge when the value has advanced (user
+    // pressed Cancel since this save started). See Cursor Bugbot 4aa021f7
+    // — the earlier counter model failed when `switchMap` abandoned an
+    // in-flight save's response (Success/Failure never dispatched, so
+    // the counter never drained and future saves got their merge dropped).
+    const cancelEpochAtDispatch = state.notificationPreferencesViewState.cancelEpoch;
+    const body = { task_checklist_preferences: preferencesPatch };
+    // Suppress the error snackbar when the response lands AFTER the user
+    // pressed Cancel — the Failure reducer already swallows the state
+    // update, so the toast would be a stale error for a save the user
+    // abandoned. `StateObservable#value` reads the current cancelEpoch at
+    // response time (not at dispatch time — that's what
+    // `cancelEpochAtDispatch` captures). Cursor Bugbot da2f4fe2 + Nikunj.
+    const errorSnackbar = openSnackbar({
+        messageSection: 'notification_settings_saved',
+        messageText: 'failed',
+        type: 'error',
+    });
+    const isCancelledSince = () => cancelEpochAtDispatch <
+        state$.value.notificationPreferencesViewState.cancelEpoch;
+    // Abort the in-flight HTTP request when `switchMap` disposes this
+    // observable (new debounced batch fires, tenant switch, unmount).
+    // Without an AbortSignal, `switchMap` would drop the response
+    // client-side but the older PUT would still land on the server —
+    // under patch-semantic LWW, a slower older PUT arriving after a
+    // newer one silently reverts the user's latest choice on the
+    // server. Cursor Bugbot e3861a76. `AbortController.abort()` is
+    // idempotent so it's safe if the request already completed.
+    const controller = new AbortController();
+    const request$ = zeniAPI
+        .putAndGetJSON(notificationPreferencesUrl(zeniAPI), body, undefined, controller.signal)
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response)) {
+            return of(saveNotificationPreferencesSuccess({
+                cancelEpochAtDispatch,
+                savedOverrides: overrides,
+                serverEcho: response.data?.task_checklist_preferences,
+            }));
+        }
+        const actions = [
+            saveNotificationPreferencesFailure({
+                cancelEpochAtDispatch,
+                error: response.status,
+            }),
+        ];
+        if (!isCancelledSince()) {
+            // Surface a user-visible error — without it the UI reverts to
+            // server truth after debounce and the failed toggle looks like
+            // a mystery UI bug.
+            actions.push(errorSnackbar);
+        }
+        return of(...actions);
+    }), catchError((error) => {
+        const actions = [
+            saveNotificationPreferencesFailure({
+                cancelEpochAtDispatch,
+                error: createZeniAPIStatus('Unexpected Error', 'Save notification preferences failed: ' +
+                    JSON.stringify(error)),
+            }),
+        ];
+        if (!isCancelledSince()) {
+            actions.push(errorSnackbar);
+        }
+        return of(...actions);
+    }), finalize(() => {
+        // switchMap disposal (new batch fires, unmount) OR the takeUntil
+        // below (Cancel fires) → abort the still-in-flight HTTP request.
+        // No-op if the request has already completed successfully or
+        // errored. Without this, the pre-Cancel PUT would still land on
+        // the server; under patch-semantic LWW, a slower older PUT
+        // arriving after Cancel silently reverts the user's just-cleared
+        // overrides on the server.
+        controller.abort();
+    }), 
+    // Cancel and tenant-switch/logout do not flow through the outer
+    // `filter`, so switchMap would never dispose this observable on
+    // either. `takeUntil` completes request$ on Cancel OR clear-all,
+    // which triggers finalize above (aborts the in-flight HTTP
+    // request). Without matching clear-all, a tenant switch during
+    // an in-flight PUT would let the older PUT land on the server
+    // under patch-semantic LWW. Cursor Bugbot 3637969823 + 3641372002.
+    takeUntil(actions$.pipe(filter((action) => clearNotificationPreferencesLocalOverrides.match(action) ||
+        clearAllNotificationPreferencesView.match(action)))));
+    // Flip savePreferencesState to In-Progress BEFORE the network call so
+    // any "saving…" UI can render.
+    return concat(of(saveNotificationPreferences()), request$);
+}));

package/lib/esm/view/notificationPreferencesView/notificationPreferencesEndpoint.js

@@ -0,0 +1,5 @@
+// Shared endpoint used by both the GET (envelope refresh in
+// `fetchNotificationSettingsEpic`) and the PUT (patch in
+// `saveNotificationPreferencesEpic`). Kept as a helper so an endpoint rename
+// can't drift between the two callers.
+export const notificationPreferencesUrl = (zeniAPI) => `${zeniAPI.apiEndPoints.notificationMicroServiceBaseUrl}/1.0/notification-preferences`;

package/lib/esm/view/notificationPreferencesView/notificationPreferencesViewPayload.js

@@ -0,0 +1,36 @@
+import { toNotificationChannel, toNotificationFrequency, } from '../../entity/notificationRegistry/notificationRegistryState';
+const mapEventEnabledByChannel = (raw) => {
+    if (raw == null) {
+        return {};
+    }
+    const out = {};
+    Object.entries(raw).forEach(([eventId, channelMap]) => {
+        const mapped = {};
+        Object.entries(channelMap).forEach(([channel, enabled]) => {
+            mapped[toNotificationChannel(channel)] = enabled;
+        });
+        out[eventId] = mapped;
+    });
+    return out;
+};
+export const mapPayloadToPreferences = (payload) => {
+    const groupFrequencyRaw = payload?.group_frequency_by_group_id ?? {};
+    const groupFrequencyByGroupId = Object.fromEntries(Object.entries(groupFrequencyRaw).map(([groupId, frequency]) => [
+        groupId,
+        toNotificationFrequency(frequency),
+    ]));
+    return {
+        eventEnabledByChannel: mapEventEnabledByChannel(payload?.event_enabled_by_channel),
+        groupFrequencyByGroupId,
+    };
+};
+export const mapPreferencesToPayload = (preferences) => {
+    const payload = {};
+    if (Object.keys(preferences.eventEnabledByChannel).length > 0) {
+        payload.event_enabled_by_channel = preferences.eventEnabledByChannel;
+    }
+    if (Object.keys(preferences.groupFrequencyByGroupId).length > 0) {
+        payload.group_frequency_by_group_id = preferences.groupFrequencyByGroupId;
+    }
+    return payload;
+};