@nestia/e2e 10.0.2 → 11.0.0-dev.20260305

package/lib/GaffComparator.js

@@ -1,286 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GaffComparator = void 0;
-/**
- * Type-safe comparator functions for Array.sort() operations with advanced
- * field access.
- *
- * GaffComparator provides a collection of specialized comparator functions
- * designed to work seamlessly with Array.sort() and testing frameworks like
- * TestValidator.sort(). Each comparator supports both single values and arrays
- * of values, enabling complex multi-field sorting scenarios with lexicographic
- * ordering.
- *
- * Key features:
- *
- * - Generic type safety for any object structure
- * - Support for single values or arrays of values per field
- * - Lexicographic comparison for multi-value scenarios
- * - Locale-aware string comparison
- * - Automatic type conversion for dates and numbers
- *
- * The comparators follow the standard JavaScript sort contract:
- *
- * - Return < 0 if first element should come before second
- * - Return > 0 if first element should come after second
- * - Return 0 if elements are equal
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @example
- *   ```typescript
- *   // Basic usage with single fields
- *   users.sort(GaffComparator.strings(user => user.name));
- *   posts.sort(GaffComparator.dates(post => post.createdAt));
- *   products.sort(GaffComparator.numbers(product => product.price));
- *
- *   // Multi-field sorting with arrays
- *   users.sort(GaffComparator.strings(user => [user.lastName, user.firstName]));
- *   events.sort(GaffComparator.dates(event => [event.startDate, event.endDate]));
- *
- *   // Integration with TestValidator's currying pattern
- *   const validator = TestValidator.sort("user sorting",
- *     (sortable) => api.getUsers({ sort: sortable })
- *   )("name", "email")(
- *     GaffComparator.strings(user => [user.name, user.email])
- *   );
- *   await validator("+"); // ascending
- *   await validator("-"); // descending
- *   ```;
- */
-var GaffComparator;
-(function (GaffComparator) {
-    /**
-     * Creates a comparator function for string-based sorting with locale-aware
-     * comparison.
-     *
-     * Generates a comparator that extracts string values from objects and
-     * performs lexicographic comparison using locale-sensitive string comparison.
-     * Supports both single strings and arrays of strings for multi-field sorting
-     * scenarios.
-     *
-     * When comparing arrays, performs lexicographic ordering: compares the first
-     * elements, then the second elements if the first are equal, and so on. This
-     * enables complex sorting like "sort by last name, then by first name".
-     *
-     * @example
-     *   ```typescript
-     *   interface User {
-     *     id: string;
-     *     firstName: string;
-     *     lastName: string;
-     *     email: string;
-     *     status: 'active' | 'inactive';
-     *   }
-     *
-     *   const users: User[] = [
-     *     { id: '1', firstName: 'John', lastName: 'Doe', email: 'john@example.com', status: 'active' },
-     *     { id: '2', firstName: 'Jane', lastName: 'Doe', email: 'jane@example.com', status: 'inactive' },
-     *     { id: '3', firstName: 'Bob', lastName: 'Smith', email: 'bob@example.com', status: 'active' }
-     *   ];
-     *
-     *   // Single field sorting
-     *   users.sort(GaffComparator.strings(user => user.lastName));
-     *   // Result: Doe, Doe, Smith
-     *
-     *   // Multi-field sorting: last name, then first name
-     *   users.sort(GaffComparator.strings(user => [user.lastName, user.firstName]));
-     *   // Result: Doe Jane, Doe John, Smith Bob
-     *
-     *   // Status-based sorting
-     *   users.sort(GaffComparator.strings(user => user.status));
-     *   // Result: active users first, then inactive
-     *
-     *   // Complex multi-field: status, then last name, then first name
-     *   users.sort(GaffComparator.strings(user => [user.status, user.lastName, user.firstName]));
-     *
-     *   // Integration with TestValidator sorting validation
-     *   const sortValidator = TestValidator.sort("user name sorting",
-     *     (sortFields) => userApi.getUsers({ sort: sortFields })
-     *   )("lastName", "firstName")(
-     *     GaffComparator.strings(user => [user.lastName, user.firstName])
-     *   );
-     *   await sortValidator("+"); // test ascending order
-     *   await sortValidator("-"); // test descending order
-     *   ```;
-     *
-     * @template T - The type of objects being compared
-     * @param getter - Function that extracts string value(s) from input objects
-     * @returns A comparator function suitable for Array.sort()
-     */
-    GaffComparator.strings = function (getter) {
-        return function (x, y) {
-            var a = wrap(getter(x));
-            var b = wrap(getter(y));
-            var idx = a.findIndex(function (v, i) { return v !== b[i]; });
-            return idx !== -1 ? compare(a[idx], b[idx]) : 0;
-        };
-    };
-    /**
-     * Creates a comparator function for date-based sorting with automatic string
-     * parsing.
-     *
-     * Generates a comparator that extracts date values from objects,
-     * automatically converting string representations to Date objects for
-     * numerical comparison. Supports both single dates and arrays of dates for
-     * complex temporal sorting.
-     *
-     * Date strings are parsed using the standard Date constructor, which supports
-     * ISO 8601 format, RFC 2822 format, and other common date representations.
-     * The comparison is performed on millisecond timestamps for precise
-     * ordering.
-     *
-     * @example
-     *   ```typescript
-     *   interface Event {
-     *     id: string;
-     *     title: string;
-     *     startDate: string;
-     *     endDate: string;
-     *     createdAt: string;
-     *     updatedAt: string;
-     *   }
-     *
-     *   const events: Event[] = [
-     *     {
-     *       id: '1',
-     *       title: 'Conference',
-     *       startDate: '2024-03-15T09:00:00Z',
-     *       endDate: '2024-03-15T17:00:00Z',
-     *       createdAt: '2024-01-10T10:00:00Z',
-     *       updatedAt: '2024-02-01T15:30:00Z'
-     *     },
-     *     {
-     *       id: '2',
-     *       title: 'Workshop',
-     *       startDate: '2024-03-10T14:00:00Z',
-     *       endDate: '2024-03-10T16:00:00Z',
-     *       createdAt: '2024-01-15T11:00:00Z',
-     *       updatedAt: '2024-01-20T09:15:00Z'
-     *     }
-     *   ];
-     *
-     *   // Sort by start date (chronological order)
-     *   events.sort(GaffComparator.dates(event => event.startDate));
-     *
-     *   // Sort by creation date (oldest first)
-     *   events.sort(GaffComparator.dates(event => event.createdAt));
-     *
-     *   // Multi-field: start date, then end date
-     *   events.sort(GaffComparator.dates(event => [event.startDate, event.endDate]));
-     *
-     *   // Sort by modification history: created date, then updated date
-     *   events.sort(GaffComparator.dates(event => [event.createdAt, event.updatedAt]));
-     *
-     *   // Validate API date sorting with TestValidator
-     *   const dateValidator = TestValidator.sort("event chronological sorting",
-     *     (sortFields) => eventApi.getEvents({ sort: sortFields })
-     *   )("startDate")(
-     *     GaffComparator.dates(event => event.startDate)
-     *   );
-     *   await dateValidator("+", true); // ascending with trace logging
-     *
-     *   // Test complex date-based sorting
-     *   const sortByEventSchedule = GaffComparator.dates(event => [
-     *     event.startDate,
-     *     event.endDate
-     *   ]);
-     *   ```;
-     *
-     * @template T - The type of objects being compared
-     * @param getter - Function that extracts date string(s) from input objects
-     * @returns A comparator function suitable for Array.sort()
-     */
-    GaffComparator.dates = function (getter) {
-        return function (x, y) {
-            var take = function (v) {
-                return wrap(getter(v)).map(function (str) { return new Date(str).getTime(); });
-            };
-            var a = take(x);
-            var b = take(y);
-            var idx = a.findIndex(function (v, i) { return v !== b[i]; });
-            return idx !== -1 ? a[idx] - b[idx] : 0;
-        };
-    };
-    /**
-     * Creates a comparator function for numerical sorting with multi-value
-     * support.
-     *
-     * Generates a comparator that extracts numerical values from objects and
-     * performs mathematical comparison. Supports both single numbers and arrays
-     * of numbers for complex numerical sorting scenarios like sorting by price
-     * then by rating.
-     *
-     * When comparing arrays, performs lexicographic numerical ordering: compares
-     * the first numbers, then the second numbers if the first are equal, and so
-     * on. This enables sophisticated sorting like "sort by price ascending, then
-     * by rating descending".
-     *
-     * @example
-     *   ```typescript
-     *   interface Product {
-     *     id: string;
-     *     name: string;
-     *     price: number;
-     *     rating: number;
-     *     stock: number;
-     *     categoryId: number;
-     *     salesCount: number;
-     *   }
-     *
-     *   const products: Product[] = [
-     *     { id: '1', name: 'Laptop', price: 999.99, rating: 4.5, stock: 15, categoryId: 1, salesCount: 150 },
-     *     { id: '2', name: 'Mouse', price: 29.99, rating: 4.2, stock: 50, categoryId: 1, salesCount: 300 },
-     *     { id: '3', name: 'Keyboard', price: 79.99, rating: 4.8, stock: 25, categoryId: 1, salesCount: 200 }
-     *   ];
-     *
-     *   // Sort by price (ascending)
-     *   products.sort(GaffComparator.numbers(product => product.price));
-     *   // Result: Mouse ($29.99), Keyboard ($79.99), Laptop ($999.99)
-     *
-     *   // Sort by rating (descending requires negation)
-     *   products.sort(GaffComparator.numbers(product => -product.rating));
-     *   // Result: Keyboard (4.8), Laptop (4.5), Mouse (4.2)
-     *
-     *   // Multi-field: category, then price
-     *   products.sort(GaffComparator.numbers(product => [product.categoryId, product.price]));
-     *
-     *   // Complex business logic: popularity (sales) then rating
-     *   products.sort(GaffComparator.numbers(product => [-product.salesCount, -product.rating]));
-     *   // Negative values for descending order
-     *
-     *   // Sort by inventory priority: low stock first, then by sales
-     *   products.sort(GaffComparator.numbers(product => [product.stock, -product.salesCount]));
-     *
-     *   // Validate API numerical sorting with TestValidator
-     *   const priceValidator = TestValidator.sort("product price sorting",
-     *     (sortFields) => productApi.getProducts({ sort: sortFields })
-     *   )("price")(
-     *     GaffComparator.numbers(product => product.price)
-     *   );
-     *   await priceValidator("+"); // test ascending order
-     *   await priceValidator("-"); // test descending order
-     *
-     *   // Test multi-criteria sorting
-     *   const sortByBusinessValue = GaffComparator.numbers(product => [
-     *     -product.salesCount,  // High sales first
-     *     -product.rating,      // High rating first
-     *     product.price         // Low price first (for tie-breaking)
-     *   ]);
-     *   ```;
-     *
-     * @template T - The type of objects being compared
-     * @param closure - Function that extracts number value(s) from input objects
-     * @returns A comparator function suitable for Array.sort()
-     */
-    GaffComparator.numbers = function (closure) {
-        return function (x, y) {
-            var a = wrap(closure(x));
-            var b = wrap(closure(y));
-            var idx = a.findIndex(function (v, i) { return v !== b[i]; });
-            return idx !== -1 ? a[idx] - b[idx] : 0;
-        };
-    };
-    var compare = function (x, y) { return x.localeCompare(y); };
-    var wrap = function (elem) { return (Array.isArray(elem) ? elem : [elem]); };
-})(GaffComparator || (exports.GaffComparator = GaffComparator = {}));
-//# sourceMappingURL=GaffComparator.js.map

