transit-core-taf 1.0.2

package/dist/transit-core-taf/global-setup.js

@@ -0,0 +1,103 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const dotenv = __importStar(require("dotenv"));
+const path_1 = __importDefault(require("path"));
+const fs = __importStar(require("fs"));
+// Function to find the project root
+const findProjectRoot = (startPath) => {
+    let currentPath = startPath;
+    while (currentPath !== path_1.default.parse(currentPath).root) {
+        if (fs.existsSync(path_1.default.join(currentPath, 'package.json'))) {
+            return currentPath;
+        }
+        currentPath = path_1.default.dirname(currentPath);
+    }
+    return startPath; // Fallback to the original directory if not found
+};
+async function globalSetup() {
+    const env = process.env.ENV || 'stage';
+    const projectRoot = path_1.default.resolve(__dirname, '..');
+    const envPath = path_1.default.join(projectRoot, `.env.${env}`);
+    // Load env file
+    if (fs.existsSync(envPath)) {
+        dotenv.config({ path: envPath, override: true });
+        console.log(`✅ Loaded ${envPath} from project root ${projectRoot} ✅`);
+    }
+    else {
+        throw new Error(`❌ Environment file .env.${env} not found in project root ${projectRoot} ❌`);
+    }
+    const argv = process.argv;
+    // Find all arguments related to project selection
+    const projectArgs = argv.map((arg, i) => {
+        if (arg === '--project' && i + 1 < argv.length) {
+            return argv[i + 1];
+        }
+        if (arg.startsWith('--project=')) {
+            return arg.split('=')[1];
+        }
+        return null;
+    }).filter(p => p !== null);
+    let runAuth = false;
+    if (projectArgs.length > 0) {
+        // --project flag is used. Only run if 'api-tests' is specified.
+        if (projectArgs.includes('api-tests')) {
+            runAuth = true;
+        }
+    }
+    else {
+        // No --project flag. Check for test path arguments.
+        const testCommandIndex = argv.indexOf('test');
+        const argsAfterTest = testCommandIndex !== -1 ? argv.slice(testCommandIndex + 1) : [];
+        const pathArgs = argsAfterTest.filter(arg => !arg.startsWith('-'));
+        if (pathArgs.length === 0) {
+            // No path arguments, so it's a full run.
+            runAuth = true;
+        }
+        else {
+            // Path arguments are present. Check if any are in the api-tests directory.
+            if (pathArgs.some(p => p.startsWith('tests/api-tests'))) {
+                runAuth = true;
+            }
+        }
+    }
+    if (runAuth) {
+        console.log('Global setup for api-tests is running...');
+    }
+}
+exports.default = globalSetup;

package/dist/transit-core-taf/index.d.ts

@@ -0,0 +1,23 @@
+export * from './base/basepagevalidations';
+export * from './base/basepageactions';
+export * from './base/basepagewaits';
+export * from './base/commonpageactions';
+export * from './base/commonpagevalidations';
+export * from './base/commonpagewaits';
+export * from './base/logger';
+export * from './utils/envutils';
+export * from './utils/excelUtils';
+export * from './utils/networkutils';
+export * from './utils/Utils';
+export * from './baseapi/baseapihelpers';
+export * from './baseapi/apiutils';
+export * from './constants/apiconstants';
+export * from './constants/test-tags';
+export * from './steps/basepageactions.steps';
+export * from './steps/basepagevalidations.steps';
+export * from './steps/basepagewaits.steps';
+export * from './steps/commonpageactions.steps';
+export * from './steps/commonpagevalidations.steps';
+export * from './steps/commonpagewaits.steps';
+export * from './steps/hooks';
+export * from './steps/world';

package/dist/transit-core-taf/index.js

