@stratal/testing 0.0.2 → 0.0.5

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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"}

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

@@ -0,0 +1,48 @@
+/**
+ * Options for mocking JSON responses
+ */
+export interface MockJsonOptions {
+    /**
+     * HTTP status code for the response
+     * @default 200
+     */
+    status?: number;
+    /**
+     * Custom headers to include in the response
+     */
+    headers?: Record<string, string>;
+    /**
+     * Delay in milliseconds before responding
+     */
+    delay?: number;
+    /**
+     * HTTP method to match (GET, POST, PUT, PATCH, DELETE, etc.)
+     * @default 'GET'
+     */
+    method?: string;
+    /**
+     * Specific path to override URL pathname
+     * If not provided, the pathname from the URL will be used
+     */
+    path?: string;
+}
+/**
+ * Options for mocking error responses
+ */
+export interface MockErrorOptions {
+    /**
+     * Custom headers to include in the error response
+     */
+    headers?: Record<string, string>;
+    /**
+     * HTTP method to match (GET, POST, PUT, PATCH, DELETE, etc.)
+     * @default 'GET'
+     */
+    method?: string;
+    /**
+     * Specific path to override URL pathname
+     * If not provided, the pathname from the URL will be used
+     */
+    path?: string;
+}
+//# sourceMappingURL=fetch-mock.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-mock.types.d.ts","sourceRoot":"","sources":["../../../src/core/http/fetch-mock.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACb"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fetch-mock.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-mock.types.js","sourceRoot":"","sources":["../../../src/core/http/fetch-mock.types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,6 @@
+export { TestHttpClient } from './test-http-client';
+export { TestHttpRequest } from './test-http-request';
+export { TestResponse } from './test-response';
+export { FetchMock, createFetchMock } from './fetch-mock';
+export type { MockJsonOptions, MockErrorOptions } from './fetch-mock.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACzD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/core/http/index.js

@@ -0,0 +1,5 @@
+export { TestHttpClient } from './test-http-client';
+export { TestHttpRequest } from './test-http-request';
+export { TestResponse } from './test-response';
+export { FetchMock, createFetchMock } from './fetch-mock';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/core/http/test-http-client.d.ts

@@ -0,0 +1,54 @@
+import type { TestingModule } from '../testing-module';
+import { TestHttpRequest } from './test-http-request';
+/**
+ * TestHttpClient
+ *
+ * Fluent HTTP client for making test requests.
+ *
+ * @example
+ * ```typescript
+ * const response = await module.http
+ *   .forHost('example.com')
+ *   .post('/api/v1/users')
+ *   .withBody({ name: 'Test' })
+ *   .send()
+ *
+ * response.assertCreated()
+ * ```
+ */
+export declare class TestHttpClient {
+    private readonly module;
+    private defaultHeaders;
+    private host;
+    constructor(module: TestingModule);
+    /**
+     * Set the host for the request
+     */
+    forHost(host: string): this;
+    /**
+     * Set default headers for all requests
+     */
+    withHeaders(headers: Record<string, string>): this;
+    /**
+     * Create a GET request
+     */
+    get(path: string): TestHttpRequest;
+    /**
+     * Create a POST request
+     */
+    post(path: string): TestHttpRequest;
+    /**
+     * Create a PUT request
+     */
+    put(path: string): TestHttpRequest;
+    /**
+     * Create a PATCH request
+     */
+    patch(path: string): TestHttpRequest;
+    /**
+     * Create a DELETE request
+     */
+    delete(path: string): TestHttpRequest;
+    private createRequest;
+}
+//# sourceMappingURL=test-http-client.d.ts.map

package/dist/core/http/test-http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-http-client.d.ts","sourceRoot":"","sources":["../../../src/core/http/test-http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,IAAI,CAAsB;gBAEL,MAAM,EAAE,aAAa;IAElD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAOlD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAIlC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAInC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAIlC;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAIpC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAIrC,OAAO,CAAC,aAAa;CAGtB"}

