@trackunit/iris-app-e2e 1.8.89 → 1.8.91

package/generators.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "name": "iris-app-e2e",
+  "version": "1.0.3",
+  "generators": {
+    "e2e-configuration": {
+      "factory": "./src/generators/e2e-configuration/generator#e2eConfigurationGenerator",
+      "schema": "./src/generators/e2e-configuration/schema.json",
+      "description": "e2e configuration setup for Iris app projects"
+    }
+  }
+}

package/package.json

@@ -1,12 +1,27 @@
 {
   "name": "@trackunit/iris-app-e2e",
-  "version": "1.8.89",
+  "version": "1.8.91",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "generators": "./generators.json",
   "engines": {
     "node": ">=24.x"
   },
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "require": "./src/index.js",
+      "import": "./src/index.js"
+    },
+    "./support": {
+      "types": "./src/support.d.ts",
+      "require": "./src/support.js",
+      "import": "./src/support.js"
+    },
+    "./package.json": "./package.json"
+  },
   "dependencies": {
     "@neuralegion/cypress-har-generator": "^5.17.0",
     "@nx/cypress": "22.4.4",
@@ -14,18 +29,8 @@
     "@nx/vite": "22.4.4",
     "cypress-terminal-report": "7.0.3",
     "node-xlsx": "^0.23.0",
-    "prettier": "^3.4.2"
-  },
-  "exports": {
-    "./package.json": "./package.json",
-    ".": {
-      "module": "./index.esm.js",
-      "types": "./index.d.ts",
-      "import": "./index.cjs.mjs",
-      "default": "./index.cjs.js"
-    }
+    "prettier": "^3.4.2",
+    "tslib": "^2.6.2"
   },
-  "module": "./index.esm.js",
-  "main": "./index.cjs.js",
-  "types": "./index.d.ts"
+  "type": "commonjs"
 }

