@kadanza/extension-sdk 0.0.14 → 0.2.0

package/dist/extension-sdk.js

@@ -31,6 +31,7 @@ var r = {
 	loadPageSettings: "LOAD_PAGE_SETTINGS",
 	updatePageSettings: "UPDATE_PAGE_SETTINGS",
 	pageSettingsUpdated: "PAGE_SETTINGS_UPDATED",
+	requestNavigationChange: "REQUEST_NAVIGATION_CHANGE",
 	navigationChange: "NAVIGATION_CHANGE"
 };
 //#endregion
@@ -76,8 +77,56 @@ function l(e = window.location.search) {
 	return new URLSearchParams(e).get("tenantUrl");
 }
 //#endregion
+//#region src/PendingRequest.ts
+var u = class e {
+	promise;
+	context;
+	#e;
+	#t;
+	#n;
+	#r = !1;
+	#i;
+	constructor(e) {
+		this.context = e.context, this.#i = e.onSettle, this.promise = new Promise((e, t) => {
+			this.#e = e, this.#t = t;
+		}), this.#n = setTimeout(() => {
+			this.reject(Error(e.timeoutMessage));
+		}, e.timeoutMs);
+	}
+	static create(t) {
+		return new e(t);
+	}
+	get isPending() {
+		return !this.#r;
+	}
+	matches(e) {
+		return this.isPending && e(this.context);
+	}
+	resolve(e) {
+		return this.#r ? !1 : (this.#a(), this.#e(e), !0);
+	}
+	reject(e) {
+		return this.#r ? !1 : (this.#a(), this.#t(e), !0);
+	}
+	abandon() {
+		return this.#r ? !1 : (this.#a(), !0);
+	}
+	#a() {
+		this.#r = !0, clearTimeout(this.#n), this.#i?.(), this.#i = void 0;
+	}
+}, d = "server";
+function f(e) {
+	return e === "client-hash" ? "client-hash" : d;
+}
+function p(e) {
+	return typeof e != "string" || e === "" || e === "?" ? "" : e.startsWith("?") ? e : `?${e}`;
+}
+//#endregion
 //#region src/ExtensionSDK.ts
