apify-test-tools 0.1.0

package/dist/lib/extend-expect.js

@@ -0,0 +1,228 @@
+import { TO_FINISH_WITH_OPTIONS } from './consts.js';
+export const extendExpect = (expect) => {
+    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 (received, userOptions) => {
+            const options = {
+                ...TO_FINISH_WITH_OPTIONS,
+                ...userOptions,
+            };
+            const 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 = {
+                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]}`);
+                        continue;
+                    }
+                    isWithinInterval(ppeDiffs, actual[ppeEvent], expected, 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 = (actual, message) => {
+        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 = (actual, message) => {
+        return expect(actual, message);
+    };
+    return softExpect;
+};
+const isWithinInterval = (diffs, actual, options, intervalOption) => {
+    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 ?? ''}>`);
+        }
+    }
+};
+//# sourceMappingURL=extend-expect.js.map

package/dist/lib/extend-expect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend-expect.js","sourceRoot":"","sources":["../../lib/extend-expect.ts"],"names":[],"mappings":"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"}

package/dist/lib/lib.d.ts

@@ -0,0 +1,16 @@
+import { ExpectStatic, TestFunction, SuiteFactory, TestOptions, TestContext } from 'vitest';
+import type { RunOptions } from './types';
+import { RunTestResult } from './run-test-result.js';
+export { ExpectStatic };
+export declare const describe: (name: string, fn?: SuiteFactory<object>, options?: TestOptions) => void;
+export declare const testActor: <T>(actorName: string, testName: string, fn: TestFunction<{
+    run: ReturnType<typeof createStartRunFn<T>>;
+}>, testOptions?: TestOptions) => void;
+export declare const testTestActor: <T>(testName: string, fn: TestFunction<{
+    run: ReturnType<typeof createStartRunFn<T>>;
+}>) => void;
+export declare const it: <T>(actorName: string, testName: string, fn: TestFunction<{
+    run: ReturnType<typeof createStartRunFn<T>>;
+}>, testOptions?: TestOptions) => void;
+declare const createStartRunFn: <T>(actorNameOrId: string, { annotate, task }: TestContext) => (runOptions: RunOptions<T>) => Promise<RunTestResult>;
+//# sourceMappingURL=lib.d.ts.map

package/dist/lib/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../lib/lib.ts"],"names":[],"mappings":"AACA,OAAO,EAEH,YAAY,EACZ,YAAY,EAEZ,YAAY,EACZ,WAAW,EACX,WAAW,EACd,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAwBrD,OAAO,EAAE,YAAY,EAAE,CAAC;AAYxB,eAAO,MAAM,QAAQ,SACX,MAAM,OACP,YAAY,CAAC,MAAM,CAAC,YAChB,WAAW,SAGvB,CAAC;AAMF,eAAO,MAAM,SAAS,GAAI,CAAC,aACZ,MAAM,YACP,MAAM,MACZ,YAAY,CAAC;IAAE,GAAG,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,gBACnD,WAAW,SAiB5B,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,CAAC,YACjB,MAAM,MACZ,YAAY,CAAC;IAAE,GAAG,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,SAWpE,CAAC;AAEF,eAAO,MAAM,EAAE,GAtCW,CAAC,aACZ,MAAM,YACP,MAAM,MACZ,YAAY,CAAC;IAAE,GAAG,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,gBACnD,WAAW,SAkCF,CAAC;AAE5B,QAAA,MAAM,gBAAgB,GAAI,CAAC,iBAAiB,MAAM,sBAAsB,WAAW,kBAIrD,UAAU,CAAC,CAAC,CAAC,2BA8B1C,CAAC"}

package/dist/lib/lib.js

