@zohodesk/testinglibrary 0.3.1-experimental → 0.3.1

package/build/test/core/playwright/configuration/__tests__/Configuration.test.js

@@ -0,0 +1,53 @@
+"use strict";
+
+const Configuration = require("../../../../../core/playwright/configuration/Configuration");
+const {
+  combineConfiguration
+} = require("../../../../../core/playwright/configuration/ConfigurationHelper");
+jest.mock('../../../../../core/playwright/configuration/ConfigurationHelper', () => ({
+  combineConfiguration: jest.fn()
+}));
+describe('Configuration Class', () => {
+  let config;
+  let sampleData;
+  beforeEach(() => {
+    // Sample data as a JSON object
+    sampleData = {
+      headless: false,
+      trace: true,
+      video: true,
+      bddMode: true
+    };
+
+    // Initialize the Configuration instance with sample data
+    config = new Configuration(sampleData);
+  });
+  test('should add new key-value pair to the configuration', () => {
+    config.add('newKey', 'newValue');
+    expect(config.get('newKey')).toBe('newValue');
+  });
+  test('should combine configurations correctly using addAll', () => {
+    const newConfig = new Configuration({
+      newKey1: 'newValue1',
+      trace: false // existing key to test override
+    });
+    const combinedConfig = {
+      headless: false,
+      trace: false,
+      // trace overridden
+      video: true,
+      bddMode: true,
+      newKey1: 'newValue1'
+    };
+    combineConfiguration.mockReturnValue(combinedConfig);
+    config.addAll(newConfig);
+    expect(combineConfiguration).toHaveBeenCalledWith(sampleData, newConfig.getAll());
+    expect(config.getAll()).toEqual(combinedConfig);
+  });
+  test('should return correct value for a given key', () => {
+    expect(config.get('headless')).toBe(false);
+    expect(config.get('trace')).toBe(true);
+    expect(config.get('video')).toBe(true);
+    expect(config.get('bddMode')).toBe(true);
+  });
+});

package/build/test/core/playwright/helpers/__tests__/configFileNameProvider.test.js

@@ -0,0 +1,34 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _fs = require("fs");
+var _path = _interopRequireDefault(require("path"));
+var _configFileNameProvider = require("../../../../../core/playwright/helpers/configFileNameProvider");
+jest.mock('fs');
+jest.mock('path');
+const mockCwd = '/mock/current/directory';
+_path.default.resolve = jest.fn();
+process.cwd = jest.fn(() => mockCwd);
+describe('getUATFileName', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+  test('return the pipeline matched config files for pipeline matched files exists', () => {
+    const mode = 'cd';
+    const mockPath = `${mockCwd}/uat/conf/${mode}/uat.config.js`;
+    _fs.existsSync.mockReturnValue(true);
+    _path.default.resolve.mockImplementation((...args) => args.join('/'));
+    const result = (0, _configFileNameProvider.getUATFileName)(mode);
+    expect(_fs.existsSync).toHaveBeenCalledWith(mockPath);
+    expect(result).toBe(mockPath);
+  });
+  test('return the default config files for pipeline matched files not exists', () => {
+    const mode = 'ci';
+    const defaultPath = `${mockCwd}/uat.config.js`;
+    _fs.existsSync.mockReturnValue(false);
+    _path.default.resolve.mockImplementation((...args) => args.join('/'));
+    const result = (0, _configFileNameProvider.getUATFileName)(mode);
+    expect(_fs.existsSync).toHaveBeenCalledWith(`${mockCwd}/uat/conf/${mode}/uat.config.js`);
+    expect(result).toBe(defaultPath);
+  });
+});

package/build/test/core/playwright/helpers/__tests__/getUsers_ListOfActors.test.js