package/src/commands/defaultCommands.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupDefaultCommands = setupDefaultCommands;
+/**
+ * Sets up default Cypress commands for E2E testing.
+ * Adds custom commands like getByTestId, login, enterIrisApp, etc.
+ */
+function setupDefaultCommands() {
+    Cypress.Commands.add("getByTestId", {
+        prevSubject: ["optional"],
+    }, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (subject, testId, options = {}) => {
+        const selector = `[data-testid="${testId}"]`;
+        const timeout = options.timeout ?? 15000;
+        if (subject) {
+            if (Cypress.dom.isElement(subject) || Cypress.dom.isJquery(subject)) {
+                return cy.wrap(subject, { timeout }).find(selector, { timeout });
+            }
+            else if (Cypress.dom.isWindow(subject)) {
+                return cy.get(selector, { timeout });
+            }
+            else if (Array.isArray(subject)) {
+                const element = subject.map(el => cy.wrap(el, { timeout }).find(selector, { timeout }));
+                if (element[0]) {
+                    return element[0];
+                }
+                return cy.wrap(null);
+            }
+            return cy.get(selector, { timeout });
+        }
+        else {
+            return cy.get(selector, { timeout });
+        }
+    });
+    Cypress.Commands.add("login", fixture => {
+        const envUrl = `${Cypress.config().baseUrl}/env`;
+        cy.log(`Getting env from: ${envUrl}`);
+        cy.request({
+            method: "GET",
+            url: envUrl,
+            headers: {
+                "Content-Type": "application/json",
+            },
+        }).then(envResponse => {
+            const env = envResponse.body;
+            const domain = env.auth?.url;
+            if (!(Boolean(domain))) {
+                throw new Error(`No domain found from servers /env found env: ${JSON.stringify(env)}`);
+            }
+            cy.log(`Using: ${domain}`);
+            cy.clearCookies();
+            cy.fixture(fixture ?? "auth").then(({ username, password }) => {
+                const options = {
+                    warnBeforePasswordExpired: true,
+                    multiOptionalFactorEnroll: false,
+                };
+                cy.request({
+                    method: "POST",
+                    url: `${domain}/api/v1/authn`,
+                    headers: {
+                        "Content-Type": "application/json",
+                    },
+                    body: {
+                        username,
+                        password,
+                        options,
+                    },
+                })
+                    .then(response => {
+                    if (response.isOkStatusCode) {
+                        const sessionToken = response.body.sessionToken;
+                        return cy.visit(`/auth/manager-classic#session_token=${sessionToken}&fleetHome=true`);
+                    }
+                    else {
+                        throw new Error(`Could not get a session token for user: ${username}, ${JSON.stringify(response)}`);
+                    }
+                })
+                    .then(() => cy.url({ timeout: 20000 }).should("not.include", "manager-classic")) // Wait for redirect away from manager-classic
+                    .url()
+                    .should("contain", `${Cypress.config().baseUrl}`);
+                cy.get("#host-layout-content", { timeout: 15000 }).should("be.visible"); // Wait for host layout to be visible
+            });
+        });
+    });
+    Cypress.Commands.add("switchToLocalDevMode", () => {
+        cy.getByTestId("developerPortalNav").click();
+        cy.url({ timeout: 15000, log: true }).should("contain", "/iris-sdk-portal");
+        //eslint-disable-next-line @typescript-eslint/no-explicit-any
+        cy.getByTestId("localDevModeSwitch-input").then(($ele) => {
+            if ($ele && !$ele.is(":checked")) {
+                cy.getByTestId("localDevModeSwitch-thumb").click();
+            }
+        });
+    });
+    Cypress.Commands.add("enterIrisApp", options => {
+        return cy
+            .get(`iframe[data-testid="${options?.testId ?? "app-iframe"}"]`, { timeout: 30000 })
+            .first()
+            .its("0.contentDocument.body", { timeout: 30000, log: true })
+            .should("not.be.empty")
+            .then($body => {
+            return () => cy.wrap($body);
+        });
+    });
+    Cypress.Commands.add("enterStorybookPreview", options => {
+        return cy
+            .get(`iframe[id="${options?.testId ?? "storybook-preview-iframe"}"]`, { timeout: 30000 })
+            .first()
+            .its("0.contentDocument.body", { timeout: 30000, log: true })
+            .should("not.be.empty")
+            .then($body => {
+            return () => cy.wrap($body);
+        });
+    });
+    Cypress.Commands.add("getValidateFeatureFlags", () => {
+        cy.intercept({ url: "**/ValidateFeatureFlags" }).as("ValidateFeatureFlags");
+        cy.intercept({ url: "**/UserPermissions" }).as("UserPermissions");
+        cy.intercept({ url: "**/ActiveSubscription" }).as("ActiveSubscription");
+    });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let ccData = null;
+    Cypress.Commands.add("configCat", value => {
+        if (!ccData) {
+            cy.wait("@ValidateFeatureFlags").then(intercept => {
+                ccData = intercept.response?.body?.data?.featureFlags;
+                return ccData?.find((ff) => ff.key === value).state;
+            });
+        }
+        else {
+            return ccData?.find((ff) => ff.key === value).state;
+        }
+    });
+}
+//# sourceMappingURL=defaultCommands.js.map

