@rbaileysr/zephyr-managed-api 1.4.2 → 1.4.3

package/README.md

@@ -279,6 +279,10 @@ Feel free to drop ideas, suggestions or improvements into our [Community hub](ht
 
 ## Changelog
 
+### 1.4.3
+
+- **Fixed**: `createTestExecutionWithVersion()` now automatically adds the test case to the test cycle if it's not already present (matching public API behavior). This ensures executions can be created for older test case versions even if they weren't previously added to the cycle. The function now properly handles the complete workflow: adding the test case to the cycle (if needed) before creating the execution.
+
 ### 1.4.2
 
 - **Added**: Delete comment methods - `deleteTestCaseComment()`, `deleteTestCycleComment()`, `deleteTestPlanComment()`. All support version-specific operations for test cases.
@@ -292,6 +296,7 @@ Feel free to drop ideas, suggestions or improvements into our [Community hub](ht
 - **Added**: `AI_AGENT_GUIDE.md` - Comprehensive guide for AI coding agents covering all API functions, capabilities, limitations, and best practices. This file is included in the NPM package and visible on the NPM website.
 - **Changed**: All test case-related private API methods that accept a test case key now support an optional `version` parameter. When a version is specified, the method automatically resolves the test case ID for that specific version.
 
+
 ### 1.4.1
 
 - **Added**: `listAllTestExecutionsForTestCase()` - List all test executions for a test case across all versions. Unlike the public API which only returns executions for the latest version, this method returns executions from all test case versions. Returns minimal data (key and testCase info) - use the public API to get full execution details if needed.

package/dist/README.md

@@ -279,6 +279,10 @@ Feel free to drop ideas, suggestions or improvements into our [Community hub](ht
 
 ## Changelog
 
+### 1.4.3
+
+- **Fixed**: `createTestExecutionWithVersion()` now automatically adds the test case to the test cycle if it's not already present (matching public API behavior). This ensures executions can be created for older test case versions even if they weren't previously added to the cycle. The function now properly handles the complete workflow: adding the test case to the cycle (if needed) before creating the execution.
+
 ### 1.4.2
 
 - **Added**: Delete comment methods - `deleteTestCaseComment()`, `deleteTestCycleComment()`, `deleteTestPlanComment()`. All support version-specific operations for test cases.
@@ -292,6 +296,7 @@ Feel free to drop ideas, suggestions or improvements into our [Community hub](ht
 - **Added**: `AI_AGENT_GUIDE.md` - Comprehensive guide for AI coding agents covering all API functions, capabilities, limitations, and best practices. This file is included in the NPM package and visible on the NPM website.
 - **Changed**: All test case-related private API methods that accept a test case key now support an optional `version` parameter. When a version is specified, the method automatically resolves the test case ID for that specific version.
 
+
 ### 1.4.1
 
 - **Added**: `listAllTestExecutionsForTestCase()` - List all test executions for a test case across all versions. Unlike the public API which only returns executions for the latest version, this method returns executions from all test case versions. Returns minimal data (key and testCase info) - use the public API to get full execution details if needed.

package/dist/groups/Private/PrivateTestExecutions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PrivateTestExecutions.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateTestExecutions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,sCAAsC,EACtC,uCAAuC,EACvC,qCAAqC,EACrC,sCAAsC,EACtC,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,oCAAoC,EACpC,qCAAqC,EACrC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA0D5C,qBAAa,qBAAsB,SAAQ,WAAW;IACrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,+BAA+B,CACpC,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,sCAAsC,GAC7C,OAAO,CAAC,uCAAuC,CAAC;IAgInD;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,iBAAiB,CACtB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,yBAAyB,CAAC;IAgErC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,mBAAmB,CACxB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,IAAI,CAAC;IAuFhB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,qBAAqB,CAC1B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,6BAA6B,CAAC;IA6EzC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,6BAA6B,CAClC,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,oCAAoC,GAC3C,OAAO,CAAC,IAAI,CAAC;IA2DhB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,8BAA8B,CACnC,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,qCAAqC,GAC5C,OAAO,CAAC,IAAI,CAAC;IA0DhB;;OAEG;YACW,aAAa;IA0B3B;;OAEG;YACW,uBAAuB;IA6BrC;;OAEG;YACW,cAAc;IA0B5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACG,8BAA8B,CACnC,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,qCAAqC,GAC5C,OAAO,CAAC,sCAAsC,CAAC;IAsGlD;;OAEG;YACW,gBAAgB;CA0B9B"}
+{"version":3,"file":"PrivateTestExecutions.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateTestExecutions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,sCAAsC,EACtC,uCAAuC,EACvC,qCAAqC,EACrC,sCAAsC,EACtC,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,oCAAoC,EACpC,qCAAqC,EACrC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA0D5C,qBAAa,qBAAsB,SAAQ,WAAW;IACrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,+BAA+B,CACpC,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,sCAAsC,GAC7C,OAAO,CAAC,uCAAuC,CAAC;IAgInD;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,iBAAiB,CACtB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,yBAAyB,CAAC;IAgErC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,mBAAmB,CACxB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,IAAI,CAAC;IAuFhB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,qBAAqB,CAC1B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,6BAA6B,CAAC;IA6EzC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,6BAA6B,CAClC,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,oCAAoC,GAC3C,OAAO,CAAC,IAAI,CAAC;IA2DhB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,8BAA8B,CACnC,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,qCAAqC,GAC5C,OAAO,CAAC,IAAI,CAAC;IA0DhB;;OAEG;YACW,aAAa;IA0B3B;;OAEG;YACW,uBAAuB;IA6BrC;;OAEG;YACW,cAAc;IA0B5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACG,8BAA8B,CACnC,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,qCAAqC,GAC5C,OAAO,CAAC,sCAAsC,CAAC;IA0NlD;;OAEG;YACW,gBAAgB;CA0B9B"}

package/dist/groups/Private/PrivateTestExecutions.js

@@ -655,12 +655,98 @@ export class PrivateTestExecutions extends PrivateBase {
         const testCaseId = await this.getTestCaseIdForVersion(request.body.testCaseKey, request.body.version);
         // Step 2: Get test cycle ID from key
         const testCycleId = await this.getTestCycleId(request.body.testCycleKey);
-        // Step 3: Get testRunItemId from private API
-        const testRunItemId = await this.getTestRunItemId(credentials, {
-            testCycleKey: request.body.testCycleKey,
-            testCaseId,
-            projectId: request.projectId,
-        });
+        // Step 3: Check if test case is already in the cycle, if not add it
+        let testRunItemId;
+        try {
+            testRunItemId = await this.getTestRunItemId(credentials, {
+                testCycleKey: request.body.testCycleKey,
+                testCaseId,
+                projectId: request.projectId,
+            });
+        }
+        catch (error) {
+            // If test case not found in cycle, add it first
+            if (error instanceof NotFoundError) {
+                // Get current cycle items to determine next index
+                const cycleItems = await this.getTestCycleItems(credentials, {
+                    testCycleKey: request.body.testCycleKey,
+                    projectId: request.projectId,
+                });
+                // Determine next index (highest index + 1, or 0 if no items)
+                const nextIndex = cycleItems.testRunItems.length > 0
+                    ? Math.max(...cycleItems.testRunItems.map((item) => item.index)) + 1
+                    : 0;
+                // Prepare assignedTo - use from request if provided, otherwise from body.assignedToId
+                let assignedTo = request.assignedTo;
+                if (!assignedTo && request.body.assignedToId) {
+                    // Note: assignedToId is an account ID, but assignedTo should be a user key
+                    // For now, we'll use the account ID as-is and let the API handle it
+                    assignedTo = request.body.assignedToId;
+                }
+                // Add test case to cycle using bulk save endpoint
+                const bulkSaveUrl = `${this.privateApiBaseUrl}/testrunitem/bulk/save`;
+                const bulkSaveHeaders = {
+                    'Content-Type': 'application/json',
+                    authorization: `JWT ${contextJwt}`,
+                    'jira-project-id': String(request.projectId),
+                };
+                const bulkSaveBody = {
+                    addedTestRunItems: [
+                        {
+                            index: nextIndex,
+                            lastTestResult: {
+                                testCaseId,
+                                ...(assignedTo && { assignedTo }),
+                                ...(request.iterationId && { iterationId: request.iterationId }),
+                                ...(request.jiraVersionId && {
+                                    jiraVersionId: typeof request.jiraVersionId === 'string'
+                                        ? request.jiraVersionId
+                                        : String(request.jiraVersionId),
+                                }),
+                            },
+                        },
+                    ],
+                    updatedTestRunItemsIndexes: cycleItems.testRunItems.map((item) => ({
+                        id: item.id,
+                        index: item.index,
+                    })),
+                    updatedTestRunItems: [],
+                    deletedTestRunItems: [],
+                    testRunId: testCycleId,
+                    autoReorder: false,
+                };
+                const bulkSaveResponse = await fetch(bulkSaveUrl, {
+                    method: 'PUT',
+                    headers: bulkSaveHeaders,
+                    body: JSON.stringify(bulkSaveBody),
+                });
+                if (!bulkSaveResponse.ok) {
+                    if (bulkSaveResponse.status === 400) {
+                        throw new BadRequestError('Invalid request parameters for adding test case to test cycle. Ensure test case version and cycle are valid.');
+                    }
+                    if (bulkSaveResponse.status === 401) {
+                        throw new UnauthorizedError('Failed to authenticate. Please check your credentials.');
+                    }
+                    if (bulkSaveResponse.status === 403) {
+                        throw new ForbiddenError('Insufficient permissions to add test case to test cycle.');
+                    }
+                    if (bulkSaveResponse.status === 404) {
+                        throw new NotFoundError(`Test case '${request.body.testCaseKey}' (version ${request.body.version}) or test cycle '${request.body.testCycleKey}' not found.`);
+                    }
+                    throw new ServerError(`Failed to add test case to test cycle. Status: ${bulkSaveResponse.status}`, bulkSaveResponse.status, bulkSaveResponse.statusText);
+                }
+                // Now get the testRunItemId
+                testRunItemId = await this.getTestRunItemId(credentials, {
+                    testCycleKey: request.body.testCycleKey,
+                    testCaseId,
+                    projectId: request.projectId,
+                });
+            }
+            else {
+                // Re-throw other errors
+                throw error;
+            }
+        }
         // Step 4: Create execution via private API
         const url = `${this.privateApiBaseUrl}/testresult`;
         const headers = {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rbaileysr/zephyr-managed-api",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "Managed API wrapper for Zephyr Cloud REST API v2 - Comprehensive type-safe access to all Zephyr API endpoints for ScriptRunner Connect",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rbaileysr/zephyr-managed-api",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "Managed API wrapper for Zephyr Cloud REST API v2 - Comprehensive type-safe access to all Zephyr API endpoints for ScriptRunner Connect",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",