Add update user password method (#794)

## Description

Adds the update user password method for the user management API

## Documentation

Does this require changes to the WorkOS Docs? E.g. the [API
Reference](https://workos.com/docs/reference) or code snippets need
updates.

```
[ ] Yes
```

If yes, link a related docs PR and add a docs maintainer as a reviewer.
Their approval is required.

Author: danerwilliams

src/users/interfaces/index.ts

@@ -11,3 +11,4 @@ export * from './remove-user-from-organization-options.interface';
 export * from './revoke-session-options.interface';
 export * from './user.interface';
 export * from './verify-session.interface';
+export * from './update-user-password-options.interface';

src/users/interfaces/update-user-password-options.interface.ts

@@ -0,0 +1,8 @@
+export interface UpdateUserPasswordOptions {
+  userId: string;
+  password: string;
+}
+
+export interface SerializedUpdateUserPasswordOptions {
+  password: string;
+}

src/users/serializers/index.ts

@@ -7,5 +7,6 @@ export * from './create-password-reset-challenge.serializer';
 export * from './create-user-options.serializer';
 export * from './revoke-session-options.serializer';
 export * from './session.serializer';
+export * from './update-user-password-options.serializer';
 export * from './user.serializer';
 export * from './verify-session.serializer';

src/users/serializers/update-user-password-options.serializer.ts

@@ -0,0 +1,10 @@
+import {
+  SerializedUpdateUserPasswordOptions,
+  UpdateUserPasswordOptions,
+} from '../interfaces';
+
+export const serializeUpdateUserPasswordOptions = (
+  options: UpdateUserPasswordOptions,
+): SerializedUpdateUserPasswordOptions => ({
+  password: options.password,
+});

src/users/users.spec.ts

@@ -328,4 +328,19 @@ describe('UserManagement', () => {
       });
     });
   });
+
+  describe('updateUserPassword', () => {
+    it('sends a updateUserPassword request', async () => {
+      mock.onPut(`/users/${userId}/password`).reply(200, userFixture);
+      const resp = await workos.users.updateUserPassword({
+        userId,
+        password: 'secure',
+      });
+
+      expect(mock.history.put[0].url).toEqual(`/users/${userId}/password`);
+      expect(resp).toMatchObject({
+        email: '[email protected]',
+      });
+    });
+  });
 });

src/users/users.ts

@@ -25,6 +25,7 @@ import {
   SerializedCreateUserOptions,
   SerializedRevokeSessionOptions,
   SerializedVerifySessionOptions,
+  UpdateUserPasswordOptions,
   User,
   UserResponse,
   VerifySessionOptions,
@@ -44,6 +45,7 @@ import {
   serializeCreatePasswordResetChallengeOptions,
   serializeCreateUserOptions,
   serializeRevokeSessionOptions,
+  serializeUpdateUserPasswordOptions,
   serializeVerifySessionOptions,
 } from './serializers';
 import { deserializeList } from '../common/serializers';
@@ -217,4 +219,13 @@ export class Users {
 
     return deserializeUser(data);
   }
+
+  async updateUserPassword(payload: UpdateUserPasswordOptions): Promise<User> {
+    const { data } = await this.workos.put<UserResponse>(
+      `/users/${payload.userId}/password`,
+      serializeUpdateUserPasswordOptions(payload),
+    );
+
+    return deserializeUser(data);
+  }
 }