@wf-financing/ui-sdk 1.0.0 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # Wayflyer Financing UI SDK
 
-Wayflyer provides a `@wf-financing/ui-sdk` package that can be used as a client-side UI SDK to interact with the Embedded Finance API. It provides a single method to mount the CTA banner in the partner UI.
+Wayflyer provides a `@wf-financing/ui-sdk` - a client-side UI SDK to interact with the Embedded Finance API. Its primary method mounts the CTA banner in the partner UI.
 
 ## Installation
 
@@ -10,55 +10,46 @@ Install the package directly from NPM with `npm install @wf-financing/ui-sdk`. T
 
 To initialize `WayflyerUiSdk`, call the static method `loadSdk` with the following parameters:
 
-1. `targetId` - The DOM element's ID where the CTA is supposed to be mounted.
-2. `partnerCallback` - A function of type `PartnerCallbackType`, which is also provided by the `@wf-financing/ui-sdk` package.
-3. `companyToken` - The merchant identifier.
+1. `companyToken` - The merchant identifier.
    - **Note**: The `companyToken` should be minted using the Company Token endpoint on the partner's backend. See the Authentication section [here](https://docs.wayflyer.com/embedded-finance/authentication) for more details.
+2. `options` (optional) – an object of type `SdkOptionsType` that provides an ability for SDK to run in different modes (e.g. sandbox mode).
 
 ```jsx
-import { type IWayflyerUiCtaSdk, WayflyerUiSdk } from '@wf-financing/ui-sdk';
+import { WayflyerUiSdk } from '@wf-financing/ui-sdk';
 
-const wayflyerSdk = (await WayflyerUiSdk.loadSdk(targetId, partnerCallback, companyToken)) as IWayflyerUiCtaSdk;
+const wayflyerUiSdk = await WayflyerUiSdk.loadSdk(companyToken);
 ```
 
 ## SDK methods
 
-### `mountCta()`
+### `mountCta(targetId, partnerCallback)`
 
 This function mounts the CTA banner once it's called.
 
+1. `targetId` - the `id` of the DOM element where the CTA banner should be mounted.
+2. `partnerCallback` – a callback function that should return data of type `PartnerCallbackType`.
+
 ```jsx
-wayflyerSdk.mountCta();
-```
+import { type PartnerCallbackType } from '@wf-financing/ui-sdk';
 
-## Mocked mode
+const partnerCallback: PartnerCallbackType = await () => {};
 
-To simplify the testing process, the SDK can be initialized in mock mode. To do so, pass the fourth argument of type `MockedModeType`. In mock mode, the partner can manually set responses for SDK methods via the `sdkScenario` field in the optional `mockedMode` argument.
+wayflyerUiSdk.mountCta(targetId, partnerCallback);
+```
 
-```jsx
-import { WayflyerUiSdk, type MockedModeType, SdkScenarios } from '@wf-financing/ui-sdk';
+## Sandbox
 
-const mockedModeNewApplication: MockedModeType = {
-   isMockedMode: true,
-   sdkScenario: SdkScenarios.INDICATIVE_NEW_APPLICATION,
-};
+To simplify the testing process, the SDK can be initialized in sandbox mode. To do so, pass the second argument of type `SdkOptionsType` with `isSandbox` flag set to `true`. In sandbox mode, the partner can simulate responses for SDK methods with the help of the additional package `@wf-financing/sandbox-ui`.
 
-const mockedModeNewApplication: MockedModeType = {
-   isMockedMode: true,
-   sdkScenario: SdkScenarios.GENERIC_NEW_APPLICATION,
-};
+```jsx
+import { WayflyerUiSdk, type SdkOptionsType, type PartnerCallbackType } from '@wf-financing/ui-sdk';
 
-const mockedModeContinueApplication: MockedModeType = {
-   isMockedMode: true,
-   sdkScenario: SdkScenarios.CONTINUE_APPLICATION,
-};
+const options: SdkOptionsType = { isSandbox: true };
+const wayflyerUiSdk = await WayflyerUiSdk.loadSdk(companyToken, options);
 
-const mockedModeNoCta: MockedModeType = {
-   isMockedMode: true,
-   sdkScenario: SdkScenarios.NO_CTA,
-};
+const partnerCallback: PartnerCallbackType = await () => {};
 
-const wayflyerSdk = (await WayflyerUiSdk.loadSdk(targetId, partnerCallback, companyToken, mockedMode)) as IWayflyerUiCtaSdk;
+wayflyerUiSdk.mountCta(targetId, partnerCallback);
 ```
 
