apify-test-tools 0.1.0

package/example-github-events/push.json

@@ -0,0 +1,216 @@
+{
+    "ref": "refs/heads/master",
+    "before": "e15bf2a167bec5681afef2a5c057b8a10b78850d",
+    "after": "7f9e105e4ce7881f9def76db60bd8e4e58ead9f2",
+    "repository": {
+      "id": 530628540,
+      "node_id": "R_kgDOH6C_vA",
+      "name": "store-booking",
+      "full_name": "apify-projects/store-booking",
+      "private": true,
+      "owner": {
+        "name": "apify-projects",
+        "email": "hello@apify.com",
+        "login": "apify-projects",
+        "id": 69005150,
+        "node_id": "MDEyOk9yZ2FuaXphdGlvbjY5MDA1MTUw",
+        "avatar_url": "https://avatars.githubusercontent.com/u/69005150?v=4",
+        "gravatar_id": "",
+        "url": "https://api.github.com/users/apify-projects",
+        "html_url": "https://github.com/apify-projects",
+        "followers_url": "https://api.github.com/users/apify-projects/followers",
+        "following_url": "https://api.github.com/users/apify-projects/following{/other_user}",
+        "gists_url": "https://api.github.com/users/apify-projects/gists{/gist_id}",
+        "starred_url": "https://api.github.com/users/apify-projects/starred{/owner}{/repo}",
+        "subscriptions_url": "https://api.github.com/users/apify-projects/subscriptions",
+        "organizations_url": "https://api.github.com/users/apify-projects/orgs",
+        "repos_url": "https://api.github.com/users/apify-projects/repos",
+        "events_url": "https://api.github.com/users/apify-projects/events{/privacy}",
+        "received_events_url": "https://api.github.com/users/apify-projects/received_events",
+        "type": "Organization",
+        "site_admin": false
+      },
+      "html_url": "https://github.com/apify-projects/store-booking",
+      "description": null,
+      "fork": false,
+      "url": "https://github.com/apify-projects/store-booking",
+      "forks_url": "https://api.github.com/repos/apify-projects/store-booking/forks",
+      "keys_url": "https://api.github.com/repos/apify-projects/store-booking/keys{/key_id}",
+      "collaborators_url": "https://api.github.com/repos/apify-projects/store-booking/collaborators{/collaborator}",
+      "teams_url": "https://api.github.com/repos/apify-projects/store-booking/teams",
+      "hooks_url": "https://api.github.com/repos/apify-projects/store-booking/hooks",
+      "issue_events_url": "https://api.github.com/repos/apify-projects/store-booking/issues/events{/number}",
+      "events_url": "https://api.github.com/repos/apify-projects/store-booking/events",
+      "assignees_url": "https://api.github.com/repos/apify-projects/store-booking/assignees{/user}",
+      "branches_url": "https://api.github.com/repos/apify-projects/store-booking/branches{/branch}",
+      "tags_url": "https://api.github.com/repos/apify-projects/store-booking/tags",
+      "blobs_url": "https://api.github.com/repos/apify-projects/store-booking/git/blobs{/sha}",
+      "git_tags_url": "https://api.github.com/repos/apify-projects/store-booking/git/tags{/sha}",
+      "git_refs_url": "https://api.github.com/repos/apify-projects/store-booking/git/refs{/sha}",
+      "trees_url": "https://api.github.com/repos/apify-projects/store-booking/git/trees{/sha}",
+      "statuses_url": "https://api.github.com/repos/apify-projects/store-booking/statuses/{sha}",
+      "languages_url": "https://api.github.com/repos/apify-projects/store-booking/languages",
+      "stargazers_url": "https://api.github.com/repos/apify-projects/store-booking/stargazers",
+      "contributors_url": "https://api.github.com/repos/apify-projects/store-booking/contributors",
+      "subscribers_url": "https://api.github.com/repos/apify-projects/store-booking/subscribers",
+      "subscription_url": "https://api.github.com/repos/apify-projects/store-booking/subscription",
+      "commits_url": "https://api.github.com/repos/apify-projects/store-booking/commits{/sha}",
+      "git_commits_url": "https://api.github.com/repos/apify-projects/store-booking/git/commits{/sha}",
+      "comments_url": "https://api.github.com/repos/apify-projects/store-booking/comments{/number}",
+      "issue_comment_url": "https://api.github.com/repos/apify-projects/store-booking/issues/comments{/number}",
+      "contents_url": "https://api.github.com/repos/apify-projects/store-booking/contents/{+path}",
+      "compare_url": "https://api.github.com/repos/apify-projects/store-booking/compare/{base}...{head}",
+      "merges_url": "https://api.github.com/repos/apify-projects/store-booking/merges",
+      "archive_url": "https://api.github.com/repos/apify-projects/store-booking/{archive_format}{/ref}",
+      "downloads_url": "https://api.github.com/repos/apify-projects/store-booking/downloads",
+      "issues_url": "https://api.github.com/repos/apify-projects/store-booking/issues{/number}",
+      "pulls_url": "https://api.github.com/repos/apify-projects/store-booking/pulls{/number}",
+      "milestones_url": "https://api.github.com/repos/apify-projects/store-booking/milestones{/number}",
+      "notifications_url": "https://api.github.com/repos/apify-projects/store-booking/notifications{?since,all,participating}",
+      "labels_url": "https://api.github.com/repos/apify-projects/store-booking/labels{/name}",
+      "releases_url": "https://api.github.com/repos/apify-projects/store-booking/releases{/id}",
+      "deployments_url": "https://api.github.com/repos/apify-projects/store-booking/deployments",
+      "created_at": 1661859371,
+      "updated_at": "2024-07-01T22:15:13Z",
+      "pushed_at": 1721436715,
+      "git_url": "git://github.com/apify-projects/store-booking.git",
+      "ssh_url": "git@github.com:apify-projects/store-booking.git",
+      "clone_url": "https://github.com/apify-projects/store-booking.git",
+      "svn_url": "https://github.com/apify-projects/store-booking",
+      "homepage": "",
+      "size": 3080,
+      "stargazers_count": 0,
+      "watchers_count": 0,
+      "language": "TypeScript",
+      "has_issues": true,
+      "has_projects": true,
+      "has_downloads": true,
+      "has_wiki": true,
+      "has_pages": false,
+      "has_discussions": false,
+      "forks_count": 1,
+      "mirror_url": null,
+      "archived": false,
+      "disabled": false,
+      "open_issues_count": 19,
+      "license": {
+        "key": "apache-2.0",
+        "name": "Apache License 2.0",
+        "spdx_id": "Apache-2.0",
+        "url": "https://api.github.com/licenses/apache-2.0",
+        "node_id": "MDc6TGljZW5zZTI="
+      },
+      "allow_forking": true,
+      "is_template": false,
+      "web_commit_signoff_required": false,
+      "topics": [],
+      "visibility": "private",
+      "forks": 1,
+      "open_issues": 19,
+      "watchers": 0,
+      "default_branch": "master",
+      "stargazers": 0,
+      "master_branch": "master",
+      "organization": "apify-projects",
+      "custom_properties": {}
+    },
+    "pusher": {
+      "name": "lhotanok",
+      "email": "84460709+lhotanok@users.noreply.github.com"
+    },
+    "organization": {
+      "login": "apify-projects",
+      "id": 69005150,
+      "node_id": "MDEyOk9yZ2FuaXphdGlvbjY5MDA1MTUw",
+      "url": "https://api.github.com/orgs/apify-projects",
+      "repos_url": "https://api.github.com/orgs/apify-projects/repos",
+      "events_url": "https://api.github.com/orgs/apify-projects/events",
+      "hooks_url": "https://api.github.com/orgs/apify-projects/hooks",
+      "issues_url": "https://api.github.com/orgs/apify-projects/issues",
+      "members_url": "https://api.github.com/orgs/apify-projects/members{/member}",
+      "public_members_url": "https://api.github.com/orgs/apify-projects/public_members{/member}",
+      "avatar_url": "https://avatars.githubusercontent.com/u/69005150?v=4",
+      "description": "This organization houses projects that are not part of Apify itself, such as enterprise or marketplace developed actors and scrapers."
+    },
+    "sender": {
+      "login": "lhotanok",
+      "id": 84460709,
+      "node_id": "MDQ6VXNlcjg0NDYwNzA5",
+      "avatar_url": "https://avatars.githubusercontent.com/u/84460709?v=4",
+      "gravatar_id": "",
+      "url": "https://api.github.com/users/lhotanok",
+      "html_url": "https://github.com/lhotanok",
+      "followers_url": "https://api.github.com/users/lhotanok/followers",
+      "following_url": "https://api.github.com/users/lhotanok/following{/other_user}",
+      "gists_url": "https://api.github.com/users/lhotanok/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/lhotanok/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/lhotanok/subscriptions",
+      "organizations_url": "https://api.github.com/users/lhotanok/orgs",
+      "repos_url": "https://api.github.com/users/lhotanok/repos",
+      "events_url": "https://api.github.com/users/lhotanok/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/lhotanok/received_events",
+      "type": "User",
+      "site_admin": false
+    },
+    "created": false,
+    "deleted": false,
+    "forced": false,
+    "base_ref": null,
+    "compare": "https://github.com/apify-projects/store-booking/compare/6b186d1fa8b6...591b7f55c7b8",
+    "commits": [
+      {
+        "id": "7f9e105e4ce7881f9def76db60bd8e4e58ead9f2",
+        "tree_id": "3f16d04f6d1cb44f8b90015a69168fdcc29621e1",
+        "distinct": true,
+        "message": "fix: A",
+        "timestamp": "2024-07-20T02:51:54+02:00",
+        "url": "https://github.com/apify-projects/store-booking/commit/591b7f55c7b8feb5012937f870d43266b0650118",
+        "author": {
+          "name": "Kristýna Lhoťanová",
+          "email": "84460709+lhotanok@users.noreply.github.com",
+          "username": "oklinov"
+        },
+        "committer": {
+          "name": "GitHub",
+          "email": "noreply@github.com",
+          "username": "web-flow"
+        }
+      },
+      {
+        "id": "3d1556141893eb3b7f281702e5cbec13d8814156",
+        "tree_id": "3f16d04f6d1cb44f8b90015a69168fdcc29621e1",
+        "distinct": true,
+        "message": "feat: A",
+        "timestamp": "2024-07-20T02:51:54+02:00",
+        "url": "https://github.com/apify-projects/store-booking/commit/591b7f55c7b8feb5012937f870d43266b0650118",
+        "author": {
+          "name": "Kristýna Lhoťanová",
+          "email": "84460709+lhotanok@users.noreply.github.com",
+          "username": "oklinov"
+        },
+        "committer": {
+          "name": "GitHub",
+          "email": "noreply@github.com",
+          "username": "web-flow"
+        }
+      }
+    ],
+    "head_commit": {
+      "id": "591b7f55c7b8feb5012937f870d43266b0650118",
+      "tree_id": "3f16d04f6d1cb44f8b90015a69168fdcc29621e1",
+      "distinct": true,
+      "message": "fix: validate rendered detail page locale (both language & currency) (#133)",
+      "timestamp": "2024-07-20T02:51:54+02:00",
+      "url": "https://github.com/apify-projects/store-booking/commit/591b7f55c7b8feb5012937f870d43266b0650118",
+      "author": {
+        "name": "Kristýna Lhoťanová",
+        "email": "84460709+lhotanok@users.noreply.github.com",
+        "username": "lhotanok"
+      },
+      "committer": {
+        "name": "GitHub",
+        "email": "noreply@github.com",
+        "username": "web-flow"
+      }
+    }
+  }

