@wf-financing/headless-sdk 3.0.7 → 4.1.0

package/README.md

@@ -7,16 +7,16 @@ Install the package directly from NPM with `npm install @wf-financing/headless-s
 To minimize bundle size and reduce the impact on partners' page load times, the SDK uses dynamic imports to load the main functionality.
 
 ## Instantiation
-Initialize the Wayflyer headless SDK by passing the `companyToken` and an optional `options` object with a type of `SdkOptionsType` that specifies additional functionality of SDK instance - e.g. consuming sandbox API instead of the production.
+Initialize the Wayflyer headless SDK by passing the `companyToken` and an optional `options` object with a type of `HeadlessSdkOptions` that specifies additional functionality of SDK instance - e.g. consuming sandbox API instead of the production.
 
 ```jsx
-import { WayflyerHeadlessSdk, SdkOptionsType } from '@wf-financing/headless-sdk';
+import { WayflyerHeadlessSdk, HeadlessSdkOptions } from '@wf-financing/headless-sdk';
 
 // instantiation in production mode
 const wayflyerHeadlessSdk = await WayflyerHeadlessSdk.loadSdk(companyToken);
 
-// instantiation in sandbox mode, `options` type of SdkOptionsType
-const options: SdkOptionsType = { isSandbox: true };
+// instantiation in sandbox mode, `options` type of HeadlessSdkOptions
+const options: HeadlessSdkOptions = { isSandbox: true };
 const wayflyerHeadlessSdk = await WayflyerHeadlessSdk.loadSdk(companyToken, options);
 ```
 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.
@@ -64,12 +64,12 @@ await wayflyerSdk.dismissCta();
 
 ## Sandbox
 
-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 additional package `@wf-financing/sandbox-ui`.
+To simplify the testing process, the SDK can be initialized in sandbox mode. To do so, pass the second argument of type `HeadlessSdkOptions` with `isSandbox` flag set to `true`. In sandbox mode, the partner can simulate responses for SDK methods with the help of additional package `@wf-financing/sandbox-ui`.
 
 ```jsx
-import { WayflyerHeadlessSdk, SdkOptionsType } from '@wf-financing/headless-sdk';
+import { WayflyerHeadlessSdk, HeadlessSdkOptions } from '@wf-financing/headless-sdk';
 
