@dev-blinq/cucumber-js 1.0.0

package/lib/api/load_sources.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSources = void 0;
+const paths_1 = require("./paths");
+const messages_1 = require("@cucumber/messages");
+const environment_1 = require("./environment");
+const gherkin_1 = require("./gherkin");
+const console_logger_1 = require("./console_logger");
+/**
+ * Load and parse features, produce a filtered and ordered test plan and/or parse errors.
+ *
+ * @public
+ * @param coordinates - Coordinates required to find features
+ * @param environment - Project environment.
+ */
+async function loadSources(coordinates, environment = {}) {
+    const { cwd, stderr, debug } = (0, environment_1.mergeEnvironment)(environment);
+    const logger = new console_logger_1.ConsoleLogger(stderr, debug);
+    const newId = messages_1.IdGenerator.uuid();
+    const { unexpandedFeaturePaths, featurePaths } = await (0, paths_1.resolvePaths)(logger, cwd, coordinates);
+    if (featurePaths.length === 0) {
+        return {
+            plan: [],
+            errors: [],
+        };
+    }
+    const { filteredPickles, parseErrors } = await (0, gherkin_1.getFilteredPicklesAndErrors)({
+        newId,
+        cwd,
+        logger,
+        unexpandedFeaturePaths,
+        featurePaths,
+        coordinates,
+    });
+    const plan = filteredPickles.map(({ location, pickle }) => ({
+        name: pickle.name,
+        uri: pickle.uri,
+        location,
+    }));
+    const errors = parseErrors.map(({ source, message }) => {
+        return {
+            uri: source.uri,
+            location: source.location,
+            message,
+        };
+    });
+    return {
+        plan,
+        errors,
+    };
+}
+exports.loadSources = loadSources;
+//# sourceMappingURL=load_sources.js.map

package/lib/api/load_sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_sources.js","sourceRoot":"","sources":["../../src/api/load_sources.ts"],"names":[],"mappings":";;;AAOA,mCAAsC;AACtC,iDAAgD;AAChD,+CAAgD;AAChD,uCAAuD;AACvD,qDAAgD;AAGhD;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAC/B,WAAgC,EAChC,cAA+B,EAAE;IAEjC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,8BAAgB,EAAC,WAAW,CAAC,CAAA;IAC5D,MAAM,MAAM,GAAY,IAAI,8BAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACxD,MAAM,KAAK,GAAG,sBAAW,CAAC,IAAI,EAAE,CAAA;IAChC,MAAM,EAAE,sBAAsB,EAAE,YAAY,EAAE,GAAG,MAAM,IAAA,oBAAY,EACjE,MAAM,EACN,GAAG,EACH,WAAW,CACZ,CAAA;IACD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE;QAC7B,OAAO;YACL,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,EAAE;SACX,CAAA;KACF;IACD,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,MAAM,IAAA,qCAA2B,EAAC;QACzE,KAAK;QACL,GAAG;QACH,MAAM;QACN,sBAAsB;QACtB,YAAY;QACZ,WAAW;KACZ,CAAC,CAAA;IACF,MAAM,IAAI,GAAqB,eAAe,CAAC,GAAG,CAChD,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,QAAQ;KACT,CAAC,CACH,CAAA;IACD,MAAM,MAAM,GAAoB,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACtE,OAAO;YACL,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO;SACR,CAAA;IACH,CAAC,CAAC,CAAA;IACF,OAAO;QACL,IAAI;QACJ,MAAM;KACP,CAAA;AACH,CAAC;AA5CD,kCA4CC","sourcesContent":["import {\n  ILoadSourcesResult,\n  IPlannedPickle,\n  IRunEnvironment,\n  ISourcesCoordinates,\n  ISourcesError,\n} from './types'\nimport { resolvePaths } from './paths'\nimport { IdGenerator } from '@cucumber/messages'\nimport { mergeEnvironment } from './environment'\nimport { getFilteredPicklesAndErrors } from './gherkin'\nimport { ConsoleLogger } from './console_logger'\nimport { ILogger } from '../logger'\n\n/**\n * Load and parse features, produce a filtered and ordered test plan and/or parse errors.\n *\n * @public\n * @param coordinates - Coordinates required to find features\n * @param environment - Project environment.\n */\nexport async function loadSources(\n  coordinates: ISourcesCoordinates,\n  environment: IRunEnvironment = {}\n): Promise<ILoadSourcesResult> {\n  const { cwd, stderr, debug } = mergeEnvironment(environment)\n  const logger: ILogger = new ConsoleLogger(stderr, debug)\n  const newId = IdGenerator.uuid()\n  const { unexpandedFeaturePaths, featurePaths } = await resolvePaths(\n    logger,\n    cwd,\n    coordinates\n  )\n  if (featurePaths.length === 0) {\n    return {\n      plan: [],\n      errors: [],\n    }\n  }\n  const { filteredPickles, parseErrors } = await getFilteredPicklesAndErrors({\n    newId,\n    cwd,\n    logger,\n    unexpandedFeaturePaths,\n    featurePaths,\n    coordinates,\n  })\n  const plan: IPlannedPickle[] = filteredPickles.map(\n    ({ location, pickle }) => ({\n      name: pickle.name,\n      uri: pickle.uri,\n      location,\n    })\n  )\n  const errors: ISourcesError[] = parseErrors.map(({ source, message }) => {\n    return {\n      uri: source.uri,\n      location: source.location,\n      message,\n    }\n  })\n  return {\n    plan,\n    errors,\n  }\n}\n"]}

package/lib/api/load_support.d.ts

