test-fns 1.7.2 → 1.9.1

package/dist/contract/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * .what = public contract for test-fns library
+ * .why = provides the stable public API surface, re-exports from domain.operations
+ */
+export { getError } from 'helpful-errors';
+export { genTestUuid } from '../domain.operations/genTestUuid';
+export { bdd, given, then, when } from '../domain.operations/givenWhenThen';
+export { useBeforeAll, useBeforeEach, usePrep, } from '../domain.operations/usePrep';
+export { useThen } from '../domain.operations/useThen';
+export { useWhen } from '../domain.operations/useWhen';

package/dist/contract/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * .what = public contract for test-fns library
+ * .why = provides the stable public API surface, re-exports from domain.operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWhen = exports.useThen = exports.usePrep = exports.useBeforeEach = exports.useBeforeAll = exports.when = exports.then = exports.given = exports.bdd = exports.genTestUuid = exports.getError = void 0;
+// forward the getError method since it is almost always needed with tests
+var helpful_errors_1 = require("helpful-errors");
+Object.defineProperty(exports, "getError", { enumerable: true, get: function () { return helpful_errors_1.getError; } });
+// test utilities
+var genTestUuid_1 = require("../domain.operations/genTestUuid");
+Object.defineProperty(exports, "genTestUuid", { enumerable: true, get: function () { return genTestUuid_1.genTestUuid; } });
+var givenWhenThen_1 = require("../domain.operations/givenWhenThen");
+Object.defineProperty(exports, "bdd", { enumerable: true, get: function () { return givenWhenThen_1.bdd; } });
+Object.defineProperty(exports, "given", { enumerable: true, get: function () { return givenWhenThen_1.given; } });
+Object.defineProperty(exports, "then", { enumerable: true, get: function () { return givenWhenThen_1.then; } });
+Object.defineProperty(exports, "when", { enumerable: true, get: function () { return givenWhenThen_1.when; } });
+var usePrep_1 = require("../domain.operations/usePrep");
+Object.defineProperty(exports, "useBeforeAll", { enumerable: true, get: function () { return usePrep_1.useBeforeAll; } });
+Object.defineProperty(exports, "useBeforeEach", { enumerable: true, get: function () { return usePrep_1.useBeforeEach; } });
+Object.defineProperty(exports, "usePrep", { enumerable: true, get: function () { return usePrep_1.usePrep; } });
+var useThen_1 = require("../domain.operations/useThen");
+Object.defineProperty(exports, "useThen", { enumerable: true, get: function () { return useThen_1.useThen; } });
+var useWhen_1 = require("../domain.operations/useWhen");
+Object.defineProperty(exports, "useWhen", { enumerable: true, get: function () { return useWhen_1.useWhen; } });
+//# sourceMappingURL=index.js.map

package/dist/contract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,0EAA0E;AAC1E,iDAA0C;AAAjC,0GAAA,QAAQ,OAAA;AAEjB,iBAAiB;AACjB,kEAAiE;AAAxD,0GAAA,WAAW,OAAA;AACpB,sEAA8E;AAArE,oGAAA,GAAG,OAAA;AAAE,sGAAA,KAAK,OAAA;AAAE,qGAAA,IAAI,OAAA;AAAE,qGAAA,IAAI,OAAA;AAC/B,0DAIwC;AAHtC,uGAAA,YAAY,OAAA;AACZ,wGAAA,aAAa,OAAA;AACb,kGAAA,OAAO,OAAA;AAET,0DAAyD;AAAhD,kGAAA,OAAO,OAAA;AAChB,0DAAyD;AAAhD,kGAAA,OAAO,OAAA"}

package/dist/contract/vitest.setup.d.ts

