feat: add log() method to BuildClient (#509)

This exposes the new /actor-builds/:build_id/log endpoint.

For more information, see the API reference at:
https://docs.apify.com/api/v2/#/reference/actor-builds/build-log

src/resource_clients/build.ts

@@ -1,6 +1,7 @@
 import { ACT_JOB_TERMINAL_STATUSES } from '@apify/consts';
 import ow from 'ow';
 
+import { LogClient } from './log';
 import { ApiClientSubResourceOptions } from '../base/api_client';
 import { ResourceClient } from '../base/resource_client';
 import {
@@ -69,6 +70,15 @@ export class BuildClient extends ResourceClient {
 
         return this._waitForFinish(options);
     }
+
+    /**
+     * https://docs.apify.com/api/v2#/reference/actor-builds/build-log
+     */
+    log(): LogClient {
+        return new LogClient(this._subResourceOptions({
+            resourcePath: 'log',
+        }));
+    }
 }
 
 export interface BuildClientGetOptions {

test/builds.test.js

@@ -108,5 +108,17 @@ describe('Build methods', () => {
             expect(browserRes).toEqual(res);
             validateRequest({ waitForFinish: 0 }, { buildId });
         });
+
+        test('log().get() works', async () => {
+            const buildId = 'some-build-id';
+
+            const resource = await client.build(buildId).log().get();
+            expect(resource).toEqual('build-log');
+            validateRequest({}, { buildId });
+
+            const browserRes = await page.evaluate((id) => client.build(id).log().get(), buildId);
+            expect(browserRes).toEqual('build-log');
+            validateRequest({}, { buildId });
+        });
     });
 });

test/mock_server/routes/builds.js

@@ -7,6 +7,7 @@ const builds = express.Router();
 const ROUTES = [
     { id: 'get-build', method: 'GET', path: '/:buildId', type: 'responseJsonMock' },
     { id: 'abort-build', method: 'POST', path: '/:buildId/abort' },
+    { id: 'build-log', method: 'GET', path: '/:buildId/log', type: 'text' },
 ];
 
 addRoutes(builds, ROUTES);