@@ -0,0 +1,10 @@
+import { ILoadSupportOptions, IRunEnvironment } from './types';
+import { ISupportCodeLibrary } from '../support_code_library_builder/types';
+/**
+ * Load support code for use in test runs.
+ *
+ * @public
+ * @param options - Subset of `IRunnableConfiguration` required to find the support code.
+ * @param environment - Project environment.
+ */
+export declare function loadSupport(options: ILoadSupportOptions, environment?: IRunEnvironment): Promise<ISupportCodeLibrary>;

package/lib/api/load_support.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSupport = void 0;
+const messages_1 = require("@cucumber/messages");
+const paths_1 = require("./paths");
+const support_1 = require("./support");
+const environment_1 = require("./environment");
+const console_logger_1 = require("./console_logger");
+/**
+ * Load support code for use in test runs.
+ *
+ * @public
+ * @param options - Subset of `IRunnableConfiguration` required to find the support code.
+ * @param environment - Project environment.
+ */
+async function loadSupport(options, environment = {}) {
+    const { cwd, stderr, debug } = (0, environment_1.mergeEnvironment)(environment);
+    const logger = new console_logger_1.ConsoleLogger(stderr, debug);
+    const newId = messages_1.IdGenerator.uuid();
+    const { requirePaths, importPaths } = await (0, paths_1.resolvePaths)(logger, cwd, options.sources, options.support);
+    return await (0, support_1.getSupportCodeLibrary)({
+        cwd,
+        newId,
+        requireModules: options.support.requireModules,
+        requirePaths,
+        importPaths,
+    });
+}
+exports.loadSupport = loadSupport;
+//# sourceMappingURL=load_support.js.map

package/lib/api/load_support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_support.js","sourceRoot":"","sources":["../../src/api/load_support.ts"],"names":[],"mappings":";;;AAAA,iDAAgD;AAEhD,mCAAsC;AACtC,uCAAiD;AACjD,+CAAgD;AAGhD,qDAAgD;AAEhD;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAC/B,OAA4B,EAC5B,cAA+B,EAAE;IAEjC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,8BAAgB,EAAC,WAAW,CAAC,CAAA;IAC5D,MAAM,MAAM,GAAY,IAAI,8BAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACxD,MAAM,KAAK,GAAG,sBAAW,CAAC,IAAI,EAAE,CAAA;IAChC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,IAAA,oBAAY,EACtD,MAAM,EACN,GAAG,EACH,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,OAAO,CAChB,CAAA;IACD,OAAO,MAAM,IAAA,+BAAqB,EAAC;QACjC,GAAG;QACH,KAAK;QACL,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,cAAc;QAC9C,YAAY;QACZ,WAAW;KACZ,CAAC,CAAA;AACJ,CAAC;AApBD,kCAoBC","sourcesContent":["import { IdGenerator } from '@cucumber/messages'\nimport { ILoadSupportOptions, IRunEnvironment } from './types'\nimport { resolvePaths } from './paths'\nimport { getSupportCodeLibrary } from './support'\nimport { mergeEnvironment } from './environment'\nimport { ISupportCodeLibrary } from '../support_code_library_builder/types'\nimport { ILogger } from '../logger'\nimport { ConsoleLogger } from './console_logger'\n\n/**\n * Load support code for use in test runs.\n *\n * @public\n * @param options - Subset of `IRunnableConfiguration` required to find the support code.\n * @param environment - Project environment.\n */\nexport async function loadSupport(\n  options: ILoadSupportOptions,\n  environment: IRunEnvironment = {}\n): Promise<ISupportCodeLibrary> {\n  const { cwd, stderr, debug } = mergeEnvironment(environment)\n  const logger: ILogger = new ConsoleLogger(stderr, debug)\n  const newId = IdGenerator.uuid()\n  const { requirePaths, importPaths } = await resolvePaths(\n    logger,\n    cwd,\n    options.sources,\n    options.support\n  )\n  return await getSupportCodeLibrary({\n    cwd,\n    newId,\n    requireModules: options.support.requireModules,\n    requirePaths,\n    importPaths,\n  })\n}\n"]}

package/lib/api/paths.d.ts

@@ -0,0 +1,8 @@
+import { ISourcesCoordinates, ISupportCodeCoordinates } from './types';
+import { ILogger } from '../logger';
+export declare function resolvePaths(logger: ILogger, cwd: string, sources: Pick<ISourcesCoordinates, 'paths'>, support?: ISupportCodeCoordinates): Promise<{
+    unexpandedFeaturePaths: string[];
+    featurePaths: string[];
+    requirePaths: string[];
+    importPaths: string[];
+}>;

