@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 +97 -40
- package/dist/{2FJCTAHO-CWBmsmEH.js → 2FJCTAHO-CFl8Nboh.js} +1 -1
- package/dist/esm/ef-components.js +1 -1
- package/dist/{index-DFAZOLCj.js → index-_-C1g5eV.js} +10652 -10562
- package/dist/index.css +1 -1
- package/dist/mockServiceWorker.js +1 -1
- package/dist/{production-DYzgZr6B.js → production-B79PtJKh.js} +2 -2
- package/dist/umd/ef-components.js +192 -192
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -331,7 +331,101 @@ const OnboardingSection = () => {
|
|
|
331
331
|
};
|
|
332
332
|
```
|
|
333
333
|
|
|
334
|
-
### 3.
|
|
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
|
-
###
|
|
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
|
-
###
|
|
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-
|
|
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-
|
|
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,
|