@@ -0,0 +1,48 @@
+/**
+ * .what = vitest setup file to register BDD globals
+ * .why = direct `import { then }` triggers ESM thenable detection in vitest.
+ *        this setup file registers given/when/then as globals via the `bdd` namespace,
+ *        which bypasses thenable detection since `bdd` has no top-level `then`.
+ *
+ * .usage = add to vitest.config.ts:
+ *   export default defineConfig({
+ *     test: {
+ *       setupFiles: ['test-fns/vitest.setup'],
+ *     },
+ *   });
+ *
+ * @see .agent/repo=.this/role=any/briefs/limitation.esm-thenable-then-export.md
+ */
+import { bdd } from './index';
+declare global {
+    /**
+     * describe the scene (initial state or context) for a group of tests
+     * @example
+     * given('a dry plant', () => {
+     *   when('water needs are checked', () => {
+     *     then('it should return true', () => {
+     *       expect(doesPlantNeedWater(plant)).toBe(true);
+     *     });
+     *   });
+     * });
+     */
+    var given: typeof bdd.given;
+    /**
+     * describe the event (action or trigger) that occurs within a scene
+     * @example
+     * when('the user clicks submit', () => {
+     *   then('the form should be submitted', () => {
+     *     expect(form.submitted).toBe(true);
+     *   });
+     * });
+     */
+    var when: typeof bdd.when;
+    /**
+     * assert the effect (expected outcome) that should be observed
+     * @example
+     * then('it should return the correct value', () => {
+     *   expect(result).toBe(expected);
+     * });
+     */
+    var then: typeof bdd.then;
+}

package/dist/contract/vitest.setup.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * .what = vitest setup file to register BDD globals
+ * .why = direct `import { then }` triggers ESM thenable detection in vitest.
+ *        this setup file registers given/when/then as globals via the `bdd` namespace,
+ *        which bypasses thenable detection since `bdd` has no top-level `then`.
+ *
+ * .usage = add to vitest.config.ts:
+ *   export default defineConfig({
+ *     test: {
+ *       setupFiles: ['test-fns/vitest.setup'],
+ *     },
+ *   });
+ *
+ * @see .agent/repo=.this/role=any/briefs/limitation.esm-thenable-then-export.md
+ */
+const index_1 = require("./index");
+// register BDD helpers as globals
+globalThis.given = index_1.bdd.given;
+globalThis.when = index_1.bdd.when;
+globalThis.then = index_1.bdd.then;
+//# sourceMappingURL=vitest.setup.js.map

package/dist/contract/vitest.setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.setup.js","sourceRoot":"","sources":["../../src/contract/vitest.setup.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;GAcG;AACH,mCAA8B;AAsC9B,kCAAkC;AAClC,UAAU,CAAC,KAAK,GAAG,WAAG,CAAC,KAAK,CAAC;AAC7B,UAAU,CAAC,IAAI,GAAG,WAAG,CAAC,IAAI,CAAC;AAC3B,UAAU,CAAC,IAAI,GAAG,WAAG,CAAC,IAAI,CAAC"}

package/dist/domain.operations/genTestUuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genTestUuid.js","sourceRoot":"","sources":["../../src/domain.operations/genTestUuid.ts"],"names":[],"mappings":";;;AAAA,+BAAkC;AAElC;;;;;GAKG;AACI,MAAM,WAAW,GAAG,GAAW,EAAE;IACtC,OAAO,CAAC,MAAM,EAAE,IAAA,SAAI,GAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxD,CAAC,CAAC;AAFW,QAAA,WAAW,eAEtB;AAEF;;GAEG;AACI,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAW,EAAE,CACtD,oCAAoC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AADzC,QAAA,UAAU,cAC+B"}

package/dist/{givenWhenThen.d.ts → domain.operations/givenWhenThen.d.ts}

@@ -16,9 +16,9 @@ interface Describe {
     (desc: string, fn: () => void): void;
     /** Only runs the tests inside this `describe` for the current file */
     only: (desc: string, fn: () => void) => void;
-    /** Skips running the tests inside this `describe` for the current file */
+    /** Skip the tests inside this `describe` for the current file */
     skip: (desc: string, fn: () => void) => void;
-    /** Skips running the tests inside this `describe` for the current file if the condition is satisfied */
+    /** Skip the tests inside this `describe` for the current file if the condition is satisfied */
     skipIf: (condition: boolean) => (desc: string, fn: () => void) => void;
     /** Runs the tests inside this `describe` for the current file only if the condition is satisfied */
     runIf: (condition: boolean) => (desc: string, fn: () => void) => void;
@@ -27,11 +27,11 @@ interface Test {
     (...input: TestInput<void>): void;
     /** Only runs this test for the current file */
     only: (...input: TestInput<void>) => void;
-    /** Skips running this test */
+    /** Skip this test */
     skip: (...input: TestInput<void>) => void;
     /** Marks the test as one that still needs to be written */
     todo: (...input: TestInput<void>) => void;
-    /** Skips running the test, if the condition is satisfied */
+    /** Skip the test if the condition is satisfied */
     skipIf: (condition: boolean) => (...input: TestInput<void>) => void;
     /** Runs the test if the condition is satisfied */
     runIf: (condition: boolean) => (...input: TestInput<void>) => void;
@@ -53,7 +53,45 @@ interface Test {
         attempt: number;
     }>) => void;
 }