@@ -0,0 +1,80 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _fs = require("fs");
+var _path = _interopRequireDefault(require("path"));
+jest.mock('fs');
+jest.mock('path');
+jest.mock('../../../../../core/playwright/readConfigFile', () => ({
+  generateConfigFromFile: jest.fn(() => ({
+    uatDirectory: '/test/directory'
+  })),
+  getRunMode: jest.fn(() => 'dev')
+}));
+const {
+  getListOfActors
+} = require('../../../../../core/playwright/helpers/auth/getUsers');
+describe('getListOfActors', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+    _path.default.join.mockImplementation((...args) => args.join('/'));
+  });
+  test('throws an error when config file cannot be loaded', () => {
+    _fs.existsSync.mockReturnValueOnce(true); // Main config file exists
+
+    jest.mock('/test/directory/conf/dev/actors/index.js', () => {
+      throw new Error('Loading error');
+    }, {
+      virtual: true
+    });
+    expect(() => getListOfActors()).toThrow('Error loading actor configuration from /test/directory/conf/dev/actors/index.js');
+  });
+  test('throws an error when beta feature config does not exist', () => {
+    _fs.existsSync.mockReturnValueOnce(true) // Main config file exists
+    .mockReturnValueOnce(false); // Beta feature config does not exist in either path
+
+    const betaFeature = 'nonExistentFeature';
+    expect(() => getListOfActors(betaFeature)).toThrow(`There is no beta feature configured with the name "${betaFeature}"`);
+  });
+  test('loads main configuration when betaFeature is not provided and main config file exists', () => {
+    _fs.existsSync.mockReturnValueOnce(true);
+    jest.doMock('/test/directory/conf/dev/actors/index.js', () => ({
+      actors: []
+    }), {
+      virtual: true
+    });
+    const result = getListOfActors();
+    expect(result).toEqual({
+      actors: []
+    });
+  });
+  test('falls back to default configuration if main config file does not exist', () => {
+    _fs.existsSync.mockReturnValueOnce(false).mockReturnValueOnce(true);
+    jest.doMock('/test/directory/conf/default/actors/index.js', () => ({
+      actors: []
+    }), {
+      virtual: true
+    });
+    const result = getListOfActors();
+    expect(result).toEqual({
+      actors: []
+    });
+  });
+  test('loads beta feature configuration when betaFeature is provided', () => {
+    _fs.existsSync.mockReturnValueOnce(true) // Main config file exists
+    .mockReturnValueOnce(true); // Beta feature config exists
+
+    const betaFeature = 'parentchild';
+    const betaFeaturePath = `/test/directory/conf/dev/actors/beta/${betaFeature}/index.js`;
+    jest.doMock(betaFeaturePath, () => ({
+      betaActors: []
+    }), {
+      virtual: true
+    });
+    const result = getListOfActors(betaFeature);
+    expect(result).toEqual({
+      betaActors: []
+    });
+    expect(_path.default.join).toHaveBeenCalledWith('/test/directory', `conf/dev/actors/beta/${betaFeature}/index.js`);
+  });
+});

package/build/utils/cliArgsToObject.js

@@ -36,6 +36,9 @@ function cliArgsToObject(cliArgs, isKeyNeedToBeAdded) {
         value = true;
       }
       processEnv[key] = value;
+      if (!isNaN(parseInt(value))) {
+        processEnv[key] = parseInt(value);
+      }
     }
   });
   return processEnv;

package/jest.config.js

@@ -5,6 +5,16 @@ const appPath = process.cwd();
 const appGlobals = path.resolve(appPath, '__testUtils__', 'globals.js');
 
 module.exports = {
+  reporters: [
+    "default",
+    [
+      "jest-html-reporter",
+      {
+        outputPath: "unit_reports/unit-report.html",
+        pageTitle: "Unit Report"
+      }
+    ]
+  ],
   rootDir: process.cwd(),
   testEnvironment: 'node',
 
@@ -22,7 +32,7 @@ module.exports = {
       'preprocessor',
       'jsPreprocessor.js'
     ),
-    '^.+\\.jsx?$': 'babel-jest',
+    '^.+\\.jsx?$': 'babel-jest'
   },
   
   testMatch: ['**/__tests__/**/*.test.js'],