package/lib/GaffComparator.js.map

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

package/lib/MapUtil.d.ts

@@ -1,79 +0,0 @@
-/**
- * A namespace providing utility functions for Map manipulation.
- *
- * This namespace contains helper functions for working with JavaScript Map
- * objects, providing convenient methods for common Map operations like
- * retrieving values with lazy initialization.
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @example
- *   ```typescript
- *   // Create a cache with lazy initialization
- *   const cache = new Map<string, ExpensiveObject>();
- *
- *   const obj = MapUtil.take(cache, "key1", () => {
- *     console.log("Creating expensive object...");
- *     return new ExpensiveObject();
- *   });
- *
- *   // Subsequent calls return cached value without re-creating
- *   const sameObj = MapUtil.take(cache, "key1", () => new ExpensiveObject());
- *   console.log(obj === sameObj); // true
- *   ```;
- */
-export declare namespace MapUtil {
-    /**
-     * Retrieves a value from a Map or creates it using a lazy initialization
-     * function.
-     *
-     * This function implements the "get or create" pattern for Maps. If the key
-     * exists in the Map, it returns the existing value. Otherwise, it calls the
-     * provided factory function to create a new value, stores it in the Map, and
-     * returns it. The factory function is only called when the key doesn't exist,
-     * enabling lazy initialization and caching patterns.
-     *
-     * @example
-     *   ```typescript
-     *   // Simple caching example
-     *   const userCache = new Map<number, User>();
-     *
-     *   const user = MapUtil.take(userCache, userId, () => {
-     *     // This expensive operation only runs if userId is not cached
-     *     return fetchUserFromDatabase(userId);
-     *   });
-     *
-     *   // Configuration object caching
-     *   const configs = new Map<string, Config>();
-     *
-     *   const dbConfig = MapUtil.take(configs, "database", () => ({
-     *     host: "localhost",
-     *     port: 5432,
-     *     database: "myapp"
-     *   }));
-     *
-     *   // Lazy computation results
-     *   const computationCache = new Map<string, number>();
-     *
-     *   const result = MapUtil.take(computationCache, "fibonacci-40", () => {
-     *     console.log("Computing fibonacci(40)...");
-     *     return fibonacci(40); // Only computed once
-     *   });
-     *
-     *   // Using with complex keys
-     *   const cache = new Map<[number, number], Matrix>();
-     *   const key: [number, number] = [rows, cols];
-     *
-     *   const matrix = MapUtil.take(cache, key, () =>
-     *     generateIdentityMatrix(rows, cols)
-     *   );
-     *   ```;
-     *
-     * @template K - The type of keys in the Map
-     * @template V - The type of values in the Map
-     * @param map - The Map to retrieve from or update
-     * @param key - The key to look up in the Map
-     * @param value - A factory function that creates the value if key doesn't exist
-     * @returns The existing value if found, or the newly created value
-     */
-    function take<K, V>(map: Map<K, V>, key: K, value: () => V): V;
-}