+/**
+ * describe the scene (initial state or context) for a group of tests
+ * @example
+ * given('a dry plant', () => {
+ *   when('water needs are checked', () => {
+ *     then('it should return true', () => {
+ *       expect(doesPlantNeedWater(plant)).toBe(true);
+ *     });
+ *   });
+ * });
+ */
 export declare const given: Describe;
+/**
+ * describe the event (action or trigger) that occurs within a scene
+ * @example
+ * when('the user clicks submit', () => {
+ *   then('the form should be submitted', () => {
+ *     expect(form.submitted).toBe(true);
+ *   });
+ * });
+ */
 export declare const when: Describe;
-export declare const then: Test;
-export {};
+/**
+ * .what = namespace object for BDD-style test helpers
+ * .why = provides vitest-compatible access to given/when/then via `bdd.then()`
+ *        since direct `then` export triggers ESM thenable detection in vitest.
+ *
+ * @see .agent/repo=.this/role=any/briefs/limitation.esm-thenable-then-export.md
+ */
+export declare const bdd: {
+    given: Describe;
+    when: Describe;
+    then: Test;
+};
+/**
+ * .what = wraps `then` to handle vitest's thenable detection
+ * .why = vitest calls `then(resolve, reject)` on module import; we detect and resolve it
+ *
+ * @see .agent/repo=.this/role=any/briefs/limitation.esm-thenable-then-export.md
+ */
+declare const thenExportable: Test;
+export { thenExportable as then };