package/index.ts

@@ -0,0 +1,2 @@
+export { describe, testActor, ExpectStatic } from './lib/lib.js';
+export { RunTestResult } from './lib/run-test-result.js';

package/lib/consts.ts

@@ -0,0 +1,15 @@
+import type { ToFinishWithOptionsWithDefaults } from './types';
+
+export const TO_FINISH_WITH_OPTIONS: ToFinishWithOptionsWithDefaults = {
+    status: 'SUCCEEDED',
+    duration: {
+        min: 600, // 0.6 sec
+        max: 600_000, // 10 min
+    },
+    failedRequests: 0,
+    requestsRetries: { max: 3 },
+    forbiddenLogs: [
+        'ReferenceError',
+        'TypeError',
+    ],
+};

package/lib/extend-expect.ts

@@ -0,0 +1,268 @@
+import type { Assertion, ExpectStatic } from 'vitest';
+
+import { TO_FINISH_WITH_OPTIONS } from './consts.js';
+import type { Interval, ToFinishWithOptions } from './types';
+import { RunTestResult } from './run-test-result.js';
+
+export const extendExpect = (expect: ExpectStatic): ExpectStatic => {
+    expect.extend({
+        toBeArray: (actual) => {
+            const pass = Array.isArray(actual);
+            return {
+                pass,
+                message: () => `Expected "${actual}" to be a array`,
+            };
+        },
+        toBeBoolean: (received) => {
+            const actual = typeof received;
+            const expected = 'boolean';
+            return {
+                pass: actual === expected,
+                message: () => `Expected "${actual}" to be a boolean`,
+                expected: 'boolean',
+            };
+        },
+        toBeEmptyArray: (actual) => {
+            const pass = Array.isArray(actual) && actual.length === 0;
+            return {
+                pass,
+                message: () => `Expected ${actual} to be an empty array`,
+                actual,
+                expected: [],
+            };
+        },
+        toBeNonEmptyArray: (actual) => {
+            const pass = Array.isArray(actual) && actual.length > 0;
+            return {
+                pass,
+                message: () => `Expected ${actual} to be a non-empty array`,
+            };
+        },
+        toBeNonEmptyString: (actual) => {
+            const pass = typeof actual === 'string' && actual.length > 0;
+            return {
+                pass,
+                message: () => `Expected "${actual}" to be a non-empty string`,
+            };
+        },
+        toBeNumber: (actual) => {
+            const pass = typeof actual === 'number';
+            return {
+                pass,
+                message: () => `Expected "${actual}" to be a number`,
+            };
+        },
+        toBeNonEmptyObject: (actual) => {
+            const isObject = typeof actual === 'object' && !Array.isArray(actual);
+            const isNonEmpty = Object.entries(actual).length > 0;
+            const pass = isObject && isNonEmpty;
+            return {
+                pass,
+                message: () => `Expected "${actual}" to be a non-emtpy object`,
+            };
+        },
+        toBeObject: (actual) => {
+            const pass = typeof actual === 'object' && !Array.isArray(actual);
+            return {
+                pass,
+                message: () => `Expected "${actual}" to be an object`,
+            };
+        },
+        toBeString: (received) => {
+            const actual = typeof received;
+            const expected = 'string';
+            return {
+                pass: actual === expected,
+                message: () => `Expected "${actual}" to be a string`,
+                actual,
+                expected,
+            };
+        },
+        toBeTrue: (actual) => {
+            const pass = actual === true;
+            return {
+                pass,
+                message: () => `Expected "${actual}" to be true`,
+                expected: true,
+                actual,
+            };
+        },
+        toBeFalse: (actual) => {
+            const pass = actual === false;
+            return {
+                pass,
+                message: () => `Expected "${actual}" to be false`,
+            };
+        },
+        toBeWholeNumber: (received) => {
+            const pass = Number.isInteger(received);
+            return {
+                pass,
+                message: () => `Expected "${received}" to be a whole number`,
+            };
+        },
+        toBeWithinRange: (received, lower, upper) => {
+            const pass = received >= lower && received <= upper;
+            return {
+                pass,
+                message: () => `Expected ${received} to be within range <${lower}, ${upper}>`,
+            };
+        },
+        toFinishWith: async <PpeEvent extends string>(
+            received: RunTestResult,
+            userOptions: ToFinishWithOptions<PpeEvent>,
+        ) => {
+            const options = {
+                ...TO_FINISH_WITH_OPTIONS,
+                ...userOptions,
+            };
+
+            const diffs: Diffs = {
+                pass: true,
+                actual: ['Run:'],
+                expected: ['Run:'],
+            };
+            {
+                const expected = options?.status;
+                const actual = received.status;
+                diffs.pass = expected === actual;
+                diffs.actual.push(`status=${actual}`);
+                diffs.expected.push(`status=${expected}`);
+            }
+
+            const {
+                chargedEventCounts,
+                stats: { durationMillis },
+            } = await received.getRunInfo();
+            const datasetItemCount = (await received.getDataset()).items.length;
+            const stats = (await received.getStatistics());
+
+            isWithinInterval(diffs, datasetItemCount, options, 'datasetItemCount');
+            isWithinInterval(diffs, durationMillis, options, 'duration');
+            isWithinInterval(diffs, stats?.requestsFailed, options, 'failedRequests');
+            isWithinInterval(diffs, stats?.requestsRetries, options, 'requestsRetries');
+
+            const ppeDiffs: Diffs = {
+                pass: true,
+                actual: ['PPE Events:'],
+                expected: ['PPE Events:'],
+            };
+
+            if (options.chargedEventCounts) {
+                const expected = options.chargedEventCounts;
+                const actual = chargedEventCounts ?? {};
+                const uniquePpeEvents = new Set([
+                    ...Array.from(Object.keys(expected)),
+                    ...Array.from(Object.keys(actual)),
+                ]);
+
+                for (const ppeEvent of uniquePpeEvents) {
+                    if (!(ppeEvent in expected)) {
+                        isWithinInterval(
+                            ppeDiffs,
+                            actual[ppeEvent],
+                            { [ppeEvent]: 0 },
+                            ppeEvent,
+                        );
+                        continue;
+                    }
+                    if (!(ppeEvent in actual)) {
+                        ppeDiffs.pass = false;
+                        ppeDiffs.actual.push(`${ppeEvent}=X`);
+                        ppeDiffs.expected.push(`${ppeEvent}=${expected[ppeEvent as PpeEvent]}`);
+                        continue;
+                    }
+                    isWithinInterval(ppeDiffs, actual[ppeEvent], expected, ppeEvent as PpeEvent);
+                }
+
+                diffs.pass = ppeDiffs.pass;
+                diffs.actual.push(ppeDiffs.actual.join('\n    '));
+                diffs.expected.push(ppeDiffs.expected.join('\n    '));
+            }
+
+            {
+                const { forbiddenLogs } = options;
+                const log = await received.getLog();
+                const occuredLogs = [];
+                for (const forbiddenLog of forbiddenLogs) {
+                    if (log.includes(forbiddenLog)) {
+                        occuredLogs.push(forbiddenLog);
+                    }
+                }
+                if (occuredLogs.length > 0) {
+                    diffs.pass = false;
+                    diffs.actual.push(` logs=[${occuredLogs.join(', ')}]`);
+                    diffs.expected.push(` logs=[]`);
+                }
+            }
+
+            return {
+                pass: diffs.pass,
+                message: () => `Run ${received.id} didn't finish as expected`,
+                actual: diffs.actual.join('\n  '),
+                expected: diffs.expected.join('\n  '),
+            };
+        },
+        toStartWith: (received, prefix) => {
+            const pass = received?.startsWith(prefix);
+            return {
+                pass,
+                message: () => `Expected "${received}" to start with "${prefix}"`,
+            };
+        },
+    });
+
+    // here we are switching logic of expect and expect.soft
+    // expect => expect.soft
+    // expect.hard => expect
+    const { soft } = expect;
+    const oldExpect = { ...expect };
+    const softExpect = <T>(actual: T, message?: string): Assertion => {
+        return soft(actual, message);
+    };
+
+    for (const [key, value] of Object.entries(oldExpect)) {
+        // @ts-expect-error: No idea how to type this properly
+        softExpect[key] = value;
+    }
+
+    softExpect.hard = <T>(actual: T, message?: string): Assertion<T> => {
+        return expect(actual, message);
+    };
+
+    return softExpect as unknown as ExpectStatic;
+};
+
+type Diffs = {
+    pass: boolean
+    actual: string[]
+    expected: string[]
+
+}
+
+const isWithinInterval = <T extends string>(
+    diffs: Diffs,
+    actual: number | undefined,
+    options: Record<T, Interval | null>,
+    intervalOption: T,
+) => {
+    const expected = options[intervalOption];
+    if (expected === null) {
+        // check is disabled if expected value is null
+        return;
+    }
+    if (typeof expected === 'number') {
+        if (actual !== expected) {
+            diffs.pass = false;
+            diffs.actual.push(`${intervalOption}=${actual}`);
+            diffs.expected.push(`${intervalOption}=${expected}`);
+        }
+    } else if (typeof expected === 'object') {
+        const { min, max } = expected;
+        if (actual === undefined || (min !== undefined && actual < min) || (max !== undefined && actual > max)) {
+            diffs.pass = false;
+            diffs.actual.push(`${intervalOption}=${actual}`);
+            diffs.expected.push(`${intervalOption}=<${min ?? ''},${max ?? ''}>`);
+        }
+    }
+};