@@ -0,0 +1,91 @@
+import { ApifyClient } from 'apify-client';
+import { describe as vitestDescribe, test as vitestTest, } from 'vitest';
+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 = [];
+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());
+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 = {
+    // we want to run tests concurrently
+    concurrent: true,
+    // test should finish within 1 hour
+    timeout: 60_000 * 60,
+};
+export const describe = (name, fn, options = DEFAULT_TEST_OPTIONS) => {
+    vitestDescribe.runIf(!!RUN_PLATFORM_TESTS || !!RUN_ALL_PLATFORM_TESTS)(name, options, fn);
+};
+const DEFAULT_TEST_ACTOR_OPTIONS = {
+    retry: 1,
+};
+export const testActor = (actorName, testName, fn, 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 = (testName, fn) => {
+    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 = (actorNameOrId, { annotate, task }) => {
+    const actorConfig = config.get(actorNameOrId);
+    const build = actorConfig?.buildNumber;
+    const buildId = actorConfig?.buildId;
+    return async (runOptions) => {
+        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);
+    };
+};
+//# sourceMappingURL=lib.js.map

package/dist/lib/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../lib/lib.ts"],"names":[],"mappings":"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"}

package/dist/lib/run-test-result.d.ts

@@ -0,0 +1,20 @@
+import { ActorRun, ApifyClient } from 'apify-client';
+import type { Dataset, SdkCrawlerStatistics } from './types';
+export declare class RunTestResult {
+    private readonly apifyClient;
+    private readonly run;
+    private log;
+    private dataset;
+    private statistics;
+    private runInfo;
+    private input;
+    constructor(apifyClient: ApifyClient, run: ActorRun);
+    getStatistics: () => Promise<SdkCrawlerStatistics | undefined>;
+    getLog: () => Promise<string>;
+    getDataset: <T>() => Promise<Dataset<T>>;
+    getInput: <T>() => Promise<T>;
+    getRunInfo: () => Promise<ActorRun>;
+    get id(): string;
+    get status(): string;
+}
+//# sourceMappingURL=run-test-result.d.ts.map

package/dist/lib/run-test-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-test-result.d.ts","sourceRoot":"","sources":["../../lib/run-test-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE7D,qBAAa,aAAa;IAQlB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG;IARxB,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,KAAK,CAAsB;gBAGd,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,QAAQ;IAGlC,aAAa,QAAa,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAQjE;IAEF,MAAM,QAAa,OAAO,CAAC,MAAM,CAAC,CAOhC;IAEF,UAAU,GAAS,CAAC,OAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAQ1C;IAEF,QAAQ,GAAS,CAAC,OAAK,OAAO,CAAC,CAAC,CAAC,CAOhC;IAED,UAAU,QAAa,OAAO,CAAC,QAAQ,CAAC,CAOtC;IAEF,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;CACJ"}

package/dist/lib/run-test-result.js

@@ -0,0 +1,62 @@
+export class RunTestResult {
+    apifyClient;
+    run;
+    log;
+    dataset;
+    statistics;
+    runInfo;
+    input;
+    constructor(apifyClient, run) {
+        this.apifyClient = apifyClient;
+        this.run = run;
+    }
+    getStatistics = async () => {
+        if (this.statistics) {
+            return this.statistics;
+        }
+        const kvs = this.apifyClient.keyValueStore(this.run.defaultKeyValueStoreId);
+        const stats = await kvs.getRecord('SDK_CRAWLER_STATISTICS_0');
+        this.statistics = stats?.value;
+        return this.statistics;
+    };
+    getLog = async () => {
+        if (this.log) {
+            return this.log;
+        }
+        const runLog = await this.apifyClient.run(this.id).log().get();
+        this.log = runLog;
+        return runLog;
+    };
+    getDataset = async () => {
+        if (this.dataset) {
+            return this.dataset;
+        }
+        const dataset = this.apifyClient.dataset(this.run.defaultDatasetId);
+        const items = (await dataset.listItems()).items;
+        this.dataset = { items };
+        return this.dataset;
+    };
+    getInput = async () => {
+        if (this.input) {
+            return this.input;
+        }
+        const kvs = this.apifyClient.keyValueStore(this.run.defaultKeyValueStoreId);
+        const input = await kvs.getRecord('INPUT');
+        return input;
+    };
+    getRunInfo = async () => {
+        if (this.runInfo) {
+            return this.runInfo;
+        }
+        const run = this.apifyClient.run(this.run.id);
+        this.runInfo = await run.get();
+        return this.runInfo;
+    };
+    get id() {
+        return this.run.id;
+    }
+    get status() {
+        return this.run.status;
+    }
+}
+//# sourceMappingURL=run-test-result.js.map

package/dist/lib/run-test-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-test-result.js","sourceRoot":"","sources":["../../lib/run-test-result.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,aAAa;IAQD;IACA;IARb,GAAG,CAAqB;IACxB,OAAO,CAA+B;IACtC,UAAU,CAAmC;IAC7C,OAAO,CAAuB;IAC9B,KAAK,CAAsB;IAEnC,YACqB,WAAwB,EACxB,GAAa;QADb,gBAAW,GAAX,WAAW,CAAa;QACxB,QAAG,GAAH,GAAG,CAAU;IACzB,CAAC;IAEV,aAAa,GAAG,KAAK,IAA+C,EAAE;QAClE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,UAAU,CAAC;QAC3B,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,GAAG,KAAK,EAAE,KAAwC,CAAC;QAClE,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC,CAAC;IAEF,MAAM,GAAG,KAAK,IAAqB,EAAE;QACjC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,GAAG,CAAC;QACpB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QAC/D,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC;QAClB,OAAO,MAAgB,CAAC;IAC5B,CAAC,CAAC;IAEF,UAAU,GAAG,KAAK,IAA2B,EAAE;QAC3C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,OAAqB,CAAC;QACtC,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,KAAY,CAAC;QACvD,IAAI,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,OAAqB,CAAC;IACtC,CAAC,CAAC;IAEF,QAAQ,GAAG,KAAK,IAAkB,EAAE;QAChC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,KAAU,CAAA;QAC1B,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO,KAAU,CAAC;IACtB,CAAC,CAAA;IAED,UAAU,GAAG,KAAK,IAAuB,EAAE;QACvC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,OAAO,CAAC;QACxB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAQ,CAAC;IACzB,CAAC,CAAC;IAEF,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IAC3B,CAAC;CACJ"}

package/dist/lib/types.d.ts

@@ -0,0 +1,107 @@
+import { ActorCallOptions } from 'apify-client';
+import { Assertion } from 'vitest';
+export type ActorBuild = {
+    buildId: string;
+    actorId: string;
+    buildNumber: string;
+    actorName: string;
+};
+export type RunOptions<T> = {
+    input: Omit<T, 'actorName'>;
+    options?: ActorCallOptions;
+    prefilledInput?: boolean;
+};
+export type Dataset<T> = {
+    items: T[];
+};
+export type OpenInterval = {
+    min: number;
+    max?: undefined;
+} | {
+    min?: undefined;
+    max: number;
+};
+export type ClosedInterval = {
+    min: number;
+    max: number;
+};
+export type Interval = number | OpenInterval | ClosedInterval;
+export type ToFinishWithOptionsWithDefaults = {
+    status: RunStatus;
+    duration: Interval | null;
+    failedRequests: Interval | null;
+    requestsRetries: Interval | null;
+    forbiddenLogs: string[];
+};
+export type IntervalOption<PpeEvent extends string> = keyof Pick<ToFinishWithOptions<PpeEvent>, 'datasetItemCount' | 'requestsRetries' | 'failedRequests' | 'duration'>;
+export type ToFinishWithOptions<PpeEvent extends string> = Partial<ToFinishWithOptionsWithDefaults> & {
+    datasetItemCount: Interval;
+    /**
+     * Define expected charged (PPE) event counts. You can also define count as `Interval`.
+     *
+     * Example
+     * ```ts
+     * chargedEventCounts: {
+     *   'actor-start': 4,
+     *   'item-pushed': { min: 10, max: 20 },
+     * }
+     * ```
+     *
+     * If you omit any PPE event, it's expected count will be 0.
+     * Assertion will fail if `chargedEventCounts` doesn't contain some of the expected events.
+     */
+    chargedEventCounts?: Record<PpeEvent, Interval>;
+};
+export type SdkCrawlerStatistics = {
+    requestsFinished: number;
+    requestsFailed: number;
+    requestsRetries: number;
+    requestsFailedPerMinute: number;
+    requestsFinishedPerMinute: number;
+    requestMinDurationMillis: number;
+    requestMaxDurationMillis: number;
+    requestRetryHistogram: number[];
+    requestTotalFailedDurationMillis: number;
+    requestTotalFinishedDurationMillis: number;
+    crawlerStartedAt: string;
+    crawlerFinishedAt: string;
+    statsPersistedAt: string;
+    crawlerRuntimeMillis: number;
+    crawlerLastStartTimestamp: number;
+};
+export type RunStatus = 'SUCCEEDED' | 'READY' | 'RUNNING' | 'FAILED' | 'ABORTING' | 'ABORTED' | 'TIMING-OUT' | 'TIMED-OUT';
+export interface ActorMatchers<R = unknown> {
+    toBeArray: () => R;
+    toBeBoolean: () => R;
+    toBeEmptyArray: () => R;
+    toBeNonEmptyArray: () => R;
+    toBeNonEmptyString: () => R;
+    toBeNumber: () => R;
+    toBeFalse: () => R;
+    toBeTrue: () => R;
+    toBeNonEmptyObject: () => R;
+    toBeObject: () => R;
+    toBeString: () => R;
+    toBeWholeNumber: () => R;
+    toBeWithinRange: (lower: number, upper: number) => R;
+    /**
+     * Validates the following properties of a run:
+     * - `status` (default: `SUCCEEDED`)
+     * - `duration` in milliseconds (default: `{ min: 600, max: 600_000}` - <0.6s, 10min>)
+     * - `failedRequests` (default: `0`)
+     * - `requestsRetries` (default: `{ max: 3 }`)
+     * - `forbiddenLogs` (default: `['ReferenceError', 'TypeError']`)
+     * - `datasetItemCount` (required)
+     * - `chargedEventCounts`
+     */
+    toFinishWith: <PpeEvent extends string>(options: ToFinishWithOptions<PpeEvent>) => Promise<R>;
+    toStartWith: (prefix: string) => R;
+    hard: <T>(actual: T, message?: string) => Assertion;
+}
+declare module 'vitest' {
+    interface Assertion<T = any> extends ActorMatchers<T> {
+    }
+    interface AsymmetricMatchersContaining extends ActorMatchers {
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../lib/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../lib/types.ts"],"names":[],"mappings":""}

package/dist/lib/utils.d.ts

@@ -0,0 +1,7 @@
+import { ApifyClient } from 'apify-client';
+/**
+ * Gets prefilled values for a provided build or, if not provided, uses actor's
+ * default build (this is usually `latest`).
+ */
+export declare const getActorPrefilledInput: (apifyClient: ApifyClient, actorNameOrId: string, buildId: string | undefined) => Promise<Record<string, unknown>>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,gBAClB,WAAW,iBACT,MAAM,WACZ,MAAM,GAAG,SAAS,qCAuC9B,CAAC"}

package/dist/lib/utils.js

@@ -0,0 +1,30 @@
+/**
+ * Gets prefilled values for a provided build or, if not provided, uses actor's
+ * default build (this is usually `latest`).
+ */
+export const getActorPrefilledInput = async (apifyClient, actorNameOrId, buildId) => {
+    if (!buildId) {
+        const actorInfo = await apifyClient.actor(actorNameOrId).get();
+        const defaultBuildTag = actorInfo?.defaultRunOptions.build;
+        const taggedBuild = actorInfo?.taggedBuilds?.[defaultBuildTag || ''];
+        buildId = taggedBuild?.buildId;
+        if (!buildId) {
+            console.error(`Coudn't find default build for actor ${actorNameOrId}. Prefilled values will not be used.`);
+            return {};
+        }
+    }
+    const buildInfo = await apifyClient.build(buildId).get();
+    const inputSchema = buildInfo?.actorDefinition?.input;
+    if (!inputSchema) {
+        console.error(`Coudn't find input schema definition for actor ${actorNameOrId}, build ${buildId}.`, 'Prefilled values will not be used');
+        return {};
+    }
+    const prefill = {};
+    for (const [propertyName, propertyValue] of Object.entries(inputSchema.properties)) {
+        if (propertyValue.prefill !== undefined) {
+            prefill[propertyName] = propertyValue.prefill;
+        }
+    }
+    return prefill;
+};
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../lib/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EACvC,WAAwB,EACxB,aAAqB,EACrB,OAA2B,EAC7B,EAAE;IACA,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,EAAE,CAAC;QAE/D,MAAM,eAAe,GAAG,SAAS,EAAE,iBAAiB,CAAC,KAAK,CAAC;QAE3D,MAAM,WAAW,GAAG,SAAS,EAAE,YAAY,EAAE,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,GAAG,WAAW,EAAE,OAAO,CAAC;QAE/B,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,wCAAwC,aAAa,sCAAsC,CAAC,CAAC;YAC3G,OAAO,EAAE,CAAA;QACb,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;IAEzD,MAAM,WAAW,GAAG,SAAS,EAAE,eAAe,EAAE,KAEnC,CAAA;IAEb,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACT,kDAAkD,aAAa,WAAW,OAAO,GAAG,EACpF,mCAAmC,CACtC,CAAC;QACF,OAAO,EAAE,CAAA;IACb,CAAC;IAED,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,KAAK,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QACjF,IAAI,aAAa,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,CAAC,YAAY,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC;QAClD,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC"}

package/dist/test/unit/custom-matchers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=custom-matchers.test.d.ts.map

package/dist/test/unit/custom-matchers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-matchers.test.d.ts","sourceRoot":"","sources":["../../../test/unit/custom-matchers.test.ts"],"names":[],"mappings":""}