@sanoma-ai/workflows 0.0.0-stage → 0.2.0

package/dist/cucumber.d.ts

@@ -0,0 +1,64 @@
+import { type ISupportCodeLibrary } from "@cucumber/cucumber/api";
+import { type Pickle, type PickleStep, TestStepResultStatus } from "@cucumber/messages";
+import { Query } from "@cucumber/query";
+/** A parameter type the steps' expressions use, as Cucumber's `defineParameterType` takes it. */
+export interface ParameterTypeSpec {
+    name: string;
+    regexp: RegExp | string | readonly (RegExp | string)[];
+    transformer: (...match: string[]) => unknown;
+}
+/** What one run does with its scenarios' steps. */
+export interface SanomaWorld {
+    /** Called before the scenario's first step. */
+    begin(pickle: Pickle): void;
+    /** Runs one step: `expression` is the expression it matched, `values` its parameters. */
+    step(expression: string, values: unknown[], pickleStep: PickleStep): unknown;
+}
+/**
+ * Builds a support code library: the parameter types, then one step definition per expression,
+ * each handing its step to the World. Cucumber keeps one builder per process, so the library is
+ * built here, by hand, in one synchronous stretch (`reset`, register, `finalize`): building it
+ * again in the same process gives the same definitions, where a second `loadSupport` would
+ * import nothing new and find none.
+ */
+export declare function buildLibrary(parameterTypes: readonly ParameterTypeSpec[], expressions: Iterable<string>): ISupportCodeLibrary;
+/** How one step ended. */
+export interface StepResult {
+    status: TestStepResultStatus;
+    /** Why it failed: its error's message. */
+    message?: string;
+    /** The expressions that match it: none for an undefined step, more than one for an ambiguous one. */
+    matches: string[];
+}
+/** What a run read: Cucumber's `Query` of its messages, each file's text, and the files Gherkin could not parse. */
+export interface Report {
+    query: Query;
+    /** Each file's text, by its path relative to the run's `cwd`. */
+    texts: Map<string, string>;
+    /** Files Gherkin could not parse; none of the run's scenarios ran when there are any. */
+    parseErrors: {
+        uri: string;
+        line?: number;
+        message: string;
+    }[];
+}
+/** How each step of a run ended, by its pickle step's id; a step of a pickle that did not run has none. */
+export declare function stepResults({ query }: Report): Map<string, StepResult>;
+/** A pickle's line: its examples row's, or its scenario's. */
+export declare const lineOf: (report: Report, pickle: Pickle) => number;
+/**
+ * Runs the feature files `files` (relative to `cwd`) with the library, serially, in this
+ * process, and reads back what happened. `line`, with a single file, runs only the scenario or
+ * examples row at that line. `makeWorld` makes each scenario's World, given the report so far
+ * (every file and pickle, read before the first scenario starts). A dry run matches the steps
+ * and runs none. A step's error that is a bug in code (`isBug`) is rethrown once the run is
+ * over, rather than reported as the step's failure.
+ */
+export declare function runFeatures(library: ISupportCodeLibrary, makeWorld: (report: Report) => SanomaWorld, { cwd, files, line, dryRun, isBug, }: {
+    cwd: string;
+    files: string[];
+    line?: number;
+    dryRun?: boolean;
+    isBug: (err: unknown) => boolean;
+}): Promise<Report>;
+export { TestStepResultStatus as StepStatus };

package/dist/cucumber.js