package/src/commands/defaultCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultCommands.js","sourceRoot":"","sources":["../../../../../../libs/iris-app-sdk/iris-app-e2e/src/commands/defaultCommands.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Sets up default Cypress commands for E2E testing.\n * Adds custom commands like getByTestId, login, enterIrisApp, etc.\n */\nexport function setupDefaultCommands() {\n  Cypress.Commands.add(\n    \"getByTestId\",\n    {\n      prevSubject: [\"optional\"],\n    },\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (subject: any, testId: string, options: { timeout?: number } = {}) => {\n      const selector = `[data-testid=\"${testId}\"]`;\n      const timeout = options.timeout ?? 15000;\n\n      if (subject) {\n        if (Cypress.dom.isElement(subject) || Cypress.dom.isJquery(subject)) {\n          return cy.wrap(subject, { timeout }).find(selector, { timeout });\n        } else if (Cypress.dom.isWindow(subject)) {\n          return cy.get(selector, { timeout });\n        } else if (Array.isArray(subject)) {\n          const element = subject.map(el => cy.wrap(el, { timeout }).find(selector, { timeout }));\n          if (element[0]) {\n            return element[0];\n          }\n          return cy.wrap(null);\n        }\n        return cy.get(selector, { timeout });\n      } else {\n        return cy.get(selector, { timeout });\n      }\n    }\n  );\n\n  Cypress.Commands.add(\"login\", fixture => {\n    const envUrl = `${Cypress.config().baseUrl}/env`;\n    cy.log(`Getting env from: ${envUrl}`);\n    cy.request({\n      method: \"GET\",\n      url: envUrl,\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n    }).then(envResponse => {\n      const env = envResponse.body;\n      const domain = env.auth?.url;\n      if (!(Boolean(domain))) {\n        throw new Error(`No domain found from servers /env found env: ${JSON.stringify(env)}`);\n      }\n      cy.log(`Using: ${domain}`);\n      cy.clearCookies();\n      cy.fixture(fixture ?? \"auth\").then(({ username, password }) => {\n        const options = {\n          warnBeforePasswordExpired: true,\n          multiOptionalFactorEnroll: false,\n        };\n\n        cy.request({\n          method: \"POST\",\n          url: `${domain}/api/v1/authn`,\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n          body: {\n            username,\n            password,\n            options,\n          },\n        })\n          .then(response => {\n            if (response.isOkStatusCode) {\n              const sessionToken = response.body.sessionToken;\n\n              return cy.visit(`/auth/manager-classic#session_token=${sessionToken}&fleetHome=true`);\n            } else {\n              throw new Error(`Could not get a session token for user: ${username}, ${JSON.stringify(response)}`);\n            }\n          })\n          .then(() => cy.url({ timeout: 20000 }).should(\"not.include\", \"manager-classic\")) // Wait for redirect away from manager-classic\n          .url()\n          .should(\"contain\", `${Cypress.config().baseUrl}`);\n        cy.get(\"#host-layout-content\", { timeout: 15000 }).should(\"be.visible\"); // Wait for host layout to be visible\n      });\n    });\n  });\n\n  Cypress.Commands.add(\"switchToLocalDevMode\", () => {\n    cy.getByTestId(\"developerPortalNav\").click();\n    cy.url({ timeout: 15000, log: true }).should(\"contain\", \"/iris-sdk-portal\");\n\n    //eslint-disable-next-line @typescript-eslint/no-explicit-any\n    cy.getByTestId(\"localDevModeSwitch-input\").then(($ele: any) => {\n      if ($ele && !$ele.is(\":checked\")) {\n        cy.getByTestId(\"localDevModeSwitch-thumb\").click();\n      }\n    });\n  });\n\n  Cypress.Commands.add(\"enterIrisApp\", options => {\n    return cy\n      .get(`iframe[data-testid=\"${options?.testId ?? \"app-iframe\"}\"]`, { timeout: 30000 })\n      .first()\n      .its(\"0.contentDocument.body\", { timeout: 30000, log: true })\n      .should(\"not.be.empty\")\n      .then($body => {\n        return () => cy.wrap($body);\n      });\n  });\n\n  Cypress.Commands.add(\"enterStorybookPreview\", options => {\n    return cy\n      .get(`iframe[id=\"${options?.testId ?? \"storybook-preview-iframe\"}\"]`, { timeout: 30000 })\n      .first()\n      .its(\"0.contentDocument.body\", { timeout: 30000, log: true })\n      .should(\"not.be.empty\")\n      .then($body => {\n        return () => cy.wrap($body);\n      });\n  });\n\n  Cypress.Commands.add(\"getValidateFeatureFlags\", () => {\n    cy.intercept({ url: \"**/ValidateFeatureFlags\" }).as(\"ValidateFeatureFlags\");\n    cy.intercept({ url: \"**/UserPermissions\" }).as(\"UserPermissions\");\n    cy.intercept({ url: \"**/ActiveSubscription\" }).as(\"ActiveSubscription\");\n  });\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let ccData: any = null;\n  Cypress.Commands.add(\"configCat\", value => {\n    if (!ccData) {\n      cy.wait(\"@ValidateFeatureFlags\").then(intercept => {\n        ccData = intercept.response?.body?.data?.featureFlags;\n        return ccData?.find((ff: { key: string }) => ff.key === value).state;\n      });\n    } else {\n      return ccData?.find((ff: { key: string }) => ff.key === value).state;\n    }\n  });\n}\n"]}

package/src/generators/e2e-configuration/README.md