@@ -0,0 +1,39 @@
+"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("./base/basepagevalidations"), exports);
+__exportStar(require("./base/basepageactions"), exports);
+__exportStar(require("./base/basepagewaits"), exports);
+__exportStar(require("./base/commonpageactions"), exports);
+__exportStar(require("./base/commonpagevalidations"), exports);
+__exportStar(require("./base/commonpagewaits"), exports);
+__exportStar(require("./base/logger"), exports);
+__exportStar(require("./utils/envutils"), exports);
+__exportStar(require("./utils/excelUtils"), exports);
+__exportStar(require("./utils/networkutils"), exports);
+__exportStar(require("./utils/Utils"), exports);
+__exportStar(require("./baseapi/baseapihelpers"), exports);
+__exportStar(require("./baseapi/apiutils"), exports);
+__exportStar(require("./constants/apiconstants"), exports);
+__exportStar(require("./constants/test-tags"), exports);
+__exportStar(require("./steps/basepageactions.steps"), exports);
+__exportStar(require("./steps/basepagevalidations.steps"), exports);
+__exportStar(require("./steps/basepagewaits.steps"), exports);
+__exportStar(require("./steps/commonpageactions.steps"), exports);
+__exportStar(require("./steps/commonpagevalidations.steps"), exports);
+__exportStar(require("./steps/commonpagewaits.steps"), exports);
+__exportStar(require("./steps/hooks"), exports);
+__exportStar(require("./steps/world"), exports);

package/dist/transit-core-taf/steps/basepageactions.steps.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/transit-core-taf/steps/basepageactions.steps.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cucumber_1 = require("@cucumber/cucumber");
+const basepageactions_1 = require("../base/basepageactions");
+(0, cucumber_1.When)('I click the element {string}', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageActions.clickElement(element);
+});
+(0, cucumber_1.When)('I click the locator {string}', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageActions.clickByLocator(element);
+});
+(0, cucumber_1.When)('I click the button with text {string}', async function (buttonText) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    await basePageActions.clickButtonByText(buttonText);
+});
+(0, cucumber_1.When)('I click the element with ID {string}', async function (id) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    await basePageActions.clickById(id);
+});
+(0, cucumber_1.When)('I fill the input {string} with {string}', async function (selector, value) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageActions.fillInput(element, value);
+});
+(0, cucumber_1.When)('I clear the input {string}', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageActions.clearInput(element);
+});
+(0, cucumber_1.When)('I type {string} into {string} slowly', async function (text, selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageActions.typeSlowly(element, text);
+});
+(0, cucumber_1.When)('I hover over the element {string}', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageActions.hoverOverElement(element);
+});
+(0, cucumber_1.When)('I press the {string} key on {string}', async function (key, selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageActions.pressKey(element, key);
+});
+(0, cucumber_1.When)('I check the checkbox {string}', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageActions.checkCheckbox(element);
+});
+(0, cucumber_1.When)('I uncheck the checkbox {string}', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageActions.uncheckCheckbox(element);
+});
+(0, cucumber_1.When)('I select the option {string} from {string}', async function (value, selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageActions.selectOption(element, value);
+});
+(0, cucumber_1.When)('I reload the page', async function () {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageActions = new basepageactions_1.BasePageActions(this.page, this.logger);
+    await basePageActions.reloadPage();
+});