package/lib/lib.ts

@@ -0,0 +1,134 @@
+import { ApifyClient } from 'apify-client';
+import {
+    describe as vitestDescribe,
+    ExpectStatic,
+    TestFunction,
+    test as vitestTest,
+    SuiteFactory,
+    TestOptions,
+    TestContext,
+} from 'vitest';
+import type { ActorBuild, RunOptions } from './types';
+import { RunTestResult } from './run-test-result.js';
+import { extendExpect } from './extend-expect.js';
+import { getActorPrefilledInput } from './utils.js';
+
+const ACTOR_BUILDS = 'ACTOR_BUILDS';
+let actorBuilds: ActorBuild[] = [];
+try {
+    const actorBuildsEnv = process.env[ACTOR_BUILDS];
+    if (actorBuildsEnv) {
+        actorBuilds = JSON.parse(actorBuildsEnv);
+        if (!Array.isArray(actorBuilds)) {
+            throw new Error(`${ACTOR_BUILDS} env variable should contain a JSON array, got ${typeof actorBuilds}`);
+        }
+    }
+} catch (err) {
+    throw new Error(`Failed to parse actor builds: ${err}`);
+}
+
+const config = actorBuilds.reduce((map, cfg) => {
+    map.set(cfg.actorName, cfg);
+    map.set(cfg.actorId, cfg);
+    return map;
+}, new Map<string, ActorBuild>());
+
+export { ExpectStatic };
+
+const { TESTER_APIFY_TOKEN, RUN_PLATFORM_TESTS, RUN_ALL_PLATFORM_TESTS } = process.env;
+const apifyClient = new ApifyClient({ token: TESTER_APIFY_TOKEN });
+
+const DEFAULT_TEST_OPTIONS: TestOptions = {
+    // we want to run tests concurrently
+    concurrent: true,
+    // test should finish within 1 hour
+    timeout: 60_000 * 60,
+};
+
+export const describe = (
+    name: string,
+    fn?: SuiteFactory<object>,
+    options: TestOptions = DEFAULT_TEST_OPTIONS,
+) => {
+    vitestDescribe.runIf(!!RUN_PLATFORM_TESTS || !!RUN_ALL_PLATFORM_TESTS)(name, options, fn);
+};
+
+const DEFAULT_TEST_ACTOR_OPTIONS: TestOptions = {
+    retry: 1,
+};
+
+export const testActor = <T>(
+    actorName: string,
+    testName: string,
+    fn: TestFunction<{ run: ReturnType<typeof createStartRunFn<T>> }>,
+    testOptions?: TestOptions,
+) => {
+    const options = {
+        ...DEFAULT_TEST_ACTOR_OPTIONS,
+        ...testOptions,
+    };
+    const name = `${actorName}: ${testName}`;
+    const shouldRun = !!RUN_ALL_PLATFORM_TESTS || config.has(actorName);
+
+    vitestTest.runIf(shouldRun)(name, options, async (context) => {
+        const { expect, ...rest } = context;
+        await fn({
+            expect: extendExpect(expect),
+            run: createStartRunFn(actorName, context),
+            ...rest,
+        });
+    });
+};
+
+export const testTestActor = <T>(
+    testName: string,
+    fn: TestFunction<{ run: ReturnType<typeof createStartRunFn<T>> }>,
+) => {
+    vitestTest(testName, async (context) => {
+        const { expect, ...rest } = context;
+        await fn({
+            expect: extendExpect(expect),
+            // @ts-expect-error: this just to test custom matchers
+            run: () => { },
+            ...rest,
+        });
+    });
+};
+
+export const it = testActor;
+
+const createStartRunFn = <T>(actorNameOrId: string, { annotate, task }: TestContext) => {
+    const actorConfig = config.get(actorNameOrId);
+    const build = actorConfig?.buildNumber;
+    const buildId = actorConfig?.buildId;
+    return async (runOptions: RunOptions<T>) => {
+        const {
+            input,
+            options,
+            prefilledInput,
+        } = runOptions;
+        const actor = apifyClient.actor(actorNameOrId);
+
+        const actorInput = {
+            ...(prefilledInput && await getActorPrefilledInput(apifyClient, actorNameOrId, buildId)),
+            ...input,
+        };
+        const run = await actor.call(
+            actorInput,
+            { build, ...options, },
+        );
+
+        const runLink = `https://console.apify.com/view/runs/${run.id}`;
+        await annotate(runLink, 'run_link');
+        // @ts-expect-error: `TaskMeta` cannot be retyped
+        task.meta = {
+            runId: run.id,
+            runLink,
+        };
+
+        // waiting for datasetItemCount and chargedEventCounts to sync
+        await new Promise((resolve) => setTimeout(resolve, 10_000));
+
+        return new RunTestResult(apifyClient, run);
+    };
+};