@stratal/testing 0.0.2 → 0.0.5

package/dist/core/override/provider-override-builder.js

@@ -0,0 +1,94 @@
+/**
+ * Fluent builder for provider overrides
+ *
+ * Provides a NestJS-style API for overriding providers in tests.
+ *
+ * @example
+ * ```typescript
+ * const module = await Test.createTestingModule({
+ *   imports: [RegistrationModule],
+ * })
+ *   .overrideProvider(EMAIL_TOKENS.EmailService)
+ *   .useValue(mockEmailService)
+ *   .compile()
+ * ```
+ */
+export class ProviderOverrideBuilder {
+    parent;
+    token;
+    constructor(parent, token) {
+        this.parent = parent;
+        this.token = token;
+    }
+    /**
+     * Use a static value as the provider
+     *
+     * The value will be registered directly in the container.
+     *
+     * @param value - The value to use as the provider
+     * @returns The parent TestingModuleBuilder for chaining
+     */
+    useValue(value) {
+        return this.parent.addProviderOverride({
+            token: this.token,
+            type: 'value',
+            implementation: value,
+        });
+    }
+    /**
+     * Use a class as the provider
+     *
+     * The class will be registered as a singleton.
+     *
+     * @param cls - The class constructor to use as the provider
+     * @returns The parent TestingModuleBuilder for chaining
+     */
+    useClass(cls) {
+        return this.parent.addProviderOverride({
+            token: this.token,
+            type: 'class',
+            implementation: cls,
+        });
+    }
+    /**
+     * Use a factory function as the provider
+     *
+     * The factory receives the container and should return the provider instance.
+     *
+     * @param factory - Factory function that creates the provider
+     * @returns The parent TestingModuleBuilder for chaining
+     */
+    useFactory(factory) {
+        return this.parent.addProviderOverride({
+            token: this.token,
+            type: 'factory',
+            implementation: factory,
+        });
+    }
+    /**
+     * Use an existing token as the provider (alias)
+     *
+     * The override token will resolve to the same instance as the target token.
+     *
+     * @param existingToken - The token to alias
+     * @returns The parent TestingModuleBuilder for chaining
+     *
+     * @example
+     * ```typescript
+     * const module = await Test.createTestingModule({
+     *   imports: [MyModule],
+     * })
+     *   .overrideProvider(ABSTRACT_TOKEN)
+     *   .useExisting(ConcreteService)
+     *   .compile()
+     * ```
+     */
+    useExisting(existingToken) {
+        return this.parent.addProviderOverride({
+            token: this.token,
+            type: 'existing',
+            implementation: existingToken,
+        });
+    }
+}
+//# sourceMappingURL=provider-override-builder.js.map

package/dist/core/override/provider-override-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-override-builder.js","sourceRoot":"","sources":["../../../src/core/override/provider-override-builder.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,uBAAuB;IAEf;IACA;IAFnB,YACmB,MAA4B,EAC5B,KAAwB;QADxB,WAAM,GAAN,MAAM,CAAsB;QAC5B,UAAK,GAAL,KAAK,CAAmB;IACvC,CAAC;IAEL;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAQ;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,OAAO;YACb,cAAc,EAAE,KAAK;SACtB,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAkC;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,OAAO;YACb,cAAc,EAAE,GAAG;SACpB,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,OAAoC;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,SAAS;YACf,cAAc,EAAE,OAAO;SACxB,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,WAAW,CAAC,aAAgC;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,UAAU;YAChB,cAAc,EAAE,aAAa;SAC9B,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/core/test.d.ts

@@ -0,0 +1,48 @@
+import { type DynamicModule, type ModuleClass } from 'stratal/module';
+import { TestingModuleBuilder, type TestingModuleConfig } from './testing-module-builder';
+/**
+ * Test
+ *
+ * Static class for creating testing modules.
+ * Provides a NestJS-style API for configuring test modules.
+ *
+ * @example
+ * ```typescript
+ * // In vitest.setup.ts:
+ * Test.setBaseModules([CoreModule])
+ *
+ * // In test files:
+ * const module = await Test.createTestingModule({
+ *   imports: [RegistrationModule, GeoModule],
+ * })
+ *   .overrideProvider(EMAIL_TOKENS.EmailService)
+ *   .useValue(mockEmailService)
+ *   .compile()
+ * ```
+ */
+export declare class Test {
+    /**
+     * Base modules to include in all test modules
+     * Set once in vitest.setup.ts
+     */
+    private static baseModules;
+    /**
+     * Set base modules to include in all test modules
+     * Should be called once in vitest.setup.ts
+     *
+     * @param modules - Modules to include before test-specific modules (e.g., CoreModule)
+     */
+    static setBaseModules(modules: (ModuleClass | DynamicModule)[]): void;
+    /**
+     * Get base modules
+     */
+    static getBaseModules(): (ModuleClass | DynamicModule)[];
+    /**
+     * Create a testing module builder
+     *
+     * @param config - Configuration with modules and optional env overrides
+     * @returns TestingModuleBuilder for configuring and compiling the module
+     */
+    static createTestingModule(config: TestingModuleConfig): TestingModuleBuilder;
+}
+//# sourceMappingURL=test.d.ts.map

package/dist/core/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/core/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEzF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,IAAI;IACf;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW,CAAsC;IAEhE;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,WAAW,GAAG,aAAa,CAAC,EAAE,GAAG,IAAI;IAIrE;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC,EAAE;IAIxD;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB;CAG9E"}

package/dist/core/test.js

@@ -0,0 +1,53 @@
+import { TestingModuleBuilder } from './testing-module-builder';
+/**
+ * Test
+ *
+ * Static class for creating testing modules.
+ * Provides a NestJS-style API for configuring test modules.
+ *
+ * @example
+ * ```typescript
+ * // In vitest.setup.ts:
+ * Test.setBaseModules([CoreModule])
+ *
+ * // In test files:
+ * const module = await Test.createTestingModule({
+ *   imports: [RegistrationModule, GeoModule],
+ * })
+ *   .overrideProvider(EMAIL_TOKENS.EmailService)
+ *   .useValue(mockEmailService)
+ *   .compile()
+ * ```
+ */
+export class Test {
+    /**
+     * Base modules to include in all test modules
+     * Set once in vitest.setup.ts
+     */
+    static baseModules = [];
+    /**
+     * Set base modules to include in all test modules
+     * Should be called once in vitest.setup.ts
+     *
+     * @param modules - Modules to include before test-specific modules (e.g., CoreModule)
+     */
+    static setBaseModules(modules) {
+        this.baseModules = modules;
+    }
+    /**
+     * Get base modules
+     */
+    static getBaseModules() {
+        return this.baseModules;
+    }
+    /**
+     * Create a testing module builder
+     *
+     * @param config - Configuration with modules and optional env overrides
+     * @returns TestingModuleBuilder for configuring and compiling the module
+     */
+    static createTestingModule(config) {
+        return new TestingModuleBuilder(config);
+    }
+}
+//# sourceMappingURL=test.js.map

package/dist/core/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/core/test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAA4B,MAAM,0BAA0B,CAAA;AAEzF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,IAAI;IACf;;;OAGG;IACK,MAAM,CAAC,WAAW,GAAoC,EAAE,CAAA;IAEhE;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,OAAwC;QAC5D,IAAI,CAAC,WAAW,GAAG,OAAO,CAAA;IAC5B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc;QACnB,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAA2B;QACpD,OAAO,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAA;IACzC,CAAC"}

package/dist/core/testing-module-builder.d.ts

@@ -0,0 +1,99 @@
+import { ApplicationConfig, type StratalEnv } from 'stratal';
+import { InjectionToken, ModuleOptions } from 'stratal/module';
+import { ProviderOverrideBuilder, type ProviderOverrideConfig } from './override';
+import { TestingModule } from './testing-module';
+/**
+ * Configuration for creating a testing module
+ *
+ * Extends ModuleOptions to support all module properties like NestJS.
+ *
+ * @example
+ * ```typescript
+ * const module = await Test.createTestingModule({
+ *   imports: [RegistrationModule, GeoModule],
+ *   providers: [{ provide: MOCK_TOKEN, useValue: mockValue }],
+ *   controllers: [TestController],
+ * }).compile()
+ * ```
+ */
+export interface TestingModuleConfig extends ModuleOptions {
+    /** Optional environment overrides */
+    env?: Partial<StratalEnv>;
+    /** Logging configuration. Defaults: level=ERROR, formatter='json' */
+    logging?: ApplicationConfig['logging'];
+}
+/**
+ * Builder for creating test modules with provider overrides
+ *
+ * Provides a NestJS-style fluent API for configuring test modules.
+ * Supports all ModuleOptions properties (imports, providers, controllers, consumers, jobs).
+ *
+ * @example Basic usage
+ * ```typescript
+ * const module = await Test.createTestingModule({
+ *   imports: [RegistrationModule],
+ * }).compile()
+ * ```
+ *
+ * @example Provider override
+ * ```typescript
+ * const module = await Test.createTestingModule({
+ *   imports: [RegistrationModule, GeoModule],
+ * })
+ *   .overrideProvider(EMAIL_TOKENS.EmailService)
+ *   .useValue(mockEmailService)
+ *   .compile()
+ * ```
+ *
+ * @example Full ModuleOptions
+ * ```typescript
+ * const module = await Test.createTestingModule({
+ *   imports: [RegistrationModule],
+ *   providers: [{ provide: MOCK_TOKEN, useValue: mockValue }],
+ *   controllers: [TestController],
+ *   consumers: [TestConsumer],
+ *   jobs: [TestJob],
+ * }).compile()
+ * ```
+ */
+export declare class TestingModuleBuilder {
+    private config;
+    private overrides;
+    constructor(config: TestingModuleConfig);
+    /**
+     * Override a provider with a custom implementation
+     *
+     * Returns a ProviderOverrideBuilder for specifying the override type.
+     *
+     * @param token - The injection token to override
+     * @returns ProviderOverrideBuilder for chaining useValue/useClass/useFactory
+     */
+    overrideProvider<T>(token: InjectionToken<T>): ProviderOverrideBuilder<T>;
+    /**
+     * Add a provider override (internal use by ProviderOverrideBuilder)
+     *
+     * @internal
+     */
+    addProviderOverride<T>(override: ProviderOverrideConfig<T>): this;
+    /**
+     * Merge additional environment bindings
+     *
+     * @param env - Partial environment to merge
+     * @returns This builder for chaining
+     */
+    withEnv(env: Partial<StratalEnv>): this;
+    /**
+     * Compile the testing module
+     *
+     * Creates the Application, applies overrides, initializes, and returns TestingModule.
+     * The ModuleRegistry handles all module registrations automatically.
+     *
+     * @returns Promise<TestingModule> - The compiled testing module
+     */
+    compile(): Promise<TestingModule>;
+    /**
+     * Create a test root module with the given options
+     */
+    private createTestRootModule;
+}
+//# sourceMappingURL=testing-module-builder.d.ts.map

package/dist/core/testing-module-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing-module-builder.d.ts","sourceRoot":"","sources":["../../src/core/testing-module-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,iBAAiB,EAEjB,KAAK,UAAU,EAChB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,cAAc,EAAuB,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAInF,OAAO,EAAE,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAEjF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,qCAAqC;IACrC,GAAG,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IACzB,qEAAqE;IACrE,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,SAAS,CAAuC;gBAEpC,MAAM,EAAE,mBAAmB;IAE/C;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC,CAAC;IAIzE;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,IAAI;IAKjE;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAKvC;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAmEvC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAK7B"}

package/dist/core/testing-module-builder.js

@@ -0,0 +1,156 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { createExecutionContext } from 'cloudflare:test';
+import { Application, } from 'stratal';
+import { LogLevel } from 'stratal/logger';
+import { Module } from 'stratal/module';
+import { STORAGE_TOKENS } from 'stratal/storage';
+import { FakeStorageService } from '../storage';
+import { getTestEnv } from './env';
+import { ProviderOverrideBuilder } from './override';
+import { Test } from './test';
+import { TestingModule } from './testing-module';
+/**
+ * Builder for creating test modules with provider overrides
+ *
+ * Provides a NestJS-style fluent API for configuring test modules.
+ * Supports all ModuleOptions properties (imports, providers, controllers, consumers, jobs).
+ *
+ * @example Basic usage
+ * ```typescript
+ * const module = await Test.createTestingModule({
+ *   imports: [RegistrationModule],
+ * }).compile()
+ * ```
+ *
+ * @example Provider override
+ * ```typescript
+ * const module = await Test.createTestingModule({
+ *   imports: [RegistrationModule, GeoModule],
+ * })
+ *   .overrideProvider(EMAIL_TOKENS.EmailService)
+ *   .useValue(mockEmailService)
+ *   .compile()
+ * ```
+ *
+ * @example Full ModuleOptions
+ * ```typescript
+ * const module = await Test.createTestingModule({
+ *   imports: [RegistrationModule],
+ *   providers: [{ provide: MOCK_TOKEN, useValue: mockValue }],
+ *   controllers: [TestController],
+ *   consumers: [TestConsumer],
+ *   jobs: [TestJob],
+ * }).compile()
+ * ```
+ */
+export class TestingModuleBuilder {
+    config;
+    overrides = [];
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Override a provider with a custom implementation
+     *
+     * Returns a ProviderOverrideBuilder for specifying the override type.
+     *
+     * @param token - The injection token to override
+     * @returns ProviderOverrideBuilder for chaining useValue/useClass/useFactory
+     */
+    overrideProvider(token) {
+        return new ProviderOverrideBuilder(this, token);
+    }
+    /**
+     * Add a provider override (internal use by ProviderOverrideBuilder)
+     *
+     * @internal
+     */
+    addProviderOverride(override) {
+        this.overrides.push(override);
+        return this;
+    }
+    /**
+     * Merge additional environment bindings
+     *
+     * @param env - Partial environment to merge
+     * @returns This builder for chaining
+     */
+    withEnv(env) {
+        this.config.env = { ...this.config.env, ...env };
+        return this;
+    }
+    /**
+     * Compile the testing module
+     *
+     * Creates the Application, applies overrides, initializes, and returns TestingModule.
+     * The ModuleRegistry handles all module registrations automatically.
+     *
+     * @returns Promise<TestingModule> - The compiled testing module
+     */
+    async compile() {
+        // 1. Create environment (cloudflare:test base + overrides)
+        const env = getTestEnv(this.config.env);
+        // 2. Create ExecutionContext
+        const ctx = createExecutionContext();
+        // 3. Build root module from config (supports all ModuleOptions)
+        const baseModules = Test.getBaseModules();
+        const configImports = this.config.imports ?? [];
+        const allImports = [...baseModules, ...configImports];
+        // Create root module with all config properties
+        const rootModule = this.createTestRootModule({
+            imports: allImports,
+            providers: this.config.providers,
+            controllers: this.config.controllers,
+            consumers: this.config.consumers,
+            jobs: this.config.jobs,
+        });
+        // 4. Create Application
+        const app = new Application(env, ctx, {
+            module: rootModule,
+            logging: {
+                level: this.config.logging?.level ?? LogLevel.ERROR,
+                formatter: this.config.logging?.formatter ?? 'pretty',
+            },
+        });
+        // 7. Initialize application - ModuleRegistry handles all module registrations
+        await app.initialize();
+        // 5. Auto-register FakeStorageService as singleton (can be overridden by user)
+        // Must be singleton so files uploaded in setup are available when consumers run
+        app.container.registerSingleton(STORAGE_TOKENS.StorageService, FakeStorageService);
+        // 6. Apply user overrides BEFORE initialize
+        for (const override of this.overrides) {
+            switch (override.type) {
+                case 'value':
+                    app.container.registerValue(override.token, override.implementation);
+                    break;
+                case 'class':
+                    app.container.registerSingleton(override.token, override.implementation);
+                    break;
+                case 'factory':
+                    app.container.registerFactory(override.token, override.implementation);
+                    break;
+                case 'existing':
+                    app.container.registerExisting(override.token, override.implementation);
+                    break;
+            }
+        }
+        return new TestingModule(app, env);
+    }
+    /**
+     * Create a test root module with the given options
+     */
+    createTestRootModule(options) {
+        let TestRootModule = class TestRootModule {
+        };
+        TestRootModule = __decorate([
+            Module(options)
+        ], TestRootModule);
+        return TestRootModule;
+    }
+}
+//# sourceMappingURL=testing-module-builder.js.map

