@wetransform/core 1.0.1 → 1.1.0

package/README.md

@@ -31,6 +31,8 @@ sdk.on('successSubmit', (payload) => console.log('File successfully submitted',
 
 // Opening WeTransform
 await sdk.open()
+// Dynamically switch locale without remounting
+await sdk.setLocale('fr')
 // Close WeTransform
 await sdk.close()
 // Destroy WeTransform session
@@ -46,6 +48,7 @@ Returns a `WeTransformInstance` with:
 - `open(): Promise<void>` - initializes auth and mounts WeTransform
 - `close(): Promise<void>` - closes SDK UI and unmounts WeTransform
 - `destroy(): Promise<void>` - closes and tears down SDK resources
+- `setLocale(locale): Promise<void>` - updates locale/auth context and syncs iframe locale when active
 - `on(event, handler): () => void` - subscribes to SDK events, returns unsubscribe function
 
 ### `WeTransformConfig`
@@ -57,6 +60,17 @@ Returns a `WeTransformInstance` with:
 - `displayAsModal?: boolean` (default: `true`)
 - `mountElement?: string | HTMLElement` (default id: `weTransform_iframeContainer`, used when `displayAsModal` is `false`)
 
+`locale` defaults to `'en'` when not provided.
+
+### Runtime locale switching
+
+- `setLocale('en' | 'fr')` is additive and does not require destroy/recreate.
+- If the locale is unchanged, `setLocale` is a no-op.
+- If SDK status is `open`, locale is sent to iframe immediately via bridge messaging.
+- If SDK status is `opening`, locale is sent after iframe readiness is reached.
+- `setLocale` updates auth API URL context to `{VITE_SENDER_API_URL}/{locale}/send/{organizationHandle}` for subsequent auth calls.
+- Calling `setLocale` after `destroy()` throws `Cannot set locale after destroy.`
+
 #### Inline mounting behavior (`displayAsModal: false`)
 
 When `displayAsModal` is `false`, wetTransform SDK mounts the iframe into:

package/dist/index.d.mts

@@ -54,6 +54,7 @@ type WeTransformInstance = {
   open: () => Promise<void>;
   close: () => Promise<void>;
   destroy: () => Promise<void>;
+  setLocale: (locale: SupportedLocales) => Promise<void>;
   on: <K extends keyof WeTransformEventMap>(event: K, handler: WeTransformEventMap[K]) => () => void;
 };
 type SupportedLocales = 'en' | 'fr';

package/dist/index.mjs

@@ -84,6 +84,9 @@ var AuthBridge = class {
 		});
 		return this.refreshPromise;
 	}
