@zeniai/client-epic-state 5.0.82-betaAS1 → 5.0.83-betaRR0

package/lib/view/spendManagement/chargeCards/cardPolicy/createCardPolicy/createCardPolicyState.d.ts

@@ -0,0 +1,45 @@
+import { FetchStateAndError, ID } from '../../../../../commonStateTypes/common';
+import { BulkCreateCardPolicyTemplateError } from '../../../../../entity/cardPolicy/cardPolicyPayload';
+/**
+ * View-side scaffolding for the Card Policy "create" flow.
+ *
+ * `POST /cards/1.0/policy-templates` is now a bulk endpoint — both the
+ * manual create page and the AI CFO submit pass an array of templates
+ * (single-element today; multi-element when AI CFO multi-policy review
+ * lands). The slice tracks one request lifecycle for the whole submit
+ * and captures the per-template ids + errors on success.
+ *
+ * List + edit lifecycles live in sibling slices (`cardPolicyList`,
+ * `cardPolicyDetail`); MCC categories used by the create form live on
+ * the entity slice (shared with the AI-CFO flow) and are fetched via the
+ * co-located `fetchCardPolicyMccCategoriesEpic`.
+ */
+export interface CreateCardPolicyState {
+    createCardPolicyTemplateRequestState: FetchStateAndError;
+    /**
+     * Per-item failures returned alongside `templates_created` on the bulk
+     * response. Empty on full success; populated on partial success so the
+     * UI can render a "N of M created" banner. Cleared when a new submit
+     * starts and by `clearCreateCardPolicy`.
+     */
+    lastCreateCardPolicyTemplateErrors: BulkCreateCardPolicyTemplateError[];
+    /**
+     * `templateId`s of the templates created by the most recent successful
+     * bulk submit, in the order they were returned by the BE. Empty when no
+     * submit has succeeded yet or after `clearCreateCardPolicy`.
+     *
+     * For the single-policy case this holds exactly one id; the
+     * `getLastCreatedCardPolicyTemplateId` selector returns `[0]` for
+     * ergonomic single-create routing.
+     */
+    lastCreatedCardPolicyTemplateIds: ID[];
+    /**
+     * Chat session id from `sourceChatSessionId` on the most recent
+     * `createCardPolicyTemplates` dispatch — i.e. the AI CFO conversation
+     * that triggered the bulk create. Lets the policy list and AI CFO
+     * drawer correlate an in-flight create back to its originating session.
+     * `undefined` when the most recent submit came from the manual create
+     * screen (which omits `sourceChatSessionId`).
+     */
+    lastCreateCardPolicySourceChatSessionId?: ID;
+}

package/lib/view/spendManagement/chargeCards/cardPolicy/createCardPolicy/createCardPolicyState.js

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

package/lib/view/spendManagement/chargeCards/cardPolicy/createCardPolicy/createCardPolicyTemplateEpic.d.ts

