testeranto 0.81.3 → 0.84.0

package/dist/types/src/Node.d.ts

@@ -1,6 +1,10 @@
 import Testeranto from "./lib/core.js";
 import { ITTestResourceRequest } from "./lib/index.js";
 import type { IBaseTest, ITestImplementation, ITestSpecification } from "./Types.js";
-import { INodeTestInterface } from "./lib/types.js";
+import { ITestInterface, INodeTestInterface } from "./lib/types.js";
+export declare class NodeTesteranto<TestShape extends IBaseTest<unknown, unknown, unknown, unknown, unknown, unknown, unknown, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>>> extends Testeranto<TestShape> {
+    constructor(input: TestShape["iinput"], testSpecification: ITestSpecification<TestShape>, testImplementation: ITestImplementation<TestShape>, testResourceRequirement: ITTestResourceRequest, testInterface: Partial<ITestInterface<TestShape>>);
+    receiveTestResourceConfig(partialTestResource: string): Promise<string[]>;
+}
 declare const _default: <ITestShape extends IBaseTest<unknown, unknown, unknown, unknown, unknown, unknown, unknown, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>>>(input: ITestShape["iinput"], testSpecification: ITestSpecification<ITestShape>, testImplementation: ITestImplementation<ITestShape, object>, testInterface: Partial<INodeTestInterface<ITestShape>>, testResourceRequirement?: ITTestResourceRequest) => Promise<Testeranto<ITestShape>>;
 export default _default;

package/dist/types/src/PM/index.d.ts