package/dist/transit-core-taf/steps/basepagevalidations.steps.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/transit-core-taf/steps/basepagevalidations.steps.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cucumber_1 = require("@cucumber/cucumber");
+const basepagevalidations_1 = require("../base/basepagevalidations");
+(0, cucumber_1.Then)('the element {string} should be visible', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageValidations = new basepagevalidations_1.BasePageValidations(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageValidations.validateElementToBeVisible(element);
+});
+(0, cucumber_1.Then)('the element {string} should not be visible', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageValidations = new basepagevalidations_1.BasePageValidations(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageValidations.validateElementNotToBeVisible(element);
+});
+(0, cucumber_1.Then)('the element {string} should have text {string}', async function (selector, expectedText) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageValidations = new basepagevalidations_1.BasePageValidations(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageValidations.validateElementToHaveText(element, expectedText);
+});
+(0, cucumber_1.Then)('the element {string} should be enabled', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageValidations = new basepagevalidations_1.BasePageValidations(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageValidations.validateElementToBeEnabled(element);
+});
+(0, cucumber_1.Then)('the element {string} should be hidden', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageValidations = new basepagevalidations_1.BasePageValidations(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageValidations.validateElementToBeHidden(element);
+});
+(0, cucumber_1.Then)('the element {string} should have attribute {string} with value {string}', async function (selector, attribute, value) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageValidations = new basepagevalidations_1.BasePageValidations(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageValidations.validateElementToHaveAttribute(element, attribute, value);
+});
+(0, cucumber_1.Then)('the element {string} should contain text {string}', async function (selector, expectedText) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageValidations = new basepagevalidations_1.BasePageValidations(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageValidations.validateElementToContainText(element, expectedText);
+});
+(0, cucumber_1.Then)('the URL should match {string}', async function (expectedUrl) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageValidations = new basepagevalidations_1.BasePageValidations(this.page, this.logger);
+    await basePageValidations.validateUrlToContain(expectedUrl);
+});

package/dist/transit-core-taf/steps/basepagewaits.steps.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/transit-core-taf/steps/basepagewaits.steps.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cucumber_1 = require("@cucumber/cucumber");
+const basepagewaits_1 = require("../base/basepagewaits");
+(0, cucumber_1.When)('I wait for the page to load', async function () {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageWaits = new basepagewaits_1.BasePageWaits(this.page, this.logger);
+    await basePageWaits.waitForPageLoad();
+});
+(0, cucumber_1.When)('I wait for {int} seconds', async function (seconds) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageWaits = new basepagewaits_1.BasePageWaits(this.page, this.logger);
+    await basePageWaits.waitForSeconds(seconds);
+});
+(0, cucumber_1.When)('I wait for the element {string} to be visible', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageWaits = new basepagewaits_1.BasePageWaits(this.page, this.logger);
+    const element = this.page.locator(selector);
+    await basePageWaits.waitForElementToBeVisible(element);
+});
+(0, cucumber_1.When)('I navigate to {string}', async function (url) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const basePageWaits = new basepagewaits_1.BasePageWaits(this.page, this.logger);
+    await basePageWaits.goto(url);
+});

package/dist/transit-core-taf/steps/commonpageactions.steps.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/transit-core-taf/steps/commonpageactions.steps.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cucumber_1 = require("@cucumber/cucumber");
+const commonpageactions_1 = require("../base/commonpageactions");
+(0, cucumber_1.When)('I accept the cookie popup', async function () {
+    if (!this.page)
+        throw new Error('Page not found');
+    const commonPageActions = new commonpageactions_1.CommonPageActions(this.page, this.logger);
+    await commonPageActions.acceptCookiePopup();
+});
+(0, cucumber_1.When)('I drag {string} to {string}', async function (sourceSelector, targetSelector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const commonPageActions = new commonpageactions_1.CommonPageActions(this.page, this.logger);
+    const source = this.page.locator(sourceSelector);
+    const target = this.page.locator(targetSelector);
+    await commonPageActions.dragAndDrop(source, target);
+});

package/dist/transit-core-taf/steps/commonpagevalidations.steps.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/transit-core-taf/steps/commonpagevalidations.steps.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cucumber_1 = require("@cucumber/cucumber");
+const commonpagevalidations_1 = require("../base/commonpagevalidations");
+(0, cucumber_1.Then)('the page should be in fullscreen mode', async function () {
+    if (!this.page)
+        throw new Error('Page not found');
+    const commonPageValidations = new commonpagevalidations_1.CommonPageValidations(this.page);
+    await commonPageValidations.validateFullScreen(true);
+});
+(0, cucumber_1.Then)('the page should not be in fullscreen mode', async function () {
+    if (!this.page)
+        throw new Error('Page not found');
+    const commonPageValidations = new commonpagevalidations_1.CommonPageValidations(this.page);
+    await commonPageValidations.validateFullScreen(false);
+});