@@ -0,0 +1,25 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateCreatedCardPolicyTemplate } from '../../../../../entity/cardPolicy/cardPolicyReducer';
+import { RootState } from '../../../../../reducer';
+import { ZeniAPI } from '../../../../../zeniAPI';
+import { createCardPolicyTemplates, updateCreateCardPolicyTemplateRequestState } from './createCardPolicyReducer';
+export type ActionType = ReturnType<typeof createCardPolicyTemplates> | ReturnType<typeof updateCreatedCardPolicyTemplate> | ReturnType<typeof updateCreateCardPolicyTemplateRequestState>;
+/**
+ * `POST /cards/1.0/policy-templates` (bulk). Builds the bulk wire body
+ * from the camelCased action payload, sends one round-trip, and on
+ * success fans out:
+ *  - one `updateCreatedCardPolicyTemplate` on the entity slice per row
+ *    in `templates_created` (so the entity store is hydrated with every
+ *    created template), and
+ *  - one `updateCreateCardPolicyTemplateRequestState` with the ordered
+ *    id list + per-item errors so the view can render partial-success
+ *    UX without re-touching the wire types.
+ *
+ * Partial success (`errors.length > 0` with at least one template
+ * created) is still treated as `Completed` — the lifecycle is binary
+ * and the per-item errors live on the slice for the UI to inspect.
+ * Hard failures (non-success `status` or thrown errors) map to `Error`
+ * the same way they did pre-bulk.
+ */
+export declare const createCardPolicyTemplatesEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/spendManagement/chargeCards/cardPolicy/createCardPolicy/createCardPolicyTemplateEpic.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCardPolicyTemplatesEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const cardPolicyReducer_1 = require("../../../../../entity/cardPolicy/cardPolicyReducer");
+const cardPolicyPayload_1 = require("../../../../../entity/cardPolicy/cardPolicyPayload");
+const responsePayload_1 = require("../../../../../responsePayload");
+const createCardPolicyReducer_1 = require("./createCardPolicyReducer");
+/**
+ * `POST /cards/1.0/policy-templates` (bulk). Builds the bulk wire body
+ * from the camelCased action payload, sends one round-trip, and on
+ * success fans out:
+ *  - one `updateCreatedCardPolicyTemplate` on the entity slice per row
+ *    in `templates_created` (so the entity store is hydrated with every
+ *    created template), and
+ *  - one `updateCreateCardPolicyTemplateRequestState` with the ordered
+ *    id list + per-item errors so the view can render partial-success
+ *    UX without re-touching the wire types.
+ *
+ * Partial success (`errors.length > 0` with at least one template
+ * created) is still treated as `Completed` — the lifecycle is binary
+ * and the per-item errors live on the slice for the UI to inspect.
+ * Hard failures (non-success `status` or thrown errors) map to `Error`
+ * the same way they did pre-bulk.
+ */
+const createCardPolicyTemplatesEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(createCardPolicyReducer_1.createCardPolicyTemplates.match), (0, operators_1.mergeMap)((action) => {
+    const body = (0, cardPolicyPayload_1.toCreateCardPolicyTemplatesRequestBody)(action.payload);
+    return zeniAPI
+        .postAndGetJSON(`${zeniAPI.apiEndPoints.cardMicroServiceBaseUrl}/1.0/policy-templates`, body)
+        .pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessStatus)(response) && response.data != null) {
+            const { templates_created, errors } = response.data;
+            const createdTemplates = templates_created.map((row) => row.template);
+            const actions = [
+                ...createdTemplates.map((template) => (0, cardPolicyReducer_1.updateCreatedCardPolicyTemplate)(template)),
+                (0, createCardPolicyReducer_1.updateCreateCardPolicyTemplateRequestState)({
+                    fetchState: 'Completed',
+                    perItemErrors: (errors ?? []).map(cardPolicyPayload_1.toBulkCreateCardPolicyTemplateError),
+                    templateIds: createdTemplates.map((template) => template.template_id),
+                }),
+            ];
+            return (0, rxjs_1.from)(actions);
+        }
+        else {
+            return (0, rxjs_1.of)((0, createCardPolicyReducer_1.updateCreateCardPolicyTemplateRequestState)({
+                fetchState: 'Error',
+                error: response.status,
+            }));
+        }
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, createCardPolicyReducer_1.updateCreateCardPolicyTemplateRequestState)({
+        fetchState: 'Error',
+        error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Create card-policy templates REST API call errored out' +
+            JSON.stringify(error)),
+    }))));
+}));
+exports.createCardPolicyTemplatesEpic = createCardPolicyTemplatesEpic;

package/lib/view/spendManagement/chargeCards/cardPolicy/createCardPolicy/fetchCardPolicyMccCategoriesEpic.d.ts

