@rbaileysr/zephyr-managed-api 1.3.7 → 1.3.8

package/README.md

@@ -155,9 +155,11 @@ const apiEU = createZephyrApi(
     - VersionControl
         - **Test Case (version-specific)**: `getTestCaseIssueLinks`, `getTestCaseWebLinks`, `getTestCaseTestScript`, `getTestCaseTestSteps`
         - **Test Execution Step**: `getTestExecutionStepIssueLinks`, `createTestExecutionStepIssueLink`
-    - IterationData (supplements public API with iteration data)
+    - ExtendedData (supplements public API with extended data: iterations and versions)
         - **Test Cycle**: `getTestCycleIteration`, `updateTestCycleIteration`
-        - **Test Execution**: `getTestExecutionIteration`, `updateTestExecutionIteration`
+        - **Test Execution**: `getTestExecutionIteration`, `updateTestExecutionIteration`, `getTestExecutionVersion`, `updateTestExecutionVersion`
+    - TestCaseArchiving (access archived test cases and archiving operations)
+        - **Test Case**: `getArchivedTestCases`, `archiveTestCases`, `unarchiveTestCases`
 
 ## Private API Authentication
 
@@ -393,9 +395,9 @@ const stepLink = await api.Private.VersionControl.createTestExecutionStepIssueLi
 });
 ```
 
-### Example: Get and Set Iteration Data (Supplements Public API)
+### Example: Get and Set Extended Data (Supplements Public API)
 
-The public API does not support getting or setting iterations for Test Cycles and Test Executions. Use the `IterationData` sub-group to supplement public API calls with iteration data.
+The public API does not support getting or setting iterations for Test Cycles and Test Executions, or Jira version IDs (release versions) for Test Executions. Use the `ExtendedData` sub-group to supplement public API calls with this additional data.
 
 ```typescript
 // === Test Cycle Iteration ===
@@ -407,14 +409,14 @@ const testCycle = await api.TestCycle.createTestCycle({
 });
 
 // Set iteration using private API (supplements createTestCycle)