package/dist/core/http/test-http-client.js

@@ -0,0 +1,75 @@
+import { TestHttpRequest } from './test-http-request';
+/**
+ * TestHttpClient
+ *
+ * Fluent HTTP client for making test requests.
+ *
+ * @example
+ * ```typescript
+ * const response = await module.http
+ *   .forHost('example.com')
+ *   .post('/api/v1/users')
+ *   .withBody({ name: 'Test' })
+ *   .send()
+ *
+ * response.assertCreated()
+ * ```
+ */
+export class TestHttpClient {
+    module;
+    defaultHeaders = new Headers();
+    host = null;
+    constructor(module) {
+        this.module = module;
+    }
+    /**
+     * Set the host for the request
+     */
+    forHost(host) {
+        this.host = host;
+        return this;
+    }
+    /**
+     * Set default headers for all requests
+     */
+    withHeaders(headers) {
+        for (const [key, value] of Object.entries(headers)) {
+            this.defaultHeaders.set(key, value);
+        }
+        return this;
+    }
+    /**
+     * Create a GET request
+     */
+    get(path) {
+        return this.createRequest('GET', path);
+    }
+    /**
+     * Create a POST request
+     */
+    post(path) {
+        return this.createRequest('POST', path);
+    }
+    /**
+     * Create a PUT request
+     */
+    put(path) {
+        return this.createRequest('PUT', path);
+    }
+    /**
+     * Create a PATCH request
+     */
+    patch(path) {
+        return this.createRequest('PATCH', path);
+    }
+    /**
+     * Create a DELETE request
+     */
+    delete(path) {
+        return this.createRequest('DELETE', path);
+    }
+    createRequest(method, path) {
+        return new TestHttpRequest(method, path, this.defaultHeaders, this.module, this.host);
+    }
+}
+//# sourceMappingURL=test-http-client.js.map

package/dist/core/http/test-http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-http-client.js","sourceRoot":"","sources":["../../../src/core/http/test-http-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,cAAc;IAII;IAHrB,cAAc,GAAY,IAAI,OAAO,EAAE,CAAA;IACvC,IAAI,GAAkB,IAAI,CAAA;IAElC,YAA6B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAI,CAAC;IAEvD;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAA+B;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACrC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACxC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACzC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAC1C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC3C,CAAC;IAEO,aAAa,CAAC,MAAc,EAAE,IAAY;QAChD,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IACvF,CAAC;CACF"}

package/dist/core/http/test-http-request.d.ts

@@ -0,0 +1,60 @@
+import type { TestingModule } from '../testing-module';
+import { TestResponse } from './test-response';
+/**
+ * TestHttpRequest
+ *
+ * Request builder with fluent API for configuring test HTTP requests.
+ *
+ * @example
+ * ```typescript
+ * const response = await module.http
+ *   .post('/api/v1/register')
+ *   .withBody({ name: 'Test School' })
+ *   .withHeaders({ 'X-Custom': 'value' })
+ *   .send()
+ * ```
+ *
+ * @example Authenticated request
+ * ```typescript
+ * const response = await module.http
+ *   .get('/api/v1/profile')
+ *   .actingAs({ id: user.id })
+ *   .send()
+ * ```
+ */
+export declare class TestHttpRequest {
+    private readonly method;
+    private readonly path;
+    private readonly module;
+    private readonly host;
+    private body;
+    private requestHeaders;
+    private actingAsUser;
+    constructor(method: string, path: string, headers: Headers, module: TestingModule, host?: string | null);
+    /**
+     * Set the request body
+     */
+    withBody(data: unknown): this;
+    /**
+     * Add headers to the request
+     */
+    withHeaders(headers: Record<string, string>): this;
+    /**
+     * Set Content-Type to application/json
+     */
+    asJson(): this;
+    /**
+     * Authenticate the request as a specific user
+     */
+    actingAs(user: {
+        id: string;
+    }): this;
+    /**
+     * Send the request and return response
+     *
+     * Calls module.fetch() - NOT SELF.fetch()
+     */
+    send(): Promise<TestResponse>;
+    private applyAuthentication;
+}
+//# sourceMappingURL=test-http-request.d.ts.map

