@stratal/testing 0.0.2 → 0.0.4

package/CHANGELOG.md

@@ -0,0 +1,107 @@
+# @stratal/testing
+
+## 0.0.4
+
+### Patch Changes
+
+- **Build cleanup** — Removed redundant polyfills export and cleaned up the build configuration.
+- **Relaxed vitest version** — Loosened the vitest peer dependency version constraint.
+
+- Updated dependencies []:
+  - stratal@0.0.4
+
+## 0.0.3
+
+### Patch Changes
+
+- - **Build cleanup** — Removed redundant polyfills export and cleaned up the build configuration.
+  - **Relaxed vitest version** — Loosened the vitest peer dependency version constraint.
+- Updated dependencies []:
+  - stratal@0.0.3
+
+## 0.0.2
+
+### Patch Changes
+
+#### `stratal` (core)
+
+##### Breaking Changes
+
+- **`withRoot`/`withRootAsync` renamed to `forRoot`/`forRootAsync`** — All dynamic module configuration methods have been renamed for consistency. Update every `SomeModule.withRoot(...)` call to `SomeModule.forRoot(...)` and `SomeModule.withRootAsync(...)` to `SomeModule.forRootAsync(...)`. ([`152913a`](https://github.com/strataljs/stratal/commit/152913a))
+
+- **Barrel export removed — use sub-path imports** — The top-level `stratal` barrel export has been removed. Consumers must now import from sub-paths (`stratal/di`, `stratal/router`, `stratal/cache`, `stratal/validation`, etc.). ([`af073d8`](https://github.com/strataljs/stratal/commit/af073d8))
+
+##### Features
+
+- **DOM polyfill for Cloudflare Workers** — Added a DOM polyfill to support AWS SDK v3 XML parsing in Cloudflare Workers environments. ([`f3b2cb9`](https://github.com/strataljs/stratal/commit/f3b2cb9))
+
+- **Benchmark suite** — Added benchmark functionality for measuring framework performa30438`](https://github.com/strataljs/stratal/commit/7230438))
+
+##### Security
+
+- **ConfigService blocks prototype pollution** — `ConfigService` now rejects dangerous keys (`__proto__`, `constructor`, `prototype`) to prevent prototype pollution attacks. ([`567139c`](https://github.com/strataljs/stratal/commit/567139c), [`e64b4e7`](https://github.com/strataljs/stratal/commit/e64b4e7))
+
+##### Bug Fixes
+
+- **`reflect-metadata` import moved to vitest setup** — Removed unused `reflect-metadata` imports from example files and centralized the import in `vitest.setup.ts`. ([`f3b2cb9`](https://github.com/strataljs/stratal/commit/f3b2cb9))
+
+---
+
+#### `@stratal/testing`
+
+##### Breaking Changes
+
+- **Import paths updated** — Import paths updated to match the new core sub-path exports (e.g. `stratal/di` instead of the barrel `stratal`). ([`af073d8`](https://github.com/strataljs/stratal/commit/af073d8))
+
+- Updated dependencies []:
+  - @stratal/testing@0.0.2
+
+## 0.0.1
+
+### Patch Changes
+
+- Initial release of the Stratal framework — a modular Cloudflare Workers framework built on Hono and tsyringe.
+
+  **Core Infrastructure**
+
+  - NestJS-style module system with `@Module()` decorator, dynamic modules (`forRoot`, `forRootAsync`), and lifecycle hooks (`OnInitialize`, `OnShutdown`)
+  - Two-tier dependency injection container (global singletons + request-scoped) powered by tsyringe with conditional registration and service decoration
+  - `StratalWorker` entry point extending Cloudflare's `WorkerEntrypoint` for HTTP fetch, queue batches, and scheduled cron triggers
+
+  **Routing & API**
+
+  - Hono-based routing with `@Controller()` and `@Route()` decorators, automatic controller discovery, and route guards via `@UseGuards()`
+  - OpenAPI schema generation with `@hono/zod-openapi` and Scalar API reference integration
+  - NestJS-like middleware configuration with route-specific application and exclusion
+
+  **Background Processing**
+
+  - Queue consumerfor Cloudflare Queues with `@Consumer()` and `@QueueJob()` decorators and batch processing
+  - Cron job scheduling via `CronManager` integrated with Cloudflare's scheduled events
+
+  **Services & Integrations**
+
+  - Email module with pluggable providers (Nodemailer, Resend) and queue-based sending
+  - Storage module with AWS S3 / Cloudflare R2 support, multipart uploads, presigned URLs, and TUS resumable uploads
+  - Internationalization (i18n) module with locale detection, message compilation, and request-scoped translations
+  - Cache module with pluggable providers and Cloudflare KV integration
+  - Configuration module with `registerAs()` namespaces and Zod-based validation
+  - Structured logging with JSON and pretty formatters
+
+  **Developer Experience**
+
+  - Zod-powered request/response validation with type inference
+  - Custom `ApplicationError` class with HTTP status mapping
+  - ESM-only with full TypeScript decorator support (`emitDecoratorMetadata`)
+  - Sub-path exports for tree-shakeable imports (`stratal/di`, `stratal/router`, `stratal/cache`, etc.)
+
+  - `TestingModule` and `TestingModuleBuilder` for bootstrapping isolated module environments in tests
+  - `TestHttpClient` with request builder and response wrapper for integration testing
+  - `FetchMock` for mocking HTTP fetch calls
+  - `FakeStorageService` for in-memory storage testing without S3/R2
+  - `ProviderOverrideBuilder` for replacing providers with test doubles
+  - Nodemailer mock for email testing
+  - Test environment utilities via `getTestEnv()`
+
+- Updated dependencies []:
+  - stratal@0.0.1

package/dist/core/env/index.d.ts

@@ -0,0 +1,2 @@
+export { getTestEnv } from './test-env';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/env/index.js

@@ -0,0 +1,2 @@
+export { getTestEnv } from './test-env';
+//# sourceMappingURL=index.js.map

package/dist/core/env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/env/test-env.d.ts

@@ -0,0 +1,9 @@
+import { type StratalEnv } from 'stratal';
+/**
+ * Get test environment with optional overrides
+ *
+ * @param overrides - Optional partial env to merge with cloudflare:test env
+ * @returns Complete Env object for testing
+ */
+export declare function getTestEnv(overrides?: Partial<StratalEnv>): StratalEnv;
+//# sourceMappingURL=test-env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-env.d.ts","sourceRoot":"","sources":["../../../src/core/env/test-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAA;AAGzC;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAKtE"}

package/dist/core/env/test-env.js

@@ -0,0 +1,14 @@
+import { env as cloudflareEnv } from 'cloudflare:test';
+/**
+ * Get test environment with optional overrides
+ *
+ * @param overrides - Optional partial env to merge with cloudflare:test env
+ * @returns Complete Env object for testing
+ */
+export function getTestEnv(overrides) {
+    return {
+        ...cloudflareEnv,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=test-env.js.map

package/dist/core/env/test-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-env.js","sourceRoot":"","sources":["../../../src/core/env/test-env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,SAA+B;IACxD,OAAO;QACL,GAAG,aAAa;QAChB,GAAG,SAAS;KACC,CAAA;AACjB,CAAC"}

package/dist/core/http/fetch-mock.d.ts

@@ -0,0 +1,236 @@
+import type { MockJsonOptions, MockErrorOptions } from './fetch-mock.types';
+/**
+ * Wrapper around Cloudflare's fetchMock for declarative fetch mocking in tests
+ *
+ * Based on undici's MockAgent, fetchMock.get(origin) returns a MockPool for that origin.
+ * The MockPool's intercept() method is used to define which requests to mock.
+ *
+ * @example
+ * ```typescript
+ * import { createFetchMock } from '@stratal/testing'
+ *
+ * const mock = createFetchMock()
+ *
+ * beforeEach(() => {
+ *   mock.activate()
+ *   mock.disableNetConnect()
+ * })
+ *
+ * afterEach(() => {
+ *   mock.reset()
+ * })
+ *
+ * it('should mock external API', async () => {
+ *   // Using helper method
+ *   mock.mockJsonResponse('https://api.example.com/data', { success: true })
+ *
+ *   // Or using direct API
+ *   mock.get('https://api.example.com')
+ *     .intercept({ path: '/users', method: 'POST' })
+ *     .reply(201, JSON.stringify({ created: true }))
+ *
+ *   const response = await fetch('https://api.example.com/data')
+ *   const json = await response.json()
+ *
+ *   expect(json.success).toBe(true)
+ *   mock.assertNoPendingInterceptors()
+ * })
+ * ```
+ */
+export declare class FetchMock {
+    /**
+     * Get a MockPool for the specified origin
+     *
+     * This is the underlying fetchMock.get() method that returns a MockPool
+     * for mocking requests to the specified origin.
+     *
+     * @param origin - The origin URL (e.g., 'https://api.example.com')
+     * @returns MockPool for chaining .intercept() and .reply()
+     *
+     * @example
+     * ```typescript
+     * // Mock a GET request
+     * mock.get('https://api.example.com')
+     *   .intercept({ path: '/users', method: 'GET' })
+     *   .reply(200, JSON.stringify({ users: [] }))
+     *
+     * // Mock a POST request with body matching
+     * mock.get('https://api.example.com')
+     *   .intercept({
+     *     path: '/users',
+     *     method: 'POST',
+     *     body: (body) => body.includes('test')
+     *   })
+     *   .reply(201, JSON.stringify({ created: true }))
+     * ```
+     */
+    get(origin: string): import("cloudflare:test").Interceptable;
+    /**
+     * Activate fetch mocking for the current test
+     *
+     * @example
+     * ```typescript
+     * beforeEach(() => {
+     *   mock.activate()
+     * })
+     * ```
+     */
+    activate(): void;
+    /**
+     * Deactivate fetch mocking
+     */
+    deactivate(): void;
+    /**
+     * Disable all network connections, forcing all requests to use mocks
+     *
+     * @example
+     * ```typescript
+     * beforeEach(() => {
+     *   mock.activate()
+     *   mock.disableNetConnect() // Ensure all requests are mocked
+     * })
+     * ```
+     */
+    disableNetConnect(): void;
+    /**
+     * Enable network connections for specific hosts
+     *
+     * @example
+     * ```typescript
+     * mock.enableNetConnect('localhost')
+     * mock.enableNetConnect(/^https:\/\/trusted\.com/)
+     * ```
+     */
+    enableNetConnect(host?: string | RegExp): void;
+    /**
+     * Assert that all defined interceptors were called
+     *
+     * @throws {Error} If there are pending interceptors that weren't matched
+     *
+     * @example
+     * ```typescript
+     * it('should call all mocked endpoints', async () => {
+     *   mock.mockJsonResponse('https://api.example.com/data', { data: [] })
+     *
+     *   await fetch('https://api.example.com/data')
+     *
+     *   mock.assertNoPendingInterceptors() // Pass
+     * })
+     * ```
+     */
+    assertNoPendingInterceptors(): void;
+    /**
+     * Reset all mocks and interceptors
+     *
+     * @example
+     * ```typescript
+     * afterEach(() => {
+     *   mock.reset()
+     * })
+     * ```
+     */
+    reset(): void;
+    /**
+     * Helper method to mock JSON responses
+     *
+     * Automatically parses the URL into origin and path, and sets up the mock.
+     *
+     * @param url - Full URL to mock (e.g., 'https://api.example.com/users')
+     * @param data - JSON data to return
+     * @param options - Additional options for the mock
+     *
+     * @example
+     * ```typescript
+     * // Mock a GET request
+     * mock.mockJsonResponse('https://api.example.com/users', { users: [] })
+     *
+     * // Mock a POST request
+     * mock.mockJsonResponse(
+     *   'https://api.example.com/users',
+     *   { created: true },
+     *   { method: 'POST', status: 201 }
+     * )
+     *
+     * // With custom headers and delay
+     * mock.mockJsonResponse(
+     *   'https://api.example.com/users',
+     *   { users: [] },
+     *   {
+     *     status: 200,
+     *     method: 'GET',
+     *     headers: { 'X-Custom': 'value' },
+     *     delay: 100
+     *   }
+     * )
+     * ```
+     */
+    mockJsonResponse(url: string, data: unknown, options?: MockJsonOptions): import("cloudflare:test").MockScope<object>;
+    /**
+     * Helper method to mock error responses
+     *
+     * @param url - Full URL to mock
+     * @param status - HTTP error status code
+     * @param message - Optional error message
+     * @param options - Additional options for the error mock
+     *
+     * @example
+     * ```typescript
+     * // Mock a 401 error
+     * mock.mockError('https://api.example.com/fail', 401, 'Unauthorized')
+     *
+     * // Mock a 500 error with custom method
+     * mock.mockError(
+     *   'https://api.example.com/fail',
+     *   500,
+     *   'Server Error',
+     *   { method: 'POST' }
+     * )
+     * ```
+     */
+    mockError(url: string, status: number, message?: string, options?: MockErrorOptions): import("cloudflare:test").MockScope<object>;
+    /**
+     * Generic helper to mock any HTTP request
+     *
+     * @param origin - The origin URL (e.g., 'https://api.example.com')
+     * @param options - Request matching and response options
+     *
+     * @example
+     * ```typescript
+     * mock.mockRequest('https://api.example.com', {
+     *   path: '/users',
+     *   method: 'PUT',
+     *   status: 200,
+     *   body: { updated: true }
+     * })
+     * ```
+     */
+    mockRequest(origin: string, options: {
+        path: string;
+        method?: string;
+        status?: number;
+        body?: unknown;
+    }): import("cloudflare:test").MockScope<object>;
+}
+/**
+ * Factory function to create a new FetchMock instance
+ *
+ * @returns A new FetchMock instance
+ *
+ * @example
+ * ```typescript
+ * import { createFetchMock } from '@stratal/testing'
+ *
+ * const mock = createFetchMock()
+ *
+ * beforeEach(() => {
+ *   mock.activate()
+ *   mock.disableNetConnect()
+ * })
+ *
+ * afterEach(() => {
+ *   mock.reset()
+ * })
+ * ```
+ */
+export declare function createFetchMock(): FetchMock;
+//# sourceMappingURL=fetch-mock.d.ts.map

package/dist/core/http/fetch-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-mock.d.ts","sourceRoot":"","sources":["../../../src/core/http/fetch-mock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,SAAS;IACrB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM;IAIlB;;;;;;;;;OASG;IACH,QAAQ;IAIR;;OAEG;IACH,UAAU;IAIV;;;;;;;;;;OAUG;IACH,iBAAiB;IAIjB;;;;;;;;OAQG;IACH,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAOvC;;;;;;;;;;;;;;;OAeG;IACH,2BAA2B;IAI3B;;;;;;;;;OASG;IACH,KAAK;IAKL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB;IAwB1E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAkBvF;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE;CAS5E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAE3C"}

package/dist/core/http/fetch-mock.js

@@ -0,0 +1,290 @@
+import { fetchMock } from 'cloudflare:test';
+/**
+ * Wrapper around Cloudflare's fetchMock for declarative fetch mocking in tests
+ *
+ * Based on undici's MockAgent, fetchMock.get(origin) returns a MockPool for that origin.
+ * The MockPool's intercept() method is used to define which requests to mock.
+ *
+ * @example
+ * ```typescript
+ * import { createFetchMock } from '@stratal/testing'
+ *
+ * const mock = createFetchMock()
+ *
+ * beforeEach(() => {
+ *   mock.activate()
+ *   mock.disableNetConnect()
+ * })
+ *
+ * afterEach(() => {
+ *   mock.reset()
+ * })
+ *
+ * it('should mock external API', async () => {
+ *   // Using helper method
+ *   mock.mockJsonResponse('https://api.example.com/data', { success: true })
+ *
+ *   // Or using direct API
+ *   mock.get('https://api.example.com')
+ *     .intercept({ path: '/users', method: 'POST' })
+ *     .reply(201, JSON.stringify({ created: true }))
+ *
+ *   const response = await fetch('https://api.example.com/data')
+ *   const json = await response.json()
+ *
+ *   expect(json.success).toBe(true)
+ *   mock.assertNoPendingInterceptors()
+ * })
+ * ```
+ */
+export class FetchMock {
+    /**
+     * Get a MockPool for the specified origin
+     *
+     * This is the underlying fetchMock.get() method that returns a MockPool
+     * for mocking requests to the specified origin.
+     *
+     * @param origin - The origin URL (e.g., 'https://api.example.com')
+     * @returns MockPool for chaining .intercept() and .reply()
+     *
+     * @example
+     * ```typescript
+     * // Mock a GET request
+     * mock.get('https://api.example.com')
+     *   .intercept({ path: '/users', method: 'GET' })
+     *   .reply(200, JSON.stringify({ users: [] }))
+     *
+     * // Mock a POST request with body matching
+     * mock.get('https://api.example.com')
+     *   .intercept({
+     *     path: '/users',
+     *     method: 'POST',
+     *     body: (body) => body.includes('test')
+     *   })
+     *   .reply(201, JSON.stringify({ created: true }))
+     * ```
+     */
+    get(origin) {
+        return fetchMock.get(origin);
+    }
+    /**
+     * Activate fetch mocking for the current test
+     *
+     * @example
+     * ```typescript
+     * beforeEach(() => {
+     *   mock.activate()
+     * })
+     * ```
+     */
+    activate() {
+        fetchMock.activate();
+    }
+    /**
+     * Deactivate fetch mocking
+     */
+    deactivate() {
+        fetchMock.deactivate();
+    }
+    /**
+     * Disable all network connections, forcing all requests to use mocks
+     *
+     * @example
+     * ```typescript
+     * beforeEach(() => {
+     *   mock.activate()
+     *   mock.disableNetConnect() // Ensure all requests are mocked
+     * })
+     * ```
+     */
+    disableNetConnect() {
+        fetchMock.disableNetConnect();
+    }
+    /**
+     * Enable network connections for specific hosts
+     *
+     * @example
+     * ```typescript
+     * mock.enableNetConnect('localhost')
+     * mock.enableNetConnect(/^https:\/\/trusted\.com/)
+     * ```
+     */
+    enableNetConnect(host) {
+        if (host) {
+            fetchMock.enableNetConnect(host);
+            return;
+        }
+        fetchMock.enableNetConnect();
+    }
+    /**
+     * Assert that all defined interceptors were called
+     *
+     * @throws {Error} If there are pending interceptors that weren't matched
+     *
+     * @example
+     * ```typescript
+     * it('should call all mocked endpoints', async () => {
+     *   mock.mockJsonResponse('https://api.example.com/data', { data: [] })
+     *
+     *   await fetch('https://api.example.com/data')
+     *
+     *   mock.assertNoPendingInterceptors() // Pass
+     * })
+     * ```
+     */
+    assertNoPendingInterceptors() {
+        fetchMock.assertNoPendingInterceptors();
+    }
+    /**
+     * Reset all mocks and interceptors
+     *
+     * @example
+     * ```typescript
+     * afterEach(() => {
+     *   mock.reset()
+     * })
+     * ```
+     */
+    reset() {
+        // Reset by deactivating
+        fetchMock.deactivate();
+    }
+    /**
+     * Helper method to mock JSON responses
+     *
+     * Automatically parses the URL into origin and path, and sets up the mock.
+     *
+     * @param url - Full URL to mock (e.g., 'https://api.example.com/users')
+     * @param data - JSON data to return
+     * @param options - Additional options for the mock
+     *
+     * @example
+     * ```typescript
+     * // Mock a GET request
+     * mock.mockJsonResponse('https://api.example.com/users', { users: [] })
+     *
+     * // Mock a POST request
+     * mock.mockJsonResponse(
+     *   'https://api.example.com/users',
+     *   { created: true },
+     *   { method: 'POST', status: 201 }
+     * )
+     *
+     * // With custom headers and delay
+     * mock.mockJsonResponse(
+     *   'https://api.example.com/users',
+     *   { users: [] },
+     *   {
+     *     status: 200,
+     *     method: 'GET',
+     *     headers: { 'X-Custom': 'value' },
+     *     delay: 100
+     *   }
+     * )
+     * ```
+     */
+    mockJsonResponse(url, data, options = {}) {
+        const parsedUrl = new URL(url);
+        const origin = `${parsedUrl.protocol}//${parsedUrl.host}`;
+        const path = options.path ?? parsedUrl.pathname;
+        const method = options.method ?? 'GET';
+        const { status = 200, headers = {}, delay } = options;
+        const defaultHeaders = {
+            'Content-Type': 'application/json',
+            ...headers,
+        };
+        const mock = fetchMock
+            .get(origin)
+            .intercept({ path, method })
+            .reply(status, JSON.stringify(data), { headers: defaultHeaders });
+        if (delay) {
+            return mock.delay(delay);
+        }
+        return mock;
+    }
+    /**
+     * Helper method to mock error responses
+     *
+     * @param url - Full URL to mock
+     * @param status - HTTP error status code
+     * @param message - Optional error message
+     * @param options - Additional options for the error mock
+     *
+     * @example
+     * ```typescript
+     * // Mock a 401 error
+     * mock.mockError('https://api.example.com/fail', 401, 'Unauthorized')
+     *
+     * // Mock a 500 error with custom method
+     * mock.mockError(
+     *   'https://api.example.com/fail',
+     *   500,
+     *   'Server Error',
+     *   { method: 'POST' }
+     * )
+     * ```
+     */
+    mockError(url, status, message, options = {}) {
+        const parsedUrl = new URL(url);
+        const origin = `${parsedUrl.protocol}//${parsedUrl.host}`;
+        const path = options.path ?? parsedUrl.pathname;
+        const method = options.method ?? 'GET';
+        const { headers = {} } = options;
+        const body = message ? JSON.stringify({ error: message }) : '';
+        const responseHeaders = message
+            ? { 'Content-Type': 'application/json', ...headers }
+            : headers;
+        return fetchMock
+            .get(origin)
+            .intercept({ path, method })
+            .reply(status, body, { headers: responseHeaders });
+    }
+    /**
+     * Generic helper to mock any HTTP request
+     *
+     * @param origin - The origin URL (e.g., 'https://api.example.com')
+     * @param options - Request matching and response options
+     *
+     * @example
+     * ```typescript
+     * mock.mockRequest('https://api.example.com', {
+     *   path: '/users',
+     *   method: 'PUT',
+     *   status: 200,
+     *   body: { updated: true }
+     * })
+     * ```
+     */
+    mockRequest(origin, options) {
+        const { path, method = 'GET', status = 200, body } = options;
+        return fetchMock
+            .get(origin)
+            .intercept({ path, method })
+            .reply(status, body ? JSON.stringify(body) : '');
+    }
+}
+/**
+ * Factory function to create a new FetchMock instance
+ *
+ * @returns A new FetchMock instance
+ *
+ * @example
+ * ```typescript
+ * import { createFetchMock } from '@stratal/testing'
+ *
+ * const mock = createFetchMock()
+ *
+ * beforeEach(() => {
+ *   mock.activate()
+ *   mock.disableNetConnect()
+ * })
+ *
+ * afterEach(() => {
+ *   mock.reset()
+ * })
+ * ```
+ */
+export function createFetchMock() {
+    return new FetchMock();
+}
+//# sourceMappingURL=fetch-mock.js.map

package/dist/core/http/fetch-mock.js.map

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