@melio-eng/web-sdk 1.0.37 → 1.0.38-pr.76.b08b8f0

package/dist/flows/JustPayFlow.d.ts

@@ -8,6 +8,7 @@ export declare class JustPayFlow extends Flow {
     private externalVendorIds;
     private amount?;
     private authCode;
+    private entryPoint?;
     constructor(containerId: string, config: JustPayFlowConfig, partnerName: string, environment: Environment, authCode: string, branchOverride?: string);
     /**
      * Construct the specific flow URL for vendor payment - goes through /auth

package/dist/flows/JustPayFlow.js

@@ -10,6 +10,7 @@ export class JustPayFlow extends Flow {
         this.externalVendorIds = config.externalVendorIds;
         this.amount = config.amount;
         this.authCode = authCode;
+        this.entryPoint = config.entryPoint;
         if (isEmptyString(this.authCode)) {
             throw new Error('Authorization code is required for just pay flow. Please call init() before opening just pay flow.');
         }
@@ -19,7 +20,8 @@ export class JustPayFlow extends Flow {
      */
     constructFlowUrl(baseUrl) {
         const vendorIdsParam = this.externalVendorIds.join(',');
-        let target = `/external-entries/payment-flow?externalVendorIds=${vendorIdsParam}&externalOrigin=${this.partnerName}`;
+        const externalOrigin = this.entryPoint ? `${this.partnerName}-${this.entryPoint}` : this.partnerName;
+        let target = `/external-entries/payment-flow?externalVendorIds=${vendorIdsParam}&externalOrigin=${externalOrigin}`;
         if (this.amount !== undefined) {
             target += `&amount=${this.amount}`;
         }

package/dist/flows/OnboardingFlow.d.ts

@@ -7,6 +7,7 @@ export declare class OnboardingFlow extends Flow {
     private preFilledParams;
     private enforceOnboarding?;
     private authCode;
+    private entryPoint?;
     constructor(containerId: string, config: OnboardingConfig, partnerName: string, environment: Environment, authCode: string, branchOverride?: string);
     /**
      * Construct the specific flow URL for onboarding - now goes through /auth

package/dist/flows/OnboardingFlow.js

@@ -6,10 +6,11 @@ import { isEmptyString } from './utils.js';
 export class OnboardingFlow extends Flow {
     constructor(containerId, config, partnerName, environment, authCode, branchOverride) {
         super(containerId, config, partnerName, environment, branchOverride);
-        const { userDetails, organizationDetails, enforceOnboarding } = config;
+        const { userDetails, organizationDetails, enforceOnboarding, entryPoint } = config;
         this.preFilledParams = { userDetails, organizationDetails };
         this.enforceOnboarding = enforceOnboarding;
         this.authCode = authCode;
+        this.entryPoint = entryPoint;
         if (isEmptyString(this.authCode)) {
             throw new Error('Authorization code is required for onboarding flow. Please call init() before opening onboarding flow.');
         }
@@ -29,6 +30,7 @@ export class OnboardingFlow extends Flow {
                 preFilledBase64 = '';
             }
         }
+        const externalOrigin = this.entryPoint ? `${this.partnerName}-${this.entryPoint}` : this.partnerName;
         const targetQueryParams = [];
         if (preFilledBase64) {
             targetQueryParams.push(`preFilledParams=${encodeURIComponent(preFilledBase64)}`);
@@ -36,7 +38,7 @@ export class OnboardingFlow extends Flow {
         if (this.enforceOnboarding !== undefined) {
             targetQueryParams.push(`enforceOnboarding=${this.enforceOnboarding}`);
         }
-        targetQueryParams.push(`externalOrigin=${this.partnerName}`);
+        targetQueryParams.push(`externalOrigin=${externalOrigin}`);
         const target = `/welcome?${targetQueryParams.join('&')}`;
         const encodedTarget = encodeURIComponent(target);
         return `${baseUrl}/${this.partnerName}/auth?token=${this.authCode}&redirectUrl=${encodedTarget}`;

package/dist/flows/PayFlow.d.ts

@@ -6,6 +6,7 @@ import { Flow } from './Flow.js';
 export declare class PayFlow extends Flow {
     private billIds;
     private authCode;
+    private entryPoint?;
     constructor(containerId: string, config: PayFlowConfig, partnerName: string, environment: Environment, authCode: string, branchOverride?: string);
     /**
      * Construct the specific flow URL for bill payment - now goes through /auth

package/dist/flows/PayFlow.js

@@ -8,6 +8,7 @@ export class PayFlow extends Flow {
         super(containerId, config, partnerName, environment, branchOverride);
         this.billIds = config.billIds;
         this.authCode = authCode;
+        this.entryPoint = config.entryPoint;
         if (isEmptyString(this.authCode)) {
             throw new Error('Authorization code is required for pay flow. Please call init() before opening pay flow.');
         }
@@ -17,7 +18,8 @@ export class PayFlow extends Flow {
      */
     constructFlowUrl(baseUrl) {
         const billIdsParam = this.billIds.join(',');
-        const target = `/external-entries/payment-flow?billIds=${billIdsParam}&externalOrigin=${this.partnerName}`;
+        const externalOrigin = this.entryPoint ? `${this.partnerName}-${this.entryPoint}` : this.partnerName;
+        const target = `/external-entries/payment-flow?billIds=${billIdsParam}&externalOrigin=${externalOrigin}`;
         const encodedTarget = encodeURIComponent(target);
         return `${baseUrl}/${this.partnerName}/auth?token=${this.authCode}&redirectUrl=${encodedTarget}`;
     }

package/dist/types.d.ts

@@ -41,6 +41,11 @@ export interface UserDetails {
     lastName?: string;
     dateOfBirth?: string;
 }
+/**
+ * Entry point context for the flow, used to construct the externalOrigin parameter.
+ * When provided, the externalOrigin becomes `${partnerName}-${entryPoint}` (e.g., 'xero-contacts').
+ */
+export type ExternalEntryPoint = 'contacts';
 /**
  * Configuration for onboarding flow
  */
@@ -48,12 +53,16 @@ export interface OnboardingConfig extends BaseFlowConfig {
     userDetails?: UserDetails;
     organizationDetails?: OrganizationDetails;
     enforceOnboarding?: boolean;
+    /** Optional entry point context — affects the externalOrigin passed to the platform */
+    entryPoint?: ExternalEntryPoint;
 }
 /**
  * Configuration for pay flow
  */
 export interface PayFlowConfig extends BaseFlowConfig {
     billIds: Array<string>;
+    /** Optional entry point context — affects the externalOrigin passed to the platform */
+    entryPoint?: ExternalEntryPoint;
 }
 /**
  * Configuration for just pay flow (vendor-based payment)
@@ -63,6 +72,8 @@ export interface JustPayFlowConfig extends BaseFlowConfig {
     externalVendorIds: Array<string>;
     /** Optional amount to prefill in the payment flow */
     amount?: number;
+    /** Optional entry point context — affects the externalOrigin passed to the platform */
+    entryPoint?: ExternalEntryPoint;
 }
 /**
  * Configuration for settings flow

package/package.json

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