@@ -0,0 +1,158 @@
+import { Writable } from "node:stream";
+import { supportCodeLibraryBuilder } from "@cucumber/cucumber";
+import { runCucumber } from "@cucumber/cucumber/api";
+import { NodeType } from "@cucumber/cucumber-expressions";
+import { IdGenerator, TestStepResultStatus } from "@cucumber/messages";
+import { Query } from "@cucumber/query";
+/**
+ * Builds a support code library: the parameter types, then one step definition per expression,
+ * each handing its step to the World. Cucumber keeps one builder per process, so the library is
+ * built here, by hand, in one synchronous stretch (`reset`, register, `finalize`): building it
+ * again in the same process gives the same definitions, where a second `loadSupport` would
+ * import nothing new and find none.
+ */
+export function buildLibrary(parameterTypes, expressions) {
+    const builder = supportCodeLibraryBuilder;
+    builder.reset(process.cwd(), IdGenerator.uuid(), {
+        requireModules: [],
+        requirePaths: [],
+        importPaths: [],
+        loaders: [],
+    });
+    const { defineParameterType, defineStep, Before, BeforeStep } = builder.methods;
+    for (const { name, regexp, transformer } of parameterTypes) {
+        defineParameterType({ name, regexp: regexp, transformer, useForSnippets: false });
+    }
+    for (const expression of expressions)
+        defineStep(expression, stepCode(expression));
+    Before(function ({ pickle }) {
+        if (this.run.skips(pickle))
+            return "skipped";
+        this.begin(pickle);
+        return undefined;
+    });
+    BeforeStep(function ({ pickleStep }) {
+        this.current = pickleStep;
+    });
+    const library = builder.finalize();
+    // Cucumber checks a definition's code's `length` against what it passes: the expression's
+    // parameters, then the step's doc string or table, or else a callback. Its own parse of each
+    // expression says how many parameters it has.
+    for (const { code, expression } of library.stepDefinitions) {
+        Object.defineProperty(code, "length", {
+            value: countParameters(expression.ast) + 1,
+        });
+    }
+    return library;
+}
+const countParameters = (node) => node.type === NodeType.parameter ? 1 : (node.nodes ?? []).reduce((n, child) => n + countParameters(child), 0);
+/**
+ * A step definition's code. Cucumber passes the expression's values, then the step's doc string
+ * or table when it has one, then a callback: with one more argument than the parameters it took
+ * the callback of a step with no argument (the callback interface), and with two more, the
+ * argument of a step that has one (the promise interface). The World reads the argument from
+ * the pickle step, so the code answers both.
+ */
+function stepCode(expression) {
+    const code = function (...args) {
+        const parameters = code.length - 1;
+        const result = Promise.resolve()
+            .then(() => this.step(expression, args.slice(0, parameters), this.current))
+            .catch((err) => {
+            this.run.caught(err);
+            throw err;
+        });
+        if (args.length > parameters + 1)
+            return result;
+        const done = args.at(-1);
+        result.then((value) => done(null, value), (err) => done(err));
+        return undefined;
+    };
+    return code;
+}
+/** How each step of a run ended, by its pickle step's id; a step of a pickle that did not run has none. */
+export function stepResults({ query }) {
+    const results = new Map();
+    for (const finished of query.findAllTestStepFinished()) {
+        const testStep = query.findTestStepBy(finished);
+        if (!testStep?.pickleStepId)
+            continue;
+        const { status, message, exception } = finished.testStepResult;
+        const why = exception?.message ?? message;
+        results.set(testStep.pickleStepId, {
+            status,
+            matches: query.findStepDefinitionsBy(testStep).map((d) => d.pattern.source),
+            ...(why !== undefined && { message: why }),
+        });
+    }
+    return results;
+}
+/** A pickle's line: its examples row's, or its scenario's. */
+export const lineOf = (report, pickle) => report.query.findLocationOf(pickle)?.line ?? 1;
+/** A stream that drops what it is given: Cucumber's formatters and logger write nowhere. */
+const sink = () => new Writable({
+    write(_chunk, _encoding, callback) {
+        callback();
+    },
+});
+/**
+ * A path as a glob that matches it alone: Cucumber globs each path it is given, and reads one
+ * whose name starts with `@` as a list of paths. Brackets escape what they can; brace
+ * expansion reads braces and commas before brackets, so those (and backslashes) match any
+ * character instead.
+ */
+const literal = (path) => path.replaceAll(/[*?[\]()+@]/g, "[$&]").replaceAll(/[{},\\]/g, "?");
+/**
+ * Runs the feature files `files` (relative to `cwd`) with the library, serially, in this
+ * process, and reads back what happened. `line`, with a single file, runs only the scenario or
+ * examples row at that line. `makeWorld` makes each scenario's World, given the report so far
+ * (every file and pickle, read before the first scenario starts). A dry run matches the steps
+ * and runs none. A step's error that is a bug in code (`isBug`) is rethrown once the run is
+ * over, rather than reported as the step's failure.
+ */
+export async function runFeatures(library, makeWorld, { cwd, files, line, dryRun = false, isBug, }) {
+    const report = { query: new Query(), texts: new Map(), parseErrors: [] };
+    let bug;
+    const run = {
+        skips: (pickle) => line !== undefined && lineOf(report, pickle) !== line,
+        caught: (err) => {
+            if (isBug(err))
+                bug ??= err;
+        },
+    };
+    // Cucumber makes a scenario's World with `new`: a constructor that returns an object gives that object.
+    function World() {
+        return Object.assign(makeWorld(report), { run });
+    }
+    const configuration = {
+        sources: { defaultDialect: "en", paths: files.map(literal), names: [], tagExpression: "", order: "defined" },
+        support: { ...library, World },
+        runtime: {
+            dryRun,
+            failFast: false,
+            filterStacktraces: true,
+            parallel: 0,
+            retry: 0,
+            retryTagFilter: "",
+            strict: true,
+            worldParameters: {},
+        },
+        // Cucumber always formats to stdout, here a sink: `rerun` is the formatter that does least.
+        formats: { stdout: "rerun", files: {}, publish: false, options: {} },
+    };
+    await runCucumber(configuration, { cwd, stdout: sink(), stderr: sink(), env: {} }, (envelope) => {
+        report.query.update(envelope);
+        const { source, parseError } = envelope;
+        if (source)
+            report.texts.set(source.uri, source.data);
+        if (parseError) {
+            const { uri = "", location } = parseError.source;
+            report.parseErrors.push({ uri, ...(location && { line: location.line }), message: parseError.message });
+        }
+    });
+    if (bug !== undefined)
+        throw bug;
+    return report;
+}
+export { TestStepResultStatus as StepStatus };
+//# sourceMappingURL=cucumber.js.map

