@anddone/coretestautomation 1.0.1

package/dist/utils/generationUtils.d.ts

@@ -0,0 +1,424 @@
+export declare class GenerationUtils {
+    /**
+         * Returns a random integer between min and max (inclusive).
+         *
+         * @param min Minimum number (inclusive)
+         * @param max Maximum number (inclusive)
+         * @returns Random number between min and max
+         *
+         * Example:
+         * randomNumber(1, 10) → 7
+         */
+    static randomNumber(min: number, max: number): number;
+    /**
+     * Returns a random floating-point number between min and max.
+     *
+     * @param min Minimum number
+     * @param max Maximum number
+     * @param decimals Number of decimal places (default: 2)
+     * @returns Random float between min and max
+     *
+     * Example:
+     * randomFloat(1, 5, 2) → 3.47
+     */
+    static randomFloat(min: number, max: number, decimals?: number): number;
+    /**
+     * Returns a random boolean value.
+     *
+     * @returns true or false
+     *
+     * Example:
+     * randomBoolean() → true
+     */
+    static randomBoolean(): boolean;
+    /**
+     * Returns a random element from an array.
+     *
+     * @param values Array of values
+     * @returns Random element or null if array is empty
+     *
+     * Example:
+     * randomFromArray(["A", "B", "C"]) → "B"
+     */
+    static randomFromArray<T>(values: T[]): T | null;
+    /**
+     * Returns a random valid index for an array.
+     *
+     * @param max Length of the array
+     * @returns Random index between 0 and max - 1
+     *
+     * Example:
+     * randomIndex(5) → 3
+     */
+    static randomIndex(max: number): number;
+    /**
+     * Returns a random alphabetic string (A–Z, a–z).
+     *
+     * @param length Length of the string
+     * @returns Random alphabetic string
+     *
+     * Example:
+     * randomAlphaString(5) → "aZxQe"
+     */
+    static randomAlphaString(length: number): string;
+    /**
+     * Returns a random numeric string (0–9).
+     *
+     * @param length Length of the string
+     * @returns Random numeric string
+     *
+     * Example:
+     * randomNumericString(4) → "4829"
+     */
+    static randomNumericString(length: number): string;
+    /**
+     * Returns a random alphanumeric string (letters + numbers).
+     *
+     * @param length Length of the string
+     * @returns Random alphanumeric string
+     *
+     * Example:
+     * randomAlphaNumericString(8) → "A9bX2Lq7"
+     */
+    static randomAlphaNumericString(length: number): string;
+    /**
+     * Internal helper to generate random string from a given character set.
+     *
+     * @param chars Allowed characters
+     * @param length Length of string
+     * @returns Random string
+     */
+    private static generateRandomFromCharset;
+    /**
+     * Returns a random first name.
+     *
+     * @returns Random first name
+     *
+     * Example:
+     * randomFirstName() → "Rahul"
+     */
+    static randomFirstName(): string;
+    /**
+     * Returns a random last name.
+     *
+     * @returns Random last name
+     *
+     * Example:
+     * randomLastName() → "Sharma"
+     */
+    static randomLastName(): string;
+    /**
+     * Returns a random full name (first name + last name).
+     *
+     * @returns Random full name
+     *
+     * Example:
+     * randomFullName() → "Rahul Sharma"
+     */
+    static randomFullName(): string;
+    /**
+     * Returns a random username generated from name and number.
+     *
+     * @returns Random username
+     *
+     * Example:
+     * randomUsername() → "rahul.sharma482"
+     */
+    static randomUsername(): string;
+    /**
+     * Returns a random email address.
+     *
+     * @returns Random email string
+     *
+     * Example:
+     * randomEmail() → "rahul.sharma482@gmail.com"
+     */
+    static randomEmail(): string;
+    /**
+     * Returns a random country calling code.
+     *
+     * @returns Country code string (e.g. "+91")
+     *
+     * Example:
+     * randomCountryCode() → "+91"
+     */
+    static randomCountryCode(): string;
+    /**
+     * Returns a random phone number with country code.
+     *
+     * @returns Phone number string
+     *
+     * Example:
+     * randomPhoneNumber() → "+91 9876543210"
+     */
+    static randomPhoneNumber(): string;
+    /**
+     * Returns a random US phone number.
+     *
+     * Format: +1 XXX-XXX-XXXX
+     *
+     * @returns US phone number string
+     *
+     * Example:
+     * getRandomUSPhoneNumber() → "+1 415-782-3490"
+     */
+    static getRandomUSPhoneNumber(): string;
+    /**
+     * Generates a random user object containing basic identity and contact details.
+     *
+     * @returns Generated fields include:
+     * - First name
+     * - Last name
+     * - Full name (first + last)
+     * - Username (lowercased name with numeric suffix)
+     * - Email address (using common email domains)
+     *
+     * - Generic phone number (with random country code)
+     * - US-specific phone number
+     */
+    static generateUserObject(): {
+        firstName: string;
+        lastName: string;
+        fullName: string;
+        username: string;
+        email: string;
+        phoneNo: string;
+        usPhone: string;
+    };
+    private static generateIndiaPincode;
+    /**
+     * Returns a random India location (country, state, city).
+     *
+     * @returns Object containing country, state, and city
+     *
+     * Example:
+     * getRandomIndiaLocation()
+     * → { country: "India", state: "Karnataka", city: "Bengaluru", pincode: "560102" }
+     */
+    static getRandomIndiaLocation(): {
+        country: string;
+        state: string;
+        city: string;
+        pincode: string;
+    };
+    private static generateUSZipCode;
+    /**
+     * Returns a random USA location (country, state, city).
+     *
+     * @returns Object containing country, state, and city
+     *
+     * Example:
+     * getRandomUSALocation()
+     * → { country: "United States", state: "California", city: "San Diego" }
+     */
+    static getRandomUSALocation(): {
+        country: string;
+        state: string;
+        city: string;
+        zipCode: string;
+    };
+    /**
+     * Returns a random address line.
+     *
+     * @returns Random address line
+     *
+     * Example:
+     * randomAddressLine() → "Flat 302, MG Road"
+     */
+    static randomAddressLine(): string;
+    /**
+     * Returns a random UUID.
+     *
+     * @returns Random UUID string
+     *
+     * Example:
+     * randomUUID() → "f47ac10b-58cc-4372-a567-0e02b2c3d479"
+     */
+    static randomUUID(): string;
+    /**
+     * Returns a random lorem sentence.
+     *
+     * @param wordCount Optional number of words in the sentence
+     * @returns Random lorem sentence string
+     *
+     * Example:
+     * randomLoremSentence() → "Lorem ipsum dolor sit amet."
+     * randomLoremSentence(8) → "Lorem ipsum dolor sit amet consectetur elit."
+     */
+    static randomLoremSentence(wordCount?: number): string;
+    /**
+     * Returns the current date formatted in the given timezone.
+     *
+     * @param timezone IANA timezone
+     * @param format date-fns format string
+     * @returns formatted date string
+     *
+     * Example:
+     * getCurrentDateByTimezoneFormat("Asia/Kolkata", "dd/MM/yyyy") → "07/01/2026"
+     */
+    static getCurrentDateByTimezoneFormat(timezone: string, format: string): string;
+    /**
+     * Parses a date string using the provided format.
+     *
+     * @param dateStr input date string
+     * @param format date-fns format describing the input
+     * @returns Date object if valid, otherwise null
+     *
+     * Example:
+     * parseDate("02/Jan/2003", "dd/MMM/yyyy") -> 2003-01-01T18:30:00.000Z
+     */
+    static parseDate(dateStr: string, format: string): Date | null;
+    /**
+     * Converts a date string from one format to another.
+     *
+     * @param dateStr input date string
+     * @param inputFormat format of input string
+     * @param outputFormat desired output format
+     * @returns formatted date string or null if invalid
+     *
+     * Example:
+     * convertDateFormat("2026-01-07", "yyyy-MM-dd", "dd/MM/yyyy") → "07/01/2026"
+     */
+    static convertDateFormat(dateStr: string, inputFormat: string, outputFormat: string): string | null;
+    /**
+     * Removes the time portion from a Date and normalizes it to local midnight.
+     *
+     * @param date Date object
+     * @returns Date with time set to 00:00 or null if invalid
+     *
+     * Example:
+     * normalizeToDateOnly(new Date("2026-01-07T10:30:00")) -> 2024-01-14T18:30:00.000Z
+     */
+    static normalizeToDateOnly(date: Date): Date | null;
+    /**
+     * Adjusts a date by adding or subtracting days, months, and/or years.
+     *
+     * Positive values add time, negative values subtract time.
+     *
+     * @param date Base date to adjust
+     * @param options Object containing days, months, and/or years
+     * @returns Adjusted Date or null if input date is invalid
+     *
+     * Example:
+     * adjustDate(new Date(), { days: 5 })
+     * adjustDate(new Date(), { months: -2 })
+     * adjustDate(new Date(), { years: 1, days: 10 })
+     */
+    static adjustDate(date: Date, options: {
+        days?: number;
+        months?: number;
+        years?: number;
+    }): Date | null;
+    /**
+     * Adjusts the current date by adding or subtracting days, months, and/or years.
+     *
+     * Positive values add time, negative values subtract time.
+     *
+     * @param options Object containing days, months, and/or years
+     * @returns Adjusted Date or null if input date is invalid
+     *
+     * Example:
+     * adjustDate({ days: 5 })
+     * adjustDate({ months: -2 })
+     * adjustDate({ years: 1, days: 10 })
+     */
+    static adjustFromCurrentDate(options: {
+        days?: number;
+        months?: number;
+        years?: number;
+    }): Date | null;
+    /**
+     * Extracts day, month, and year from a Date object.
+     *
+     * @param date Date object
+     * @returns {{ day: number; month: number; year: number } | null}
+     * Object containing day (1–31), month (1–12), and year
+     */
+    static getDayMonthYear(date: Date): {
+        day: number;
+        month: number;
+        year: number;
+    } | null;
+    /**
+     * Splits a string using a string or regex delimiter.
+     *
+     * @param value Input string to split
+     * @param delimiter String or RegExp used as delimiter
+     * @returns Array of split values (trimmed, non-empty)
+     *
+     * Examples:
+     * splitByDelimiter("A,B,C", ",") → ["A", "B", "C"]
+     * splitByDelimiter("A | B | C", "|") → ["A", "B", "C"]
+     * splitByDelimiter("A,B;C|D", /[,;|]/) → ["A", "B", "C", "D"]
+     */
+    static splitByDelimiter(value: string, delimiter: string | RegExp): string[];
+    /**
+     * Returns the first regex match found in a string.
+     *
+     * If the regex contains capturing groups, the full match is returned.
+     *
+     * @param value Input string
+     * @param pattern Regular expression
+     * @returns First matched string or null if no match
+     *
+     * Example:
+     * getFirstMatch("Amount: $250", /\d+/) → "250"
+     */
+    static getFirstMatch(value: string, pattern: RegExp): string | null;
+    /**
+     * Returns all matches of a regex pattern found in a string.
+     *
+     * Note: For full functionality, the regex should have the global (g) flag.
+     *
+     * @param value Input string
+     * @param pattern Regular expression (preferably with /g)
+     * @returns Array of matched strings (empty array if no matches)
+     *
+     * Example:
+     * getAllMatches("IDs: 12, 45, 78", /\d+/g) → ["12", "45", "78"]
+     */
+    static getAllMatches(value: string, pattern: RegExp): string[];
+    /**
+   * This method is to get total technology fee
+   * @since 13-01-2026
+   * @param fixedFee number
+   * @param percentageFee number
+   * @param amount number
+   * @returns number | null
+   */
+    static getTotalFees(fixedFee: number, percentageFee: number, amount: number): number | null;
+    /**
+     * This method is get total amount as per passed fixed & percentage fee and amount
+     * @since 13-01-2026
+     * @param fixedFee number
+     * @param percentageFee number
+     * @param amount number
+     * @returns number | null
+     */
+    static getTotalAmount(fixedFee: number, percentageFee: number, amount: number): number | null;
+    /**
+     * Returns the difference between two dates in years.
+     *
+     * @param date1 Start date
+     * @param date2 End date
+     * @returns Difference in days or null if invalid
+     */
+    static getDifferenceInDays(date1: Date, date2: Date): number | null;
+    /**
+     * Returns the difference between two dates in years.
+     *
+     * @param date1 Start date
+     * @param date2 End date
+     * @returns Difference in months or null if invalid
+     */
+    static getDifferenceInMonths(date1: Date, date2: Date): number | null;
+    /**
+     * Returns the difference between two dates in years.
+     *
+     * @param date1 Start date
+     * @param date2 End date
+     * @returns Difference in years or null if invalid
+     */
+    static getDifferenceInYears(date1: Date, date2: Date): number | null;
+}
+//# sourceMappingURL=generationUtils.d.ts.map

package/dist/utils/generationUtils.d.ts.map

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