@jpmorgan-payments/embedded-finance-components 0.8.0 → 0.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -331,7 +331,101 @@ const OnboardingSection = () => {
331
331
  };
332
332
  ```
333
333
 
334
- ### 3. LinkedAccountWidget
334
+ ### 3. Accounts
335
+
336
+ > **⚠️ Alpha State**: This component is currently in alpha state and not fully integrated with the OpenAPI Specification (OAS). It may have limited functionality and is subject to significant changes.
337
+
338
+ The `Accounts` component provides a read-only, responsive UI for displaying all accounts associated with a client, including their categories, states, routing information, and balances.
339
+
340
+ #### Main Features:
341
+
342
+ - Display accounts with categories, states, and routing information
343
+ - Show account balances (ITAV, ITBD) with human-friendly labels
344
+ - Filter accounts by category via props
345
+ - Responsive layout with mobile support
346
+ - Loading states and error handling
347
+ - Masked account numbers for security
348
+
349
+ #### Props:
350
+
351
+ | Prop Name | Type | Required | Description |
352
+ | ------------------- | ---------- | -------- | --------------------------------------- |
353
+ | `allowedCategories` | `string[]` | Yes | Array of account categories to display |
354
+ | `clientId` | `string` | No | Client ID to filter accounts |
355
+ | `title` | `string` | No | Optional title for the accounts section |
356
+
357
+ #### Usage:
358
+
359
+ ```jsx
360
+ import {
361
+ Accounts,
362
+ EBComponentsProvider,
363
+ } from '@jpmorgan-payments/embedded-finance-components';
364
+
365
+ const AccountsSection = () => {
366
+ return (
367
+ <EBComponentsProvider apiBaseUrl="https://your-api-base-url.com">
368
+ <Accounts
369
+ allowedCategories={['LIMITED_DDA', 'LIMITED_DDA_PAYMENTS']}
370
+ clientId="your-client-id"
371
+ title="My Accounts"
372
+ />
373
+ </EBComponentsProvider>
374
+ );
375
+ };
376
+ ```
377
+
378
+ ### 4. Recipients
379
+
380
+ The `Recipients` component provides comprehensive management of payment recipients, enabling users to create, view, edit, and delete recipient information.
381
+
382
+ #### Main Features:
383
+
384
+ - Create, view, edit, and delete payment recipients
385
+ - Support for multiple payment methods (ACH, WIRE, RTP)
386
+ - Dynamic form validation based on selected payment methods
387
+ - Search and filtering capabilities
388
+ - Pagination for large recipient lists
389
+ - Mobile-responsive design
390
+
391
+ #### Props:
392
+
393
+ | Prop Name | Type | Required | Description |
394
+ | ------------------------ | ---------- | -------- | ---------------------------------------------------------------------- |
395
+ | `clientId` | `string` | No | Optional client ID filter |
396
+ | `initialRecipientType` | `string` | No | Default recipient type (RECIPIENT, LINKED_ACCOUNT, SETTLEMENT_ACCOUNT) |
397
+ | `showCreateButton` | `boolean` | No | Show/hide create functionality |
398
+ | `config` | `object` | No | Configuration for payment methods and validation rules |
399
+ | `onRecipientCreated` | `function` | No | Callback when recipient is created |
400
+ | `onRecipientUpdated` | `function` | No | Callback when recipient is updated |
401
+ | `onRecipientDeactivated` | `function` | No | Callback when recipient is deactivated |
402
+ | `userEventsHandler` | `function` | No | Handler for user events |
403
+
404
+ #### Usage:
405
+
406
+ ```jsx
407
+ import {
408
+ EBComponentsProvider,
409
+ Recipients,
410
+ } from '@jpmorgan-payments/embedded-finance-components';
411
+
412
+ const RecipientsSection = () => {
413
+ return (
414
+ <EBComponentsProvider apiBaseUrl="https://your-api-base-url.com">
415
+ <Recipients
416
+ clientId="your-client-id"
417
+ initialRecipientType="RECIPIENT"
418
+ showCreateButton={true}
419
+ onRecipientCreated={(recipient) => {
420
+ console.log('Recipient created:', recipient);
421
+ }}
422
+ />
423
+ </EBComponentsProvider>
424
+ );
425
+ };
426
+ ```
427
+
428
+ ### 5. LinkedAccountWidget
335
429
 
336
430
  The `LinkedAccountWidget` component facilitates the process of adding a client's linked account, as described in the [Add Linked Account API documentation](https://developer.payments.jpmorgan.com/docs/embedded-finance-solutions/embedded-payments/capabilities/embedded-payments/how-to/add-linked-account).
337
431
 
@@ -358,7 +452,7 @@ const LinkedAccountSection = () => {
358
452
  };
359
453
  ```
360
454
 
361
- ### 4. MakePayment
455
+ ### 6. MakePayment
362
456
 
363
457
  > **⚠️ Alpha State**: This component is currently in alpha state and not fully integrated with the OpenAPI Specification (OAS). It may have limited functionality and is subject to significant changes.
364
458
 
@@ -417,7 +511,7 @@ const PaymentSection = () => {
417
511
  };
