@tesouro/embedded-components-react 0.3.31 → 0.3.33

package/README.md

@@ -290,20 +290,21 @@ Read-only details for one credit **or** debit card — status, form factor, prog
 
 Issues a new **debit** card for an enrolled team member: cardholder, format
 (virtual / physical), funding bank account, and — for physical cards — a mailing
-destination. Loading, success, and error feedback use both full-screen views and
+destination. Optional spend limit and per-transaction maximum are applied after
+issuance. Loading, success, and error feedback use both full-screen views and
 sonner toasts.
 
 #### Props
 
-| Prop            | Type                                  | Default        | Description                                                                                                                       |
-| --------------- | ------------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------- |
-| `cardArtSrc`    | `string`                              | **Required**   | Static card plastic image URL (no name overlays).                                                                                 |
-| `labels`        | `PartialDeep<CreateCardWidgetLabels>` | English labels | Overrides presentational copy (header, setup, mailing, card controls, preparing, success, footer). Nested groups merge per group. |
-| `featureLabels` | toast / untitled-funding overrides    | English labels | Overrides mutation toast strings and the funding-account fallback name.                                                           |
-| `className`     | `string`                              | —              | Optional class on the presentational root.                                                                                        |
-| `onClose`       | `() => void`                          | —              | Header close control. Omit and no close control is rendered.                                                                      |
-| `onCancel`      | `() => void`                          | —              | Called when Cancel is pressed (also invokes `onClose` when both are set).                                                         |
-| `onViewCard`    | `(cardId: string) => void`            | —              | Called with the new debit card id after a successful create when the user presses **View card**.                                  |
+| Prop            | Type                                                       | Default        | Description                                                                                                                                                |
+| --------------- | ---------------------------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `cardArtSrc`    | `string`                                                   | **Required**   | Static card plastic image URL (no name overlays).                                                                                                          |
+| `labels`        | `PartialDeep<CreateCardWidgetLabels>`                      | English labels | Overrides presentational copy (header, setup, mailing, card controls, preparing, success, footer). Nested groups merge per group.                          |
+| `featureLabels` | toast / untitled-funding / velocity-control-name overrides | English labels | Overrides mutation toast strings (including spend-control and admin-access warnings), the funding-account fallback name, and API velocity-control `name`s. |
+| `className`     | `string`                                                   | —              | Optional class on the presentational root.                                                                                                                 |
+| `onClose`       | `() => void`                                               | —              | Header close control. Omit and no close control is rendered.                                                                                               |
+| `onCancel`      | `() => void`                                               | —              | Called when Cancel is pressed (also invokes `onClose` when both are set).                                                                                  |
+| `onViewCard`    | `(cardId: string) => void`                                 | —              | Called with the new debit card id after a successful create when the user presses **View card**.                                                           |
 
 ### CounterpartsWidget
 

package/dist/index.d.ts