-var u = 1e4, d = 12e4, f = 3e4, p = 2147483647, m = class {
+function m(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+var h = 1e4, g = 12e4, _ = 3e4, v = 2147483647, y = class {
 	#e = null;
 	#t = null;
 	#n = null;
@@ -88,7 +137,7 @@ var u = 1e4, d = 12e4, f = 3e4, p = 2147483647, m = class {
 	#s = null;
 	#c = null;
 	#l = !1;
-	#u = d;
+	#u = g;
 	#d = null;
 	#f = !1;
 	#p = null;
@@ -97,40 +146,34 @@ var u = 1e4, d = 12e4, f = 3e4, p = 2147483647, m = class {
 	#g = null;
 	#_ = /* @__PURE__ */ new Set();
 	#v = /* @__PURE__ */ new Set();
+	#y = /* @__PURE__ */ new Set();
 	get isConnected() {
 		return this.#r;
 	}
 	async connect(e = {}) {
-		if (this.#w(), this.#r && this.#a && this.#o && this.#s) return this.#E(e), this.#A(), {
-			authToken: this.#a,
-			extensionDetails: this.#o,
-			designTokens: this.#s,
-			pageSettings: this.#c
-		};
+		if (this.#D(), this.#r) return this.#k(e), this.#N(), this.#x();
 		if (this.#m) return this.#m;
-		this.#E(e);
+		this.#k(e);
 		let t = l();
-		this.#e = c(t), this.#t = t, this.#n?.(), this.#n = a(this.#e, (e) => this.#y(e));
-		let n = e.timeoutMs ?? u, o = new Promise((e, t) => {
-			let r = setTimeout(() => {
-				this.#p = null, this.#m = null, t(/* @__PURE__ */ Error(`Handshake timed out after ${n}ms.`));
-			}, n);
-			this.#p = {
-				resolve: e,
-				reject: t,
-				timer: r
-			};
+		this.#e = c(t), this.#t = t, this.#n?.(), this.#n = a(this.#e, (e) => this.#b(e));
+		let n = e.timeoutMs ?? h, o = u.create({
+			timeoutMs: n,
+			timeoutMessage: `Handshake timed out after ${n}ms.`,
+			onSettle: () => {
+				this.#p === o && (this.#p = null), this.#m = null;
+			}
 		});
-		this.#m = o;
+		this.#p = o, this.#m = o.promise;
+		let s = { routingType: f(e.routingType) };
 		try {
-			i(r.handshakeInit, this.#e);
+			i(r.handshakeInit, this.#e, s);
 		} catch (e) {
-			throw this.#N(this.#p), this.#p = null, this.#m = null, this.#n?.(), this.#n = null, this.#e = null, this.#t = null, this.#k(), e;
+			throw o.abandon(), this.#n?.(), this.#n = null, this.#e = null, this.#t = null, this.#M(), e;
 		}
-		return o;
+		return o.promise;
 	}
 	destroy() {
-		this.#i = !0, this.#r = !1, this.#k(), this.#l = !1, this.#f = !1, this.#n?.(), this.#n = null, this.#e = null, this.#t = null, this.#F(this.#p, /* @__PURE__ */ Error("SDK destroyed.")), this.#F(this.#h, /* @__PURE__ */ Error("SDK destroyed.")), this.#F(this.#g, /* @__PURE__ */ Error("SDK destroyed.")), this.#p = null, this.#m = null, this.#h = null, this.#g = null, this.#_.clear(), this.#v.clear(), this.#a = null, this.#o = null, this.#s = null, this.#c = null;
+		this.#i = !0, this.#r = !1, this.#M(), this.#l = !1, this.#f = !1, this.#n?.(), this.#n = null, this.#e = null, this.#t = null, this.#p?.reject(/* @__PURE__ */ Error("SDK destroyed.")), this.#h?.reject(/* @__PURE__ */ Error("SDK destroyed.")), this.#g?.reject(/* @__PURE__ */ Error("SDK destroyed.")), this.#p = null, this.#m = null, this.#h = null, this.#g = null, this.#_.clear(), this.#v.clear(), this.#y.clear(), this.#a = null, this.#o = null, this.#s = null, this.#c = null;
 	}
 	getAuthToken() {
 		return this.#a;
@@ -151,193 +194,192 @@ var u = 1e4, d = 12e4, f = 3e4, p = 2147483647, m = class {
 		return this.#t;
 	}
 	getApiUrl() {
-		return this.#o ? e(this.#o.baseUrl) : null;
+		let t = this.#o?.baseUrl;
+		if (!t) return null;
+		try {
+			return e(t);
+		} catch {
+			return null;
+		}
 	}
 	async apiCall(e, t = {}) {
-		return this.#T(), n(e, {
-			baseUrl: this.#o.baseUrl,
-			tenantDomain: this.#o.tenantDomain,
-			authTokenJwt: this.#a.jwt
+		this.#O();
+		let r = this.#o?.baseUrl, i = this.#o?.tenantDomain, a = this.#a?.jwt;
+		if (!r || !i || !a) throw Error("API calls require handshake authToken and extensionDetails (baseUrl, tenantDomain).");
+		return n(e, {
+			baseUrl: r,
+			tenantDomain: i,
+			authTokenJwt: a
 		}, t);
 	}
 	async emitRequestAuthTokenRefresh(e = {}) {
-		if (this.#T(), this.#h) throw Error("Auth token refresh already in progress.");
-		let t = e.timeoutMs ?? u, n = this.#e, a = new Promise((e, n) => {
-			let r = setTimeout(() => {
-				this.#h = null, n(/* @__PURE__ */ Error(`Auth token refresh timed out after ${t}ms.`));
-			}, t);
-			this.#h = {
-				resolve: e,
-				reject: n,
-				timer: r
-			};
+		if (this.#O(), this.#h) throw Error("Auth token refresh already in progress.");
+		let t = e.timeoutMs ?? h, n = this.#e, a = u.create({
+			timeoutMs: t,
+			timeoutMessage: `Auth token refresh timed out after ${t}ms.`,
+			onSettle: () => {
+				this.#h === a && (this.#h = null);
+			}
 		});
-		return i(r.requestAuthTokenRefresh, n), a;
+		return this.#h = a, i(r.requestAuthTokenRefresh, n), a.promise;
 	}
 	async emitUpdatePageSettings(e, t = {}) {
-		if (this.#T(), this.#g) throw Error("Page settings update already in progress.");
-		let n = t.timeoutMs ?? u, a = this.#e, o = new Promise((e, t) => {
-			let r = setTimeout(() => {
-				this.#g = null, t(/* @__PURE__ */ Error(`Page settings update timed out after ${n}ms.`));
-			}, n);
-			this.#g = {
-				resolve: e,
-				reject: t,
-				timer: r
-			};
+		if (this.#O(), this.#g) throw Error("Page settings update already in progress.");
+		let n = t.timeoutMs ?? h, a = this.#e, o = u.create({
+			timeoutMs: n,
+			timeoutMessage: `Page settings update timed out after ${n}ms.`,
+			onSettle: () => {
+				this.#g === o && (this.#g = null);
+			}
 		});
-		return i(r.updatePageSettings, a, e), o;
+		return this.#g = o, i(r.updatePageSettings, a, e), o.promise;
 	}
 	onLoadPageSettings(e) {
 		return this.#_.add(e), () => {
 			this.#_.delete(e);
 		};
 	}
-	onAuthTokenRefresh(e) {
+	onNavigate(e) {
 		return this.#v.add(e), () => {
 			this.#v.delete(e);
 		};
 	}
+	onAuthTokenRefresh(e) {
+		return this.#y.add(e), () => {
+			this.#y.delete(e);
+		};
+	}
 	emitNavigationChange(e) {
-		this.#T(), i(r.navigationChange, this.#e, e);
+		this.#O(), i(r.navigationChange, this.#e, e);
 	}
-	#y(e) {
+	#b(e) {
 		let { type: t, payload: n } = e.data;
 		switch (t) {
 			case r.handshakeAck:
-				this.#b(n);
+				this.#S(n);
 				break;
 			case r.authTokenRefresh:
-				this.#x(n);
+				this.#C(n);
 				break;
 			case r.loadPageSettings:
-				this.#S(n);
+				this.#w(n);
+				break;
+			case r.requestNavigationChange:
+				this.#T(n);
 				break;
 			case r.pageSettingsUpdated:
-				this.#C(n);
+				this.#E(n);
 				break;
 			default: break;
 		}
 	}
-	#b(e) {
-		if (!e?.authToken || !e.extensionDetails || !e.designTokens) {
-			this.#F(this.#p, /* @__PURE__ */ Error("Invalid HANDSHAKE_ACK payload.")), this.#p = null, this.#m = null;
-			return;
-		}
-		this.#a = e.authToken, this.#o = e.extensionDetails, this.#s = e.designTokens, this.#c = e.pageSettings ?? null, this.#r = !0;
-		let t = this.#p;
-		this.#p = null, this.#m = null, this.#P(t, {
+	#x() {
+		return {
 			authToken: this.#a,
 			extensionDetails: this.#o,
 			designTokens: this.#s,
 			pageSettings: this.#c
-		}), this.#f = !1, this.#A();
+		};
+	}
+	#S(e) {
+		this.#a = m(e?.authToken) ? e?.authToken : null, this.#o = m(e?.extensionDetails) ? e?.extensionDetails : null, this.#s = m(e?.designTokens) ? e?.designTokens : null, this.#c = m(e?.pageSettings) ? e?.pageSettings : null, this.#r = !0, this.#p?.resolve(this.#x()), this.#f = !1, this.#N();
 	}
-	#x(e) {
+	#C(e) {
 		if (!e?.authToken) {
-			this.#F(this.#h, /* @__PURE__ */ Error("Invalid TOKEN_REFRESH payload.")), this.#h = null;
+			this.#h?.reject(/* @__PURE__ */ Error("Invalid TOKEN_REFRESH payload."));
 			return;
 		}
-		this.#a = e.authToken;
-		let t = this.#h;
-		this.#h = null, this.#P(t, this.#a);
-		for (let e of this.#v) e(this.#a);
-		this.#f = !1, this.#A();
+		this.#a = e.authToken, this.#h?.resolve(this.#a);
+		for (let e of this.#y) e(this.#a);
+		this.#f = !1, this.#N();
 	}
-	#S(e) {
+	#w(e) {
 		let t = e ?? {};
 		this.#c = t;
 		for (let e of this.#_) e(t);
 	}
-	#C(e) {
+	#T(e) {
+		if (!(!e || typeof e.path != "string")) for (let t of this.#v) t(e);
+	}
+	#E(e) {
 		if (!e || typeof e.success != "boolean") {
-			this.#F(this.#g, /* @__PURE__ */ Error("Invalid PAGE_SETTINGS_UPDATED payload.")), this.#g = null;
+			this.#g?.reject(/* @__PURE__ */ Error("Invalid PAGE_SETTINGS_UPDATED payload."));
 			return;
 		}
-		let t = this.#g;
-		this.#g = null, this.#P(t, e);
+		this.#g?.resolve(e);
 	}
-	#w() {
+	#D() {
 		if (this.#i) throw Error("SDK has been destroyed.");
 	}
-	#T() {
-		if (this.#w(), !this.#r || !this.#e) throw Error("SDK is not connected. Call connect() first.");
+	#O() {
+		if (this.#D(), !this.#r || !this.#e) throw Error("SDK is not connected. Call connect() first.");
 	}
-	#E(e) {
+	#k(e) {
 		if (e.authTokenBufferMs !== void 0 && (!Number.isFinite(e.authTokenBufferMs) || e.authTokenBufferMs < 0)) throw Error("authTokenBufferMs must be a finite non-negative number.");
-		this.#l = e.authTokenAutoRefresh === !0, this.#u = e.authTokenBufferMs ?? d, this.#f = !1, this.#k();
+		this.#l = e.authTokenAutoRefresh === !0, this.#u = e.authTokenBufferMs ?? g, this.#f = !1, this.#M();
 	}
-	#D(e) {
+	#A(e) {
 		let t = Number(e.expires);
 		return Number.isFinite(t) ? t * 1e3 : null;
 	}
-	#O(e) {
-		let t = this.#D(e);
+	#j(e) {
+		let t = this.#A(e);
 		return t === null ? null : Math.max(0, t - this.#u - Date.now());
 	}
-	#k() {
+	#M() {
 		this.#d !== null && (clearTimeout(this.#d), this.#d = null);
 	}
