@zohodesk/testinglibrary 0.4.21-experimental → 0.4.23-experimental

package/build/core/playwright/setup/config-utils.js

@@ -7,12 +7,14 @@ Object.defineProperty(exports, "__esModule", {
 exports.getBrowsersList = getBrowsersList;
 exports.getProjects = getProjects;
 exports.getTestDir = getTestDir;
+exports.getTestUseOptions = getTestUseOptions;
 var _test = require("@playwright/test");
 var _path = _interopRequireDefault(require("path"));
 var _readConfigFile = require("../readConfigFile");
-var _playwrightBdd = require("playwright-bdd");
+var _bddFramework = require("../../../bdd-framework");
 var _logger = require("../../../utils/logger");
 var _browserTypes = require("../constants/browserTypes");
+var _configFileNameProvider = require("../helpers/configFileNameProvider");
 var _fileUtils = require("../../../utils/fileUtils");
 /**
  ** Playwright project configuration
@@ -146,15 +148,30 @@ function getPathsForFeatureFiles(cwd) {
 function getTestDir(bddMode, cwd, {
   stepDefinitionsFolder
 }) {
-  return bddMode ? (0, _playwrightBdd.defineBddConfig)({
-    features: getPathsForFeatureFiles(cwd),
-    steps: [_path.default.join(cwd, 'uat', '**', stepDefinitionsFolder, '*.spec.js'), require.resolve('../fixtures.js')],
-    importTestFrom: require.resolve('../fixtures.js'),
+  return bddMode ? (0, _bddFramework.defineBddConfig)({
+    paths: getPathsForFeatureFiles(cwd),
+    import: [_path.default.join(cwd, 'uat', '**', stepDefinitionsFolder, '*.spec.js')],
     featuresRoot: _path.default.join(cwd, 'uat'),
     outputDir: _path.default.join(cwd, 'uat', '.features-gen'),
-    disableWarnings: {
-      importTestFrom: true
-    },
     publish: true
   }) : _path.default.join(cwd, 'uat');
+}
+function getTestUseOptions({
+  viewport,
+  trace,
+  video,
+  testIdAttribute
+}) {
+  let defaultTestuseOptions = {
+    viewport,
+    testIdAttribute,
+    trace: trace ? 'on' : 'off',
+    video: video ? {
+      mode: 'on',
+      size: {
+        ...viewport
+      }
+    } : 'off'
+  };
+  return defaultTestuseOptions;
 }

package/build/core/playwright/test-runner.js

@@ -24,7 +24,7 @@ var _RunnerHelper = _interopRequireDefault(require("./runner/RunnerHelper"));
 var _Runner = _interopRequireDefault(require("./runner/Runner"));
 function runPreprocessing(tagArgs, configPath) {
   const beforeCommand = 'node';
-  const bddGenPath = _path.default.resolve((0, _rootPath.getExecutableBinaryPath)('bddgen'));
+  const bddGenPath = _path.default.resolve(__dirname, '../', '../', 'bdd-framework', 'cli', 'index.js');
   const beforeArgs = [bddGenPath, '-c', configPath];
   if (tagArgs) {
     beforeArgs.push('--tags');

package/build/decorators.d.ts

@@ -1 +1 @@
-export * from 'playwright-bdd/decorators';
+export * from './bdd-framework/decorators';

package/build/decorators.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-var _decorators = require("playwright-bdd/decorators");
+var _decorators = require("./bdd-framework/decorators");
 Object.keys(_decorators).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _decorators[key]) return;

package/build/setup-folder-structure/samples/auth-setup-sample.js

@@ -1,21 +1,73 @@
 /* eslint-disable no-console */
 import { test as setup, expect } from '@zohodesk/testinglibrary';
-import {
-  performLoginSteps,
-  getDefaultActor
-} from '@zohodesk/testinglibrary/helpers';
+import path from 'path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { getAuthFileDirectory } from '../../core/playwright';
+import { Logger } from '../../utils/logger';
 
-const user = getDefaultActor();
+const userdata = require('./authUsers.json');
 
-async function verifyPageIsLoaded(page) {
-  //Implement your validation steps here
-  //Refer desk_client_app auth.setup.js
-  return true;
+const authContent = { cookies: [] };
+
+const LOGIN_ERR_MESSAGE = 'Need go be logged in';
+// const AUTH_ERR_MESSAGE = `Founded Path - ${path.resolve(process.cwd(),'uat','playwright','.auth')} \n Find if file is Properly Created. Cookies Cannot Be Read .. `
+
+function convertCookiesToParse(cookies, authFilePath) {
+  try {
+    return JSON.parse(cookies);
+  } catch (err) {
+    Logger.error(err);
+    throw new Error(
+      ` Error while parsing cookies ${err} \n${path.resolve(
+        process.cwd(),
+        authFilePath
+      )} File is Empty`
+    );
+    // process.exit()
+  }
+}
+const authDirectory = getAuthFileDirectory(); //path.resolve(process.cwd(), 'uat', 'playwright', '.auth');
+if (!existsSync(authDirectory)) {
+  console.log('Creating auth directory for the first time setup...');
+  mkdirSync(authDirectory, { recursive: true });
 }
 
-setup(`${user.edition} - Authentication`, async ({ page }) => {
+userdata.forEach(data => {
+  const authFile = path.resolve(path.join(authDirectory, `${data.filename}`));
+  if (!existsSync(authFile)) {
+    console.log('creating auth file..');
+    writeFileSync(authFile, JSON.stringify(authContent, null, 2));
+  }
+  setup(data.description, async ({ page }) => {
+    try {
+      const cookies = readFileSync(authFile);
+      const parsedCookies = convertCookiesToParse(cookies, authFile);
+      await page
+        .context()
+        .addCookies(
+          parsedCookies.cookies === undefined ? [] : parsedCookies.cookies
+        );
+      await page.goto(page.getBaseUrl());
+      await page.waitForLoadState();
+      if (await page.url().includes(process.env.domain)) {
+        await page.waitForSelector(data.locator);
+      } else {
+        throw new Error(LOGIN_ERR_MESSAGE);
+      }
+    } catch (err) {
+      if (err.message === LOGIN_ERR_MESSAGE) {
+        await expect(page.locator('.load-bg')).toBeHidden();
+        await page.locator('#login_id').type(data.useremail);
+        await page.locator('#nextbtn').click();
+        await page.locator('#password').type(data.password);
+        await page.locator('#nextbtn').click();
+
+        await page.waitForLoadState('networkidle');
+
+        await page.waitForSelector(data.locator);
 
-  //Implement performLoginSteps here
-  const { email, password } = user;
-  await performLoginSteps({ },verifyPageIsLoaded );
-});
+        await page.context().storageState({ path: authFile });
+      }
+    }
+  });
+});

package/build/setup-folder-structure/samples/authUsers-sample.json

@@ -0,0 +1,9 @@
+[
+    {
+        "useremail": "/ user name /",
+        "password": "/ password /",
+        "description": "/ description/",
+        "filename": "user.json",
+        "locator": "/ selector to identify page has been loaded completely /"
+    }
+]

package/build/setup-folder-structure/samples/env-config-sample.json

@@ -0,0 +1,21 @@
+{
+  "dev": {
+    "domain": "https://desk.localzoho.com/agent",
+    "orgName": "org-name",
+    "deptName": "dept-name",
+    "moduleName": "module-name",
+    "devURL": "Provide your devURL here"
+  },
+  "prod": {
+    "domain": "https://desk.localzoho.com/agent",
+    "orgName": "org-name",
+    "deptName": "dept-name",
+    "moduleName": "module-name"
+  },
+  "k8test": {
+    "domain": "https://desk.localzoho.com/agent",
+    "orgName": "org-name",
+    "deptName": "dept-name",
+    "moduleName": "module-name"
+  }
+}

package/build/setup-folder-structure/setupProject.js

@@ -10,9 +10,8 @@ var _path = _interopRequireDefault(require("path"));
 var _logger = require("../utils/logger");
 function getScriptsToBeAdded() {
   return {
-    "uat": "ZDTestingFramework test --mode=dev --headed",
-    "uat-debug": "ZDTestingFramework test --mode=dev --debug",
-    "uat-validate": "ZDTestingFramework validate",
+    "uat": "ZDTestingFramework test --mode=prod --headed",
+    "uat-debug": "ZDTestingFramework test --mode=prod --debug",
     "uat-report": "ZDTestingFramework report --port=9009",
     "codegen": "ZDTestingFramework codegen deskclientapp.localzoho.com/agent"
   };
@@ -72,6 +71,7 @@ function createAuthenticationFile() {
         });
       }
       (0, _fs.writeFileSync)(_path.default.resolve(process.cwd(), 'uat', 'fixtures', 'auth.setup.js'), getSetupFileAsString('auth-setup-sample.js'), null, 2);
+      (0, _fs.writeFileSync)(_path.default.resolve(process.cwd(), 'uat', 'fixtures', 'authUsers.json'), getSetupFileAsString('authUsers-sample.json'), null, 2);
       _logger.Logger.log(_logger.Logger.INFO_TYPE, 'Creating Authentication File ....');
     } catch (err) {
       _logger.Logger.error(err);
@@ -84,21 +84,8 @@ function createAuthenticationFile() {
 function createConfigJson() {
   const uatFolder = _path.default.resolve(process.cwd(), 'uat');
   if ((0, _fs.existsSync)(uatFolder)) {
-    _logger.Logger.log(_logger.Logger.INFO_TYPE, 'Creating settings.json file inside UAT Folder');
-    if (!(0, _fs.existsSync)(_path.default.resolve(uatFolder, 'conf', 'default'))) {
-      (0, _fs.mkdirSync)(_path.default.resolve(uatFolder, 'conf', 'default'), {
-        recursive: true
-      });
-    }
-    (0, _fs.writeFileSync)(_path.default.resolve(uatFolder, 'conf', 'default', './settings.json'), getSetupFileAsString('settings.json'), null, 2);
-    if (!(0, _fs.existsSync)(_path.default.resolve(uatFolder, 'conf', 'default', 'actors', 'editions'))) {
-      (0, _fs.mkdirSync)(_path.default.resolve(uatFolder, 'conf', 'default', 'actors', 'editions'), {
-        recursive: true
-      });
-    }
-    (0, _fs.writeFileSync)(_path.default.resolve(uatFolder, 'conf', 'default', 'actors', 'editions', 'free.json'), getSetupFileAsString('free-sample.json'), null, 2);
-    (0, _fs.writeFileSync)(_path.default.resolve(uatFolder, 'conf', 'default', 'actors', 'editions', 'index.js'), getSetupFileAsString('editions-index.js'), null, 2);
-    (0, _fs.writeFileSync)(_path.default.resolve(uatFolder, 'conf', 'default', 'actors', 'index.js'), getSetupFileAsString('actors-index.js'), null, 2);
+    _logger.Logger.log(_logger.Logger.INFO_TYPE, 'Creating env-config file inside UAT Folder');
+    (0, _fs.writeFileSync)(_path.default.resolve(uatFolder, './env-config.json'), getSetupFileAsString('env-config-sample.json'), null, 2);
   } else {
     _logger.Logger.log(_logger.Logger.INFO_TYPE, 'Something went wrong. Please re-initialize the @zohodesk/testinglibrary');
   }

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/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/{build/setup-folder-structure/samples → nobdd/uat/conf/default}/settings.json

@@ -1,7 +1,6 @@
 {
-  "environment": "dev",
+  "environment": "ci",
   "edition": "enterprise",
   "profile": "admin",
-  "domain": "https://zdesk-devops16.csez.zohocorpin.com:31025/agent",
-  "devUrl" : "" 
-}
+  "domain": "https://zdesk-devops16.csez.zohocorpin.com:31025/agent"
+}

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

@@ -0,0 +1,36 @@
+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: false,
+  retries:1,
+  openReportOn: 'never',
+  browsers: ['Chrome'],
+  isAuthMode: true,
+  authFilePath: getPrimaryCookiePath(),
+  trace: 'retain-on-failure',
+  video: 'retain-on-failure',
+  retries:1,
+  bddMode: false,
+  expectTimeout: 10 * 1000,
+  testTimeout: 60 * 1000,
+  globalTimeout: 2 * 60 * 60 * 1000,
+  featureFilesFolder: 'feature-files',
+  stepDefinitionsFolder: 'steps',
+  viewport: { width: 1280, height: 720 },
+  testIdAttribute: 'data-id',
+  editionOrder: ['Free', 'Express', 'Standard', 'Professional', 'Enterprise'],
+  additionalPages: {
+    ...customFixtures
+  }
+};

package/nobdd/uat/env-config.json

@@ -0,0 +1,20 @@
+{
+  "dev": {
+    "domain": "https://zdesk-devops16.csez.zohocorpin.com:31025/agent",
+    "orgName": "org-name",
+    "deptName": "dept-name",
+    "moduleName": "module-name"
+  },
+  "prod": {
+    "domain": "https://zdesk-devops16.csez.zohocorpin.com:31025/agent",
+    "orgName": "sangeetha.t@zohocorp.com",
+    "deptName": "sangeethat",
+    "moduleName": "sangeethat"
+  },
+  "ci": {
+    "domain": "https://zdesk-devops16.csez.zohocorpin.com:31025/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,33 @@
+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);
+      const logoutURL = `${domainOrigin}/support/logout.sas`;
+      await page.goto(logoutURL);
+      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(process.env.domain);
+
+    await page.waitForSelector('#login');
+
+    const isLoggedIn = await page.isVisible('#login');
+    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,37 @@
+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,
+  retries:1,
+  openReportOn: 'never',
+  browsers: ['Chrome'],
+  isAuthMode: true,
+  authFilePath: getPrimaryCookiePath(),
+  trace: 'retain-on-failure',
+  video: 'retain-on-failure',
+  retries:1,
+  bddMode: false,
+  expectTimeout: 10 * 1000,
+  testTimeout: 60 * 1000,
+  globalTimeout: 2 * 60 * 60 * 1000,
+  featureFilesFolder: 'feature-files',
+  stepDefinitionsFolder: 'steps',
+  viewport: { width: 1280, height: 720 },
+  testIdAttribute: 'data-id',
+  editionOrder: ['Free', 'Express', 'Standard', 'Professional', 'Enterprise'],
+  additionalPages: {
+    ...customFixtures
+  },
+  url:""
+};