Merge pull request #47 from crowdin/generate-report-fnc

feat: generate report fnc

README.md

@@ -97,6 +97,7 @@ Please refer to JSDoc for more details.
 | `getSubscription`                  | returns an information about app subscription                   |
 | `convertString`                    | converts source or translation according to specified config    |
 | `getBundleConfigurationForm`       | returns UI template config for custom formatters                |
+| `generateReport`                   | generates Crowdin report, covers check if finished              |
 
 Also please have a look to working example of the [Crowdin App](https://github.com/crowdin/create-crowdin-app). It can be used as a basis for your app.
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowdin/crowdin-apps-functions",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Utility library to easily and quickly develop Crowdin App",
   "main": "out/index.js",
   "types": "out/index.d.ts",

src/crowdin.ts

@@ -1,5 +1,5 @@
 /* eslint-disable @typescript-eslint/ban-ts-ignore */
-import Crowdin, { SourceFilesModel, TranslationsModel, WebhooksModel } from '@crowdin/crowdin-api-client';
+import Crowdin, { ReportsModel, SourceFilesModel, TranslationsModel, WebhooksModel } from '@crowdin/crowdin-api-client';
 import axios from 'axios';
 
 interface UpdateOrCreateFileArgs {
@@ -574,6 +574,29 @@ export async function getSubscription({
     }
 }
 
+export async function generateReport({
+    client,
+    projectId,
+    request,
+}: {
+    client: Crowdin;
+    projectId: number;
+    request: ReportsModel.GenerateReportRequest;
+}): Promise<any | undefined> {
+    const report = await client.reportsApi.generateReport(projectId, request);
+
+    while (true) {
+        const status = await client.reportsApi.checkReportStatus(projectId, report.data.identifier);
+
+        if (status.data.status === 'finished') {
+            const downloadRes = await client.reportsApi.downloadReport(projectId, report.data.identifier);
+
+            const reportBlob = await axios.get(downloadRes.data.url);
+            return reportBlob.data;
+        }
+    }
+}
+
 export interface FileEntity {
     name: string;
     title: string;

tests/crowdin.spec.ts

@@ -8,10 +8,12 @@ import Crowdin, {
     UploadStorageModel,
     WebhooksModel,
 } from '@crowdin/crowdin-api-client';
+import axios from 'axios';
 import { createMock } from 'ts-auto-mock';
 import {
     FileEntity,
     createOrUpdateWebhook,
+    generateReport,
     getFolder,
     getOrCreateFolder,
     updateOrCreateFile,
@@ -491,3 +493,32 @@ describe('CreateOrUpdateWebhook function', () => {
         });
     });
 });
+
+describe('generateReport function', () => {
+    let client: Crowdin;
+    const projectId = 1;
+    const reportId = '123';
+    const reportUrl = 'report-url';
+    const reportBlob = 'some-data';
+    const generateReportMock = jest.fn().mockImplementation(() => ({ data: { identifier: reportId } }));
+    const checkReportStatustMock = jest.fn().mockImplementation(() => ({ data: { status: 'finished' } }));
+    const downloadReportMock = jest.fn().mockImplementation(() => ({ data: { url: reportUrl } }));
+    const axiosGet = jest.fn().mockImplementation(() => ({ data: reportBlob }));
+
+    beforeEach(() => {
+        jest.mock('axios');
+        client = createMock<Crowdin>({
+            reportsApi: {
+                generateReport: generateReportMock,
+                checkReportStatus: checkReportStatustMock,
+                downloadReport: downloadReportMock,
+            },
+        });
+        axios.get = axiosGet;
+    });
+
+    it('should generate report', async () => {
+        const res = await generateReport({ client, projectId, request: { name: 'test', schema: {} } });
+        expect(res).toBe(reportBlob);
+    });
+});