@@ -0,0 +1,15 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { fetchCardPolicyMccCategories, updateCardPolicyMccCategories, updateCardPolicyMccCategoriesFailure } from '../../../../../entity/cardPolicy/cardPolicyReducer';
+import { RootState } from '../../../../../reducer';
+import { ZeniAPI } from '../../../../../zeniAPI';
+/**
+ * MCC categories are reference data shared between the manual create
+ * flow and the AI-CFO `card_policy` form. The slice fields live on the
+ * `entity/cardPolicy` slice (so any consumer can read them without
+ * re-fetching); only the fetch lifecycle lives in `createCardPolicy/`
+ * because the manual create page is currently the only producer of the
+ * `fetchCardPolicyMccCategories` action.
+ */
+export type ActionType = ReturnType<typeof fetchCardPolicyMccCategories> | ReturnType<typeof updateCardPolicyMccCategories> | ReturnType<typeof updateCardPolicyMccCategoriesFailure>;
+export declare const fetchCardPolicyMccCategoriesEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/spendManagement/chargeCards/cardPolicy/createCardPolicy/fetchCardPolicyMccCategoriesEpic.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchCardPolicyMccCategoriesEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const cardPolicyReducer_1 = require("../../../../../entity/cardPolicy/cardPolicyReducer");
+const responsePayload_1 = require("../../../../../responsePayload");
+const fetchCardPolicyMccCategoriesEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(cardPolicyReducer_1.fetchCardPolicyMccCategories.match), 
+// `exhaustMap` (rather than `mergeMap`) so a duplicate
+// `fetchCardPolicyMccCategories` dispatched while the previous one
+// is still in flight is dropped instead of producing a second HTTP
+// request. Both the Create and Edit policy screens dispatch this
+// on mount, and React 18 StrictMode invokes their mount effect
+// twice with a stale `mccCategoriesFetchState` closure — without
+// `exhaustMap` that yields two `/cards/mcc-codes` calls.
+(0, operators_1.exhaustMap)(() => {
+    return zeniAPI
+        .getJSON(`${zeniAPI.apiEndPoints.cardMicroServiceBaseUrl}/1.0/cards/mcc-codes`)
+        .pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessStatus)(response) && response.data != null) {
+            return (0, rxjs_1.from)([(0, cardPolicyReducer_1.updateCardPolicyMccCategories)(response.data)]);
+        }
+        else {
+            return (0, rxjs_1.of)((0, cardPolicyReducer_1.updateCardPolicyMccCategoriesFailure)(response.status));
+        }
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, cardPolicyReducer_1.updateCardPolicyMccCategoriesFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch card policy MCC categories REST API call errored out' +
+        JSON.stringify(error))))));
+}));
+exports.fetchCardPolicyMccCategoriesEpic = fetchCardPolicyMccCategoriesEpic;

package/lib/view/spendManagement/chargeCards/chargeCardList/chargeCardList.d.ts

@@ -61,7 +61,7 @@ export declare const initialCreditAcc: CreditAccount;
 export declare const initialDebitCardSummaries: DebitCardSummaries;
 export declare const initialResendRevokeCardInvite: ResendRevokeCardInvite;
 export declare const initialCreditAccountRepayment: CreditAccountRepayment;
-export declare const toChargeCardSortKeyType: (v: string) => "status" | "accountType" | "owner" | "cardName" | "limit" | "department" | "cardType" | "utilisation";
+export declare const toChargeCardSortKeyType: (v: string) => "status" | "department" | "accountType" | "owner" | "cardName" | "limit" | "cardType" | "utilisation";
 export declare type ChargeCardViewSortKey = ReturnType<typeof toChargeCardSortKeyType>;
 export declare const ALL_CASHBACK_SORT_KEYS: readonly ["month", "cashback"];
 export declare const toCashbackSortKeyType: (v: string) => "month" | "cashback";

package/lib/view/spendManagement/chargeCards/chargeCardList/chargeCardListSelector.d.ts

@@ -54,7 +54,21 @@ export interface MyPendingActivationChargeCardListSelectorView extends SelectorV
 export interface ChargeCardListWithShippingAddressSelectorView extends SelectorView {
     cards: ChargeCardWithUserAndShippingAddress[];
 }
+export interface AllChargeCardsWithUserSelectorView extends SelectorView {
+    cards: ChargeCardWithUser[];
+}
 export declare const getChargeCardListView: (state: RootState, includeCreditAccountDebitSummaryAndCashbackInfo: boolean, isDebitCardEnabled: boolean, isCreditCardEnabled: boolean) => ChargeCardListSelectorView;
+/**
+ * Returns every enriched `ChargeCardWithUser` for the tenant, without
+ * applying the cards-list screen's `searchText` filter or its column
+ * `sortKey/sortOrder`. Used by surfaces that need the raw card universe
+ * decoupled from whatever the user has typed/sorted on the cards list
+ * (e.g. the Card Policy "Apply to Cards" picker, which owns its own
+ * search + sort UI). The list-screen's filter/sort state is intentionally
+ * left untouched so revisits to the cards list still restore the user's
+ * search.
+ */
+export declare const getAllChargeCardsWithUser: (state: RootState) => AllChargeCardsWithUserSelectorView;
 export declare const getMyPendingActivationChargeCardListView: (state: RootState) => MyPendingActivationChargeCardListSelectorView;
 export declare const getMyRequestOnHoldChargeCardListWithShippingAddress: (state: RootState) => ChargeCardListWithShippingAddressSelectorView;
 /**

package/lib/view/spendManagement/chargeCards/chargeCardList/chargeCardListSelector.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getChargeCardBulkActionView = exports.getChargeCardRowActionView = exports.getChargeCardRecurringExpensesByCardIds = exports.getDebitCardSummary = exports.getDebitCardList = exports.getDepositAccountListWithDebitCardIssued = exports.getCreditAccountDetails = exports.anyCardOnHold = exports.getMyRequestOnHoldChargeCardListWithShippingAddress = exports.getMyPendingActivationChargeCardListView = exports.getChargeCardListView = void 0;
+exports.getChargeCardBulkActionView = exports.getChargeCardRowActionView = exports.getChargeCardRecurringExpensesByCardIds = exports.getDebitCardSummary = exports.getDebitCardList = exports.getDepositAccountListWithDebitCardIssued = exports.getCreditAccountDetails = exports.anyCardOnHold = exports.getMyRequestOnHoldChargeCardListWithShippingAddress = exports.getMyPendingActivationChargeCardListView = exports.getAllChargeCardsWithUser = exports.getChargeCardListView = void 0;
 const toolkit_1 = require("@reduxjs/toolkit");
 const orderBy_1 = __importDefault(require("lodash/orderBy"));
 const sortOrderPayload_1 = require("../../../../commonPayloadTypes/sortOrderPayload");
@@ -94,6 +94,32 @@ const getChargeCardListView = (state, includeCreditAccountDebitSummaryAndCashbac
     };
 };
 exports.getChargeCardListView = getChargeCardListView;
+/**
+ * Returns every enriched `ChargeCardWithUser` for the tenant, without
+ * applying the cards-list screen's `searchText` filter or its column
+ * `sortKey/sortOrder`. Used by surfaces that need the raw card universe
+ * decoupled from whatever the user has typed/sorted on the cards list
+ * (e.g. the Card Policy "Apply to Cards" picker, which owns its own
+ * search + sort UI). The list-screen's filter/sort state is intentionally
+ * left untouched so revisits to the cards list still restore the user's
+ * search.
+ */
+const getAllChargeCardsWithUser = (state) => {
+    const { chargeCardListState, chargeCardState, chargeCardConfigState } = state;
+    const cards = (0, chargeCardSelector_1.getChargeCardsByIds)(chargeCardState, chargeCardListState.cardIds);
+    const chargeCardsWithUser = getChargeCardsWithUser(cards, state);
+    const fetchState = (0, reduceFetchState_1.reduceFetchState)([
+        chargeCardListState,
+        chargeCardConfigState,
+    ]).fetchState;
+    return {
+        fetchState,
+        error: chargeCardListState.error,
+        cards: chargeCardsWithUser,
+        version: '1.0',
+    };
+};
+exports.getAllChargeCardsWithUser = getAllChargeCardsWithUser;
 const getMyPendingActivationChargeCardListView = (state) => {
     const { tenantState, chargeCardListState, chargeCardState } = state;
     const cards = (0, chargeCardSelector_1.getChargeCardsByIds)(chargeCardState, chargeCardListState.cardIds);

package/lib/view/spendManagement/chargeCards/issueChargeCard/aiCardCreationFormDraftTypes.d.ts

@@ -0,0 +1,79 @@
+import { ID } from '../../../../commonStateTypes/common';
+import { CardsCardKind, CardsCreationInitialData } from '../../../../entity/aiCfo/aiCfoState';
+import { User } from '../../../../entity/user/userState';
+/**
+ * AI CFO card-creation form draft state — the canonical source of
+ * truth for the `CardsCreationInteractiveForm` component (rule #4).
+ *
+ * The web-components form is a pure renderer that hydrates from
+ * `IssueChargeCardState.aiCardCreationFormDraft` and emits every
+ * change back via `onFormChange` → `updateAiCardCreationFormDraft`.
+ *
+ * The AI-payload-side types (`CardsCardKind`, `CardsCardOption`,
+ * `CardNameOption`, `CardsCreationInitialData`, etc.) are defined on
+ * `entity/aiCfo/aiCfoState.ts` and consumed directly from there — this
+ * file only declares the FE-side form draft shapes and the companion
+ * seed context the reducer keeps for re-derivation.
+ */
+/**
+ * Step-1 row: a single team the user can opt in/out of via a checkbox.
+ *
+ * Mirrors the AI's `teamRows[i]` payload field-for-field plus the
+ * `isChecked` toggle, with FE display strings (`value`, `rightLabel`)
+ * resolved from the AI's `avgMonthlySpend` / `recommendedLimit`.
+ */
+export interface CardsTeamRow {
+    cardKind: CardsCardKind;
+    id: string;
+    isChecked: boolean;
+    label: string;
+    /** Right column primary value, e.g. "$20,000". */
+    rightLabel: string;
+    /** Middle column primary value, e.g. "$18,400". */
+    value: string;
+    rightSubLabel?: string;
+    subLabel?: string;
+    subValue?: string;
+}
+/**
+ * Owner field value held in the form state. Mirrors `UserSingleSelectField`
+ * which wants both the universe of users and the currently selected user
+ * collocated with the field value.
+ */
+export interface CardsOwnerFieldValue {
+    allUsers: User[];
+    selectedUser?: User;
+}
+/**
+ * Step-2 row: the configured card for one of the teams the user kept
+ * in step 1. `cardOptionId` references one of the
+ * `CardsCreationInitialData.cardOptions`.
+ */
+export interface CardsCardRow {
+    cardKind: CardsCardKind;
+    cardOptionId: string;
+    id: string;
+    label: string;
+    owner: CardsOwnerFieldValue;
+    recommendedLimit?: number;
+}
+/**
+ * Canonical CES shape for the AI card-creation form. The web-components
+ * `CardsCreationInteractiveForm` hydrates RHF from this object and emits
+ * every change back through `onFormChange`.
+ */
+export interface CardsFormDraft {
+    cardRows: CardsCardRow[];
+    teamRows: CardsTeamRow[];
+}
+/**
+ * Seed context retained on the slice so subsequent `updateAiCardCreationFormDraft`
+ * dispatches can re-derive step-2 rows from step-1 selections without the
+ * component re-passing the full universe each time.
+ */
+export interface AiCardCreationFormDraftSeedContext {
+    allUsers: User[];
+    mode: CardsCreationInitialData['mode'];
+    suggestedOwnerUserIdByTeamId: Record<ID, string | undefined>;
+    defaultCardOptionId?: string;
+}

package/lib/view/spendManagement/chargeCards/issueChargeCard/aiCardCreationFormDraftTypes.js

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

package/lib/view/spendManagement/chargeCards/issueChargeCard/buildAiCardCreationFormDraftSeed.d.ts

@@ -0,0 +1,25 @@
+import { CardsCreationInitialData } from '../../../../entity/aiCfo/aiCfoState';
+import { User } from '../../../../entity/user/userState';
+import { AiCardCreationFormDraftSeedContext, CardsFormDraft } from './aiCardCreationFormDraftTypes';
+export interface BuildAiCardCreationFormDraftSeedArgs {
+    allUsers: User[];
+    initialData: CardsCreationInitialData;
+}
+export interface BuildAiCardCreationFormDraftSeedResult {
+    context: AiCardCreationFormDraftSeedContext;
+    draft: CardsFormDraft;
+}
+/**
+ * Build the initial `CardsFormDraft` + companion seed context for a
+ * fresh AI card-creation session. Used by the `seedAiCardCreationFormDraft`
+ * reducer.
+ *
+ * Branches on `initialData.mode`:
+ * - `review`: step-1 team rows start fully checked. Step-2 `cardRows`
+ *   is left empty — `deriveAiCardRowsFromTeams` materializes it on
+ *   subsequent `updateAiCardCreationFormDraft` dispatches.
+ * - `create`: no step-1 list — seed `cardRows` directly from the AI's
+ *   suggested cards (resolving owners via `allUsers`) and leave
+ *   `teamRows` empty.
+ */
+export declare const buildAiCardCreationFormDraftSeed: ({ initialData, allUsers, }: BuildAiCardCreationFormDraftSeedArgs) => BuildAiCardCreationFormDraftSeedResult;

package/lib/view/spendManagement/chargeCards/issueChargeCard/buildAiCardCreationFormDraftSeed.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAiCardCreationFormDraftSeed = void 0;
+/**
+ * Build the initial `CardsFormDraft` + companion seed context for a
+ * fresh AI card-creation session. Used by the `seedAiCardCreationFormDraft`
+ * reducer.
+ *
+ * Branches on `initialData.mode`:
+ * - `review`: step-1 team rows start fully checked. Step-2 `cardRows`
+ *   is left empty — `deriveAiCardRowsFromTeams` materializes it on
+ *   subsequent `updateAiCardCreationFormDraft` dispatches.
+ * - `create`: no step-1 list — seed `cardRows` directly from the AI's
+ *   suggested cards (resolving owners via `allUsers`) and leave
+ *   `teamRows` empty.
+ */
+const buildAiCardCreationFormDraftSeed = ({ initialData, allUsers, }) => {
+    const context = {
+        allUsers,
+        defaultCardOptionId: initialData.cardOptions[0]?.id,
+        mode: initialData.mode,
+        suggestedOwnerUserIdByTeamId: initialData.suggestedOwnerUserIdByTeamId,
+    };
+    if (initialData.mode === 'create') {
+        return {
+            context,
+            draft: {
+                teamRows: [],
+                cardRows: initialData.cardRows.map((seed) => buildCardRowFromSeed(seed, allUsers)),
+            },
+        };
+    }
+    const teamRows = initialData.teamRows.map((row) => ({
+        cardKind: row.cardKind,
+        id: row.id,
+        isChecked: true,
+        label: row.label,
+        value: row.avgMonthlySpend,
+        rightLabel: row.recommendedLimit,
+        rightSubLabel: row.recommendedLimitCadence,
+    }));
+    return {
+        context,
+        draft: {
+            teamRows,
+            cardRows: [],
+        },
+    };
+};
+exports.buildAiCardCreationFormDraftSeed = buildAiCardCreationFormDraftSeed;
+const buildCardRowFromSeed = (seed, allUsers) => {
+    const selectedUser = seed.suggestedOwnerUserId != null
+        ? allUsers.find((user) => user.userId === seed.suggestedOwnerUserId)
+        : undefined;
+    return {
+        cardKind: seed.cardKind,
+        id: seed.id,
+        label: seed.label,
+        cardOptionId: seed.cardOptionId,
+        owner: {
+            allUsers,
+            selectedUser,
+        },
+        recommendedLimit: seed.recommendedLimit,
+    };
+};

package/lib/view/spendManagement/chargeCards/issueChargeCard/deriveAiCardRowsFromTeams.d.ts

@@ -0,0 +1,26 @@
+import { User } from '../../../../entity/user/userState';
+import { CardsCardRow, CardsTeamRow } from './aiCardCreationFormDraftTypes';
+export interface DeriveAiCardRowsFromTeamsArgs {
+    allUsers: User[];
+    /** First card option id; used as the per-row default when nothing else applies. */
+    defaultCardOptionId: string | undefined;
+    /** Map of teamId -> suggested owner userId surfaced by the AI. */
+    suggestedOwnerUserIdByTeamId: Record<string, string | undefined>;
+    teamRows: CardsTeamRow[];
+    /** Existing step-2 rows; preserved row-for-row when the team is still checked. */
+    prevCardRows?: CardsCardRow[];
+}
+/**
+ * Derive the step-2 `cardRows` from the user's step-1 team selection.
+ *
+ * Behaviour:
+ * - One output row per `teamRow.isChecked === true`, in the same order.
+ * - When a team is still checked AND we have a previous row for it, the
+ *   previous row is preserved verbatim — so user edits made in step 2
+ *   aren't blown away when an upstream watchHandler re-derives.
+ * - Newly-included teams fall back to:
+ *     - `cardOptionId = defaultCardOptionId`
+ *     - `selectedUser = the User whose userId === suggestedOwnerUserIdByTeamId[teamId]`
+ *     - `recommendedLimit = numeric parse of `teamRow.rightLabel` (e.g. "$20,000")`
+ */
+export declare const deriveAiCardRowsFromTeams: ({ teamRows, prevCardRows, allUsers, defaultCardOptionId, suggestedOwnerUserIdByTeamId, }: DeriveAiCardRowsFromTeamsArgs) => CardsCardRow[];

package/lib/view/spendManagement/chargeCards/issueChargeCard/deriveAiCardRowsFromTeams.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveAiCardRowsFromTeams = void 0;
+/**
+ * Derive the step-2 `cardRows` from the user's step-1 team selection.
+ *
+ * Behaviour:
+ * - One output row per `teamRow.isChecked === true`, in the same order.
+ * - When a team is still checked AND we have a previous row for it, the
+ *   previous row is preserved verbatim — so user edits made in step 2
+ *   aren't blown away when an upstream watchHandler re-derives.
+ * - Newly-included teams fall back to:
+ *     - `cardOptionId = defaultCardOptionId`
+ *     - `selectedUser = the User whose userId === suggestedOwnerUserIdByTeamId[teamId]`
+ *     - `recommendedLimit = numeric parse of `teamRow.rightLabel` (e.g. "$20,000")`
+ */
+const deriveAiCardRowsFromTeams = ({ teamRows, prevCardRows = [], allUsers, defaultCardOptionId, suggestedOwnerUserIdByTeamId, }) => {
+    const prevById = new Map(prevCardRows.map((row) => [row.id, row]));
+    const userById = new Map(allUsers.map((user) => [user.userId, user]));
+    return teamRows
+        .filter((row) => row.isChecked)
+        .map((teamRow) => {
+        const previous = prevById.get(teamRow.id);
+        if (previous != null) {
+            return previous;
+        }
+        const suggestedUserId = suggestedOwnerUserIdByTeamId[teamRow.id];
+        const selectedUser = suggestedUserId != null ? userById.get(suggestedUserId) : undefined;
+        return {
+            cardKind: teamRow.cardKind,
+            id: teamRow.id,
+            label: teamRow.label,
+            cardOptionId: defaultCardOptionId ?? '',
+            owner: {
+                allUsers,
+                selectedUser,
+            },
+            recommendedLimit: parseLimitToFloat(teamRow.rightLabel),
+        };
+    });
+};
+exports.deriveAiCardRowsFromTeams = deriveAiCardRowsFromTeams;
+// Best-effort numeric parse of an AI-provided limit string like "$20,000".
+const parseLimitToFloat = (raw) => {
+    const cleaned = raw.replace(/[^0-9.-]/g, '');
+    if (cleaned.length === 0) {
+        return undefined;
+    }
+    const parsed = Number(cleaned);
+    return Number.isFinite(parsed) ? parsed : undefined;
+};

package/lib/view/spendManagement/chargeCards/issueChargeCard/issueChargeCardEpic.d.ts

@@ -8,6 +8,6 @@ import { updateUserRoles } from '../../../../entity/userRole/userRoleReducer';
 import { RootState } from '../../../../reducer';
 import { ZeniAPI } from '../../../../zeniAPI';
 import { updateChargeCardList } from '../chargeCardList/chargeCardListReducer';
-import { issueChargeCardSuccessOrFailure, issueChargeCards, updateChargeCardCount, updateDebitCardCount, updateLastSelfIssuedDebitCardId } from './issueChargeCardReducer';
-export type ActionType = ReturnType<typeof issueChargeCards> | ReturnType<typeof updateChargeCards> | ReturnType<typeof updateAllUsers> | ReturnType<typeof updateUserRoles> | ReturnType<typeof openSnackbar> | ReturnType<typeof updateChargeCardList> | ReturnType<typeof updateChargeCardCount> | ReturnType<typeof updateDebitCardCount> | ReturnType<typeof updateLastSelfIssuedDebitCardId> | ReturnType<typeof issueChargeCardSuccessOrFailure> | ReturnType<typeof updateAddresses>;
+import { issueChargeCardSuccessOrFailure, issueChargeCards, updateChargeCardCount, updateDebitCardCount, updateLastIssuedCardIds, updateLastSelfIssuedDebitCardId } from './issueChargeCardReducer';
+export type ActionType = ReturnType<typeof issueChargeCards> | ReturnType<typeof updateChargeCards> | ReturnType<typeof updateAllUsers> | ReturnType<typeof updateUserRoles> | ReturnType<typeof openSnackbar> | ReturnType<typeof updateChargeCardList> | ReturnType<typeof updateChargeCardCount> | ReturnType<typeof updateDebitCardCount> | ReturnType<typeof updateLastSelfIssuedDebitCardId> | ReturnType<typeof updateLastIssuedCardIds> | ReturnType<typeof issueChargeCardSuccessOrFailure> | ReturnType<typeof updateAddresses>;
 export declare const issueChargeCardEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/spendManagement/chargeCards/issueChargeCard/issueChargeCardEpic.js

@@ -90,7 +90,7 @@ const issueChargeCardEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, ope
             actions.push((0, chargeCardReducer_1.updateChargeCards)(issuedCards), (0, userReducer_1.updateAllUsers)({ users: response.data.users }), (0, userRoleReducer_1.updateUserRoles)(response.data.user_roles), (0, chargeCardListReducer_1.updateChargeCardList)({
                 chargeCardListPayload: response.data,
                 keepExistingListItems: true,
-            }), (0, addressReducer_1.updateAddresses)(response.data.addresses), (0, issueChargeCardReducer_1.updateChargeCardCount)(response.data?.cards_count_by_user_id ?? []), (0, issueChargeCardReducer_1.updateDebitCardCount)(response.data?.debit_cards_count_by_deposit_account_id ?? {}), (0, issueChargeCardReducer_1.issueChargeCardSuccessOrFailure)({ fetchState: 'Completed' }));
+            }), (0, addressReducer_1.updateAddresses)(response.data.addresses), (0, issueChargeCardReducer_1.updateChargeCardCount)(response.data?.cards_count_by_user_id ?? []), (0, issueChargeCardReducer_1.updateDebitCardCount)(response.data?.debit_cards_count_by_deposit_account_id ?? {}), (0, issueChargeCardReducer_1.updateLastIssuedCardIds)(issuedCards.map((card) => card.card_id)), (0, issueChargeCardReducer_1.issueChargeCardSuccessOrFailure)({ fetchState: 'Completed' }));
             if (issuedCards.length === 1 &&
                 (issuedCards[0].card_type.code ===
                     'business_virtual_debit_card' ||

package/lib/view/spendManagement/chargeCards/issueChargeCard/issueChargeCardReducer.d.ts

@@ -1,11 +1,18 @@
 import { FetchState, ID } from '../../../../commonStateTypes/common';
+import { CardsCreationInitialData } from '../../../../entity/aiCfo/aiCfoState';
 import { CardCodeType } from '../../../../entity/chargeCard/chargeCard';
 import { DepositAccountWithLimitPayload } from '../../../../entity/depositAccount/depositAccountPayload';
+import { User } from '../../../../entity/user/userState';
 import { ZeniAPIStatus } from '../../../../responsePayload';
 import { ActiveChargeCardCountPayload, ActiveDebitCardCountByUserIdPayload } from '../../../userListView/userListViewPayload';
+import { CardsFormDraft } from './aiCardCreationFormDraftTypes';
 import { IssueChargeCardLocalData, IssueChargeCardState } from './issueChargeCardState';
 export declare const initialState: IssueChargeCardState;
-export declare const issueChargeCards: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[], {}, "issueChargeCard/issueChargeCards", never, never>, updateChargeCardsLocalStore: import("@reduxjs/toolkit").ActionCreatorWithPayload<IssueChargeCardLocalData[], "issueChargeCard/updateChargeCardsLocalStore">, updateLastSelfIssuedDebitCardId: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "issueChargeCard/updateLastSelfIssuedDebitCardId">, issueChargeCardSuccessOrFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+export declare const issueChargeCards: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload?: {
+    sourceChatSessionId?: ID;
+} | undefined], {
+    sourceChatSessionId?: ID;
+}, "issueChargeCard/issueChargeCards", never, never>, updateChargeCardsLocalStore: import("@reduxjs/toolkit").ActionCreatorWithPayload<IssueChargeCardLocalData[], "issueChargeCard/updateChargeCardsLocalStore">, updateLastSelfIssuedDebitCardId: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "issueChargeCard/updateLastSelfIssuedDebitCardId">, updateLastIssuedCardIds: import("@reduxjs/toolkit").ActionCreatorWithPayload<string[], "issueChargeCard/updateLastIssuedCardIds">, issueChargeCardSuccessOrFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     fetchState: FetchState;
     error?: ZeniAPIStatus;
 }, "issueChargeCard/issueChargeCardSuccessOrFailure">, resetIssueChargeCardForm: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"issueChargeCard/resetIssueChargeCardForm">, updateCustomAddressId: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
