testeranto 0.62.0 → 0.73.0

package/dist/types/lib/abstractBase.d.ts

@@ -1,11 +1,12 @@
+import { IBaseTest } from "../Types";
 import { ITTestResourceConfiguration, ITestArtifactory, ITLog } from ".";
-import { IBaseTest, IUtils } from "../Types";
+import { PM } from "../PM/index.js";
 export declare type IGivens<ITestShape extends IBaseTest> = Record<string, BaseGiven<ITestShape>>;
 export declare abstract class BaseSuite<ITestShape extends IBaseTest> {
     name: string;
     givens: IGivens<ITestShape>;
     checks: BaseCheck<ITestShape>[];
-    store: ITestShape['istore'];
+    store: ITestShape["istore"];
     fails: BaseGiven<ITestShape>[];
     testResourceConfiguration: ITTestResourceConfiguration;
     index: number;
@@ -27,9 +28,10 @@ export declare abstract class BaseSuite<ITestShape extends IBaseTest> {
         }[];
         fails: BaseGiven<ITestShape>[];
     };
-    setup(s: ITestShape['iinput'], artifactory: ITestArtifactory, tr: ITTestResourceConfiguration, utils: IUtils): Promise<ITestShape['isubject']>;
-    assertThat(t: ITestShape['then']): unknown;
-    run(input: ITestShape['iinput'], testResourceConfiguration: ITTestResourceConfiguration, artifactory: (fPath: string, value: unknown) => void, tLog: (...string: any[]) => void, utils: IUtils): Promise<BaseSuite<ITestShape>>;
+    setup(s: ITestShape["iinput"], artifactory: ITestArtifactory, tr: ITTestResourceConfiguration, pm: PM): Promise<ITestShape["isubject"]>;
+    assertThat(t: ITestShape["then"]): unknown;
+    afterAll(store: ITestShape["istore"], artifactory: ITestArtifactory, pm: PM): ITestShape["istore"];
+    run(input: ITestShape["iinput"], testResourceConfiguration: ITTestResourceConfiguration, artifactory: (fPath: string, value: unknown) => void, tLog: (...string: any[]) => void, pm: PM): Promise<BaseSuite<ITestShape>>;
 }
 export declare abstract class BaseGiven<ITestShape extends IBaseTest> {
     name: string;
@@ -37,13 +39,13 @@ export declare abstract class BaseGiven<ITestShape extends IBaseTest> {
     whens: BaseWhen<ITestShape>[];
     thens: BaseThen<ITestShape>[];
     error: Error;
-    store: ITestShape['istore'];
+    fail: any;
+    store: ITestShape["istore"];
     recommendedFsPath: string;
-    givenCB: ITestShape['given'];
+    givenCB: ITestShape["given"];
     initialValues: any;
-    constructor(name: string, features: string[], whens: BaseWhen<ITestShape>[], thens: BaseThen<ITestShape>[], givenCB: ITestShape['given'], initialValues: any);
-    beforeAll(store: ITestShape['istore'], artifactory: ITestArtifactory): ITestShape["istore"];
-    afterAll(store: ITestShape['istore'], artifactory: ITestArtifactory, utils: IUtils): ITestShape["istore"];
+    constructor(name: string, features: string[], whens: BaseWhen<ITestShape>[], thens: BaseThen<ITestShape>[], givenCB: ITestShape["given"], initialValues: any);
+    beforeAll(store: ITestShape["istore"], artifactory: ITestArtifactory): ITestShape["istore"];
     toObj(): {
         name: string;
         whens: {
@@ -57,33 +59,33 @@ export declare abstract class BaseGiven<ITestShape extends IBaseTest> {
         error: (string | Error | undefined)[] | null;
         features: string[];
     };
-    abstract givenThat(subject: ITestShape['isubject'], testResourceConfiguration: any, artifactory: ITestArtifactory, givenCB: ITestShape['given']): Promise<ITestShape['istore']>;
-    afterEach(store: ITestShape['istore'], key: string, artifactory: ITestArtifactory): Promise<unknown>;
-    give(subject: ITestShape['isubject'], key: string, testResourceConfiguration: any, tester: any, artifactory: ITestArtifactory, tLog: ITLog, utils: IUtils): Promise<ITestShape["istore"]>;
+    abstract givenThat(subject: ITestShape["isubject"], testResourceConfiguration: any, artifactory: ITestArtifactory, givenCB: ITestShape["given"], pm: PM): Promise<ITestShape["istore"]>;
+    afterEach(store: ITestShape["istore"], key: string, artifactory: ITestArtifactory, pm: PM): Promise<unknown>;
+    give(subject: ITestShape["isubject"], key: string, testResourceConfiguration: any, tester: (t: Awaited<ITestShape["then"]> | undefined) => boolean, artifactory: ITestArtifactory, tLog: ITLog, pm: PM, suiteNdx: number): Promise<ITestShape["istore"]>;
 }
 export declare abstract class BaseWhen<ITestShape extends IBaseTest> {
     name: string;
-    whenCB: (x: ITestShape['iselection']) => ITestShape['then'];
+    whenCB: (x: ITestShape["iselection"]) => ITestShape["then"];
     error: boolean;
-    constructor(name: string, whenCB: (xyz: ITestShape['iselection']) => ITestShape['then']);
-    abstract andWhen(store: ITestShape['istore'], whenCB: (x: ITestShape['iselection']) => ITestShape['then'], testResource: any): any;
+    constructor(name: string, whenCB: (xyz: ITestShape["iselection"]) => ITestShape["then"]);
+    abstract andWhen(store: ITestShape["istore"], whenCB: (x: ITestShape["iselection"]) => ITestShape["then"], testResource: any, pm: PM): any;
     toObj(): {
         name: string;
         error: boolean;
     };
-    test(store: ITestShape['istore'], testResourceConfiguration: any, tLog: ITLog, utils: IUtils): Promise<any>;
+    test(store: ITestShape["istore"], testResourceConfiguration: any, tLog: ITLog, pm: PM, key: string): Promise<any>;
 }
 export declare abstract class BaseThen<ITestShape extends IBaseTest> {
     name: string;
-    thenCB: (storeState: ITestShape['iselection']) => ITestShape['then'];
+    thenCB: (storeState: ITestShape["iselection"]) => ITestShape["then"];
     error: boolean;
-    constructor(name: string, thenCB: (val: ITestShape['iselection']) => ITestShape['then']);
+    constructor(name: string, thenCB: (val: ITestShape["iselection"]) => ITestShape["then"]);
     toObj(): {
         name: string;
         error: boolean;
     };
-    abstract butThen(store: ITestShape['istore'], thenCB: any, testResourceConfiguration?: any): Promise<ITestShape['iselection']>;
-    test(store: ITestShape['istore'], testResourceConfiguration: any, tLog: ITLog, utils: IUtils): Promise<ITestShape['then'] | undefined>;
+    abstract butThen(store: ITestShape["istore"], thenCB: any, testResourceConfiguration?: any): Promise<ITestShape["iselection"]>;
+    test(store: ITestShape["istore"], testResourceConfiguration: any, tLog: ITLog, pm: PM): Promise<ITestShape["then"] | undefined>;
 }
 export declare abstract class BaseCheck<ITestShape extends IBaseTest> {
     name: string;
@@ -96,7 +98,7 @@ export declare abstract class BaseCheck<ITestShape extends IBaseTest> {
         [K in keyof ITestShape["thens"]]: (p: any, tc: any) => BaseThen<ITestShape>;
     };
     constructor(name: string, features: string[], checkCB: (whens: any, thens: any) => any, whens: any, thens: any);
-    abstract checkThat(subject: ITestShape['isubject'], testResourceConfiguration: any, artifactory: ITestArtifactory): Promise<ITestShape['istore']>;
-    afterEach(store: ITestShape['istore'], key: string, cb?: any): Promise<unknown>;
-    check(subject: ITestShape['isubject'], key: string, testResourceConfiguration: any, tester: any, artifactory: ITestArtifactory, tLog: ITLog, utils: IUtils): Promise<void>;
+    abstract checkThat(subject: ITestShape["isubject"], testResourceConfiguration: any, artifactory: ITestArtifactory): Promise<ITestShape["istore"]>;
+    afterEach(store: ITestShape["istore"], key: string, cb: any, pm: PM): Promise<unknown>;
+    check(subject: ITestShape["isubject"], key: string, testResourceConfiguration: any, tester: any, artifactory: ITestArtifactory, tLog: ITLog, pm: PM): Promise<void>;
 }

package/dist/types/lib/basebuilder.d.ts

@@ -1,10 +1,12 @@
-import { IBaseTest, ICheckKlasser, IGivenKlasser, ISuiteKlasser, ITestSpecification, IThenKlasser, IWhenKlasser } from "../Types";
+import { ITTestResourceRequest, ITestJob } from ".";
+import { IBaseTest, ITestSpecification } from "../Types.js";
+import { ISuiteKlasser, IGivenKlasser, IWhenKlasser, IThenKlasser, ICheckKlasser } from "./types.js";
 import { BaseCheck, BaseWhen, BaseThen, BaseGiven } from "./abstractBase.js";
-import { ITTestResourceRequest, ITestJob, ILogWriter } from ".";
+import { PM } from "../PM/index.js";
 export declare abstract class BaseBuilder<ITestShape extends IBaseTest, SuiteExtensions, GivenExtensions, WhenExtensions, ThenExtensions, CheckExtensions> {
-    readonly input: ITestShape['iinput'];
+    readonly input: ITestShape["iinput"];
     specs: any;
-    assertThis: (t: any) => {};
+    assertThis: (t: ITestShape["then"]) => {};
     testResourceRequirement: ITTestResourceRequest;
     artifacts: Promise<unknown>[];
     testJobs: ITestJob[];
@@ -14,11 +16,12 @@ export declare abstract class BaseBuilder<ITestShape extends IBaseTest, SuiteExt
     whenOverides: Record<keyof WhenExtensions, IWhenKlasser<ITestShape>>;
     thenOverides: Record<keyof ThenExtensions, IThenKlasser<ITestShape>>;
     checkOverides: Record<keyof CheckExtensions, ICheckKlasser<ITestShape>>;
-    constructor(input: ITestShape['iinput'], suitesOverrides: Record<keyof SuiteExtensions, ISuiteKlasser<ITestShape>>, givenOverides: Record<keyof GivenExtensions, IGivenKlasser<ITestShape>>, whenOverides: Record<keyof WhenExtensions, IWhenKlasser<ITestShape>>, thenOverides: Record<keyof ThenExtensions, IThenKlasser<ITestShape>>, checkOverides: Record<keyof CheckExtensions, ICheckKlasser<ITestShape>>, logWriter: ILogWriter, testResourceRequirement: ITTestResourceRequest, testSpecification: any);
+    puppetMaster: PM;
+    constructor(input: ITestShape["iinput"], suitesOverrides: Record<keyof SuiteExtensions, ISuiteKlasser<ITestShape>>, givenOverides: Record<keyof GivenExtensions, IGivenKlasser<ITestShape>>, whenOverides: Record<keyof WhenExtensions, IWhenKlasser<ITestShape>>, thenOverides: Record<keyof ThenExtensions, IThenKlasser<ITestShape>>, checkOverides: Record<keyof CheckExtensions, ICheckKlasser<ITestShape>>, testResourceRequirement: ITTestResourceRequest, testSpecification: any);
     Specs(): any;
     Suites(): Record<keyof SuiteExtensions, ISuiteKlasser<ITestShape>>;
     Given(): Record<keyof GivenExtensions, (name: string, features: string[], whens: BaseWhen<ITestShape>[], thens: BaseThen<ITestShape>[], gcb: any) => BaseGiven<ITestShape>>;
-    When(): Record<keyof WhenExtensions, (arg0: ITestShape['istore'], ...arg1: any) => BaseWhen<ITestShape>>;
-    Then(): Record<keyof ThenExtensions, (selection: ITestShape['iselection'], expectation: any) => BaseThen<ITestShape>>;
+    When(): Record<keyof WhenExtensions, (arg0: ITestShape["istore"], ...arg1: any) => BaseWhen<ITestShape>>;
+    Then(): Record<keyof ThenExtensions, (selection: ITestShape["iselection"], expectation: any) => BaseThen<ITestShape>>;
     Check(): Record<keyof CheckExtensions, (feature: string, callback: (whens: any, thens: any) => any, whens: any, thens: any, x: any) => BaseCheck<ITestShape>>;
 }

package/dist/types/lib/classBuilder.d.ts

@@ -1,6 +1,7 @@
-import type { IBaseTest, ICheckKlasser, IGivenKlasser, ISuiteKlasser, ITestImplementation, ITestSpecification, IThenKlasser, IWhenKlasser } from "../Types";
+import { IBaseTest, ITestImplementation, ITestSpecification } from "../Types.js";
 import { BaseBuilder } from "./basebuilder.js";
-import { ILogWriter, ITTestResourceRequest } from ".";
+import { ISuiteKlasser, IGivenKlasser, IWhenKlasser, IThenKlasser, ICheckKlasser } from "./types.js";
+import { ITTestResourceRequest } from "./index.js";
 export declare abstract class ClassBuilder<ITestShape extends IBaseTest> extends BaseBuilder<ITestShape, any, any, any, any, any> {
-    constructor(testImplementation: ITestImplementation<ITestShape, any>, testSpecification: ITestSpecification<ITestShape>, input: ITestShape['iinput'], suiteKlasser: ISuiteKlasser<ITestShape>, givenKlasser: IGivenKlasser<ITestShape>, whenKlasser: IWhenKlasser<ITestShape>, thenKlasser: IThenKlasser<ITestShape>, checkKlasser: ICheckKlasser<ITestShape>, testResourceRequirement: ITTestResourceRequest, logWriter: ILogWriter);
+    constructor(testImplementation: ITestImplementation<ITestShape, any>, testSpecification: ITestSpecification<ITestShape>, input: ITestShape["iinput"], suiteKlasser: ISuiteKlasser<ITestShape>, givenKlasser: IGivenKlasser<ITestShape>, whenKlasser: IWhenKlasser<ITestShape>, thenKlasser: IThenKlasser<ITestShape>, checkKlasser: ICheckKlasser<ITestShape>, testResourceRequirement: ITTestResourceRequest);
 }

package/dist/types/lib/core.d.ts

@@ -1,7 +1,8 @@
-import type { IBaseTest, ITestImplementation, ITestInterface, ITestSpecification, IUtils } from "../Types";
-import { ILogWriter, ITTestResourceConfiguration, ITTestResourceRequest, ITestJob } from "./index.js";
+import { IBaseTest, ITestSpecification, ITestImplementation } from "../Types.js";
+import { ITestInterface } from "./types.js";
+import { ITTestResourceRequest } from "./index.js";
 import { ClassBuilder } from "./classBuilder.js";
 export default abstract class Testeranto<ITestShape extends IBaseTest> extends ClassBuilder<ITestShape> {
-    constructor(input: ITestShape['iinput'], testSpecification: ITestSpecification<ITestShape>, testImplementation: ITestImplementation<ITestShape, object>, testResourceRequirement: ITTestResourceRequest | undefined, logWriter: ILogWriter, testInterface: Partial<ITestInterface<ITestShape>>);
-    abstract receiveTestResourceConfig(t: ITestJob, partialTestResource: ITTestResourceConfiguration, utils: IUtils): any;
+    constructor(input: ITestShape["iinput"], testSpecification: ITestSpecification<ITestShape>, testImplementation: ITestImplementation<ITestShape>, testResourceRequirement: ITTestResourceRequest | undefined, testInterface: Partial<ITestInterface<ITestShape>>);
+    abstract receiveTestResourceConfig(partialTestResource: string): any;
 }

package/dist/types/lib/index.d.ts

@@ -1,12 +1,14 @@
-import { IBaseTest, ITestInterface, IUtils } from "../Types.js";
+import { PM } from "../PM/index.js";
+import { IBaseTest } from "../Types.js";
 import { IGivens, BaseCheck, BaseSuite, BaseWhen, BaseThen } from "./abstractBase.js";
+import { ITestInterface } from "./types.js";
 export declare const BaseTestInterface: ITestInterface<IBaseTest>;
 export declare const DefaultTestInterface: (p: Partial<ITestInterface<any>>) => ITestInterface<any>;
 export declare type ITTestResourceConfiguration = {
     name: string;
     fs: string;
     ports: number[];
-    scheduled: boolean;
+    browserWSEndpoint: string;
 };
 export declare type ITTestResourceRequirement = {
     name: string;
@@ -20,7 +22,7 @@ export declare type ITLog = (...string: any[]) => void;
 export declare type ILogWriter = {
     createWriteStream: (line: string) => any | any;
     writeFileSync: (fp: string, contents: string) => any;
-    mkdirSync: (fp: string) => any;
+    mkdirSync: () => any;
     testArtiFactoryfileWriter: (tLog: ITLog, n: (Promise: any) => void) => (fPath: string, value: unknown) => void;
 };
 export declare type ITestArtificer = (key: string, data: any) => void;
@@ -31,12 +33,12 @@ declare type ITest = {
     checks: BaseCheck<IBaseTest>[];
     testResourceConfiguration: ITTestResourceConfiguration;
 };
-export declare type ITestJob = {
+export declare type ITestJob<T = PM> = {
     toObj(): object;
     test: ITest;
     runner: (x: ITTestResourceConfiguration, t: ITLog) => Promise<BaseSuite<IBaseTest>>;
     testResourceRequirement: ITTestResourceRequirement;
-    receiveTestResourceConfig: (testResource: any, utils: IUtils) => Promise<{
+    receiveTestResourceConfig: (pm: PM) => Promise<{
         failed: number;
         artifacts: Promise<unknown>[];
         logPromise: Promise<unknown>;

package/dist/types/lib/types.d.ts

@@ -0,0 +1,62 @@
+import { IBaseTest } from "../Types";
+import { IGivens, BaseCheck, BaseSuite, BaseGiven, BaseWhen, BaseThen } from "./abstractBase";
+import { ITTestResourceConfiguration, ITestArtificer } from ".";
+import { PM } from "../PM/index";
+export declare type IRunTime = `node` | `web`;
+export declare type ITestTypes = [string, IRunTime, {
+    ports: number;
+}, ITestTypes[]];
+export declare type IJsonConfig = {
+    outdir: string;
+    tests: ITestTypes[];
+    features: string;
+};
+export declare type IBaseConfig = {
+    clearScreen: boolean;
+    debugger: boolean;
+    devMode: boolean;
+    externals: string[];
+    features: string;
+    minify: boolean;
+    nodePlugins: any[];
+    outbase: string;
+    outdir: string;
+    ports: string[];
+    tests: ITestTypes[];
+    webPlugins: any[];
+};
+export declare type IBuiltConfig = {
+    buildDir: string;
+} & IBaseConfig;
+export declare type IWebTestInterface<ITestShape extends IBaseTest> = {
+    assertThis: (x: ITestShape["then"]) => void;
+    andWhen: (store: ITestShape["istore"], whenCB: ITestShape["when"], testResource: ITTestResourceConfiguration) => Promise<ITestShape["istore"]>;
+    butThen: (store: ITestShape["istore"], thenCB: any, testResource: ITTestResourceConfiguration) => Promise<ITestShape["iselection"]>;
+    afterAll: (store: ITestShape["istore"], artificer: ITestArtificer, utils: PM) => any;
+    afterEach: (store: ITestShape["istore"], key: string, artificer: ITestArtificer, utils: PM) => Promise<unknown>;
+    beforeAll: (input: ITestShape["iinput"], testResource: ITTestResourceConfiguration, artificer: ITestArtificer, utils: PM) => Promise<ITestShape["isubject"]>;
+    beforeEach: (subject: ITestShape["isubject"], initializer: (c?: any) => ITestShape["given"], artificer: ITestArtificer, testResource: ITTestResourceConfiguration, initialValues: any, utils: PM) => Promise<ITestShape["istore"]>;
+};
+export declare type INodeTestInterface<ITestShape extends IBaseTest> = {
+    assertThis: (x: ITestShape["then"]) => void;
+    andWhen: (store: ITestShape["istore"], whenCB: ITestShape["when"], testResource: ITTestResourceConfiguration) => Promise<ITestShape["istore"]>;
+    butThen: (store: ITestShape["istore"], thenCB: any, testResource: ITTestResourceConfiguration) => Promise<ITestShape["iselection"]>;
+    afterAll: (store: ITestShape["istore"], artificer: ITestArtificer, pm: PM) => any;
+    afterEach: (store: ITestShape["istore"], key: string, artificer: ITestArtificer, pm: PM) => Promise<unknown>;
+    beforeAll: (input: ITestShape["iinput"], testResource: ITTestResourceConfiguration, artificer: ITestArtificer, pm: PM) => Promise<ITestShape["isubject"]>;
+    beforeEach: (subject: ITestShape["isubject"], initializer: (c?: any) => ITestShape["given"], artificer: ITestArtificer, testResource: ITTestResourceConfiguration, initialValues: any) => Promise<ITestShape["istore"]>;
+};
+export declare type ITestInterface<ITestShape extends IBaseTest> = {
+    assertThis: (x: ITestShape["then"]) => void;
+    andWhen: (store: ITestShape["istore"], whenCB: ITestShape["when"], testResource: ITTestResourceConfiguration, pm: PM) => Promise<ITestShape["istore"]>;
+    butThen: (store: ITestShape["istore"], thenCB: any, testResource: ITTestResourceConfiguration) => Promise<ITestShape["iselection"]>;
+    afterAll: (store: ITestShape["istore"], artificer: ITestArtificer, pm: PM) => any;
+    afterEach: (store: ITestShape["istore"], key: string, artificer: ITestArtificer, pm: PM) => Promise<unknown>;
+    beforeAll: (input: ITestShape["iinput"], testResource: ITTestResourceConfiguration, artificer: ITestArtificer, pm: PM) => Promise<ITestShape["isubject"]>;
+    beforeEach: (subject: ITestShape["isubject"], initializer: (c?: any) => ITestShape["given"], artificer: ITestArtificer, testResource: ITTestResourceConfiguration, initialValues: any, pm: PM) => Promise<ITestShape["istore"]>;
+};
+export declare type ISuiteKlasser<ITestShape extends IBaseTest> = (name: string, index: number, givens: IGivens<ITestShape>, checks: BaseCheck<ITestShape>[]) => BaseSuite<ITestShape>;
+export declare type IGivenKlasser<ITestShape extends IBaseTest> = (name: any, features: any, whens: any, thens: any, givenCB: any) => BaseGiven<ITestShape>;
+export declare type IWhenKlasser<ITestShape extends IBaseTest> = (s: any, o: any) => BaseWhen<ITestShape>;
+export declare type IThenKlasser<ITestShape extends IBaseTest> = (s: any, o: any) => BaseThen<ITestShape>;
+export declare type ICheckKlasser<ITestShape extends IBaseTest> = (n: any, f: any, cb: any, w: any, t: any) => BaseCheck<ITestShape>;

package/dist/types/preload.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/puppeteerConfiger.d.ts

@@ -0,0 +1,4 @@
+declare const _default: (port: string) => Promise<{
+    webSocketDebuggerUrl: string;
+}>;
+export default _default;