-After instantiation with the mockedMode parameter, the CTA banner will behave according to the specified scenario.
+After instantiation in sandbox mode, the SDK will call the sandbox environment API.

package/dist/config/url.d.ts

@@ -1 +1 @@
-export declare const UI_PACKAGE_URL = "https://embedded-finance-frontend.vercel.app/npm/@wf-financing/ui@2";
+export declare const UI_PACKAGE_URL = "https://embedded-finance-frontend.vercel.app/npm/@wf-financing/ui@3";

package/dist/index.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n="wayflyer-ui-package",s="https://embedded-finance-frontend.vercel.app/npm/@wf-financing/ui@2",c=(a,t,i,d)=>{if(!window.WayflyerUiCtaSdk)throw new Error("Failed to load WayflyerUiCtaSdk from the script.");const e=window.WayflyerUiCtaSdk;return new e(a,t,i,d)},o=(a,t,i,d,e)=>new Promise((r,y)=>{a.onload=()=>{try{r(c(t,i,d,e))}catch(l){y(l)}}}),f=async(a,t,i,d)=>{try{const e=document.getElementById(n);if(window.WayflyerUiCtaSdk)return c(a,t,i,d);if(e)return o(e,a,t,i,d);const r=document.createElement("script");return r.src=s,r.type="module",r.id=n,r.async=!0,document.head.appendChild(r),o(r,a,t,i,d)}catch(e){throw console.error("Error in loading headless SDK:",e),new Error("Failed to load script")}};class S{static async loadSdk(t,i,d,e){return await f(t,i,d,e)}}exports.WayflyerUiSdk=S;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d="wayflyer-ui-package",l="https://embedded-finance-frontend.vercel.app/npm/@wf-financing/ui@3",a=(i,t)=>{if(!window.WayflyerUiSdk)throw new Error("Failed to load WayflyerUiSdk from the script.");const e=window.WayflyerUiSdk;return new e(i,t)},n=(i,t,e)=>new Promise((r,o)=>{i.onload=()=>{try{r(a(t,e))}catch(c){o(c)}}}),y=async(i,t)=>{try{const e=document.getElementById(d);if(window.WayflyerUiSdk)return a(i,t);if(e)return n(e,i,t);const r=document.createElement("script");return r.src=l,r.type="module",r.id=d,r.async=!0,document.head.appendChild(r),n(r,i,t)}catch(e){throw console.error("Error in loading headless SDK:",e),new Error("Failed to load script")}};class s{static async loadSdk(t,e){return await y(t,e)}}exports.WayflyerUiSdk=s;

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export type { IWayflyerUiCtaSdk, PartnerCallbackType, SdkOptionsType } from '@wf-financing/embedded-types';
+export type { IWayflyerUiSdk, PartnerCallbackType, SdkOptionsType } from '@wf-financing/embedded-types';
 export { WayflyerUiSdk } from './sdk';

package/dist/index.es.js

