@grest-ts/testkit 0.0.6 → 0.0.8

package/src/testers/GGTestComponent.ts

@@ -1,16 +1,16 @@
-import type {GGTestRunner} from "../GGTestRunner";
-
-/**
- * Interface for test components that can be registered with GGTestRunner.
- * Components must accept GGTestRunner as their constructor argument.
- */
-export interface GGTestComponent {
-    start?(): Promise<void>;
-    afterEach?(): Promise<void>;
-    teardown?(): Promise<void>;
-}
-
-/**
- * Constructor type for components. All components must accept GGTestRunner as constructor argument.
- */
-export type GGTestComponentType<T extends GGTestComponent> = new (runner: GGTestRunner) => T;
+import type {GGTestRunner} from "../GGTestRunner";
+
+/**
+ * Interface for test components that can be registered with GGTestRunner.
+ * Components must accept GGTestRunner as their constructor argument.
+ */
+export interface GGTestComponent {
+    start?(): Promise<void>;
+    afterEach?(): Promise<void>;
+    teardown?(): Promise<void>;
+}
+
+/**
+ * Constructor type for components. All components must accept GGTestRunner as constructor argument.
+ */
+export type GGTestComponentType<T extends GGTestComponent> = new (runner: GGTestRunner) => T;

package/src/testers/GGTestSelector.ts