package/dist/domain.operations/givenWhenThen.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.then = exports.bdd = exports.when = exports.given = exports.getNumberRange = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const detectTestRunner_1 = require("../infra/isomorph.test/detectTestRunner");
+const getTestGlobals_1 = require("../infra/isomorph.test/getTestGlobals");
+const getNumberRange = (input) => {
+    // Calculate the length of the range
+    const length = input.end - input.start + 1;
+    // Create an array with the specified range
+    return Array.from({ length }, (_, i) => input.start + i);
+};
+exports.getNumberRange = getNumberRange;
+const castToTestInput = ({ input, prefix, }) => {
+    const method = input.length === 3 ? input[2] : input[1]; // its always last
+    if (input.length === 3)
+        return [`${prefix}: ${input[0]}`, method]; // we allow users to specify the reason for code readability, but we dont expose this in the test report to decrease noise. folks can look in the code if they want to know "why"
+    return [`${prefix}: ${input[0]}`, method]; // otherwise, its the normal input
+};
+/**
+ * describe the scene (initial state or context) for a group of tests
+ * @example
+ * given('a dry plant', () => {
+ *   when('water needs are checked', () => {
+ *     then('it should return true', () => {
+ *       expect(doesPlantNeedWater(plant)).toBe(true);
+ *     });
+ *   });
+ * });
+ */
+const given = (desc, fn) => {
+    (0, getTestGlobals_1.globals)().describe(`given: ${desc}`, fn);
+};
+exports.given = given;
+exports.given.only = (desc, fn) => (0, getTestGlobals_1.globals)().describe.only(`given: ${desc}`, fn);
+exports.given.skip = (desc, fn) => (0, getTestGlobals_1.globals)().describe.skip(`given: ${desc}`, fn);
+exports.given.skipIf =
+    (condition) => (desc, fn) => condition ? exports.given.skip(desc, fn) : (0, exports.given)(desc, fn);
+exports.given.runIf = (condition) => exports.given.skipIf(!condition);
+/**
+ * describe the event (action or trigger) that occurs within a scene
+ * @example
+ * when('the user clicks submit', () => {
+ *   then('the form should be submitted', () => {
+ *     expect(form.submitted).toBe(true);
+ *   });
+ * });
+ */
+const when = (desc, fn) => {
+    (0, getTestGlobals_1.globals)().describe(`when: ${desc}`, fn);
+};
+exports.when = when;
+exports.when.only = (desc, fn) => (0, getTestGlobals_1.globals)().describe.only(`when: ${desc}`, fn);
+exports.when.skip = (desc, fn) => (0, getTestGlobals_1.globals)().describe.skip(`when: ${desc}`, fn);
+exports.when.skipIf =
+    (condition) => (desc, fn) => condition ? exports.when.skip(desc, fn) : (0, exports.when)(desc, fn);
+exports.when.runIf = (condition) => exports.when.skipIf(!condition);
+/**
+ * assert the effect (expected outcome) that should be observed
+ * @example
+ * then('it should return the correct value', () => {
+ *   expect(result).toBe(expected);
+ * });
+ */
+const then = ((...input) => {
+    (0, getTestGlobals_1.globals)().test(...castToTestInput({ input, prefix: 'then' }));
+});
+// add methods to then
+then.only = (...input) => (0, getTestGlobals_1.globals)().test.only(...castToTestInput({ input, prefix: 'then' }));
+then.skip = (...input) => (0, getTestGlobals_1.globals)().test.skip(...castToTestInput({ input, prefix: 'then' }));
+then.todo = (...input) => (0, getTestGlobals_1.globals)().test.todo(castToTestInput({ input: [input[0]], prefix: 'then' })[0]);
+then.skipIf =
+    (condition) => (...input) => condition ? then.skip(...input) : then(...input);
+then.runIf = (condition) => then.skipIf(!condition);
+then.repeatably =
+    (configuration) => (...input) => {
+        if (input.length !== 2 && input.length !== 3)
+            throw new helpful_errors_1.UnexpectedCodePathError('unsupported input length', { input });
+        if (configuration.criteria === 'SOME') {
+            const runner = (0, detectTestRunner_1.getTestRunner)();
+            const testFn = (0, getTestGlobals_1.globals)().test;
+            let attempt = 0;
+            (0, getTestGlobals_1.globals)().beforeEach(() => attempt++);
+            const [name, fn] = castToTestInput({
+                input: input.length === 2
+                    ? [input[0], () => input[1]({ attempt })]
+                    : [input[0], input[1], () => input[2]({ attempt })],
+                prefix: 'then',
+            });
+            if (runner === 'jest') {
+                jest.retryTimes(configuration.attempts, { logErrorsBeforeRetry: true });
+                testFn(name, fn);
+            }
+            if (runner === 'vitest') {
+                testFn(name, { retry: configuration.attempts }, fn);
+            }
+            return;
+        }
+        if (configuration.criteria === 'EVERY') {
+            for (const attempt of (0, exports.getNumberRange)({
+                start: 1,
+                end: configuration.attempts,
+            })) {
+                if (input.length === 2)
+                    then(input[0] + `, attempt ${attempt}`, () => input[1]({ attempt }));
+                if (input.length === 3)
+                    then(input[0] + `, attempt ${attempt}`, input[1], () => input[2]({ attempt }));
+            }
+            return;
+        }
+        throw new helpful_errors_1.UnexpectedCodePathError('configuration.criteria was neither EVERY nor SOME', { configuration });
+    };
+/**
+ * .what = namespace object for BDD-style test helpers
+ * .why = provides vitest-compatible access to given/when/then via `bdd.then()`
+ *        since direct `then` export triggers ESM thenable detection in vitest.
+ *
+ * @see .agent/repo=.this/role=any/briefs/limitation.esm-thenable-then-export.md
+ */
+exports.bdd = { given: exports.given, when: exports.when, then };
+/**
+ * .what = wraps `then` to handle vitest's thenable detection
+ * .why = vitest calls `then(resolve, reject)` on module import; we detect and resolve it
+ *
+ * @see .agent/repo=.this/role=any/briefs/limitation.esm-thenable-then-export.md
+ */
+const thenExportable = ((...input) => {
+    // vitest treats modules with `then` as thenables and calls then(resolve, reject)
+    if (typeof input[0] === 'function') {
+        // resolve with exports that don't have a callable `then` (to break thenable cycle)
+        input[0]({ given: exports.given, when: exports.when, bdd: exports.bdd, getNumberRange: exports.getNumberRange });
+        return;
+    }
+    then(...input);
+});
+exports.then = thenExportable;
+thenExportable.only = then.only;
+thenExportable.skip = then.skip;
+thenExportable.todo = then.todo;
+thenExportable.skipIf = then.skipIf;
+thenExportable.runIf = then.runIf;
+thenExportable.repeatably = then.repeatably;
+//# sourceMappingURL=givenWhenThen.js.map

