@stratal/testing 0.0.1

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

@@ -0,0 +1,309 @@
+import { expect } from 'vitest';
+/**
+ * TestResponse
+ *
+ * Wrapper around Response with assertion methods.
+ *
+ * @example
+ * ```typescript
+ * response
+ *   .assertOk()
+ *   .assertStatus(200)
+ *   .assertJsonPath('data.id', userId)
+ * ```
+ */
+export class TestResponse {
+    response;
+    jsonData = null;
+    textData = null;
+    constructor(response) {
+        this.response = response;
+    }
+    /**
+     * Get the raw Response object.
+     */
+    get raw() {
+        return this.response;
+    }
+    /**
+     * Get the response status code.
+     */
+    get status() {
+        return this.response.status;
+    }
+    /**
+     * Get response headers.
+     */
+    get headers() {
+        return this.response.headers;
+    }
+    /**
+     * Get the response body as JSON.
+     */
+    async json() {
+        if (this.jsonData === null) {
+            this.jsonData = await this.response.clone().json();
+        }
+        return this.jsonData;
+    }
+    /**
+     * Get the response body as text.
+     */
+    async text() {
+        this.textData ??= await this.response.clone().text();
+        return this.textData;
+    }
+    // ============================================================
+    // Status Assertions
+    // ============================================================
+    /**
+     * Assert response status is 200 OK.
+     */
+    assertOk() {
+        return this.assertStatus(200);
+    }
+    /**
+     * Assert response status is 201 Created.
+     */
+    assertCreated() {
+        return this.assertStatus(201);
+    }
+    /**
+     * Assert response status is 204 No Content.
+     */
+    assertNoContent() {
+        return this.assertStatus(204);
+    }
+    /**
+     * Assert response status is 400 Bad Request.
+     */
+    assertBadRequest() {
+        return this.assertStatus(400);
+    }
+    /**
+     * Assert response status is 401 Unauthorized.
+     */
+    assertUnauthorized() {
+        return this.assertStatus(401);
+    }
+    /**
+     * Assert response status is 403 Forbidden.
+     */
+    assertForbidden() {
+        return this.assertStatus(403);
+    }
+    /**
+     * Assert response status is 404 Not Found.
+     */
+    assertNotFound() {
+        return this.assertStatus(404);
+    }
+    /**
+     * Assert response status is 422 Unprocessable Entity.
+     */
+    assertUnprocessable() {
+        return this.assertStatus(422);
+    }
+    /**
+     * Assert response status is 500 Internal Server Error.
+     */
+    assertServerError() {
+        return this.assertStatus(500);
+    }
+    /**
+     * Assert response has the given status code.
+     */
+    assertStatus(expected) {
+        expect(this.response.status, `Expected status ${expected}, got ${this.response.status}`).toBe(expected);
+        return this;
+    }
+    /**
+     * Assert response status is in the 2xx success range.
+     */
+    assertSuccessful() {
+        expect(this.response.status >= 200 && this.response.status < 300, `Expected successful status (2xx), got ${this.response.status}`).toBe(true);
+        return this;
+    }
+    // ============================================================
+    // JSON Assertions
+    // ============================================================
+    /**
+     * Assert JSON response contains the given data.
+     */
+    async assertJson(expected) {
+        const actual = await this.json();
+        for (const [key, value] of Object.entries(expected)) {
+            expect(actual[key], `Expected JSON key "${key}" to be ${JSON.stringify(value)}, got ${JSON.stringify(actual[key])}`).toBe(value);
+        }
+        return this;
+    }
+    /**
+     * Assert JSON response has value at the given path.
+     *
+     * @param path - Dot-notation path (e.g., 'data.user.id')
+     * @param expected - Expected value at path
+     */
+    async assertJsonPath(path, expected) {
+        const json = await this.json();
+        const actual = this.getValueAtPath(json, path);
+        expect(actual, `Expected JSON path "${path}" to be ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`).toBe(expected);
+        return this;
+    }
+    /**
+     * Assert JSON response structure matches the given schema.
+     */
+    async assertJsonStructure(structure) {
+        const json = await this.json();
+        for (const key of structure) {
+            expect(key in json, `Expected JSON to have key "${key}", got keys: ${JSON.stringify(Object.keys(json))}`).toBe(true);
+        }
+        return this;
+    }
+    /**
+     * Assert a JSON path exists (value can be anything, including null).
+     *
+     * @param path - Dot-notation path (e.g., 'data.user.id')
+     */
+    async assertJsonPathExists(path) {
+        const json = await this.json();
+        const exists = this.hasValueAtPath(json, path);
+        expect(exists, `Expected JSON path "${path}" to exist`).toBe(true);
+        return this;
+    }
+    /**
+     * Assert a JSON path does not exist.
+     *
+     * @param path - Dot-notation path (e.g., 'data.user.deletedAt')
+     */
+    async assertJsonPathMissing(path) {
+        const json = await this.json();
+        const exists = this.hasValueAtPath(json, path);
+        expect(exists, `Expected JSON path "${path}" to not exist`).toBe(false);
+        return this;
+    }
+    /**
+     * Assert JSON value at path matches a custom predicate.
+     *
+     * @param path - Dot-notation path (e.g., 'data.items')
+     * @param matcher - Predicate function to validate the value
+     */
+    async assertJsonPathMatches(path, matcher) {
+        const json = await this.json();
+        const value = this.getValueAtPath(json, path);
+        expect(matcher(value), `Expected JSON path "${path}" to match predicate, got ${JSON.stringify(value)}`).toBe(true);
+        return this;
+    }
+    /**
+     * Assert string value at path contains a substring.
+     *
+     * @param path - Dot-notation path (e.g., 'data.message')
+     * @param substring - Substring to search for
+     */
+    async assertJsonPathContains(path, substring) {
+        const json = await this.json();
+        const value = this.getValueAtPath(json, path);
+        expect(typeof value === 'string', `Expected JSON path "${path}" to be a string, got ${typeof value}`).toBe(true);
+        expect(value.includes(substring), `Expected JSON path "${path}" to contain "${substring}", got "${String(value)}"`).toBe(true);
+        return this;
+    }
+    /**
+     * Assert array value at path includes a specific item.
+     *
+     * @param path - Dot-notation path (e.g., 'data.tags')
+     * @param item - Item to search for in the array
+     */
+    async assertJsonPathIncludes(path, item) {
+        const json = await this.json();
+        const value = this.getValueAtPath(json, path);
+        expect(Array.isArray(value), `Expected JSON path "${path}" to be an array, got ${typeof value}`).toBe(true);
+        expect(value.includes(item), `Expected JSON path "${path}" to include ${JSON.stringify(item)}`).toBe(true);
+        return this;
+    }
+    /**
+     * Assert array length at path equals the expected count.
+     *
+     * @param path - Dot-notation path (e.g., 'data.items')
+     * @param count - Expected array length
+     */
+    async assertJsonPathCount(path, count) {
+        const json = await this.json();
+        const value = this.getValueAtPath(json, path);
+        expect(Array.isArray(value), `Expected JSON path "${path}" to be an array, got ${typeof value}`).toBe(true);
+        expect(value.length, `Expected JSON path "${path}" to have ${count} items, got ${value.length}`).toBe(count);
+        return this;
+    }
+    /**
+     * Assert multiple JSON paths at once (batch assertion).
+     *
+     * @param expectations - Object mapping paths to expected values
+     */
+    async assertJsonPaths(expectations) {
+        const json = await this.json();
+        for (const [path, expected] of Object.entries(expectations)) {
+            const actual = this.getValueAtPath(json, path);
+            expect(actual, `Expected JSON path "${path}" to be ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`).toBe(expected);
+        }
+        return this;
+    }
+    // ============================================================
+    // Header Assertions
+    // ============================================================
+    /**
+     * Assert response has the given header.
+     */
+    assertHeader(name, expected) {
+        const actual = this.response.headers.get(name);
+        expect(actual !== null, `Expected header "${name}" to be present`).toBe(true);
+        if (expected !== undefined) {
+            expect(actual, `Expected header "${name}" to be "${expected}", got "${actual}"`).toBe(expected);
+        }
+        return this;
+    }
+    /**
+     * Assert response does not have the given header.
+     */
+    assertHeaderMissing(name) {
+        const actual = this.response.headers.get(name);
+        expect(actual, `Expected header "${name}" to be absent, but got "${actual}"`).toBeNull();
+        return this;
+    }
+    // ============================================================
+    // Private Helpers
+    // ============================================================
+    /**
+     * Get value at dot-notation path.
+     */
+    getValueAtPath(obj, path) {
+        const parts = path.split('.');
+        let current = obj;
+        for (const part of parts) {
+            if (current === null || current === undefined) {
+                return undefined;
+            }
+            current = current[part];
+        }
+        return current;
+    }
+    /**
+     * Check if a path exists in the object (even if value is null/undefined).
+     */
+    hasValueAtPath(obj, path) {
+        const parts = path.split('.');
+        let current = obj;
+        for (const part of parts) {
+            if (current === null || current === undefined) {
+                return false;
+            }
+            if (typeof current !== 'object') {
+                return false;
+            }
+            const record = current;
+            if (!(part in record)) {
+                return false;
+            }
+            current = record[part];
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=test-response.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-response.js","sourceRoot":"","sources":["../../../src/core/http/test-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAY;IAIM;IAHrB,QAAQ,GAAY,IAAI,CAAA;IACxB,QAAQ,GAAkB,IAAI,CAAA;IAEtC,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEnD;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAA;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAA;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAA;QACpD,CAAC;QACD,OAAO,IAAI,CAAC,QAAa,CAAA;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAA;QACpD,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,+DAA+D;IAC/D,oBAAoB;IACpB,+DAA+D;IAE/D;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAAgB;QAC3B,MAAM,CACJ,IAAI,CAAC,QAAQ,CAAC,MAAM,EACpB,mBAAmB,QAAQ,SAAS,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAC3D,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,MAAM,CACJ,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,EACzD,yCAAyC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACZ,OAAO,IAAI,CAAA;IACb,CAAC;IAED,+DAA+D;IAC/D,kBAAkB;IAClB,+DAA+D;IAE/D;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,QAAiC;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAA2B,CAAA;QAEzD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,MAAM,CACJ,MAAM,CAAC,GAAG,CAAC,EACX,sBAAsB,GAAG,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAChG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACf,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,QAAiB;QAClD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAE9C,MAAM,CACJ,MAAM,EACN,uBAAuB,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAChG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAEhB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,SAAmB;QAC3C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAA2B,CAAA;QAEvD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,CACJ,GAAG,IAAI,IAAI,EACX,8BAA8B,GAAG,gBAAgB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CACrF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACd,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,oBAAoB,CAAC,IAAY;QACrC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAE9C,MAAM,CACJ,MAAM,EACN,uBAAuB,IAAI,YAAY,CACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,qBAAqB,CAAC,IAAY;QACtC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAE9C,MAAM,CACJ,MAAM,EACN,uBAAuB,IAAI,gBAAgB,CAC5C,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAEb,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,qBAAqB,CACzB,IAAY,EACZ,OAAoC;QAEpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAE7C,MAAM,CACJ,OAAO,CAAC,KAAK,CAAC,EACd,uBAAuB,IAAI,6BAA6B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAChF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,sBAAsB,CAAC,IAAY,EAAE,SAAiB;QAC1D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAE7C,MAAM,CACJ,OAAO,KAAK,KAAK,QAAQ,EACzB,uBAAuB,IAAI,yBAAyB,OAAO,KAAK,EAAE,CACnE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,MAAM,CACH,KAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EACrC,uBAAuB,IAAI,iBAAiB,SAAS,WAAW,MAAM,CAAC,KAAK,CAAC,GAAG,CACjF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,sBAAsB,CAAC,IAAY,EAAE,IAAa;QACtD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAE7C,MAAM,CACJ,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB,uBAAuB,IAAI,yBAAyB,OAAO,KAAK,EAAE,CACnE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,MAAM,CACH,KAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,EACnC,uBAAuB,IAAI,gBAAgB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAClE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB,CAAC,IAAY,EAAE,KAAa;QACnD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAE7C,MAAM,CACJ,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB,uBAAuB,IAAI,yBAAyB,OAAO,KAAK,EAAE,CACnE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,MAAM,CACH,KAAmB,CAAC,MAAM,EAC3B,uBAAuB,IAAI,aAAa,KAAK,eAAgB,KAAmB,CAAC,MAAM,EAAE,CAC1F,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAEb,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,YAAqC;QACzD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAE9B,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAC9C,MAAM,CACJ,MAAM,EACN,uBAAuB,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAChG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAClB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,+DAA+D;IAC/D,oBAAoB;IACpB,+DAA+D;IAE/D;;OAEG;IACH,YAAY,CAAC,IAAY,EAAE,QAAiB;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAE9C,MAAM,CACJ,MAAM,KAAK,IAAI,EACf,oBAAoB,IAAI,iBAAiB,CAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CACJ,MAAM,EACN,oBAAoB,IAAI,YAAY,QAAQ,WAAW,MAAM,GAAG,CACjE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAClB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,IAAY;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAE9C,MAAM,CACJ,MAAM,EACN,oBAAoB,IAAI,4BAA4B,MAAM,GAAG,CAC9D,CAAC,QAAQ,EAAE,CAAA;QAEZ,OAAO,IAAI,CAAA;IACb,CAAC;IAED,+DAA+D;IAC/D,kBAAkB;IAClB,+DAA+D;IAE/D;;OAEG;IACK,cAAc,CAAC,GAAY,EAAE,IAAY;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC7B,IAAI,OAAO,GAAY,GAAG,CAAA;QAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC9C,OAAO,SAAS,CAAA;YAClB,CAAC;YACD,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAA;QACtD,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,GAAY,EAAE,IAAY;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC7B,IAAI,OAAO,GAAY,GAAG,CAAA;QAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC9C,OAAO,KAAK,CAAA;YACd,CAAC;YAED,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAA;YACd,CAAC;YAED,MAAM,MAAM,GAAG,OAAkC,CAAA;YAEjD,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC;gBACtB,OAAO,KAAK,CAAA;YACd,CAAC;YAED,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export { getTestEnv } from './env';
+export { TestHttpClient, TestHttpRequest, TestResponse } from './http';
+export { ProviderOverrideBuilder, type ProviderOverrideConfig } from './override';
+export { Test } from './test';
+export { TestingModule } from './testing-module';
+export { TestingModuleBuilder, type TestingModuleConfig } from './testing-module-builder';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAClC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,7 @@
+export { getTestEnv } from './env';
+export { TestHttpClient, TestHttpRequest, TestResponse } from './http';
+export { ProviderOverrideBuilder } from './override';
+export { Test } from './test';
+export { TestingModule } from './testing-module';
+export { TestingModuleBuilder } from './testing-module-builder';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAClC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAA+B,MAAM,YAAY,CAAA;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,0BAA0B,CAAA"}

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

@@ -0,0 +1,2 @@
+export { ProviderOverrideBuilder, type ProviderOverrideConfig } from './provider-override-builder';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/override/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/core/override/index.js

@@ -0,0 +1,2 @@
+export { ProviderOverrideBuilder } from './provider-override-builder';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/override/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAA+B,MAAM,6BAA6B,CAAA"}

package/dist/core/override/provider-override-builder.d.ts

@@ -0,0 +1,77 @@
+import type { Container, InjectionToken } from 'stratal';
+import type { TestingModuleBuilder } from '../testing-module-builder';
+/**
+ * Provider override configuration
+ */
+export interface ProviderOverrideConfig<T = unknown> {
+    token: InjectionToken<T>;
+    type: 'value' | 'class' | 'factory' | 'existing';
+    implementation: T | (new (...args: unknown[]) => T) | ((container: Container) => T) | InjectionToken<T>;
+}
+/**
+ * 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 declare class ProviderOverrideBuilder<T> {
+    private readonly parent;
+    private readonly token;
+    constructor(parent: TestingModuleBuilder, token: InjectionToken<T>);
+    /**
+     * 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: T): TestingModuleBuilder;
+    /**
+     * 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: new (...args: unknown[]) => T): TestingModuleBuilder;
+    /**
+     * 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: (container: Container) => T): TestingModuleBuilder;
+    /**
+     * 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: InjectionToken<T>): TestingModuleBuilder;
+}
+//# sourceMappingURL=provider-override-builder.d.ts.map

package/dist/core/override/provider-override-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-override-builder.d.ts","sourceRoot":"","sources":["../../../src/core/override/provider-override-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAErE;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,OAAO;IACjD,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;IACxB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAA;IAChD,cAAc,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,KAAK,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;CACxG;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,uBAAuB,CAAC,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IAG3C;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,oBAAoB;IAQxC;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,oBAAoB;IAQlE;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,CAAC,GAAG,oBAAoB;IAQtE;;;;;;;;;;;;;;;;;OAiBG;IACH,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,oBAAoB;CAOpE"}

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, ModuleClass } from 'stratal';
+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,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACzD,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"}