feat(intercom): [nan-1916] add fetch article action (#60)

## Describe your changes
Add intercom fetch articl action

## Issue ticket number and link
NAN-1916

## Checklist before requesting a review (skip if just adding/editing
APIs & templates)
- [ ] I added tests, otherwise the reason is:
- [ ] External API requests have `retries`
- [ ] Pagination is used where appropriate
- [ ] The built in `nango.paginate` call is used instead of a `while
(true)` loop
- [ ] Third party requests are NOT parallelized (this can cause issues
with rate limits)
- [ ] If a sync requires metadata the `nango.yaml` has `auto_start:
false`
- [ ] If the sync is a `full` sync then `track_deletes: true` is set

flows.yaml

@@ -3394,6 +3394,12 @@ integrations:
                 campaign_id: string
                 name: string
     intercom:
+        actions:
+            fetch-article:
+                description: Fetch a single article from Intercom
+                input: IdEntity
+                endpoint: GET /single-article
+                output: Article
         syncs:
             conversations:
                 runs: every 6 hours
@@ -3426,6 +3432,8 @@ integrations:
                 version: 1.0.0
                 endpoint: GET /articles
         models:
+            IdEntity:
+                id: string
             Contact:
                 id: string
                 workspace_id: string
@@ -3574,8 +3582,8 @@ integrations:
         models:
             JiraIssueMetadata:
                 projectIdsToSync: JiraProjectId[]
-                cloudId: string
-                baseUrl: string
+                cloudId?: string
+                baseUrl?: string
             JiraProjectId:
                 id: string
             Timestamps:

integrations/intercom/actions/fetch-article.ts

@@ -0,0 +1,20 @@
+import type { NangoAction, ProxyConfiguration, Article, IdEntity } from '../../models';
+import { toArticle } from '../mappers/to-article.js';
+
+export default async function runAction(nango: NangoAction, input: IdEntity): Promise<Article> {
+    if (!input.id) {
+        throw new nango.ActionError({
+            message: 'Id is required to delete a user'
+        });
+    }
+
+    const config: ProxyConfiguration = {
+        // https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/retrievearticle
+        endpoint: `/articles/${input.id}`,
+        retries: 10
+    };
+
+    const response = await nango.get(config);
+
+    return toArticle(response.data);
+}

integrations/intercom/nango.yaml

@@ -1,5 +1,11 @@
 integrations:
     intercom:
+        actions:
+            fetch-article:
+                description: Fetch a single article from Intercom
+                input: IdEntity
+                endpoint: GET /single-article
+                output: Article
         syncs:
             conversations:
                 runs: every 6 hours
@@ -32,6 +38,8 @@ integrations:
                 version: 1.0.0
                 endpoint: GET /articles
 models:
+    IdEntity:
+        id: string
     Contact:
         id: string
         workspace_id: string

integrations/jira/nango.yaml

@@ -45,8 +45,8 @@ integrations:
 models:
     JiraIssueMetadata:
         projectIdsToSync: JiraProjectId[]
-        cloudId: string
-        baseUrl: string
+        cloudId?: string
+        baseUrl?: string
     JiraProjectId:
         id: string
     Timestamps: