feat: presence.updatePresenceByUserCode (#52)

Author: miyajan

docs/presence.md

@@ -3,6 +3,7 @@
 - [getPresenceByUserID](#getpresencebyuserid)
 - [getPresenceByUserCode](#getpresencebyusercode)
 - [updatePresenceByUserID](#updatepresencebyuserid)
+- [updatePresenceByUserCode](#updatepresencebyusercode)
 
 ## Overview
 
@@ -79,3 +80,24 @@ See the example response in the `Reference`.
 #### Reference
 
 - https://developer.cybozu.io/hc/ja/articles/360026939911#step1
+
+### updatePresenceByUserCode
+
+Update the presence information specified by the user code.
+
+#### Parameters
+
+| Name        |  Type  | Required | Description                                  |
+| ----------- | :----: | :------: | -------------------------------------------- |
+| code        | String |   Yes    | The user code.                               |
+| status      | Object |          | An object containing data of the status.     |
+| status.code | String |          | The status code of the presence information. |
+| notes       | String |          | The memo.                                    |
+
+#### Returns
+
+See the example response in the `Reference`.
+
+#### Reference
+
+- https://developer.cybozu.io/hc/ja/articles/360026939911#step2

src/client/PresenceClient.ts

@@ -35,4 +35,17 @@ export class PresenceClient {
     const data = (rest as unknown) as Record<string, unknown>;
     return this.client.patch(path, data);
   }
+
+  public updatePresenceByUserCode(params: {
+    code: string;
+    status?: {
+      code?: string;
+    };
+    notes?: string;
+  }): Promise<Presence> {
+    const { code, ...rest } = params;
+    const path = buildPath({ endpointName: `presence/users/code/${code}` });
+    const data = (rest as unknown) as Record<string, unknown>;
+    return this.client.patch(path, data);
+  }
 }

src/client/__tests__/PresenceClient.test.ts

@@ -80,4 +80,33 @@ describe("PresenceClient", () => {
       });
     });
   });
+
+  describe("updatePresenceByUserCode", () => {
+    const params = {
+      code: "cybozu",
+      status: {
+        code: "attend",
+      },
+      notes: "This is presence note.",
+    };
+    beforeEach(async () => {
+      await presenceClient.updatePresenceByUserCode(params);
+    });
+    it("should pass the path to the http client", () => {
+      expect(mockClient.getLogs()[0].path).toBe(
+        "/api/v1/presence/users/code/cybozu"
+      );
+    });
+    it("should send a patch request", () => {
+      expect(mockClient.getLogs()[0].method).toBe("patch");
+    });
+    it("should pass status and notes as a param to the http client", () => {
+      expect(mockClient.getLogs()[0].params).toEqual({
+        status: {
+          code: "attend",
+        },
+        notes: "This is presence note.",
+      });
+    });
+  });
 });