-	#A() {
-		if (this.#k(), !this.#l || !this.#r || this.#i || !this.#a) return;
-		let e = this.#O(this.#a);
+	#N() {
+		if (this.#M(), !this.#l || !this.#r || this.#i || !this.#a) return;
+		let e = this.#j(this.#a);
 		if (e === null) return;
-		let t = Math.min(e, p);
+		let t = Math.min(e, v);
 		this.#d = setTimeout(() => {
-			this.#d = null, this.#j();
+			this.#d = null, this.#P();
 		}, t);
 	}
-	async #j() {
+	async #P() {
 		if (!this.#l || !this.#r || this.#i || !this.#a) return;
-		let e = this.#a, t = this.#O(e);
+		let e = this.#a, t = this.#j(e);
 		if (t !== null) {
 			if (t > 0) {
-				this.#A();
+				this.#N();
 				return;
 			}
 			if (this.#h) {
-				this.#M(e);
+				this.#F(e);
 				return;
 			}
 			try {
 				await this.emitRequestAuthTokenRefresh();
 			} catch {
-				this.#M(e);
+				this.#F(e);
 			}
 		}
 	}
-	#M(e) {
+	#F(e) {
 		if (!this.#l || !this.#r || this.#i || this.#a?.jwt !== e.jwt || this.#f) return;
-		let t = this.#D(e);
+		let t = this.#A(e);
 		if (t === null) return;
 		let n = t - Date.now();
 		if (n <= 0) return;
-		this.#f = !0, this.#k();
-		let r = Math.min(f, n);
+		this.#f = !0, this.#M();
+		let r = Math.min(_, n);
 		this.#d = setTimeout(() => {
-			this.#d = null, this.#j();
+			this.#d = null, this.#P();
 		}, r);
 	}
