@melio-eng/web-sdk 1.3.0-pr.96.0240f85 → 1.3.0-pr.97.57d4a09

package/README.md

@@ -185,7 +185,7 @@ flow.on("navigated", (p)    => console.log("Navigated to:", p.target));
 **Available Events:**
 - `loaded`: The flow iframe has rendered
 - `completed`: The user successfully finished a flow
-- `error`: A flow error occurred (e.g. `billsSyncFailed`)
+- `error`: A flow error occurred (`billsSyncFailed`, or `vendorsSyncFailed` in the Just Pay flow)
 - `exit`: The user exited the iframe
 - `navigated`: Navigation occurred inside the iframe
 - `buttonClicked`: The user clicked a button whose destination is in your product (see below)

package/dist/flows/Flow.js

@@ -1,5 +1,13 @@
 import { getBaseUrl } from './utils.js';
 import { logger, describeError, describeConfig, redactUrl } from './logger.js';
+/**
+ * MELIO_ERROR codes the embedded app reports, mapped to the host-facing error
+ * codes the SDK emits. A code that is absent here is logged but not forwarded.
+ */
+const HOST_FACING_ERROR_CODES = {
+    failed_to_sync_bills: 'billsSyncFailed',
+    failed_to_sync_vendors: 'vendorsSyncFailed',
+};
 /**
  * Flow class implementation for handling iframe flows and events
  */
@@ -155,17 +163,18 @@ export class Flow {
             case 'PAYMENT_SCHEDULED':
                 this.emit('completed', { flowName: 'payment', ...data });
                 break;
-            case 'MELIO_ERROR':
-                // Only one code maps to a host-facing event, so an unmapped code would
-                // otherwise be dropped silently.
+            case 'MELIO_ERROR': {
+                const errorCode = HOST_FACING_ERROR_CODES[data.code];
+                // Logged even when unmapped, so a new code cannot be dropped silently.
                 logger.error('Embedded app reported MELIO_ERROR', {
                     ...data,
-                    forwardedToHost: data.code === 'failed_to_sync_bills',
+                    forwardedToHost: Boolean(errorCode),
                 });
-                if (data.code === 'failed_to_sync_bills') {
-                    this.emit('error', { errorCode: 'billsSyncFailed' });
+                if (errorCode) {
+                    this.emit('error', { errorCode });
                 }
                 break;
+            }
             case 'HEIGHT_CHANGE':
                 if (this.iframe) {
                     this.iframe.style.height = `${data.height}px`;

package/dist/types.d.ts

@@ -165,9 +165,13 @@ export interface FlowCompletionData {
  * 1. Trying to sync a non-USD bill
  * 2. Trying to sync an already paid bill / draft bill
  * 3. Trying to sync bills with an unsupported amount (amount 0 or greater than $1M)
+ *
+ * vendorsSyncFailed is returned when the Just Pay flow could not load any of the
+ * requested vendors from the accounting platform. The flow cannot continue, so
+ * close it and surface the failure in your own product.
  */
 export interface ErrorData {
-    errorCode: 'billsSyncFailed';
+    errorCode: 'billsSyncFailed' | 'vendorsSyncFailed';
 }
 /**
  * Event types that can be listened to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melio-eng/web-sdk",
-  "version": "1.3.0-pr.96.0240f85",
+  "version": "1.3.0-pr.97.57d4a09",
   "description": "Melio Web SDK - Embed core Melio workflows directly into partner UI with minimal effort",
   "main": "dist/index.js",
   "module": "dist/index.js",