@stratal/testing 0.0.2 → 0.0.4

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,79 @@
+import type { Application, StratalEnv } from 'stratal';
+import { type Container } from 'stratal/di';
+import { type InjectionToken } from 'stratal/module';
+import type { FakeStorageService } from '../storage';
+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)
+ *
+ * // 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
+     *
+     * Provides assertion helpers for testing file storage operations.
+     *
+     * @example
+     * ```typescript
+     * module.storage.assertExists('path/to/file.pdf')
+     * module.storage.assertMissing('deleted/file.pdf')
+     * module.storage.clear() // Reset between tests
+     * ```
+     */
+    get storage(): FakeStorageService;
+    /**
+     * Get Application instance
+     */
+    get application(): Application;
+    /**
+     * Get DI Container
+     */
+    get container(): Container;
+    /**
+     * Execute an HTTP request through RouterService
+     *
+     * This is the core method - calls RouterService.fetch() directly, no SELF.fetch()
+     */
+    fetch(request: Request): Promise<Response>;
+    /**
+     * Run callback in request scope (for DB operations, service access)
+     */
+    runInRequestScope<T>(callback: () => T | Promise<T>): Promise<T>;
+    /**
+     * 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,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACtD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAGpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;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;;;;;;;;;;;OAWG;IACH,IAAI,OAAO,IAAI,kBAAkB,CAEhC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED;;;;OAIG;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,IAAI,CAAC;CAG7B"}

package/dist/core/testing-module.js

@@ -0,0 +1,99 @@
+import { ROUTER_TOKENS } from 'stratal/router';
+import { STORAGE_TOKENS } from 'stratal/storage';
+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)
+ *
+ * // Cleanup
+ * await module.close()
+ * ```
+ */
+export class TestingModule {
+    app;
+    env;
+    _http = null;
+    constructor(app, env) {
+        this.app = app;
+        this.env = env;
+    }
+    /**
+     * Resolve a service from the container
+     */
+    get(token) {
+        return this.app.container.resolve(token);
+    }
+    /**
+     * Get HTTP test client for making requests
+     */
+    get http() {
+        this._http ??= new TestHttpClient(this);
+        return this._http;
+    }
+    /**
+     * Get fake storage service for assertions
+     *
+     * Provides assertion helpers for testing file storage operations.
+     *
+     * @example
+     * ```typescript
+     * module.storage.assertExists('path/to/file.pdf')
+     * module.storage.assertMissing('deleted/file.pdf')
+     * module.storage.clear() // Reset between tests
+     * ```
+     */
+    get storage() {
+        return this.get(STORAGE_TOKENS.StorageService);
+    }
+    /**
+     * Get Application instance
+     */
+    get application() {
+        return this.app;
+    }
+    /**
+     * Get DI Container
+     */
+    get container() {
+        return this.app.container;
+    }
+    /**
+     * Execute an HTTP request through RouterService
+     *
+     * This is the core method - calls RouterService.fetch() directly, no SELF.fetch()
+     */
+    async fetch(request) {
+        const router = this.get(ROUTER_TOKENS.RouterService);
+        return router.fetch(request, this.env, this.app.ctx);
+    }
+    /**
+     * Run callback in request scope (for DB operations, service access)
+     */
+    async runInRequestScope(callback) {
+        const mockContext = this.app.createMockRouterContext();
+        return this.app.container.runInRequestScope(mockContext, callback);
+    }
+    /**
+     * Cleanup - call in afterAll
+     */
+    async close() {
+        await this.app.shutdown();
+    }
+}
+//# sourceMappingURL=testing-module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testing-module.js","sourceRoot":"","sources":["../../src/core/testing-module.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAsB,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,aAAa;IAIL;IACA;IAJX,KAAK,GAA0B,IAAI,CAAA;IAE3C,YACmB,GAAgB,EAChB,GAAe;QADf,QAAG,GAAH,GAAG,CAAa;QAChB,QAAG,GAAH,GAAG,CAAY;IAC9B,CAAC;IAEL;;OAEG;IACH,GAAG,CAAI,KAAwB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC1C,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,IAAI,CAAC,KAAK,KAAK,IAAI,cAAc,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,GAAG,CAAqB,cAAc,CAAC,cAAc,CAAC,CAAA;IACpE,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,OAAgB;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAgB,aAAa,CAAC,aAAa,CAAC,CAAA;QACnE,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACtD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAI,QAA8B;QACvD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAA;QACtD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,iBAAiB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IACpE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;IAC3B,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { TestError } from './test-error';
+export { TestSetupError } from './setup-error';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}

package/dist/errors/index.js

@@ -0,0 +1,3 @@
+export { TestError } from './test-error';
+export { TestSetupError } from './setup-error';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}

package/dist/errors/setup-error.d.ts

@@ -0,0 +1,9 @@
+import { TestError } from './test-error';
+/**
+ * Error thrown when test setup fails.
+ * Examples: schema creation failure, migration failure, application bootstrap failure.
+ */
+export declare class TestSetupError extends TestError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=setup-error.d.ts.map

package/dist/errors/setup-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-error.d.ts","sourceRoot":"","sources":["../../src/errors/setup-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC;;;GAGG;AACH,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG3C"}

package/dist/errors/setup-error.js

@@ -0,0 +1,11 @@
+import { TestError } from './test-error';
+/**
+ * Error thrown when test setup fails.
+ * Examples: schema creation failure, migration failure, application bootstrap failure.
+ */
+export class TestSetupError extends TestError {
+    constructor(message, cause) {
+        super(`Test setup failed: ${message}`, cause);
+    }
+}
+//# sourceMappingURL=setup-error.js.map

