@nestia/e2e 11.0.0-dev.20260305 → 11.0.0-dev.20260312

package/lib/TestValidator.js

@@ -0,0 +1,495 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestValidator = void 0;
+const RandomGenerator_1 = require("./RandomGenerator");
+const json_equal_to_1 = require("./internal/json_equal_to");
+/**
+ * A comprehensive collection of E2E validation utilities for testing
+ * applications.
+ *
+ * TestValidator provides type-safe validation functions for common testing
+ * scenarios including condition checking, equality validation, error testing,
+ * HTTP error validation, pagination testing, search functionality validation,
+ * and sorting validation.
+ *
+ * Most functions use direct parameter passing for simplicity, while some
+ * maintain currying patterns for advanced composition. All provide detailed
+ * error messages for debugging failed assertions.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @example
+ *   ```typescript
+ *   // Basic condition testing
+ *   TestValidator.predicate("user should be authenticated", user.isAuthenticated);
+ *
+ *   // Equality validation
+ *   TestValidator.equals("API response should match expected", x, y);
+ *
+ *   // Error validation
+ *   TestValidator.error("should throw on invalid input", () => assertInput(""));
+ *   ```;
+ */
+var TestValidator;
+(function (TestValidator) {
+    /**
+     * Validates that a given condition evaluates to true.
+     *
+     * Supports synchronous boolean values, synchronous functions returning
+     * boolean, and asynchronous functions returning Promise<boolean>. The return
+     * type is automatically inferred based on the input type.
+     *
+     * @example
+     *   ```typescript
+     *   // Synchronous boolean
+     *   TestValidator.predicate("user should exist", user !== null);
+     *
+     *   // Synchronous function
+     *   TestValidator.predicate("array should be empty", () => arr.length === 0);
+     *
+     *   // Asynchronous function
+     *   await TestValidator.predicate("database should be connected",
+     *     async () => await db.ping()
+     *   );
+     *   ```;
+     *
+     * @param title - Descriptive title used in error messages when validation
+     *   fails
+     * @param condition - The condition to validate (boolean, function, or async
+     *   function)
+     * @returns Void or Promise<void> based on the input type
+     * @throws Error with descriptive message when condition is not satisfied
+     */
+    function predicate(title, condition) {
+        const message = () => `Bug on ${title}: expected condition is not satisfied.`;
+        // SCALAR
+        if (typeof condition === "boolean") {
+            if (condition !== true)
+                throw new Error(message());
+            return undefined;
+        }
+        // CLOSURE
+        const output = condition();
+        if (typeof output === "boolean") {
+            if (output !== true)
+                throw new Error(message());
+            return undefined;
+        }
+        // ASYNCHRONOUS
+        return new Promise((resolve, reject) => {
+            output
+                .then((flag) => {
+                if (flag === true)
+                    resolve();
+                else
+                    reject(message());
+            })
+                .catch(reject);
+        });
+    }
+    TestValidator.predicate = predicate;
+    /**
+     * Validates deep equality between two values using JSON comparison.
+     *
+     * Performs recursive comparison of objects and arrays. Supports an optional
+     * exception filter to ignore specific keys during comparison. Useful for
+     * validating API responses, data transformations, and object state changes.
+     *
+     * @example
+     *   ```typescript
+     *   // Basic equality
+     *   TestValidator.equals("response should match expected", expectedUser, actualUser);
+     *
+     *   // Ignore timestamps in comparison
+     *   TestValidator.equals("user data should match", expectedUser, actualUser,
+     *     (key) => key === "updatedAt"
+     *   );
+     *
+     *   // Validate API response structure
+     *   TestValidator.equals("API response structure",
+     *     { id: 1, name: "John" },
+     *     { id: 1, name: "John" }
+     *   );
+     *
+     *   // Type-safe nullable comparisons
+     *   const nullableData: { name: string } | null = getData();
+     *   TestValidator.equals("nullable check", nullableData, null);
+     *   ```;
+     *
+     * @param title - Descriptive title used in error messages when values differ
+     * @param X - The first value to compare
+     * @param y - The second value to compare (can be null or undefined)
+     * @param exception - Optional filter function to exclude specific keys from
+     *   comparison
+     * @throws Error with detailed diff information when values are not equal
+     */
+    function equals(title, X, y, exception) {
+        const diff = (0, json_equal_to_1.json_equal_to)(exception !== null && exception !== void 0 ? exception : (() => false))(X)(y);
+        if (diff.length)
+            throw new Error([
+                `Bug on ${title}: found different values - [${diff.join(", ")}]:`,
+                "\n",
+                JSON.stringify({ x: X, y }, null, 2),
+            ].join("\n"));
+    }
+    TestValidator.equals = equals;
+    /**
+     * Validates deep inequality between two values using JSON comparison.
+     *
+     * Performs recursive comparison of objects and arrays to ensure they are NOT
+     * equal. Supports an optional exception filter to ignore specific keys during
+     * comparison. Useful for validating that data has changed, objects are
+     * different, or mutations have occurred.
+     *
+     * @example
+     *   ```typescript
+     *   // Basic inequality
+     *   TestValidator.notEquals("user should be different after update", originalUser, updatedUser);
+     *
+     *   // Ignore timestamps in comparison
+     *   TestValidator.notEquals("user data should differ", originalUser, modifiedUser,
+     *     (key) => key === "updatedAt"
+     *   );
+     *
+     *   // Validate state changes
+     *   TestValidator.notEquals("state should have changed", initialState, currentState);
+     *
+     *   // Type-safe nullable comparisons
+     *   const mutableData: { count: number } | null = getMutableData();
+     *   TestValidator.notEquals("should have changed", mutableData, null);
+     *   ```;
+     *
+     * @param title - Descriptive title used in error messages when values are
+     *   equal
+     * @param x - The first value to compare
+     * @param y - The second value to compare (can be null or undefined)
+     * @param exception - Optional filter function to exclude specific keys from
+     *   comparison
+     * @throws Error when values are equal (indicating validation failure)
+     */
+    function notEquals(title, x, y, exception) {
+        const diff = (0, json_equal_to_1.json_equal_to)(exception !== null && exception !== void 0 ? exception : (() => false))(x)(y);
+        if (diff.length === 0)
+            throw new Error([
+                `Bug on ${title}: values should be different but are equal:`,
+                "\n",
+                JSON.stringify({ x, y }, null, 2),
+            ].join("\n"));
+    }
+    TestValidator.notEquals = notEquals;
+    /**
+     * Validates that a function throws an error or rejects when executed.
+     *
+     * Expects the provided function to fail. If the function executes
+     * successfully without throwing an error or rejecting, this validator will
+     * throw an exception. Supports both synchronous and asynchronous functions.
+     *
+     * @example
+     *   ```typescript
+     *   // Synchronous error validation
+     *   TestValidator.error("should reject invalid email",
+     *     () => validateEmail("invalid-email")
+     *   );
+     *
+     *   // Asynchronous error validation
+     *   await TestValidator.error("should reject unauthorized access",
+     *     async () => await api.functional.getSecretData()
+     *   );
+     *
+     *   // Validate input validation
+     *   TestValidator.error("should throw on empty string",
+     *     () => processRequiredInput("")
+     *   );
+     *   ```;
+     *
+     * @param title - Descriptive title used in error messages when no error
+     *   occurs
+     * @param task - The function that should throw an error or reject
+     * @returns Void or Promise<void> based on the input type
+     * @throws Error when the task function does not throw an error or reject
+     */
+    function error(title, task) {
+        const message = () => `Bug on ${title}: exception must be thrown.`;
+        try {
+            const output = task();
+            if (is_promise(output))
+                return new Promise((resolve, reject) => output.catch(() => resolve()).then(() => reject(message())));
+            else
+                throw new Error(message());
+        }
+        catch (_a) {
+            return undefined;
+        }
+    }
+    TestValidator.error = error;
+    /**
+     * Validates that a function throws an HTTP error with specific status codes.
+     *
+     * Specialized error validator for HTTP operations. Validates that the
+     * function throws an HttpError with one of the specified status codes. Useful
+     * for testing API endpoints, authentication, and authorization logic.
+     *
+     * @example
+     *   ```typescript
+     *   // Validate 401 Unauthorized
+     *   await TestValidator.httpError("should return 401 for invalid token", 401,
+     *     async () => await api.functional.getProtectedResource("invalid-token")
+     *   );
+     *
+     *   // Validate multiple possible error codes
+     *   await TestValidator.httpError("should return client error", [400, 404, 422],
+     *     async () => await api.functional.updateNonexistentResource(data)
+     *   );
+     *
+     *   // Validate server errors
+     *   TestValidator.httpError("should handle server errors", [500, 502, 503],
+     *     () => callFaultyEndpoint()
+     *   );
+     *   ```;
+     *
+     * @param title - Descriptive title used in error messages
+     * @param status - Expected status code(s), can be a single number or array
+     * @param task - The function that should throw an HttpError
+     * @returns Void or Promise<void> based on the input type
+     * @throws Error when function doesn't throw HttpError or status code doesn't
+     *   match
+     */
+    function httpError(title, status, task) {
+        if (typeof status === "number")
+            status = [status];
+        const message = (actual) => typeof actual === "number"
+            ? `Bug on ${title}: status code must be ${status.join(" or ")}, but ${actual}.`
+            : `Bug on ${title}: status code must be ${status.join(" or ")}, but succeeded.`;
+        const predicate = (exp) => typeof exp === "object" &&
+            exp.constructor.name === "HttpError" &&
+            status.some((val) => val === exp.status)
+            ? null
+            : new Error(message(typeof exp === "object" && exp.constructor.name === "HttpError"
+                ? exp.status
+                : undefined));
+        try {
+            const output = task();
+            if (is_promise(output))
+                return new Promise((resolve, reject) => output
+                    .catch((exp) => {
+                    const res = predicate(exp);
+                    if (res)
+                        reject(res);
+                    else
+                        resolve();
+                })
+                    .then(() => reject(new Error(message()))));
+            else
+                throw new Error(message());
+        }
+        catch (exp) {
+            const res = predicate(exp);
+            if (res)
+                throw res;
+            return undefined;
+        }
+    }
+    TestValidator.httpError = httpError;
+    /**
+     * Validates pagination index API results against expected entity order.
+     *
+     * Compares the order of entities returned by a pagination API with manually
+     * sorted expected results. Validates that entity IDs appear in the correct
+     * sequence. Commonly used for testing database queries, search results, and
+     * any paginated data APIs.
+     *
+     * @example
+     *   ```typescript
+     *   // Test article pagination
+     *   const expectedArticles = await db.articles.findAll({ order: 'created_at DESC' });
+     *   const actualArticles = await api.functional.getArticles({ page: 1, limit: 10 });
+     *
+     *   TestValidator.index("article pagination order", expectedArticles, actualArticles,
+     *     true // enable trace logging
+     *   );
+     *
+     *   // Test user search results
+     *   const manuallyFilteredUsers = allUsers.filter(u => u.name.includes("John"));
+     *   const apiSearchResults = await api.functional.searchUsers({ query: "John" });
+     *
+     *   TestValidator.index("user search results", manuallyFilteredUsers, apiSearchResults);
+     *   ```;
+     *
+     * @param title - Descriptive title used in error messages when order differs
+     * @param expected - The expected entities in correct order
+     * @param gotten - The actual entities returned by the API
+     * @param trace - Optional flag to enable debug logging (default: false)
+     * @throws Error when entity order differs between expected and actual results
+     */
+    TestValidator.index = (title, expected, gotten, trace = false) => {
+        const length = Math.min(expected.length, gotten.length);
+        expected = expected.slice(0, length);
+        gotten = gotten.slice(0, length);
+        const xIds = get_ids(expected).slice(0, length);
+        const yIds = get_ids(gotten)
+            .filter((id) => id >= xIds[0])
+            .slice(0, length);
+        const equals = xIds.every((x, i) => x === yIds[i]);
+        if (equals === true)
+            return;
+        else if (trace === true)
+            console.log({
+                expected: xIds,
+                gotten: yIds,
+            });
+        throw new Error(`Bug on ${title}: result of the index is different with manual aggregation.`);
+    };
+    /**
+     * Validates search functionality by testing API results against manual
+     * filtering.
+     *
+     * Comprehensive search validation that samples entities from a complete
+     * dataset, extracts search values, applies manual filtering, calls the search
+     * API, and compares results. Validates that search APIs return the correct
+     * subset of data matching the search criteria.
+     *
+     * @example
+     *   ```typescript
+     *   // Test article search functionality with exact matching
+     *   const allArticles = await db.articles.findAll();
+     *   const searchValidator = TestValidator.search(
+     *     "article search API",
+     *     (req) => api.searchArticles(req),
+     *     allArticles,
+     *     5 // test with 5 random samples
+     *   );
+     *
+     *   // Test exact match search
+     *   await searchValidator({
+     *     fields: ["title"],
+     *     values: (article) => [article.title], // full title for exact match
+     *     filter: (article, [title]) => article.title === title, // exact match
+     *     request: ([title]) => ({ search: { title } })
+     *   });
+     *
+     *   // Test partial match search with includes
+     *   await searchValidator({
+     *     fields: ["content"],
+     *     values: (article) => [article.content.substring(0, 20)], // partial content
+     *     filter: (article, [keyword]) => article.content.includes(keyword),
+     *     request: ([keyword]) => ({ q: keyword })
+     *   });
+     *
+     *   // Test multi-field search with exact matching
+     *   await searchValidator({
+     *     fields: ["writer", "title"],
+     *     values: (article) => [article.writer, article.title],
+     *     filter: (article, [writer, title]) =>
+     *       article.writer === writer && article.title === title,
+     *     request: ([writer, title]) => ({ search: { writer, title } })
+     *   });
+     *   ```;
+     *
+     * @param title - Descriptive title used in error messages when search fails
+     * @param getter - API function that performs the search
+     * @param total - Complete dataset to sample from for testing
+     * @param sampleCount - Number of random samples to test (default: 1)
+     * @returns A function that accepts search configuration properties
+     * @throws Error when API search results don't match manual filtering results
+     */
+    TestValidator.search = (title, getter, total, sampleCount = 1) => (props) => __awaiter(this, void 0, void 0, function* () {
+        const samples = RandomGenerator_1.RandomGenerator.sample(total, sampleCount);
+        for (const s of samples) {
+            const values = props.values(s);
+            const filtered = total.filter((entity) => props.filter(entity, values));
+            const gotten = yield getter(props.request(values));
+            TestValidator.index(`${title} (${props.fields.join(", ")})`, filtered, gotten);
+        }
+    });
+    /**
+     * Validates sorting functionality of pagination APIs.
+     *
+     * Tests sorting operations by calling the API with sort parameters and
+     * validating that results are correctly ordered. Supports multiple fields,
+     * ascending/descending order, and optional filtering. Provides detailed error
+     * reporting for sorting failures.
+     *
+     * @example
+     *   ```typescript
+     *   // Test single field sorting with GaffComparator
+     *   const sortValidator = TestValidator.sort(
+     *     "article sorting",
+     *     (sortable) => api.getArticles({ sort: sortable })
+     *   )("created_at")(
+     *     GaffComparator.dates((a) => a.created_at)
+     *   );
+     *
+     *   await sortValidator("+"); // ascending
+     *   await sortValidator("-"); // descending
+     *
+     *   // Test multi-field sorting with GaffComparator
+     *   const userSortValidator = TestValidator.sort(
+     *     "user sorting",
+     *     (sortable) => api.getUsers({ sort: sortable })
+     *   )("lastName", "firstName")(
+     *     GaffComparator.strings((user) => [user.lastName, user.firstName]),
+     *     (user) => user.isActive // only test active users
+     *   );
+     *
+     *   await userSortValidator("+", true); // ascending with trace logging
+     *
+     *   // Custom comparator for complex logic
+     *   const customSortValidator = TestValidator.sort(
+     *     "custom sorting",
+     *     (sortable) => api.getProducts({ sort: sortable })
+     *   )("price", "rating")(
+     *     (a, b) => {
+     *       const priceDiff = a.price - b.price;
+     *       return priceDiff !== 0 ? priceDiff : b.rating - a.rating; // price asc, rating desc
+     *     }
+     *   );
+     *   ```;
+     *
+     * @param title - Descriptive title used in error messages when sorting fails
+     * @param getter - API function that fetches sorted data
+     * @returns A currying function chain: field names, comparator, then direction
+     * @throws Error when API results are not properly sorted according to
+     *   specification
+     */
+    TestValidator.sort = (title, getter) => (...fields) => (comp, filter) => (direction_1, ...args_1) => __awaiter(this, [direction_1, ...args_1], void 0, function* (direction, trace = false) {
+        let data = yield getter(fields.map((field) => `${direction}${field}`));
+        if (filter)
+            data = data.filter(filter);
+        const reversed = direction === "+" ? comp : (x, y) => comp(y, x);
+        if (is_sorted(data, reversed) === false) {
+            if (fields.length === 1 &&
+                data.length &&
+                data[0][fields[0]] !== undefined &&
+                trace)
+                console.log(data.map((elem) => elem[fields[0]]));
+            throw new Error(`Bug on ${title}: wrong sorting on ${direction}(${fields.join(", ")}).`);
+        }
+    });
+})(TestValidator || (exports.TestValidator = TestValidator = {}));
+/** @internal */
+function get_ids(entities) {
+    return entities.map((entity) => entity.id).sort((x, y) => (x < y ? -1 : 1));
+}
+/** @internal */
+function is_promise(input) {
+    return (typeof input === "object" &&
+        input !== null &&
+        typeof input.then === "function" &&
+        typeof input.catch === "function");
+}
+/** @internal */
+function is_sorted(data, comp) {
+    for (let i = 1; i < data.length; ++i)
+        if (comp(data[i - 1], data[i]) > 0)
+            return false;
+    return true;
+}
+//# sourceMappingURL=TestValidator.js.map