@@ -0,0 +1,79 @@
+
+# E2E Configuration Generator
+
+This generator sets up Cypress E2E test configuration within an existing project
+using the Iris App E2E library, rather than creating a separate E2E app.
+
+## Usage
+
+You can run the generator with or without explicitly specifying a project name.
+
+### 1. With the project name
+
+Use this option to directly target a specific project for the E2E setup.
+
+```bash
+nx generate @trackunit/iris-app-e2e:e2e-configuration --project <PROJECT_NAME>
+```
+
+### 2. Without the project name
+
+This option presents a list of available projects to select from.
+
+```bash
+nx generate @trackunit/iris-app-e2e:e2e-configuration
+```
+
+## What it generates
+
+- **cypress.config.ts** - Main Cypress configuration using Iris App E2E library
+- **cypress/e2e/app.cy.ts** - Sample test file with basic structure
+- **cypress/support/commands.ts** - Custom commands setup using public API
+- **cypress/support/e2e.ts** - Support file configuration
+- **cypress/fixtures/auth.json** - Authentication fixture template
+- **Project targets** for e2e and e2e-ui execution with multiple environment configurations
+
+## Prerequisites
+
+- The target application needs to be deployed and accessible for tests to run successfully
+- Authentication credentials must be configured in the `cypress/fixtures/auth.json` file
+
+## Test User Considerations
+
+When setting up E2E tests, consider the following for test user management:
+
+### Authentication Setup
+
+- Configure test user credentials in `cypress/fixtures/auth.json`
+- Use dedicated test accounts separate from production users
+- Ensure test users have appropriate permissions for the features being tested
+
+### User Context Planning
+
+- **Basic Access**: Use standard user accounts for general functionality testing
+- **Administrative Access**: Use admin-level accounts when testing administrative features
+- **Role-based Testing**: Consider different user roles if your application has role-based access control
+- **Environment Considerations**: Test users and permissions may vary across different environments (dev, staging, production)
+
+### Security Best Practices
+
+- Regularly rotate test user passwords
+- Ensure test users have minimal necessary permissions
+
+## Running Tests
+
+After generation, you can run your E2E tests using:
+
+```bash
+# Run tests in headless mode
+nx run <project-name>:e2e
+
+# Run tests with UI for development
+nx run <project-name>:e2e-ui
+
+# Run against different environments
+nx run <project-name>:e2e --configuration=local
+nx run <project-name>:e2e --configuration=dev
+nx run <project-name>:e2e --configuration=stage
+nx run <project-name>:e2e --configuration=prod
+```

package/src/generators/e2e-configuration/files/root/cypress/e2e/app.cy.ts__tmpl__

@@ -0,0 +1,18 @@
+describe("Sample E2E Test", () => {
+  beforeEach(() => {
+    // NEVER do anything in before or after as they are never timed out and retries will never happen
+  });
+
+  it("Can log in and navigate to app", () => {
+    cy.login("auth");
+    
+    // Example: Test your application here
+    // cy.getByTestId("your-app-element").should("be.visible");
+    
+    // Example: Test Iris app integration
+    // cy.enterIrisApp().then(irisApp => {
+    //   irisApp().find(".your-selector").should("contain.text", "Expected Text");
+    //   irisApp().getByTestId("your-test-id").should("exist");
+    // });
+  });
+});

package/src/generators/e2e-configuration/files/root/cypress/fixtures/auth.json__tmpl__

@@ -0,0 +1,4 @@
+{
+  "username": "your-test-user@example.com",
+  "password": "your-test-password"
+}

package/src/generators/e2e-configuration/files/root/cypress/support/commands.ts__tmpl__

@@ -0,0 +1,3 @@
+import { setupDefaultCommands } from "@trackunit/iris-app-e2e/support";
+import "@testing-library/cypress/add-commands";
+setupDefaultCommands();

package/src/generators/e2e-configuration/files/root/cypress/support/e2e.ts__tmpl__

@@ -0,0 +1,18 @@
+// ***********************************************************
+// This example support/e2e.ts is processed and
+// loaded automatically before your test files.
+//
+// This is a great place to put global configuration and
+// behavior that modifies Cypress.
+//
+// You can change the location of this file or turn off
+// automatically serving support files with the
+// 'supportFile' configuration option.
+//
+// You can read more here:
+// https://on.cypress.io/configuration
+// ***********************************************************
+
+import { setupE2E } from "@trackunit/iris-app-e2e/support";
+import "./commands";
+setupE2E();

