@trackunit/iris-app-e2e 1.8.93 → 1.9.1

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## 1.9.1 (2026-04-08)
+
+### 🧱 Updated Dependencies
+
+- Updated react-test-setup to 1.8.88
+
+## 1.9.0 (2026-04-08)
+
+### 🚀 Features
+
+- add Cypress type references and update TypeScript module resolution ([#22626](https://github.com/Trackunit/manager/pull/22626))
+
+### ❤️ Thank You
+
+- Brian Christensen @bchTrackunit
+
 ## 1.8.93 (2026-04-08)
 
 ### 🧱 Updated Dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app-e2e",
-  "version": "1.8.93",
+  "version": "1.9.1",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "generators": "./generators.json",
@@ -20,8 +20,21 @@
       "require": "./src/support.js",
       "import": "./src/support.js"
     },
+    "./cypress": {
+      "types": "./src/types/cypress.d.ts"
+    },
     "./package.json": "./package.json"
   },
+  "typesVersions": {
+    "*": {
+      "support": [
+        "./src/support.d.ts"
+      ],
+      "cypress": [
+        "./src/types/cypress.d.ts"
+      ]
+    }
+  },
   "dependencies": {
     "@neuralegion/cypress-har-generator": "^5.17.0",
     "@nx/cypress": "22.4.4",

package/src/generators/e2e-configuration/schema.d.ts

@@ -0,0 +1,3 @@
+export interface E2eConfigurationGeneratorSchema {
+  project: string;
+}

package/src/support.d.ts

@@ -6,3 +6,42 @@
 export * from "./commands/defaultCommands";
 export * from "./setup/defaultE2ESetup";
 export * from "./setup/setupHarRecording";
+/**
+ * Cypress namespace augmentation for custom commands.
+ * These types are automatically available when importing from this module.
+ *
+ * Note: Type parameter names must match Cypress's interface definitions.
+ * eslint-disable is required because Cypress uses `Subject` which doesn't match our naming convention.
+ */
+declare global {
+    namespace Cypress {
+        interface IframeOptions extends Loggable, Timeoutable {
+            url?: string | RegExp;
+            testId?: string;
+        }
+        interface IframeHandler<Subject> {
+            (selector: string, options?: Partial<IframeOptions>): Chainable<Subject>;
+            (options?: Partial<IframeOptions>): Chainable<Subject>;
+        }
+        interface Chainable<Subject> {
+            enterIrisApp: IframeHandler<() => Chainable<JQuery<HTMLBodyElement>>>;
+            enterStorybookPreview: IframeHandler<() => Chainable<JQuery<HTMLBodyElement>>>;
+            /**
+             * Custom command to select DOM element by data-testid attribute.
+             *
+             * @example cy.getByTestId('sidebar')
+             */
+            getByTestId(value: string, options?: Partial<Loggable & Timeoutable>): Chainable<Subject>;
+            /**
+             * Logs in as the user defined in auth.json (public version - auth fixture only)
+             * Can be passed an optional fixture type
+             *
+             * @example cy.login('auth')
+             */
+            login(fixture?: "auth"): Chainable<Subject>;
+            switchToLocalDevMode(): Chainable<Subject>;
+            getValidateFeatureFlags(): Chainable<Subject>;
+            configCat(flag: string): Chainable<boolean>;
+        }
+    }
+}

package/src/support.js

@@ -1,5 +1,6 @@
 "use strict";
-/// <reference path="./types/cypress.d.ts" />
+/// <reference types="cypress" />
+/// <reference types="@testing-library/cypress" />
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 /**
@@ -10,4 +11,5 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./commands/defaultCommands"), exports);
 tslib_1.__exportStar(require("./setup/defaultE2ESetup"), exports);
 tslib_1.__exportStar(require("./setup/setupHarRecording"), exports);
+/* eslint-enable @typescript-eslint/naming-convention */
 //# sourceMappingURL=support.js.map

package/src/types/cypress.d.ts

@@ -0,0 +1,41 @@
+/* eslint-disable @typescript-eslint/naming-convention */
+// load type definitions that come with Cypress module
+/// <reference types="cypress" />
+/// <reference types="@testing-library/cypress" />
+
+declare namespace Cypress {
+  interface IframeOptions extends Loggable, Timeoutable {
+    url?: string | RegExp;
+    testId?: string;
+  }
+
+  interface IframeHandler<Subject> {
+    (selector: string, options?: Partial<IframeOptions>): Chainable<Subject>;
+    (options?: Partial<IframeOptions>): Chainable<Subject>;
+  }
+
+  interface Chainable<Subject> {
+    enterIrisApp: IframeHandler<() => Chainable<JQuery<HTMLBodyElement>>>;
+    enterStorybookPreview: IframeHandler<() => Chainable<JQuery<HTMLBodyElement>>>;
+
+    /**
+     * Custom command to select DOM element by data-testid attribute.
+     *
+     * @example cy.getByTestId('sidebar')
+     */
+    getByTestId(value: string, options?: Partial<Loggable & Timeoutable>): Chainable<Subject>;
+
+    /**
+     * Logs in as the user defined in auth.json (public version - auth fixture only)
+     * Can be passed an optional fixture type
+     *
+     * @example cy.login('auth')
+     */
+    login(fixture?: "auth"): Chainable<Subject>;
+
+    switchToLocalDevMode(): Chainable<Subject>;
+
+    getValidateFeatureFlags(): Chainable<Subject>;
+    configCat(flag: string): Chainable<boolean>;
+  }
+}