@@ -56,14 +66,14 @@ module.exports = {
   collectCoverageFrom: ['src/**/*.js'],
   coverageDirectory: './build/cov',
   coverageReporters: ['lcov', 'json', 'html', 'json-summary', 'text'],
-  coverageThreshold: {
-    global: {
-      branches: 100,
-      functions: 100,
-      lines: 100,
-      statements: 100
-    }
-  },
+  // coverageThreshold: {
+  //   global: {
+  //     branches: 100,
+  //     functions: 100,
+  //     lines: 100,
+  //     statements: 100
+  //   }
+  // },
   globals: {
     __DEVELOPMENT__: true,
     __DOCS__: false,

package/nobdd/README.md

@@ -0,0 +1 @@
+npm install $(npm pack ../ | tail -1)

package/nobdd/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "testingframeworknobdd",
+  "version": "1.0.0",
+  "description": "collection of examples that we can use for testing",
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "scripts": {
+    "uat": "ZDTestingFramework test --mode=dev --headed",
+    "uatnobdd": "ZDTestingFramework test --mode=nobdd",
+    "uat-ci": "ZDTestingFramework test --mode=ci --headed",
+    "uat-clean": "ZDTestingFramework clearCaches",
+    "uat-debug": "ZDTestingFramework test --mode=dev --debug",
+    "uat-report": "ZDTestingFramework report --port=9009",
+    "codegen": "ZDTestingFramework codegen deskclientapp.localzoho.com/agent"
+  }
+}

package/nobdd/uat/conf/default/actors/beta/custom-module.json

@@ -0,0 +1,24 @@
+[
+  {
+    "id": "1",
+    "edition": "enterprise",
+    "orgName": "custommoduleportal",
+    "profiles": [
+      {
+        "profile": "admin",
+        "email": "indragith.m+agent@zohotest.com",
+        "password": "Paara!2019"
+      },
+      {
+        "profile": "agent",
+        "email": "indragith.m+agent@zohotest.com",
+        "password": "Paara!2019"
+      },
+      {
+        "profile": "lightagent",
+        "email": "indragith.m+abc1@zohotest.com",
+        "password": "Paara!2019"
+      }
+    ]
+  }
+]

package/nobdd/uat/conf/default/actors/beta/index.js

@@ -0,0 +1,6 @@
+const parentchild = require('./parent-child.json');
+const custommodule = require('./custom-module.json');
+
+const beta = { parentchild, custommodule };
+
+module.exports = beta;

package/nobdd/uat/conf/default/actors/beta/parent-child.json

@@ -0,0 +1,24 @@
+[
+  {
+    "id": "1",
+    "edition": "enterprise",
+    "orgName": "parentchildportal",
+    "profiles": [
+      {
+        "profile": "admin",
+        "email": "indragith.m@zohocorp.com",
+        "password": "Paara!2019"
+      },
+      {
+        "profile": "agent",
+        "email": "indragith.m+agent@zohotest.com",
+        "password": "Paara!2019"
+      },
+      {
+        "profile": "lightagent",
+        "email": "indragith.m+abc1@zohotest.com",
+        "password": "Paara!2019"
+      }
+    ]
+  }
+]

package/nobdd/uat/conf/default/actors/editions/enterprise.json

@@ -0,0 +1,24 @@
+[
+  {
+    "id": "1",
+    "edition": "enterprise",
+    "orgName": "zohodeskteam",
+    "profiles": [
+      {
+        "profile": "admin",
+        "email": "solairaj.m+26jun2023@zohotest.com",
+        "password": "Demo@1201"
+      },
+      {
+        "profile": "agent",
+        "email": "anitha.m+agentat@zohotest.com",
+        "password": "Desk@1234"
+      },
+      {
+        "profile": "lightagent",
+        "email": "anitha.m+admin@zohotest.com",
+        "password": "Moon@2018"
+      }
+    ]
+  }
+]

package/nobdd/uat/conf/default/actors/editions/index.js

@@ -0,0 +1,4 @@
+const enterprise = require('./enterprise.json');
+const editions = {enterprise};
+
+module.exports = editions;

package/nobdd/uat/conf/default/actors/index.js

@@ -0,0 +1,5 @@
+const editions = require('./editions/index');
+const beta = require('./beta/index');
+
+
+module.exports = { editions, beta }

package/nobdd/uat/conf/default/settings.json

@@ -0,0 +1,6 @@
+{
+  "environment": "ci",
+  "edition": "enterprise",
+  "profile": "admin",
+  "domain": "https://zdesk-devops08.csez.zohocorpin.com:31007/agent"
+}

package/nobdd/uat/conf/nobdd/uat.config.js

@@ -0,0 +1,28 @@
+const customFixtures = require('../../shared/commands/_index-custom-fixtures');
+
+const { getDefaultActor } = require('@zohodesk/testinglibrary/helpers');
+
+function getPrimaryCookiePath() {
+  const { email } = getDefaultActor();
+  return `uat/playwright/.auth/${email}-cookies.json`;
+}
+
+/**
+ * Represents the user configuration object.
+ * @typedef {import('@zohodesk/testinglibrary').UserConfig} UserConfig
+ */
+module.exports = {
+  headless: true,
+  openReportOn: 'never',
+  browsers: ['Chrome'],
+  isAuthMode: false,
+  authFilePath: getPrimaryCookiePath(),
+  trace: true,
+  video: true,
+  bddMode: false,
+  viewport: { width: 1280, height: 720 },
+  testIdAttribute: 'data-id',
+  additionalPages: {
+    ...customFixtures
+  }
+};

package/nobdd/uat/env-config.json

@@ -0,0 +1,20 @@
+{
+  "dev": {
+    "domain": "https://desk.localzoho.com/agent",
+    "orgName": "org-name",
+    "deptName": "dept-name",
+    "moduleName": "module-name"
+  },
+  "prod": {
+    "domain": "https://desk.localzoho.com/agent/",
+    "orgName": "sangeetha.t@zohocorp.com",
+    "deptName": "sangeethat",
+    "moduleName": "sangeethat"
+  },
+  "ci": {
+    "domain": "https://zdesk-devops08.csez.zohocorpin.com:31007/agent/",
+    "orgName": "clientcicdk8",
+    "deptName": "clientcicdk8",
+    "moduleName": "tickets"
+  }
+}

package/nobdd/uat/fixtures/auth.setup.js

@@ -0,0 +1,44 @@
+/* eslint-disable no-console */
+import {
+  test as setup,
+  expect
+} from '@zohodesk/testinglibrary';
+import {
+  getDefaultActor,
+  getUserForSelectedEditionAndProfile,
+  performLoginSteps
+} from '@zohodesk/testinglibrary/helpers'
+import { SETUP_HOME_PAGE_SELECTORS } from '../modules/Setup/dom-selectors/SetupSelectors';
+import getUrlOrigin from '../shared/url-helpers/getUrlOrigin';
+
+const { edition, profile } = getDefaultActor();
+
+const user = getUserForSelectedEditionAndProfile(edition, profile);
+
+async function verifyPageIsLoaded(page) {
+  const urlOrigin = getUrlOrigin(page.url());
+  const domainOrigin = getUrlOrigin(process.env.domain);
+  if (urlOrigin === domainOrigin) {
+    await expect(
+      page
+        .locator('header')
+        .getByLabel(SETUP_HOME_PAGE_SELECTORS.SETUP_ICON_LABEL)
+    ).toBeVisible();
+    return true;
+  }
+  return false;
+}
+
+setup(`${user.edition} - Authentication`, async ({ page }) => {
+  const { email, password } = user;
+  await performLoginSteps(
+    {
+      page,
+      authFilePrefix: email,
+      useremail: email,
+      password: password
+    },
+    verifyPageIsLoaded
+  );
+  //await completeOnboardings({ page });
+});

package/nobdd/uat/fixtures/setup.teardown.js

@@ -0,0 +1,32 @@
+import fs from 'fs';
+import path from 'path';
+import {
+  test as teardown,
+  expect
+} from '@zohodesk/testinglibrary';
+import { isDevelopmentSetup, loadCookiesIfPresent } from '@zohodesk/testinglibrary/helpers'
+import getUrlOrigin from '../shared/url-helpers/getUrlOrigin';
+
+// We are adding teardown logic only in CI mode
+if (!isDevelopmentSetup()) {
+  teardown(`Log out scenarios`, async ({ page }) => {
+    const authDirectory = path.resolve(
+      process.cwd(),
+      'uat',
+      'playwright',
+      '.auth'
+    );
+    const files = fs.readdirSync(authDirectory);
+    const promises = files.map(async file => {
+      const authFilePath = path.join(authDirectory, file);
+      await loadCookiesIfPresent(page, authFilePath);
+      const domainOrigin = getUrlOrigin(process.env.domain);
+      await page.goto(`${domainOrigin}/support/logout.sas `);
+      await page.waitForNavigation();
+      await expect(page.locator('[id="signin_flow"]')).toBeVisible();
+      await fs.rmSync(authFilePath);
+    });
+
+    await Promise.all(promises);
+  });
+}

package/nobdd/uat/modules/nobdd/steps/VerifyNoBDD.feature.spec.js

@@ -0,0 +1,16 @@
+import { test, expect } from "@zohodesk/testinglibrary";
+
+test.describe("Verify no authentication required @nobdd", () => {
+
+  test("Verify the page is not logged in", async ({ page }) => {
+
+    await page.goto('https://desk.localzoho.com/');
+
+    await page.waitForSelector('.zgh-accounts');
+
+    const isLoggedIn = await page.isVisible('.zgh-accounts');
+    expect(isLoggedIn).toBe(true);
+
+  });
+
+});

package/nobdd/uat/shared/commands/_index-custom-fixtures.js

@@ -0,0 +1,9 @@
+const i18n = require('./i18n');
+const unAuthenticatedPage = require('./unauthenticatedPage');
+
+const customFixtures = {
+  ...i18n,
+  ...unAuthenticatedPage
+};
+
+module.exports = customFixtures;

package/nobdd/uat/shared/commands/i18n.js

@@ -0,0 +1,25 @@
+/* eslint-disable no-param-reassign */
+
+// Note: We are duplicating below method from @zohodesk/i18n. We are not importing it as react package not yet availble in test environment.
+function replaceI18NValuesWithRegex(i18nStr, values) {
+  if (typeof values !== 'undefined') {
+    if (Array.isArray(values)) {
+      for (let i = 0; i < values.length; i++) {
+        i18nStr = i18nStr.replace(new RegExp(`\\{${i}\\}`, 'g'), values[i]);
+      }
+    } else {
+      i18nStr = i18nStr.replace(new RegExp('\\{0\\}', 'g'), values);
+    }
+  }
+  return i18nStr;
+}
+
+module.exports = {
+  i18N: async ({ page }, use) => {
+    await use(async (key, values) => {
+      const i18nValue = await page.evaluate((i18nKey) => window.i18n[i18nKey], key);
+      const i18nStr = replaceI18NValuesWithRegex(i18nValue, values)
+      return i18nStr;
+    })
+  }
+}

package/nobdd/uat/shared/commands/unauthenticatedPage.js

@@ -0,0 +1,8 @@
+module.exports = {
+  unauthenticatedPage: async ({ browser }, use) => {
+    const context = await browser.newContext({ storageState: null });
+    const unauthenticatedPage = await context.newPage();
+    await use(unauthenticatedPage);
+    await context.close();
+  }
+}

package/nobdd/uat/shared/index.js

@@ -0,0 +1,7 @@
+const completeOnboardings = require("./onboardings/onboardingUpdate")
+
+
+
+module.exports = {
+    completeOnboardings
+}

package/nobdd/uat/shared/onboardings/onboardingUpdate.js

@@ -0,0 +1,44 @@
+async function get_cookie(page) {
+  return page.evaluate(async () => {
+    const results = document.cookie.match(`crmcsr=(.*?)(;|$)`);
+    if (results) {
+      return unescape(results[1]);
+    }
+    return null;
+  });
+}
+
+async function getOnboardings({ page, cookieVal }) {
+  return page.evaluate(
+    async (cookieVal) =>
+      fetch('/api/v1/onboardingStatus', {
+        method: 'GET',
+        headers: {
+          orgId: window.currentOrg.id,
+          'X-ZCSRF-TOKEN': `crmcsrfparam=${cookieVal}`
+        }
+      }).then((r) => (r.ok ? r.json() : Promise.reject(r))),
+    cookieVal
+  );
+}
+
+async function completeOnboardings({ page }) {
+  const cookieVal = await get_cookie(page);
+  const onboardings = await getOnboardings({ page });
+  if (onboardings.pending.length) {
+    await page.evaluate(
+      async ({ cookieVal, onboardings }) =>
+        fetch('/api/v1/onboardingStatus/markComplete', {
+          method: 'POST',
+          headers: {
+            orgId: window.currentOrg.id,
+            'X-ZCSRF-TOKEN': `crmcsrfparam=${cookieVal}`
+          },
+          body: JSON.stringify({ items: onboardings.pending })
+        }),
+      { cookieVal, onboardings }
+    );
+  }
+}
+
+module.exports = completeOnboardings;

package/nobdd/uat/shared/url-helpers/getUrlOrigin.js

@@ -0,0 +1,6 @@
+function getUrlOrigin(url) {
+  const { origin } = new URL(url);
+  return origin;
+}
+
+module.exports = getUrlOrigin;

package/nobdd/uat.config.js

@@ -0,0 +1,30 @@
+const customFixtures = require('./uat/shared/commands/_index-custom-fixtures');
+
+const { getDefaultActor } = require('@zohodesk/testinglibrary/helpers');
+
+function getPrimaryCookiePath() {
+  const { email } = getDefaultActor();
+  return `uat/playwright/.auth/${email}-cookies.json`;
+}
+
+/**
+ * Represents the user configuration object.
+ * @typedef {import('@zohodesk/testinglibrary').UserConfig} UserConfig
+ */
+module.exports = {
+  headless: false,
+  openReportOn: 'never',
+  browsers: ['Chrome'],
+  isAuthMode: true,
+  authFilePath: getPrimaryCookiePath(),
+  trace: true,
+  video: true,
+  bddMode: true,
+  featureFilesFolder: 'feature-files',
+  stepDefinitionsFolder: 'steps',
+  viewport: { width: 1280, height: 720 },
+  testIdAttribute: 'data-id',
+  additionalPages: {
+    ...customFixtures
+  }
+};