@nestia/e2e 7.3.3 → 8.0.0-dev.20250829

package/lib/MapUtil.js

@@ -0,0 +1,92 @@
+"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

@@ -0,0 +1 @@
+{"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"}

package/lib/RandomGenerator.d.ts

@@ -20,13 +20,13 @@
  *   const testUser = {
  *     id: RandomGenerator.alphaNumeric(8),
  *     name: RandomGenerator.name(),
- *     bio: RandomGenerator.paragraph(3)(5, 10),
+ *     bio: RandomGenerator.paragraph({ sentences: 3, wordMin: 5, wordMax: 10 }),
  *     phone: RandomGenerator.mobile(),
- *     createdAt: RandomGenerator.date(new Date())(1000 * 60 * 60 * 24 * 30) // 30 days
+ *     createdAt: RandomGenerator.date(new Date(), 1000 * 60 * 60 * 24 * 30) // 30 days
  *   };
  *
  *   // Sample data for testing
- *   const testSample = RandomGenerator.sample(allUsers)(5);
+ *   const testSample = RandomGenerator.sample(allUsers, 5);
  *   ```;
  */
 export declare namespace RandomGenerator {
@@ -41,9 +41,9 @@ export declare namespace RandomGenerator {
      *
      * @example
      *   ```typescript
-     *   RandomGenerator.alphabets(5);  // "hello"
-     *   RandomGenerator.alphabets(3);  // "abc"
-     *   RandomGenerator.alphabets(10); // "randomtext"
+     *   RandomGenerator.alphabets(5);  // e.g. "kxqpw"
+     *   RandomGenerator.alphabets(3);  // e.g. "mzr"
+     *   RandomGenerator.alphabets(10); // e.g. "qwertasdfg"
      *
      *   // Generate random CSS class names
      *   const className = `test-${RandomGenerator.alphabets(6)}`;