package/dist/errors/setup-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-error.js","sourceRoot":"","sources":["../../src/errors/setup-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3C,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,sBAAsB,OAAO,EAAE,EAAE,KAAK,CAAC,CAAA;IAC/C,CAAC;CACF"}

package/dist/errors/test-error.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Base error class for all test framework errors.
+ * Extends from Error and allows easy identification via `instanceof`.
+ */
+export declare class TestError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+//# sourceMappingURL=test-error.d.ts.map

package/dist/errors/test-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-error.d.ts","sourceRoot":"","sources":["../../src/errors/test-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;aAGhB,KAAK,CAAC,EAAE,KAAK;gBAD7B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAQhC"}

package/dist/errors/test-error.js

@@ -0,0 +1,15 @@
+/**
+ * Base error class for all test framework errors.
+ * Extends from Error and allows easy identification via `instanceof`.
+ */
+export class TestError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'TestError';
+        // Maintain proper stack trace
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+//# sourceMappingURL=test-error.js.map

package/dist/errors/test-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-error.js","sourceRoot":"","sources":["../../src/errors/test-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGhB;IAFlB,YACE,OAAe,EACC,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;QAEvB,8BAA8B;QAC9B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;IACjD,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { ProviderOverrideBuilder, type ProviderOverrideConfig } from './core/override';
+export { Test } from './core/test';
+export { TestingModule } from './core/testing-module';
+export { TestingModuleBuilder, type TestingModuleConfig } from './core/testing-module-builder';
+export { createFetchMock, FetchMock } from './core/http/fetch-mock';
+export type { MockErrorOptions, MockJsonOptions } from './core/http/fetch-mock.types';
+export { TestHttpClient } from './core/http/test-http-client';
+export { TestHttpRequest } from './core/http/test-http-request';
+export { TestResponse } from './core/http/test-response';
+export { FakeStorageService, type StoredFile } from './storage';
+export { getTestEnv } from './core/env';
+export { TestError, TestSetupError } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAA;AAG1B,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAC9F,OAAO,EAAE,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAGtF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACnE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAGrF,OAAO,EAAE,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACtF,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAG9F,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACnE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAGxD,OAAO,EAAE,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -1,14 +1,13 @@
-import 'stratal/polyfills';
 // Core Testing
+export { ProviderOverrideBuilder } from './core/override';
 export { Test } from './core/test';
 export { TestingModule } from './core/testing-module';
 export { TestingModuleBuilder } from './core/testing-module-builder';
-export { ProviderOverrideBuilder } from './core/override';
 // HTTP Testing
+export { createFetchMock, FetchMock } from './core/http/fetch-mock';
 export { TestHttpClient } from './core/http/test-http-client';
 export { TestHttpRequest } from './core/http/test-http-request';
 export { TestResponse } from './core/http/test-response';
-export { FetchMock, createFetchMock } from './core/http/fetch-mock';
 // Storage
 export { FakeStorageService } from './storage';
 // Environment utilities

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAA;AAE1B,eAAe;AACf,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,+BAA+B,CAAA;AAC9F,OAAO,EAAE,uBAAuB,EAA+B,MAAM,iBAAiB,CAAA;AAEtF,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAGnE,UAAU;AACV,OAAO,EAAE,kBAAkB,EAAmB,MAAM,WAAW,CAAA;AAE/D,wBAAwB;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,uBAAuB,EAA+B,MAAM,iBAAiB,CAAA;AACtF,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,+BAA+B,CAAA;AAE9F,eAAe;AACf,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAExD,UAAU;AACV,OAAO,EAAE,kBAAkB,EAAmB,MAAM,WAAW,CAAA;AAE/D,wBAAwB;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}

package/dist/mocks/index.d.ts

@@ -0,0 +1,4 @@
+export * from './nodemailer';
+export { createMock } from '@golevelup/ts-vitest';
+export type { DeepMocked, PartialFuncReturn } from '@golevelup/ts-vitest';
+//# sourceMappingURL=index.d.ts.map

package/dist/mocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAG5B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/mocks/index.js

@@ -0,0 +1,4 @@
+export * from './nodemailer';
+// Deep mocking utilities from @golevelup/ts-vitest
+export { createMock } from '@golevelup/ts-vitest';
+//# sourceMappingURL=index.js.map

package/dist/mocks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAE5B,mDAAmD;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/mocks/nodemailer.d.ts

@@ -0,0 +1,10 @@
+declare const _default: {
+    createTransport: () => {
+        sendMail: () => Promise<{}>;
+    };
+};
+export default _default;
+export declare const createTransport: () => {
+    sendMail: () => Promise<{}>;
+};
+//# sourceMappingURL=nodemailer.d.ts.map

package/dist/mocks/nodemailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodemailer.d.ts","sourceRoot":"","sources":["../../src/mocks/nodemailer.ts"],"names":[],"mappings":";;;;;AAAA,wBAIC;AAED,eAAO,MAAM,eAAe;;CAE1B,CAAA"}

package/dist/mocks/nodemailer.js

@@ -0,0 +1,9 @@
+export default {
+    createTransport: () => ({
+        sendMail: () => Promise.resolve({}),
+    }),
+};
+export const createTransport = () => ({
+    sendMail: () => Promise.resolve({}),
+});
+//# sourceMappingURL=nodemailer.js.map

package/dist/mocks/nodemailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodemailer.js","sourceRoot":"","sources":["../../src/mocks/nodemailer.ts"],"names":[],"mappings":"AAAA,eAAe;IACb,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;QACtB,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;KACpC,CAAC;CACH,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,CAAC;IACpC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;CACpC,CAAC,CAAA"}