@@ -1,34 +1,34 @@
-const a = "wayflyer-ui-package", s = "https://embedded-finance-frontend.vercel.app/npm/@wf-financing/ui@2", c = (n, t, i, d) => {
-  if (!window.WayflyerUiCtaSdk)
-    throw new Error("Failed to load WayflyerUiCtaSdk from the script.");
-  const e = window.WayflyerUiCtaSdk;
-  return new e(n, t, i, d);
-}, o = (n, t, i, d, e) => new Promise((r, y) => {
-  n.onload = () => {
+const d = "wayflyer-ui-package", l = "https://embedded-finance-frontend.vercel.app/npm/@wf-financing/ui@3", a = (i, t) => {
+  if (!window.WayflyerUiSdk)
+    throw new Error("Failed to load WayflyerUiSdk from the script.");
+  const r = window.WayflyerUiSdk;
+  return new r(i, t);
+}, n = (i, t, r) => new Promise((e, o) => {
+  i.onload = () => {
     try {
-      r(c(t, i, d, e));
-    } catch (l) {
-      y(l);
+      e(a(t, r));
+    } catch (c) {
+      o(c);
     }
   };
-}), f = async (n, t, i, d) => {
+}), y = async (i, t) => {
   try {
-    const e = document.getElementById(a);
-    if (window.WayflyerUiCtaSdk)
-      return c(n, t, i, d);
-    if (e)
-      return o(e, n, t, i, d);
-    const r = document.createElement("script");
-    return r.src = s, r.type = "module", r.id = a, r.async = !0, document.head.appendChild(r), o(r, n, t, i, d);
-  } catch (e) {
-    throw console.error("Error in loading headless SDK:", e), new Error("Failed to load script");
+    const r = document.getElementById(d);
+    if (window.WayflyerUiSdk)
+      return a(i, t);
+    if (r)
+      return n(r, i, t);
+    const e = document.createElement("script");
+    return e.src = l, e.type = "module", e.id = d, e.async = !0, document.head.appendChild(e), n(e, i, t);
+  } catch (r) {
+    throw console.error("Error in loading headless SDK:", r), new Error("Failed to load script");
   }
 };
-class w {
-  static async loadSdk(t, i, d, e) {
-    return await f(t, i, d, e);
+class s {
+  static async loadSdk(t, r) {
+    return await y(t, r);
   }
 }
 export {
-  w as WayflyerUiSdk
+  s as WayflyerUiSdk
 };

package/dist/sdk/index.d.ts

@@ -1,5 +1,5 @@
-import { PartnerCallbackType, SdkOptionsType } from '@wf-financing/embedded-types';
+import { SdkOptionsType, IWayflyerUiSdk } from '@wf-financing/embedded-types';
 
 export declare class WayflyerUiSdk {
-    static loadSdk(targetId: string, partnerCallback: PartnerCallbackType, companyToken: string, options?: SdkOptionsType): Promise<void | import('@wf-financing/embedded-types').IWayflyerUiCtaSdk>;
+    static loadSdk(companyToken: string, options?: SdkOptionsType): Promise<IWayflyerUiSdk>;
 }

package/dist/sdk-mode/loadSdkUiMode.d.ts

@@ -1,5 +1,5 @@
-import { IWayflyerUiCtaSdk, PartnerCallbackType, SdkOptionsType } from '@wf-financing/embedded-types';
+import { IWayflyerUiSdk, SdkOptionsType } from '@wf-financing/embedded-types';
 
-type LoadUiSdkModeType = (targetId: string, partnerCallback: PartnerCallbackType, companyToken: string, options?: SdkOptionsType) => Promise<IWayflyerUiCtaSdk | void>;
+type LoadUiSdkModeType = (companyToken: string, options?: SdkOptionsType) => Promise<IWayflyerUiSdk | void>;
 export declare const loadUiSdkMode: LoadUiSdkModeType;
 export {};

package/dist/utils/initializeUiSdk.d.ts

@@ -1,3 +1,3 @@
-import { IWayflyerUiCtaSdk, SdkOptionsType, PartnerCallbackType } from '@wf-financing/embedded-types';
+import { IWayflyerUiSdk, SdkOptionsType } from '@wf-financing/embedded-types';
 
-export declare const initializeUiSdk: (targetId: string, partnerCallback: PartnerCallbackType, companyToken: string, options?: SdkOptionsType) => IWayflyerUiCtaSdk;
+export declare const initializeUiSdk: (companyToken: string, options?: SdkOptionsType) => IWayflyerUiSdk;

package/dist/utils/loadScriptAndInitializeSdk.d.ts

@@ -1,3 +1,3 @@
-import { IWayflyerUiCtaSdk, PartnerCallbackType, SdkOptionsType } from '@wf-financing/embedded-types';
+import { IWayflyerUiSdk, SdkOptionsType } from '@wf-financing/embedded-types';
 
-export declare const loadScriptAndInitializeSdk: (script: HTMLScriptElement, targetId: string, partnerCallback: PartnerCallbackType, companyToken: string, options?: SdkOptionsType) => Promise<IWayflyerUiCtaSdk>;
+export declare const loadScriptAndInitializeSdk: (script: HTMLScriptElement, companyToken: string, options?: SdkOptionsType) => Promise<IWayflyerUiSdk>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wf-financing/ui-sdk",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",
   "types": "dist/index.d.ts",
@@ -15,7 +15,7 @@
     "dist"
   ],
   "dependencies": {
-    "@wf-financing/embedded-types": "0.4.0"
+    "@wf-financing/embedded-types": "0.4.1"
   },
   "devDependencies": {
     "vite": "^6.3.5",