-await api.Private.IterationData.updateTestCycleIteration(credentials, {
+await api.Private.ExtendedData.updateTestCycleIteration(credentials, {
   testCycleKey: testCycle.key,
   projectId: 10313,
   iterationId: 10952254
 });
 
 // Get iteration data (supplements getTestCycle)
-const testCycleIteration = await api.Private.IterationData.getTestCycleIteration(credentials, {
+const testCycleIteration = await api.Private.ExtendedData.getTestCycleIteration(credentials, {
   testCycleKey: 'M12-R1',
   projectId: 10313
 });
@@ -434,25 +436,113 @@ await api.TestExecution.createTestExecution({
 // or look it up using listTestExecutions() after creation
 
 // Set iteration using private API (supplements createTestExecution)
-await api.Private.IterationData.updateTestExecutionIteration(credentials, {
+await api.Private.ExtendedData.updateTestExecutionIteration(credentials, {
   testExecutionKey: 'M12-E1', // Use known key or look up after creation
   projectId: 10313,
   iterationId: 10952254
 });
 
 // Get iteration data (supplements getTestExecution)
-const testExecutionIteration = await api.Private.IterationData.getTestExecutionIteration(credentials, {
+const testExecutionIteration = await api.Private.ExtendedData.getTestExecutionIteration(credentials, {
   testExecutionKey: 'M12-E1',
   projectId: 10313
 });
 console.log('Test Execution Iteration ID:', testExecutionIteration.iterationId); // null if not set
 
 // Clear iteration by setting to null
-await api.Private.IterationData.updateTestCycleIteration(credentials, {
+await api.Private.ExtendedData.updateTestCycleIteration(credentials, {
   testCycleKey: 'M12-R1',
   projectId: 10313,
   iterationId: null
 });
+
+// === Test Execution Version (Release Version) ===
+
+// Create test execution with public API (returns void)
+await api.TestExecution.createTestExecution({
+  projectKey: 'M15',
+  testCaseKey: 'M15-T3',
+  testCycleKey: 'M15-R1',
+  statusName: 'Pass'
+});
+
+// Note: createTestExecution returns no data, so you need to know the execution key
+// or look it up using listTestExecutions() after creation
+
+// Set Jira version ID (release version) using private API (supplements createTestExecution)
+await api.Private.ExtendedData.updateTestExecutionVersion(credentials, {
+  testExecutionKey: 'M15-E3', // Use known key or look up after creation
+  projectId: 10316,
+  jiraVersionId: 10102
+});
+
+// Get version data (supplements getTestExecution)
+const testExecutionVersion = await api.Private.ExtendedData.getTestExecutionVersion(credentials, {
+  testExecutionKey: 'M15-E3',
+  projectId: 10316
+});
+console.log('Jira Version ID:', testExecutionVersion.jiraVersionId); // null if not set
+
+// Clear version by setting to null
+await api.Private.ExtendedData.updateTestExecutionVersion(credentials, {
+  testExecutionKey: 'M15-E3',
+  projectId: 10316,
+  jiraVersionId: null
+});
+```
+
+### Example: Test Case Archiving
+
+The public API does not expose the archived flag on test cases. Use the `TestCaseArchiving` sub-group to list archived test cases and perform archiving/unarchiving operations.
+
+```typescript
+// === Get Archived Test Cases ===
+
+// Get first page of archived test cases
+const archived = await api.Private.TestCaseArchiving.getArchivedTestCases(credentials, {
+  projectId: 10316,
+  maxResults: 50,
+  startAt: 0
+});
+console.log(`Found ${archived.total} archived test cases`);
+archived.results.forEach(tc => {
+  console.log(`- ${tc.key}: ${tc.name}`);
+});
+
+// Get archived test cases with custom query filter
+const filtered = await api.Private.TestCaseArchiving.getArchivedTestCases(credentials, {
+  projectId: 10316,
+  query: "testCase.name CONTAINS 'migration'",
+  maxResults: 100
+});
+
+// === Archive Test Cases ===
+
+// Archive a single test case
+await api.Private.TestCaseArchiving.archiveTestCases(credentials, {
+  projectId: 10316,
+  testCaseIds: [288004503]
+});
+
+// Archive multiple test cases
+await api.Private.TestCaseArchiving.archiveTestCases(credentials, {
+  projectId: 10316,
+  testCaseIds: [288004503, 288004504, 288004505]
+});
+
+// === Unarchive Test Cases ===
+
+// Unarchive a single test case
+await api.Private.TestCaseArchiving.unarchiveTestCases(credentials, {
+  projectId: 10316,
+  testCaseIds: [288004503]
+});
+
+// Unarchive multiple test cases
+await api.Private.TestCaseArchiving.unarchiveTestCases(credentials, {
+  projectId: 10316,
+  testCaseIds: [288004503, 288004504, 288004505]
+});
 ```
 
 **Note:** Version numbers are absolute (1-based: 1 = first version ever created, 2 = second version, etc. The highest number is the current/latest version). Use `listTestCaseVersions()` to find the total number of versions and identify the latest. If `version` is not provided, the latest version is used.
@@ -469,9 +559,19 @@ Feel free to drop ideas, suggestions or improvements into our [Community hub](ht
 
 ## Changelog
 
+### 1.3.8
+
+- **Added**: `getTestExecutionVersion()` - Get Jira version ID (release version) for a test execution (supplements public `getTestExecution()`)
+- **Added**: `updateTestExecutionVersion()` - Set/clear Jira version ID for a test execution (supplements public `createTestExecution()`/`updateTestExecution()`)
+- **Added**: New `TestCaseArchiving` sub-group under Private API for test case archiving operations
+- **Added**: `getArchivedTestCases()` - Get paginated list of archived test cases (supplements public API which doesn't expose archived flag)
+- **Added**: `archiveTestCases()` - Archive one or more test cases (bulk operation)
+- **Added**: `unarchiveTestCases()` - Unarchive one or more test cases (bulk operation)
+- **Changed**: Renamed `IterationData` sub-group to `ExtendedData` to better reflect that it handles both iteration and version data
+
 ### 1.3.7
 
-- **Added**: New `IterationData` sub-group under Private API to supplement public API with iteration data
+- **Added**: New `ExtendedData` sub-group under Private API to supplement public API with extended data (iterations and versions)
 - **Added**: `getTestCycleIteration()` - Get iteration for a test cycle (supplements public `getTestCycle()`)
 - **Added**: `updateTestCycleIteration()` - Set/clear iteration for a test cycle (supplements public `createTestCycle()`/`updateTestCycle()`)
 - **Added**: `getTestExecutionIteration()` - Get iteration for a test execution (supplements public `getTestExecution()`)

package/dist/README.md

@@ -155,9 +155,11 @@ const apiEU = createZephyrApi(
     - VersionControl
         - **Test Case (version-specific)**: `getTestCaseIssueLinks`, `getTestCaseWebLinks`, `getTestCaseTestScript`, `getTestCaseTestSteps`
         - **Test Execution Step**: `getTestExecutionStepIssueLinks`, `createTestExecutionStepIssueLink`
-    - IterationData (supplements public API with iteration data)
+    - ExtendedData (supplements public API with extended data: iterations and versions)
         - **Test Cycle**: `getTestCycleIteration`, `updateTestCycleIteration`
-        - **Test Execution**: `getTestExecutionIteration`, `updateTestExecutionIteration`
+        - **Test Execution**: `getTestExecutionIteration`, `updateTestExecutionIteration`, `getTestExecutionVersion`, `updateTestExecutionVersion`
+    - TestCaseArchiving (access archived test cases and archiving operations)
+        - **Test Case**: `getArchivedTestCases`, `archiveTestCases`, `unarchiveTestCases`
 
 ## Private API Authentication
 
@@ -393,9 +395,9 @@ const stepLink = await api.Private.VersionControl.createTestExecutionStepIssueLi
 });
 ```
 
-### Example: Get and Set Iteration Data (Supplements Public API)
+### Example: Get and Set Extended Data (Supplements Public API)
 
-The public API does not support getting or setting iterations for Test Cycles and Test Executions. Use the `IterationData` sub-group to supplement public API calls with iteration data.
+The public API does not support getting or setting iterations for Test Cycles and Test Executions, or Jira version IDs (release versions) for Test Executions. Use the `ExtendedData` sub-group to supplement public API calls with this additional data.
 
 ```typescript
 // === Test Cycle Iteration ===
@@ -407,14 +409,14 @@ const testCycle = await api.TestCycle.createTestCycle({
 });
 
 // Set iteration using private API (supplements createTestCycle)
-await api.Private.IterationData.updateTestCycleIteration(credentials, {
+await api.Private.ExtendedData.updateTestCycleIteration(credentials, {
   testCycleKey: testCycle.key,
   projectId: 10313,
   iterationId: 10952254
 });
 
 // Get iteration data (supplements getTestCycle)
-const testCycleIteration = await api.Private.IterationData.getTestCycleIteration(credentials, {
+const testCycleIteration = await api.Private.ExtendedData.getTestCycleIteration(credentials, {
   testCycleKey: 'M12-R1',
   projectId: 10313
 });
@@ -434,25 +436,113 @@ await api.TestExecution.createTestExecution({
 // or look it up using listTestExecutions() after creation
 
 // Set iteration using private API (supplements createTestExecution)
-await api.Private.IterationData.updateTestExecutionIteration(credentials, {
+await api.Private.ExtendedData.updateTestExecutionIteration(credentials, {
   testExecutionKey: 'M12-E1', // Use known key or look up after creation
   projectId: 10313,
   iterationId: 10952254
 });
 
 // Get iteration data (supplements getTestExecution)
-const testExecutionIteration = await api.Private.IterationData.getTestExecutionIteration(credentials, {
+const testExecutionIteration = await api.Private.ExtendedData.getTestExecutionIteration(credentials, {
   testExecutionKey: 'M12-E1',
   projectId: 10313
 });
 console.log('Test Execution Iteration ID:', testExecutionIteration.iterationId); // null if not set
 
 // Clear iteration by setting to null
-await api.Private.IterationData.updateTestCycleIteration(credentials, {
+await api.Private.ExtendedData.updateTestCycleIteration(credentials, {
   testCycleKey: 'M12-R1',
   projectId: 10313,
   iterationId: null
 });
+
+// === Test Execution Version (Release Version) ===
+
+// Create test execution with public API (returns void)
+await api.TestExecution.createTestExecution({
+  projectKey: 'M15',
+  testCaseKey: 'M15-T3',
+  testCycleKey: 'M15-R1',
+  statusName: 'Pass'
+});
+
+// Note: createTestExecution returns no data, so you need to know the execution key
+// or look it up using listTestExecutions() after creation
+
+// Set Jira version ID (release version) using private API (supplements createTestExecution)
+await api.Private.ExtendedData.updateTestExecutionVersion(credentials, {
+  testExecutionKey: 'M15-E3', // Use known key or look up after creation
+  projectId: 10316,
+  jiraVersionId: 10102
+});
+
+// Get version data (supplements getTestExecution)
+const testExecutionVersion = await api.Private.ExtendedData.getTestExecutionVersion(credentials, {
+  testExecutionKey: 'M15-E3',
+  projectId: 10316
+});
+console.log('Jira Version ID:', testExecutionVersion.jiraVersionId); // null if not set
+
+// Clear version by setting to null
+await api.Private.ExtendedData.updateTestExecutionVersion(credentials, {
+  testExecutionKey: 'M15-E3',
+  projectId: 10316,
+  jiraVersionId: null
+});
+```
+
+### Example: Test Case Archiving
+
+The public API does not expose the archived flag on test cases. Use the `TestCaseArchiving` sub-group to list archived test cases and perform archiving/unarchiving operations.
+
+```typescript
+// === Get Archived Test Cases ===
+
+// Get first page of archived test cases
+const archived = await api.Private.TestCaseArchiving.getArchivedTestCases(credentials, {
+  projectId: 10316,
+  maxResults: 50,
+  startAt: 0
+});
+console.log(`Found ${archived.total} archived test cases`);
+archived.results.forEach(tc => {
+  console.log(`- ${tc.key}: ${tc.name}`);
+});
+
+// Get archived test cases with custom query filter
+const filtered = await api.Private.TestCaseArchiving.getArchivedTestCases(credentials, {
+  projectId: 10316,
+  query: "testCase.name CONTAINS 'migration'",
+  maxResults: 100
+});
+
+// === Archive Test Cases ===
+
+// Archive a single test case
+await api.Private.TestCaseArchiving.archiveTestCases(credentials, {
+  projectId: 10316,
+  testCaseIds: [288004503]
+});
+
+// Archive multiple test cases
+await api.Private.TestCaseArchiving.archiveTestCases(credentials, {
+  projectId: 10316,
+  testCaseIds: [288004503, 288004504, 288004505]
+});
+
+// === Unarchive Test Cases ===
+
+// Unarchive a single test case
+await api.Private.TestCaseArchiving.unarchiveTestCases(credentials, {
+  projectId: 10316,
+  testCaseIds: [288004503]
+});
+
+// Unarchive multiple test cases
+await api.Private.TestCaseArchiving.unarchiveTestCases(credentials, {
+  projectId: 10316,
+  testCaseIds: [288004503, 288004504, 288004505]
+});
 ```
 
 **Note:** Version numbers are absolute (1-based: 1 = first version ever created, 2 = second version, etc. The highest number is the current/latest version). Use `listTestCaseVersions()` to find the total number of versions and identify the latest. If `version` is not provided, the latest version is used.
@@ -469,9 +559,19 @@ Feel free to drop ideas, suggestions or improvements into our [Community hub](ht
 
 ## Changelog
 
+### 1.3.8
+
+- **Added**: `getTestExecutionVersion()` - Get Jira version ID (release version) for a test execution (supplements public `getTestExecution()`)
+- **Added**: `updateTestExecutionVersion()` - Set/clear Jira version ID for a test execution (supplements public `createTestExecution()`/`updateTestExecution()`)
+- **Added**: New `TestCaseArchiving` sub-group under Private API for test case archiving operations
+- **Added**: `getArchivedTestCases()` - Get paginated list of archived test cases (supplements public API which doesn't expose archived flag)
+- **Added**: `archiveTestCases()` - Archive one or more test cases (bulk operation)
+- **Added**: `unarchiveTestCases()` - Unarchive one or more test cases (bulk operation)
+- **Changed**: Renamed `IterationData` sub-group to `ExtendedData` to better reflect that it handles both iteration and version data
+
 ### 1.3.7
 
-- **Added**: New `IterationData` sub-group under Private API to supplement public API with iteration data
+- **Added**: New `ExtendedData` sub-group under Private API to supplement public API with extended data (iterations and versions)
 - **Added**: `getTestCycleIteration()` - Get iteration for a test cycle (supplements public `getTestCycle()`)
 - **Added**: `updateTestCycleIteration()` - Set/clear iteration for a test cycle (supplements public `createTestCycle()`/`updateTestCycle()`)
 - **Added**: `getTestExecutionIteration()` - Get iteration for a test execution (supplements public `getTestExecution()`)

package/dist/groups/Private/{PrivateIterationData.d.ts → PrivateExtendedData.d.ts}

@@ -2,15 +2,15 @@
  * Copyright Adaptavist 2025 (c) All rights reserved
  */
 /**
- * Private API Iteration Data sub-group
- * Supplements public API with iteration data for Test Cycles and Test Executions
+ * Private API Extended Data sub-group
+ * Supplements public API with extended data (iterations, versions) for Test Cycles and Test Executions
  *
  * ⚠️ WARNING: These methods use private APIs that are not officially supported.
  */
-import type { PrivateApiCredentials, GetTestCycleIterationRequest, TestCycleIterationResponse, UpdateTestCycleIterationRequest, GetTestExecutionIterationRequest, TestExecutionIterationResponse, UpdateTestExecutionIterationRequest } from '../../types';
+import type { PrivateApiCredentials, GetTestCycleIterationRequest, TestCycleIterationResponse, UpdateTestCycleIterationRequest, GetTestExecutionIterationRequest, TestExecutionIterationResponse, UpdateTestExecutionIterationRequest, GetTestExecutionVersionRequest, TestExecutionVersionResponse, UpdateTestExecutionVersionRequest } from '../../types';
 import type { ZephyrApiConnection } from '../../index';
 import { PrivateBase } from './PrivateBase';
-export declare class PrivateIterationData extends PrivateBase {
+export declare class PrivateExtendedData extends PrivateBase {
     constructor(apiConnection?: ZephyrApiConnection);
     /**
      * Get test cycle iteration using private API
@@ -153,5 +153,77 @@ export declare class PrivateIterationData extends PrivateBase {
      * ```
      */
     updateTestExecutionIteration(credentials: PrivateApiCredentials, request: UpdateTestExecutionIterationRequest): Promise<void>;
+    /**
+     * Get test execution version using private API
+     *
+     * Retrieves Jira version ID (release version) for a test execution that is not available in the public API.
+     * Use this to supplement the public `getTestExecution()` response with version information.
+     *
+     * ⚠️ WARNING: This uses a private Zephyr API endpoint that is not officially supported.
+     * The endpoint may change or be removed at any time without notice.
+     *
+     * @param credentials - Private API credentials
+     * @param request - Get test execution version request
+     * @param request.testExecutionKey - Test execution key (e.g., "M15-E3")
+     * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @returns Test execution version response with jiraVersionId (null if not set)
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {NotFoundError} If the test execution is not found
+     * @throws {ServerError} If the server returns an error
+     *
+     * @example
+     * ```typescript
+     * // Get version for a test execution (supplements public getTestExecution)
+     * const publicData = await api.TestExecution.getTestExecution({ key: 'M15-E3' });
+     * const versionData = await api.Private.IterationData.getTestExecutionVersion(credentials, {
+     *   testExecutionKey: 'M15-E3',
+     *   projectId: 10316
+     * });
+     * console.log('Jira Version ID:', versionData.jiraVersionId);
+     * ```
+     */
+    getTestExecutionVersion(credentials: PrivateApiCredentials, request: GetTestExecutionVersionRequest): Promise<TestExecutionVersionResponse>;
+    /**
+     * Update test execution version using private API
+     *
+     * Sets or clears the Jira version ID (release version) for a test execution. Use this to supplement
+     * a test execution created via the public API with version data.
+     *
+     * ⚠️ WARNING: This uses a private Zephyr API endpoint that is not officially supported.
+     * The endpoint may change or be removed at any time without notice.
+     *
+     * @param credentials - Private API credentials
+     * @param request - Update test execution version request
+     * @param request.testExecutionKey - Test execution key (e.g., "M15-E3")
+     * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @param request.jiraVersionId - Jira version ID to set, or null to clear
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {NotFoundError} If the test execution is not found
+     * @throws {ServerError} If the server returns an error
+     *
+     * @example
+     * ```typescript
+     * // Create test execution with public API (returns void), then set version with private API
+     * await api.TestExecution.createTestExecution({
+     *   projectKey: 'M15',
+     *   testCaseKey: 'M15-T3',
+     *   testCycleKey: 'M15-R1',
+     *   statusName: 'Pass'
+     * });
+     *
+     * // Note: createTestExecution returns no data, so use known key or look up after creation
+     * // Set version using private API
+     * await api.Private.IterationData.updateTestExecutionVersion(credentials, {
+     *   testExecutionKey: 'M15-E3', // Use known key or look up via listTestExecutions()
+     *   projectId: 10316,
+     *   jiraVersionId: 10102
+     * });
+     * ```
+     */
+    updateTestExecutionVersion(credentials: PrivateApiCredentials, request: UpdateTestExecutionVersionRequest): Promise<void>;
 }
-//# sourceMappingURL=PrivateIterationData.d.ts.map
+//# sourceMappingURL=PrivateExtendedData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PrivateExtendedData.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateExtendedData.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,4BAA4B,EAC5B,0BAA0B,EAC1B,+BAA+B,EAC/B,gCAAgC,EAChC,8BAA8B,EAC9B,mCAAmC,EACnC,8BAA8B,EAC9B,4BAA4B,EAC5B,iCAAiC,EACjC,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAwC5C,qBAAa,mBAAoB,SAAQ,WAAW;gBACvC,aAAa,CAAC,EAAE,mBAAmB;IAQ/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,qBAAqB,CAC1B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,0BAA0B,CAAC;IAqEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,wBAAwB,CAC7B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,+BAA+B,GACtC,OAAO,CAAC,IAAI,CAAC;IAgFhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,yBAAyB,CAC9B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,gCAAgC,GACvC,OAAO,CAAC,8BAA8B,CAAC;IAqE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACG,4BAA4B,CACjC,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,mCAAmC,GAC1C,OAAO,CAAC,IAAI,CAAC;IA+EhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,uBAAuB,CAC5B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,8BAA8B,GACrC,OAAO,CAAC,4BAA4B,CAAC;IAsExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACG,0BAA0B,CAC/B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,iCAAiC,GACxC,OAAO,CAAC,IAAI,CAAC;CA0EhB"}

package/dist/groups/Private/{PrivateIterationData.js → PrivateExtendedData.js}

@@ -3,7 +3,7 @@
  */
 import { PrivateBase } from './PrivateBase';
 import { BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ServerError, UnexpectedError, } from '../../utils';
-export class PrivateIterationData extends PrivateBase {
+export class PrivateExtendedData extends PrivateBase {
     constructor(apiConnection) {
         super(apiConnection);
     }
@@ -361,4 +361,183 @@ export class PrivateIterationData extends PrivateBase {
             throw new UnexpectedError(`Unexpected error while updating test execution iteration for '${request.testExecutionKey}'`, error);
         }
     }
+    // ============================================================================
+    // Test Execution Version Methods
+    // ============================================================================
+    /**
+     * Get test execution version using private API
+     *
+     * Retrieves Jira version ID (release version) for a test execution that is not available in the public API.
+     * Use this to supplement the public `getTestExecution()` response with version information.
+     *
+     * ⚠️ WARNING: This uses a private Zephyr API endpoint that is not officially supported.
+     * The endpoint may change or be removed at any time without notice.
+     *
+     * @param credentials - Private API credentials
+     * @param request - Get test execution version request
+     * @param request.testExecutionKey - Test execution key (e.g., "M15-E3")
+     * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @returns Test execution version response with jiraVersionId (null if not set)
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {NotFoundError} If the test execution is not found
+     * @throws {ServerError} If the server returns an error
+     *
+     * @example
+     * ```typescript
+     * // Get version for a test execution (supplements public getTestExecution)
+     * const publicData = await api.TestExecution.getTestExecution({ key: 'M15-E3' });
+     * const versionData = await api.Private.IterationData.getTestExecutionVersion(credentials, {
+     *   testExecutionKey: 'M15-E3',
+     *   projectId: 10316
+     * });
+     * console.log('Jira Version ID:', versionData.jiraVersionId);
+     * ```
+     */
+    async getTestExecutionVersion(credentials, request) {
+        // Get Context JWT
+        const contextJwt = await this.getContextJwt(credentials);
+        // Build URL with minimal fields needed (jiraVersionId is included in the fields)
+        const fields = 'id,key,jiraVersionId';
+        const url = `${this.privateApiBaseUrl}/testresult/${request.testExecutionKey}?fields=${encodeURIComponent(fields)}&itemId=${request.testExecutionKey}`;
+        const headers = {
+            accept: 'application/json',
+            authorization: `JWT ${contextJwt}`,
+            'jira-project-id': String(request.projectId),
+        };
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers,
+            });
+            if (!response.ok) {
+                if (response.status === 400) {
+                    throw new BadRequestError(`Invalid request parameters for getting test execution version.`);
+                }
+                if (response.status === 401) {
+                    throw new UnauthorizedError('Failed to authenticate. Please check your credentials.');
+                }
+                if (response.status === 403) {
+                    throw new ForbiddenError('Insufficient permissions to get test execution version.');
+                }
+                if (response.status === 404) {
+                    throw new NotFoundError(`Test execution '${request.testExecutionKey}' not found.`);
+                }
+                throw new ServerError(`Failed to get test execution version. Status: ${response.status}`, response.status, response.statusText);
+            }
+            const data = (await response.json());
+            return {
+                id: data.id,
+                key: data.key,
+                // jiraVersionId is excluded from response if not set, so use null if undefined
+                jiraVersionId: data.jiraVersionId ?? null,
+            };
+        }
+        catch (error) {
+            if (error instanceof BadRequestError ||
+                error instanceof UnauthorizedError ||
+                error instanceof ForbiddenError ||
+                error instanceof NotFoundError ||
+                error instanceof ServerError ||
+                error instanceof UnexpectedError) {
+                throw error;
+            }
+            throw new UnexpectedError(`Unexpected error while getting test execution version for '${request.testExecutionKey}'`, error);
+        }
+    }
+    /**
+     * Update test execution version using private API
+     *
+     * Sets or clears the Jira version ID (release version) for a test execution. Use this to supplement
+     * a test execution created via the public API with version data.
+     *
+     * ⚠️ WARNING: This uses a private Zephyr API endpoint that is not officially supported.
+     * The endpoint may change or be removed at any time without notice.
+     *
+     * @param credentials - Private API credentials
+     * @param request - Update test execution version request
+     * @param request.testExecutionKey - Test execution key (e.g., "M15-E3")
+     * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @param request.jiraVersionId - Jira version ID to set, or null to clear
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {NotFoundError} If the test execution is not found
+     * @throws {ServerError} If the server returns an error
+     *
+     * @example
+     * ```typescript
+     * // Create test execution with public API (returns void), then set version with private API
+     * await api.TestExecution.createTestExecution({
+     *   projectKey: 'M15',
+     *   testCaseKey: 'M15-T3',
+     *   testCycleKey: 'M15-R1',
+     *   statusName: 'Pass'
+     * });
+     *
+     * // Note: createTestExecution returns no data, so use known key or look up after creation
+     * // Set version using private API
+     * await api.Private.IterationData.updateTestExecutionVersion(credentials, {
+     *   testExecutionKey: 'M15-E3', // Use known key or look up via listTestExecutions()
+     *   projectId: 10316,
+     *   jiraVersionId: 10102
+     * });
+     * ```
+     */
+    async updateTestExecutionVersion(credentials, request) {
+        // Get Context JWT
+        const contextJwt = await this.getContextJwt(credentials);
+        // First, get the numeric ID for the test execution
+        const testExecutionData = await this.getTestExecutionVersion(credentials, {
+            testExecutionKey: request.testExecutionKey,
+            projectId: request.projectId,
+        });
+        // Build URL with numeric ID
+        const url = `${this.privateApiBaseUrl}/testresult/${testExecutionData.id}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            accept: 'application/json',
+            authorization: `JWT ${contextJwt}`,
+            'jira-project-id': String(request.projectId),
+        };
+        const requestBody = {
+            id: testExecutionData.id,
+            jiraVersionId: request.jiraVersionId,
+        };
+        try {
+            const response = await fetch(url, {
+                method: 'PUT',
+                headers,
+                body: JSON.stringify(requestBody),
+            });
+            if (!response.ok) {
+                if (response.status === 400) {
+                    throw new BadRequestError(`Invalid request parameters for updating test execution version.`);
+                }
+                if (response.status === 401) {
+                    throw new UnauthorizedError('Failed to authenticate. Please check your credentials.');
+                }
+                if (response.status === 403) {
+                    throw new ForbiddenError('Insufficient permissions to update test execution version.');
+                }
+                if (response.status === 404) {
+                    throw new NotFoundError(`Test execution '${request.testExecutionKey}' not found.`);
+                }
+                throw new ServerError(`Failed to update test execution version. Status: ${response.status}`, response.status, response.statusText);
+            }
+            // Response is empty on success
+        }
+        catch (error) {
+            if (error instanceof BadRequestError ||
+                error instanceof UnauthorizedError ||
+                error instanceof ForbiddenError ||
+                error instanceof NotFoundError ||
+                error instanceof ServerError ||
+                error instanceof UnexpectedError) {
+                throw error;
+            }
+            throw new UnexpectedError(`Unexpected error while updating test execution version for '${request.testExecutionKey}'`, error);
+        }
+    }
 }