@or-sdk/users 3.4.0 → 3.5.0

package/dist/types/types.d.ts

@@ -1,40 +1,5 @@
-import { OrderOptions, PaginationOptions, Token } from '@or-sdk/base';
-export type { CurrentMultiUserProfile } from './schemas';
-export type UsersConfig = {
-    token: Token;
-    discoveryUrl?: string;
-    accountId?: string;
-    usersUrl: string;
-    sdkUrl?: string;
-};
-export type ListUsersParams = OrderOptions & PaginationOptions & {
-    query: {
-        [key: string]: any;
-    };
-};
-export type UserItem = {
-    id: string;
-    email: string;
-    username: string;
-    data: {
-        firstName: string;
-        lastName: string;
-        contactPhone: string;
-    };
-};
-export type User = {
-    dateCreated: number;
-    accountId: string;
-    email: string;
-    role: string;
-    data: {
-        firstName: string;
-        updatedBy: string;
-    };
-    dateModified: number;
-    username: string;
-    id: string;
-};
+import { Token } from '@or-sdk/base';
+export type { Token };
 export type TokenData = {
     allow: boolean;
     tokenType: string;
@@ -51,21 +16,7 @@ export type Profile = {
     email: string;
     username: string;
 };
-export type AccountItem = {
-    id: string;
-    accountName: string;
-};
-export type AccountProfile = {
-    id: string;
-    email: string;
-    username: string;
-};
-export type ListProfilesParams = {
-    email?: string;
-    username?: string;
-    id?: string;
-};
-export type AttachResponse = {
+export type AttachResult = {
     emailSent?: boolean;
     userAttached?: boolean;
 };
@@ -85,37 +36,6 @@ export type ProfileAccountItem = {
     id: string;
     accountName: string;
 };
-export type UserAdvanced = {
-    id: string;
-    email: string;
-    dateCreated: Date;
-    disabled: boolean;
-    username: string;
-    role: string;
-    data: {
-        firstName?: string;
-        lastName?: string;
-        disableAt?: Date;
-        phoneNumber?: string;
-        permissions?: {
-            scope?: Array<string>;
-        };
-    };
-    profile?: {
-        id: string;
-        firstName?: string;
-        lastName?: string;
-        phoneNumber?: string;
-        email: string;
-        icon?: string;
-    };
-    createdBy?: string;
-    bySuperAdmin?: boolean;
-};
-export type ListUsersAdvancedParams = {
-    limit?: number;
-    offset?: number;
-};
 export type ListAccountsParams = {
     limit?: number;
     skip?: number;
@@ -124,8 +44,10 @@ export type ListAccountsParams = {
     };
     projection?: string[];
 };
-export type ListAccountsResponse = {
-    items: (AccountItem & {
+export type ListAccountsResult = {
+    items: {
+        id: string;
+        accountName: string;
         dateCreated: string;
         dateModified: string;
         disabled: boolean;
@@ -133,7 +55,7 @@ export type ListAccountsResponse = {
         data: {
             [key: string]: unknown;
         };
-    })[];
+    }[];
     total: number;
 };
 export interface ValidateParams {
@@ -154,8 +76,4 @@ export type UpdateUserParam = {
     role?: string;
     multiUserId?: string;
 };
-export type CreateUserWithMultResponse = {
-    emailSent: boolean;
-    userCreated?: true;
-};
 //# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,YAAY,EAAE,KAAK,EAAE,CAAC;AAEtB,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CAAE,CAAC;AAE5E,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAAE,CAAC;AAElF,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;CAAE,CAAC;AAEtH,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;CAAE,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KAAE,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SAAE,CAAC;KACnC,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,WAAW,CAAC,EAAE;YACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;SAClB,CAAC;KACH,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/package.json

@@ -1,39 +1,39 @@
 {
   "name": "@or-sdk/users",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "license": "Apache-2.0",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
   "scripts": {
-    "build": "pnpm clean && pnpm build:esm & pnpm build:cjs",
+    "build": "pnpm clean && concurrently 'npm:build:*(!watch)'",
     "build:cjs": "tsc --project tsconfig.json",
     "build:esm": "tsc --project tsconfig.esm.json",
     "build:types": "tsc --project tsconfig.types.json",
-    "build:watch": "concurrently -r --hide 1,2 \"pnpm build:watch:cjs\" \"pnpm build:watch:esm\" \"pnpm build:watch:types\"",
-    "build:watch:cjs": "tsc --project tsconfig.json -w",
-    "build:watch:esm": "tsc --project tsconfig.esm.json -w",
-    "build:watch:types": "tsc --project tsconfig.types.json -w",
+    "build:watch": "concurrently -r --hide 1,2 'npm:build:watch:*'",
+    "build:watch:cjs": "pnpm build:cjs -w",
+    "build:watch:esm": "pnpm build:esm -w",
+    "build:watch:types": "pnpm build:types -w",
     "clean": "rm -rf ./dist",
     "dev": "pnpm build:watch:esm",
-    "test": "vitest --run",
+    "test": "vitest",
     "test:watch": "vitest --watch"
   },
   "dependencies": {
-    "@or-sdk/base": "^0.41.0",
-    "@or-sdk/sdk-api": "^0.26.23",
+    "@or-sdk/base": "^0.42.0",
+    "@or-sdk/sdk-api": "^0.26.24",
     "validator": "^13.11.0",
-    "zod": "^3.22.4"
+    "zod": "^3.24.4"
   },
   "devDependencies": {
     "@types/validator": "^13.11.8",
     "concurrently": "9.0.1",
-    "msw": "^2.1.5",
+    "msw": "^2.8.2",
     "typescript": "5.6.2",
-    "vitest": "^0.31.1"
+    "vitest": "^3.1.3"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "5eb5630f98ec7f553db937f6f321d7224ba727bf"
+  "gitHead": "7c8a6a4bcd0ea2a445262dd9fc5a8cfd6974c8b0"
 }

package/src/Users.ts

@@ -4,27 +4,50 @@ import { SdkApi } from '@or-sdk/sdk-api';
 
 import { SERVICE_KEY } from './constants';
 import { CreateUserConflictError } from './errors';
-import { CurrentMultiUserProfile, CreateUserWithMultData } from './schemas';
 import {
-  AccountItem,
+  currentMultiUserProfileSchema,
+  createUserWithMultDataSchema,
+  upsertMultiUserParamsSchema,
+  usersConfigSchema,
+  listUsersParamsSchema,
+  getUserByIdParamsSchema,
+  listProfilesParamsSchema,
+  listUsersAdvancedParamsSchema,
+} from './schemas/index';
+import type {
   AccountProfile,
-  AttachParams,
-  AttachResponse,
+  AccountItem,
+  CreateUserWithMultData,
+  CreateUserWithMultResult,
+  CurrentMultiUserProfile,
+  GetUserByIdParams,
+  ListAccountProfilesResult,
   ListProfilesParams,
-  ListUsersParams, Profile, ProfileAccountItem, ProfileUserItem, TokenData, User, UserItem,
+  ListProfilesResult,
+  ListUsersParams,
+  ListUsersResult,
+  ListUsersAdvancedParams,
+  UserAdvanced,
+  ProfileItem,
+  UpsertMultiUserParams,
+  UpsertMultiUserResult,
+  User,
   UsersConfig,
-  UserAdvanced, ListUsersAdvancedParams,
-  ListAccountsParams, ListAccountsResponse,
+} from './schemas/index';
+import type {
+  AttachParams,
+  AttachResult,
+  Profile, ProfileAccountItem, ProfileUserItem, TokenData,
+  ListAccountsParams, ListAccountsResult,
   ValidateParams,
   UpdateUserParam,
-  CreateUserWithMultResponse,
 } from './types';
 
 export class Users extends Base {
   private readonly sdkApi!: SdkApi;
 
   constructor(params: UsersConfig) {
-    const { token, discoveryUrl = '', accountId, usersUrl, sdkUrl } = params;
+    const { token, discoveryUrl = '', accountId, usersUrl, sdkUrl } = usersConfigSchema.parse(params);
 
     super({
       token,
@@ -49,13 +72,22 @@ export class Users extends Base {
   }
 
   /**
-   * List users
+   * List users in account
+   *
    * ```typescript
-   * await users.listUsers({from:0, size: 1, orderDirection: 'asc', orderProperty: 'email', query});
+   * await users.listUsers({
+   *   from: 0,
+   *   size: 1,
+   *   orderDirection: 'asc',
+   *   orderProperty: 'email',
+   *   query: {
+   *     // optional
+   *   },
+   * });
    * ```
    */
-  public async listUsers(params = {} as ListUsersParams): Promise<List<UserItem>> {
-    const { from = 0, size, orderDirection, orderProperty, query } = params;
+  public async listUsers(params = {} as ListUsersParams): Promise<ListUsersResult> {
+    const { from = 0, size, orderDirection, orderProperty, query } = listUsersParamsSchema.parse(params);
     return this.callApiV2({
       route: '/users',
       method: 'GET',
@@ -70,21 +102,27 @@ export class Users extends Base {
   }
 
   /**
-   * Get user by Id
+   * Get account user by Id
+   *
    * ```typescript
-   * const result = await users.getUserById('user-id');
+   * const result = await users.getUserById('<user-id>');
    * ```
    */
-  public async getUserById(userId: string, projection: string[] = []): Promise<User> {
+  public async getUserById(
+    userId: GetUserByIdParams['userId'],
+    projection: GetUserByIdParams['projection'],
+  ): Promise<User> {
+    const { userId: parsedUserId, projection: parsedProjection = [] } = getUserByIdParamsSchema.parse({
+      userId,
+      projection,
+    });
     const accountPrefix = this.sdkApi.isCrossAccount ? `accounts/${this.sdkApi.currentAccountId}` : '';
-    const route = `${accountPrefix}/users/${encodeURIComponent(userId)}`;
+    const route = `${accountPrefix}/users/${encodeURIComponent(parsedUserId)}`;
 
     return this.sdkApi.makeRequest({
       route,
       method: 'GET',
-      params: {
-        projection,
-      },
+      params: { projection: parsedProjection },
     });
   }
 
@@ -109,12 +147,13 @@ export class Users extends Base {
       route: '/user/multi-user',
     });
     return validate
-      ? await CurrentMultiUserProfile.parseAsync(profile)
+      ? await currentMultiUserProfileSchema.parseAsync(profile)
       : profile;
   }
 
   /**
-   * Get account info
+   * Get account info based on given token
+   *
    * ```typescript
    * await users.getAccountInfo();
    * ```
@@ -127,12 +166,13 @@ export class Users extends Base {
   }
 
   /**
-   * List account profiles
+   * List account multi-user profiles
+   *
    * ```typescript
    * await users.listAccountProfiles();
    * ```
    */
-  public async listAccountProfiles(): Promise<List<AccountProfile>> {
+  public async listAccountProfiles(): Promise<ListAccountProfilesResult> {
     return this.callApiV2({
       route: '/account/multi-users',
       method: 'GET',
@@ -140,35 +180,40 @@ export class Users extends Base {
   }
 
   /**
-   * List profiles. Super admin only.
+   * List profiles with ability for partial match by email, username or match by id.
+   *
+   * Super admin only.
+   *
    * ```typescript
    * await users.listProfiles();
    * ```
    */
-  public async listProfiles(params = {} as ListProfilesParams): Promise<List<AccountProfile>> {
-    const data = await this.callApiV2<AccountProfile[]>({
+  public async listProfiles(params: ListProfilesParams): Promise<ListProfilesResult> {
+    const parsedParams = listProfilesParamsSchema.parse(params);
+    const data = await this.callApiV2<ProfileItem[]>({
       route: '/multi-users',
       method: 'GET',
-      params: {
-        email: params.email,
-        username: params.username,
-        id: params.id,
-      },
+      params: parsedParams,
     });
-    return makeList<AccountProfile>(data);
+    return makeList<ProfileItem>(data);
   }
 
   /**
    * List users with profile information
+   *
    * ```typescript
    * const result = await users.listUsersAdvanced();
    * ```
    */
-  public async listUsersAdvanced(params = {} as ListUsersAdvancedParams): Promise<UserAdvanced[]> {
+  public async listUsersAdvanced(params: ListUsersAdvancedParams): Promise<UserAdvanced[]> {
+    const parsedParams = listUsersAdvancedParamsSchema.parse(params);
     return this.callApiV2({
       route: '/users/advanced',
       method: 'GET',
-      params,
+      params: {
+        ...parsedParams,
+        skipShareViews: parsedParams?.skipShareViews || undefined,
+      },
     });
   }
 
@@ -177,9 +222,8 @@ export class Users extends Base {
    *
    * Super admin only.
    *
-   * @example
    * ```typescript
-   * const result = await users.getProfileByEmail('user@example.com');
+   * const result = await users.getProfileByEmail('multi-user@example.com');
    * ```
    */
   public async getProfileByEmail(email: string): Promise<AccountProfile> {
@@ -190,9 +234,9 @@ export class Users extends Base {
   }
 
   /**
-   * Get profile by Id
+   * Get multi-user profile by Id
    * ```typescript
-   * const result = await users.getProfileById('profile-id');
+   * const result = await users.getProfileById('<profile-id>');
    * ```
    */
   public async getProfileById(profileId: string): Promise<Profile> {
@@ -218,18 +262,39 @@ export class Users extends Base {
   /**
    * Attach profile.
    *
-   * Normal usage - pass only email.
+   * ### Normal: Attach current user (based on token) to multi-user profile
    *
-   * Super admin usage: Send userId if you want to attach another user instead of current.
-   * Pass password if you want to automatically create profile.
+   * Pass only multi-user email and it will begin attachment process with email verification.
+   * ```typescript
+   * await users.attachProfile({
+   *   email: 'multi-user@example.com',
+   * })
+   * ```
+   *
+   * ### Super admin: Attach another user to multi-user profile
+   * Send userId if you want to attach another user instead of current.
+   *
+   * ```typescript
+   * await users.attachProfile({
+   *   email: 'multi-user@example.com',
+   *   userId: '<user-id-uuid>',
+   * });
+   * ```
+   *
+   * ### Super admin: Attach another user to multi-user profile and create new profile if it doesn't exist
+   * Send password if you want to automatically create profile.
    *
    * ```typescript
-   * await users.attachProfile();
+   * await users.attachProfile({
+   *   email: 'multi-user@example.com',
+   *   userId: '<user-id-uuid>',
+   *   password: 's3cure_p@ss0rd!',
+   * });
    * ```
    */
-  public async attachProfile(params: AttachParams): Promise<AttachResponse> {
+  public async attachProfile(params: AttachParams): Promise<AttachResult> {
     return this.sdkApi.makeRequest({
-      route: `/accounts/${this.currentAccountId || 'current'}/multi-user/attach-start`,
+      route: `/accounts/${this.currentAccountId ?? 'current'}/multi-user/attach-start`,
       method: 'POST',
       data: {
         email: params.email,
@@ -273,7 +338,7 @@ export class Users extends Base {
    */
   public async getUserEmail(userId?: string): Promise<{ email: string; }> {
     return this.callApiV2<{ email: string; }>({
-      route: `/users/${userId || 'current'}/email`,
+      route: `/users/${userId ?? 'current'}/email`,
       method: 'GET',
     });
   }
@@ -296,7 +361,7 @@ export class Users extends Base {
   /**
    * Update user
    * ```typescript
-   * await users.updateUser(userId, user, acountId);
+   * await users.updateUser(userId, user, accountId);
    * ```
    */
   public async updateUser(userId: string, user: UpdateUserParam, accountId?: string): Promise<void> {
@@ -346,33 +411,41 @@ export class Users extends Base {
   }
 
   /**
-   * Start user with multi creation process
+   * Initiate the creation of the multi-user
+   *
+   * @example
    * ```typescript
-   * const response = await users.createUserWithMulti(userData, accountId);
+   * const { userCreated, emailSent } = await users.createUserWithMulti(userData, accountId);
+   * // userCreated === true - if user already exists
+   * // emailSent === true - if user does not exists and invitation email was sent
    * ```
-   * response.userCreated - if multi user exists.
-   * if not it will send verification email and create only after comfirmation
    */
   public async createUserWithMulti(
     userData: CreateUserWithMultData,
     accountId?: string,
-  ): Promise<CreateUserWithMultResponse> {
+  ): Promise<CreateUserWithMultResult> {
     try {
-      const data = await CreateUserWithMultData.parseAsync(userData);
+      const data = await createUserWithMultDataSchema.parseAsync(userData);
 
-      return await this.sdkApi.makeRequest<CreateUserWithMultResponse>({
-        route: `/accounts/${accountId || undefined}/multi-user/create-start`,
+      return await this.sdkApi.makeRequest<CreateUserWithMultResult>({
+        route: `/accounts/${accountId ?? undefined}/multi-user/create-start`,
         method: 'POST',
         data,
       });
     } catch (error) {
       if (error instanceof Error && error.cause instanceof AxiosError && error.cause?.response?.status === 409) {
         const errorMessage = parseAxiosErrorMessage(error.cause);
-        throw new CreateUserConflictError(errorMessage, { cause: error.cause });
+        throw new CreateUserConflictError(errorMessage, {
+          cause: error.cause,
+          statusCode: error.cause.response.status,
+        });
       }
       if (error instanceof AxiosError && error.response?.status === 409) {
         const errorMessage = parseAxiosErrorMessage(error);
-        throw new CreateUserConflictError(errorMessage, { cause: error });
+        throw new CreateUserConflictError(errorMessage, {
+          cause: error,
+          statusCode: error.response.status,
+        });
       }
       throw error;
     }
@@ -396,8 +469,8 @@ export class Users extends Base {
    * await users.listAccounts({limit, skip, query, projection});
    * ```
    */
-  public async listAccounts(params: ListAccountsParams = {}): Promise<ListAccountsResponse> {
-    const data = await this.callApiV2<{ count: number; rows: ListAccountsResponse['items']; }>({
+  public async listAccounts(params: ListAccountsParams = {}): Promise<ListAccountsResult> {
+    const data = await this.callApiV2<{ count: number; rows: ListAccountsResult['items']; }>({
       route: '/accounts',
       params,
     });
@@ -406,5 +479,32 @@ export class Users extends Base {
       items: data.rows,
     };
   }
-}
 
+  /**
+   * Upsert multi-user.
+   *
+   * If multi-user with email already exists return it, otherwise create new one with given email and password
+   *
+   * Super admin only!
+   *
+   * @example
+   * ```typescript
+   * await users.createMultiUser({
+   *   email: 'user@example.com',
+   *   password: 's3cure_p@ss0rd!',
+   *   data: {
+   *     // optional
+   *   }
+   * });
+   * ```
+   */
+  public async upsertMultiUser(params: UpsertMultiUserParams): Promise<UpsertMultiUserResult> {
+    const data = await upsertMultiUserParamsSchema.parseAsync(params);
+
+    return await this.sdkApi.makeRequest<UpsertMultiUserResult>({
+      route: '/multi-user/create',
+      method: 'PUT',
+      data,
+    });
+  }
+}

package/src/__tests__/Users.spec.ts

@@ -2,6 +2,7 @@
 
 import { http } from 'msw';
 import { afterAll, afterEach, beforeAll, describe, expect, it } from 'vitest';
+import { z } from 'zod';
 
 import { Users, UserRole, CreateUserConflictError } from '../index';
 
@@ -14,7 +15,7 @@ import {
   profileFixture,
   profileNoPhoneFixture,
   createUserWithMultiFixture,
-} from './mocks';
+} from './mocks/index';
 
 function buildUsersInstance() {
   return new Users({
@@ -35,6 +36,15 @@ describe('Users API', () => {
       expect(api.serviceUrl).toBe(USERS_URL);
       expect((api as any).sdkApi.serviceUrl).toBe(SDK_URL);
     });
+
+    it('throws error if usersUrl and discoveryUrl are not provided', () => {
+      expect(() => {
+        new Users({
+          token: 'test-token',
+          sdkUrl: SDK_URL,
+        });
+      }).toThrowErrorMatchingSnapshot();
+    });
   });
 
   describe('getCurrentMultiUserProfile', () => {
@@ -65,7 +75,7 @@ describe('Users API', () => {
       mockApiServer.use(http.get(url, errorRes(testError)) as any);
 
       const api = buildUsersInstance();
-      expect(api.getCurrentMultiUserProfile()).rejects.toThrow(testError);
+      await expect(api.getCurrentMultiUserProfile()).rejects.toThrow(testError);
     });
 
     it('show throw error on invalid response', async () => {
@@ -74,7 +84,7 @@ describe('Users API', () => {
       );
 
       const api = buildUsersInstance();
-      expect(api.getCurrentMultiUserProfile()).rejects.toThrowErrorMatchingSnapshot();
+      await expect(api.getCurrentMultiUserProfile()).rejects.toThrowErrorMatchingSnapshot();
     });
 
     it('show throw error on invalid response if validate = true', async () => {
@@ -83,7 +93,7 @@ describe('Users API', () => {
       );
 
       const api = buildUsersInstance();
-      expect(api.getCurrentMultiUserProfile({ validate: true })).rejects.toThrowErrorMatchingSnapshot();
+      await expect(api.getCurrentMultiUserProfile({ validate: true })).rejects.toThrowErrorMatchingSnapshot();
     });
 
     it('show not throw error on invalid response if validate = false', async () => {
@@ -142,7 +152,7 @@ describe('Users API', () => {
         disableAt: new Date(Date.now() - 1000 * 60 * 60 * 24).toISOString(),
       };
       const api = buildUsersInstance();
-      expect(api.createUserWithMulti(userData)).rejects.toThrowErrorMatchingSnapshot();
+      await expect(api.createUserWithMulti(userData)).rejects.toThrowErrorMatchingSnapshot();
     });
   });
 });