package/dist/domain.operations/givenWhenThen.js.map

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

package/dist/{usePrep.d.ts → domain.operations/usePrep.d.ts}

@@ -1,6 +1,6 @@
 /**
  * .what = declare a resource to be prepared before tests
- * .why = simplifies devexp by letting you write `const thing = usePrep(...)`
+ * .why = simplifies devexp via `const thing = usePrep(...)` syntax
  * .mode =
  *   - 'beforeAll': prepare once for all tests
  *   - 'beforeEach': prepare fresh for each test run

package/dist/{usePrep.js → domain.operations/usePrep.js}

@@ -2,9 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useBeforeEach = exports.useBeforeAll = exports.usePrep = void 0;
 const helpful_errors_1 = require("helpful-errors");
+const getTestGlobals_1 = require("../infra/isomorph.test/getTestGlobals");
 /**
  * .what = declare a resource to be prepared before tests
- * .why = simplifies devexp by letting you write `const thing = usePrep(...)`
+ * .why = simplifies devexp via `const thing = usePrep(...)` syntax
  * .mode =
  *   - 'beforeAll': prepare once for all tests
  *   - 'beforeEach': prepare fresh for each test run
@@ -30,7 +31,7 @@ const usePrep = (setup, options = { mode: 'beforeAll' }) => {
             throw new Error('usePrep: value is not callable');
         },
     };
-    const register = options.mode === 'beforeEach' ? beforeEach : beforeAll;
+    const register = options.mode === 'beforeEach' ? (0, getTestGlobals_1.globals)().beforeEach : (0, getTestGlobals_1.globals)().beforeAll;
     register(async () => {
         toolbox = await setup();
         // assign properties from toolbox to drawer so Object.keys(), for..in, etc work

package/dist/domain.operations/usePrep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrep.js","sourceRoot":"","sources":["../../src/domain.operations/usePrep.ts"],"names":[],"mappings":";;;AAAA,mDAAyD;AAEzD,4EAAkE;AAElE;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,CACrB,KAAuB,EACvB,UAEI,EAAE,IAAI,EAAE,WAAW,EAAE,EACtB,EAAE;IACL,wEAAwE;IACxE,MAAM,MAAM,GAAe,EAAE,CAAC,CAAC,8BAA8B;IAC7D,IAAI,OAAsB,CAAC,CAAC,uCAAuC;IAEnE,qDAAqD;IACrD,MAAM,YAAY,GAAsB;QACtC,GAAG,CAAC,CAAC,EAAE,IAAI;YACT,IAAI,OAAO,KAAK,SAAS;gBACvB,MAAM,IAAI,wCAAuB,CAC/B,uDAAuD,CACxD,CAAC;YACJ,OAAQ,OAAe,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,OAAO;YACL,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,wBAAwB,CAAC,CAAC,EAAE,IAAI;YAC9B,OAAO,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACvD,CAAC;QACD,KAAK;YACH,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;IAEF,MAAM,QAAQ,GACZ,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,IAAA,wBAAO,GAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAA,wBAAO,GAAE,CAAC,SAAS,CAAC;IAE7E,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,OAAO,GAAG,MAAM,KAAK,EAAE,CAAC;QAExB,+EAA+E;QAC/E,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAE/B,iEAAiE;QACjE,OAAO,YAAY,CAAC,GAAG,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,mDAAmD;IACnD,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE,YAAY,CAAM,CAAC;AAC9C,CAAC,CAAC;AA7CW,QAAA,OAAO,WA6ClB;AAEK,MAAM,YAAY,GAAG,CAC1B,KAAuC,EACR,EAAE,CAAC,IAAA,eAAO,EAAI,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AAFhE,QAAA,YAAY,gBAEoD;AACtE,MAAM,aAAa,GAAG,CAC3B,KAAuC,EACR,EAAE,CAAC,IAAA,eAAO,EAAI,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AAFjE,QAAA,aAAa,iBAEoD"}

package/dist/domain.operations/useThen.d.ts

@@ -0,0 +1,17 @@
+/**
+ * .what = interface for useThen with modifiers
+ * .why = enables useThen.only, useThen.skip, etc.
+ */
+interface UseThen {
+    <T extends Record<string, any>>(desc: string, fn: () => Promise<T> | T): T;
+    only: <T extends Record<string, any>>(desc: string, fn: () => Promise<T> | T) => T;
+    skip: <T extends Record<string, any>>(desc: string, fn: () => Promise<T> | T) => T;
+    skipIf: (condition: boolean) => <T extends Record<string, any>>(desc: string, fn: () => Promise<T> | T) => T;
+    runIf: (condition: boolean) => <T extends Record<string, any>>(desc: string, fn: () => Promise<T> | T) => T;
+}
+/**
+ * .what = register a test and capture its return value for subsequent assertions
+ * .why = eliminates `let` declarations for sharing operation results between then blocks
+ */
+export declare const useThen: UseThen;
+export {};

