From cecd0db8038bdb271ad905f23e3edf0152661346 Mon Sep 17 00:00:00 2001
From: Asaf Shen <asaf@descope.com>
Date: Mon, 1 Jun 2026 10:47:33 +0300
Subject: [PATCH 1/2] feat(user): add locale option to invite and invite-batch

Plumb a locale string through both forms of invite() (options-object
and positional) and through inviteBatch() so callers can override
which message template variant the backend sends.

- user.ts: add locale to the options-object overload, the positional
  overload, and both inviteBatch and invite request bodies
- user.test.ts: assert the field reaches the wire on both paths
---
 lib/management/user.test.ts | 7 +++++++
 lib/management/user.ts      | 6 ++++++
 2 files changed, 13 insertions(+)

diff --git a/lib/management/user.test.ts b/lib/management/user.test.ts
index 13c3ebdfb..febb78dab 100644
--- a/lib/management/user.test.ts
+++ b/lib/management/user.test.ts
@@ -326,6 +326,7 @@ describe('Management User', () => {
         inviteUrl: 'https://invite.me',
         sendMail: true,
         templateOptions: { k1: 'v1' },
+        locale: 'en-US',
       });
 
       expect(mockHttpClient.post).toHaveBeenCalledWith(apiPaths.user.create, {
@@ -337,6 +338,7 @@ describe('Management User', () => {
         inviteUrl: 'https://invite.me',
         sendMail: true,
         templateOptions: { k1: 'v1' },
+        locale: 'en-US',
       });
 
       expect(resp).toEqual({
@@ -407,6 +409,10 @@ describe('Management User', () => {
         ],
         'https://invite.me',
         true,
+        undefined,
+        undefined,
+        undefined,
+        'fr-FR',
       );
 
       expect(mockHttpClient.post).toHaveBeenCalledWith(apiPaths.user.createBatch, {
@@ -437,6 +443,7 @@ describe('Management User', () => {
         invite: true,
         inviteUrl: 'https://invite.me',
         sendMail: true,
+        locale: 'fr-FR',
       });
 
       expect(resp).toEqual({
diff --git a/lib/management/user.ts b/lib/management/user.ts
index 29fcc0be1..f7b0ec850 100644
--- a/lib/management/user.ts
+++ b/lib/management/user.ts
@@ -230,6 +230,7 @@ const withUser = (httpClient: HttpClient) => {
       sendSMS?: boolean; // send invite via text message, default is according to project settings
       templateOptions?: TemplateOptions;
       templateId?: string;
+      locale?: string; // locale for the invite message
     },
   ): Promise<SdkResponse<UserResponse>>;
   function invite(
@@ -251,6 +252,7 @@ const withUser = (httpClient: HttpClient) => {
     familyName?: string,
     additionalLoginIds?: string[],
     templateId?: string,
+    locale?: string, // locale for the invite message
   ): Promise<SdkResponse<UserResponse>>;
 
   function invite(
@@ -272,6 +274,7 @@ const withUser = (httpClient: HttpClient) => {
     familyName?: string,
     additionalLoginIds?: string[],
     templateId?: string,
+    locale?: string, // locale for the invite message
   ): Promise<SdkResponse<UserResponse>> {
     // We support both the old and new parameters forms of invite user
     // 1. The new form - invite(loginIdOrUserId, { email, phone, ... }})
@@ -298,6 +301,7 @@ const withUser = (httpClient: HttpClient) => {
             sendSMS,
             additionalLoginIds,
             templateId,
+            locale,
           }
         : {
             loginId: loginIdOrUserId,
@@ -511,6 +515,7 @@ const withUser = (httpClient: HttpClient) => {
       sendSMS?: boolean, // send invite via text message, default is according to project settings
       templateOptions?: TemplateOptions,
       templateId?: string,
+      locale?: string, // locale for the invite message
     ): Promise<SdkResponse<CreateOrInviteBatchResponse>> =>
       transformResponse<CreateOrInviteBatchResponse, CreateOrInviteBatchResponse>(
         httpClient.post(apiPaths.user.createBatch, {
@@ -521,6 +526,7 @@ const withUser = (httpClient: HttpClient) => {
           sendSMS,
           templateOptions,
           templateId,
+          locale,
         }),
         (data) => data,
       ),

From 074407efc26985ad16de20c30fb5a74cbb64e984 Mon Sep 17 00:00:00 2001
From: Asaf Shen <asaf@descope.com>
Date: Mon, 1 Jun 2026 11:06:36 +0300
Subject: [PATCH 2/2] test(user): assert locale on positional invite overload

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 lib/management/user.test.ts | 44 +++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/lib/management/user.test.ts b/lib/management/user.test.ts
index febb78dab..c716272e4 100644
--- a/lib/management/user.test.ts
+++ b/lib/management/user.test.ts
@@ -308,6 +308,50 @@ describe('Management User', () => {
       });
     });
 
+    it('should send locale via the positional arguments overload', async () => {
+      const httpResponse = {
+        ok: true,
+        json: () => mockMgmtUserResponse,
+        clone: () => ({
+          json: () => Promise.resolve(mockMgmtUserResponse),
+        }),
+        status: 200,
+      };
+      mockHttpClient.post.mockResolvedValue(httpResponse);
+
+      await management.user.invite(
+        'loginId',
+        'a@b.c',
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+        'en-US',
+      );
+
+      expect(mockHttpClient.post).toHaveBeenCalledWith(
+        apiPaths.user.create,
+        expect.objectContaining({
+          loginId: 'loginId',
+          email: 'a@b.c',
+          locale: 'en-US',
+          invite: true,
+        }),
+      );
+    });
+
     it('should send the correct request and receive correct response with options argument', async () => {
       const httpResponse = {
         ok: true,