@@ -19,6 +26,9 @@ export declare const issueChargeCards: import("@reduxjs/toolkit").ActionCreatorW
 }, "issueChargeCard/fetchIssueCardPage", never, never>, updateDepositAccountsInCards: import("@reduxjs/toolkit").ActionCreatorWithPayload<DepositAccountWithLimitPayload[], "issueChargeCard/updateDepositAccountsInCards">, fetchDepositAccountListForCards: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"issueChargeCard/fetchDepositAccountListForCards">, updateDepositAccountListForCardsFetchStatus: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     fetchState: FetchState;
     error?: ZeniAPIStatus;
-}, "issueChargeCard/updateDepositAccountListForCardsFetchStatus">, clearIssueChargeCard: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"issueChargeCard/clearIssueChargeCard">;
+}, "issueChargeCard/updateDepositAccountListForCardsFetchStatus">, seedAiCardCreationFormDraft: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[allUsers: User[], initialData: CardsCreationInitialData], {
+    allUsers: User[];
+    initialData: CardsCreationInitialData;
+}, "issueChargeCard/seedAiCardCreationFormDraft", never, never>, updateAiCardCreationFormDraft: import("@reduxjs/toolkit").ActionCreatorWithPayload<CardsFormDraft, "issueChargeCard/updateAiCardCreationFormDraft">, clearAiCardCreationFormDraft: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"issueChargeCard/clearAiCardCreationFormDraft">, clearIssueChargeCard: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"issueChargeCard/clearIssueChargeCard">;
 declare const _default: import("redux").Reducer<IssueChargeCardState>;
 export default _default;