feat: allow sorting of Actors collection (#708)

Added new sorting param sortBy for the new feature described in this
[Issue](https://app.zenhub.com/workspaces/platform-team-5f6454160d9f82000fa6733f/issues/gh/apify/apify-core/20997)

I will wait until [Apify-Core
PR](apify/apify-core#21566) is deployed and then
will merge this.

Author: protoss70

src/resource_clients/actor_collection.ts

@@ -28,6 +28,7 @@ export class ActorCollectionClient extends ResourceCollectionClient {
                 limit: ow.optional.number,
                 offset: ow.optional.number,
                 desc: ow.optional.boolean,
+                sortBy: ow.optional.string.oneOf(Object.values(ActorListSortBy)),
             }),
         );
 
@@ -44,11 +45,17 @@ export class ActorCollectionClient extends ResourceCollectionClient {
     }
 }
 
+export enum ActorListSortBy {
+    CREATED_AT = 'createdAt',
+    LAST_RUN_STARTED_AT = 'lastRunStartedAt',
+}
+
 export interface ActorCollectionListOptions {
     my?: boolean;
     limit?: number;
     offset?: number;
     desc?: boolean;
+    sortBy?: ActorListSortBy;
 }
 
 export interface ActorCollectionListItem {

test/actors.test.js

@@ -1,5 +1,5 @@
 const { Browser, validateRequest, DEFAULT_OPTIONS } = require('./_helper');
-const { ApifyClient } = require('apify-client');
+const { ActorListSortBy, ApifyClient } = require('apify-client');
 const { stringifyWebhooksToBase64 } = require('../src/utils');
 const mockServer = require('./mock_server/server');
 
@@ -39,6 +39,7 @@ describe('Actor methods', () => {
                 offset: 3,
                 desc: true,
                 my: true,
+                sortBy: ActorListSortBy.CREATED_AT,
             };
 
             const res = await client.actors().list(opts);