package/dist/domain.operations/useThen.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useThen = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const givenWhenThen_1 = require("./givenWhenThen");
+// use bdd.then to avoid vitest thenable detection issues with direct then export
+const { then } = givenWhenThen_1.bdd;
+/**
+ * .what = helper to create the proxy pattern for useThen
+ * .why = reused by main function and all modifiers
+ */
+const createUseThenProxy = (input) => {
+    // metaphor: "drawer" = proxy target, "toolbox" = real resolved resource
+    const drawer = {};
+    let toolbox;
+    // declare proxy handler up front so we can mutate it
+    const proxyHandler = {
+        get(_, prop) {
+            if (toolbox === undefined)
+                throw new helpful_errors_1.UnexpectedCodePathError('useThen: tried to access value before test ran');
+            return toolbox[prop];
+        },
+        ownKeys() {
+            return Reflect.ownKeys(drawer);
+        },
+        getOwnPropertyDescriptor(_, prop) {
+            return Object.getOwnPropertyDescriptor(drawer, prop);
+        },
+    };
+    // register the test via the provided then function (or modifier)
+    input.thenFn(input.desc, async () => {
+        toolbox = await input.fn();
+        // assign properties for Object.keys() support
+        Object.assign(drawer, toolbox);
+        // remove get trap once test completes
+        delete proxyHandler.get;
+    });
+    // return proxy
+    return new Proxy(drawer, proxyHandler);
+};
+/**
+ * .what = register a test and capture its return value for subsequent assertions
+ * .why = eliminates `let` declarations for sharing operation results between then blocks
+ */
+const useThen = (desc, fn) => createUseThenProxy({ desc, fn, thenFn: then });
+exports.useThen = useThen;
+// modifiers
+exports.useThen.only = (desc, fn) => createUseThenProxy({ desc, fn, thenFn: then.only });
+exports.useThen.skip = (desc, fn) => createUseThenProxy({ desc, fn, thenFn: then.skip });
+exports.useThen.skipIf =
+    (condition) => (desc, fn) => createUseThenProxy({ desc, fn, thenFn: then.skipIf(condition) });
+exports.useThen.runIf =
+    (condition) => (desc, fn) => createUseThenProxy({ desc, fn, thenFn: then.runIf(condition) });
+//# sourceMappingURL=useThen.js.map