package/dist/transit-core-taf/steps/commonpagewaits.steps.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/transit-core-taf/steps/commonpagewaits.steps.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cucumber_1 = require("@cucumber/cucumber");
+const commonpagewaits_1 = require("../base/commonpagewaits");
+(0, cucumber_1.When)('I wait for the attribute {string} of element {string} to be {string}', async function (attribute, selector, value) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const commonPageWaits = new commonpagewaits_1.CommonPageWaits(this.page);
+    const element = this.page.locator(selector);
+    await commonPageWaits.waitForAttributeToBePresent(element, attribute, value);
+});
+(0, cucumber_1.When)('I wait for the URL to be {string}', async function (url) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const commonPageWaits = new commonpagewaits_1.CommonPageWaits(this.page);
+    await commonPageWaits.waitForURL(url);
+});
+(0, cucumber_1.When)('I wait for the element {string} to be hidden', async function (selector) {
+    if (!this.page)
+        throw new Error('Page not found');
+    const commonPageWaits = new commonpagewaits_1.CommonPageWaits(this.page);
+    const element = this.page.locator(selector);
+    await commonPageWaits.waitForElementToBeHidden(element);
+});

package/dist/transit-core-taf/steps/hooks.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/transit-core-taf/steps/hooks.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cucumber_1 = require("@cucumber/cucumber");
+(0, cucumber_1.Before)(async function ({ pickle }) {
+    this.logger.testDescription = pickle.name;
+    await this.openBrowser();
+});
+(0, cucumber_1.After)(async function () {
+    await this.closeBrowser();
+});

package/dist/transit-core-taf/steps/world.d.ts

@@ -0,0 +1,12 @@
+import { IWorldOptions, World } from '@cucumber/cucumber';
+import { Page, Browser, BrowserContext } from '@playwright/test';
+import { Logger } from '../base/logger';
+export declare class CustomWorld extends World {
+    browser: Browser | null;
+    context: BrowserContext | null;
+    page: Page | null;
+    logger: Logger;
+    constructor(options: IWorldOptions);
+    openBrowser(): Promise<void>;
+    closeBrowser(): Promise<void>;
+}

package/dist/transit-core-taf/steps/world.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomWorld = void 0;
+const cucumber_1 = require("@cucumber/cucumber");
+const test_1 = require("@playwright/test");
+const logger_1 = require("../base/logger");
+class CustomWorld extends cucumber_1.World {
+    browser;
+    context;
+    page;
+    logger;
+    constructor(options) {
+        super(options);
+        this.browser = null;
+        this.context = null;
+        this.page = null;
+        this.logger = new logger_1.Logger('Default Test');
+    }
+    async openBrowser() {
+        this.browser = await test_1.chromium.launch({ headless: false });
+        this.context = await this.browser.newContext();
+        this.page = await this.context.newPage();
+    }
+    async closeBrowser() {
+        if (this.page) {
+            await this.page.close();
+        }
+        if (this.context) {
+            await this.context.close();
+        }
+        if (this.browser) {
+            await this.browser.close();
+        }
+    }
+}
+exports.CustomWorld = CustomWorld;
+(0, cucumber_1.setWorldConstructor)(CustomWorld);