package/lib/TestValidator.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+import * as e2e from "./module";
+export default e2e;
+export * from "./module";

package/lib/index.js

@@ -0,0 +1,42 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const e2e = __importStar(require("./module"));
+exports.default = e2e;
+__exportStar(require("./module"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8CAAgC;AAEhC,kBAAe,GAAG,CAAC;AACnB,2CAAyB"}

package/lib/internal/json_equal_to.d.ts

@@ -0,0 +1 @@
+export declare const json_equal_to: (exception: (key: string) => boolean) => <T>(x: T) => (y: T | null | undefined) => string[];

package/lib/internal/json_equal_to.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.json_equal_to = void 0;
+const json_equal_to = (exception) => (x) => (y) => {
+    const container = [];
+    const iterate = (accessor) => (x) => (y) => {
+        if (typeof x === "function" || typeof y === "function")
+            return;
+        else if (typeof x !== typeof y)
+            container.push(accessor);
+        else if (x instanceof Array)
+            if (!(y instanceof Array))
+                container.push(accessor);
+            else
+                array(accessor)(x)(y);
+        else if (x instanceof Object)
+            object(accessor)(x)(y);
+        else if (x !== y)
+            container.push(accessor);
+    };
+    const array = (accessor) => (x) => (y) => {
+        if (x.length !== y.length)
+            container.push(`${accessor}.length`);
+        x.forEach((xItem, i) => iterate(`${accessor}[${i}]`)(xItem)(y[i]));
+    };
+    const object = (accessor) => (x) => (y) => Object.keys(x)
+        .filter((key) => x[key] !== undefined && !exception(key))
+        .forEach((key) => iterate(`${accessor}.${key}`)(x[key])(y[key]));
+    iterate("")(x)(y);
+    return container;
+};
+exports.json_equal_to = json_equal_to;
+//# sourceMappingURL=json_equal_to.js.map

package/lib/internal/json_equal_to.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json_equal_to.js","sourceRoot":"","sources":["../../src/internal/json_equal_to.ts"],"names":[],"mappings":";;;AAAO,MAAM,aAAa,GACxB,CAAC,SAAmC,EAAE,EAAE,CACxC,CAAI,CAAI,EAAE,EAAE,CACZ,CAAC,CAAuB,EAAY,EAAE;IACpC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,OAAO,GACX,CAAC,QAAgB,EAAE,EAAE,CACrB,CAAC,CAAM,EAAE,EAAE,CACX,CAAC,CAAM,EAAQ,EAAE;QACf,IAAI,OAAO,CAAC,KAAK,UAAU,IAAI,OAAO,CAAC,KAAK,UAAU;YAAE,OAAO;aAC1D,IAAI,OAAO,CAAC,KAAK,OAAO,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aACpD,IAAI,CAAC,YAAY,KAAK;YACzB,IAAI,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC;gBAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;;gBAC/C,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACxB,IAAI,CAAC,YAAY,MAAM;YAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAChD,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC;IACJ,MAAM,KAAK,GACT,CAAC,QAAgB,EAAE,EAAE,CACrB,CAAC,CAAQ,EAAE,EAAE,CACb,CAAC,CAAQ,EAAQ,EAAE;QACjB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,SAAS,CAAC,IAAI,CAAC,GAAG,QAAQ,SAAS,CAAC,CAAC;QAChE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC;IACJ,MAAM,MAAM,GACV,CAAC,QAAgB,EAAE,EAAE,CACrB,CAAC,CAAM,EAAE,EAAE,CACX,CAAC,CAAM,EAAQ,EAAE,CACf,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;SACX,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;SACxD,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEvE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClB,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAlCS,QAAA,aAAa,iBAkCtB"}

package/lib/module.d.ts

@@ -0,0 +1,6 @@
+export * from "./ArrayUtil";
+export * from "./MapUtil";
+export * from "./RandomGenerator";
+export * from "./DynamicExecutor";
+export * from "./GaffComparator";
+export * from "./TestValidator";

package/lib/module.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ArrayUtil"), exports);
+__exportStar(require("./MapUtil"), exports);
+__exportStar(require("./RandomGenerator"), exports);
+__exportStar(require("./DynamicExecutor"), exports);
+__exportStar(require("./GaffComparator"), exports);
+__exportStar(require("./TestValidator"), exports);
+//# sourceMappingURL=module.js.map

package/lib/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,4CAA0B;AAC1B,oDAAkC;AAElC,oDAAkC;AAClC,mDAAiC;AACjC,kDAAgC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/e2e",
-  "version": "11.0.0-dev.20260305",
+  "version": "11.0.0-dev.20260312",
   "description": "E2E test utilify functions",
   "main": "lib/index.js",
   "exports": {