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

package/.github/workflows/on_pull_request.yaml

@@ -12,7 +12,7 @@ jobs:
         name: PR title check
         runs-on: ubuntu-latest
         steps:
-            - uses: apify/actions/pr-title-check@v1.3.0
+            - uses: apify/actions/pr-title-check@v1.6.1
 
     code_checks:
         name: Code checks

package/CHANGELOG.md

@@ -5,6 +5,10 @@ All notable changes to this project will be documented in this file.
 <!-- git-cliff-unreleased-start -->
 ## 0.9.1 - **not yet released**
 
+### 🚀 Features
+
+- **config/modes:** Lay groundwork for multiple configuration structures ([#142](https://github.com/apify/apify-test-tools/pull/142)) ([7e18638](https://github.com/apify/apify-test-tools/commit/7e18638a8d3523154dbe819312c2b16b54c548ff)) by [@JuanGalilea](https://github.com/JuanGalilea)
+
 ### 🐛 Bug Fixes
 
 - Apply default actor timeout to runs ([#134](https://github.com/apify/apify-test-tools/pull/134)) ([82f5f7d](https://github.com/apify/apify-test-tools/commit/82f5f7d4de990db7ad8edf940c19ffd6b20bad13)) by [@Patai5](https://github.com/Patai5)

package/bin/utils/config/load-config.ts

@@ -1,61 +1,23 @@
 import path from 'node:path';
 
-import { z } from 'zod';
-
 import { selectActors } from '../../actor-filtering.js';
 import { isPathWithinScope } from '../../path-utils.js';
 import type { ActorConfig } from '../../types.js';
 import { safeReadJsonObjectFile } from '../json-file.js';
+import { parseConfigFile } from './parser.js';
+import type { ResolvedActorConfig } from './structures/base.js';
 
 export const CONFIG_FILE_NAME = 'apify-test-tools.config.json';
 
-// Reading the config happens in four stages, each one swappable on its own:
+// Reading the config happens in three stages, each one swappable on its own:
 //
 //   1. file                -> plain object          (safeReadJsonObjectFile)
-//   2. plain object        -> ActorConfigFile       (parseConfigFile — the schema, swap point for new flavours)
-//   3. ActorConfigFile     -> ResolvedActorConfig[] (resolveRawConfig — one normalized shape for everyone)
-//   4. ResolvedActorConfig -> ActorConfig           (loadActorConfig — merges in .actor/actor.json)
-//
-// Stages 1-3 are the "what did the user write" half and stage 4 the "what does the repo look like"
-// half. A differently shaped config file only has to reach stage 3's output to work with the rest
-// of the tool.
-
-// #region schema (soon to be moved)
-
-const ACTOR_ENTRY_SCHEMA = z.object({
-    folder: z.string(),
-    // "owner/name", with neither half empty — deliberately permissive about what characters those
-    // halves may contain, the platform is the authority on that.
-    actorFullName: z.string().regex(/^[^/]+\/[^/]+$/),
-    tokenEnvVar: z.string(),
-    overrideActorContext: z.array(z.string()).optional(),
-});
-
-const CONFIG_FILE_SCHEMA = z.object({
-    actors: z.array(ACTOR_ENTRY_SCHEMA),
-});
-
-export type ActorConfigFile = z.infer<typeof CONFIG_FILE_SCHEMA>;
-
-/**
- * The single shape stage 4 understands: an actor entry whose paths have been normalized, with no
- * trace left of which config flavour produced it. Whatever replaces or extends
- * {@link parseConfigFile} and {@link resolveRawConfig} only has to produce this.
- */
-export interface ResolvedActorConfig {
-    actorFullName: string;
-    folder: string;
-    tokenEnvVar: string;
-    overrideActorContext?: string[];
-}
-
-// #endregion
+//   2. plain object        -> ResolvedActorConfig[] (parseConfigFile — picks a strategy, validates
+//                                                    and normalizes; see ./parser.ts)
+//   3. ResolvedActorConfig -> ActorConfig           (loadActorConfig — merges in .actor/actor.json)
 
 // #region utils
 
-// Strips a trailing slash so config-declared paths ("actors/shopify/" vs "actors/shopify") compare equal.
-const stripTrailingSlash = (pathValue: string): string => pathValue.replace(/\/+$/, '');
-
 const findOverlappingContextPaths = (contextPaths: string[]): [string, string] | undefined => {
     for (let i = 0; i < contextPaths.length; i++) {
         for (let j = i + 1; j < contextPaths.length; j++) {
@@ -70,41 +32,9 @@ const findOverlappingContextPaths = (contextPaths: string[]): [string, string] |
     return undefined;
 };
 
-type ConfigParsingIssue = z.ZodError<ActorConfigFile>['issues'][number];
-
-// Restates a schema violation in the wording this config file has always used, so error output
-// stays recognizable now that the hand-rolled checks are gone.
-const describeIssue = (issue: ConfigParsingIssue, rawActors: unknown[]): string => {
-    const [, index, field] = issue.path;
-
-    if (typeof index !== 'number') {
-        return `Config file "${CONFIG_FILE_NAME}" must have an "actors" array at the top level.`;
-    }
-
-    const folder = (rawActors[index] as { folder?: unknown } | undefined)?.folder;
-
-    switch (field) {
-        case 'folder':
-            return (
-                `Invalid "folder" for actor entry at index ${index} in "${CONFIG_FILE_NAME}". ` +
-                `Must be a string (use "." for a single-actor repo).`
-            );
-        case 'actorFullName':
-            return (
-                `Invalid "actorFullName" for folder "${folder}" in "${CONFIG_FILE_NAME}". ` +
-                `Must be in "owner/name" format (e.g. "apify/web-scraper").`
-            );
-        case 'tokenEnvVar':
-            return `Invalid "tokenEnvVar" for folder "${folder}" in "${CONFIG_FILE_NAME}". Must be a string.`;
-        case 'overrideActorContext':
-            return (
-                `Invalid "overrideActorContext" for folder "${folder}" in "${CONFIG_FILE_NAME}". ` +
-                `Must be an array of strings.`
-            );
-        default:
-            return `Invalid actor entry at index ${index} in "${CONFIG_FILE_NAME}": ${issue.message}`;
-    }
-};
+// The repo root is spelled "" internally but "." in a config file, so report it the way a reader
+// would have written it.
+const displayFolder = (folder: string): string => folder || '.';
 
 // #endregion
 
@@ -133,52 +63,7 @@ const readConfigFileContents = async (): Promise<Record<string, unknown>> => {
 };
 
 /**
- * Stage 2 — validates the file's shape. Every problem is reported at once rather than only the
- * first one to fail.
- */
-export const parseConfigFile = (contents: Record<string, unknown>): ActorConfigFile => {
-    const parsed = CONFIG_FILE_SCHEMA.safeParse(contents);
-    if (parsed.success) {
-        return parsed.data;
-    }
-
-    const rawActors = Array.isArray(contents.actors) ? contents.actors : [];
-    const messages = new Set(parsed.error.issues.map((issue) => describeIssue(issue, rawActors)));
-    throw new Error([...messages].join('\n'));
-};
-
-/**
- * Stage 3 — normalizes the paths the user wrote and rejects entries that collide once normalized.
- * The repo root is "" from here on, however it was spelled in the file.
- */
-export const resolveRawConfig = (config: ActorConfigFile): ResolvedActorConfig[] => {
-    const seenFolders = new Set<string>();
-
-    return config.actors.map((entry) => {
-        const folder = entry.folder === '.' ? '' : stripTrailingSlash(entry.folder);
-
-        if (seenFolders.has(folder)) {
-            throw new Error(
-                `Duplicate folder "${entry.folder}" in "${CONFIG_FILE_NAME}". Each actor must have a unique folder.`,
-            );
-        }
-        seenFolders.add(folder);
-
-        return {
-            actorFullName: entry.actorFullName,
-            folder,
-            tokenEnvVar: entry.tokenEnvVar,
-            overrideActorContext: entry.overrideActorContext?.map(stripTrailingSlash),
-        };
-    });
-};
-
-// The repo root is spelled "" internally but "." in a config file, so report it the way a reader
-// would have written it.
-const displayFolder = (folder: string): string => folder || '.';
-
-/**
- * Stage 4 — resolves one normalized entry against the repo, reading the actor's `.actor/actor.json`
+ * Stage 3 — resolves one normalized entry against the repo, reading the actor's `.actor/actor.json`
  * for its `dockerContextDir` and deciding which paths count as the actor's context.
  */
 export const loadActorConfig = (entry: ResolvedActorConfig): ActorConfig => {
@@ -235,16 +120,13 @@ export const loadActorConfig = (entry: ResolvedActorConfig): ActorConfig => {
 // #endregion
 
 export const readConfigFile = async (selection: { actors: string[]; ignore: string[] }): Promise<ActorConfig[]> => {
-    const rawConfig = await readConfigFileContents();
-
-    // replace this when enabling different file structures
-    // some kind of strategy pattern seems appropriate here
-    const resolvedConfigs = resolveRawConfig(parseConfigFile(rawConfig));
+    const rawFileContents = await readConfigFileContents();
+    const parsedConfigs = parseConfigFile(rawFileContents);
 
     const actorConfigs: ActorConfig[] = [];
-    for (const resolved of resolvedConfigs) {
+    for (const parsed of parsedConfigs) {
         // Sequential on purpose: the first actor with a problem should be the one reported.
-        actorConfigs.push(loadActorConfig(resolved));
+        actorConfigs.push(loadActorConfig(parsed));
     }
 
     return selectActors(selection, actorConfigs);

package/bin/utils/config/parser.ts

@@ -0,0 +1,88 @@
+import z from 'zod';
+
+import { CONFIG_FILE_STRATEGY, type ResolvedActorConfig, type StrategyParser } from './structures/base.js';
+import { LEGACY_PARSER } from './structures/legacy.js';
+
+const CONFIG_FILE_STRATEGIES: {
+    // instead of Record, we do this to ensure that the modes match
+    [key in CONFIG_FILE_STRATEGY]: StrategyParser & { mode: key };
+} = {
+    [CONFIG_FILE_STRATEGY.LEGACY]: LEGACY_PARSER,
+} as const;
+
+const ModeSelectionSchema = z.enum(CONFIG_FILE_STRATEGY).default(CONFIG_FILE_STRATEGY.LEGACY);
+
+function selectStrategy(mode: unknown): StrategyParser {
+    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: string): string => pathValue.replace(/\/+$/, '');
+
+// The repo root may be written as ".", "./", "/" or ""; everything downstream spells it "".
+const normalizeFolder = (folder: string): string => {
+    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: ResolvedActorConfig[]): ResolvedActorConfig[] {
+    const seenFolders = new Set<string>();
+    const seenActorFullNames = new Set<string>();
+    const errors: string[] = [];
+
+    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: Record<string, unknown>): ResolvedActorConfig[] {
+    const { mode, ...rest } = body;
+    const strategy = selectStrategy(mode);
+
+    const resolved = strategy.parse(rest);
+    const validated = verifyConfiguration(resolved);
+    return validated;
+}

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

@@ -0,0 +1,61 @@
+import { prettifyError, type ZodType } from 'zod';
+
+import { ACTOR_NAME, USERNAME } from '@apify/consts';
+
+function stripRegexAnchor(regex: string): string {
+    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 interface ResolvedActorConfig {
+    actorFullName: string;
+    folder: string;
+    tokenEnvVar: string;
+    overrideActorContext?: string[];
+}
+
+export enum CONFIG_FILE_STRATEGY {
+    LEGACY = 'legacy',
+}
+
+export type StrategyParser = {
+    mode: CONFIG_FILE_STRATEGY;
+    parse: (body: Record<string, unknown>) => ResolvedActorConfig[];
+};
+
+export function defineStrategy<T extends Record<string, unknown>, Mode extends CONFIG_FILE_STRATEGY>(
+    // mode is transparent so it can be validated with & { mode: Mode }
+    mode: Mode,
+    schema: ZodType<T>,
+    resolve: (body: T) => ResolvedActorConfig[],
+) {
+    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: Record<string, unknown>) => {
+            const parsed = schema.safeParse(body);
+            if (parsed.success) {
+                return resolve(parsed.data);
+            }
+            throw new Error(prettifyError(parsed.error));
+        },
+    };
+}

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

@@ -0,0 +1,20 @@
+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),
+});
+
+type LegacyConfig = z.infer<typeof schema>;
+
+export const LEGACY_PARSER = defineStrategy(CONFIG_FILE_STRATEGY.LEGACY, schema, (body: LegacyConfig) => body.actors);

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

@@ -1,38 +1,8 @@
-import { z } from 'zod';
 import type { ActorConfig } from '../../types.js';
+import type { ResolvedActorConfig } from './structures/base.js';
 export declare const CONFIG_FILE_NAME = "apify-test-tools.config.json";
-declare const CONFIG_FILE_SCHEMA: z.ZodObject<{
-    actors: z.ZodArray<z.ZodObject<{
-        folder: z.ZodString;
-        actorFullName: z.ZodString;
-        tokenEnvVar: z.ZodString;
-        overrideActorContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type ActorConfigFile = z.infer<typeof CONFIG_FILE_SCHEMA>;
 /**
- * The single shape stage 4 understands: an actor entry whose paths have been normalized, with no
- * trace left of which config flavour produced it. Whatever replaces or extends
- * {@link parseConfigFile} and {@link resolveRawConfig} only has to produce this.
- */
-export interface ResolvedActorConfig {
-    actorFullName: string;
-    folder: string;
-    tokenEnvVar: string;
-    overrideActorContext?: string[];
-}
-/**
- * Stage 2 — validates the file's shape. Every problem is reported at once rather than only the
- * first one to fail.
- */
-export declare const parseConfigFile: (contents: Record<string, unknown>) => ActorConfigFile;
-/**
- * Stage 3 — normalizes the paths the user wrote and rejects entries that collide once normalized.
- * The repo root is "" from here on, however it was spelled in the file.
- */
-export declare const resolveRawConfig: (config: ActorConfigFile) => ResolvedActorConfig[];
-/**
- * Stage 4 — resolves one normalized entry against the repo, reading the actor's `.actor/actor.json`
+ * Stage 3 — resolves one normalized entry against the repo, reading the actor's `.actor/actor.json`
  * for its `dockerContextDir` and deciding which paths count as the actor's context.
  */
 export declare const loadActorConfig: (entry: ResolvedActorConfig) => ActorConfig;
@@ -40,5 +10,4 @@ export declare const readConfigFile: (selection: {
     actors: string[];
     ignore: string[];
 }) => Promise<ActorConfig[]>;
-export {};
 //# sourceMappingURL=load-config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../../../bin/utils/config/load-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,eAAO,MAAM,gBAAgB,iCAAiC,CAAC;AAwB/D,QAAA,MAAM,kBAAkB;;;;;;;iBAEtB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjE;;;;GAIG;AACH,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;AAqFD;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,eASnE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,eAAe,KAAG,mBAAmB,EAoB7E,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,mBAAmB,KAAG,WAiD5D,CAAC;AAIF,eAAO,MAAM,cAAc,GAAU,WAAW;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,KAAG,OAAO,CAAC,WAAW,EAAE,CAc7G,CAAC"}
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../../../bin/utils/config/load-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,eAAO,MAAM,gBAAgB,iCAAiC,CAAC;AAuD/D;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,mBAAmB,KAAG,WAiD5D,CAAC;AAIF,eAAO,MAAM,cAAc,GAAU,WAAW;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,KAAG,OAAO,CAAC,WAAW,EAAE,CAW7G,CAAC"}

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

@@ -1,35 +1,16 @@
 import path from 'node:path';
-import { z } from 'zod';
 import { selectActors } from '../../actor-filtering.js';
 import { isPathWithinScope } from '../../path-utils.js';
 import { safeReadJsonObjectFile } from '../json-file.js';
+import { parseConfigFile } from './parser.js';
 export const CONFIG_FILE_NAME = 'apify-test-tools.config.json';
-// Reading the config happens in four stages, each one swappable on its own:
+// Reading the config happens in three stages, each one swappable on its own:
 //
 //   1. file                -> plain object          (safeReadJsonObjectFile)
-//   2. plain object        -> ActorConfigFile       (parseConfigFile — the schema, swap point for new flavours)
-//   3. ActorConfigFile     -> ResolvedActorConfig[] (resolveRawConfig — one normalized shape for everyone)
-//   4. ResolvedActorConfig -> ActorConfig           (loadActorConfig — merges in .actor/actor.json)
-//
-// Stages 1-3 are the "what did the user write" half and stage 4 the "what does the repo look like"
-// half. A differently shaped config file only has to reach stage 3's output to work with the rest
-// of the tool.
-// #region schema (soon to be moved)
-const ACTOR_ENTRY_SCHEMA = z.object({
-    folder: z.string(),
-    // "owner/name", with neither half empty — deliberately permissive about what characters those
-    // halves may contain, the platform is the authority on that.
-    actorFullName: z.string().regex(/^[^/]+\/[^/]+$/),
-    tokenEnvVar: z.string(),
-    overrideActorContext: z.array(z.string()).optional(),
-});
-const CONFIG_FILE_SCHEMA = z.object({
-    actors: z.array(ACTOR_ENTRY_SCHEMA),
-});
-// #endregion
+//   2. plain object        -> ResolvedActorConfig[] (parseConfigFile — picks a strategy, validates
+//                                                    and normalizes; see ./parser.ts)
+//   3. ResolvedActorConfig -> ActorConfig           (loadActorConfig — merges in .actor/actor.json)
 // #region utils
-// Strips a trailing slash so config-declared paths ("actors/shopify/" vs "actors/shopify") compare equal.
-const stripTrailingSlash = (pathValue) => pathValue.replace(/\/+$/, '');
 const findOverlappingContextPaths = (contextPaths) => {
     for (let i = 0; i < contextPaths.length; i++) {
         for (let j = i + 1; j < contextPaths.length; j++) {
@@ -41,30 +22,9 @@ const findOverlappingContextPaths = (contextPaths) => {
     }
     return undefined;
 };
-// Restates a schema violation in the wording this config file has always used, so error output
-// stays recognizable now that the hand-rolled checks are gone.
-const describeIssue = (issue, rawActors) => {
-    const [, index, field] = issue.path;
-    if (typeof index !== 'number') {
-        return `Config file "${CONFIG_FILE_NAME}" must have an "actors" array at the top level.`;
-    }
-    const folder = rawActors[index]?.folder;
-    switch (field) {
-        case 'folder':
-            return (`Invalid "folder" for actor entry at index ${index} in "${CONFIG_FILE_NAME}". ` +
-                `Must be a string (use "." for a single-actor repo).`);
-        case 'actorFullName':
-            return (`Invalid "actorFullName" for folder "${folder}" in "${CONFIG_FILE_NAME}". ` +
-                `Must be in "owner/name" format (e.g. "apify/web-scraper").`);
-        case 'tokenEnvVar':
-            return `Invalid "tokenEnvVar" for folder "${folder}" in "${CONFIG_FILE_NAME}". Must be a string.`;
-        case 'overrideActorContext':
-            return (`Invalid "overrideActorContext" for folder "${folder}" in "${CONFIG_FILE_NAME}". ` +
-                `Must be an array of strings.`);
-        default:
-            return `Invalid actor entry at index ${index} in "${CONFIG_FILE_NAME}": ${issue.message}`;
-    }
-};
+// The repo root is spelled "" internally but "." in a config file, so report it the way a reader
+// would have written it.
+const displayFolder = (folder) => folder || '.';
 // #endregion
 // #region stages
 /** Stage 1 — the config file as a plain object, or a failure phrased for whoever wrote it. */
@@ -86,43 +46,7 @@ const readConfigFileContents = async () => {
     }
 };
 /**
- * Stage 2 — validates the file's shape. Every problem is reported at once rather than only the
- * first one to fail.
- */
-export const parseConfigFile = (contents) => {
-    const parsed = CONFIG_FILE_SCHEMA.safeParse(contents);
-    if (parsed.success) {
-        return parsed.data;
-    }
-    const rawActors = Array.isArray(contents.actors) ? contents.actors : [];
-    const messages = new Set(parsed.error.issues.map((issue) => describeIssue(issue, rawActors)));
-    throw new Error([...messages].join('\n'));
-};
-/**
- * Stage 3 — normalizes the paths the user wrote and rejects entries that collide once normalized.
- * The repo root is "" from here on, however it was spelled in the file.
- */
-export const resolveRawConfig = (config) => {
-    const seenFolders = new Set();
-    return config.actors.map((entry) => {
-        const folder = entry.folder === '.' ? '' : stripTrailingSlash(entry.folder);
-        if (seenFolders.has(folder)) {
-            throw new Error(`Duplicate folder "${entry.folder}" in "${CONFIG_FILE_NAME}". Each actor must have a unique folder.`);
-        }
-        seenFolders.add(folder);
-        return {
-            actorFullName: entry.actorFullName,
-            folder,
-            tokenEnvVar: entry.tokenEnvVar,
-            overrideActorContext: entry.overrideActorContext?.map(stripTrailingSlash),
-        };
-    });
-};
-// The repo root is spelled "" internally but "." in a config file, so report it the way a reader
-// would have written it.
-const displayFolder = (folder) => folder || '.';
-/**
- * Stage 4 — resolves one normalized entry against the repo, reading the actor's `.actor/actor.json`
+ * Stage 3 — resolves one normalized entry against the repo, reading the actor's `.actor/actor.json`
  * for its `dockerContextDir` and deciding which paths count as the actor's context.
  */
 export const loadActorConfig = (entry) => {
@@ -163,14 +87,12 @@ export const loadActorConfig = (entry) => {
 };
 // #endregion
 export const readConfigFile = async (selection) => {
-    const rawConfig = await readConfigFileContents();
-    // replace this when enabling different file structures
-    // some kind of strategy pattern seems appropriate here
-    const resolvedConfigs = resolveRawConfig(parseConfigFile(rawConfig));
+    const rawFileContents = await readConfigFileContents();
+    const parsedConfigs = parseConfigFile(rawFileContents);
     const actorConfigs = [];
-    for (const resolved of resolvedConfigs) {
+    for (const parsed of parsedConfigs) {
         // Sequential on purpose: the first actor with a problem should be the one reported.
-        actorConfigs.push(loadActorConfig(resolved));
+        actorConfigs.push(loadActorConfig(parsed));
     }
     return selectActors(selection, actorConfigs);
 };

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

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

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

@@ -0,0 +1,19 @@
+import { type ResolvedActorConfig, type StrategyParser } from './structures/base.js';
+declare function selectStrategy(mode: unknown): StrategyParser;
+/**
+ * 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.
+ */
+declare function verifyConfiguration(body: ResolvedActorConfig[]): ResolvedActorConfig[];
+export declare const _privates: {
+    selectStrategy: typeof selectStrategy;
+    verifyConfiguration: typeof verifyConfiguration;
+};
+export declare function parseConfigFile(body: Record<string, unknown>): ResolvedActorConfig[];
+export {};
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../bin/utils/config/parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAY3G,iBAAS,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAOrD;AAWD;;;;;;;;GAQG;AACH,iBAAS,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CA+B/E;AAGD,eAAO,MAAM,SAAS;;;CAGrB,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,EAAE,CAOpF"}