package/dist/domain.operations/useThen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThen.js","sourceRoot":"","sources":["../../src/domain.operations/useThen.ts"],"names":[],"mappings":";;;AAAA,mDAAyD;AAEzD,mDAAsC;AAEtC,iFAAiF;AACjF,MAAM,EAAE,IAAI,EAAE,GAAG,mBAAG,CAAC;AAQrB;;;GAGG;AACH,MAAM,kBAAkB,GAAG,CAAgC,KAI1D,EAAK,EAAE;IACN,wEAAwE;IACxE,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,IAAI,OAAsB,CAAC;IAE3B,qDAAqD;IACrD,MAAM,YAAY,GAAsB;QACtC,GAAG,CAAC,CAAC,EAAE,IAAI;YACT,IAAI,OAAO,KAAK,SAAS;gBACvB,MAAM,IAAI,wCAAuB,CAC/B,gDAAgD,CACjD,CAAC;YACJ,OAAQ,OAAe,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,OAAO;YACL,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,wBAAwB,CAAC,CAAC,EAAE,IAAI;YAC9B,OAAO,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACvD,CAAC;KACF,CAAC;IAEF,iEAAiE;IACjE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;QAClC,OAAO,GAAG,MAAM,KAAK,CAAC,EAAE,EAAE,CAAC;QAE3B,8CAA8C;QAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAE/B,sCAAsC;QACtC,OAAO,YAAY,CAAC,GAAG,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE,YAAY,CAAM,CAAC;AAC9C,CAAC,CAAC;AAkCF;;;GAGG;AACI,MAAM,OAAO,GAAY,CAC9B,IAAY,EACZ,EAAwB,EACrB,EAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAH1C,QAAA,OAAO,WAGmC;AAEvD,YAAY;AACZ,eAAO,CAAC,IAAI,GAAG,CACb,IAAY,EACZ,EAAwB,EACrB,EAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAE5D,eAAO,CAAC,IAAI,GAAG,CACb,IAAY,EACZ,EAAwB,EACrB,EAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAE5D,eAAO,CAAC,MAAM;IACZ,CAAC,SAAkB,EAAE,EAAE,CACvB,CAAgC,IAAY,EAAE,EAAwB,EAAK,EAAE,CAC3E,kBAAkB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AAErE,eAAO,CAAC,KAAK;IACX,CAAC,SAAkB,EAAE,EAAE,CACvB,CAAgC,IAAY,EAAE,EAAwB,EAAK,EAAE,CAC3E,kBAAkB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC"}

package/dist/domain.operations/useWhen.d.ts

@@ -0,0 +1,18 @@
+/**
+ * .what = interface for useWhen with modifiers
+ * .why = enables useWhen.only, useWhen.skip, etc.
+ */
+interface UseWhen {
+    <T>(desc: string, fn: () => T): T;
+    only: <T>(desc: string, fn: () => T) => T;
+    skip: <T>(desc: string, fn: () => T) => T;
+    skipIf: (condition: boolean) => <T>(desc: string, fn: () => T) => T;
+    runIf: (condition: boolean) => <T>(desc: string, fn: () => T) => T;
+}
+/**
+ * .what = execute a fn synchronously and capture its return value for sibling blocks
+ * .why = enables sharing operation results across sequential blocks without let declarations
+ * .note = unlike useThen, does not create a test block - executes immediately during collection
+ */
+export declare const useWhen: UseWhen;
+export {};

package/dist/domain.operations/useWhen.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWhen = void 0;
+/**
+ * .what = helper to create useWhen pattern
+ * .why = executes fn synchronously and returns result (no describe wrapper)
+ * .note = does not create a nested when block due to vitest describe timing issues
+ */
+const createUseWhen = (input) => {
+    // skip mode returns undefined - the result won't be used in skipped tests
+    if (input.skip)
+        return undefined;
+    // execute synchronously and return
+    return input.fn();
+};
+/**
+ * .what = execute a fn synchronously and capture its return value for sibling blocks
+ * .why = enables sharing operation results across sequential blocks without let declarations
+ * .note = unlike useThen, does not create a test block - executes immediately during collection
+ */
+const useWhen = (desc, fn) => createUseWhen({ desc, fn });
+exports.useWhen = useWhen;
+// modifiers
+exports.useWhen.only = (desc, fn) => createUseWhen({ desc, fn }); // only has no special meaning for synchronous execution
+exports.useWhen.skip = (desc, fn) => createUseWhen({ desc, fn, skip: true });
+exports.useWhen.skipIf =
+    (condition) => (desc, fn) => createUseWhen({ desc, fn, skip: condition });
+exports.useWhen.runIf =
+    (condition) => (desc, fn) => createUseWhen({ desc, fn, skip: !condition });
+//# sourceMappingURL=useWhen.js.map