package/lib/MapUtil.js

@@ -1,92 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MapUtil = void 0;
-/**
- * A namespace providing utility functions for Map manipulation.
- *
- * This namespace contains helper functions for working with JavaScript Map
- * objects, providing convenient methods for common Map operations like
- * retrieving values with lazy initialization.
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @example
- *   ```typescript
- *   // Create a cache with lazy initialization
- *   const cache = new Map<string, ExpensiveObject>();
- *
- *   const obj = MapUtil.take(cache, "key1", () => {
- *     console.log("Creating expensive object...");
- *     return new ExpensiveObject();
- *   });
- *
- *   // Subsequent calls return cached value without re-creating
- *   const sameObj = MapUtil.take(cache, "key1", () => new ExpensiveObject());
- *   console.log(obj === sameObj); // true
- *   ```;
- */
-var MapUtil;
-(function (MapUtil) {
-    /**
-     * Retrieves a value from a Map or creates it using a lazy initialization
-     * function.
-     *
-     * This function implements the "get or create" pattern for Maps. If the key
-     * exists in the Map, it returns the existing value. Otherwise, it calls the
-     * provided factory function to create a new value, stores it in the Map, and
-     * returns it. The factory function is only called when the key doesn't exist,
-     * enabling lazy initialization and caching patterns.
-     *
-     * @example
-     *   ```typescript
-     *   // Simple caching example
-     *   const userCache = new Map<number, User>();
-     *
-     *   const user = MapUtil.take(userCache, userId, () => {
-     *     // This expensive operation only runs if userId is not cached
-     *     return fetchUserFromDatabase(userId);
-     *   });
-     *
-     *   // Configuration object caching
-     *   const configs = new Map<string, Config>();
-     *
-     *   const dbConfig = MapUtil.take(configs, "database", () => ({
-     *     host: "localhost",
-     *     port: 5432,
-     *     database: "myapp"
-     *   }));
-     *
-     *   // Lazy computation results
-     *   const computationCache = new Map<string, number>();
-     *
-     *   const result = MapUtil.take(computationCache, "fibonacci-40", () => {
-     *     console.log("Computing fibonacci(40)...");
-     *     return fibonacci(40); // Only computed once
-     *   });
-     *
-     *   // Using with complex keys
-     *   const cache = new Map<[number, number], Matrix>();
-     *   const key: [number, number] = [rows, cols];
-     *
-     *   const matrix = MapUtil.take(cache, key, () =>
-     *     generateIdentityMatrix(rows, cols)
-     *   );
-     *   ```;
-     *
-     * @template K - The type of keys in the Map
-     * @template V - The type of values in the Map
-     * @param map - The Map to retrieve from or update
-     * @param key - The key to look up in the Map
-     * @param value - A factory function that creates the value if key doesn't exist
-     * @returns The existing value if found, or the newly created value
-     */
-    function take(map, key, value) {
-        if (map.has(key)) {
-            return map.get(key);
-        }
-        var newValue = value();
-        map.set(key, newValue);
-        return newValue;
-    }
-    MapUtil.take = take;
-})(MapUtil || (exports.MapUtil = MapUtil = {}));
-//# sourceMappingURL=MapUtil.js.map

package/lib/MapUtil.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MapUtil.js","sourceRoot":"","sources":["../src/MapUtil.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,IAAiB,OAAO,CA8DvB;AA9DD,WAAiB,OAAO;IACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACH,SAAgB,IAAI,CAAO,GAAc,EAAE,GAAM,EAAE,KAAc;QAC/D,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;QAC3B,CAAC;QACD,IAAM,QAAQ,GAAG,KAAK,EAAE,CAAC;QACzB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAPe,YAAI,OAOnB,CAAA;AACH,CAAC,EA9DgB,OAAO,uBAAP,OAAO,QA8DvB"}