418
512
  ```
419
513
 
420
- ### 5. TransactionsDisplay
514
+ ### 7. TransactionsDisplay
421
515
 
422
516
  > **⚠️ Alpha State**: This component is currently in alpha state and not fully integrated with the OpenAPI Specification (OAS). It may have limited functionality and is subject to significant changes.
423
517
 
@@ -685,40 +779,3 @@ This configuration file is a mapping utility that connects form fields to API fi
685
779
  - `storybook:build` – build production storybook bundle to `storybook-static`
686
780
  - `prettier:write` – formats all files with Prettier
687
781
  - `generate-api` – generates API client from OpenAPI specifications using Orval
688
-
689
- ## Recent Updates (v0.7.2)
690
-
691
- The library has been significantly enhanced with the following updates:
692
-
693
- ### New Components
694
-
695
- - **MakePayment**: Complete payment interface with multiple payment methods and fee calculation _(Alpha - not fully integrated with OAS)_
696
- - **TransactionsDisplay**: Transaction history viewer with detailed information and filtering _(Alpha - not fully integrated with OAS)_
697
- - **OnboardingFlow**: Next-generation onboarding experience with improved UX and flow management
698
-
699
- ### Enhanced Features
700
-
701
- - **Improved Document Upload**: Enhanced document upload with file preview, drag-and-drop support, and better error handling
702
- - **Enhanced Theming**: More comprehensive theming system with additional design tokens and better customization options
703
- - **Multi-language Support**: Added French Canadian (fr-CA) language support alongside English (US)
704
- - **Better Mobile Experience**: Improved responsive design and mobile-first approach
705
- - **Enhanced Error Handling**: Better error boundary implementation and user-friendly error messages
706
-
707
- ### Technical Improvements
708
-
709
- - **Orval Integration**: Enhanced API code generation with better type safety and React Query integration
710
- - **Testing Enhancements**: Improved test utilities with better MSW (Mock Service Worker) integration
711
- - **Performance Optimizations**: Better memoization and rendering optimizations
712
- - **Accessibility Improvements**: Enhanced ARIA support and keyboard navigation
713
-
714
- ### API Enhancements
715
-
716
- - **Better State Management**: Improved state management with React Query integration
717
- - **Enhanced Validation**: Better form validation with Zod schemas and improved error messages
718
- - **Improved Data Fetching**: Better caching, error handling, and loading states
719
-
720
- ### Developer Experience
721
-
722
- - **Better Documentation**: Enhanced Storybook stories with more comprehensive examples
723
- - **Improved Testing**: Better test coverage and more robust testing utilities
724
- - **Enhanced TypeScript Support**: Better type definitions and improved developer experience
@@ -1,7 +1,7 @@
1
1
  var ps = Object.defineProperty;
2
2
  var ws = (e, t, n) => t in e ? ps(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
3
3
  var Le = (e, t, n) => ws(e, typeof t != "symbol" ? t + "" : t, n);
4
- import { g as xs, c as M, a as m, b as be, d as K, o as Ot, e as B, P as qo, S as N, t as P, i as E, f as H, h as I, j as $s, k as tr, u as pe, l as G, s as Nn, m as Un, n as rt, p as T, q as Cs, r as kn, v as Ke, w as Ss, x as Dt, y as Tt, z as ks, A as Es, B as mn, F as Ds, C as zr, D as Ft, $ as Ro, E as Ms, G as As, H as j, I as Br, J as Ts, K as nr, L as Fs, M as Is, N as _n, O as Ls, Q as Os, R as te, T as Ps, U as _s } from "./production-DYzgZr6B.js";
4
+ import { g as xs, c as M, a as m, b as be, d as K, o as Ot, e as B, P as qo, S as N, t as P, i as E, f as H, h as I, j as $s, k as tr, u as pe, l as G, s as Nn, m as Un, n as rt, p as T, q as Cs, r as kn, v as Ke, w as Ss, x as Dt, y as Tt, z as ks, A as Es, B as mn, F as Ds, C as zr, D as Ft, $ as Ro, E as Ms, G as As, H as j, I as Br, J as Ts, K as nr, L as Fs, M as Is, N as _n, O as Ls, Q as Os, R as te, T as Ps, U as _s } from "./production-B79PtJKh.js";
5
5
  var Ko = {
6
6
  À: "A",
7
7
  Á: "A",
@@ -1,4 +1,4 @@
1
- import { A as s, E as t, L as i, M as n, z as c, O as o, c as p, b as r, R as m, T as R, p as d, n as f, y as g, d as l, a as u, r as y, m as C, k as A, l as S, f as D, w as E, g as F, q as M, h as P, i as b, x as k, t as v, s as B, e as O, v as T } from "../index-DFAZOLCj.js";
1
+ import { A as s, E as t, L as i, M as n, z as c, O as o, c as p, b as r, R as m, T as R, p as d, n as f, y as g, d as l, a as u, r as y, m as C, k as A, l as S, f as D, w as E, g as F, q as M, h as P, i as b, x as k, t as v, s as B, e as O, v as T } from "../index-_-C1g5eV.js";
2
2
  export {
3
3
  s as Accounts,
4
4
  t as EBComponentsProvider,