@@ -67,8 +67,8 @@ export declare namespace RandomGenerator {
      *
      * @example
      *   ```typescript
-     *   RandomGenerator.alphaNumeric(8);  // "a1b2c3d4"
-     *   RandomGenerator.alphaNumeric(12); // "x9y8z7w6v5u4"
+     *   RandomGenerator.alphaNumeric(8);  // e.g. "a1b2c3d4"
+     *   RandomGenerator.alphaNumeric(12); // e.g. "x9y8z7w6v5u4"
      *
      *   // Generate random API keys
      *   const apiKey = RandomGenerator.alphaNumeric(32);
@@ -95,9 +95,9 @@ export declare namespace RandomGenerator {
      *
      * @example
      *   ```typescript
-     *   RandomGenerator.name();    // "john doe"
-     *   RandomGenerator.name(1);   // "alice"
-     *   RandomGenerator.name(3);   // "jane mary smith"
+     *   RandomGenerator.name();    // e.g. "lorem ipsum" (2-3 words)
+     *   RandomGenerator.name(1);   // e.g. "dolor" (single word)
+     *   RandomGenerator.name(3);   // e.g. "sit amet consectetur" (3 words)
      *
      *   // Generate test user names
      *   const users = Array.from({ length: 10 }, () => ({
@@ -111,7 +111,7 @@ export declare namespace RandomGenerator {
      *   ```
      *
      * @param length - Number of words in the name (default: random between 2-3)
-     * @returns A space-separated string resembling a human name
+     * @returns A space-separated string of random words (each 3-7 chars by default)
      */
     const name: (length?: number) => string;
     /**
@@ -119,77 +119,112 @@ export declare namespace RandomGenerator {
      *
      * Creates a paragraph consisting of a specified number of "sentences"
      * (words). Each sentence is a random alphabetic string, and sentences are
-     * joined with spaces. Returns a currying function to allow configuration of
-     * word length ranges.
+     * joined with spaces. Accepts an optional configuration object for fine-tuned
+     * control over the paragraph structure.
      *
      * @example
      *   ```typescript
-     *   // Generate with default word lengths (3-7 characters)
-     *   RandomGenerator.paragraph(3)();           // "hello world test"
-     *   RandomGenerator.paragraph(5)();           // "lorem ipsum dolor sit amet"
+     *   // Generate with defaults (random 2-5 words, 3-7 characters each)
+     *   RandomGenerator.paragraph();  // e.g. "lorem ipsum dolor"
+     *
+     *   // Specific number of sentences
+     *   RandomGenerator.paragraph({ sentences: 5 });  // "lorem ipsum dolor sit amet"
      *
      *   // Custom word length ranges
-     *   RandomGenerator.paragraph(4)(2, 5);       // "ab cd ef gh"
-     *   RandomGenerator.paragraph(6)(8, 12);      // "verylongword anotherlongword..."
+     *   RandomGenerator.paragraph({ sentences: 4, wordMin: 2, wordMax: 5 });
+     *   // "ab cd ef gh"
      *
      *   // Generate product descriptions
-     *   const description = RandomGenerator.paragraph(8)(4, 8);
+     *   const description = RandomGenerator.paragraph({
+     *     sentences: 8,
+     *     wordMin: 4,
+     *     wordMax: 8
+     *   });
      *
      *   // Create test content for forms
-     *   const placeholder = RandomGenerator.paragraph(3)(5, 10);
-     *
-     *   // Generate variable-length test data
-     *   const testTexts = Array.from({ length: 5 }, (_, i) =>
-     *     RandomGenerator.paragraph(i + 2)(3, 6)
-     *   );
+     *   const placeholder = RandomGenerator.paragraph({
+     *     sentences: 3,
+     *     wordMin: 5,
+     *     wordMax: 10
+     *   });
      *   ```;
      *
-     * @param sentences - Number of sentences (words) in the paragraph (default:
-     *   random 2-5)
-     * @returns A currying function that accepts word length parameters
+     * @param props - Optional configuration object with sentences count and word
+     *   length ranges
+     * @returns A string containing the generated paragraph
      */
-    const paragraph: (sentences?: number) => (wordMin?: number, wordMax?: number) => string;
+    const paragraph: (props?: Partial<{
+        sentences: number;
+        wordMin: number;
+        wordMax: number;
+    }>) => string;
     /**
      * Generates random multi-paragraph content with customizable structure.
      *
      * Creates content consisting of multiple paragraphs separated by double
-     * newlines. Uses a triple-currying pattern to allow fine-grained control over
-     * content structure: paragraphs count → sentences per paragraph → word
+     * newlines. Accepts an optional configuration object to control content
+     * structure including paragraph count, sentences per paragraph, and word
      * character lengths. Ideal for generating realistic-looking text content for
      * testing.
      *
      * @example
      *   ```typescript
      *   // Generate with all defaults
-     *   const article = RandomGenerator.content()()();
+     *   const article = RandomGenerator.content();
      *
      *   // Specific structure: 5 paragraphs, 15-25 sentences each, 4-8 char words
-     *   const longContent = RandomGenerator.content(5)(15, 25)(4, 8);
+     *   const longContent = RandomGenerator.content({
+     *     paragraphs: 5,
+     *     sentenceMin: 15,
+     *     sentenceMax: 25,
+     *     wordMin: 4,
+     *     wordMax: 8
+     *   });
      *
      *   // Short content with brief sentences
-     *   const shortContent = RandomGenerator.content(2)(5, 8)(2, 4);
+     *   const shortContent = RandomGenerator.content({
+     *     paragraphs: 2,
+     *     sentenceMin: 5,
+     *     sentenceMax: 8,
+     *     wordMin: 2,
+     *     wordMax: 4
+     *   });
      *
      *   // Generate blog post content
      *   const blogPost = {
      *     title: RandomGenerator.name(3),
-     *     content: RandomGenerator.content(4)(10, 20)(3, 7),
-     *     summary: RandomGenerator.paragraph(2)(5, 10)
+     *     content: RandomGenerator.content({
+     *       paragraphs: 4,
+     *       sentenceMin: 10,
+     *       sentenceMax: 20,
+     *       wordMin: 3,
+     *       wordMax: 7
+     *     }),
+     *     summary: RandomGenerator.paragraph({ sentences: 2 })
      *   };
      *
      *   // Create test data for CMS
      *   const pages = Array.from({ length: 10 }, () => ({
      *     id: RandomGenerator.alphaNumeric(8),
-     *     content: RandomGenerator.content(randint(2, 6))(8, 15)(4, 9)
+     *     content: RandomGenerator.content({
+     *       paragraphs: randint(2, 6),
+     *       sentenceMin: 8,
+     *       sentenceMax: 15
+     *     })
      *   }));
-     *
-     *   // Generate email content for testing
-     *   const emailBody = RandomGenerator.content(3)(5, 12)(3, 8);
      *   ```;
      *
-     * @param paragraphs - Number of paragraphs to generate (default: random 3-8)
-     * @returns A currying function that accepts sentence count parameters
+     * @param props - Optional configuration object with paragraph, sentence, and
+     *   word parameters
+     * @returns A string containing the generated multi-paragraph content
      */
-    const content: (paragraphs?: number) => (sentenceMin?: number, sentenceMax?: number) => (wordMin?: number, wordMax?: number) => string;
+    const content: (props?: Partial<{
+        paragraphs: number;
+        sentenceMin: number;
+        sentenceMax: number;
+        wordMin: number;
+        wordMax: number;
+    }>) => string;
     /**
      * Extracts a random substring from the provided content string.
      *
@@ -202,9 +237,9 @@ export declare namespace RandomGenerator {
      *   ```typescript
      *   const text = "The quick brown fox jumps over the lazy dog";
      *
-     *   RandomGenerator.substring(text);  // "quick brown fox"
-     *   RandomGenerator.substring(text);  // "jumps over"
-     *   RandomGenerator.substring(text);  // "fox jumps over the lazy"
+     *   RandomGenerator.substring(text);  // e.g. "quick brown fox"
+     *   RandomGenerator.substring(text);  // e.g. "jumps over"
+     *   RandomGenerator.substring(text);  // e.g. "fox jumps over the lazy"
      *
      *   // Generate search terms from content
      *   const searchQuery = RandomGenerator.substring(articleContent);
@@ -234,9 +269,9 @@ export declare namespace RandomGenerator {
      *
      * @example
      *   ```typescript
-     *   RandomGenerator.mobile();        // "0103341234"
-     *   RandomGenerator.mobile("011");   // "0119876543"
-     *   RandomGenerator.mobile("+82");   // "+8233412345"
+     *   RandomGenerator.mobile();        // e.g. "0103341234" or "01012345678"
+     *   RandomGenerator.mobile("011");   // e.g. "0119876543" or "01112345678"
+     *   RandomGenerator.mobile("+82");   // e.g. "+823341234" or "+8212345678"
      *
      *   // Generate test user phone numbers
      *   const testUsers = Array.from({ length: 100 }, () => ({
@@ -262,8 +297,7 @@ export declare namespace RandomGenerator {
     /**
      * Generates a random date within a specified range from a starting point.
      *
-     * Creates a currying function that accepts a range in milliseconds and
-     * returns a random date between the start date and start date + range. The
+     * Returns a random date between the start date and start date + range. The
      * range represents the maximum number of milliseconds to add to the starting
      * date. Useful for generating timestamps, creation dates, or scheduling test
      * data.
@@ -275,30 +309,31 @@ export declare namespace RandomGenerator {
      *   const oneMonth = 30 * oneDay;
      *
      *   // Random date within the next 30 days
-     *   const futureDate = RandomGenerator.date(now)(oneMonth);
+     *   const futureDate = RandomGenerator.date(now, oneMonth);
      *
      *   // Random date within the past week
      *   const pastWeek = new Date(now.getTime() - 7 * oneDay);
-     *   const recentDate = RandomGenerator.date(pastWeek)(7 * oneDay);
+     *   const recentDate = RandomGenerator.date(pastWeek, 7 * oneDay);
      *
      *   // Generate random creation dates for test data
      *   const startOfYear = new Date(2024, 0, 1);
      *   const endOfYear = new Date(2024, 11, 31).getTime() - startOfYear.getTime();
-     *   const randomCreationDate = RandomGenerator.date(startOfYear)(endOfYear);
+     *   const randomCreationDate = RandomGenerator.date(startOfYear, endOfYear);
      *
      *   // Create test events with random timestamps
      *   const events = Array.from({ length: 50 }, () => ({
      *     id: RandomGenerator.alphaNumeric(8),
      *     title: RandomGenerator.name(2),
-     *     createdAt: RandomGenerator.date(new Date())(oneMonth),
-     *     scheduledFor: RandomGenerator.date(new Date())(oneMonth * 3)
+     *     createdAt: RandomGenerator.date(new Date(), oneMonth),
+     *     scheduledFor: RandomGenerator.date(new Date(), oneMonth * 3)
      *   }));
      *   ```;
      *
      * @param from - The starting date for the random range
-     * @returns A currying function that accepts a range in milliseconds
+     * @param range - The range in milliseconds from the starting date
+     * @returns A random date within the specified range
      */
-    const date: (from: Date) => (range: number) => Date;
+    const date: (from: Date, range: number) => Date;
     /**
      * Randomly samples a specified number of unique elements from an array.
      *
@@ -312,30 +347,31 @@ export declare namespace RandomGenerator {
      *   ```typescript
      *   const numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
      *
-     *   RandomGenerator.sample(numbers)(3);  // [2, 7, 9]
-     *   RandomGenerator.sample(numbers)(5);  // [1, 4, 6, 8, 10]
-     *   RandomGenerator.sample(numbers)(15); // [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] (capped at array length)
+     *   RandomGenerator.sample(numbers, 3);  // e.g. [2, 7, 9]
+     *   RandomGenerator.sample(numbers, 5);  // e.g. [1, 4, 6, 8, 10]
+     *   RandomGenerator.sample(numbers, 15); // returns all 10 elements (capped at array length)
      *
      *   // Sample users for testing
      *   const allUsers = await getUsersFromDatabase();
-     *   const testUsers = RandomGenerator.sample(allUsers)(10);
+     *   const testUsers = RandomGenerator.sample(allUsers, 10);
      *
      *   // Create random product selections
-     *   const featuredProducts = RandomGenerator.sample(allProducts)(5);
+     *   const featuredProducts = RandomGenerator.sample(allProducts, 5);
      *
      *   // Generate test data subsets
-     *   const validationSet = RandomGenerator.sample(trainingData)(100);
+     *   const validationSet = RandomGenerator.sample(trainingData, 100);
      *
      *   // Random A/B testing groups
-     *   const groupA = RandomGenerator.sample(allParticipants)(50);
+     *   const groupA = RandomGenerator.sample(allParticipants, 50);
      *   const remaining = allParticipants.filter(p => !groupA.includes(p));
-     *   const groupB = RandomGenerator.sample(remaining)(50);
+     *   const groupB = RandomGenerator.sample(remaining, 50);
      *   ```;
      *
      * @param array - The source array to sample from
-     * @returns A currying function that accepts the desired sample count
+     * @param count - The number of elements to sample
+     * @returns An array containing the randomly selected elements
      */
-    const sample: <T>(array: T[]) => (count: number) => T[];
+    const sample: <T>(array: T[], count: number) => T[];
     /**
      * Randomly selects a single element from an array.
      *
@@ -349,8 +385,8 @@ export declare namespace RandomGenerator {
      *   const colors = ['red', 'blue', 'green', 'yellow', 'purple'];
      *   const fruits = ['apple', 'banana', 'orange', 'grape', 'kiwi'];
      *
-     *   RandomGenerator.pick(colors);  // "blue"
-     *   RandomGenerator.pick(fruits);  // "apple"
+     *   RandomGenerator.pick(colors);  // e.g. "blue"
+     *   RandomGenerator.pick(fruits);  // e.g. "apple"
      *
      *   // Select random configuration options
      *   const randomTheme = RandomGenerator.pick(['light', 'dark', 'auto']);