-const options: SdkOptionsType = { isSandbox: true };
+const options: HeadlessSdkOptions = { isSandbox: true };
 const wayflyerSdk = await WayflyerHeadlessSdk.loadSdk(companyToken, options);
 ```
 

package/dist/config/applicationVersion.d.ts

@@ -0,0 +1 @@
+export declare const APPLICATION_VERSION: string;

package/dist/config/index.d.ts

@@ -1,2 +1,3 @@
 export { WAYFLYER_HEADLESS_SDK_ID } from './scriptId';
 export { HEADLESS_PACKAGE_URL } from './url';
+export { APPLICATION_VERSION } from './applicationVersion';

package/dist/config/url.d.ts

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

package/dist/index.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var l=(e=>(e.GENERIC_OFFER="generic_offer",e.INDICATIVE_OFFER="indicative_offer",e.CONTINUE_APPLICATION="continue_application",e))(l||{});const s="wayflyer-headless-sdk",c="https://embedded-finance-frontend.vercel.app/npm/@wf-financing/headless@2",n=(e,d)=>{if(!window.WayflyerHeadlessSdk)throw new Error("Failed to load WayflyerHeadlessSdk from the script.");const r=window.WayflyerHeadlessSdk;return window.waylflyerHeadlessSdk||(window.waylflyerHeadlessSdk=new r(e,d)),window.waylflyerHeadlessSdk},t=(e,d,r)=>new Promise((a,i)=>{e.onload=()=>{try{a(n(d,r))}catch(o){i(o)}}}),y=async(e,d)=>{try{const r=document.getElementById(s);if(window.WayflyerHeadlessSdk)return n(e,d);if(r)return t(r,e,d);const a=document.createElement("script");return a.src=c,a.type="module",a.id=s,a.async=!0,document.head.appendChild(a),t(a,e,d)}catch(r){throw console.error("Error in loading headless SDK:",r),new Error("Failed to load script")}};class f{static async loadSdk(d,r){return await y(d,r)}}exports.CtaStateType=l;exports.WayflyerHeadlessSdk=f;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var p=(s=>(s.GENERIC_OFFER="generic_offer",s.INDICATIVE_OFFER="indicative_offer",s.CONTINUE_APPLICATION="continue_application",s))(p||{}),h=Object.defineProperty,I=(s,e,t)=>e in s?h(s,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):s[e]=t,d=(s,e,t)=>I(s,typeof e!="symbol"?e+"":e,t);const v="https://api.wayflyer.com",E="https://sandbox-api.wayflyer.com",b=s=>{try{return JSON.parse(atob(s.split(".")[1]))}catch{return null}},c={"Content-Type":"application/json"},y={event:"/financing/v1/company/event/",error:"/financing/v1/error/"},S="wf_session_v1",k=1800*1e3,A=1440*60*1e3;class D{getSessionId(){const e=Date.now();let t=this.loadSession();return(!t||this.isSessionExpired(t,e))&&(t=this.mintNewSession(e)),t.lastActivity=e,this.saveSession(t),t.sessionId}isSessionExpired(e,t){const n=t-e.lastActivity>k,i=t-e.createdAt>A;return n||i}mintNewSession(e){return{sessionId:crypto.randomUUID(),createdAt:e,lastActivity:e}}loadSession(){try{const e=sessionStorage.getItem(S);return e?JSON.parse(e):null}catch{return null}}saveSession(e){try{sessionStorage.setItem(S,JSON.stringify(e))}catch{console.warn("Failed to save session context")}}}const f=class a{constructor(e,t){d(this,"baseUrl",null),d(this,"sessionManager"),this.companyToken=e,this.baseUrl=t?E:v,this.sessionManager=new D}static getGlobalInstance(){return window.WayflyerLogger||null}static setGlobalInstance(e){window.WayflyerLogger=e}static initialize(e,t){a.getGlobalInstance()&&console.warn("Logger re-initialized");const n=new a(e,t==null?void 0:t.isSandbox);a.setGlobalInstance(n)}static getMandatoryProperties(e){const t=b(e),[n,i]=(t==null?void 0:t.sub.split("|"))||[],o=t==null?void 0:t.user_id;return{partner_id:n,company_id:i,user_id:o}}static getInstance(){const e=a.getGlobalInstance();if(!e)throw new Error("Logger not initialized. Call initialize() first.");return e}static async logEvent(e,t){if(this.isDevEnvironment)return;const n=a.getInstance(),i=n.sessionManager.getSessionId(),o={...c,Authorization:`Bearer ${n.companyToken}`,"X-Session-ID":i};try{const r={...a.getMandatoryProperties(n.companyToken),...t},l=await fetch(n.baseUrl+y.event,{method:"POST",headers:o,body:JSON.stringify({timestamp:new Date().toISOString(),event_name:e,properties:r})});if(l.status===200)return await l.json()}catch(r){console.error("Failed to log event",r)}}static async logError(e,t){if(this.isDevEnvironment){console.error(e);return}const n=a.getInstance(),i=n.sessionManager.getSessionId(),o={...c,"X-Session-ID":i};try{const r={...a.getMandatoryProperties(n.companyToken),...t},l=await fetch(n.baseUrl+y.error,{method:"POST",headers:o,body:JSON.stringify({timestamp:new Date().toISOString(),message:e,properties:r})});if(l.status===200)return await l.json()}catch(r){console.warn("Failed to log error",r)}}};d(f,"isDevEnvironment",!1);let u=f;const w="wayflyer-headless-sdk",O="https://embedded-finance-frontend.vercel.app/npm/@wf-financing/headless@3",z="4.1.0",m=(s,e)=>{if(!window.WayflyerHeadlessSdk)throw new Error("Failed to load WayflyerHeadlessSdk from the script.");const t=window.WayflyerHeadlessSdk;return window.waylflyerHeadlessSdk||(window.waylflyerHeadlessSdk=new t(s,e)),window.waylflyerHeadlessSdk},g=(s,e,t)=>new Promise((n,i)=>{s.onload=()=>{try{n(m(e,t))}catch(o){i(o)}}}),H=async(s,e)=>{try{const t=document.getElementById(w);if(window.WayflyerHeadlessSdk)return m(s,e);if(t)return g(t,s,e);const n=document.createElement("script");return n.src=O,n.type="module",n.id=w,n.async=!0,document.head.appendChild(n),g(n,s,e)}catch(t){throw console.error("Error in loading headless SDK:",t),new Error("Failed to load script")}};class N{static async loadSdk(e,t){const n=Date.now();u.initialize(e,t);const i=await H(e,t),r=Date.now()-n;return u.logEvent(`headless_sdk_initialized: entry point version: ${z}, SDK version: ${i==null?void 0:i.sdkVersion} SDK initialization latency: ${r}ms`),i}}exports.CtaStateType=p;exports.WayflyerHeadlessSdk=N;

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { CtaStateType } from '@wf-financing/embedded-types';
-export type { CanadianProvinceCode, CompanyDataType, ContinueHostedApplicationResponseType, CountryCode, CtaContinueFundingType, CtaGenericOfferType, CtaIndicativeOfferType, CtaResponseType, IWayflyerHeadlessSdk, SdkOptionsType, StartHostedApplicationRequestType, StartHostedApplicationResponseType, UserDataType, USStateCode, } from '@wf-financing/embedded-types';
+export type { CanadianProvinceCode, CompanyDataType, ContinueHostedApplicationResponseType, CountryCode, CtaContinueFundingType, CtaGenericOfferType, CtaIndicativeOfferType, CtaResponseType, IWayflyerHeadlessSdk, SdkOptionsType, HeadlessSdkOptions, StartHostedApplicationRequestType, StartHostedApplicationResponseType, UserDataType, USStateCode, } from '@wf-financing/embedded-types';
 export { WayflyerHeadlessSdk } from './sdk';

package/dist/index.es.js

@@ -1,36 +1,168 @@
-var o = /* @__PURE__ */ ((e) => (e.GENERIC_OFFER = "generic_offer", e.INDICATIVE_OFFER = "indicative_offer", e.CONTINUE_APPLICATION = "continue_application", e))(o || {});
-const s = "wayflyer-headless-sdk", c = "https://embedded-finance-frontend.vercel.app/npm/@wf-financing/headless@2", l = (e, d) => {
+var m = /* @__PURE__ */ ((s) => (s.GENERIC_OFFER = "generic_offer", s.INDICATIVE_OFFER = "indicative_offer", s.CONTINUE_APPLICATION = "continue_application", s))(m || {}), h = Object.defineProperty, I = (s, e, t) => e in s ? h(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t, c = (s, e, t) => I(s, typeof e != "symbol" ? e + "" : e, t);
+const v = "https://api.wayflyer.com", E = "https://sandbox-api.wayflyer.com", b = (s) => {
+  try {
+    return JSON.parse(atob(s.split(".")[1]));
+  } catch {
+    return null;
+  }
+}, d = {
+  "Content-Type": "application/json"
+}, y = {
+  event: "/financing/v1/company/event/",
+  error: "/financing/v1/error/"
+}, S = "wf_session_v1", k = 1800 * 1e3, A = 1440 * 60 * 1e3;
+class D {
+  getSessionId() {
+    const e = Date.now();
+    let t = this.loadSession();
+    return (!t || this.isSessionExpired(t, e)) && (t = this.mintNewSession(e)), t.lastActivity = e, this.saveSession(t), t.sessionId;
+  }
+  isSessionExpired(e, t) {
+    const n = t - e.lastActivity > k, i = t - e.createdAt > A;
+    return n || i;
+  }
+  mintNewSession(e) {
+    return {
+      sessionId: crypto.randomUUID(),
+      createdAt: e,
+      lastActivity: e
+    };
+  }
+  loadSession() {
+    try {
+      const e = sessionStorage.getItem(S);
+      return e ? JSON.parse(e) : null;
+    } catch {
+      return null;
+    }
+  }
+  saveSession(e) {
+    try {
+      sessionStorage.setItem(S, JSON.stringify(e));
+    } catch {
+      console.warn("Failed to save session context");
+    }
+  }
+}
+const g = class a {
+  constructor(e, t) {
+    c(this, "baseUrl", null), c(this, "sessionManager"), this.companyToken = e, this.baseUrl = t ? E : v, this.sessionManager = new D();
+  }
+  static getGlobalInstance() {
+    return window.WayflyerLogger || null;
+  }
+  static setGlobalInstance(e) {
+    window.WayflyerLogger = e;
+  }
+  static initialize(e, t) {
+    a.getGlobalInstance() && console.warn("Logger re-initialized");
+    const n = new a(e, t == null ? void 0 : t.isSandbox);
+    a.setGlobalInstance(n);
+  }
+  static getMandatoryProperties(e) {
+    const t = b(e), [n, i] = (t == null ? void 0 : t.sub.split("|")) || [], o = t == null ? void 0 : t.user_id;
+    return { partner_id: n, company_id: i, user_id: o };
+  }
+  static getInstance() {
+    const e = a.getGlobalInstance();
+    if (!e)
+      throw new Error("Logger not initialized. Call initialize() first.");
+    return e;
+  }
+  static async logEvent(e, t) {
+    if (this.isDevEnvironment) return;
+    const n = a.getInstance(), i = n.sessionManager.getSessionId(), o = {
+      ...d,
+      Authorization: `Bearer ${n.companyToken}`,
+      "X-Session-ID": i
+    };
+    try {
+      const r = {
+        ...a.getMandatoryProperties(n.companyToken),
+        ...t
+      }, l = await fetch(n.baseUrl + y.event, {
+        method: "POST",
+        headers: o,
+        body: JSON.stringify({
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          event_name: e,
+          properties: r
+        })
+      });
+      if (l.status === 200)
+        return await l.json();
+    } catch (r) {
+      console.error("Failed to log event", r);
+    }
+  }
+  static async logError(e, t) {
+    if (this.isDevEnvironment) {
+      console.error(e);
+      return;
+    }
+    const n = a.getInstance(), i = n.sessionManager.getSessionId(), o = {
+      ...d,
+      "X-Session-ID": i
+    };
+    try {
+      const r = {
+        ...a.getMandatoryProperties(n.companyToken),
+        ...t
+      }, l = await fetch(n.baseUrl + y.error, {
+        method: "POST",
+        headers: o,
+        body: JSON.stringify({
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          message: e,
+          properties: r
+        })
+      });
+      if (l.status === 200)
+        return await l.json();
+    } catch (r) {
+      console.warn("Failed to log error", r);
+    }
+  }
+};
+c(g, "isDevEnvironment", !1);
+let w = g;
+const p = "wayflyer-headless-sdk", O = "https://embedded-finance-frontend.vercel.app/npm/@wf-financing/headless@3", z = "4.1.0", f = (s, e) => {
   if (!window.WayflyerHeadlessSdk)
     throw new Error("Failed to load WayflyerHeadlessSdk from the script.");
-  const r = window.WayflyerHeadlessSdk;
-  return window.waylflyerHeadlessSdk || (window.waylflyerHeadlessSdk = new r(e, d)), window.waylflyerHeadlessSdk;
-}, t = (e, d, r) => new Promise((a, n) => {
-  e.onload = () => {
+  const t = window.WayflyerHeadlessSdk;
+  return window.waylflyerHeadlessSdk || (window.waylflyerHeadlessSdk = new t(s, e)), window.waylflyerHeadlessSdk;
+}, u = (s, e, t) => new Promise((n, i) => {
+  s.onload = () => {
     try {
-      a(l(d, r));
-    } catch (i) {
-      n(i);
+      n(f(e, t));
+    } catch (o) {
+      i(o);
     }
   };
-}), y = async (e, d) => {
+}), N = async (s, e) => {
   try {
-    const r = document.getElementById(s);
+    const t = document.getElementById(p);
     if (window.WayflyerHeadlessSdk)
-      return l(e, d);
-    if (r)
-      return t(r, e, d);
-    const a = document.createElement("script");
-    return a.src = c, a.type = "module", a.id = s, a.async = !0, document.head.appendChild(a), t(a, e, d);
-  } catch (r) {
-    throw console.error("Error in loading headless SDK:", r), new Error("Failed to load script");
+      return f(s, e);
+    if (t)
+      return u(t, s, e);
+    const n = document.createElement("script");
+    return n.src = O, n.type = "module", n.id = p, n.async = !0, document.head.appendChild(n), u(n, s, e);
+  } catch (t) {
+    throw console.error("Error in loading headless SDK:", t), new Error("Failed to load script");
   }
 };
-class f {
-  static async loadSdk(d, r) {
-    return await y(d, r);
+class H {
+  static async loadSdk(e, t) {
+    const n = Date.now();
+    w.initialize(e, t);
+    const i = await N(e, t), r = Date.now() - n;
+    return w.logEvent(
+      `headless_sdk_initialized: entry point version: ${z}, SDK version: ${i == null ? void 0 : i.sdkVersion} SDK initialization latency: ${r}ms`
+    ), i;
   }
 }
 export {
-  o as CtaStateType,
-  f as WayflyerHeadlessSdk
+  m as CtaStateType,
+  H as WayflyerHeadlessSdk
 };

package/dist/sdk/index.d.ts

@@ -1,5 +1,5 @@
-import { SdkOptionsType, IWayflyerHeadlessSdk } from '@wf-financing/embedded-types';
+import { HeadlessSdkOptions, IWayflyerHeadlessSdk } from '@wf-financing/embedded-types';
 
 export declare class WayflyerHeadlessSdk {
-    static loadSdk(companyToken: string, options?: SdkOptionsType): Promise<IWayflyerHeadlessSdk>;
+    static loadSdk(companyToken: string, options?: HeadlessSdkOptions): Promise<IWayflyerHeadlessSdk>;
 }

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

@@ -1,5 +1,5 @@
-import { IWayflyerHeadlessSdk, SdkOptionsType } from '@wf-financing/embedded-types';
+import { IWayflyerHeadlessSdk, HeadlessSdkOptions } from '@wf-financing/embedded-types';
 
-type LoadHeadlessSdkModeType = (companyToken: string, options?: SdkOptionsType) => Promise<IWayflyerHeadlessSdk | void>;
+type LoadHeadlessSdkModeType = (companyToken: string, options?: HeadlessSdkOptions) => Promise<IWayflyerHeadlessSdk | void>;
 export declare const loadHeadlessSdkMode: LoadHeadlessSdkModeType;
 export {};

package/dist/utils/initializeHeadlessSdk.d.ts

@@ -1,3 +1,3 @@
-import { IWayflyerHeadlessSdk, SdkOptionsType } from '@wf-financing/embedded-types';
+import { IWayflyerHeadlessSdk, HeadlessSdkOptions } from '@wf-financing/embedded-types';
 
-export declare const initializeHeadlessSdk: (companyToken: string, options?: SdkOptionsType) => IWayflyerHeadlessSdk;
+export declare const initializeHeadlessSdk: (companyToken: string, options?: HeadlessSdkOptions) => IWayflyerHeadlessSdk;

package/dist/utils/loadScriptAndInitializeSdk.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wf-financing/headless-sdk",
-  "version": "3.0.7",
+  "version": "4.1.0",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",
   "types": "dist/index.d.ts",
@@ -15,7 +15,8 @@
     "dist"
   ],
   "dependencies": {
-    "@wf-financing/embedded-types": "0.7.1"
+    "@wf-financing/embedded-types": "1.1.0",
+    "@wf-financing/logger": "2.1.0"
   },
   "devDependencies": {
     "vite": "^6.3.5",