package/dist/domain.operations/useWhen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWhen.js","sourceRoot":"","sources":["../../src/domain.operations/useWhen.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAI,KAIzB,EAAK,EAAE;IACN,0EAA0E;IAC1E,IAAI,KAAK,CAAC,IAAI;QAAE,OAAO,SAAyB,CAAC;IAEjD,mCAAmC;IACnC,OAAO,KAAK,CAAC,EAAE,EAAE,CAAC;AACpB,CAAC,CAAC;AAkBF;;;;GAIG;AACI,MAAM,OAAO,GAAY,CAAI,IAAY,EAAE,EAAW,EAAK,EAAE,CAClE,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AADjB,QAAA,OAAO,WACU;AAE9B,YAAY;AACZ,eAAO,CAAC,IAAI,GAAG,CAAI,IAAY,EAAE,EAAW,EAAK,EAAE,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,wDAAwD;AAEzI,eAAO,CAAC,IAAI,GAAG,CAAI,IAAY,EAAE,EAAW,EAAK,EAAE,CACjD,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAE1C,eAAO,CAAC,MAAM;IACZ,CAAC,SAAkB,EAAE,EAAE,CACvB,CAAI,IAAY,EAAE,EAAW,EAAK,EAAE,CAClC,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AAEjD,eAAO,CAAC,KAAK;IACX,CAAC,SAAkB,EAAE,EAAE,CACvB,CAAI,IAAY,EAAE,EAAW,EAAK,EAAE,CAClC,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { given, when, then } from './givenWhenThen';
-export { genTestUuid } from './genTestUuid';
-export { usePrep, useBeforeAll, useBeforeEach } from './usePrep';
-export { getError } from 'helpful-errors';
+/**
+ * .what = package entry point for test-fns
+ * .why = re-exports from contract layer for public consumption
+ */
+export * from './contract';

package/dist/index.js

@@ -1,17 +1,22 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getError = exports.useBeforeEach = exports.useBeforeAll = exports.usePrep = exports.genTestUuid = exports.then = exports.when = exports.given = void 0;
-var givenWhenThen_1 = require("./givenWhenThen");
-Object.defineProperty(exports, "given", { enumerable: true, get: function () { return givenWhenThen_1.given; } });
-Object.defineProperty(exports, "when", { enumerable: true, get: function () { return givenWhenThen_1.when; } });
-Object.defineProperty(exports, "then", { enumerable: true, get: function () { return givenWhenThen_1.then; } });
-var genTestUuid_1 = require("./genTestUuid");
-Object.defineProperty(exports, "genTestUuid", { enumerable: true, get: function () { return genTestUuid_1.genTestUuid; } });
-var usePrep_1 = require("./usePrep");
-Object.defineProperty(exports, "usePrep", { enumerable: true, get: function () { return usePrep_1.usePrep; } });
-Object.defineProperty(exports, "useBeforeAll", { enumerable: true, get: function () { return usePrep_1.useBeforeAll; } });
-Object.defineProperty(exports, "useBeforeEach", { enumerable: true, get: function () { return usePrep_1.useBeforeEach; } });
-// forward the getError method since it is almost always needed with tests
-var helpful_errors_1 = require("helpful-errors");
-Object.defineProperty(exports, "getError", { enumerable: true, get: function () { return helpful_errors_1.getError; } });
+/**
+ * .what = package entry point for test-fns
+ * .why = re-exports from contract layer for public consumption
+ */
+__exportStar(require("./contract"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAAoD;AAA3C,sGAAA,KAAK,OAAA;AAAE,qGAAA,IAAI,OAAA;AAAE,qGAAA,IAAI,OAAA;AAC1B,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,qCAAiE;AAAxD,kGAAA,OAAO,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,wGAAA,aAAa,OAAA;AAE7C,0EAA0E;AAC1E,iDAA0C;AAAjC,0GAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,6CAA2B"}

package/dist/infra/isomorph.test/detectTestRunner.d.ts

@@ -0,0 +1,18 @@
+/**
+ * .what = the test runner currently executing the code
+ * .why = enables isomorphic behavior between vitest and jest
+ */
+export type TestRunner = 'vitest' | 'jest';
+/**
+ * .what = detects which test runner is currently executing
+ * .why = enables runtime selection of test framework apis
+ *
+ * .note = vitest is checked first as it's more specific
+ */
+export declare const detectTestRunner: () => TestRunner;
+export declare const getTestRunner: () => TestRunner;
+/**
+ * .what = resets the cached runner (for testing only)
+ * .why = allows tests to verify detection logic with different env states
+ */
+export declare const resetTestRunnerCache: () => void;