@@ -2396,11 +2396,23 @@ interface CreateCardFeatureLabels {
         creating: string;
         success: string;
         error: string;
+        /**
+         * Card issued but a follow-up velocity-control POST failed. The card
+         * already exists; this must not read as a create failure.
+         */
+        controlsWarning: string;
         /**
          * Card issued but granting company admins access to it failed. The card
          * already exists; this must not read as a create failure.
          */
         companyAdminAccessWarning: string;
+        /**
+         * Card issued, but BOTH the velocity-control POST(s) and the company-admin
+         * access grant failed. Distinct from the two single-failure warnings above
+         * so an issuer who hits both is told about both, not just whichever this
+         * code checks first.
+         */
+        controlsAndAccessWarning: string;
         /**
          * The roster of users to grant access to a new card failed to load.
          * Shown with a retry action; Create stays disabled until it resolves so
@@ -2410,6 +2422,28 @@ interface CreateCardFeatureLabels {
         retry: string;
     };
     untitledFundingAccount: string;
+    /**
+     * API-required `name` on a velocity control. Not shown in this widget;
+     * may surface on a later controls list.
+     */
+    velocityControlNames: {
+        spendLimit: string;
+        perTransactionMaximum: string;
+    };
+    /**
+     * Spend-limit reset-period tab labels and notices. Owned here (not UI
+     * labels) because the feature layer decides what each opaque period value
+     * means.
+     */
+    spendLimit: {
+        periodOneTime: string;
+        periodDaily: string;
+        periodMonthly: string;
+        oneTimeWarningTitle: string;
+        oneTimeWarningDescription: string;
+        dailyResetNotice: string;
+        monthlyResetNotice: string;
+    };
     /**
      * Success-screen copy chosen from the create response's `cardStatus`.
      * Active/ready wording lives on the UI defaults; these cover statuses that
@@ -2426,6 +2460,8 @@ declare const CREATE_CARD_FEATURE_LABELS_EN: CreateCardFeatureLabels;
 declare function resolveCreateCardFeatureLabels(overrides?: Partial<{
     toast: Partial<CreateCardFeatureLabels['toast']>;
     untitledFundingAccount: string;
+    velocityControlNames: Partial<CreateCardFeatureLabels['velocityControlNames']>;
+    spendLimit: Partial<CreateCardFeatureLabels['spendLimit']>;
     success: Partial<CreateCardFeatureLabels['success']>;
 }>): CreateCardFeatureLabels;
 
@@ -2436,6 +2472,8 @@ type CreateCardWidgetProps = WidgetProviderProps & {
     featureLabels?: Partial<{
         toast: Partial<CreateCardFeatureLabels['toast']>;
         untitledFundingAccount: string;
+        velocityControlNames: Partial<CreateCardFeatureLabels['velocityControlNames']>;
+        spendLimit: Partial<CreateCardFeatureLabels['spendLimit']>;
         success: Partial<CreateCardFeatureLabels['success']>;
     }>;
     className?: string;

package/dist/index.js

@@ -20,8 +20,8 @@ import { BillPayWidget as T } from "./libs/tesouro-embedded-components-react/bil
 import "./lib/BillPayWidget.js";
 import { CardDetailsWidget as E } from "./libs/tesouro-embedded-components-react/card-details-widget/feature/dist/index6.js";
 import { CardFormatValue as D } from "./libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index3.js";
-import { CREATE_CARD_FEATURE_LABELS_EN as O, resolveCreateCardFeatureLabels as k } from "./libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index4.js";
-import { CreateCardWidget as A } from "./libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index7.js";
+import { CREATE_CARD_FEATURE_LABELS_EN as O, resolveCreateCardFeatureLabels as k } from "./libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index5.js";
+import { CreateCardWidget as A } from "./libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index8.js";
 import { CardsWidget as j } from "./libs/tesouro-embedded-components-react/cards-widget/feature/dist/index9.js";
 import "./lib/CardsWidget.js";
 import "./lib/CardDetailsWidget.js";

package/dist/lib/CardsWidget.d.ts

@@ -997,11 +997,23 @@ interface CreateCardFeatureLabels {
         creating: string;
         success: string;
         error: string;
+        /**
+         * Card issued but a follow-up velocity-control POST failed. The card
+         * already exists; this must not read as a create failure.
+         */
+        controlsWarning: string;
         /**
          * Card issued but granting company admins access to it failed. The card
          * already exists; this must not read as a create failure.
          */
         companyAdminAccessWarning: string;
+        /**
+         * Card issued, but BOTH the velocity-control POST(s) and the company-admin
+         * access grant failed. Distinct from the two single-failure warnings above
+         * so an issuer who hits both is told about both, not just whichever this
+         * code checks first.
+         */
+        controlsAndAccessWarning: string;
         /**
          * The roster of users to grant access to a new card failed to load.
          * Shown with a retry action; Create stays disabled until it resolves so
@@ -1011,6 +1023,28 @@ interface CreateCardFeatureLabels {
         retry: string;
     };
     untitledFundingAccount: string;
+    /**
+     * API-required `name` on a velocity control. Not shown in this widget;
+     * may surface on a later controls list.
+     */
+    velocityControlNames: {
+        spendLimit: string;
+        perTransactionMaximum: string;
+    };
+    /**
+     * Spend-limit reset-period tab labels and notices. Owned here (not UI
+     * labels) because the feature layer decides what each opaque period value
+     * means.
+     */
+    spendLimit: {
+        periodOneTime: string;
+        periodDaily: string;
+        periodMonthly: string;
+        oneTimeWarningTitle: string;
+        oneTimeWarningDescription: string;
+        dailyResetNotice: string;
+        monthlyResetNotice: string;
+    };
     /**
      * Success-screen copy chosen from the create response's `cardStatus`.
      * Active/ready wording lives on the UI defaults; these cover statuses that
@@ -1031,6 +1065,8 @@ type CreateCardWidgetProps = WidgetProviderProps & {
     featureLabels?: Partial<{
         toast: Partial<CreateCardFeatureLabels['toast']>;
         untitledFundingAccount: string;
+        velocityControlNames: Partial<CreateCardFeatureLabels['velocityControlNames']>;
+        spendLimit: Partial<CreateCardFeatureLabels['spendLimit']>;
         success: Partial<CreateCardFeatureLabels['success']>;
     }>;
     className?: string;

package/dist/lib/CreateCardWidget.d.ts

@@ -720,11 +720,23 @@ interface CreateCardFeatureLabels {
         creating: string;
         success: string;
         error: string;
+        /**
+         * Card issued but a follow-up velocity-control POST failed. The card
+         * already exists; this must not read as a create failure.
+         */
+        controlsWarning: string;
         /**
          * Card issued but granting company admins access to it failed. The card
          * already exists; this must not read as a create failure.
          */
         companyAdminAccessWarning: string;
+        /**
+         * Card issued, but BOTH the velocity-control POST(s) and the company-admin
+         * access grant failed. Distinct from the two single-failure warnings above
+         * so an issuer who hits both is told about both, not just whichever this
+         * code checks first.
+         */
+        controlsAndAccessWarning: string;
         /**
          * The roster of users to grant access to a new card failed to load.
          * Shown with a retry action; Create stays disabled until it resolves so
@@ -734,6 +746,28 @@ interface CreateCardFeatureLabels {
         retry: string;
     };
     untitledFundingAccount: string;
+    /**
+     * API-required `name` on a velocity control. Not shown in this widget;
+     * may surface on a later controls list.
+     */
+    velocityControlNames: {
+        spendLimit: string;
+        perTransactionMaximum: string;
+    };
+    /**
+     * Spend-limit reset-period tab labels and notices. Owned here (not UI
+     * labels) because the feature layer decides what each opaque period value
+     * means.
+     */
+    spendLimit: {
+        periodOneTime: string;
+        periodDaily: string;
+        periodMonthly: string;
+        oneTimeWarningTitle: string;
+        oneTimeWarningDescription: string;
+        dailyResetNotice: string;
+        monthlyResetNotice: string;
+    };
     /**
      * Success-screen copy chosen from the create response's `cardStatus`.
      * Active/ready wording lives on the UI defaults; these cover statuses that
@@ -750,6 +784,8 @@ declare const CREATE_CARD_FEATURE_LABELS_EN: CreateCardFeatureLabels;
 declare function resolveCreateCardFeatureLabels(overrides?: Partial<{
     toast: Partial<CreateCardFeatureLabels['toast']>;
     untitledFundingAccount: string;
+    velocityControlNames: Partial<CreateCardFeatureLabels['velocityControlNames']>;
+    spendLimit: Partial<CreateCardFeatureLabels['spendLimit']>;
     success: Partial<CreateCardFeatureLabels['success']>;
 }>): CreateCardFeatureLabels;
 
@@ -760,6 +796,8 @@ type CreateCardWidgetProps = WidgetProviderProps & {
     featureLabels?: Partial<{
         toast: Partial<CreateCardFeatureLabels['toast']>;
         untitledFundingAccount: string;
+        velocityControlNames: Partial<CreateCardFeatureLabels['velocityControlNames']>;
+        spendLimit: Partial<CreateCardFeatureLabels['spendLimit']>;
         success: Partial<CreateCardFeatureLabels['success']>;
     }>;
     className?: string;

package/dist/lib/CreateCardWidget.js

@@ -1,5 +1,5 @@
 import { CardFormatValue as e } from "../libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index3.js";
-import { CREATE_CARD_FEATURE_LABELS_EN as t, resolveCreateCardFeatureLabels as n } from "../libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index4.js";
-import { CreateCardWidget as r } from "../libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index7.js";
+import { CREATE_CARD_FEATURE_LABELS_EN as t, resolveCreateCardFeatureLabels as n } from "../libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index5.js";
+import { CreateCardWidget as r } from "../libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index8.js";
 import "../libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index.js";
 export { t as CREATE_CARD_FEATURE_LABELS_EN, e as CardFormatValue, r as CreateCardWidget, n as resolveCreateCardFeatureLabels };

package/dist/libs/tesouro-embedded-components-react/bill-pay-widget/feature/dist/index31.js

@@ -1,11 +1,13 @@
-import { PAY_BILL_FLOW_LABELS_EN as e, mergePayBillFlowLabels as t } from "./index11.js";
-import { MARK_AS_PAID_FLOW_LABELS_EN as n, mergeMarkAsPaidFlowLabels as r } from "./index2.js";
+import { UNSAVED_BILL_DIALOG_LABELS_EN as e } from "../../ui/dist/index95.js";
+import "../../ui/dist/index.js";
+import { PAY_BILL_FLOW_LABELS_EN as t, mergePayBillFlowLabels as n } from "./index11.js";
+import { MARK_AS_PAID_FLOW_LABELS_EN as r, mergeMarkAsPaidFlowLabels as i } from "./index2.js";
 import "./index5.js";
-import { APPROVAL_POLICY_RULE_COPY_EN as i } from "./index15.js";
-import { BILL_DETAIL_ACTIONS_LABELS_EN as a, SCHEDULED_SUMMARY_LABEL_EN as o, mergeBillDetailActionsLabels as s } from "./index29.js";
-import { SOURCE_DOCUMENT_PREVIEW_LABELS_EN as c } from "./index30.js";
+import { APPROVAL_POLICY_RULE_COPY_EN as a } from "./index15.js";
+import { BILL_DETAIL_ACTIONS_LABELS_EN as o, SCHEDULED_SUMMARY_LABEL_EN as s, mergeBillDetailActionsLabels as c } from "./index29.js";
+import { SOURCE_DOCUMENT_PREVIEW_LABELS_EN as l } from "./index30.js";
 //#region ../../libs/tesouro-embedded-components-react/bill-pay-widget/feature/dist/index31.js
-var l = {
+var u = {
 	unmappedValidationError: (e, t) => `${e}: ${t}`,
 	unknownValidationField: "(unknown field)",
 	requiredField: "This field is required.",
@@ -17,7 +19,7 @@ var l = {
 	unusableQuantity: "Enter a quantity greater than 0.",
 	lineItemsNeedAttention: "Check the highlighted line items before saving.",
 	totalsNeedAttention: "Enter valid amounts for discount, tax, and total."
-}, u = {
+}, d = {
 	achMethod: "via ACH bank transfer",
 	noMethod: "No payment method on file",
 	accountHolder: "Account holder",
@@ -27,13 +29,13 @@ var l = {
 	paymentMethodUnavailable: "We could not load payment methods. Try again.",
 	searchFailed: "We could not load vendors. Try again.",
 	vendorDetailsFailed: "We could not load this vendor. Try again."
-}, d = {
+}, f = {
 	attachFailed: "We could not attach that file. Try again.",
 	deleteFailed: "We could not remove that document. Try again.",
 	noDocument: "No document attached to this bill.",
 	pendingDeletionNotice: "This document will be removed when you save this bill.",
-	preview: c
-}, f = {
+	preview: l
+}, p = {
 	notProvided: "Not provided",
 	paymentInstructionsValue: (e) => `Account ending in ${e}`,
 	invoiceDateRow: "Invoice date",
@@ -47,7 +49,7 @@ var l = {
 	totalRow: "Total",
 	paymentInstructionsSaveError: "Couldn't save payment instructions. Try again.",
 	paymentInstructionsLinkError: "Payment instructions were saved to the vendor, but couldn't be added to this bill. Try again."
-}, p = {
+}, m = {
 	dateLabel: (e) => new Date(e).toLocaleString("en-US", {
 		month: "short",
 		day: "numeric",
@@ -71,20 +73,20 @@ var l = {
 	markedAsPartiallyPaid: "Marked as partially paid",
 	paymentReverted: "Payment reverted",
 	statusChanged: (e) => `Status changed to ${e}`
-}, m = {
+}, h = {
 	newTitle: "New bill",
 	extractedTitle: (e) => `Bill from ${e}`,
 	viewTitle: (e) => `Bill from ${e}`,
 	readOnlyTitle: "Bill details",
 	addedOn: (e) => `Added on ${e}`,
-	discardConfirm: "Discard your changes to this bill?",
-	scheduledSummary: o,
-	actions: a,
-	detail: f,
-	history: p,
-	payBill: e,
-	markAsPaid: n,
-	approvalPolicyCopy: i,
+	unsavedChanges: e,
+	scheduledSummary: s,
+	actions: o,
+	detail: p,
+	history: m,
+	payBill: t,
+	markAsPaid: r,
+	approvalPolicyCopy: a,
 	deleteDraft: {
 		menuItem: "Delete draft",
 		dialog: {
@@ -95,31 +97,35 @@ var l = {
 		error: "Couldn't delete this draft. Try again."
 	}
 };
-function h(e) {
+function g(e) {
 	return {
-		...m,
+		...h,
 		...e,
-		actions: s(e?.actions),
+		actions: c(e?.actions),
 		detail: {
-			...m.detail,
+			...h.detail,
 			...e?.detail
 		},
 		history: {
-			...m.history,
+			...h.history,
 			...e?.history
 		},
-		payBill: t(e?.payBill),
-		markAsPaid: r(e?.markAsPaid),
+		payBill: n(e?.payBill),
+		markAsPaid: i(e?.markAsPaid),
+		unsavedChanges: {
+			...h.unsavedChanges,
+			...e?.unsavedChanges
+		},
 		approvalPolicyCopy: {
-			...m.approvalPolicyCopy,
+			...h.approvalPolicyCopy,
 			...e?.approvalPolicyCopy
 		},
 		deleteDraft: {
-			...m.deleteDraft,
+			...h.deleteDraft,
 			...e?.deleteDraft,
 			dialog: (() => {
 				let t = {
-					...m.deleteDraft.dialog,
+					...h.deleteDraft.dialog,
 					...e?.deleteDraft?.dialog
 				};
 				return delete t.reason, t;
@@ -127,7 +133,7 @@ function h(e) {
 		}
 	};
 }
-var g = {
+var _ = {
 	createTitle: "New vendor",
 	editTitle: "Edit vendor",
 	close: "Close the vendor form",
@@ -146,4 +152,4 @@ var g = {
 	save: "Save vendor"
 };
 //#endregion
-export { l as BILL_CREATE_MESSAGE_LABELS_EN, m as BILL_CREATE_SCREEN_LABELS_EN, f as BILL_DETAIL_VIEW_LABELS_EN, p as BILL_HISTORY_LABELS_EN, d as SOURCE_DOCUMENT_CONTAINER_LABELS_EN, g as VENDOR_INLINE_FORM_LABELS_EN, u as VENDOR_SECTION_PROPS_LABELS_EN, h as mergeBillCreateScreenCopy };
+export { u as BILL_CREATE_MESSAGE_LABELS_EN, h as BILL_CREATE_SCREEN_LABELS_EN, p as BILL_DETAIL_VIEW_LABELS_EN, m as BILL_HISTORY_LABELS_EN, f as SOURCE_DOCUMENT_CONTAINER_LABELS_EN, _ as VENDOR_INLINE_FORM_LABELS_EN, d as VENDOR_SECTION_PROPS_LABELS_EN, g as mergeBillCreateScreenCopy };

package/dist/libs/tesouro-embedded-components-react/bill-pay-widget/feature/dist/index40.js

@@ -104,9 +104,10 @@ function x({ payableId: _, form: v, counterpartId: x, clearCounterpart: S, prepa
 					let t = await C?.();
 					if (t && !t.ok) return;
 					let n = await Y(t?.counterpartBankAccountId);
-					v.setErrors(void 0), w?.(n), E?.(n), e.success(k.draftSaved);
+					return v.setErrors(void 0), w?.(n), E?.(n), e.success(k.draftSaved), n;
 				} catch {
 					v.setErrors({ form: k.saveFailed });
+					return;
 				} finally {
 					B(void 0), V.current = !1;
 				}

package/dist/libs/tesouro-embedded-components-react/bill-pay-widget/feature/dist/index43.js

@@ -9,7 +9,10 @@ var e = {
 	decisionConfirm: "bill-pay-bill-decision-confirm",
 	decisionReason: "bill-pay-bill-decision-reason",
 	deleteDraftDialog: "bill-pay-bill-delete-draft-dialog",
-	deleteDraftConfirm: "bill-pay-bill-delete-draft-confirm"
+	deleteDraftConfirm: "bill-pay-bill-delete-draft-confirm",
+	unsavedDialog: "bill-pay-bill-unsaved-dialog",
+	unsavedSaveDraft: "bill-pay-bill-unsaved-save-draft",
+	unsavedDiscard: "bill-pay-bill-unsaved-discard"
 };
 //#endregion
 export { e as billCreateTestIds };