@@ -1,10 +1,7 @@
-import { Browser, Page } from "puppeteer-core/lib/esm/puppeteer/puppeteer-core-browser";
 import { ITLog, ITTestResourceConfiguration } from "../lib";
 export declare abstract class PM {
     server: any;
-    browser: Browser;
     testResourceConfiguration: ITTestResourceConfiguration;
-    abstract startPuppeteer(options: any, destfolder: string): Promise<Browser>;
     abstract testArtiFactoryfileWriter(tLog: ITLog, callback: (Promise: any) => void): any;
     abstract createWriteStream(filepath: string): any;
     abstract writeFileSync(fp: string, contents: string): any;
@@ -16,5 +13,14 @@ export declare abstract class PM {
     abstract end(accessObject: {
         uid: number;
     }): boolean;
-    abstract customScreenShot(opts: object, page: Page): any;
+    abstract customScreenShot(opts: object): any;
+    abstract screencast(opts: object): any;
+    abstract page(): string | undefined;
+    abstract click(selector: string): any;
+    abstract focusOn(selector: string): any;
+    abstract typeInto(value: string): any;
+    abstract getValue(value: string): any;
+    abstract getAttribute(selector: string, attribute: string): any;
+    abstract isDisabled(selector: string): boolean;
+    abstract $(selector: string): any;
 }

package/dist/types/src/PM/main.d.ts

@@ -2,27 +2,22 @@
 /// <reference types="node" />
 /// <reference types="node" />
 import fs from "fs";
+import { Browser } from "puppeteer-core";
 import { PassThrough } from "stream";
 import { IBuiltConfig, ITestTypes } from "../lib/types";
 import { PM } from "./index.js";
 import { ITLog } from "../lib/index.js";
 export declare class PM_Main extends PM {
+    browser: Browser;
     shutdownMode: boolean;
     configs: IBuiltConfig;
     ports: Record<number, boolean>;
     queue: any[];
     registry: Record<string, boolean>;
     constructor(configs: IBuiltConfig);
-    shutDown(): void;
+    $(selector: string): boolean;
+    screencast(opts: object): void;
     customScreenShot(opts: object): void;
-    startPuppeteer(options: any, destfolder: string): Promise<any>;
-    checkForShutdown: () => void;
-    register: (src: string) => void;
-    deregister: (src: string) => void;
-    launchNode: (src: string, dest: string) => Promise<void>;
-    launchWebSideCar: (src: string, dest: string, testConfig: ITestTypes) => Promise<unknown>;
-    launchNodeSideCar: (src: string, dest: string, testConfig: ITestTypes) => Promise<void>;
-    launchWeb: (t: string, dest: string, sidecars: ITestTypes[]) => void;
     end(accessObject: {
         uid: number;
     }): boolean;
@@ -34,4 +29,21 @@ export declare class PM_Main extends PM {
     write(accessObject: {
         uid: number;
     }, contents: string): boolean;
+    page(): string | undefined;
+    click(selector: string): string | undefined;
+    focusOn(selector: string): void;
+    typeInto(value: string): void;
+    getValue(value: string): void;
+    getAttribute(selector: string, attribute: string): void;
+    isDisabled(selector: string): boolean;
+    startPuppeteer(options: any, destfolder: string): Promise<any>;
+    shutDown(): void;
+    checkForShutdown: () => void;
+    register: (src: string) => void;
+    deregister: (src: string) => void;
+    launchNode: (src: string, dest: string) => Promise<void>;
+    launchWebSideCar: (src: string, dest: string, testConfig: ITestTypes) => Promise<unknown>;
+    launchNodeSideCar: (src: string, dest: string, testConfig: ITestTypes) => Promise<void>;
+    launchWeb: (t: string, dest: string, sidecars: ITestTypes[]) => void;
+    receiveFeatures: (features: string[], destFolder: string) => void;
 }

package/dist/types/src/PM/node.d.ts

@@ -3,13 +3,21 @@
 import { PassThrough } from "stream";
 import { ITLog, ITTestResourceConfiguration } from "../lib";
 import { PM } from "./index.js";
-import { Page } from "puppeteer-core/lib/esm/puppeteer";
 declare type PuppetMasterServer = Record<string, Promise<any>>;
 export declare class PM_Node extends PM {
     server: PuppetMasterServer;
     testResourceConfiguration: ITTestResourceConfiguration;
     constructor(t: ITTestResourceConfiguration);
-    customScreenShot(opts: object, page: Page): any;
+    $(selector: string): boolean;
+    screencast(opts: object): void;
+    isDisabled(selector: string): boolean;
+    getAttribute(selector: string, attribute: string): void;
+    getValue(selector: string): void;
+    focusOn(selector: string): void;
+    typeInto(value: string): void;
+    page(): any;
+    click(selector: string): string | undefined;
+    customScreenShot(opts: object): any;
     existsSync(destFolder: string): boolean;
     mkdirSync(): any;
     write(writeObject: {
@@ -22,6 +30,6 @@ export declare class PM_Node extends PM {
     }): any;
     customclose(): void;
     testArtiFactoryfileWriter(tLog: ITLog, callback: (Promise: any) => void): (fPath: any, value: string | Buffer | PassThrough) => void;
-    startPuppeteer(options?: any): Promise<any>;
+    startPuppeteer(options?: any): any;
 }
 export {};

package/dist/types/src/PM/web.d.ts

@@ -3,11 +3,21 @@
 import { PassThrough } from "stream";
 import { ITLog, ITTestResourceConfiguration } from "../lib";
 import { PM } from "./index.js";
+import { ScreenshotOptions } from "puppeteer-core";
 declare type PuppetMasterServer = Record<string, Promise<any>>;
 export declare class PM_Web extends PM {
     server: PuppetMasterServer;
     constructor(t: ITTestResourceConfiguration);
-    customScreenShot(opts: object): void;
+    $(selector: string): boolean;
+    screencast(opts: object): void;
+    isDisabled(selector: string): boolean;
+    getAttribute(selector: string, attribute: string): any;
+    getValue(selector: string): any;
+    focusOn(selector: string): any;
+    typeInto(value: string): any;
+    page(): string | undefined;
+    click(selector: string): any;
+    customScreenShot(opts: ScreenshotOptions): any;
     existsSync(destFolder: string): boolean;
     mkdirSync(): any;
     write(writeObject: {
@@ -20,6 +30,5 @@ export declare class PM_Web extends PM {
     }): any;
     customclose(): void;
     testArtiFactoryfileWriter(tLog: ITLog, callback: (Promise: any) => void): (fPath: any, value: string | Buffer | PassThrough) => void;
-    startPuppeteer(options: any, destFolder: string): Promise<any>;
 }
 export {};

package/dist/types/src/SubPackages/react-dom/jsx/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 export declare type IInput = (props?: any) => JSX.Element;
 export declare type IState = unknown;
 export declare type ISelection = HTMLElement;

package/dist/types/src/SubPackages/react-test-renderer/jsx/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import renderer from "react-test-renderer";
 import { IBaseTest, ITestImplementation, ITestSpecification } from "../../../Types";
 export declare type IWhenShape = any;

package/dist/types/src/SubPackages/react-test-renderer/jsx-promised/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import renderer from "react-test-renderer";
 import { IBaseTest, ITestImplementation, ITestSpecification } from "../../../Types";
 export declare type IWhenShape = any;

package/dist/types/src/Types.d.ts

@@ -24,10 +24,10 @@ export declare type ITestImplementation<ITestShape extends IBaseTest<unknown, un
         [K in keyof ITestShape["givens"]]: (...Ig: ITestShape["givens"][K]) => ITestShape["given"];
     };
     whens: {
-        [K in keyof ITestShape["whens"]]: (...Iw: ITestShape["whens"][K]) => (zel: ITestShape["iselection"], utils: PM) => ITestShape["when"];
+        [K in keyof ITestShape["whens"]]: (...Iw: ITestShape["whens"][K]) => (zel: ITestShape["iselection"], utils: PM) => Promise<ITestShape["when"]>;
     };
     thens: {
-        [K in keyof ITestShape["thens"]]: (...It: ITestShape["thens"][K]) => (ssel: ITestShape["iselection"]) => ITestShape["then"];
+        [K in keyof ITestShape["thens"]]: (...It: ITestShape["thens"][K]) => (ssel: ITestShape["iselection"], utils: PM) => ITestShape["then"];
     };
     checks: {
         [K in keyof ITestShape["checks"]]: (...Ic: ITestShape["checks"][K]) => ITestShape["given"];

package/dist/types/src/Web.d.ts

@@ -1,6 +1,10 @@
 import type { IBaseTest, ITestImplementation, ITestSpecification } from "./Types";
 import Testeranto from "./lib/core.js";
 import { ITTestResourceRequest } from "./lib/index.js";
-import { IWebTestInterface } from "./lib/types";
+import { ITestInterface, IWebTestInterface } from "./lib/types";
+export declare class WebTesteranto<TestShape extends IBaseTest<unknown, unknown, unknown, unknown, unknown, unknown, unknown, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>>> extends Testeranto<TestShape> {
+    constructor(input: TestShape["iinput"], testSpecification: ITestSpecification<TestShape>, testImplementation: ITestImplementation<TestShape>, testResourceRequirement: ITTestResourceRequest, testInterface: Partial<ITestInterface<TestShape>>);
+    receiveTestResourceConfig(partialTestResource: any): Promise<string[]>;
+}
 declare const _default: <ITestShape extends IBaseTest<unknown, unknown, unknown, unknown, unknown, unknown, unknown, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>>>(input: ITestShape["iinput"], testSpecification: ITestSpecification<ITestShape>, testImplementation: ITestImplementation<ITestShape, object>, testInterface: Partial<IWebTestInterface<ITestShape>>, testResourceRequirement?: ITTestResourceRequest) => Promise<Testeranto<ITestShape>>;
 export default _default;

package/dist/types/src/esbuildConfigs/featuresPlugin.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    name: string;
+    setup(build: any): void;
+};
+export default _default;

package/dist/types/src/esbuildConfigs/inputFilesPlugin.d.ts

@@ -1,5 +1,7 @@
+import type { Plugin } from "esbuild";
+declare const register: (entrypoint: string, sources: string[]) => void;
 declare const _default: (platform: "web" | "node", entryPoints: Set<string> | string[]) => {
-    name: string;
-    setup(build: any): void;
+    register: (entrypoint: string, sources: string[]) => void;
+    inputFilesPluginFactory: Plugin;
 };
 export default _default;

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

@@ -11,6 +11,7 @@ export declare abstract class BaseSuite<ITestShape extends IBaseTest<unknown, un
     testResourceConfiguration: ITTestResourceConfiguration;
     index: number;
     constructor(name: string, index: number, givens?: IGivens<ITestShape>, checks?: BaseCheck<ITestShape>[]);
+    features(): string[];
     toObj(): {
         name: string;
         givens: {
@@ -27,7 +28,7 @@ export declare abstract class BaseSuite<ITestShape extends IBaseTest<unknown, un
             features: string[];
         }[];
         fails: BaseGiven<ITestShape>[];
-        features: {};
+        features: string[];
     };
     setup(s: ITestShape["iinput"], artifactory: ITestArtifactory, tr: ITTestResourceConfiguration, pm: PM): Promise<ITestShape["isubject"]>;
     assertThat(t: ITestShape["then"]): unknown;
@@ -62,19 +63,19 @@ export declare abstract class BaseGiven<ITestShape extends IBaseTest<unknown, un
     };
     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"]>;
+    give(subject: ITestShape["isubject"], key: string, testResourceConfiguration: ITTestResourceConfiguration, 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"];
     error: boolean;
     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;
+    abstract andWhen(store: ITestShape["istore"], whenCB: (x: ITestShape["iselection"]) => ITestShape["then"], testResource: any, pm: PM): Promise<any>;
     toObj(): {
         name: string;
         error: boolean;
     };
-    test(store: ITestShape["istore"], testResourceConfiguration: any, tLog: ITLog, pm: PM, key: string): Promise<any>;
+    test(store: ITestShape["istore"], testResourceConfiguration: any, tLog: ITLog, pm: PM, filepath: string): Promise<any>;
 }
 export declare abstract class BaseThen<ITestShape extends IBaseTest<unknown, unknown, unknown, unknown, unknown, unknown, unknown, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>>> {
     name: string;

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

@@ -4,5 +4,5 @@ import { ITTestResourceRequest } from "./index.js";
 import { ClassBuilder } from "./classBuilder.js";
 export default abstract class Testeranto<ITestShape extends IBaseTest<unknown, unknown, unknown, unknown, unknown, unknown, unknown, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>>> extends ClassBuilder<ITestShape> {
     constructor(input: ITestShape["iinput"], testSpecification: ITestSpecification<ITestShape>, testImplementation: ITestImplementation<ITestShape>, testResourceRequirement: ITTestResourceRequest | undefined, testInterface: Partial<ITestInterface<ITestShape>>);
-    abstract receiveTestResourceConfig(partialTestResource: string): any;
+    abstract receiveTestResourceConfig(partialTestResource: string): Promise<string[]>;
 }

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

@@ -42,6 +42,7 @@ export declare type ITestJob<T = PM> = {
         failed: number;
         artifacts: Promise<unknown>[];
         logPromise: Promise<unknown>;
+        features: string[];
     }>;
 };
 export declare type ITestResults = Promise<{

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

@@ -1,4 +1,5 @@
 import { IBaseTest } from "../Types";
+import type { Plugin } from "esbuild";
 import { IGivens, BaseCheck, BaseSuite, BaseGiven, BaseWhen, BaseThen } from "./abstractBase";
 import { ITTestResourceConfiguration, ITestArtificer } from ".";
 import { PM } from "../PM/index";
@@ -11,19 +12,20 @@ export declare type IJsonConfig = {
     tests: ITestTypes[];
     botEmail: string;
 };
+export declare type IPlugin = (register: (entrypoint: any, sources: any) => any, entrypoints: any) => Plugin;
 export declare type IBaseConfig = {
     clearScreen: boolean;
     debugger: boolean;
     devMode: boolean;
     externals: string[];
     minify: boolean;
-    nodePlugins: any[];
     outbase: string;
     outdir: string;
     ports: string[];
     tests: ITestTypes[];
-    webPlugins: any[];
-    botEmail: string;
+    nodePlugins: IPlugin[];
+    webPlugins: IPlugin[];
+    featureIngestor: (s: string) => Promise<string>;
 };
 export declare type IBuiltConfig = {
     buildDir: string;
@@ -31,7 +33,7 @@ export declare type IBuiltConfig = {
 export declare type IWebTestInterface<ITestShape extends IBaseTest<unknown, unknown, unknown, unknown, unknown, unknown, unknown, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>>> = {
     assertThis: (x: ITestShape["then"]) => void;
     andWhen: (store: ITestShape["istore"], whenCB: ITestShape["when"], testResource: ITTestResourceConfiguration, utils: PM) => Promise<ITestShape["istore"]>;
-    butThen: (store: ITestShape["istore"], thenCB: any, testResource: ITTestResourceConfiguration) => Promise<ITestShape["iselection"]>;
+    butThen: (store: ITestShape["istore"], thenCB: any, testResource: ITTestResourceConfiguration, utils: PM) => 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"]>;
@@ -53,7 +55,7 @@ export declare type ITestInterface<ITestShape extends IBaseTest<unknown, unknown
     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"]>;
+    beforeEach: (subject: ITestShape["isubject"], initializer: (c?: any) => ITestShape["given"], testResource: ITTestResourceConfiguration, initialValues: any, pm: PM) => Promise<ITestShape["istore"]>;
 };
 export declare type ISuiteKlasser<ITestShape extends IBaseTest<unknown, unknown, unknown, unknown, unknown, unknown, unknown, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>>> = (name: string, index: number, givens: IGivens<ITestShape>, checks: BaseCheck<ITestShape>[]) => BaseSuite<ITestShape>;
 export declare type IGivenKlasser<ITestShape extends IBaseTest<unknown, unknown, unknown, unknown, unknown, unknown, unknown, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>, Record<string, any>>> = (name: any, features: any, whens: any, thens: any, givenCB: any) => BaseGiven<ITestShape>;