@sridharkikkeri/playwright-common 1.0.17 → 1.0.18

package/create-healthedge-tests.js

@@ -56,7 +56,7 @@ const packageJson = {
     'lint:fix': 'eslint . --fix'
   },
   dependencies: {
-    '@sridharkikkeri/playwright-common': '^1.0.17',
+    '@sridharkikkeri/playwright-common': '^1.0.18',
     '@playwright/test': '^1.42.0',
     'allure-playwright': '^3.4.5'
   },
@@ -70,104 +70,173 @@ const packageJson = {
 
 fs.writeFileSync(path.join(projectPath, 'package.json'), JSON.stringify(packageJson, null, 2));
 
-// --- CORE EXTENSION BOILERPLATE ---
+// --- ENHANCED CORE EXTENSION BOILERPLATE ---
 
-const baseApiClientTs = `import { ApiClient } from '@sridharkikkeri/playwright-common';
+const apiClientTs = `import { ApiClient as CommonApiClient } from '@sridharkikkeri/playwright-common';
 
-export class BaseApiClient extends ApiClient {
+/**
+ * Enterprise API Client.
+ * Use this class to add project-specific headers, 
+ * authentication tokens, or shared response validation.
+ */
+export class ApiClient extends CommonApiClient {
     constructor(baseUrl: string) {
         super(baseUrl);
     }
-    // Add shared project-specific headers or logic here
+
+    async getWithAuth(endpoint: string) {
+        const token = 'YOUR_AUTH_TOKEN'; // Replace with real auth logic
+        return this.get(endpoint, {
+            headers: { 'Authorization': \`Bearer \${token}\` }
+        });
+    }
+
+    async postData(endpoint: string, data: any) {
+        return this.post(endpoint, data);
+    }
 }
 `;
-fs.writeFileSync(path.join(projectPath, 'src/core/api/BaseApiClient.ts'), baseApiClientTs);
+fs.writeFileSync(path.join(projectPath, 'src/core/api/ApiClient.ts'), apiClientTs);
 
-const projectAuthTs = `import { CookieAuth, AuthStrategy } from '@sridharkikkeri/playwright-common';
+const authStrategyTs = `import { CookieAuth, AuthStrategy as CommonAuthStrategy } from '@sridharkikkeri/playwright-common';
 
-export class ProjectAuth {
-    static async setupSession(auth: AuthStrategy) {
-        // Implement custom complex auth setup if needed
+export class AuthStrategy extends CommonAuthStrategy {
+    async login(credentials: any): Promise<void> {
+        // Implement project-specific login logic here
+        await this.page.goto('/login');
+        await this.page.fill('#username', credentials.username);
+        await this.page.fill('#password', credentials.password);
+        await this.page.click('#login-btn');
     }
 }
 `;
-fs.writeFileSync(path.join(projectPath, 'src/core/api/auth/ProjectAuth.ts'), projectAuthTs);
+fs.writeFileSync(path.join(projectPath, 'src/core/api/auth/AuthStrategy.ts'), authStrategyTs);
 
-const envConfigTs = `import { ConfigManager } from '@sridharkikkeri/playwright-common';
+const configManagerTs = `import { ConfigManager as CommonConfigManager } from '@sridharkikkeri/playwright-common';
 
-export class ProjectConfig extends ConfigManager {
-    static getClientName() { return 'HealthEdge'; }
+export class ConfigManager extends CommonConfigManager {
+    static getEnvironmentConfig() {
+        return this.getConfig();
+    }
+    
+    static isSelfHealingEnabled() {
+        return this.getConfig().healingEnabled ?? true;
+    }
 }
 `;
-fs.writeFileSync(path.join(projectPath, 'src/core/config/ProjectConfig.ts'), envConfigTs);
+fs.writeFileSync(path.join(projectPath, 'src/core/config/ConfigManager.ts'), configManagerTs);
 
-const localizationTs = `import { Localization } from '@sridharkikkeri/playwright-common';
+const localizationTs = `import { Localization as CommonLocalization } from '@sridharkikkeri/playwright-common';
 
-export class ProjectLocalization extends Localization {
-    static getAvailableLocales() { return ['en', 'fr']; }
+export class Localization extends CommonLocalization {
+    static getTranslate(key: string) {
+        return this.t(key);
+    }
 }
 `;
-fs.writeFileSync(path.join(projectPath, 'src/core/i18n/ProjectLocalization.ts'), localizationTs);
+fs.writeFileSync(path.join(projectPath, 'src/core/i18n/Localization.ts'), localizationTs);
 
-const baseComponentTs = `import { Page } from '@playwright/test';
-import { BasePage, ActionOrchestrator } from '@sridharkikkeri/playwright-common';
+const basePageTs = `import { Page } from '@playwright/test';
+import { BasePage as CommonBasePage, ActionOrchestrator } from '@sridharkikkeri/playwright-common';
 
-export abstract class BaseComponent extends BasePage {
-    constructor(page: Page, orchestrator?: ActionOrchestrator) {
-        super(page, { pageName: 'BaseComponent', orchestrator });
+/**
+ * Global Base Page for all project Page Objects.
+ */
+export abstract class BasePage extends CommonBasePage {
+    constructor(page: Page, options?: { pageName: string; orchestrator?: ActionOrchestrator }) {
+        super(page, options);
+    }
+
+    async waitForLoadingFinished() {
+        await this.page.waitForSelector('.loading-spinner', { state: 'hidden' });
     }
 }
 `;
-fs.writeFileSync(path.join(projectPath, 'src/core/pages/BaseComponent.ts'), baseComponentTs);
+fs.writeFileSync(path.join(projectPath, 'src/core/pages/BasePage.ts'), basePageTs);
 
-const reporterTs = `import { AllureUtil } from '@sridharkikkeri/playwright-common';
+const allureUtilTs = `import { AllureUtil as CommonAllureUtil } from '@sridharkikkeri/playwright-common';
 
-export class ProjectReporter {
-    static async logEnterpriseStep(name: string) {
-        console.log(\`[ENTERPRISE] \${name}\`);
+export class AllureUtil extends CommonAllureUtil {
+    static async captureStep(name: string, body: () => Promise<void>) {
+        await this.step(name, body);
     }
 }
 `;
-fs.writeFileSync(path.join(projectPath, 'src/core/reporting/ProjectReporter.ts'), reporterTs);
+fs.writeFileSync(path.join(projectPath, 'src/core/reporting/AllureUtil.ts'), allureUtilTs);
+
+const locatorHealingTs = `import { LocatorHealing as CommonLocatorHealing } from '@sridharkikkeri/playwright-common';
+
+export class LocatorHealing extends CommonLocatorHealing {
+    // Add project-specific healing logic or custom heuristics here
+}
+`;
+fs.writeFileSync(path.join(projectPath, 'src/core/selfhealing/LocatorHealing.ts'), locatorHealingTs);
 
-const healingTs = `import { LocatorHealing } from '@sridharkikkeri/playwright-common';
+const actionOrchestratorTs = `import { ActionOrchestrator as CommonActionOrchestrator } from '@sridharkikkeri/playwright-common';
 
-export class ProjectHealer extends LocatorHealing {
-    // Override framework healing logic here
+export class ActionOrchestrator extends CommonActionOrchestrator {
+    // Extend orchestration logic here
 }
 `;
-fs.writeFileSync(path.join(projectPath, 'src/core/selfhealing/ProjectHealer.ts'), healingTs);
+fs.writeFileSync(path.join(projectPath, 'src/core/selfhealing/ActionOrchestrator.ts'), actionOrchestratorTs);
+
+const visualTestingTs = `import { VisualTesting as CommonVisualTesting } from '@sridharkikkeri/playwright-common';
 
-const visualTs = `import { VisualTesting } from '@sridharkikkeri/playwright-common';
+export class VisualTesting extends CommonVisualTesting {
+    static async verifyFullPage(name: string) {
+        // Custom full page screenshot logic
+    }
+}
+`;
+fs.writeFileSync(path.join(projectPath, 'src/core/visual/VisualTesting.ts'), visualTestingTs);
+
+const elementWrapperTs = `import { ElementWrapper as CommonElementWrapper } from '@sridharkikkeri/playwright-common';
+
+/**
+ * Enterprise Element Wrapper.
+ * Extend this class to add project-specific element interactions.
+ */
+export class ElementWrapper extends CommonElementWrapper {
+    async clickAndLog(stepDescription?: string): Promise<void> {
+        console.log(\`[AUTO-LOG] Clicking element: \${stepDescription || 'unknown'}\`);
+        await this.click(stepDescription);
+    }
 
-export class ProjectVisuals extends VisualTesting {
-    // Custom exclusions or thresholds
+    async forceFill(value: string, stepDescription?: string): Promise<void> {
+        await this.locator.fill(value, { force: true });
+    }
 }
 `;
-fs.writeFileSync(path.join(projectPath, 'src/core/visual/ProjectVisuals.ts'), visualTs);
+fs.writeFileSync(path.join(projectPath, 'src/core/wrappers/ElementWrapper.ts'), elementWrapperTs);
 
-const wrapperTs = `import { ElementWrapper } from '@sridharkikkeri/playwright-common';
+const loggerTs = `import { Logger as CommonLogger } from '@sridharkikkeri/playwright-common';
 
-export class ProjectElement extends ElementWrapper {
-    // Extend element behaviors (e.g., custom scrolls)
+export class Logger extends CommonLogger {
+    static info(message: string) {
+        console.log(\`[INFO] \${message}\`);
+    }
 }
 `;
-fs.writeFileSync(path.join(projectPath, 'src/core/wrappers/ProjectElement.ts'), wrapperTs);
+fs.writeFileSync(path.join(projectPath, 'src/core/utils/Logger.ts'), loggerTs);
+
+const errorUtilsTs = `import { ErrorUtils as CommonErrorUtils } from '@sridharkikkeri/playwright-common';
 
-const projectUtilsTs = `export class ProjectUtils {
-    static generateRandomID() { return Math.random().toString(36).substring(7); }
+export class ErrorUtils extends CommonErrorUtils {
+    // Project-specific error handling
 }
 `;
-fs.writeFileSync(path.join(projectPath, 'src/core/utils/ProjectUtils.ts'), projectUtilsTs);
+fs.writeFileSync(path.join(projectPath, 'src/core/utils/ErrorUtils.ts'), errorUtilsTs);
 
 // --- UTILS & I18N POPULATION ---
 const stringUtilsTs = `export class StringUtils {
     static capitalize(str: string) { return str.charAt(0).toUpperCase() + str.slice(1); }
+    static mask(str: string) { return str.replace(/./g, '*'); }
 }`;
 fs.writeFileSync(path.join(projectPath, 'src/utils/StringUtils.ts'), stringUtilsTs);
 
 const dateUtilsTs = `export class DateUtils {
     static now() { return new Date().toISOString(); }
+    static format(date: Date) { return date.toLocaleDateString(); }
 }`;
 fs.writeFileSync(path.join(projectPath, 'src/utils/DateUtils.ts'), dateUtilsTs);
 
@@ -175,51 +244,61 @@ fs.writeFileSync(path.join(projectPath, 'src/i18n/en.json'), JSON.stringify({ "w
 fs.writeFileSync(path.join(projectPath, 'src/i18n/fr.json'), JSON.stringify({ "welcome": "Bienvenue chez HealthEdge" }, null, 2));
 
 // --- DOCUMENTATION ---
-fs.writeFileSync(path.join(projectPath, 'api-docs/assets/style.css'), 'body { font-family: sans-serif; padding: 20px; }');
-fs.writeFileSync(path.join(projectPath, 'api-docs/index.html'), `
+fs.writeFileSync(path.join(projectPath, 'api-docs/assets/style.css'), 'body { font-family: sans-serif; padding: 20px; line-height: 1.6; }');
+fs.writeFileSync(path.join(projectPath, 'api-docs/index.html'), \`
 <html>
-<head><link rel="stylesheet" href="assets/style.css"></head>
+<head>
+    <title>\${projectName} API Docs</title>
+    <link rel="stylesheet" href="assets/style.css">
+</head>
 <body>
-    <h1>${projectName} - API Documentation</h1>
-    <p>This folder is ready to host your TypeDoc or custom API documentation.</p>
+    <h1>\${projectName} - Enterprise API Documentation</h1>
+    <p>Welcome to the central documentation hub for your Playwright testing project.</p>
+    <ul>
+        <li><a href="classes/README.md">Class References</a></li>
+        <li><a href="interfaces/README.md">Interfaces</a></li>
+    </ul>
 </body>
-</html>`);
+</html>\`);
+
 ['classes', 'interfaces', 'types', 'variables'].forEach(fold => {
-  fs.writeFileSync(path.join(projectPath, `api-docs/${fold}/README.md`), `# ${fold}\nDocumentation for your project ${fold} goes here.`);
+  fs.writeFileSync(path.join(projectPath, \`api-docs/\${fold}/README.md\`), \`# \${fold.toUpperCase()}\\nDetailed documentation for \${fold} in project \${projectName}.\`);
 });
 
 // --- STANDARD CONFIG & EXAMPLES ---
 const baseConfig = { healingEnabled: true, environment: 'dev', baseUrl: 'https://example.com', apiUrl: 'https://api.example.com', timeout: 30000, retries: 2 };
 const environments = ['dev', 'qa', 'auto', 'staging', 'prod'];
 environments.forEach(env => {
-  const config = { ...baseConfig, environment: env, baseUrl: `https://${env}.example.com`, apiUrl: `https://api-${env}.example.com` };
-  fs.writeFileSync(path.join(projectPath, `framework.config.${env}.json`), JSON.stringify(config, null, 2));
+  const config = { ...baseConfig, environment: env, baseUrl: \`https://\${env}.example.com\`, apiUrl: \`https://api-\${env}.example.com\` };
+  fs.writeFileSync(path.join(projectPath, \`framework.config.\${env}.json\`), JSON.stringify(config, null, 2));
 });
 fs.writeFileSync(path.join(projectPath, 'framework.config.json'), JSON.stringify(baseConfig, null, 2));
 
-const playwrightConfig = `import { defineConfig } from '@playwright/test';
+const playwrightConfig = \`import { defineConfig } from '@playwright/test';
 export default defineConfig({
   testDir: './src/tests',
   timeout: 30000,
+  retries: process.env.CI ? 2 : 0,
   reporter: [['html'], ['allure-playwright', { outputFolder: 'allure-results' }]],
   use: { trace: 'on-first-retry', screenshot: 'only-on-failure' }
-});`;
+});\`;
 fs.writeFileSync(path.join(projectPath, 'playwright.config.ts'), playwrightConfig);
 
-const fixturesTs = `import { test as base } from '@sridharkikkeri/playwright-common';
+const fixturesTs = \`import { test as base } from '@sridharkikkeri/playwright-common';
 import { HomePage } from '../pages/HomePage';
+import { LoginPage } from '../pages/LoginPage';
 
-export const test = base.extend<{ homePage: HomePage }>({
-  homePage: async ({ page, orchestrator }, use) => { 
-    await use(new HomePage(page, orchestrator)); 
-  },
+export const test = base.extend<{ homePage: HomePage; loginPage: LoginPage }>({
+  homePage: async ({ page, orchestrator }, use) => { await use(new HomePage(page, orchestrator)); },
+  loginPage: async ({ page, orchestrator }, use) => { await use(new LoginPage(page, orchestrator)); },
 });
 
-export { expect } from '@playwright/test';`;
+export { expect } from '@playwright/test';\`;
 fs.writeFileSync(path.join(projectPath, 'src/fixtures/fixtures.ts'), fixturesTs);
 
-const samplePage = `import { Page } from '@playwright/test';
-import { BasePage, ActionOrchestrator } from '@sridharkikkeri/playwright-common';
+const homePageTs = \`import { Page } from '@playwright/test';
+import { BasePage } from '../core/pages/BasePage';
+import { ActionOrchestrator } from '../core/selfhealing/ActionOrchestrator';
 
 export class HomePage extends BasePage {
   constructor(page: Page, orchestrator?: ActionOrchestrator) { 
@@ -228,10 +307,31 @@ export class HomePage extends BasePage {
   private readonly searchBtn = this.element('button[type="submit"]');
   async clickSearch() { await this.searchBtn.click('Click Search Button'); }
 }
-`;
-fs.writeFileSync(path.join(projectPath, 'src/pages/HomePage.ts'), samplePage);
+\`;
+fs.writeFileSync(path.join(projectPath, 'src/pages/HomePage.ts'), homePageTs);
 
-const visualTest = `import { test, expect } from '../fixtures/fixtures';
+const loginPageTs = \`import { Page } from '@playwright/test';
+import { BasePage } from '../core/pages/BasePage';
+import { ActionOrchestrator } from '../core/selfhealing/ActionOrchestrator';
+
+export class LoginPage extends BasePage {
+  constructor(page: Page, orchestrator?: ActionOrchestrator) { 
+    super(page, { pageName: 'LoginPage', orchestrator }); 
+  }
+  private readonly userField = this.element('#user');
+  private readonly passField = this.element('#pass');
+  private readonly loginBtn = this.element('#login');
+
+  async login(u: string, p: string) {
+    await this.userField.fill(u, 'Enter username');
+    await this.passField.fill(p, 'Enter password');
+    await this.loginBtn.click('Click Login');
+  }
+}
+\`;
+fs.writeFileSync(path.join(projectPath, 'src/pages/LoginPage.ts'), loginPageTs);
+
+const visualTest = \`import { test, expect } from '../fixtures/fixtures';
 
 test.describe('Enterprise Visual Regression', () => {
     test('HP Visual Verification', async ({ page }) => {
@@ -241,32 +341,27 @@ test.describe('Enterprise Visual Regression', () => {
             threshold: 0.1
         });
     });
-});`;
+});\`;
 fs.writeFileSync(path.join(projectPath, 'src/tests/visual.spec.ts'), visualTest);
 
-const sampleTest = `import { test, expect } from '../fixtures/fixtures';
+const sampleTest = \`import { test, expect } from '../fixtures/fixtures';
 
-test('Standard Smoke Test', async ({ page }) => {
+test('Standard Smoke Test', async ({ page, loginPage }) => {
   await page.goto('https://playwright.dev');
   await expect(page).toHaveTitle(/Playwright/);
-});`;
+});\`;
 fs.writeFileSync(path.join(projectPath, 'src/tests/sample.spec.ts'), sampleTest);
 
-const tsConfig = {
-  compilerOptions: {
-    target: 'ES2020',
-    module: 'commonjs',
-    lib: ['ES2020'],
-    strict: true,
-    esModuleInterop: true,
-    skipLibCheck: true,
-    resolveJsonModule: true
-  },
-  include: ['src/**/*']
+const tsConfig = { 
+  compilerOptions: { 
+    target: 'ES2020', module: 'commonjs', lib: ['ES2020', 'DOM'], 
+    strict: true, esModuleInterop: true, skipLibCheck: true, resolveJsonModule: true 
+  }, 
+  include: ['src/**/*'] 
 };
 fs.writeFileSync(path.join(projectPath, 'tsconfig.json'), JSON.stringify(tsConfig, null, 2));
 
-const gitignore = `node_modules/
+const gitignore = \`node_modules/
 allure-results/
 allure-report/
 test-results/
@@ -274,35 +369,35 @@ playwright-report/
 .env
 *.log
 dist/
-`;
+\`;
 fs.writeFileSync(path.join(projectPath, '.gitignore'), gitignore);
 
-const readme = `# ${projectName}
+const readme = \`# \${projectName}
 
 ## Overview
 Enterprise automation test project powered by **@sridharkikkeri/playwright-common**.
 
 ## Getting Started
-\`\`\`bash
+\\\`\\\`\\\`bash
 npm install
 npm run test:dev
-\`\`\`
+\\\`\\\`\\\`
 
 ## Features
-- **Self-Healing**: Enabled by default
-- **Visual Regression**: \`npm run test:visual\`
-- **Enterprise Reporting**: Allure integration
-`;
+- **Self-Healing**: Powered by AI Action Orchestrator
+- **Visual Regression**: Built-in screenshot comparison
+- **Enterprise Reporting**: Allure reporting with custom steps
+\`;
 fs.writeFileSync(path.join(projectPath, 'README.md'), readme);
 
 console.log('✅ Comprehensive Project Structure Created');
-console.log('\n📦 Installing dependencies...\n');
+console.log('\\n📦 Installing dependencies...\\n');
 
 try {
   execSync('npm install', { cwd: projectPath, stdio: 'inherit' });
-  console.log('\n✅ Dependencies installed');
+  console.log('\\n✅ Dependencies installed');
 } catch (error) {
-  console.log('\n⚠️ npm install failed. Please run manually.');
+  console.log('\\n⚠️ npm install failed. Please run manually.');
 }
 
-console.log(`\n🎉 Project ready! cd ${projectName} and try: npm run test:dev\n`);
+console.log(\`\\n🎉 Project ready! cd \${projectName} and try: npm run test:dev\\n\`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sridharkikkeri/playwright-common",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "Production-grade Playwright framework with AI-powered self-healing, visual regression, and enterprise features",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",