@@ -1,223 +1,223 @@
-import {RuntimeConstructor, RuntimeResult, Selector, SelectorExtensions, ObjectResult, StartResult, RuntimeInput} from "./RuntimeSelector";
-import {GGTestRuntime} from "../GGTestRuntime";
-import type {GGTestRunner} from "../GGTestRunner";
-
-/**
- * Internal implementation class for Selector.
- * Works with GGTestRuntime instances directly.
- */
-export class GGTestSelector<T extends RuntimeConstructor[]> {
-
-    private static readonly extensions = new Map<string, typeof GGTestSelectorExtension>();
-
-    public readonly runtimes: GGTestRuntime[];
-    private readonly extensionCache = new Map<string, unknown>();
-
-    constructor(runtimes: GGTestRuntime[]) {
-        this.runtimes = runtimes;
-    }
-
-    public get length(): number {
-        return this.runtimes.length;
-    }
-
-    public static addExtension(factory: typeof GGTestSelectorExtension & { PROPERTY_NAME: string }): void {
-        if (this.extensions.has(factory.PROPERTY_NAME)) {
-            throw new Error("Extension with name '" + factory.PROPERTY_NAME + "' is already registered!")
-        }
-        this.extensions.set(factory.PROPERTY_NAME, factory);
-    }
-
-    public static hasExtension(name: string): boolean {
-        return this.extensions.has(name);
-    }
-
-    public getExtension<K extends keyof SelectorExtensions<T>>(name: K): SelectorExtensions<T>[K] {
-        const cached = this.extensionCache.get(name as string);
-        if (cached !== undefined) {
-            return cached as SelectorExtensions<T>[K];
-        }
-
-        const extension = GGTestSelector.extensions.get(name);
-        if (!extension) {
-            throw new Error(`Extension '${String(name)}' is not registered. ` +
-                `Make sure the module providing this extension is imported.`);
-        }
-
-        const extensionInstance = new extension(this.runtimes);
-        this.extensionCache.set(name as string, extensionInstance);
-        return extensionInstance as SelectorExtensions<T>[K];
-    }
-
-    /**
-     * Stop all runtimes in this selector.
-     */
-    public async stop(): Promise<void> {
-        for (const runtime of this.runtimes) {
-            await runtime.stop();
-        }
-    }
-
-    /**
-     * Shutdown all runtimes in this selector.
-     */
-    public async shutdown(): Promise<void> {
-        for (const runtime of this.runtimes) {
-            await runtime.shutdown();
-        }
-    }
-}
-
-export class GGTestSelectorExtension {
-
-    protected readonly runner: GGTestRunner
-
-    constructor(protected readonly runtimes: GGTestRuntime[]) {
-        this.runner = this.runtimes[0]?.runner
-    }
-
-    protected async forEachParallel(callback: (runtime: GGTestRuntime) => Promise<void>): Promise<void> {
-        const results = await Promise.allSettled(
-            this.runtimes.map(runtime => callback(runtime))
-        );
-        const errors = results
-            .filter((r): r is PromiseRejectedResult => r.status === 'rejected')
-            .map(r => r.reason);
-
-        if (errors.length > 0) {
-            throw new AggregateError(errors, `${errors.length} runtime(s) failed`);
-        }
-    }
-}
-
-/**
- * Create a proxied Selector that supports:
- * - Indexed access: selector[0]
- * - Extension access: selector.config, selector.logs
- * - Lifecycle methods: selector.stop(), selector.shutdown()
- * - Standard properties: selector.runtimes, selector.length
- */
-export function createSelector<T extends RuntimeConstructor[]>(runtimes: GGTestRuntime[]): Selector<T> {
-    const impl = new GGTestSelector<T>(runtimes);
-
-    return new Proxy(impl as unknown as Selector<T>, {
-        get(target, prop) {
-            const implTarget = target as unknown as GGTestSelector<T>;
-
-            // Handle numeric index access: selector[0]
-            if (typeof prop === 'string' && /^\d+$/.test(prop)) {
-                const index = parseInt(prop, 10);
-                if (index >= 0 && index < implTarget.runtimes.length) {
-                    return createSelector([implTarget.runtimes[index]]);
-                }
-                return undefined;
-            }
-
-            // Handle extension access: selector.config, selector.logs, etc.
-            if (typeof prop === 'string' && GGTestSelector.hasExtension(prop)) {
-                return implTarget.getExtension(prop as keyof SelectorExtensions<T>);
-            }
-
-            // Handle methods and properties from impl
-            return Reflect.get(implTarget, prop);
-        }
-    }) as Selector<T>;
-}
-
-// ============================================================================
-// Factory functions for different input shapes
-// ============================================================================
-
-/**
- * Create result based on input shape.
- * - Single runtime → Selector
- * - Array of runtimes → Selector
- * - Object → ObjectResult with named selectors
- */
-export function createStartResult<T extends RuntimeInput>(
-    input: T,
-    runtimes: GGTestRuntime[]
-): StartResult<T> {
-    // Object input: { main: MainRuntime, sub: SubRuntime }
-    if (isObjectInput(input)) {
-        return createObjectResult(input, runtimes) as StartResult<T>;
-    }
-
-    // Array or single runtime → Selector
-    return createSelector(runtimes) as StartResult<T>;
-}
-
-/**
- * Check if input is an object (not a constructor or array).
- */
-function isObjectInput(input: RuntimeInput): input is Record<string, RuntimeConstructor | RuntimeConstructor[]> {
-    return typeof input === 'object' && !Array.isArray(input) && !('NAME' in input);
-}
-
-/**
- * Create ObjectResult for object input.
- */
-function createObjectResult<T extends Record<string, RuntimeConstructor | RuntimeConstructor[]>>(
-    input: T,
-    runtimes: GGTestRuntime[]
-): ObjectResult<T> {
-    const result: Record<string, Selector<any>> = {};
-
-    // Group runtimes by the key they were registered under
-    // We need to track which runtimes belong to which key
-    for (const [key, value] of Object.entries(input)) {
-        const constructors = Array.isArray(value) ? value : [value];
-        const names = constructors.map(c => c.NAME);
-        const keyRuntimes = runtimes.filter(r => names.includes(r.name));
-        result[key] = createSelector(keyRuntimes);
-    }
-
-    // Add stop/shutdown that affects all runtimes
-    (result as any).stop = async () => {
-        for (const runtime of runtimes) {
-            await runtime.stop();
-        }
-    };
-
-    (result as any).shutdown = async () => {
-        for (const runtime of runtimes) {
-            await runtime.shutdown();
-        }
-    };
-
-    return result as ObjectResult<T>;
-}
-
-// ============================================================================
-// Legacy factory (for backwards compatibility)
-// ============================================================================
-
-/**
- * @deprecated Use createStartResult instead.
- * Create a RuntimeResult for accessing runtimes via get() method.
- */
-export function createRuntimeSelector<T extends RuntimeConstructor[]>(runtimes: GGTestRuntime[]): RuntimeResult<T> {
-    return {
-        get(runtimeConstructor: RuntimeConstructor): Selector<any> {
-            const name = runtimeConstructor.NAME;
-            const filtered = runtimes.filter(r => r.name === name);
-            return createSelector(filtered);
-        },
-
-        all(): Selector<any> {
-            return createSelector(runtimes);
-        },
-
-        async stop(): Promise<void> {
-            for (const runtime of runtimes) {
-                await runtime.stop();
-            }
-        },
-
-        async shutdown(): Promise<void> {
-            for (const runtime of runtimes) {
-                await runtime.shutdown();
-            }
-        }
-    } as RuntimeResult<T>;
-}
+import {RuntimeConstructor, RuntimeResult, Selector, SelectorExtensions, ObjectResult, StartResult, RuntimeInput} from "./RuntimeSelector";
+import {GGTestRuntime} from "../GGTestRuntime";
+import type {GGTestRunner} from "../GGTestRunner";
+
+/**
+ * Internal implementation class for Selector.
+ * Works with GGTestRuntime instances directly.
+ */
+export class GGTestSelector<T extends RuntimeConstructor[]> {
+
+    private static readonly extensions = new Map<string, typeof GGTestSelectorExtension>();
+
+    public readonly runtimes: GGTestRuntime[];
+    private readonly extensionCache = new Map<string, unknown>();
+
+    constructor(runtimes: GGTestRuntime[]) {
+        this.runtimes = runtimes;
+    }
+
+    public get length(): number {
+        return this.runtimes.length;
+    }
+
+    public static addExtension(factory: typeof GGTestSelectorExtension & { PROPERTY_NAME: string }): void {
+        if (this.extensions.has(factory.PROPERTY_NAME)) {
+            throw new Error("Extension with name '" + factory.PROPERTY_NAME + "' is already registered!")
+        }
+        this.extensions.set(factory.PROPERTY_NAME, factory);
+    }
+
+    public static hasExtension(name: string): boolean {
+        return this.extensions.has(name);
+    }
+
+    public getExtension<K extends keyof SelectorExtensions<T>>(name: K): SelectorExtensions<T>[K] {
+        const cached = this.extensionCache.get(name as string);
+        if (cached !== undefined) {
+            return cached as SelectorExtensions<T>[K];
+        }
+
+        const extension = GGTestSelector.extensions.get(name);
+        if (!extension) {
+            throw new Error(`Extension '${String(name)}' is not registered. ` +
+                `Make sure the module providing this extension is imported.`);
+        }
+
+        const extensionInstance = new extension(this.runtimes);
+        this.extensionCache.set(name as string, extensionInstance);
+        return extensionInstance as SelectorExtensions<T>[K];
+    }
+
+    /**
+     * Stop all runtimes in this selector.
+     */
+    public async stop(): Promise<void> {
+        for (const runtime of this.runtimes) {
+            await runtime.stop();
+        }
+    }
+
+    /**
+     * Shutdown all runtimes in this selector.
+     */
+    public async shutdown(): Promise<void> {
+        for (const runtime of this.runtimes) {
+            await runtime.shutdown();
+        }
+    }
+}
+
+export class GGTestSelectorExtension {
+
+    protected readonly runner: GGTestRunner
+
+    constructor(protected readonly runtimes: GGTestRuntime[]) {
+        this.runner = this.runtimes[0]?.runner
+    }
+
+    protected async forEachParallel(callback: (runtime: GGTestRuntime) => Promise<void>): Promise<void> {
+        const results = await Promise.allSettled(
+            this.runtimes.map(runtime => callback(runtime))
+        );
+        const errors = results
+            .filter((r): r is PromiseRejectedResult => r.status === 'rejected')
+            .map(r => r.reason);
+
+        if (errors.length > 0) {
+            throw new AggregateError(errors, `${errors.length} runtime(s) failed`);
+        }
+    }
+}
+
+/**
+ * Create a proxied Selector that supports:
+ * - Indexed access: selector[0]
+ * - Extension access: selector.config, selector.logs
+ * - Lifecycle methods: selector.stop(), selector.shutdown()
+ * - Standard properties: selector.runtimes, selector.length
+ */
+export function createSelector<T extends RuntimeConstructor[]>(runtimes: GGTestRuntime[]): Selector<T> {
+    const impl = new GGTestSelector<T>(runtimes);
+
+    return new Proxy(impl as unknown as Selector<T>, {
+        get(target, prop) {
+            const implTarget = target as unknown as GGTestSelector<T>;
+
+            // Handle numeric index access: selector[0]
+            if (typeof prop === 'string' && /^\d+$/.test(prop)) {
+                const index = parseInt(prop, 10);
+                if (index >= 0 && index < implTarget.runtimes.length) {
+                    return createSelector([implTarget.runtimes[index]]);
+                }
+                return undefined;
+            }
+
+            // Handle extension access: selector.config, selector.logs, etc.
+            if (typeof prop === 'string' && GGTestSelector.hasExtension(prop)) {
+                return implTarget.getExtension(prop as keyof SelectorExtensions<T>);
+            }
+
+            // Handle methods and properties from impl
+            return Reflect.get(implTarget, prop);
+        }
+    }) as Selector<T>;
+}
+
+// ============================================================================
+// Factory functions for different input shapes
+// ============================================================================
+
+/**
+ * Create result based on input shape.
+ * - Single runtime → Selector
+ * - Array of runtimes → Selector
+ * - Object → ObjectResult with named selectors
+ */
+export function createStartResult<T extends RuntimeInput>(
+    input: T,
+    runtimes: GGTestRuntime[]
+): StartResult<T> {
+    // Object input: { main: MainRuntime, sub: SubRuntime }
+    if (isObjectInput(input)) {
+        return createObjectResult(input, runtimes) as StartResult<T>;
+    }
+
+    // Array or single runtime → Selector
+    return createSelector(runtimes) as StartResult<T>;
+}
+
+/**
+ * Check if input is an object (not a constructor or array).
+ */
+function isObjectInput(input: RuntimeInput): input is Record<string, RuntimeConstructor | RuntimeConstructor[]> {
+    return typeof input === 'object' && !Array.isArray(input) && !('NAME' in input);
+}
+
+/**
+ * Create ObjectResult for object input.
+ */
+function createObjectResult<T extends Record<string, RuntimeConstructor | RuntimeConstructor[]>>(
+    input: T,
+    runtimes: GGTestRuntime[]
+): ObjectResult<T> {
+    const result: Record<string, Selector<any>> = {};
+
+    // Group runtimes by the key they were registered under
+    // We need to track which runtimes belong to which key
+    for (const [key, value] of Object.entries(input)) {
+        const constructors = Array.isArray(value) ? value : [value];
+        const names = constructors.map(c => c.NAME);
+        const keyRuntimes = runtimes.filter(r => names.includes(r.name));
+        result[key] = createSelector(keyRuntimes);
+    }
+
+    // Add stop/shutdown that affects all runtimes
+    (result as any).stop = async () => {
+        for (const runtime of runtimes) {
+            await runtime.stop();
+        }
+    };
+
+    (result as any).shutdown = async () => {
+        for (const runtime of runtimes) {
+            await runtime.shutdown();
+        }
+    };
+
+    return result as ObjectResult<T>;
+}
+
+// ============================================================================
+// Legacy factory (for backwards compatibility)
+// ============================================================================
+
+/**
+ * @deprecated Use createStartResult instead.
+ * Create a RuntimeResult for accessing runtimes via get() method.
+ */
+export function createRuntimeSelector<T extends RuntimeConstructor[]>(runtimes: GGTestRuntime[]): RuntimeResult<T> {
+    return {
+        get(runtimeConstructor: RuntimeConstructor): Selector<any> {
+            const name = runtimeConstructor.NAME;
+            const filtered = runtimes.filter(r => r.name === name);
+            return createSelector(filtered);
+        },
+
+        all(): Selector<any> {
+            return createSelector(runtimes);
+        },
+
+        async stop(): Promise<void> {
+            for (const runtime of runtimes) {
+                await runtime.stop();
+            }
+        },
+
+        async shutdown(): Promise<void> {
+            for (const runtime of runtimes) {
+                await runtime.shutdown();
+            }
+        }
+    } as RuntimeResult<T>;
+}

