Add Notes

Author: Volo

README.md

@@ -948,6 +948,34 @@ const response = await client.messages.create({
 });
 ```
 
+### Notes
+
+#### [Create a note](https://developers.intercom.com/intercom-api-reference/reference/create-note-for-contact)
+
+```typescript
+const response = await client.notes.create({
+    adminId: '12345',
+    body: 'Shiny',
+    contactId: '5678',
+});
+```
+
+#### [Retrieve a note](https://developers.intercom.com/intercom-api-reference/reference/view-a-note)
+
+```typescript
+const response = await client.notes.find({ id: '123' });
+```
+
+#### [List all notes](https://developers.intercom.com/intercom-api-reference/reference/list-notes-of-contact)
+
+```typescript
+const response = await client.notes.list({
+    contactId: '123',
+    page: 2,
+    perPage: 3,
+});
+```
+
 ### Segments
 
 #### [Retrieve a segment](https://developers.intercom.com/intercom-api-reference/reference/view-a-segment)

lib/admin/admin.types.ts

@@ -8,5 +8,5 @@ export interface AdminObject {
     away_mode_reassign: boolean;
     has_inbox_seat: boolean;
     team_ids: Array<number>;
-    avatar: string;
+    avatar: string | { image_url: string };
 }

lib/article.ts

@@ -3,7 +3,11 @@ import {
     ArticleObject,
     TranslatedContentObject,
 } from './article/article.types';
-import { GenericDeletedResponse, Paginated } from './common/common.types';
+import {
+    GenericDeletedResponse,
+    OperationById,
+    Paginated,
+} from './common/common.types';
 
 export default class Article {
     public readonly baseUrl = 'articles';
@@ -99,10 +103,6 @@ interface CreateArticleData {
     translatedContent?: Omit<TranslatedContentObject, 'type'>;
 }
 
-interface OperationById {
-    id: string;
-}
-
 type ArticleFindByIdData = OperationById;
 
 type UpdateArticleData = Partial<CreateArticleData> & OperationById;

lib/client.ts

@@ -10,8 +10,9 @@ import Contact from './contact';
 import DataAttribute from './dataAttribute';
 import Event from './event';
 import HelpCenter from './helpCenter';
-import Segment from './segment';
 import Message from './message';
+import Note from './note';
+import Segment from './segment';
 import Team from './team';
 import Tag from './tag';
 import Visitor from './visitor';
@@ -59,6 +60,7 @@ export default class Client {
     events: Event;
     helpCenter: HelpCenter;
     messages: Message;
+    notes: Note;
     segments: Segment;
     passwordPart?: string;
     propertiesToOmitInRequestOpts: string[];
@@ -90,6 +92,7 @@ export default class Client {
         this.events = new Event(this);
         this.helpCenter = new HelpCenter(this);
         this.messages = new Message(this);
+        this.notes = new Note(this);
         this.segments = new Segment(this);
         this.tags = new Tag(this);
         this.teams = new Team(this);

lib/common/common.types.ts

@@ -69,3 +69,7 @@ export interface GenericDeletedResponse<ObjectType extends string> {
     object: ObjectType;
     deleted: boolean;
 }
+
+export interface OperationById {
+    id: string;
+}

lib/helpCenter.ts

@@ -1,5 +1,9 @@
 import { Client } from '.';
-import { GenericDeletedResponse, Paginated } from './common/common.types';
+import {
+    GenericDeletedResponse,
+    OperationById,
+    Paginated,
+} from './common/common.types';
 import {
     CollectionObject,
     GroupTranslatedContentObject,
@@ -165,7 +169,3 @@ type SectionListData = {
 };
 
 type SectionListResponse = Paginated<SectionObject>;
-
-interface OperationById {
-    id: string;
-}

lib/index.ts

@@ -34,6 +34,7 @@ export * from './dataAttribute/dataAttribute.types';
 export * from './event/event.types';
 export * from './helpCenter/helpCenter.types';
 export * from './message/message.types';
+export * from './note/note.types';
 export * from './segment/segment.types';
 export * from './subscription/subscription.types';
 export * from './tag/tag.types';

lib/note.ts

@@ -0,0 +1,54 @@
+import { Client, NoteObject } from '.';
+import { OperationById, Paginated } from './common/common.types';
+
+export default class Note {
+    public readonly baseUrl = 'notes';
+
+    constructor(private readonly client: Client) {
+        this.client = client;
+    }
+
+    create({ adminId, body, contactId }: CreateNoteData) {
+        const data = {
+            admin_id: adminId,
+            body,
+        };
+
+        return this.client.post<NoteObject>({
+            url: `/${this.client.contacts.baseUrl}/${contactId}/${this.baseUrl}`,
+            data,
+        });
+    }
+    find({ id }: FindNoteByIdData) {
+        return this.client.get<NoteObject>({
+            url: `/${this.baseUrl}/${id}`,
+        });
+    }
+    list({ contactId, page, perPage: per_page }: ListNotesData) {
+        const params = {
+            page,
+            per_page,
+        };
+
+        return this.client.get<ListNotesResponse>({
+            url: `/${this.client.contacts.baseUrl}/${contactId}/${this.baseUrl}`,
+            params,
+        });
+    }
+}
+
+interface CreateNoteData {
+    adminId: string;
+    body: string;
+    contactId: string;
+}
+
+type FindNoteByIdData = OperationById;
+
+type ListNotesData = {
+    contactId: string;
+    page?: number;
+    perPage?: number;
+};
+
+type ListNotesResponse = Paginated<NoteObject>;

lib/note/note.types.ts

@@ -0,0 +1,22 @@
+import { AdminObject, Timestamp } from '..';
+
+export type NoteObject = {
+    type: 'note';
+    id: string;
+    created_at: Timestamp;
+    contact: {
+        type: 'contact';
+        id: string;
+    };
+    author?: Pick<
+        AdminObject,
+        | 'type'
+        | 'id'
+        | 'name'
+        | 'email'
+        | 'away_mode_enabled'
+        | 'away_mode_reassign'
+        | 'avatar'
+    >;
+    body: string;
+};

package.json

@@ -1,6 +1,6 @@
 {
     "name": "intercom-client",
-    "version": "3.0.1",
+    "version": "3.1.0",
     "description": "Official Node bindings to the Intercom API",
     "homepage": "https://github.com/intercom/intercom-node",
     "bugs:": "https://github.com/intercom/intercom-node/issues",