package/dist/cucumber.js.map

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

package/dist/datafile.d.ts

@@ -0,0 +1,71 @@
+import type { Node } from "./ast.ts";
+import { type Secret } from "./secret.ts";
+/** Something a data file may not hold, at UTF-16 offsets into its text. */
+export interface DataFileProblem {
+    start: number;
+    end: number;
+    message: string;
+}
+/** A name in a data file that refers to a declared resource: one imported from a data file, or exported by this one. */
+export declare class Reference {
+    readonly name: string;
+    constructor(name: string);
+}
+/** True for a `Reference`, made by any copy of this package: read by a registered symbol, not `instanceof`. */
+export declare const isReference: (value: unknown) => value is Reference;
+/** What `secret("NAME")` stands for in a data file: its marker, `{ $secret: "NAME", generate?: true }`. */
+export type SecretRef = Secret;
+/** A value in a data file: a literal, a reference to a declared resource, or a secret's marker. */
+export type DataValue = null | boolean | number | string | Reference | SecretRef | DataValue[] | {
+    [field: string]: DataValue;
+};
+/** An `import { name } from "…"`: of a connector's constructors (`from "…/resources"`), or of another data file's resource. */
+export interface DataFileImport {
+    kind: "constructors" | "file";
+    /** The specifier as written. */
+    source: string;
+    /** The name the other module exports. */
+    imported: string;
+    /** The name it has in this file. */
+    local: string;
+    start: number;
+}
+/** An `export const name = vendor.type({ … })`. */
+export interface DataFileExport {
+    name: string;
+    /** The local name of the constructors it calls (`github`). */
+    vendor: string;
+    type: string;
+    desired: {
+        [field: string]: DataValue;
+    };
+    /** The `export const` statement. */
+    start: number;
+    end: number;
+}
+export interface DataFile {
+    imports: DataFileImport[];
+    /** Each `export const` whose value is in the subset. */
+    exports: DataFileExport[];
+    /** Every name an `export const` declares, its value in the subset or not. */
+    declared: string[];
+    problems: DataFileProblem[];
+}
+/** Where a data file imports `secret` from; checked before `CONSTRUCTORS`, which they match too. */
+export declare const SECRET_ENTRIES: ReadonlySet<string>;
+/**
+ * Reads a data file's program without running it: its imports, each `export const` resource
+ * with its fields evaluated, and everything outside the data-file subset as a problem that says
+ * what to write instead.
+ *
+ * The subset: named imports, from a connector's `…/resources` entry or a `.ts` data file;
+ * `export const <name> = <vendor>.<type>({ … })`, one per statement, its argument built of
+ * strings (template literals without `${}` too), numbers, booleans, null, objects and arrays,
+ * and names of resources this file declares or imports; and `export default [a, b]`.
+ *
+ * `root` is the directory relative imports must stay in: by default the nearest `resources/`
+ * directory above `filename`, else the file's own.
+ */
+export declare function readDataFile(program: Node, filename: string, root?: string): DataFile;
+/** A property's name: an identifier's, or a literal's as a string; undefined for any other key. */
+export declare const keyName: (key: Node) => string | undefined;