+	setApiUrl(apiUrl) {
+		this.apiUrl = apiUrl;
+	}
 	clear() {
 		this.accessToken = null;
 		this.refreshToken = null;
@@ -224,6 +227,14 @@ var IframeManager = class {
 	async requestLogout(signal) {
 		await this.notifyLogout(signal ?? this.activeSignal ?? void 0);
 	}
+	async setLocale(locale, signal) {
+		const updateLocale = (this.childApi ? await this.withAbort(this.childApi, signal) : null)?.setLocale;
+		if (!updateLocale) return;
+		await this.withAbort(updateLocale({ locale }), signal);
+	}
+	updateLocale(locale) {
+		this.locationInfo.locale = locale;
+	}
 	clearPersistedRoute() {
 		sessionStorage.removeItem(EMBED_ROUTE_STORAGE_KEY);
 		sessionStorage.removeItem(EMBED_ROUTE_PENDING_STORAGE_KEY);
@@ -338,6 +349,7 @@ var IframeManager = class {
 		const url = new URL(path, this.baseUrl);
 		url.searchParams.set("sdk", "true");
 		if (bootstrapToken) url.searchParams.set("token", bootstrapToken);
+		if (this.locationInfo.locale) url.searchParams.set("locale", this.locationInfo.locale);
 		return url.toString();
 	}
 	resolveInitialPath() {
@@ -532,8 +544,8 @@ function ensureDefaultInlineContainerStyles() {
 	const style = document.createElement("style");
 	style.id = DEFAULT_IFRAME_CONTAINER_STYLE_ID;
 	style.textContent = `
-  :where(#weTransform_iframeContainer) {
-    width: 1080px;
+  :where(.weTransform_iframeContainer) {
+    width: min(1080px, 100%);
     height: 720px;
     border: 0;
     position: relative;
@@ -676,16 +688,19 @@ var UiHost = class {
 		if (this.config.mountElement instanceof HTMLElement) {
 			this.inlineContainer = this.config.mountElement;
 			this.ownsInlineContainer = false;
+			this.config.mountElement.classList.add("weTransform_iframeContainer");
 			return this.config.mountElement;
 		}
 		const existingMountElement = document.getElementById(this.config.mountElement);
 		if (existingMountElement) {
 			this.inlineContainer = existingMountElement;
 			this.ownsInlineContainer = false;
+			existingMountElement.classList.add("weTransform_iframeContainer");
 			return existingMountElement;
 		}
 		const container = document.createElement("div");
 		container.id = this.config.mountElement;
+		container.classList.add("weTransform_iframeContainer");
 		document.body.appendChild(container);
 		this.inlineContainer = container;
 		this.ownsInlineContainer = true;
@@ -709,19 +724,23 @@ function createWeTransform(config) {
 	if (typeof window === "undefined") throw new Error("WeTransform SDK must run in a browser context.");
 	ensureDefaultInlineContainerStyles();
 	const baseUrl = resolveBaseUrl(config.organizationHandle);
-	const apiUrl = resolveApiUrl(config.organizationHandle, config.locale);
+	let currentLocale = config.locale ?? "en";
+	const resolveCurrentApiUrl = () => {
+		return resolveApiUrl(config.organizationHandle, currentLocale);
+	};
 	const events = new EventEmitter();
 	const uiHost = new UiHost({
 		displayAsModal: config.displayAsModal ?? true,
 		mountElement: config.mountElement ?? "weTransform_iframeContainer"
 	});
-	const authBridge = new AuthBridge(apiUrl, config.authentication, (payload) => {
+	const authBridge = new AuthBridge(resolveCurrentApiUrl(), config.authentication, (payload) => {
 		events.emit("error", payload);
 	});
 	const iframeManager = new IframeManager(baseUrl, events, authBridge, {
 		initialLocation: config.initialLocation,
 		templateHandle: config.authentication.templateHandle,
-		sourceId: config.authentication.sourceId
+		sourceId: config.authentication.sourceId,
+		locale: currentLocale
 	});
 	const revokeOnPageUnload = () => {
 		authBridge.revokeSession({ bestEffort: true });
@@ -736,6 +755,12 @@ function createWeTransform(config) {
 	let openingPromise = null;
 	let currentOpenAbortController = null;
 	let stopWaitingForReady = null;
+	let localeTransitionQueue = Promise.resolve();
+	const requestLogoutBestEffort = async () => {
+		try {
+			await iframeManager.requestLogout();
+		} catch {}
+	};
 	const open = async () => {
 		if (status !== "idle") return;
 		status = "opening";
@@ -801,7 +826,7 @@ function createWeTransform(config) {
 		currentOpenAbortController?.abort();
 		if (wasOpening) {
 			stopWaitingForReady?.();
-			await iframeManager.requestLogout();
+			await requestLogoutBestEffort();
 			iframeManager.unmount();
 			iframeManager.clearPersistedRoute();
 			uiHost.cancelOpening();
@@ -810,7 +835,7 @@ function createWeTransform(config) {
 			return;
 		}
 		if (wasOpen) {
-			await iframeManager.requestLogout();
+			await requestLogoutBestEffort();
 			iframeManager.unmount();
 			uiHost.close();
 			iframeManager.clearPersistedRoute();
@@ -818,6 +843,31 @@ function createWeTransform(config) {
 			events.emit("close");
 		}
 	};
+	const runSetLocale = async (nextLocale) => {
+		if (status === "destroyed") return;
+		if (nextLocale === currentLocale) return;
+		const wasOpening = status === "opening";
+		const wasOpen = status === "open";
+		currentLocale = nextLocale;
+		authBridge.setApiUrl(resolveCurrentApiUrl());
+		iframeManager.updateLocale(currentLocale);
+		if (wasOpen) {
+			await iframeManager.setLocale(currentLocale, currentOpenAbortController?.signal ?? void 0);
+			return;
+		}
+		if (wasOpening) {
+			const openingInFlight = openingPromise;
+			if (!openingInFlight) return;
+			await openingInFlight;
+			if (status === "open") await iframeManager.setLocale(currentLocale);
+		}
+	};
+	const setLocale = async (nextLocale) => {
+		if (status === "destroyed") throw new Error("Cannot set locale after destroy.");
+		const transition = localeTransitionQueue.then(() => runSetLocale(nextLocale));
+		localeTransitionQueue = transition.catch(() => void 0);
+		await transition;
+	};
 	const destroy = async () => {
 		if (status === "destroyed") return;
 		currentOpenAbortController?.abort();
@@ -839,6 +889,7 @@ function createWeTransform(config) {
 		open,
 		close,
 		destroy,
+		setLocale,
 		on
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wetransform/core",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "license": "ISC",
   "files": [
     "dist/**"
@@ -12,24 +12,23 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "VITE_MODE=production vp pack",
-    "dev": "vp pack --watch",
-    "lint": "vp lint --type-aware --type-check .",
-    "test": "vp test run",
-    "publish": "npm publish"
-  },
   "dependencies": {
     "focus-trap": "^8.0.1",
     "penpal": "^7.0.6"
   },
   "devDependencies": {
-    "@types/node": "catalog:",
+    "@types/node": "^24.12.0",
     "jsdom": "^29.0.1",
-    "typescript": "catalog:",
-    "vite": "catalog:",
+    "typescript": "^6.0.2",
+    "vite": "npm:@voidzero-dev/vite-plus-core@latest",
     "vite-plugin-css-injected-by-js": "^4.0.1",
-    "vite-plus": "catalog:",
-    "vitest": "catalog:"
+    "vite-plus": "^0.1.14",
+    "vitest": "npm:@voidzero-dev/vite-plus-test@latest"
+  },
+  "scripts": {
+    "build": "VITE_MODE=production vp pack",
+    "dev": "vp pack --watch",
+    "lint": "vp lint --type-aware --type-check .",
+    "test": "vp test run"
   }
-}
+}