apify-test-tools 0.9.1-beta.5 → 0.9.1-beta.6

package/dist/bin/utils/config/parser.js

@@ -0,0 +1,72 @@
+import z from 'zod';
+import { CONFIG_FILE_STRATEGY } from './structures/base.js';
+import { LEGACY_PARSER } from './structures/legacy.js';
+const CONFIG_FILE_STRATEGIES = {
+    [CONFIG_FILE_STRATEGY.LEGACY]: LEGACY_PARSER,
+};
+const ModeSelectionSchema = z.enum(CONFIG_FILE_STRATEGY).default(CONFIG_FILE_STRATEGY.LEGACY);
+function selectStrategy(mode) {
+    const parsed = ModeSelectionSchema.safeParse(mode);
+    if (!parsed.success) {
+        throw new Error(z.prettifyError(parsed.error));
+    }
+    return CONFIG_FILE_STRATEGIES[parsed.data];
+}
+// Strips a trailing slash so config-declared paths ("actors/shopify/" vs "actors/shopify") compare equal.
+const stripTrailingSlash = (pathValue) => pathValue.replace(/\/+$/, '');
+// The repo root may be written as ".", "./", "/" or ""; everything downstream spells it "".
+const normalizeFolder = (folder) => {
+    const stripped = stripTrailingSlash(folder);
+    return stripped === '.' ? '' : stripped;
+};
+/**
+ * Normalizes the paths the user wrote and checks the cross-entry invariants a per-entry schema
+ * cannot: that no two actors claim the same folder once normalized, nor the same actor on the
+ * platform. Collects every violation before throwing, so one run reports all of them rather than
+ * only the first.
+ *
+ * @returns the actors it vouched for, with their paths normalized.
+ * @throws Error listing every problem found.
+ */
+function verifyConfiguration(body) {
+    const seenFolders = new Set();
+    const seenActorFullNames = new Set();
+    const errors = [];
+    const normalized = body.map((entry) => ({
+        ...entry,
+        folder: normalizeFolder(entry.folder),
+        overrideActorContext: entry.overrideActorContext?.map(stripTrailingSlash),
+    }));
+    for (const [index, entry] of normalized.entries()) {
+        // TODO: drop folder uniqueness (this requires several changes on other places)
+        if (seenFolders.has(entry.folder)) {
+            errors.push(`Duplicate folder "${body[index].folder}". Each actor must have a unique folder.`);
+        }
+        else {
+            seenFolders.add(entry.folder);
+        }
+        if (seenActorFullNames.has(entry.actorFullName)) {
+            errors.push(`Duplicate actor "${entry.actorFullName}". Each entry must point at a different actor.`);
+        }
+        else {
+            seenActorFullNames.add(entry.actorFullName);
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(errors.join('\n'));
+    }
+    return normalized;
+}
+// eslint-disable-next-line no-underscore-dangle
+export const _privates = {
+    selectStrategy,
+    verifyConfiguration,
+};
+export function parseConfigFile(body) {
+    const { mode, ...rest } = body;
+    const strategy = selectStrategy(mode);
+    const resolved = strategy.parse(rest);
+    const validated = verifyConfiguration(resolved);
+    return validated;
+}
+//# sourceMappingURL=parser.js.map

package/dist/bin/utils/config/parser.js.map

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

package/dist/bin/utils/config/structures/base.d.ts

@@ -0,0 +1,35 @@
+import { type ZodType } from 'zod';
+export declare const ACTOR_FULL_NAME_REGEX: RegExp;
+export interface ResolvedActorConfig {
+    actorFullName: string;
+    folder: string;
+    tokenEnvVar: string;
+    overrideActorContext?: string[];
+}
+export declare enum CONFIG_FILE_STRATEGY {
+    LEGACY = "legacy"
+}
+export type StrategyParser = {
+    mode: CONFIG_FILE_STRATEGY;
+    parse: (body: Record<string, unknown>) => ResolvedActorConfig[];
+};
+export declare function defineStrategy<T extends Record<string, unknown>, Mode extends CONFIG_FILE_STRATEGY>(mode: Mode, schema: ZodType<T>, resolve: (body: T) => ResolvedActorConfig[]): {
+    mode: Mode;
+    /**
+     *
+     * @param body raw config file to be read
+     * @returns ResolvedActorConfig[] if the config file is valid, otherwise throws an error with a description of the issues.
+     * @throws Error if the config file is invalid.
+     * @example
+     * ```ts
+     * const strategy = defineStrategy(CONFIG_FILE_STRATEGY.LEGACY, schema, resolve);
+     * const resolvedActors = strategy.parse(configFileContents);
+     * ```
+     *
+     * This function is used to parse the config file according to the strategy defined by the user.
+     * It uses the schema defined in the strategy to validate the config file and resolve it into a list of ResolvedActorConfig.
+     * If the config file is invalid, it throws an error with a description of the issues.
+     */
+    parse: (body: Record<string, unknown>) => ResolvedActorConfig[];
+};
+//# sourceMappingURL=base.d.ts.map

package/dist/bin/utils/config/structures/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../bin/utils/config/structures/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAQlD,eAAO,MAAM,qBAAqB,QAGjC,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,oBAAY,oBAAoB;IAC5B,MAAM,WAAW;CACpB;AAED,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,mBAAmB,EAAE,CAAC;CACnE,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,SAAS,oBAAoB,EAE/F,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,mBAAmB,EAAE;;IAIvC;;;;;;;;;;;;;;OAcG;kBACW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAQ5C"}

package/dist/bin/utils/config/structures/base.js

@@ -0,0 +1,40 @@
+import { prettifyError } from 'zod';
+import { ACTOR_NAME, USERNAME } from '@apify/consts';
+function stripRegexAnchor(regex) {
+    return regex.replace(/^\^/, '').replace(/\$$/, '');
+}
+export const ACTOR_FULL_NAME_REGEX = new RegExp(`^${stripRegexAnchor(USERNAME.REGEX.source)}/${stripRegexAnchor(ACTOR_NAME.REGEX.source)}$`, USERNAME.REGEX.flags + ACTOR_NAME.REGEX.flags);
+export var CONFIG_FILE_STRATEGY;
+(function (CONFIG_FILE_STRATEGY) {
+    CONFIG_FILE_STRATEGY["LEGACY"] = "legacy";
+})(CONFIG_FILE_STRATEGY || (CONFIG_FILE_STRATEGY = {}));
+export function defineStrategy(
+// mode is transparent so it can be validated with & { mode: Mode }
+mode, schema, resolve) {
+    return {
+        mode,
+        /**
+         *
+         * @param body raw config file to be read
+         * @returns ResolvedActorConfig[] if the config file is valid, otherwise throws an error with a description of the issues.
+         * @throws Error if the config file is invalid.
+         * @example
+         * ```ts
+         * const strategy = defineStrategy(CONFIG_FILE_STRATEGY.LEGACY, schema, resolve);
+         * const resolvedActors = strategy.parse(configFileContents);
+         * ```
+         *
+         * This function is used to parse the config file according to the strategy defined by the user.
+         * It uses the schema defined in the strategy to validate the config file and resolve it into a list of ResolvedActorConfig.
+         * If the config file is invalid, it throws an error with a description of the issues.
+         */
+        parse: (body) => {
+            const parsed = schema.safeParse(body);
+            if (parsed.success) {
+                return resolve(parsed.data);
+            }
+            throw new Error(prettifyError(parsed.error));
+        },
+    };
+}
+//# sourceMappingURL=base.js.map

package/dist/bin/utils/config/structures/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../bin/utils/config/structures/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgB,MAAM,KAAK,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAErD,SAAS,gBAAgB,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,MAAM,CAC3C,IAAI,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAC3F,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAChD,CAAC;AASF,MAAM,CAAN,IAAY,oBAEX;AAFD,WAAY,oBAAoB;IAC5B,yCAAiB,CAAA;AACrB,CAAC,EAFW,oBAAoB,KAApB,oBAAoB,QAE/B;AAOD,MAAM,UAAU,cAAc;AAC1B,mEAAmE;AACnE,IAAU,EACV,MAAkB,EAClB,OAA2C;IAE3C,OAAO;QACH,IAAI;QACJ;;;;;;;;;;;;;;WAcG;QACH,KAAK,EAAE,CAAC,IAA6B,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/bin/utils/config/structures/legacy.d.ts

@@ -0,0 +1,6 @@
+import { CONFIG_FILE_STRATEGY } from './base.js';
+export declare const LEGACY_PARSER: {
+    mode: CONFIG_FILE_STRATEGY;
+    parse: (body: Record<string, unknown>) => import("./base.js").ResolvedActorConfig[];
+};
+//# sourceMappingURL=legacy.d.ts.map

package/dist/bin/utils/config/structures/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../../../../bin/utils/config/structures/legacy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,oBAAoB,EAAkB,MAAM,WAAW,CAAC;AAiBxF,eAAO,MAAM,aAAa;;;CAA2F,CAAC"}

package/dist/bin/utils/config/structures/legacy.js

@@ -0,0 +1,14 @@
+import z from 'zod';
+import { ACTOR_FULL_NAME_REGEX, CONFIG_FILE_STRATEGY, defineStrategy } from './base.js';
+const schema = z.object({
+    actors: z
+        .array(z.object({
+        folder: z.string(),
+        actorFullName: z.string().regex(ACTOR_FULL_NAME_REGEX),
+        tokenEnvVar: z.string(),
+        overrideActorContext: z.array(z.string()).optional(),
+    }))
+        .min(1),
+});
+export const LEGACY_PARSER = defineStrategy(CONFIG_FILE_STRATEGY.LEGACY, schema, (body) => body.actors);
+//# sourceMappingURL=legacy.js.map

package/dist/bin/utils/config/structures/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../../../../../bin/utils/config/structures/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAExF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC;SACJ,KAAK,CACF,CAAC,CAAC,MAAM,CAAC;QACL,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC;QACtD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvD,CAAC,CACL;SACA,GAAG,CAAC,CAAC,CAAC;CACd,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,IAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC"}

package/dist/test/unit/bin/utils/config/load-config.test.d.ts

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

package/dist/test/unit/bin/utils/config/load-config.test.d.ts.map

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

package/dist/test/unit/bin/utils/config/load-config.test.js

@@ -0,0 +1,138 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { CONFIG_FILE_NAME, loadActorConfig, readConfigFile } from '../../../../../bin/utils/config/load-config.js';
+let repoDir;
+let originalCwd;
+beforeEach(async () => {
+    originalCwd = process.cwd();
+    // `realpath` because macOS hands out a symlinked temp dir, while `process.cwd()` reports the target.
+    repoDir = await fs.realpath(await fs.mkdtemp(path.join(os.tmpdir(), 'apify-test-tools-config-')));
+    process.chdir(repoDir);
+});
+afterEach(async () => {
+    process.chdir(originalCwd);
+    await fs.rm(repoDir, { recursive: true, force: true });
+});
+const emptyActorSelection = { actors: [], ignore: [] };
+const validConfig = (actors) => JSON.stringify({ actors });
+const actorJson = (fields = {}) => JSON.stringify(fields);
+const writeFiles = async (files) => Promise.all(Object.entries(files).map(async ([filePath, contents]) => {
+    const absPath = path.join(repoDir, filePath);
+    await fs.mkdir(path.dirname(absPath), { recursive: true });
+    await fs.writeFile(absPath, contents);
+}));
+describe('loadActorConfig', () => {
+    const entry = (fields = {}) => ({
+        folder: 'actors/shopify',
+        actorFullName: 'myteam/shopify',
+        tokenEnvVar: 'APIFY_TOKEN',
+        ...fields,
+    });
+    const writeActorJson = async (fields = {}) => writeFiles({ 'actors/shopify/.actor/actor.json': actorJson(fields) });
+    it('resolves data coming from actor.json', async () => {
+        await writeActorJson({ dockerContextDir: '..' });
+        expect(loadActorConfig(entry())).toEqual({
+            actorFullName: 'myteam/shopify',
+            folder: 'actors/shopify',
+            tokenEnvVar: 'APIFY_TOKEN',
+            dockerContextDir: 'actors/shopify',
+            contextPaths: ['actors/shopify'],
+        });
+    });
+    it('defaults dockerContextDir to the actor folder when actor.json does not set it', async () => {
+        await writeActorJson();
+        expect(loadActorConfig(entry()).dockerContextDir).toBe('actors/shopify');
+    });
+    it('resolves dockerContextDir relative to the .actor/ folder, not the actor folder', async () => {
+        await writeActorJson({ dockerContextDir: '../../..' });
+        expect(loadActorConfig(entry()).dockerContextDir).toBe('');
+    });
+    it('throws when dockerContextDir resolves outside the repository root', async () => {
+        await writeActorJson({ dockerContextDir: '../../../..' });
+        expect(() => loadActorConfig(entry())).toThrow(/resolves outside the repository root/);
+    });
+    it('throws when actor.json is missing', () => {
+        expect(() => loadActorConfig(entry())).toThrow('Cannot read');
+    });
+    it('resolves contextPaths from overrideActorContext', async () => {
+        await writeActorJson({ dockerContextDir: '../../..' });
+        expect(loadActorConfig(entry({ overrideActorContext: ['actors/shopify', 'packages'] })).contextPaths).toEqual([
+            'actors/shopify',
+            'packages',
+        ]);
+    });
+    it('adds the actor own folder automatically when overrideActorContext does not cover it', async () => {
+        await writeActorJson();
+        expect(loadActorConfig(entry({ overrideActorContext: ['code', 'shared'] })).contextPaths).toEqual([
+            'code',
+            'shared',
+            'actors/shopify',
+        ]);
+    });
+    it('allows overrideActorContext with disjoint sibling paths that all reach the actor folder via one entry', async () => {
+        await writeActorJson();
+        expect(loadActorConfig(entry({ overrideActorContext: ['actors/shopify', 'code', 'shared'] })).contextPaths).toEqual(['actors/shopify', 'code', 'shared']);
+    });
+    it('throws when overrideActorContext entries overlap (one is a prefix of another)', async () => {
+        await writeActorJson();
+        expect(() => loadActorConfig(entry({ overrideActorContext: ['actors/shopify', 'actors'] }))).toThrow(/overlap/);
+    });
+    it('throws when overrideActorContext contains the repo root alongside another entry', async () => {
+        await writeActorJson();
+        expect(() => loadActorConfig(entry({ overrideActorContext: ['', 'actors/shopify'] }))).toThrow(/overlap/);
+    });
+});
+describe('readConfigFile', () => {
+    // Golden output massaging the whole config reading process
+    it("carries the parser's normalization through to ActorConfig[]", async () => {
+        await writeFiles({
+            [CONFIG_FILE_NAME]: validConfig([
+                { folder: '.', actorFullName: 'apify/root', tokenEnvVar: 'APIFY_TOKEN_APIFY' },
+                {
+                    folder: 'actors/shopify/',
+                    actorFullName: 'myteam/shopify',
+                    tokenEnvVar: 'APIFY_TOKEN',
+                    overrideActorContext: ['actors/shopify/', 'packages/'],
+                },
+            ]),
+            '.actor/actor.json': actorJson({}),
+            'actors/shopify/.actor/actor.json': actorJson({}),
+        });
+        expect(await readConfigFile(emptyActorSelection)).toEqual([
+            {
+                actorFullName: 'apify/root',
+                folder: '',
+                tokenEnvVar: 'APIFY_TOKEN_APIFY',
+                dockerContextDir: '',
+                contextPaths: [''],
+            },
+            {
+                actorFullName: 'myteam/shopify',
+                folder: 'actors/shopify',
+                tokenEnvVar: 'APIFY_TOKEN',
+                dockerContextDir: 'actors/shopify',
+                contextPaths: ['actors/shopify', 'packages'],
+            },
+        ]);
+    });
+    it('throws when config file is missing', async () => {
+        await expect(readConfigFile(emptyActorSelection)).rejects.toThrow('not found');
+    });
+    it('throws when config file contains invalid JSON', async () => {
+        await writeFiles({ [CONFIG_FILE_NAME]: '{bad json' });
+        await expect(readConfigFile(emptyActorSelection)).rejects.toThrow('invalid JSON');
+    });
+    it('throws when the config file is not a JSON object', async () => {
+        await writeFiles({ [CONFIG_FILE_NAME]: JSON.stringify([{ folder: 'actors/shopify' }]) });
+        await expect(readConfigFile(emptyActorSelection)).rejects.toThrow('"actors" array');
+    });
+    // The wording of a schema failure belongs to the strategy; this only checks that the failure
+    // reaches the caller rather than being swallowed on the way out of readConfigFile.
+    it('surfaces a schema failure from the parser', async () => {
+        await writeFiles({ [CONFIG_FILE_NAME]: JSON.stringify({ notActors: [] }) });
+        await expect(readConfigFile(emptyActorSelection)).rejects.toThrow(/at actors/);
+    });
+});
+//# sourceMappingURL=load-config.test.js.map

package/dist/test/unit/bin/utils/config/load-config.test.js.map

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

package/dist/test/unit/bin/utils/config/parser.test.d.ts

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

package/dist/test/unit/bin/utils/config/parser.test.d.ts.map

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

package/dist/test/unit/bin/utils/config/parser.test.js

@@ -0,0 +1,111 @@
+import { describe, expect, it } from 'vitest';
+import { _privates, parseConfigFile } from '../../../../../bin/utils/config/parser.js';
+import { CONFIG_FILE_STRATEGY } from '../../../../../bin/utils/config/structures/base.js';
+import { LEGACY_PARSER } from '../../../../../bin/utils/config/structures/legacy.js';
+const { selectStrategy, verifyConfiguration } = _privates;
+const actor = (fields = {}) => ({
+    folder: 'actors/shopify',
+    actorFullName: 'myteam/shopify',
+    tokenEnvVar: 'APIFY_TOKEN',
+    ...fields,
+});
+describe('selectStrategy', () => {
+    it('falls back to the legacy strategy when no mode is declared', () => {
+        expect(selectStrategy(undefined)).toBe(LEGACY_PARSER);
+    });
+    it('honours an explicit mode', () => {
+        expect(selectStrategy(CONFIG_FILE_STRATEGY.LEGACY)).toBe(LEGACY_PARSER);
+    });
+    it('throws on a mode no strategy is registered for', () => {
+        expect(() => selectStrategy('some-nonexistent-mode')).toThrow(/Invalid input/);
+    });
+});
+describe('verifyConfiguration', () => {
+    it('resolves the repo root to "" and gets rid of trailing slashes', () => {
+        const result = verifyConfiguration([
+            { folder: '.', actorFullName: 'myteam/root', tokenEnvVar: 'APIFY_TOKEN' },
+            {
+                folder: 'actors/shopify/',
+                actorFullName: 'myteam/shopify',
+                tokenEnvVar: 'APIFY_TOKEN',
+                overrideActorContext: ['packages/'],
+            },
+        ]);
+        expect(result).toEqual([
+            { folder: '', actorFullName: 'myteam/root', tokenEnvVar: 'APIFY_TOKEN', overrideActorContext: undefined },
+            {
+                folder: 'actors/shopify',
+                actorFullName: 'myteam/shopify',
+                tokenEnvVar: 'APIFY_TOKEN',
+                overrideActorContext: ['packages'],
+            },
+        ]);
+    });
+    it.each([
+        ['"." and ""', '.', ''],
+        ['weird roots', '', './//'],
+        ['a trailing slash', 'actors/shopify', 'actors/shopify/'],
+    ])('rejects folders that collide once normalized: %s', (_name, first, second) => {
+        expect(() => verifyConfiguration([
+            actor({ folder: first, actorFullName: 'myteam/actor-a' }),
+            actor({ folder: second, actorFullName: 'myteam/actor-b' }),
+        ])).toThrow(/Duplicate folder/);
+    });
+    it('quotes a duplicate folder the way it was written, not the way it normalized', () => {
+        expect(() => verifyConfiguration([
+            actor({ folder: '.', actorFullName: 'myteam/actor-a' }),
+            actor({ folder: './', actorFullName: 'myteam/actor-b' }),
+        ])).toThrow('Duplicate folder "./"');
+    });
+    it('rejects two entries pointing at the same actor', () => {
+        expect(() => verifyConfiguration([actor({ folder: 'actors/a' }), actor({ folder: 'actors/b' })])).toThrow(/Duplicate actor "myteam\/shopify"/);
+    });
+    it('treats actorFullName case-sensitively — "myteam/A" is not "myteam/a"', () => {
+        expect(() => verifyConfiguration([
+            actor({ folder: 'actors/a', actorFullName: 'myteam/abc' }),
+            actor({ folder: 'actors/b', actorFullName: 'myteam/ABC' }),
+        ])).not.toThrow();
+    });
+    it('reports every collision at once instead of stopping at the first', () => {
+        const message = (() => {
+            try {
+                verifyConfiguration([
+                    actor({ folder: 'actors/a', actorFullName: 'myteam/actor-a' }),
+                    actor({ folder: 'actors/a', actorFullName: 'myteam/actor-b' }),
+                    actor({ folder: 'actors/c', actorFullName: 'myteam/actor-c' }),
+                    actor({ folder: 'actors/d', actorFullName: 'myteam/actor-c' }),
+                ]);
+                return '';
+            }
+            catch (err) {
+                return err.message;
+            }
+        })();
+        expect(message.split('\n')).toEqual([
+            'Duplicate folder "actors/a". Each actor must have a unique folder.',
+            'Duplicate actor "myteam/actor-c". Each entry must point at a different actor.',
+        ]);
+    });
+    it('reports both problems for an entry that duplicates a folder and an actor at once', () => {
+        expect(() => verifyConfiguration([actor(), actor()])).toThrow(/Duplicate folder[\s\S]*Duplicate actor/);
+    });
+    it('accepts an empty configuration', () => {
+        expect(verifyConfiguration([])).toEqual([]);
+    });
+});
+describe('parseConfigFile', () => {
+    it('validates and normalizes a plain object without touching the filesystem', () => {
+        expect(parseConfigFile({ actors: [actor({ folder: 'actors/shopify/' })] })).toEqual([
+            actor({ folder: 'actors/shopify', overrideActorContext: undefined }),
+        ]);
+    });
+    it('surfaces cross-entry violations from verifyConfiguration', () => {
+        expect(() => parseConfigFile({
+            actors: [
+                actor({ actorFullName: 'myteam/actor-a', folder: 'collide/collide' }),
+                actor({ actorFullName: 'myteam/actor-b', folder: 'collide/collide' }),
+            ],
+        })).toThrow(/Duplicate folder/);
+    });
+});
+//# sourceMappingURL=parser.test.js.map

package/dist/test/unit/bin/utils/config/parser.test.js.map

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

package/dist/test/unit/bin/utils/config/structures/base.test.d.ts

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

package/dist/test/unit/bin/utils/config/structures/base.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.test.d.ts","sourceRoot":"","sources":["../../../../../../../test/unit/bin/utils/config/structures/base.test.ts"],"names":[],"mappings":""}

package/dist/test/unit/bin/utils/config/structures/base.test.js

@@ -0,0 +1,74 @@
+import { describe, expect, it } from 'vitest';
+import { ACTOR_NAME, USERNAME } from '@apify/consts';
+import { ACTOR_FULL_NAME_REGEX } from '../../../../../../bin/utils/config/structures/base.js';
+// ACTOR_FULL_NAME_REGEX is spliced together from two platform constants by stripping their anchors
+// and joining them with a "/". These tests are about the splice, not about re-testing the platform's
+// own rules: an anchor left behind, an anchor stripped too eagerly, or the actor-name alternation
+// losing its parentheses would all produce a regex that still looks plausible and matches the wrong
+// things. The cases below are the ones that tell those failures apart.
+describe('ACTOR_FULL_NAME_REGEX', () => {
+    it.each([
+        ['apify/web-scraper'],
+        ['myteam/shopify'],
+        ['my.team/web-scraper'],
+        ['my-team/shopify'],
+        ['my_team/a1'],
+        // ACTOR_NAME's first alternative — a single character — is a legal actor name on its own.
+        ['myteam/a'],
+        ['myteam/a--b'],
+    ])('accepts %s', (fullName) => {
+        expect(ACTOR_FULL_NAME_REGEX.test(fullName)).toBe(true);
+    });
+    it.each([
+        ['there is no slash', 'shopify'],
+        ['the owner half is empty', '/shopify'],
+        ['the actor half is empty', 'myteam/'],
+        ['there are two slashes', 'myteam//shopify'],
+        ['there is a third segment', 'myteam/shopify/extra'],
+        ['the owner holds a space', 'my team/shopify'],
+        ['the actor name starts with a hyphen', 'myteam/-shopify'],
+        ['the actor name ends with a hyphen', 'myteam/shopify-'],
+        ['the actor name holds an underscore', 'myteam/web_scraper'],
+        ['the actor name holds a dot', 'myteam/web.scraper'],
+    ])('rejects a name where %s', (_name, fullName) => {
+        expect(ACTOR_FULL_NAME_REGEX.test(fullName)).toBe(false);
+    });
+    // Both halves arrive anchored and get de-anchored so they can be joined; the composed regex has to
+    // put the anchors back. Without them these all match on a substring.
+    it.each([
+        ['leading text', 'see myteam/shopify'],
+        ['trailing text', 'myteam/shopify here'],
+        ['a leading newline', '\nmyteam/shopify'],
+        ['a trailing newline', 'myteam/shopify\n'],
+        ['surrounding whitespace', ' myteam/shopify '],
+    ])('matches the whole string, so it rejects %s', (_name, fullName) => {
+        expect(ACTOR_FULL_NAME_REGEX.test(fullName)).toBe(false);
+    });
+    // ACTOR_NAME's source is an alternation, "(A|B)". It survives the splice only because the platform
+    // wrote it parenthesized — lose those parens and the regex becomes "^owner/A|B$", where the "B"
+    // branch matches a bare actor name with no owner at all.
+    it('keeps the actor-name alternation from swallowing the owner half', () => {
+        expect(ACTOR_NAME.REGEX.source).toMatch(/^\^\(.*\)\$$/);
+        expect(ACTOR_FULL_NAME_REGEX.test('shopify')).toBe(false);
+        expect(ACTOR_FULL_NAME_REGEX.test('a')).toBe(false);
+    });
+    // The owner half carries a {min,max} quantifier, the one part of either source that a sloppy strip
+    // could eat. Bounds come from the constants so this stays honest if the platform moves them.
+    it("enforces the platform's username length bounds", () => {
+        const owner = (length) => `${'a'.repeat(length)}/shopify`;
+        expect(ACTOR_FULL_NAME_REGEX.test(owner(USERNAME.MIN_LENGTH))).toBe(true);
+        expect(ACTOR_FULL_NAME_REGEX.test(owner(USERNAME.MIN_LENGTH - 1))).toBe(false);
+        expect(ACTOR_FULL_NAME_REGEX.test(owner(USERNAME.MAX_LENGTH))).toBe(true);
+        expect(ACTOR_FULL_NAME_REGEX.test(owner(USERNAME.MAX_LENGTH + 1))).toBe(false);
+    });
+    // `.source` carries the pattern and none of the flags, so the flags have to be re-applied by hand.
+    // USERNAME.REGEX is declared /i and the platform does accept "MyTeam" as a username; drop that on
+    // the way here and the owner half silently becomes stricter than the thing it was copied from.
+    it('accepts either half in any case, the way the platform does', () => {
+        expect(USERNAME.REGEX.flags).toContain('i');
+        expect(ACTOR_FULL_NAME_REGEX.flags).toContain('i');
+        expect(ACTOR_FULL_NAME_REGEX.test('myteam/Shopify')).toBe(true);
+        expect(ACTOR_FULL_NAME_REGEX.test('MyTeam/shopify')).toBe(true);
+    });
+});
+//# sourceMappingURL=base.test.js.map

package/dist/test/unit/bin/utils/config/structures/base.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.test.js","sourceRoot":"","sources":["../../../../../../../test/unit/bin/utils/config/structures/base.test.ts"],"names":[],"mappings":"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"}

package/dist/test/unit/bin/utils/config/structures/legacy.test.d.ts

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

package/dist/test/unit/bin/utils/config/structures/legacy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.test.d.ts","sourceRoot":"","sources":["../../../../../../../test/unit/bin/utils/config/structures/legacy.test.ts"],"names":[],"mappings":""}