apify-test-tools 0.5.0 → 0.5.2

package/lib/consts.ts

@@ -1,4 +1,4 @@
-import type { ToFinishWithOptionsWithDefaults } from './types';
+import type { ToFinishWithOptionsWithDefaults } from './types.js';
 
 export const TO_FINISH_WITH_OPTIONS: ToFinishWithOptionsWithDefaults = {
     status: 'SUCCEEDED',
@@ -8,9 +8,6 @@ export const TO_FINISH_WITH_OPTIONS: ToFinishWithOptionsWithDefaults = {
     },
     failedRequests: 0,
     requestsRetries: { max: 3 },
-    forbiddenLogs: [
-        'ReferenceError',
-        'TypeError',
-    ],
     maxRetriesPerRequest: null,
+    forbiddenLogs: ['ReferenceError', 'TypeError'],
 };

package/lib/extend-expect.ts

@@ -1,7 +1,7 @@
 import type { Assertion, ExpectStatic } from 'vitest';
 
 import { TO_FINISH_WITH_OPTIONS } from './consts.js';
-import type { Interval, ToFinishWithOptions } from './types';
+import type { Interval, ToFinishWithOptions } from './types.js';
 import { RunTestResult } from './run-test-result.js';
 
 export const extendExpect = (expect: ExpectStatic): ExpectStatic => {
@@ -110,7 +110,7 @@ export const extendExpect = (expect: ExpectStatic): ExpectStatic => {
         },
         toFinishWith: async <PpeEvent extends string>(
             received: RunTestResult,
-            userOptions: ToFinishWithOptions<PpeEvent>,
+            userOptions: ToFinishWithOptions<PpeEvent>
         ) => {
             const options = {
                 ...TO_FINISH_WITH_OPTIONS,
@@ -145,12 +145,14 @@ export const extendExpect = (expect: ExpectStatic): ExpectStatic => {
 
             const checkInterval = (
                 value: number | undefined,
-                key: ['datasetItemCount', 'duration', 'failedRequests', 'requestsRetries', 'maxRetriesPerRequest'][number],
-                label: string,
+                key: ['datasetItemCount', 'duration', 'failedRequests', 'requestsRetries'][number],
+                label: string
             ) => {
                 const result = isWithinInterval(diffs, value, options, key);
                 if (result === false) {
-                    failedAssertions.push(`Failed ${label} check, expected ${JSON.stringify(options[key])}, got ${value}.`);
+                    failedAssertions.push(
+                        `Failed ${label} check, expected ${JSON.stringify(options[key])}, got ${value}.`
+                    );
                 }
             };
 
@@ -158,9 +160,20 @@ export const extendExpect = (expect: ExpectStatic): ExpectStatic => {
             checkInterval(durationMillis, 'duration', 'duration');
             checkInterval(stats?.requestsFailed, 'failedRequests', 'failed requests');
             checkInterval(stats?.requestsRetries, 'requestsRetries', 'requests retries');
-            const maxRetriesObserved = (stats?.requestRetryHistogram ?? [0]).length - 1;
-            checkInterval(maxRetriesObserved, 'maxRetriesPerRequest', 'max retries per request');
 
+            {
+                if (options.maxRetriesPerRequest !== null) {
+                    const maxRetriesPerRequestObserved = (stats?.requestRetryHistogram ?? [0]).length - 1;
+                    if (maxRetriesPerRequestObserved > options.maxRetriesPerRequest) {
+                        diffs.pass = false;
+                        diffs.actual.push(`maxRetriesPerRequest=${maxRetriesPerRequestObserved}`);
+                        diffs.expected.push(`maxRetriesPerRequest<=${options.maxRetriesPerRequest}`);
+                        failedAssertions.push(
+                            `Failed max retries observed check, expected <=${options.maxRetriesPerRequest}, got ${maxRetriesPerRequestObserved}.`
+                        );
+                    }
+                }
+            }
             const ppeDiffs: Diffs = {
                 pass: true,
                 actual: ['PPE Events:'],
@@ -177,12 +190,7 @@ export const extendExpect = (expect: ExpectStatic): ExpectStatic => {
 
                 for (const ppeEvent of uniquePpeEvents) {
                     if (!(ppeEvent in expected)) {
-                        isWithinInterval(
-                            ppeDiffs,
-                            actual[ppeEvent],
-                            { [ppeEvent]: 0 },
-                            ppeEvent,
-                        );
+                        isWithinInterval(ppeDiffs, actual[ppeEvent], { [ppeEvent]: 0 }, ppeEvent);
                         continue;
                     }
                     if (!(ppeEvent in actual)) {
@@ -198,7 +206,11 @@ export const extendExpect = (expect: ExpectStatic): ExpectStatic => {
                     diffs.pass = ppeDiffs.pass;
                     diffs.actual.push(ppeDiffs.actual.join('\n    '));
                     diffs.expected.push(ppeDiffs.expected.join('\n    '));
-                    failedAssertions.push(`Failed PPE event counts check, expected ${JSON.stringify(options.chargedEventCounts)}, got ${JSON.stringify(chargedEventCounts)}.`);
+                    failedAssertions.push(
+                        `Failed PPE event counts check, expected ${JSON.stringify(
+                            options.chargedEventCounts
+                        )}, got ${JSON.stringify(chargedEventCounts)}.`
+                    );
                 }
             }
 
@@ -215,13 +227,15 @@ export const extendExpect = (expect: ExpectStatic): ExpectStatic => {
                     diffs.pass = false;
                     diffs.actual.push(` logs=[${occuredLogs.join(', ')}]`);
                     diffs.expected.push(` logs=[]`);
-                    failedAssertions.push(`Failed forbidden logs check, expected [] but got [${occuredLogs.join(', ')}].`);
+                    failedAssertions.push(
+                        `Failed forbidden logs check, expected [] but got [${occuredLogs.join(', ')}].`
+                    );
                 }
             }
 
             return {
                 pass: diffs.pass,
-                message: () => `Run did not finish as expected. Failed assertions: ${failedAssertions.join(' ',)}`,
+                message: () => `Run did not finish as expected. Failed assertions: ${failedAssertions.join(' ')}`,
                 actual: diffs.actual.join('\n  '),
                 expected: diffs.expected.join('\n  '),
             };
@@ -257,17 +271,16 @@ export const extendExpect = (expect: ExpectStatic): ExpectStatic => {
 };
 
 type Diffs = {
-    pass: boolean
-    actual: string[]
-    expected: string[]
-
-}
+    pass: boolean;
+    actual: string[];
+    expected: string[];
+};
 
 const isWithinInterval = <T extends string>(
     diffs: Diffs,
     actual: number | undefined,
     options: Record<T, Interval | null>,
-    intervalOption: T,
+    intervalOption: T
 ) => {
     const expected = options[intervalOption];
     if (expected === null) {
@@ -279,7 +292,7 @@ const isWithinInterval = <T extends string>(
             diffs.pass = false;
             diffs.actual.push(`${intervalOption}=${actual}`);
             diffs.expected.push(`${intervalOption}=${expected}`);
-            return false
+            return false;
         }
     } else if (typeof expected === 'object') {
         const { min, max } = expected;
@@ -287,8 +300,8 @@ const isWithinInterval = <T extends string>(
             diffs.pass = false;
             diffs.actual.push(`${intervalOption}=${actual}`);
             diffs.expected.push(`${intervalOption}=<${min ?? ''},${max ?? ''}>`);
-            return false
+            return false;
         }
     }
-    return
+    return;
 };

package/lib/lib.ts

@@ -7,7 +7,7 @@ import {
     SuiteFactory,
     TestContext,
 } from 'vitest';
-import type { ActorBuild, ActorTestOptions, RunOptions } from './types';
+import type { ActorBuild, ActorTestOptions, RunOptions } from './types.js';
 import { RunTestResult } from './run-test-result.js';
 import { extendExpect } from './extend-expect.js';
 import { getActorPrefilledInput, sleep } from './utils.js';
@@ -26,7 +26,7 @@ try {
     throw new Error(`Failed to parse actor builds: ${err}`);
 }
 
-const config = actorBuilds.reduce((map, cfg) => {
+const config = actorBuilds.reduce<Map<string, ActorBuild>>((map, cfg) => {
     map.set(cfg.actorName, cfg);
     map.set(cfg.actorId, cfg);
     return map;
@@ -44,11 +44,7 @@ const DEFAULT_TEST_OPTIONS: ActorTestOptions = {
     timeout: 60_000 * 60,
 };
 
-export const describe = (
-    name: string,
-    fn?: SuiteFactory<object>,
-    options: ActorTestOptions = DEFAULT_TEST_OPTIONS,
-) => {
+export const describe = (name: string, fn?: SuiteFactory<object>, options: ActorTestOptions = DEFAULT_TEST_OPTIONS) => {
     vitestDescribe.runIf(!!RUN_PLATFORM_TESTS || !!RUN_ALL_PLATFORM_TESTS)(name, options, fn);
 };
 
@@ -60,7 +56,7 @@ export const testActor = <T>(
     actorName: string,
     testName: string,
     fn: TestFunction<{ run: ReturnType<typeof createStartRunFn<T>> }>,
-    testOptions?: ActorTestOptions,
+    testOptions?: ActorTestOptions
 ) => {
     const options = {
         ...DEFAULT_TEST_ACTOR_OPTIONS,
@@ -68,8 +64,7 @@ export const testActor = <T>(
     };
     const name = `${actorName}: ${testName}`;
     const shouldRun = !!RUN_ALL_PLATFORM_TESTS || config.has(actorName);
-
-    vitestTest.runIf(shouldRun)(name, options, async (context) => {
+    vitestTest.runIf(shouldRun)(name, options, async <T extends TestContext>(context: T) => {
         const { expect, ...rest } = context;
         await fn({
             expect: extendExpect(expect),
@@ -89,7 +84,7 @@ export const testStandbyActor = <I = any, O = any>(
     actorName: string,
     testName: string,
     fn: TestFunction<{ callStandby: ReturnType<typeof createStartStandbyFn<I, O>> }>,
-    testOptions?: ActorTestOptions,
+    testOptions?: ActorTestOptions
 ) => {
     const options = {
         ...DEFAULT_TEST_ACTOR_OPTIONS,
@@ -98,7 +93,7 @@ export const testStandbyActor = <I = any, O = any>(
     const name = `${actorName}: ${testName}`;
     const shouldRun = !!RUN_ALL_PLATFORM_TESTS || config.has(actorName);
 
-    vitestTest.runIf(shouldRun)(name, options, async (context) => {
+    vitestTest.runIf(shouldRun)(name, options, async <T extends TestContext>(context: T) => {
         const standbyTask = await createStandbyTask(actorName, config.get(actorName)?.buildNumber);
         const { annotate } = context;
         const { expect, ...rest } = context;
@@ -113,29 +108,28 @@ export const testStandbyActor = <I = any, O = any>(
         } catch {}
 
         const { taskId } = standbyTask;
-        const runs = (await apifyClient.task(taskId).runs().list()).items
+        const runs = (await apifyClient.task(taskId).runs().list()).items;
         for (const run of runs) {
             const runLink = generateRunLink(run);
-            await annotate(runLink, 'run_link');
+            await annotate(`${name} - ${runLink}`, 'run_link');
         }
 
         if (taskId) {
-            await apifyClient.task(taskId).delete()
+            await apifyClient.task(taskId).delete();
         }
-
     });
 };
 
 export const testTestActor = <T>(
     testName: string,
-    fn: TestFunction<{ run: ReturnType<typeof createStartRunFn<T>> }>,
+    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: () => { },
+            run: () => {},
             ...rest,
         });
     });
@@ -158,14 +152,14 @@ const createStartStandbyFn = <I, O>(standbyTask: StandbyTask) => {
             body: JSON.stringify(input),
         });
 
-        const data = await response.json() as O;
+        const data = (await response.json()) as O;
         return {
             data,
             status: response.status,
             headers: response.headers,
         };
     };
-}
+};
 
 interface StandbyTask {
     standbyUrl: string;
@@ -174,7 +168,7 @@ interface StandbyTask {
 
 const randomInt = (min: number, max: number) => {
     return Math.floor(Math.random() * (max - min + 1)) + min;
-}
+};
 
 /**
  * Creates a task with specific `build` - either `buildNumber` or default.
@@ -202,19 +196,22 @@ const createStandbyTask = async (actorNameOrId: string, buildNumber?: string): P
     const actorStandbyOptions: ActorStandby = {
         ...defaultActorStandby,
         build,
-    }
+    };
 
     try {
         const title = `Test task - ${build}:${actorNameOrId}`.slice(0, 62);
         // we try to create unique task name containing only `a-z0-9-` characters and at most 63 characters long
-        const name = `${randomInt(1, 1_000_000)}${title.toLowerCase().replaceAll(/\s+/g, '').replaceAll(/[^a-z0-9-]+/g, '-')}`.slice(0, 62);
-        const newTask = await apifyClient.tasks().create({
+        const name = `${randomInt(1, 1_000_000)}${title
+            .toLowerCase()
+            .replaceAll(/\s+/g, '')
+            .replaceAll(/[^a-z0-9-]+/g, '-')}`.slice(0, 62);
+        const newTask = (await apifyClient.tasks().create({
             actId: actorNameOrId,
             actorStandby: actorStandbyOptions,
             description: `Task for testing standby version ${build}`,
             title,
             name,
-        }) as Task & { standbyUrl?: string };
+        })) as Task & { standbyUrl?: string };
 
         const { id, standbyUrl } = newTask;
 
@@ -225,11 +222,11 @@ const createStandbyTask = async (actorNameOrId: string, buildNumber?: string): P
         return {
             standbyUrl,
             taskId: id,
-        }
+        };
     } catch (error) {
         throw new Error(`Failed to create task: ${error}`);
     }
-}
+};
 
 const createStartRunFn = <T>(actorNameOrId: string, testContext: TestContext) => {
     const { annotate, task } = testContext;
@@ -237,34 +234,26 @@ const createStartRunFn = <T>(actorNameOrId: string, testContext: TestContext) =>
     const build = actorConfig?.buildNumber;
     const buildId = actorConfig?.buildId;
     return async (runOptions: RunOptions<T>) => {
-        const {
-            input,
-            options,
-            prefilledInput,
-            runId,
-        } = runOptions;
+        const { input, options, prefilledInput, runId } = runOptions;
 
         if (runId) {
-            const run = await apifyClient.run(runId).get()
+            const run = await apifyClient.run(runId).get();
             if (!run) {
                 throw new Error(`Run with id "${runId}" doesn't exist`);
             }
-            return new RunTestResult(apifyClient, run)
+            return new RunTestResult(apifyClient, run);
         }
 
         const actor = apifyClient.actor(actorNameOrId);
 
         const actorInput = {
-            ...(prefilledInput && await getActorPrefilledInput(apifyClient, actorNameOrId, buildId)),
+            ...(prefilledInput && (await getActorPrefilledInput(apifyClient, actorNameOrId, buildId))),
             ...input,
         };
-        const run = await actor.call(
-            actorInput,
-            { build, ...options, },
-        );
+        const run = await actor.call(actorInput, { build, ...options });
 
         const runLink = generateRunLink(run);
-        await annotate(runLink, 'run_link');
+        await annotate(`${task.name} - ${runLink}`, 'run_link');
         // @ts-expect-error: `TaskMeta` cannot be retyped
         task.meta = {
             runId: run.id,
@@ -281,4 +270,4 @@ const createStartRunFn = <T>(actorNameOrId: string, testContext: TestContext) =>
 
 const generateRunLink = (run: ActorRun | ActorRunListItem): string => {
     return `https://console.apify.com/view/runs/${run.id}`;
-}
+};

package/lib/run-test-result.ts

@@ -1,5 +1,5 @@
 import { ActorRun, ApifyClient, KeyValueStoreClient } from 'apify-client';
-import type { Dataset, SdkCrawlerStatistics } from './types';
+import type { Dataset, SdkCrawlerStatistics } from './types.js';
 
 export class RunTestResult {
     private log: string | undefined;
@@ -9,10 +9,9 @@ export class RunTestResult {
     private runInfo: ActorRun | undefined;
     private input: unknown | undefined;
 
-    constructor(
-        private readonly apifyClient: ApifyClient,
-        private readonly run: ActorRun,
-    ) { /**/ }
+    constructor(private readonly apifyClient: ApifyClient, private readonly run: ActorRun) {
+        /**/
+    }
 
     getStatistics = async (): Promise<SdkCrawlerStatistics | undefined> => {
         if (this.statistics) {
@@ -33,7 +32,7 @@ export class RunTestResult {
         return runLog as string;
     };
 
-    getDataset = async<T>(): Promise<Dataset<T>> => {
+    getDataset = async <T>(): Promise<Dataset<T>> => {
         if (this.dataset) {
             return this.dataset as Dataset<T>;
         }
@@ -49,18 +48,18 @@ export class RunTestResult {
         }
         const keyValueStoreClient = this.apifyClient.keyValueStore(this.run.defaultKeyValueStoreId);
         this.keyValueStoreClient = keyValueStoreClient;
-        return keyValueStoreClient
+        return keyValueStoreClient;
     };
 
-    getInput = async<T>(): Promise<T> => {
+    getInput = async <T>(): Promise<T> => {
         if (this.input) {
-            return this.input as T
+            return this.input as T;
         }
         const kvs = this.apifyClient.keyValueStore(this.run.defaultKeyValueStoreId);
         const input = await kvs.getRecord('INPUT');
         this.input = input?.value;
         return this.input as T;
-    }
+    };
 
     getRunInfo = async (): Promise<ActorRun> => {
         if (this.runInfo) {

package/lib/types.ts

@@ -6,58 +6,57 @@ export type ActorBuild = {
     actorId: string;
     buildNumber: string;
     actorName: string;
-}
+};
 
 export type RunOptions<T> = {
-    input: Omit<T, 'actorName'>
-    options?: ActorCallOptions
-    prefilledInput?: boolean
+    input: Omit<T, 'actorName'>;
+    options?: ActorCallOptions;
+    prefilledInput?: boolean;
     /**
      * If you specify `runId`, all the other options will be ignored and this run's data will
      * be downloaded instead.
      *
      * This is usefull for testing your tests on existing runs
      */
-    runId?: string
-}
+    runId?: string;
+};
 
 export type Dataset<T> = {
-    items: T[]
-}
+    items: T[];
+};
 
-export type OpenInterval = {
-    min: number
-    max?: undefined
-} | {
-    min?: undefined
-    max: number
-}
+export type OpenInterval =
+    | {
+          min: number;
+          max?: undefined;
+      }
+    | {
+          min?: undefined;
+          max: number;
+      };
 
 export type ClosedInterval = {
-    min: number
-    max: number
-}
+    min: number;
+    max: number;
+};
 
-export type Interval = number | OpenInterval | ClosedInterval
+export type Interval = number | OpenInterval | ClosedInterval;
 
 export type ToFinishWithOptionsWithDefaults = {
-    status: RunStatus
-    duration: Interval | null
-    failedRequests: Interval | null
-    requestsRetries: Interval | null
-    forbiddenLogs: string[]
-    maxRetriesPerRequest: number | null
-}
+    status: RunStatus;
+    duration: Interval | null;
+    failedRequests: Interval | null;
+    requestsRetries: Interval | null;
+    forbiddenLogs: string[];
+    maxRetriesPerRequest: number | null;
+};
 export type IntervalOption<PpeEvent extends string> = keyof Pick<
     ToFinishWithOptions<PpeEvent>,
-    | 'datasetItemCount'
-    | 'requestsRetries'
-    | 'failedRequests'
-    | 'duration'
->
+    'datasetItemCount' | 'requestsRetries' | 'failedRequests' | 'duration'
+>;
 
 export type ToFinishWithOptions<PpeEvent extends string> = Partial<ToFinishWithOptionsWithDefaults> & {
-    datasetItemCount: Interval
+    datasetItemCount: Interval;
     /**
      * Define expected charged (PPE) event counts. You can also define count as `Interval`.
      *
@@ -72,26 +71,26 @@ export type ToFinishWithOptions<PpeEvent extends string> = Partial<ToFinishWithO
      * 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>
+    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
-}
+    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'
@@ -101,22 +100,22 @@ export type RunStatus =
     | 'ABORTING'
     | 'ABORTED'
     | 'TIMING-OUT'
-    | 'TIMED-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
+    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`)
@@ -128,9 +127,9 @@ export interface ActorMatchers<R = unknown> {
      * - `datasetItemCount` (required)
      * - `chargedEventCounts`
      */
-    toFinishWith: <PpeEvent extends string>(options: ToFinishWithOptions<PpeEvent>) => Promise<R>
-    toStartWith: (prefix: string) => R
-    hard: <T>(actual: T, message?: string) => Assertion
+    toFinishWith: <PpeEvent extends string>(options: ToFinishWithOptions<PpeEvent>) => Promise<R>;
+    toStartWith: (prefix: string) => R;
+    hard: <T>(actual: T, message?: string) => Assertion;
 }
 
 export type ActorTestOptions = Omit<TestOptions, 'retry'> & {
@@ -146,6 +145,8 @@ export type ActorTestOptions = Omit<TestOptions, 'retry'> & {
 
 declare module 'vitest' {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    interface Assertion<T = any> extends ActorMatchers<T> { }
-    interface AsymmetricMatchersContaining extends ActorMatchers { }
+    interface Assertion<T = any> extends ActorMatchers<T> {}
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    interface Matchers<T = any> extends ActorMatchers<T> {}
+    interface AsymmetricMatchersContaining extends ActorMatchers {}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "apify-test-tools",
-    "version": "0.5.0",
+    "version": "0.5.2",
     "type": "module",
     "description": "TBD",
     "engines": {
@@ -28,6 +28,9 @@
         "typescript": "^5.7",
         "vitest": "^3.2.4"
     },
+    "peerDependencies": {
+        "vitest": ">=3.2.4"
+    },
     "scripts": {
         "start": "npm run dist/bin/main.js",
         "start:dev": "GITHUB_WORKSPACE=local-clone tsx bin/main.ts",