@strivacity/sdk-nuxt 3.0.1 → 3.0.3

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## 3.0.3 (2026-08-03)
+
+### 🧱 Updated Dependencies
+
+- Updated sdk-core to 3.0.3
+
+## 3.0.2 (2026-05-12)
+
+### 🩹 Fixes
+
+- language parameter added to the login renderer component ([c8f18d9](https://github.com/Strivacity/sdk-js/commit/c8f18d9))
+
+### 🧱 Updated Dependencies
+
+- Updated sdk-core to 3.0.2
+
 ## 3.0.1 (2026-04-20)
 
 ### 🩹 Fixes

package/README.md

@@ -230,7 +230,7 @@ export const widgets = {
 
 #### Login page example
 
-The login page extracts `session_id` and optionally `language` from the URL on load, cleans up the URL, and passes them to the renderer. When a `session_id` is present the renderer calls `startSession(sessionId)` to resume the existing flow instead of starting a new one. When a `language` parameter is present it overrides `uiLocales` to display the authentication UI in the specified language.
+The login page extracts `session_id` and optionally `language` from the URL on load, cleans up the URL, and passes them to the renderer. When a `session_id` is present the renderer calls `startSession(sessionId)` to resume the existing flow instead of starting a new one. When a `language` parameter is present it is passed to the renderer which uses it for the authentication UI and emits the resolved language back via `v-model:language`.
 
 ```vue
 <script setup lang="ts">
@@ -240,10 +240,16 @@ import { widgets } from '~/components/widgets';
 
 const router = useRouter();
 const sessionId = ref<string | null>(null);
+const language = ref<string | null>(null);
 
 if (window.location.search !== '') {
 	const url = new URL(window.location.href);
 	sessionId.value = url.searchParams.get('session_id');
+
+	if (url.searchParams.has('language')) {
+		language.value = url.searchParams.get('language');
+	}
+
 	url.search = '';
 	history.replaceState({}, '', url.toString());
 }
@@ -276,6 +282,7 @@ const onBlockReady = ({ previousState, state }: { previousState: LoginFlowState;
 
 <template>
 	<StyLoginRenderer
+		v-model:language="language"
 		:widgets="widgets"
 		:session-id="sessionId"
 		@fallback="onFallback"
@@ -446,6 +453,59 @@ export class MyLogger implements SDKLogging {
 
 The `SDKLogging` interface requires `debug`, `info`, `warn`, and `error` methods. The optional `xEventId` property, when set by the SDK, provides a correlation ID to trace related log messages across the authentication flow.
 
+## HTTP Client
+
+The SDK uses a built-in `fetch`-based HTTP client for all requests. You can replace it with your own implementation by extending `SDKHttpClient` and passing your class via the `httpClient` option. This is useful when you need to attach custom headers (e.g. `x-sty-app-id`) to every outgoing request or route traffic through a proxy.
+
+### Adding custom headers to every request
+
+```typescript
+// nuxt.config.ts
+import { SDKHttpClient, type HttpClientResponse } from '@strivacity/sdk-nuxt';
+
+class CustomHttpClient extends SDKHttpClient {
+	async request<T>(url: string, options?: RequestInit): Promise<HttpClientResponse<T>> {
+		const mergedOptions: RequestInit = {
+			...options,
+			headers: {
+				'x-sty-app-id': 'my-app',
+				...(options?.headers as Record<string, string>),
+			},
+		};
+
+		const response = await fetch(url, mergedOptions);
+
+		return {
+			headers: response.headers,
+			ok: response.ok,
+			status: response.status,
+			statusText: response.statusText,
+			url: response.url,
+			json: async () => (await response.json()) as T,
+			text: async () => await response.text(),
+		};
+	}
+}
+
+export default defineNuxtConfig({
+	modules: ['@strivacity/sdk-nuxt'],
+	strivacity: {
+		// ...other options
+		httpClient: CustomHttpClient,
+	},
+});
+```
+
+Any header you add inside `request()` is automatically included in every SDK request
+
+### CORS configuration
+
+For custom request headers to reach the Strivacity cluster, the cluster must be configured to explicitly allow them. Add the header name(s) to the **Access-Control-Allow-Headers** list in the cluster settings. Without this, browsers will block the preflight `OPTIONS` request and the SDK call will fail with a CORS error.
+
+```
+Access-Control-Allow-Headers: x-sty-app-id, <any other custom headers>
+```
+
 ## API Documentation
 
 ### `useStrivacity` composable
@@ -515,6 +575,7 @@ Auto-imported in `native` mode to render the authentication UI with your own wid
 - **`params?: NativeParams`**: Additional parameters for the native login flow.
 - **`widgets?: PartialRecord<WidgetType, Vue.Component>`**: Custom Vue components for each widget type used in the flow.
 - **`sessionId?: string | null`**: Session ID for resuming an existing authentication session.
+- **`language?: string | null`**: Language tag (e.g. `"en-US"`) for the authentication UI. Defaults to `navigator.language`. Supports two-way binding via `v-model:language` — after the session starts the component emits the resolved language back to the parent. See the [Translations](https://docs.strivacity.com/docs/translations) page to learn about language precedence implemented by the product.
 
 **Events**
 
@@ -523,6 +584,7 @@ Auto-imported in `native` mode to render the authentication UI with your own wid
 - **`@error`**: Emitted when an error occurs during authentication.
 - **`@global-message`**: Emitted when the flow wants to display a global message (e.g. account lockout warning).
 - **`@block-ready`**: Emitted on flow state transitions. Receives `{ previousState: LoginFlowState; state: LoginFlowState }`. Useful for analytics and custom logging.
+- **`@update:language`**: Emitted after the session starts with the resolved language string. Used automatically by `v-model:language`.
 
 ## Vulnerability Reporting
 

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@strivacity/sdk-nuxt",
   "configKey": "strivacity",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/runtime/login-renderer.vue

@@ -7,9 +7,10 @@ const { sdk } = useStrivacity();
 const props = defineProps({
   params: { type: Object, required: false, default: () => ({}) },
   widgets: { type: null, required: false, default: () => ({}) },
+  language: { type: [String, null], required: false, default: navigator.language },
   sessionId: { type: [String, null], required: false, default: null }
 });
-const emit = defineEmits(["login", "fallback", "close", "error", "globalMessage", "blockReady"]);
+const emit = defineEmits(["login", "fallback", "close", "error", "globalMessage", "blockReady", "update:language"]);
 const WidgetRenderer = defineComponent({
   props: {
     items: {
@@ -69,7 +70,8 @@ provide("nativeFlowContext", {
 });
 onMounted(async () => {
   try {
-    const data = await loginHandler.startSession(props.sessionId);
+    const data = await loginHandler.startSession(props.sessionId, props.language);
+    emit("update:language", loginHandler.language);
     if (data) {
       await handleResponse(data);
     }

package/dist/runtime/login-renderer.vue.d.ts

@@ -4,6 +4,7 @@ import { FallbackError } from '@strivacity/sdk-core';
 type __VLS_Props = {
     params?: NativeParams;
     widgets?: PartialRecord<WidgetType, Component>;
+    language?: string | null;
     sessionId?: string | null;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -16,6 +17,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         previousState: LoginFlowState;
         state: LoginFlowState;
     }) => any;
+    "update:language": (args_0: string | null) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onLogin?: ((args_0: IdTokenClaims | null | undefined) => any) | undefined;
     onError?: ((args_0: any) => any) | undefined;
@@ -26,9 +28,11 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         previousState: LoginFlowState;
         state: LoginFlowState;
     }) => any) | undefined;
+    "onUpdate:language"?: ((args_0: string | null) => any) | undefined;
 }>, {
     params: NativeParams;
     widgets: PartialRecord<WidgetType, Component>;
+    language: string | null;
     sessionId: string | null;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strivacity/sdk-nuxt",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "license": "MIT",
   "description": "Strivacity Nuxt SDK client",
   "author": "strivacity <opensource@strivacity.com>",
@@ -10,7 +10,7 @@
   },
   "type": "module",
   "dependencies": {
-    "@strivacity/sdk-core": "3.0.1"
+    "@strivacity/sdk-core": "3.0.3"
   },
   "main": "./dist/module.mjs",
   "types": "./dist/types.d.mts",