package/src/generators/e2e-configuration/files/root/cypress/tsconfig.json__tmpl__

@@ -0,0 +1,17 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "types": ["cypress", "node", "@testing-library/cypress"],
+    "sourceMap": false
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.js",
+    "../cypress.config.ts",
+    "./**/*.cy.ts",
+    "./**/*.cy.tsx",
+    "./**/*.cy.js",
+    "./**/*.cy.jsx",
+    "./**/*.d.ts"
+  ]
+}

package/src/generators/e2e-configuration/files/root/cypress.config.ts__tmpl__

@@ -0,0 +1,25 @@
+import { install as installHarGenerator } from "@neuralegion/cypress-har-generator";
+import { createNxPreset, CypressPluginConfig, defaultCypressConfig, setupPlugins } from "@trackunit/iris-app-e2e";
+import { defineConfig } from "cypress";
+import { format, resolveConfig } from "prettier";
+
+const nxPreset = createNxPreset(__filename);
+
+const cypressJsonConfig: Partial<CypressPluginConfig> = {
+  ...defaultCypressConfig(__dirname),
+  fixturesFolder: "./cypress/fixtures",
+  supportFile: "cypress/support/e2e.ts",
+  specPattern: "cypress/e2e/**/*.cy.ts",
+};
+export default defineConfig({
+  chromeWebSecurity: false,
+  e2e: {
+    ...nxPreset,
+    ...cypressJsonConfig,
+    async setupNodeEvents(on, config: CypressPluginConfig) {
+      await nxPreset.setupNodeEvents?.(on, config);
+      const formatter = { format, resolveConfig };
+      return setupPlugins(on, config, formatter, installHarGenerator);
+    },
+  },
+});

package/src/generators/e2e-configuration/generator.js