-	#N(e) {
-		e && clearTimeout(e.timer);
-	}
-	#P(e, t) {
-		e && (clearTimeout(e.timer), e.resolve(t));
-	}
-	#F(e, t) {
-		e && (clearTimeout(e.timer), e.reject(t));
-	}
 };
 //#endregion
 //#region src/hostMessaging.ts
-function h(e, t, n, r) {
+function b(e, t, n, r) {
 	let i = r === void 0 ? { type: n } : {
 		type: n,
 		payload: r
 	};
 	e.postMessage(i, t);
 }
-function g(e, t) {
+function x(e, t) {
 	let n = (n) => {
 		n.origin === e && (!n.data || typeof n.data != "object" || !("type" in n.data) || t(n));
 	};
@@ -345,90 +387,121 @@ function g(e, t) {
 }
 //#endregion
 //#region src/ExtensionSDKHost.ts
-var _ = class {
+var S = 1e4;
+function C(e, t) {
+	return `${e}\u0000${p(t)}`;
+}
+var w = class {
 	#e;
 	#t = null;
 	#n = !1;
 	#r = !1;
+	#i = d;
+	#a = null;
 	constructor(e) {
 		this.#e = e;
 	}
 	start() {
-		this.#r || this.#n || (this.#t = g(this.#e.origin, (e) => {
-			this.#i(e);
+		this.#r || this.#n || (this.#t = x(this.#e.origin, (e) => {
+			this.#o(e);
 		}), this.#n = !0);
 	}
 	destroy() {
-		this.#r = !0, this.#n = !1, this.#t?.(), this.#t = null;
+		this.#r = !0, this.#n = !1, this.#t?.(), this.#t = null, this.#i = d, this.#a?.reject(/* @__PURE__ */ Error("ExtensionSDKHost has been destroyed.")), this.#a = null;
+	}
+	getRoutingType() {
+		return this.#i;
 	}
 	emitLoadPageSettings(e) {
-		this.#u(), this.#l(r.loadPageSettings, e);
+		this.#p(), this.#f(r.loadPageSettings, e);
+	}
+	async requestNavigationChange(e, t = {}) {
+		if (this.#p(), !e || typeof e.path != "string") throw Error("Invalid REQUEST_NAVIGATION_CHANGE payload.");
+		if (this.#a) throw Error("Navigation change request already in progress.");
+		let n = t.timeoutMs ?? S, i = u.create({
+			timeoutMs: n,
+			timeoutMessage: `Navigation change timed out after ${n}ms.`,
+			context: C(e.path, e.search),
+			onSettle: () => {
+				this.#a === i && (this.#a = null);
+			}
+		});
+		return this.#a = i, this.#f(r.requestNavigationChange, e), i.promise;
 	}
-	async #i(e) {
+	async #o(e) {
 		if (this.#r) return;
 		let { type: t, payload: n } = e.data;
 		switch (t) {
 			case r.handshakeInit:
-				await this.#a();
+				await this.#s(n);
 				break;
 			case r.requestAuthTokenRefresh:
-				await this.#o();
+				await this.#c();
 				break;
 			case r.updatePageSettings:
-				await this.#s(n);
+				await this.#l(n);
+				break;
+			case r.navigationChange:
+				this.#u(n);
 				break;
 			default: break;
 		}
 	}
-	async #a() {
+	async #s(e) {
+		this.#i = f(e?.routingType);
 		try {
-			let e = await this.#e.resolveHandshakePayload();
+			let e = await this.#e.resolveHandshakePayload(this);
 			if (this.#r) return;
-			this.#l(r.handshakeAck, e);
+			this.#f(r.handshakeAck, e);
 		} catch {}
 	}
-	async #o() {
+	async #c() {
 		try {
 			let e = await this.#e.resolveAuthToken();
 			if (this.#r) return;
-			this.#l(r.authTokenRefresh, { authToken: e });
+			this.#f(r.authTokenRefresh, { authToken: e });
 		} catch {}
 	}
-	async #s(e) {
+	async #l(e) {
 		let t = e?.settings;
 		if (!t || typeof t != "object") {
-			this.#c(!1);
+			this.#d(!1);
 			return;
 		}
 		let n = this.#e.onUpdatePageSettings;
 		if (!n) {
-			this.#c(!1);
+			this.#d(!1);
 			return;
 		}
 		try {
 			let e = await n(t);
 			if (this.#r) return;
-			this.#c(!!e);
+			this.#d(!!e);
 		} catch {
 			if (this.#r) return;
-			this.#c(!1);
+			this.#d(!1);
 		}
 	}
-	#c(e) {
+	#u(e) {
+		if (!e || typeof e.path != "string") return;
+		let t = C(e.path, e.search);
+		this.#a?.matches((e) => e === t) && this.#a.resolve(e), this.#e.onNavigationChange?.(e);
+	}
+	#d(e) {
 		let t = { success: e };
-		this.#l(r.pageSettingsUpdated, t);
+		this.#f(r.pageSettingsUpdated, t);
 	}
-	#l(e, t) {
+	#f(e, t) {
 		let n = this.#e.getContentWindow();
-		n && h(n, this.#e.origin, e, t);
+		n && b(n, this.#e.origin, e, t);
 	}
-	#u() {
+	#p() {
 		if (this.#r) throw Error("ExtensionSDKHost has been destroyed.");
 	}
 };
 //#endregion
 //#region src/hostUrl.ts
-function v(e, t) {
+function T(e, t) {
 	if (typeof e != "string") return !1;
 	try {
 		let n = new URL(e), r = n.protocol === "https:", i = !t || t(n.origin);
@@ -437,7 +510,7 @@ function v(e, t) {
 		return !1;
 	}
 }
-function y(e, t = window.location.origin) {
+function E(e, t = window.location.origin) {
 	if (typeof e != "string") return null;
 	try {
 		let n = new URL(e);
@@ -448,12 +521,12 @@ function y(e, t = window.location.origin) {
 }
 //#endregion
 //#region src/index.ts
-var b = null, x = !1, S = class extends m {
+var D = null, O = !1, k = class extends y {
 	destroy() {
-		super.destroy(), b === this && (b = null, x = !1);
+		super.destroy(), D === this && (D = null, O = !1);
 	}
-}, C = () => b ? (x ||= (console.warn("[@kadanza/extension-sdk] createExtensionSDK() was called more than once. The SDK is a singleton — reuse the same instance for the whole app."), !0), b) : (b = new S(), b);
+}, A = () => D ? (O ||= (console.warn("[@kadanza/extension-sdk] createExtensionSDK() was called more than once. The SDK is a singleton — reuse the same instance for the whole app."), !0), D) : (D = new k(), D);
 //#endregion
-export { r as CONNECTION_EVENTS, m as ExtensionSDK, _ as ExtensionSDKHost, s as InvalidOriginError, C as createExtensionSDK, y as enrichExtensionUrl, v as isValidExtensionUrl, h as postToChild, l as readTenantUrlFromLocation, c as resolveAllowedOrigin, g as subscribeToChildMessages };
+export { r as CONNECTION_EVENTS, d as DEFAULT_ROUTING_TYPE, y as ExtensionSDK, w as ExtensionSDKHost, s as InvalidOriginError, A as createExtensionSDK, E as enrichExtensionUrl, T as isValidExtensionUrl, f as normalizeRoutingType, b as postToChild, l as readTenantUrlFromLocation, c as resolveAllowedOrigin, x as subscribeToChildMessages };
 
 //# sourceMappingURL=extension-sdk.js.map