package/dist/core/testing-module-builder.js.map

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

package/dist/core/testing-module.d.ts

@@ -0,0 +1,101 @@
+import type { ConnectionName, DatabaseService } from '@stratal/framework/database';
+import type { Application, StratalEnv } from 'stratal';
+import { type Container } from 'stratal/di';
+import { type InjectionToken } from 'stratal/module';
+import type { FakeStorageService } from '../storage';
+import type { Seeder } from '../types';
+import { TestHttpClient } from './http/test-http-client';
+/**
+ * TestingModule
+ *
+ * Provides access to the test application, container, HTTP client, and utilities.
+ *
+ * @example
+ * ```typescript
+ * const module = await Test.createTestingModule({
+ *   modules: [RegistrationModule],
+ * }).compile()
+ *
+ * // Make HTTP requests
+ * const response = await module.http
+ *   .post('/api/v1/register')
+ *   .withBody({ ... })
+ *   .send()
+ *
+ * // Access services
+ * const service = module.get(REGISTRATION_TOKENS.RegistrationService)
+ *
+ * // Database utilities
+ * await module.truncateDb()
+ * await module.seed(new UserSeeder())
+ * await module.assertDatabaseHas('user', { email: 'test@example.com' })
+ *
+ * // Cleanup
+ * await module.close()
+ * ```
+ */
+export declare class TestingModule {
+    private readonly app;
+    private readonly env;
+    private _http;
+    constructor(app: Application, env: StratalEnv);
+    /**
+     * Resolve a service from the container
+     */
+    get<T>(token: InjectionToken<T>): T;
+    /**
+     * Get HTTP test client for making requests
+     */
+    get http(): TestHttpClient;
+    /**
+     * Get fake storage service for assertions
+     */
+    get storage(): FakeStorageService;
+    /**
+     * Get Application instance
+     */
+    get application(): Application;
+    /**
+     * Get DI Container
+     */
+    get container(): Container;
+    /**
+     * Execute an HTTP request through RouterService
+     */
+    fetch(request: Request): Promise<Response>;
+    /**
+     * Run callback in request scope (for DB operations, service access)
+     */
+    runInRequestScope<T>(callback: () => T | Promise<T>): Promise<T>;
+    /**
+     * Get database service instance (resolved in request scope)
+     */
+    getDb(): Promise<DatabaseService>;
+    getDb<K extends ConnectionName>(name: K): Promise<DatabaseService<K>>;
+    /**
+     * Truncate all non-prisma tables in the database
+     */
+    truncateDb(name?: ConnectionName): Promise<void>;
+    /**
+     * Run seeders in a database transaction
+     */
+    seed(...seeders: Seeder[]): Promise<void>;
+    seed(name: ConnectionName, ...seeders: Seeder[]): Promise<void>;
+    /**
+     * Assert that a record exists in the database
+     */
+    assertDatabaseHas(table: string, data: Record<string, unknown>, name?: ConnectionName): Promise<void>;
+    /**
+     * Assert that a record does not exist in the database
+     */
+    assertDatabaseMissing(table: string, data: Record<string, unknown>, name?: ConnectionName): Promise<void>;
+    /**
+     * Assert the number of records in a table
+     */
+    assertDatabaseCount(table: string, expected: number, name?: ConnectionName): Promise<void>;
+    /**
+     * Cleanup - call in afterAll
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=testing-module.d.ts.map

package/dist/core/testing-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing-module.d.ts","sourceRoot":"","sources":["../../src/core/testing-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAElF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACtD,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAGpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,KAAK,CAA8B;gBAGxB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,UAAU;IAGlC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC;IAInC;;OAEG;IACH,IAAI,IAAI,IAAI,cAAc,CAGzB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,kBAAkB,CAEhC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKhD;;OAEG;IACG,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IACjC,KAAK,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAQ3E;;OAEG;IACG,UAAU,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAetD;;OAEG;IACG,IAAI,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrE;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3G;;OAEG;IACG,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/G;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhG;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}