package/lib/api/paths.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePaths = void 0;
+const util_1 = require("util");
+const glob_1 = __importDefault(require("glob"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("mz/fs"));
+async function resolvePaths(logger, cwd, sources, support = {
+    requireModules: [],
+    requirePaths: [],
+    importPaths: [],
+}) {
+    const unexpandedFeaturePaths = await getUnexpandedFeaturePaths(cwd, sources.paths);
+    const featurePaths = await expandFeaturePaths(cwd, unexpandedFeaturePaths);
+    logger.debug('Found feature files based on configuration:', featurePaths);
+    const { requirePaths, importPaths } = await deriveSupportPaths(cwd, featurePaths, support.requirePaths, support.importPaths);
+    logger.debug('Found support files to load via `require` based on configuration:', requirePaths);
+    logger.debug('Found support files to load via `import` based on configuration:', importPaths);
+    return {
+        unexpandedFeaturePaths,
+        featurePaths,
+        requirePaths,
+        importPaths,
+    };
+}
+exports.resolvePaths = resolvePaths;
+async function expandPaths(cwd, unexpandedPaths, defaultExtension) {
+    const expandedPaths = await Promise.all(unexpandedPaths.map(async (unexpandedPath) => {
+        const matches = await (0, util_1.promisify)(glob_1.default)(unexpandedPath, {
+            absolute: true,
+            cwd,
+        });
+        const expanded = await Promise.all(matches.map(async (match) => {
+            if (path_1.default.extname(match) === '') {
+                return await (0, util_1.promisify)(glob_1.default)(`${match}/**/*${defaultExtension}`);
+            }
+            return [match];
+        }));
+        return expanded.flat();
+    }));
+    const normalized = expandedPaths.flat().map((x) => path_1.default.normalize(x));
+    return [...new Set(normalized)];
+}
+async function getUnexpandedFeaturePaths(cwd, args) {
+    if (args.length > 0) {
+        const nestedFeaturePaths = await Promise.all(args.map(async (arg) => {
+            const filename = path_1.default.basename(arg);
+            if (filename[0] === '@') {
+                const filePath = path_1.default.join(cwd, arg);
+                const content = await fs_1.default.readFile(filePath, 'utf8');
+                return content.split('\n').map((x) => x.trim());
+            }
+            return [arg];
+        }));
+        const featurePaths = nestedFeaturePaths.flat();
+        if (featurePaths.length > 0) {
+            return featurePaths.filter((x) => x !== '');
+        }
+    }
+    return ['features/**/*.{feature,feature.md}'];
+}
+function getFeatureDirectoryPaths(cwd, featurePaths) {
+    const featureDirs = featurePaths.map((featurePath) => {
+        let featureDir = path_1.default.dirname(featurePath);
+        let childDir;
+        let parentDir = featureDir;
+        while (childDir !== parentDir) {
+            childDir = parentDir;
+            parentDir = path_1.default.dirname(childDir);
+            if (path_1.default.basename(parentDir) === 'features') {
+                featureDir = parentDir;
+                break;
+            }
+        }
+        return path_1.default.relative(cwd, featureDir);
+    });
+    return [...new Set(featureDirs)];
+}
+async function expandFeaturePaths(cwd, featurePaths) {
+    featurePaths = featurePaths.map((p) => p.replace(/(:\d+)*$/g, '')); // Strip line numbers
+    return await expandPaths(cwd, featurePaths, '.feature');
+}
+async function deriveSupportPaths(cwd, featurePaths, unexpandedRequirePaths, unexpandedImportPaths) {
+    if (unexpandedRequirePaths.length === 0 &&
+        unexpandedImportPaths.length === 0) {
+        const defaultPaths = getFeatureDirectoryPaths(cwd, featurePaths);
+        const requirePaths = await expandPaths(cwd, defaultPaths, '.js');
+        const importPaths = await expandPaths(cwd, defaultPaths, '.mjs');
+        return { requirePaths, importPaths };
+    }
+    const requirePaths = unexpandedRequirePaths.length > 0
+        ? await expandPaths(cwd, unexpandedRequirePaths, '.js')
+        : [];
+    const importPaths = unexpandedImportPaths.length > 0
+        ? await expandPaths(cwd, unexpandedImportPaths, '.@(js|cjs|mjs)')
+        : [];
+    return { requirePaths, importPaths };
+}
+//# sourceMappingURL=paths.js.map

package/lib/api/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/api/paths.ts"],"names":[],"mappings":"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","sourcesContent":["import { promisify } from 'util'\nimport glob from 'glob'\nimport path from 'path'\nimport fs from 'mz/fs'\nimport { ISourcesCoordinates, ISupportCodeCoordinates } from './types'\nimport { ILogger } from '../logger'\n\nexport async function resolvePaths(\n  logger: ILogger,\n  cwd: string,\n  sources: Pick<ISourcesCoordinates, 'paths'>,\n  support: ISupportCodeCoordinates = {\n    requireModules: [],\n    requirePaths: [],\n    importPaths: [],\n  }\n): Promise<{\n  unexpandedFeaturePaths: string[]\n  featurePaths: string[]\n  requirePaths: string[]\n  importPaths: string[]\n}> {\n  const unexpandedFeaturePaths = await getUnexpandedFeaturePaths(\n    cwd,\n    sources.paths\n  )\n  const featurePaths: string[] = await expandFeaturePaths(\n    cwd,\n    unexpandedFeaturePaths\n  )\n  logger.debug('Found feature files based on configuration:', featurePaths)\n  const { requirePaths, importPaths } = await deriveSupportPaths(\n    cwd,\n    featurePaths,\n    support.requirePaths,\n    support.importPaths\n  )\n  logger.debug(\n    'Found support files to load via `require` based on configuration:',\n    requirePaths\n  )\n  logger.debug(\n    'Found support files to load via `import` based on configuration:',\n    importPaths\n  )\n  return {\n    unexpandedFeaturePaths,\n    featurePaths,\n    requirePaths,\n    importPaths,\n  }\n}\n\nasync function expandPaths(\n  cwd: string,\n  unexpandedPaths: string[],\n  defaultExtension: string\n): Promise<string[]> {\n  const expandedPaths = await Promise.all(\n    unexpandedPaths.map(async (unexpandedPath) => {\n      const matches = await promisify(glob)(unexpandedPath, {\n        absolute: true,\n        cwd,\n      })\n      const expanded = await Promise.all(\n        matches.map(async (match) => {\n          if (path.extname(match) === '') {\n            return await promisify(glob)(`${match}/**/*${defaultExtension}`)\n          }\n          return [match]\n        })\n      )\n      return expanded.flat()\n    })\n  )\n  const normalized = expandedPaths.flat().map((x) => path.normalize(x))\n  return [...new Set(normalized)]\n}\n\nasync function getUnexpandedFeaturePaths(\n  cwd: string,\n  args: string[]\n): Promise<string[]> {\n  if (args.length > 0) {\n    const nestedFeaturePaths = await Promise.all(\n      args.map(async (arg) => {\n        const filename = path.basename(arg)\n        if (filename[0] === '@') {\n          const filePath = path.join(cwd, arg)\n          const content = await fs.readFile(filePath, 'utf8')\n          return content.split('\\n').map((x) => x.trim())\n        }\n        return [arg]\n      })\n    )\n    const featurePaths = nestedFeaturePaths.flat()\n    if (featurePaths.length > 0) {\n      return featurePaths.filter((x) => x !== '')\n    }\n  }\n  return ['features/**/*.{feature,feature.md}']\n}\n\nfunction getFeatureDirectoryPaths(\n  cwd: string,\n  featurePaths: string[]\n): string[] {\n  const featureDirs = featurePaths.map((featurePath) => {\n    let featureDir = path.dirname(featurePath)\n    let childDir: string\n    let parentDir = featureDir\n    while (childDir !== parentDir) {\n      childDir = parentDir\n      parentDir = path.dirname(childDir)\n      if (path.basename(parentDir) === 'features') {\n        featureDir = parentDir\n        break\n      }\n    }\n    return path.relative(cwd, featureDir)\n  })\n  return [...new Set(featureDirs)]\n}\n\nasync function expandFeaturePaths(\n  cwd: string,\n  featurePaths: string[]\n): Promise<string[]> {\n  featurePaths = featurePaths.map((p) => p.replace(/(:\\d+)*$/g, '')) // Strip line numbers\n  return await expandPaths(cwd, featurePaths, '.feature')\n}\n\nasync function deriveSupportPaths(\n  cwd: string,\n  featurePaths: string[],\n  unexpandedRequirePaths: string[],\n  unexpandedImportPaths: string[]\n): Promise<{\n  requirePaths: string[]\n  importPaths: string[]\n}> {\n  if (\n    unexpandedRequirePaths.length === 0 &&\n    unexpandedImportPaths.length === 0\n  ) {\n    const defaultPaths = getFeatureDirectoryPaths(cwd, featurePaths)\n    const requirePaths = await expandPaths(cwd, defaultPaths, '.js')\n    const importPaths = await expandPaths(cwd, defaultPaths, '.mjs')\n    return { requirePaths, importPaths }\n  }\n  const requirePaths =\n    unexpandedRequirePaths.length > 0\n      ? await expandPaths(cwd, unexpandedRequirePaths, '.js')\n      : []\n  const importPaths =\n    unexpandedImportPaths.length > 0\n      ? await expandPaths(cwd, unexpandedImportPaths, '.@(js|cjs|mjs)')\n      : []\n  return { requirePaths, importPaths }\n}\n"]}

package/lib/api/plugins.d.ts

@@ -0,0 +1,4 @@
+import { PluginManager } from '../plugin';
+import { IRunEnvironment, IRunOptions } from './types';
+import { ILogger } from '../logger';
+export declare function initializePlugins(logger: ILogger, configuration: IRunOptions, environment: IRunEnvironment): Promise<PluginManager>;

package/lib/api/plugins.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializePlugins = void 0;
+const plugin_1 = require("../plugin");
+const publish_1 = __importDefault(require("../publish"));
+const INTERNAL_PLUGINS = {
+    publish: publish_1.default,
+};
+async function initializePlugins(logger, configuration, environment) {
+    // eventually we'll load plugin packages here
+    const pluginManager = new plugin_1.PluginManager(Object.values(INTERNAL_PLUGINS));
+    await pluginManager.init(logger, configuration, environment);
+    return pluginManager;
+}
+exports.initializePlugins = initializePlugins;
+//# sourceMappingURL=plugins.js.map

package/lib/api/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/api/plugins.ts"],"names":[],"mappings":";;;;;;AAAA,sCAAiD;AACjD,yDAAsC;AAItC,MAAM,gBAAgB,GAA2B;IAC/C,OAAO,EAAE,iBAAa;CACvB,CAAA;AAEM,KAAK,UAAU,iBAAiB,CACrC,MAAe,EACf,aAA0B,EAC1B,WAA4B;IAE5B,6CAA6C;IAC7C,MAAM,aAAa,GAAG,IAAI,sBAAa,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAA;IACxE,MAAM,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,CAAA;IAC5D,OAAO,aAAa,CAAA;AACtB,CAAC;AATD,8CASC","sourcesContent":["import { Plugin, PluginManager } from '../plugin'\nimport publishPlugin from '../publish'\nimport { IRunEnvironment, IRunOptions } from './types'\nimport { ILogger } from '../logger'\n\nconst INTERNAL_PLUGINS: Record<string, Plugin> = {\n  publish: publishPlugin,\n}\n\nexport async function initializePlugins(\n  logger: ILogger,\n  configuration: IRunOptions,\n  environment: IRunEnvironment\n): Promise<PluginManager> {\n  // eventually we'll load plugin packages here\n  const pluginManager = new PluginManager(Object.values(INTERNAL_PLUGINS))\n  await pluginManager.init(logger, configuration, environment)\n  return pluginManager\n}\n"]}

package/lib/api/run_cucumber.d.ts

@@ -0,0 +1,11 @@
+import { Envelope } from '@cucumber/messages';
+import { IRunOptions, IRunEnvironment, IRunResult } from './types';
+/**
+ * Execute a Cucumber test run.
+ *
+ * @public
+ * @param configuration - Configuration loaded from `loadConfiguration`.
+ * @param environment - Project environment.
+ * @param onMessage - Callback fired each time Cucumber emits a message.
+ */
+export declare function runCucumber(configuration: IRunOptions, environment?: IRunEnvironment, onMessage?: (message: Envelope) => void): Promise<IRunResult>;

package/lib/api/run_cucumber.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCucumber = void 0;
+const messages_1 = require("@cucumber/messages");
+const events_1 = require("events");
+const helpers_1 = require("../formatter/helpers");
+const helpers_2 = require("../cli/helpers");
+const paths_1 = require("./paths");
+const runtime_1 = require("./runtime");
+const formatters_1 = require("./formatters");
+const support_1 = require("./support");
+const environment_1 = require("./environment");
+const gherkin_1 = require("./gherkin");
+const plugins_1 = require("./plugins");
+const console_logger_1 = require("./console_logger");
+/**
+ * Execute a Cucumber test run.
+ *
+ * @public
+ * @param configuration - Configuration loaded from `loadConfiguration`.
+ * @param environment - Project environment.
+ * @param onMessage - Callback fired each time Cucumber emits a message.
+ */
+async function runCucumber(configuration, environment = {}, onMessage) {
+    const { cwd, stdout, stderr, env, debug } = (0, environment_1.mergeEnvironment)(environment);
+    const logger = new console_logger_1.ConsoleLogger(stderr, debug);
+    const newId = messages_1.IdGenerator.uuid();
+    const supportCoordinates = 'World' in configuration.support
+        ? configuration.support.originalCoordinates
+        : configuration.support;
+    const { unexpandedFeaturePaths, featurePaths, requirePaths, importPaths } = await (0, paths_1.resolvePaths)(logger, cwd, configuration.sources, supportCoordinates);
+    const supportCodeLibrary = 'World' in configuration.support
+        ? configuration.support
+        : await (0, support_1.getSupportCodeLibrary)({
+            cwd,
+            newId,
+            requirePaths,
+            importPaths,
+            requireModules: supportCoordinates.requireModules,
+        });
+    const plugins = await (0, plugins_1.initializePlugins)(logger, configuration, environment);
+    const eventBroadcaster = new events_1.EventEmitter();
+    if (onMessage) {
+        eventBroadcaster.on('envelope', onMessage);
+    }
+    eventBroadcaster.on('envelope', (value) => plugins.emit('message', value));
+    const eventDataCollector = new helpers_1.EventDataCollector(eventBroadcaster);
+    let formatterStreamError = false;
+    const cleanupFormatters = await (0, formatters_1.initializeFormatters)({
+        env,
+        cwd,
+        stdout,
+        stderr,
+        logger,
+        onStreamError: () => (formatterStreamError = true),
+        eventBroadcaster,
+        eventDataCollector,
+        configuration: configuration.formats,
+        supportCodeLibrary,
+    });
+    await (0, helpers_2.emitMetaMessage)(eventBroadcaster, env);
+    let pickleIds = [];
+    let parseErrors = [];
+    if (featurePaths.length > 0) {
+        const gherkinResult = await (0, gherkin_1.getFilteredPicklesAndErrors)({
+            newId,
+            cwd,
+            logger,
+            unexpandedFeaturePaths,
+            featurePaths,
+            coordinates: configuration.sources,
+            onEnvelope: (envelope) => eventBroadcaster.emit('envelope', envelope),
+        });
+        pickleIds = gherkinResult.filteredPickles.map(({ pickle }) => pickle.id);
+        parseErrors = gherkinResult.parseErrors;
+    }
+    if (parseErrors.length) {
+        parseErrors.forEach((parseError) => {
+            logger.error(`Parse error in "${parseError.source.uri}" ${parseError.message}`);
+        });
+        await cleanupFormatters();
+        await plugins.cleanup();
+        return {
+            success: false,
+            support: supportCodeLibrary,
+        };
+    }
+    (0, helpers_2.emitSupportCodeMessages)({
+        eventBroadcaster,
+        supportCodeLibrary,
+        newId,
+    });
+    const runtime = (0, runtime_1.makeRuntime)({
+        cwd,
+        logger,
+        eventBroadcaster,
+        eventDataCollector,
+        pickleIds,
+        newId,
+        supportCodeLibrary,
+        requireModules: supportCoordinates.requireModules,
+        requirePaths,
+        importPaths,
+        options: configuration.runtime,
+    });
+    const success = await runtime.start();
+    await cleanupFormatters();
+    await plugins.cleanup();
+    return {
+        success: success && !formatterStreamError,
+        support: supportCodeLibrary,
+    };
+}
+exports.runCucumber = runCucumber;
+//# sourceMappingURL=run_cucumber.js.map

package/lib/api/run_cucumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_cucumber.js","sourceRoot":"","sources":["../../src/api/run_cucumber.ts"],"names":[],"mappings":"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","sourcesContent":["import { Envelope, IdGenerator, ParseError } from '@cucumber/messages'\nimport { EventEmitter } from 'events'\nimport { EventDataCollector } from '../formatter/helpers'\nimport { emitMetaMessage, emitSupportCodeMessages } from '../cli/helpers'\nimport { IRunOptions, IRunEnvironment, IRunResult } from './types'\nimport { resolvePaths } from './paths'\nimport { makeRuntime } from './runtime'\nimport { initializeFormatters } from './formatters'\nimport { getSupportCodeLibrary } from './support'\nimport { mergeEnvironment } from './environment'\nimport { getFilteredPicklesAndErrors } from './gherkin'\nimport { initializePlugins } from './plugins'\nimport { ConsoleLogger } from './console_logger'\nimport { ILogger } from '../logger'\n\n/**\n * Execute a Cucumber test run.\n *\n * @public\n * @param configuration - Configuration loaded from `loadConfiguration`.\n * @param environment - Project environment.\n * @param onMessage - Callback fired each time Cucumber emits a message.\n */\nexport async function runCucumber(\n  configuration: IRunOptions,\n  environment: IRunEnvironment = {},\n  onMessage?: (message: Envelope) => void\n): Promise<IRunResult> {\n  const { cwd, stdout, stderr, env, debug } = mergeEnvironment(environment)\n  const logger: ILogger = new ConsoleLogger(stderr, debug)\n\n  const newId = IdGenerator.uuid()\n\n  const supportCoordinates =\n    'World' in configuration.support\n      ? configuration.support.originalCoordinates\n      : configuration.support\n\n  const { unexpandedFeaturePaths, featurePaths, requirePaths, importPaths } =\n    await resolvePaths(logger, cwd, configuration.sources, supportCoordinates)\n\n  const supportCodeLibrary =\n    'World' in configuration.support\n      ? configuration.support\n      : await getSupportCodeLibrary({\n          cwd,\n          newId,\n          requirePaths,\n          importPaths,\n          requireModules: supportCoordinates.requireModules,\n        })\n\n  const plugins = await initializePlugins(logger, configuration, environment)\n\n  const eventBroadcaster = new EventEmitter()\n  if (onMessage) {\n    eventBroadcaster.on('envelope', onMessage)\n  }\n  eventBroadcaster.on('envelope', (value) => plugins.emit('message', value))\n  const eventDataCollector = new EventDataCollector(eventBroadcaster)\n\n  let formatterStreamError = false\n  const cleanupFormatters = await initializeFormatters({\n    env,\n    cwd,\n    stdout,\n    stderr,\n    logger,\n    onStreamError: () => (formatterStreamError = true),\n    eventBroadcaster,\n    eventDataCollector,\n    configuration: configuration.formats,\n    supportCodeLibrary,\n  })\n  await emitMetaMessage(eventBroadcaster, env)\n\n  let pickleIds: string[] = []\n  let parseErrors: ParseError[] = []\n  if (featurePaths.length > 0) {\n    const gherkinResult = await getFilteredPicklesAndErrors({\n      newId,\n      cwd,\n      logger,\n      unexpandedFeaturePaths,\n      featurePaths,\n      coordinates: configuration.sources,\n      onEnvelope: (envelope) => eventBroadcaster.emit('envelope', envelope),\n    })\n    pickleIds = gherkinResult.filteredPickles.map(({ pickle }) => pickle.id)\n    parseErrors = gherkinResult.parseErrors\n  }\n  if (parseErrors.length) {\n    parseErrors.forEach((parseError) => {\n      logger.error(\n        `Parse error in \"${parseError.source.uri}\" ${parseError.message}`\n      )\n    })\n    await cleanupFormatters()\n    await plugins.cleanup()\n    return {\n      success: false,\n      support: supportCodeLibrary,\n    }\n  }\n\n  emitSupportCodeMessages({\n    eventBroadcaster,\n    supportCodeLibrary,\n    newId,\n  })\n\n  const runtime = makeRuntime({\n    cwd,\n    logger,\n    eventBroadcaster,\n    eventDataCollector,\n    pickleIds,\n    newId,\n    supportCodeLibrary,\n    requireModules: supportCoordinates.requireModules,\n    requirePaths,\n    importPaths,\n    options: configuration.runtime,\n  })\n  const success = await runtime.start()\n  await cleanupFormatters()\n  await plugins.cleanup()\n\n  return {\n    success: success && !formatterStreamError,\n    support: supportCodeLibrary,\n  }\n}\n"]}

package/lib/api/runtime.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="node" />
+import { IRuntime } from '../runtime';
+import { EventEmitter } from 'events';
+import { EventDataCollector } from '../formatter/helpers';
+import { IdGenerator } from '@cucumber/messages';
+import { ISupportCodeLibrary } from '../support_code_library_builder/types';
+import { IRunOptionsRuntime } from './types';
+import { ILogger } from '../logger';
+export declare function makeRuntime({ cwd, logger, eventBroadcaster, eventDataCollector, pickleIds, newId, supportCodeLibrary, requireModules, requirePaths, importPaths, options: { parallel, ...options }, }: {
+    cwd: string;
+    logger: ILogger;
+    eventBroadcaster: EventEmitter;
+    eventDataCollector: EventDataCollector;
+    newId: IdGenerator.NewId;
+    pickleIds: string[];
+    supportCodeLibrary: ISupportCodeLibrary;
+    requireModules: string[];
+    requirePaths: string[];
+    importPaths: string[];
+    options: IRunOptionsRuntime;
+}): IRuntime;

package/lib/api/runtime.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeRuntime = void 0;
+const runtime_1 = __importDefault(require("../runtime"));
+const coordinator_1 = __importDefault(require("../runtime/parallel/coordinator"));
+function makeRuntime({ cwd, logger, eventBroadcaster, eventDataCollector, pickleIds, newId, supportCodeLibrary, requireModules, requirePaths, importPaths, options: { parallel, ...options }, }) {
+    if (parallel > 0) {
+        return new coordinator_1.default({
+            cwd,
+            logger,
+            eventBroadcaster,
+            eventDataCollector,
+            pickleIds,
+            options,
+            newId,
+            supportCodeLibrary,
+            requireModules,
+            requirePaths,
+            importPaths,
+            numberOfWorkers: parallel,
+        });
+    }
+    return new runtime_1.default({
+        eventBroadcaster,
+        eventDataCollector,
+        newId,
+        pickleIds,
+        supportCodeLibrary,
+        options,
+    });
+}
+exports.makeRuntime = makeRuntime;
+//# sourceMappingURL=runtime.js.map

package/lib/api/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/api/runtime.ts"],"names":[],"mappings":";;;;;;AAAA,yDAA8C;AAK9C,kFAAyD;AAIzD,SAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,KAAK,EACL,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,GAalC;IACC,IAAI,QAAQ,GAAG,CAAC,EAAE;QAChB,OAAO,IAAI,qBAAW,CAAC;YACrB,GAAG;YACH,MAAM;YACN,gBAAgB;YAChB,kBAAkB;YAClB,SAAS;YACT,OAAO;YACP,KAAK;YACL,kBAAkB;YAClB,cAAc;YACd,YAAY;YACZ,WAAW;YACX,eAAe,EAAE,QAAQ;SAC1B,CAAC,CAAA;KACH;IACD,OAAO,IAAI,iBAAO,CAAC;QACjB,gBAAgB;QAChB,kBAAkB;QAClB,KAAK;QACL,SAAS;QACT,kBAAkB;QAClB,OAAO;KACR,CAAC,CAAA;AACJ,CAAC;AAjDD,kCAiDC","sourcesContent":["import Runtime, { IRuntime } from '../runtime'\nimport { EventEmitter } from 'events'\nimport { EventDataCollector } from '../formatter/helpers'\nimport { IdGenerator } from '@cucumber/messages'\nimport { ISupportCodeLibrary } from '../support_code_library_builder/types'\nimport Coordinator from '../runtime/parallel/coordinator'\nimport { IRunOptionsRuntime } from './types'\nimport { ILogger } from '../logger'\n\nexport function makeRuntime({\n  cwd,\n  logger,\n  eventBroadcaster,\n  eventDataCollector,\n  pickleIds,\n  newId,\n  supportCodeLibrary,\n  requireModules,\n  requirePaths,\n  importPaths,\n  options: { parallel, ...options },\n}: {\n  cwd: string\n  logger: ILogger\n  eventBroadcaster: EventEmitter\n  eventDataCollector: EventDataCollector\n  newId: IdGenerator.NewId\n  pickleIds: string[]\n  supportCodeLibrary: ISupportCodeLibrary\n  requireModules: string[]\n  requirePaths: string[]\n  importPaths: string[]\n  options: IRunOptionsRuntime\n}): IRuntime {\n  if (parallel > 0) {\n    return new Coordinator({\n      cwd,\n      logger,\n      eventBroadcaster,\n      eventDataCollector,\n      pickleIds,\n      options,\n      newId,\n      supportCodeLibrary,\n      requireModules,\n      requirePaths,\n      importPaths,\n      numberOfWorkers: parallel,\n    })\n  }\n  return new Runtime({\n    eventBroadcaster,\n    eventDataCollector,\n    newId,\n    pickleIds,\n    supportCodeLibrary,\n    options,\n  })\n}\n"]}

package/lib/api/support.d.ts

@@ -0,0 +1,9 @@
+import { IdGenerator } from '@cucumber/messages';
+import { ISupportCodeLibrary } from '../support_code_library_builder/types';
+export declare function getSupportCodeLibrary({ cwd, newId, requireModules, requirePaths, importPaths, }: {
+    cwd: string;
+    newId: IdGenerator.NewId;
+    requireModules: string[];
+    requirePaths: string[];
+    importPaths: string[];
+}): Promise<ISupportCodeLibrary>;

package/lib/api/support.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSupportCodeLibrary = void 0;
+const support_code_library_builder_1 = __importDefault(require("../support_code_library_builder"));
+const url_1 = require("url");
+const try_require_1 = __importDefault(require("../try_require"));
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { importer } = require('../importer');
+async function getSupportCodeLibrary({ cwd, newId, requireModules, requirePaths, importPaths, }) {
+    support_code_library_builder_1.default.reset(cwd, newId, {
+        requireModules,
+        requirePaths,
+        importPaths,
+    });
+    requireModules.map((module) => (0, try_require_1.default)(module));
+    requirePaths.map((path) => (0, try_require_1.default)(path));
+    for (const path of importPaths) {
+        await importer((0, url_1.pathToFileURL)(path));
+    }
+    return support_code_library_builder_1.default.finalize();
+}
+exports.getSupportCodeLibrary = getSupportCodeLibrary;
+//# sourceMappingURL=support.js.map

package/lib/api/support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support.js","sourceRoot":"","sources":["../../src/api/support.ts"],"names":[],"mappings":";;;;;;AAEA,mGAAuE;AACvE,6BAAmC;AACnC,iEAAuC;AAEvC,8DAA8D;AAC9D,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;AAEpC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,GAAG,EACH,KAAK,EACL,cAAc,EACd,YAAY,EACZ,WAAW,GAOZ;IACC,sCAAyB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE;QAC1C,cAAc;QACd,YAAY;QACZ,WAAW;KACZ,CAAC,CAAA;IAEF,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,qBAAU,EAAC,MAAM,CAAC,CAAC,CAAA;IAClD,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,qBAAU,EAAC,IAAI,CAAC,CAAC,CAAA;IAE5C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE;QAC9B,MAAM,QAAQ,CAAC,IAAA,mBAAa,EAAC,IAAI,CAAC,CAAC,CAAA;KACpC;IAED,OAAO,sCAAyB,CAAC,QAAQ,EAAE,CAAA;AAC7C,CAAC;AA3BD,sDA2BC","sourcesContent":["import { IdGenerator } from '@cucumber/messages'\nimport { ISupportCodeLibrary } from '../support_code_library_builder/types'\nimport supportCodeLibraryBuilder from '../support_code_library_builder'\nimport { pathToFileURL } from 'url'\nimport tryRequire from '../try_require'\n\n// eslint-disable-next-line @typescript-eslint/no-var-requires\nconst { importer } = require('../importer')\n\nexport async function getSupportCodeLibrary({\n  cwd,\n  newId,\n  requireModules,\n  requirePaths,\n  importPaths,\n}: {\n  cwd: string\n  newId: IdGenerator.NewId\n  requireModules: string[]\n  requirePaths: string[]\n  importPaths: string[]\n}): Promise<ISupportCodeLibrary> {\n  supportCodeLibraryBuilder.reset(cwd, newId, {\n    requireModules,\n    requirePaths,\n    importPaths,\n  })\n\n  requireModules.map((module) => tryRequire(module))\n  requirePaths.map((path) => tryRequire(path))\n\n  for (const path of importPaths) {\n    await importer(pathToFileURL(path))\n  }\n\n  return supportCodeLibraryBuilder.finalize()\n}\n"]}

package/lib/api/test_helpers.d.ts

@@ -0,0 +1,3 @@
+import { IRunEnvironment } from './types';
+export declare function setupEnvironment(): Promise<Partial<IRunEnvironment>>;
+export declare function teardownEnvironment(environment: IRunEnvironment): Promise<void>;

package/lib/api/test_helpers.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.teardownEnvironment = exports.setupEnvironment = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("mz/fs"));
+const reindent_template_literals_1 = require("reindent-template-literals");
+const stream_1 = require("stream");
+const messages_1 = require("@cucumber/messages");
+const newId = messages_1.IdGenerator.uuid();
+async function setupEnvironment() {
+    const cwd = path_1.default.join(__dirname, '..', '..', 'tmp', `api_${newId()}`);
+    await fs_1.default.mkdir(path_1.default.join(cwd, 'features'), { recursive: true });
+    await fs_1.default.writeFile(path_1.default.join(cwd, 'features', 'test.feature'), (0, reindent_template_literals_1.reindent)(`Feature: test fixture
+      Scenario: one
+        Given a step
+        Then another step`));
+    await fs_1.default.writeFile(path_1.default.join(cwd, 'features', 'steps.ts'), (0, reindent_template_literals_1.reindent)(`import { Given, Then } from '../../../src'
+    Given('a step', function () {})
+    Then('another step', function () {})`));
+    await fs_1.default.writeFile(path_1.default.join(cwd, 'cucumber.mjs'), `export default {paths: ['features/test.feature'], requireModule: ['ts-node/register'], require: ['features/steps.ts']}`);
+    const stdout = new stream_1.PassThrough();
+    return { cwd, stdout };
+}
+exports.setupEnvironment = setupEnvironment;
+async function teardownEnvironment(environment) {
+    return new Promise((resolve) => {
+        fs_1.default.rm(environment.cwd, { recursive: true }, resolve);
+    }).then(() => {
+        environment.stdout.end();
+    });
+}
+exports.teardownEnvironment = teardownEnvironment;
+//# sourceMappingURL=test_helpers.js.map

package/lib/api/test_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_helpers.js","sourceRoot":"","sources":["../../src/api/test_helpers.ts"],"names":[],"mappings":";;;;;;AACA,gDAAuB;AACvB,+CAAsB;AACtB,2EAAqD;AACrD,mCAAoC;AACpC,iDAAgD;AAEhD,MAAM,KAAK,GAAG,sBAAW,CAAC,IAAI,EAAE,CAAA;AAEzB,KAAK,UAAU,gBAAgB;IACpC,MAAM,GAAG,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,EAAE,EAAE,CAAC,CAAA;IACrE,MAAM,YAAE,CAAC,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/D,MAAM,YAAE,CAAC,SAAS,CAChB,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,cAAc,CAAC,EAC1C,IAAA,qCAAQ,EAAC;;;0BAGa,CAAC,CACxB,CAAA;IACD,MAAM,YAAE,CAAC,SAAS,CAChB,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,EACtC,IAAA,qCAAQ,EAAC;;yCAE4B,CAAC,CACvC,CAAA;IACD,MAAM,YAAE,CAAC,SAAS,CAChB,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAC9B,wHAAwH,CACzH,CAAA;IACD,MAAM,MAAM,GAAG,IAAI,oBAAW,EAAE,CAAA;IAChC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;AACxB,CAAC;AAtBD,4CAsBC;AAEM,KAAK,UAAU,mBAAmB,CAAC,WAA4B;IACpE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,YAAE,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAA;IACtD,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QACX,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC;AAND,kDAMC","sourcesContent":["import { IRunEnvironment } from './types'\nimport path from 'path'\nimport fs from 'mz/fs'\nimport { reindent } from 'reindent-template-literals'\nimport { PassThrough } from 'stream'\nimport { IdGenerator } from '@cucumber/messages'\n\nconst newId = IdGenerator.uuid()\n\nexport async function setupEnvironment(): Promise<Partial<IRunEnvironment>> {\n  const cwd = path.join(__dirname, '..', '..', 'tmp', `api_${newId()}`)\n  await fs.mkdir(path.join(cwd, 'features'), { recursive: true })\n  await fs.writeFile(\n    path.join(cwd, 'features', 'test.feature'),\n    reindent(`Feature: test fixture\n      Scenario: one\n        Given a step\n        Then another step`)\n  )\n  await fs.writeFile(\n    path.join(cwd, 'features', 'steps.ts'),\n    reindent(`import { Given, Then } from '../../../src'\n    Given('a step', function () {})\n    Then('another step', function () {})`)\n  )\n  await fs.writeFile(\n    path.join(cwd, 'cucumber.mjs'),\n    `export default {paths: ['features/test.feature'], requireModule: ['ts-node/register'], require: ['features/steps.ts']}`\n  )\n  const stdout = new PassThrough()\n  return { cwd, stdout }\n}\n\nexport async function teardownEnvironment(environment: IRunEnvironment) {\n  return new Promise((resolve) => {\n    fs.rm(environment.cwd, { recursive: true }, resolve)\n  }).then(() => {\n    environment.stdout.end()\n  })\n}\n"]}