package/dist/core/http/test-http-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-http-request.d.ts","sourceRoot":"","sources":["../../../src/core/http/test-http-request.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAe;IAM1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IATtB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAA8B;gBAGhC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAC7B,OAAO,EAAE,OAAO,EACC,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,MAAM,GAAG,IAAW;IAK5C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAK7B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAOlD;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKpC;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC;YAqBrB,mBAAmB;CAajC"}

package/dist/core/http/test-http-request.js

@@ -0,0 +1,106 @@
+import { AUTH_SERVICE } from '@stratal/framework/auth';
+import { ActingAs } from '../../auth';
+import { TestResponse } from './test-response';
+/**
+ * TestHttpRequest
+ *
+ * Request builder with fluent API for configuring test HTTP requests.
+ *
+ * @example
+ * ```typescript
+ * const response = await module.http
+ *   .post('/api/v1/register')
+ *   .withBody({ name: 'Test School' })
+ *   .withHeaders({ 'X-Custom': 'value' })
+ *   .send()
+ * ```
+ *
+ * @example Authenticated request
+ * ```typescript
+ * const response = await module.http
+ *   .get('/api/v1/profile')
+ *   .actingAs({ id: user.id })
+ *   .send()
+ * ```
+ */
+export class TestHttpRequest {
+    method;
+    path;
+    module;
+    host;
+    body = null;
+    requestHeaders;
+    actingAsUser = null;
+    constructor(method, path, headers, module, host = null) {
+        this.method = method;
+        this.path = path;
+        this.module = module;
+        this.host = host;
+        this.requestHeaders = new Headers(headers);
+    }
+    /**
+     * Set the request body
+     */
+    withBody(data) {
+        this.body = data;
+        return this;
+    }
+    /**
+     * Add headers to the request
+     */
+    withHeaders(headers) {
+        for (const [key, value] of Object.entries(headers)) {
+            this.requestHeaders.set(key, value);
+        }
+        return this;
+    }
+    /**
+     * Set Content-Type to application/json
+     */
+    asJson() {
+        this.requestHeaders.set('Content-Type', 'application/json');
+        return this;
+    }
+    /**
+     * Authenticate the request as a specific user
+     */
+    actingAs(user) {
+        this.actingAsUser = user;
+        return this;
+    }
+    /**
+     * Send the request and return response
+     *
+     * Calls module.fetch() - NOT SELF.fetch()
+     */
+    async send() {
+        await this.applyAuthentication();
+        // Auto-set Content-Type for body
+        if (this.body && !this.requestHeaders.has('Content-Type')) {
+            this.requestHeaders.set('Content-Type', 'application/json');
+        }
+        // Build request
+        const url = new URL(this.path, `http://${this.host ?? 'localhost'}`);
+        const request = new Request(url.toString(), {
+            method: this.method,
+            headers: this.requestHeaders,
+            body: this.body ? JSON.stringify(this.body) : null,
+        });
+        // Call module.fetch() - NO SELF.fetch()
+        const response = await this.module.fetch(request);
+        return new TestResponse(response);
+    }
+    async applyAuthentication() {
+        if (!this.actingAsUser)
+            return;
+        await this.module.runInRequestScope(async () => {
+            const authService = this.module.get(AUTH_SERVICE);
+            const actingAs = new ActingAs(authService);
+            const authHeaders = this.actingAsUser ? await actingAs.createSessionForUser(this.actingAsUser) : new Headers();
+            for (const [key, value] of authHeaders.entries()) {
+                this.requestHeaders.set(key, value);
+            }
+        });
+    }
+}
+//# sourceMappingURL=test-http-request.js.map