package/src/testers/IGGTestInterceptor.ts

@@ -1,11 +1,11 @@
-export interface IGGTestInterceptor {
-    register(): void | Promise<void>;
-
-    unregister(): void | Promise<void>;
-
-    validate(): void | Promise<void>;
-
-    getMockValidationError(): Error | undefined;
-
-    isCalled(): boolean;
+export interface IGGTestInterceptor {
+    register(): void | Promise<void>;
+
+    unregister(): void | Promise<void>;
+
+    validate(): void | Promise<void>;
+
+    getMockValidationError(): Error | undefined;
+
+    isCalled(): boolean;
 }

package/src/testers/IGGTestWith.ts

@@ -1,15 +1,15 @@
-import {IGGTestInterceptor} from "./IGGTestInterceptor";
-
-export interface IGGTestWith {
-    createInterceptor(): IGGTestInterceptor;
-
-    /**
-     * Returns true if this expectation requires async processing and must be used with `.waitFor()`.
-     * When true, using with `.with()` will throw an error guiding the developer to use `.waitFor()`.
-     *
-     * Example: SQS message processing is async (happens after HTTP response), so SQS
-     * interceptors require `.waitFor()`.
-     */
-    requiresWaitFor?(): boolean;
-}
-
+import {IGGTestInterceptor} from "./IGGTestInterceptor";
+
+export interface IGGTestWith {
+    createInterceptor(): IGGTestInterceptor;
+
+    /**
+     * Returns true if this expectation requires async processing and must be used with `.waitFor()`.
+     * When true, using with `.with()` will throw an error guiding the developer to use `.waitFor()`.
+     *
+     * Example: SQS message processing is async (happens after HTTP response), so SQS
+     * interceptors require `.waitFor()`.
+     */
+    requiresWaitFor?(): boolean;
+}
+