@@ -0,0 +1,238 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.e2eConfigurationGenerator = e2eConfigurationGenerator;
+const tslib_1 = require("tslib");
+const configuration_1 = tslib_1.__importDefault(require("@nx/cypress/src/generators/configuration/configuration"));
+const devkit_1 = require("@nx/devkit");
+const fileUpdater_1 = require("../../utils/fileUpdater");
+/**
+ * Generates E2E test configuration for an existing project using Iris App E2E library.
+ *
+ * This generator sets up Cypress end-to-end testing infrastructure within an existing project,
+ * including configuration files, test targets, and template files that use the public
+ * iris-app-e2e library for cross-platform compatibility.
+ *
+ * @param tree - The NX virtual file system tree
+ * @param options - Configuration options for the generator
+ * @param options.project - The name of the project to add E2E configuration to
+ * @returns {Function} A function that logs completion message with the path to the generated test file
+ * @example
+ * ```bash
+ * nx generate @trackunit/iris-app-e2e:e2e-configuration --project my-app
+ * ```
+ *
+ * Generated structure:
+ * - cypress.config.ts - Main Cypress configuration using Iris App E2E
+ * - cypress/e2e/app.cy.ts - Sample test file
+ * - cypress/support/commands.ts - Custom commands setup
+ * - cypress/support/e2e.ts - Support file configuration
+ * - cypress/fixtures/auth.json - Authentication fixture template
+ * - Project targets for e2e and e2e-ui execution with multiple environment configurations
+ */
+async function e2eConfigurationGenerator(tree, options) {
+    const libName = options.project.replace(new RegExp("/", "g"), "-");
+    const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, libName);
+    const projectRoot = projectConfig.root; // Get the actual root of the library
+    const optionsWithDefaults = {
+        linter: "none",
+        project: options.project,
+        bundler: "vite",
+        directory: "cypress",
+        baseUrl: "https://dev.manager.trackunit.com",
+    };
+    // reading project.json content
+    const existingProjectConfig = (0, devkit_1.readProjectConfiguration)(tree, options.project);
+    // generate the cypress configuration files
+    await (0, configuration_1.default)(tree, optionsWithDefaults);
+    //adding cypress target to project.json
+    (0, devkit_1.updateProjectConfiguration)(tree, options.project, {
+        ...existingProjectConfig,
+        targets: {
+            ...existingProjectConfig.targets,
+            "e2e-ui": {
+                executor: "@nx/cypress:cypress",
+                options: {
+                    cypressConfig: `${projectRoot}/cypress.config.ts`,
+                    baseUrl: "https://dev.manager.trackunit.com",
+                    headed: true,
+                    watch: true,
+                    testingType: "e2e",
+                },
+                configurations: {
+                    local: {
+                        baseUrl: "http://localhost:3000",
+                    },
+                    dev: {
+                        baseUrl: "https://dev.manager.trackunit.com",
+                    },
+                    stage: {
+                        baseUrl: "https://stage.manager.trackunit.com",
+                    },
+                    prod: {
+                        baseUrl: "https://new.manager.trackunit.com",
+                    },
+                },
+            },
+            e2e: {
+                executor: "@nx/cypress:cypress",
+                options: {
+                    cypressConfig: `${projectRoot}/cypress.config.ts`,
+                    browser: "chrome",
+                    testingType: "e2e",
+                },
+                configurations: {
+                    local: {
+                        baseUrl: "http://localhost:3000",
+                    },
+                    dev: {
+                        baseUrl: "https://dev.manager.trackunit.com",
+                    },
+                    stage: {
+                        baseUrl: "https://stage.manager.trackunit.com",
+                    },
+                    prod: {
+                        baseUrl: "https://new.manager.trackunit.com",
+                    },
+                    "feature-branch": {},
+                },
+            },
+        },
+    });
+    // overwrite the generated files with the custom files
+    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, "files/root"), projectRoot, {
+        ...options,
+        directory: "",
+        tmpl: "",
+    });
+    // Check if we're in the manager-side monorepo (has eslint-e2e.config.cjs at root)
+    const isInternalWorkspace = tree.exists("eslint-e2e.config.cjs");
+    const workspaceEslintConfigCjsPath = "eslint.config.cjs";
+    const workspaceEslintConfigMjsPath = "eslint.config.mjs";
+    const eslintConfigCjsPath = (0, devkit_1.joinPathFragments)(projectConfig.root, "eslint.config.cjs");
+    const eslintConfigMjsPath = (0, devkit_1.joinPathFragments)(projectConfig.root, "eslint.config.mjs");
+    if (isInternalWorkspace) {
+        // Manager-side monorepo: update existing eslint.config.cjs
+        (0, fileUpdater_1.updateFileInTree)(tree, eslintConfigCjsPath, _ => {
+            const hasPublishNpmTag = projectConfig.tags?.includes("publish:npm") ?? false;
+            const publicRulesImport = hasPublishNpmTag
+                ? `\nconst publicConfig = require("${(0, devkit_1.offsetFromRoot)(projectRoot)}eslint-public.config.cjs");`
+                : "";
+            const publicRulesSpread = hasPublishNpmTag ? ", ...publicConfig" : "";
+            return `const clientConfig = require("${(0, devkit_1.offsetFromRoot)(projectRoot)}eslint-client.config.cjs");
+const e2eConfig = require("${(0, devkit_1.offsetFromRoot)(projectRoot)}eslint-e2e.config.cjs");
+const { defineConfig } = require("eslint/config");${publicRulesImport}
+module.exports = defineConfig([...clientConfig, ...e2eConfig${publicRulesSpread}]);
+`;
+        });
+    }
+    else {
+        // External workspace: extend existing config or create minimal config with Cypress support
+        // Check for both .mjs and .cjs ESLint config files
+        const workspaceMjsContent = tree.exists(workspaceEslintConfigMjsPath)
+            ? tree.read(workspaceEslintConfigMjsPath, "utf-8") || ""
+            : "";
+        const workspaceCjsContent = tree.exists(workspaceEslintConfigCjsPath)
+            ? tree.read(workspaceEslintConfigCjsPath, "utf-8") || ""
+            : "";
+        const existingMjsContent = tree.exists(eslintConfigMjsPath) ? tree.read(eslintConfigMjsPath, "utf-8") || "" : "";
+        const existingCjsContent = tree.exists(eslintConfigCjsPath) ? tree.read(eslintConfigCjsPath, "utf-8") || "" : "";
+        const cypressConfigBlock = `{
+    files: ["cypress/**/*.ts", "cypress/**/*.js"],
+    languageOptions: {
+      globals: {
+        cy: "readonly",
+        Cypress: "readonly",
+        describe: "readonly",
+        it: "readonly",
+        beforeEach: "readonly",
+        afterEach: "readonly",
+        before: "readonly",
+        after: "readonly",
+        expect: "readonly",
+      },
+    },
+    rules: {
+      "@typescript-eslint/no-namespace": "off",
+    },
+  }`;
+        if (existingMjsContent && !existingMjsContent.includes("cypress")) {
+            // Update existing .mjs config to add Cypress support
+            // Find the export default array and add cypress config to it
+            const updatedContent = existingMjsContent.replace(/export\s+default\s+(\[[\s\S]*?)(];?\s*$)/m, (_, arrayContent, closing) => {
+                const trimmedContent = arrayContent.trimEnd();
+                const needsComma = trimmedContent.endsWith("}") || trimmedContent.endsWith(")");
+                return `export default ${trimmedContent}${needsComma ? "," : ""}\n  ${cypressConfigBlock}\n${closing}`;
+            });
+            tree.write(eslintConfigMjsPath, updatedContent);
+        }
+        else if (existingCjsContent && !existingCjsContent.includes("cypress")) {
+            // Update existing .cjs config to add Cypress support
+            const eslintContent = `const baseConfig = require("./eslint.config.base.cjs");
+
+module.exports = [
+  ...(Array.isArray(baseConfig) ? baseConfig : [baseConfig]),
+  ${cypressConfigBlock},
+];
+`;
+            // Backup the original config
+            tree.write((0, devkit_1.joinPathFragments)(projectConfig.root, "eslint.config.base.cjs"), existingCjsContent);
+            tree.write(eslintConfigCjsPath, eslintContent);
+        }
+        else if (!existingMjsContent && !existingCjsContent) {
+            // No project-level config - compose with the workspace base config when available.
+            if (workspaceCjsContent) {
+                const eslintContent = `const { defineConfig } = require("eslint/config");
+const baseConfig = require("${(0, devkit_1.offsetFromRoot)(projectRoot)}eslint.config.cjs");
+
+module.exports = defineConfig([
+  ...(Array.isArray(baseConfig) ? baseConfig : [baseConfig]),
+  ${cypressConfigBlock},
+]);
+`;
+                tree.write(eslintConfigCjsPath, eslintContent);
+            }
+            else if (workspaceMjsContent) {
+                const eslintContent = `import baseConfig from "${(0, devkit_1.offsetFromRoot)(projectRoot)}eslint.config.mjs";
+
+export default [
+  ...(Array.isArray(baseConfig) ? baseConfig : [baseConfig]),
+  ${cypressConfigBlock},
+];
+`;
+                tree.write(eslintConfigMjsPath, eslintContent);
+            }
+            else {
+                // Final fallback for workspaces without any ESLint setup: bootstrap the same Nx React flat
+                // config shape our app generators start from, then layer Cypress overrides on top.
+                const eslintContent = `const nx = require("@nx/eslint-plugin");
+const { defineConfig } = require("eslint/config");
+
+module.exports = defineConfig([
+  ...nx.configs["flat/react"],
+  {
+    files: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"],
+    languageOptions: {
+      parserOptions: { project: ["./tsconfig.*?.json"] },
+    },
+    rules: {},
+  },
+  {
+    ignores: ["node_modules/**", "dist/**"],
+  },
+  ${cypressConfigBlock},
+]);
+`;
+                tree.write(eslintConfigCjsPath, eslintContent);
+            }
+        }
+        // If eslintConfig already includes cypress, don't modify it
+    }
+    (0, fileUpdater_1.deleteFileInTree)(tree, (0, devkit_1.joinPathFragments)(projectConfig.root, "cypress/support/app.po.ts"));
+    await (0, devkit_1.formatFiles)(tree);
+    return () => {
+        // eslint-disable-next-line no-console
+        console.log("\n\n\n✅ 🚀 Please open this file to get started\n", (0, devkit_1.joinPathFragments)(projectConfig.root, "cypress/e2e/app.cy.ts"));
+        return tree;
+    };
+}
+//# sourceMappingURL=generator.js.map