package/dist/transit-core-taf/utils/Utils.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Generates a random alphanumeric string of specified length.
+ * @param {number} length - The number of characters in the generated string.
+ * @returns {string} - Randomly generated string.
+ */
+export declare function generateRandomString(length: number): string;
+/**
+ * Generates a random first name.
+ * @returns A random first name.
+ */
+export declare function generateFirstName(): string;
+/**
+ * Generates a random last name.
+ * @returns A random last name.
+ */
+export declare function generateLastName(): string;
+/**
+ * Generates a random household name.
+ * @returns A random household name, typically in the format "[LastName] Household".
+ */
+export declare function generateHouseholdName(): string;
+/**
+ * Generates a dynamic US address.
+ * @returns An object containing a full US address.
+ */
+export declare function generateUSAddress(): {
+    streetAddressLine1: string;
+    streetAddressLine2: string;
+    city: string;
+    state: string;
+    zipCode: string;
+    country: string;
+};
+/**
+ * Generates a random phone number for a given country.
+ * @param country - The country for which to generate the phone number.
+ * @returns A random phone number.
+ */
+export declare function generatePhoneNumber(country: string): string;
+/**
+ * Generates a random email address with the yopmail.com domain.
+ * @returns A random email address.
+ */
+export declare function generateYopmailEmail(): string;
+/**
+ * Returns the current timestamp.
+ * @returns The current timestamp in milliseconds.
+ */
+export declare function getTimestamp(): number;
+/**
+ * Calculates the time difference between two timestamps and returns a formatted string.
+ * @param startTime - The starting timestamp in milliseconds.
+ * @param endTime - The ending timestamp in milliseconds.
+ * @returns A formatted string like "5 sec 34 ms".
+ */
+export declare function getTimeDifference(startTime: number, endTime: number): string;
+export declare function readAccountApiResponse(accountId: string): any;
+/**
+ * Generates a random integer between 0 (inclusive) and the given length (exclusive).
+ * @param {number} length - The upper bound (non-inclusive) for the random number.
+ *                          If less than or equal to 0, the function returns 0.
+ * @returns {number} A random integer between 0 and length - 1, or 0 if length <= 0.
+ */
+export declare function getRandomNumber(length: number): number;
+/**
+ * Generates a random future date.
+ * @returns An object containing the day, month, and year of a random future date.
+ */
+export declare function generateRandomFutureDate(): {
+    day: number;
+    month: number;
+    year: number;
+};
+/**
+ * @description
+ * This function provides flexible date formatting similar to moment.js.
+ * It supports both padded (e.g., 03) and unpadded (e.g., 3) date/time tokens.
+ * Ideal for logs, filenames, UI display, or readable timestamps.
+ *
+ * 🧩 Supported format tokens:
+ *  ┌────────┬────────────────────────────┐
+ *  │ Token  │ Description                │
+ *  ├────────┼────────────────────────────┤
+ *  │ YYYY   │ 4-digit year (e.g. 2025)  │
+ *  │ M      │ Month (1–12)               │
+ *  │ MM     │ Month (01–12)              │
+ *  │ D      │ Day of month (1–31)        │
+ *  │ DD     │ Day of month (01–31)       │
+ *  │ h      │ Hour (0–23)                │
+ *  │ hh     │ Hour (00–23)               │
+ *  │ m      │ Minute (0–59)              │
+ *  │ mm     │ Minute (00–59)             │
+ *  │ s      │ Second (0–59)              │
+ *  │ ss     │ Second (00–59)             │
+ *  └────────┴────────────────────────────┘
+ *
+ * @examples
+ *  getDate("YYYY-MM-DD hh:mm:ss") → "2025-11-03 04:05:09"
+ *  getDate("YYYY-M-D h:m:s")     → "2025-11-3 4:5:9"
+ *  getDate("D/M/YYYY")           → "3/11/2025"
+ *
+ * @param format - (Optional) The desired date format string. Defaults to "YYYY-MM-DD".
+ * @returns A formatted date/time string.
+ */
+export declare function getDate(format?: string): string;
+/**
+ * Normalizes a date input to a timestamp (ms since epoch).
+ * - If input is a string, it will be parsed with Date.parse().
+ * - If input is a number (timestamp), it will be used directly.
+ *
+ * @param input Date as a timestamp (ms) or string
+ * @returns timestamp in milliseconds
+ */
+export declare function getParsedDate(input: number | string | null | undefined): number;