feat(integration-template): add sharepoint fetch-file action (NangoHQ#2551)

## Describe your changes

- Added a sharepoint `fetch-file` action that accepts `siteId` and
`itemId` as inputs and returns the file id and latest `download_url`.

## Issue ticket number and link

[EXT-113](https://linear.app/nango/issue/EXT-113/sharepoint-add-nango-action-to-download-a-file-with-an-update-access)
## Checklist before requesting a review (skip if just adding/editing
APIs & templates)
- [ ] I added tests, otherwise the reason is: 
- [ ] I added observability, otherwise the reason is:
- [ ] I added analytics, otherwise the reason is:

Author: hassan254-prog

integration-templates/sharepoint-online/actions/fetch-file.ts

@@ -0,0 +1,43 @@
+import type { NangoAction, FetchFile, FetchFileInput } from '../../models';
+import type { SharepointFetchFile } from '../types';
+
+/**
+ * Fetches the latest file download URL from SharePoint, which can be used to download the actual file by making an XMLHttpRequest.
+ * @param nango - The NangoAction instance used to interact with the external API.
+ * @param input - Object containing siteId and itemId.
+ * @returns A Promise that resolves with the FetchFile.
+ */
+export default async function runAction(nango: NangoAction, input: FetchFileInput): Promise<FetchFile> {
+    validate(nango, input);
+
+    const response = await nango.get<SharepointFetchFile>({
+        endpoint: `/v1.0/sites/${input.siteId}/drive/items/${input.itemId}`,
+        params: {
+            select: 'id, @microsoft.graph.downloadUrl'
+        }
+    });
+
+    return {
+        id: response.data.id,
+        download_url: response.data['@microsoft.graph.downloadUrl'] ?? null
+    };
+}
+
+/**
+ * Validates the input to ensure it contains the required fields.
+ * @param nango - The NangoAction instance used for error handling.
+ * @param input - The input to validate.
+ */
+function validate(nango: NangoAction, input: FetchFileInput) {
+    if (!input.siteId) {
+        throw new nango.ActionError({
+            message: 'Missing required parameter: siteId'
+        });
+    }
+
+    if (!input.itemId) {
+        throw new nango.ActionError({
+            message: 'Missing required parameter: itemId'
+        });
+    }
+}

integration-templates/sharepoint-online/nango.yaml

@@ -10,6 +10,16 @@ integrations:
                     - offline_access
                 output: SharePointMetadata
                 version: 1.0.0
+            fetch-file:
+                description: |
+                    This action will be used to fetch the latest file download_url which can be used to download the actual file.
+                endpoint: GET /sharepoint/fetch-file
+                scopes:
+                    - Sites.ReadWrite.All
+                    - offline_access
+                output: FetchFile
+                input: FetchFileInput
+                version: 1.0.0
         syncs:
             file-sync:
                 description: |
@@ -45,3 +55,9 @@ models:
         webUrl: string
     SharePointMetadata:
         sitesToSync: Site[]
+    FetchFileInput:
+        siteId: string
+        itemId: string
+    FetchFile:
+        id: string
+        download_url: string | null

integration-templates/sharepoint-online/types.ts

@@ -225,3 +225,9 @@ export interface DriveItem {
     webDavUrl?: string;
     webUrl?: string;
 }
+
+export interface SharepointFetchFile {
+    '@odata.context': string;
+    id: string;
+    '@microsoft.graph.downloadUrl'?: string;
+}

packages/shared/flows.yaml

@@ -2725,6 +2725,17 @@ integrations:
                     - offline_access
                 output: SharePointMetadata
                 version: 1.0.0
+            fetch-file:
+                description: >
+                    This action will be used to fetch the latest file download_url which
+                    can be used to download the actual file.
+                endpoint: GET /sharepoint/fetch-file
+                scopes:
+                    - Sites.ReadWrite.All
+                    - offline_access
+                output: FetchFile
+                input: FetchFileInput
+                version: 1.0.0
         syncs:
             file-sync:
                 description: >
@@ -2761,6 +2772,12 @@ integrations:
                 webUrl: string
             SharePointMetadata:
                 sitesToSync: Site[]
+            FetchFileInput:
+                siteId: string
+                itemId: string
+            FetchFile:
+                id: string
+                download_url: string | null
     slack:
         syncs:
             users: