@rbaileysr/zephyr-managed-api 1.3.2 → 1.3.4

package/README.md

@@ -22,8 +22,8 @@ import { createZephyrApi } from '@rbaileysr/zephyr-managed-api';
 
    // Base URL is configured in the Generic Connector
 const api = createZephyrApi(ZephyrApiConnection);
-```
-
+   ```
+   
 **Using OAuth Token:**
    ```typescript
 import { createZephyrApi } from '@rbaileysr/zephyr-managed-api';
@@ -133,47 +133,28 @@ const apiEU = createZephyrApi(
     - Authentication
         - **getContextJwt** - Get Jira Context JWT token (required for all private API calls)
     - Comments
-        - **getTestCaseComments** - Get all comments for a test case
-        - **getTestCycleComments** - Get all comments for a test cycle
-        - **getTestPlanComments** - Get all comments for a test plan
-        - **createTestCaseComment** - Create a comment on a test case
-        - **createTestCycleComment** - Create a comment on a test cycle
-        - **createTestPlanComment** - Create a comment on a test plan
+        - **Test Case**: `getTestCaseComments`, `createTestCaseComment`
+        - **Test Cycle**: `getTestCycleComments`, `createTestCycleComment`
+        - **Test Plan**: `getTestPlanComments`, `createTestPlanComment`
     - Config
-        - **CustomFields**
-            - **createCustomField** - Create custom fields for test cases, test plans, test runs, test steps, or test executions
-            - **getCustomFields** - Get all custom fields for test cases, test plans, test runs, test steps, or test executions
-        - **Labels**
-            - **getLabels** - Get all labels for a project
-            - **createLabel** - Create a new label
-        - **Iterations**
-            - **getIterations** - Get all iterations for a project
-            - **createIteration** - Create a new iteration
-        - **DataSets**
-            - **getDataSets** - Get all data sets for a project
-            - **createDataSet** - Create a new data set
-            - **updateDataSet** - Update a data set (add items/options)
+        - **CustomFields**: `createCustomField`, `getCustomFields`
+        - **Labels**: `getLabels`, `createLabel`
+        - **Iterations**: `getIterations`, `createIteration`
+        - **DataSets**: `getDataSets`, `createDataSet`, `updateDataSet`
+        - **archiveConfig** - Archive an Environment or Iteration
+        - **unarchiveConfig** - Unarchive an Environment or Iteration
     - Versions
         - **createTestCaseVersion** - Create a new test case version
     - Attachments
-        - **getTestCaseAttachments** - Get all attachments for a test case
-        - **downloadAttachment** - Download an attachment from a test case
-        - **createAttachment** - Upload an attachment to a test case
-        - **getTestStepAttachments** - Get all attachments for a test step
-        - **downloadTestStepAttachment** - Download an attachment from a test step
-        - **createTestStepAttachment** - Upload an attachment to a test step
-        - **getTestCycleAttachments** - Get all attachments for a test cycle
-        - **downloadTestCycleAttachment** - Download an attachment from a test cycle
-        - **createTestCycleAttachment** - Upload an attachment to a test cycle
-        - **getTestPlanAttachments** - Get all attachments for a test plan
-        - **downloadTestPlanAttachment** - Download an attachment from a test plan
-        - **createTestPlanAttachment** - Upload an attachment to a test plan
-        - **getTestExecutionAttachments** - Get all attachments for a test execution
-        - **downloadTestExecutionAttachment** - Download an attachment from a test execution
-        - **createTestExecutionAttachment** - Upload an attachment to a test execution
-        - **getTestExecutionStepAttachments** - Get all attachments for a test execution step
-        - **downloadTestExecutionStepAttachment** - Download an attachment from a test execution step
-        - **createTestExecutionStepAttachment** - Upload an attachment to a test execution step
+        - **Test Case**: `getTestCaseAttachments`, `downloadAttachment`, `createTestCaseAttachment`
+        - **Test Step**: `getTestStepAttachments`, `downloadTestStepAttachment`, `createTestStepAttachment`
+        - **Test Cycle**: `getTestCycleAttachments`, `downloadTestCycleAttachment`, `createTestCycleAttachment`
+        - **Test Plan**: `getTestPlanAttachments`, `downloadTestPlanAttachment`, `createTestPlanAttachment`
+        - **Test Execution**: `getTestExecutionAttachments`, `downloadTestExecutionAttachment`, `createTestExecutionAttachment`
+        - **Test Execution Step**: `getTestExecutionStepAttachments`, `downloadTestExecutionStepAttachment`, `createTestExecutionStepAttachment`
+    - VersionControl
+        - **Test Case (version-specific)**: `getTestCaseIssueLinks`, `getTestCaseWebLinks`, `getTestCaseTestScript`, `getTestCaseTestSteps`
+        - **Test Execution Step**: `getTestExecutionStepIssueLinks`, `createTestExecutionStepIssueLink`
 
 ## Private API Authentication
 
@@ -277,6 +258,24 @@ const dataSets = await api.Private.Config.DataSets.getDataSets(credentials, {
 });
 ```
 
+### Example: Archive and Unarchive Config Items
+
+```typescript
+// Archive an environment
+const archivedEnv = await api.Private.Config.archiveConfig(credentials, {
+  type: 'Environment',
+  id: 10873400,
+  projectId: 10233
+});
+
+// Unarchive an iteration
+const unarchivedIteration = await api.Private.Config.unarchiveConfig(credentials, {
+  type: 'Iteration',
+  id: 10909775,
+  projectId: 10233
+});
+```
+
 ### Example: Create Test Case Version
 
 ```typescript
@@ -296,7 +295,7 @@ const newVersion = await api.Private.Versions.createTestCaseVersion(
 // Upload an attachment to a test case
 const file = new Blob(['file content'], { type: 'text/plain' });
 
-const attachment = await api.Private.Attachments.createAttachment(
+const attachment = await api.Private.Attachments.createTestCaseAttachment(
   credentials,
   {
     testCaseKey: 'PROJ-T1',
@@ -308,6 +307,56 @@ const attachment = await api.Private.Attachments.createAttachment(
 );
 ```
 
+### Example: Get Version-Specific Data
+
+```typescript
+// Get issue links for current version
+const issueLinks = await api.Private.VersionControl.getTestCaseIssueLinks(credentials, {
+  testCaseKey: 'PROJ-T1',
+    projectId: 10233
+});
+
+// Get web links for version 2 (previous version)
+const webLinks = await api.Private.VersionControl.getTestCaseWebLinks(credentials, {
+  testCaseKey: 'PROJ-T1',
+    projectId: 10233,
+  version: 2
+});
+
+// Get test script for version 3
+const testScript = await api.Private.VersionControl.getTestCaseTestScript(credentials, {
+  testCaseKey: 'PROJ-T1',
+    projectId: 10233,
+  version: 3
+});
+
+// Get test steps for version 4 (current version, if there are 4 versions total)
+const testSteps = await api.Private.VersionControl.getTestCaseTestSteps(credentials, {
+  testCaseKey: 'PROJ-T1',
+  projectId: 10233,
+  version: 4
+});
+
+// Get issue links for a test execution step (useful for migration)
+const stepIssueLinks = await api.Private.VersionControl.getTestExecutionStepIssueLinks(credentials, {
+  testExecutionKey: 'PROJ-E1',
+  stepIndex: 0,
+  projectId: 10233
+});
+// Returns: [{ id: 169099471, issueId: '66019', type: 'BLOCKS' }, ...]
+
+// Create an issue link for a test execution step
+const stepLink = await api.Private.VersionControl.createTestExecutionStepIssueLink(credentials, {
+  testExecutionKey: 'PROJ-E1',
+  stepIndex: 0,
+  issueId: 66019,
+  type: 'RELATED',
+  projectId: 10233
+});
+```
+
+**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.
+
 **Important Notes:**
 - Private API methods require a `PrivateApiCredentials` object with `userEmail`, `apiToken`, and `jiraInstanceUrl`
 - The Context JWT token expires after 15 minutes and must be retrieved for each private API call
@@ -320,6 +369,21 @@ Feel free to drop ideas, suggestions or improvements into our [Community hub](ht
 
 ## Changelog
 
+### 1.3.4
+
+- **Added**: `getTestExecutionStepIssueLinks()` - Get issue links for a test execution step (for migration purposes)
+- **Added**: `createTestExecutionStepIssueLink()` - Create an issue link for a test execution step
+
+### 1.3.3
+
+- **Added**: New VersionControl sub-group under Private API for version-specific operations
+- **Added**: `getTestCaseIssueLinks()` - Get issue links for a test case with version support
+- **Added**: `getTestCaseWebLinks()` - Get web links for a test case with version support
+- **Added**: `getTestCaseTestScript()` - Get test script for a test case with version support
+- **Added**: `getTestCaseTestSteps()` - Get test steps for a test case with version support
+- **Added**: Version parameter support to `getTestCaseComments()`, `getTestCaseAttachments()`, and `downloadAttachment()` methods
+- **Changed**: Private API now organized as: Authentication, Comments, Config, Versions, Attachments, VersionControl
+
 ### 1.3.2
 
 - **Changed**: `updateDataSet` now takes `id` in the request object instead of as a separate parameter

package/dist/README.md

@@ -22,8 +22,8 @@ import { createZephyrApi } from '@rbaileysr/zephyr-managed-api';
 
    // Base URL is configured in the Generic Connector
 const api = createZephyrApi(ZephyrApiConnection);
-```
-
+   ```
+   
 **Using OAuth Token:**
    ```typescript
 import { createZephyrApi } from '@rbaileysr/zephyr-managed-api';
@@ -133,47 +133,28 @@ const apiEU = createZephyrApi(
     - Authentication
         - **getContextJwt** - Get Jira Context JWT token (required for all private API calls)
     - Comments
-        - **getTestCaseComments** - Get all comments for a test case
-        - **getTestCycleComments** - Get all comments for a test cycle
-        - **getTestPlanComments** - Get all comments for a test plan
-        - **createTestCaseComment** - Create a comment on a test case
-        - **createTestCycleComment** - Create a comment on a test cycle
-        - **createTestPlanComment** - Create a comment on a test plan
+        - **Test Case**: `getTestCaseComments`, `createTestCaseComment`
+        - **Test Cycle**: `getTestCycleComments`, `createTestCycleComment`
+        - **Test Plan**: `getTestPlanComments`, `createTestPlanComment`
     - Config
-        - **CustomFields**
-            - **createCustomField** - Create custom fields for test cases, test plans, test runs, test steps, or test executions
-            - **getCustomFields** - Get all custom fields for test cases, test plans, test runs, test steps, or test executions
-        - **Labels**
-            - **getLabels** - Get all labels for a project
-            - **createLabel** - Create a new label
-        - **Iterations**
-            - **getIterations** - Get all iterations for a project
-            - **createIteration** - Create a new iteration
-        - **DataSets**
-            - **getDataSets** - Get all data sets for a project
-            - **createDataSet** - Create a new data set
-            - **updateDataSet** - Update a data set (add items/options)
+        - **CustomFields**: `createCustomField`, `getCustomFields`
+        - **Labels**: `getLabels`, `createLabel`
+        - **Iterations**: `getIterations`, `createIteration`
+        - **DataSets**: `getDataSets`, `createDataSet`, `updateDataSet`
+        - **archiveConfig** - Archive an Environment or Iteration
+        - **unarchiveConfig** - Unarchive an Environment or Iteration
     - Versions
         - **createTestCaseVersion** - Create a new test case version
     - Attachments
-        - **getTestCaseAttachments** - Get all attachments for a test case
-        - **downloadAttachment** - Download an attachment from a test case
-        - **createAttachment** - Upload an attachment to a test case
-        - **getTestStepAttachments** - Get all attachments for a test step
-        - **downloadTestStepAttachment** - Download an attachment from a test step
-        - **createTestStepAttachment** - Upload an attachment to a test step
-        - **getTestCycleAttachments** - Get all attachments for a test cycle
-        - **downloadTestCycleAttachment** - Download an attachment from a test cycle
-        - **createTestCycleAttachment** - Upload an attachment to a test cycle
-        - **getTestPlanAttachments** - Get all attachments for a test plan
-        - **downloadTestPlanAttachment** - Download an attachment from a test plan
-        - **createTestPlanAttachment** - Upload an attachment to a test plan
-        - **getTestExecutionAttachments** - Get all attachments for a test execution
-        - **downloadTestExecutionAttachment** - Download an attachment from a test execution
-        - **createTestExecutionAttachment** - Upload an attachment to a test execution
-        - **getTestExecutionStepAttachments** - Get all attachments for a test execution step
-        - **downloadTestExecutionStepAttachment** - Download an attachment from a test execution step
-        - **createTestExecutionStepAttachment** - Upload an attachment to a test execution step
+        - **Test Case**: `getTestCaseAttachments`, `downloadAttachment`, `createTestCaseAttachment`
+        - **Test Step**: `getTestStepAttachments`, `downloadTestStepAttachment`, `createTestStepAttachment`
+        - **Test Cycle**: `getTestCycleAttachments`, `downloadTestCycleAttachment`, `createTestCycleAttachment`
+        - **Test Plan**: `getTestPlanAttachments`, `downloadTestPlanAttachment`, `createTestPlanAttachment`
+        - **Test Execution**: `getTestExecutionAttachments`, `downloadTestExecutionAttachment`, `createTestExecutionAttachment`
+        - **Test Execution Step**: `getTestExecutionStepAttachments`, `downloadTestExecutionStepAttachment`, `createTestExecutionStepAttachment`
+    - VersionControl
+        - **Test Case (version-specific)**: `getTestCaseIssueLinks`, `getTestCaseWebLinks`, `getTestCaseTestScript`, `getTestCaseTestSteps`
+        - **Test Execution Step**: `getTestExecutionStepIssueLinks`, `createTestExecutionStepIssueLink`
 
 ## Private API Authentication
 
@@ -277,6 +258,24 @@ const dataSets = await api.Private.Config.DataSets.getDataSets(credentials, {
 });
 ```
 
+### Example: Archive and Unarchive Config Items
+
+```typescript
+// Archive an environment
+const archivedEnv = await api.Private.Config.archiveConfig(credentials, {
+  type: 'Environment',
+  id: 10873400,
+  projectId: 10233
+});
+
+// Unarchive an iteration
+const unarchivedIteration = await api.Private.Config.unarchiveConfig(credentials, {
+  type: 'Iteration',
+  id: 10909775,
+  projectId: 10233
+});
+```
+
 ### Example: Create Test Case Version
 
 ```typescript
@@ -296,7 +295,7 @@ const newVersion = await api.Private.Versions.createTestCaseVersion(
 // Upload an attachment to a test case
 const file = new Blob(['file content'], { type: 'text/plain' });
 
-const attachment = await api.Private.Attachments.createAttachment(
+const attachment = await api.Private.Attachments.createTestCaseAttachment(
   credentials,
   {
     testCaseKey: 'PROJ-T1',
@@ -308,6 +307,56 @@ const attachment = await api.Private.Attachments.createAttachment(
 );
 ```
 
+### Example: Get Version-Specific Data
+
+```typescript
+// Get issue links for current version
+const issueLinks = await api.Private.VersionControl.getTestCaseIssueLinks(credentials, {
+  testCaseKey: 'PROJ-T1',
+    projectId: 10233
+});
+
+// Get web links for version 2 (previous version)
+const webLinks = await api.Private.VersionControl.getTestCaseWebLinks(credentials, {
+  testCaseKey: 'PROJ-T1',
+    projectId: 10233,
+  version: 2
+});
+
+// Get test script for version 3
+const testScript = await api.Private.VersionControl.getTestCaseTestScript(credentials, {
+  testCaseKey: 'PROJ-T1',
+    projectId: 10233,
+  version: 3
+});
+
+// Get test steps for version 4 (current version, if there are 4 versions total)
+const testSteps = await api.Private.VersionControl.getTestCaseTestSteps(credentials, {
+  testCaseKey: 'PROJ-T1',
+  projectId: 10233,
+  version: 4
+});
+
+// Get issue links for a test execution step (useful for migration)
+const stepIssueLinks = await api.Private.VersionControl.getTestExecutionStepIssueLinks(credentials, {
+  testExecutionKey: 'PROJ-E1',
+  stepIndex: 0,
+  projectId: 10233
+});
+// Returns: [{ id: 169099471, issueId: '66019', type: 'BLOCKS' }, ...]
+
+// Create an issue link for a test execution step
+const stepLink = await api.Private.VersionControl.createTestExecutionStepIssueLink(credentials, {
+  testExecutionKey: 'PROJ-E1',
+  stepIndex: 0,
+  issueId: 66019,
+  type: 'RELATED',
+  projectId: 10233
+});
+```
+
+**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.
+
 **Important Notes:**
 - Private API methods require a `PrivateApiCredentials` object with `userEmail`, `apiToken`, and `jiraInstanceUrl`
 - The Context JWT token expires after 15 minutes and must be retrieved for each private API call
@@ -320,6 +369,21 @@ Feel free to drop ideas, suggestions or improvements into our [Community hub](ht
 
 ## Changelog
 
+### 1.3.4
+
+- **Added**: `getTestExecutionStepIssueLinks()` - Get issue links for a test execution step (for migration purposes)
+- **Added**: `createTestExecutionStepIssueLink()` - Create an issue link for a test execution step
+
+### 1.3.3
+
+- **Added**: New VersionControl sub-group under Private API for version-specific operations
+- **Added**: `getTestCaseIssueLinks()` - Get issue links for a test case with version support
+- **Added**: `getTestCaseWebLinks()` - Get web links for a test case with version support
+- **Added**: `getTestCaseTestScript()` - Get test script for a test case with version support
+- **Added**: `getTestCaseTestSteps()` - Get test steps for a test case with version support
+- **Added**: Version parameter support to `getTestCaseComments()`, `getTestCaseAttachments()`, and `downloadAttachment()` methods
+- **Changed**: Private API now organized as: Authentication, Comments, Config, Versions, Attachments, VersionControl
+
 ### 1.3.2
 
 - **Changed**: `updateDataSet` now takes `id` in the request object instead of as a separate parameter

package/dist/groups/All.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"All.d.ts","sourceRoot":"","sources":["../../groups/All.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"All.d.ts","sourceRoot":"","sources":["../../groups/All.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAcpD,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;gBAEjC,aAAa,EAAE,mBAAmB;IAgB9C,IAAI,aAAa,oGAEhB;IAED,IAAI,4BAA4B,+GAE/B;IAED,IAAI,WAAW,2MAEd;IAED,IAAI,cAAc,4GAEjB;IAED,IAAI,cAAc,yEAEjB;IAED,IAAI,gBAAgB,0EAEnB;IAED,IAAI,uBAAuB,gHAE1B;IAED,IAAI,qBAAqB,8GAExB;IAED,IAAI,oBAAoB,qHAEvB;IAED,IAAI,kBAAkB,oGAErB;IAED,IAAI,qBAAqB,oEAExB;IAED,IAAI,wBAAwB,iHAE3B;IAED,IAAI,oBAAoB;kBAuN2hO,CAAC;eAAiB,CAAC;oDArNrkO;IAED,IAAI,uBAAuB,gHAE1B;IAGD,IAAI,cAAc,sGAEjB;IAED,IAAI,YAAY,+FAEf;IAED,IAAI,eAAe,6GAElB;IAED,IAAI,eAAe,0EAElB;IAED,IAAI,iBAAiB,yFAEpB;IAED,IAAI,wBAAwB,iHAE3B;IAED,IAAI,sBAAsB,+GAEzB;IAGD,IAAI,kBAAkB,8GAErB;IAED,IAAI,yBAAyB,gIAE5B;IAED,IAAI,gBAAgB,uGAEnB;IAED,IAAI,mBAAmB,4GAEtB;IAED,IAAI,mBAAmB,8EAEtB;IAED,IAAI,sBAAsB,iGAEzB;IAED,IAAI,4BAA4B,qHAE/B;IAED,IAAI,yBAAyB,6HAE5B;IAED,IAAI,yBAAyB,oFAE5B;IAED,IAAI,uBAAuB,qGAE1B;IAGD,IAAI,aAAa,oGAEhB;IAED,IAAI,WAAW,6FAEd;IAED,IAAI,cAAc,4GAEjB;IAED,IAAI,uBAAuB,gHAE1B;IAED,IAAI,qBAAqB,8GAExB;IAED,IAAI,2BAA2B,oHAE9B;IAGD,IAAI,WAAW,+FAEd;IAED,IAAI,SAAS,yFAEZ;IAED,IAAI,YAAY,4FAEf;IAGD,IAAI,YAAY,kGAEf;IAED,IAAI,UAAU,2FAEb;IAGD,IAAI,YAAY,gGAEf;IAED,IAAI,SAAS,yFAEZ;IAED,IAAI,YAAY,4FAEf;IAED,IAAI,YAAY,4FAEf;IAGD,IAAI,cAAc,oGAEjB;IAED,IAAI,WAAW,6FAEd;IAED,IAAI,cAAc,gGAEjB;IAED,IAAI,cAAc,gGAEjB;IAGD,IAAI,gBAAgB,yGAEnB;IAED,IAAI,cAAc,mGAEjB;IAED,IAAI,iBAAiB,sGAEpB;IAED,IAAI,iBAAiB,sGAEpB;IAGD,IAAI,UAAU,qEAEb;IAGD,IAAI,qBAAqB,wHAExB;IAED,IAAI,sBAAsB,+GAEzB;IAED,IAAI,qBAAqB,6GAExB;IAED,IAAI,sBAAsB,mHAEzB;IAGD,IAAI,sBAAsB,yHAEzB;IAED,IAAI,wBAAwB,2HAE3B;IAED,IAAI,qBAAqB,wHAExB;IAED,IAAI,oBAAoB,+EAEvB;CACD"}

package/dist/groups/Private/PrivateAttachments.d.ts

@@ -25,6 +25,7 @@ export declare class PrivateAttachments extends PrivateBase {
      * @param request - Get attachments request
      * @param request.testCaseKey - Test case key (e.g., 'PROJ-T1'). The numeric ID will be looked up automatically if Zephyr Connector is available.
      * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @param request.version - Optional version number (absolute, 1-based: 1 = first version ever created, 2 = second version, etc. The highest number is the current/latest version). If not provided, uses the latest version.
      * @returns Test case attachments response with array of attachment details
      * @throws {BadRequestError} If the request is invalid
      * @throws {UnauthorizedError} If authentication fails
@@ -50,6 +51,7 @@ export declare class PrivateAttachments extends PrivateBase {
      * @param request.testCaseKey - Test case key (e.g., 'PROJ-T1'). The numeric ID will be looked up automatically if Zephyr Connector is available.
      * @param request.projectId - Jira project ID (numeric, not the project key)
      * @param request.attachmentId - Attachment ID (UUID string, e.g., 'c3f14125-638f-47f9-9211-12a9777c09e7')
+     * @param request.version - Optional version number (absolute, 1-based: 1 = first version ever created, 2 = second version, etc. The highest number is the current/latest version). If not provided, uses the latest version.
      * @returns Blob containing the attachment file data
      * @throws {BadRequestError} If the request is invalid
      * @throws {UnauthorizedError} If authentication fails

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

@@ -1 +1 @@
-{"version":3,"file":"PrivateAttachments.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateAttachments.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PrivateAttachments.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateAttachments.ts"],"names":[],"mappings":"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"}

package/dist/groups/Private/PrivateAttachments.js

@@ -20,6 +20,7 @@ export class PrivateAttachments extends PrivateBase {
      * @param request - Get attachments request
      * @param request.testCaseKey - Test case key (e.g., 'PROJ-T1'). The numeric ID will be looked up automatically if Zephyr Connector is available.
      * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @param request.version - Optional version number (absolute, 1-based: 1 = first version ever created, 2 = second version, etc. The highest number is the current/latest version). If not provided, uses the latest version.
      * @returns Test case attachments response with array of attachment details
      * @throws {BadRequestError} If the request is invalid
      * @throws {UnauthorizedError} If authentication fails
@@ -33,15 +34,21 @@ export class PrivateAttachments extends PrivateBase {
         let testCaseId;
         if (this.testCaseGroup) {
             try {
-                const testCase = await this.testCaseGroup.getTestCase({ testCaseKey: request.testCaseKey });
+                // If version is specified, get the versioned test case; otherwise get the current version
+                const testCase = request.version !== undefined && request.version > 0
+                    ? await this.testCaseGroup.getTestCaseVersion({
+                        testCaseKey: request.testCaseKey,
+                        version: request.version,
+                    })
+                    : await this.testCaseGroup.getTestCase({ testCaseKey: request.testCaseKey });
                 if (!testCase) {
-                    throw new NotFoundError(`Test case with key '${request.testCaseKey}' not found.`);
+                    throw new NotFoundError(`Test case with key '${request.testCaseKey}'${request.version !== undefined && request.version > 0 ? ` version ${request.version}` : ''} not found.`);
                 }
                 testCaseId = testCase.id;
             }
             catch (error) {
                 if (error instanceof NotFoundError) {
-                    throw new NotFoundError(`Test case with key '${request.testCaseKey}' not found.`);
+                    throw new NotFoundError(`Test case with key '${request.testCaseKey}'${request.version !== undefined && request.version > 0 ? ` version ${request.version}` : ''} not found.`);
                 }
                 throw new UnexpectedError(`Failed to look up test case ID from key '${request.testCaseKey}'. Ensure Zephyr Connector is configured.`, error);
             }
@@ -73,7 +80,7 @@ export class PrivateAttachments extends PrivateBase {
                     throw new ForbiddenError('Insufficient permissions to get attachments.');
                 }
                 if (response.status === 404) {
-                    throw new NotFoundError(`Test case with key '${request.testCaseKey}' not found.`);
+                    throw new NotFoundError(`Test case with key '${request.testCaseKey}'${request.version !== undefined && request.version > 0 ? ` version ${request.version}` : ''} not found.`);
                 }
                 throw new ServerError(`Failed to get test case attachments. Status: ${response.status}`, response.status, response.statusText);
             }
@@ -107,6 +114,7 @@ export class PrivateAttachments extends PrivateBase {
      * @param request.testCaseKey - Test case key (e.g., 'PROJ-T1'). The numeric ID will be looked up automatically if Zephyr Connector is available.
      * @param request.projectId - Jira project ID (numeric, not the project key)
      * @param request.attachmentId - Attachment ID (UUID string, e.g., 'c3f14125-638f-47f9-9211-12a9777c09e7')
+     * @param request.version - Optional version number (absolute, 1-based: 1 = first version ever created, 2 = second version, etc. The highest number is the current/latest version). If not provided, uses the latest version.
      * @returns Blob containing the attachment file data
      * @throws {BadRequestError} If the request is invalid
      * @throws {UnauthorizedError} If authentication fails
@@ -120,6 +128,7 @@ export class PrivateAttachments extends PrivateBase {
         const attachmentsResponse = await this.getTestCaseAttachments(credentials, {
             testCaseKey: request.testCaseKey,
             projectId: request.projectId,
+            version: request.version,
         });
         // Step 2: Find the requested attachment
         const attachment = attachmentsResponse.attachments.find((att) => att.id === request.attachmentId);

package/dist/groups/Private/PrivateComments.d.ts

@@ -24,6 +24,7 @@ export declare class PrivateComments extends PrivateBase {
      * @param request - Get comments request
      * @param request.testCaseKey - Test case key (e.g., 'PROJ-T1'). The numeric ID will be looked up automatically if Zephyr Connector is available.
      * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @param request.version - Optional version number (absolute, 1-based: 1 = first version ever created, 2 = second version, etc. The highest number is the current/latest version). If not provided, uses the latest version.
      * @returns Array of comments
      * @throws {BadRequestError} If the request is invalid
      * @throws {UnauthorizedError} If authentication fails

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

@@ -1 +1 @@
-{"version":3,"file":"PrivateComments.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateComments.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,cAAc,EACd,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAS5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,eAAgB,SAAQ,WAAW;gBACnC,aAAa,CAAC,EAAE,mBAAmB;IAI/C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,mBAAmB,CACxB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,cAAc,EAAE,CAAC;IA6E5B;;;;;;;;;;;;;;;;;;OAkBG;IACG,oBAAoB,CACzB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,2BAA2B,GAClC,OAAO,CAAC,cAAc,EAAE,CAAC;IAqD5B;;;;;;;;;;;;;;;;;;OAkBG;IACG,mBAAmB,CACxB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,cAAc,EAAE,CAAC;IAqD5B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,qBAAqB,CAC1B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,6BAA6B,CAAC;IAoFzC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,sBAAsB,CAC3B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,6BAA6B,GACpC,OAAO,CAAC,qBAAqB,CAAC;IAoFjC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,qBAAqB,CAC1B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,qBAAqB,CAAC;CAmFjC"}
+{"version":3,"file":"PrivateComments.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateComments.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,cAAc,EACd,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAS5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,eAAgB,SAAQ,WAAW;gBACnC,aAAa,CAAC,EAAE,mBAAmB;IAI/C;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CACxB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,cAAc,EAAE,CAAC;IA0F5B;;;;;;;;;;;;;;;;;;OAkBG;IACG,oBAAoB,CACzB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,2BAA2B,GAClC,OAAO,CAAC,cAAc,EAAE,CAAC;IAqD5B;;;;;;;;;;;;;;;;;;OAkBG;IACG,mBAAmB,CACxB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,cAAc,EAAE,CAAC;IAqD5B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,qBAAqB,CAC1B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,6BAA6B,CAAC;IAoFzC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,sBAAsB,CAC3B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,6BAA6B,GACpC,OAAO,CAAC,qBAAqB,CAAC;IAoFjC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,qBAAqB,CAC1B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,qBAAqB,CAAC;CAmFjC"}

package/dist/groups/Private/PrivateComments.js

@@ -19,6 +19,7 @@ export class PrivateComments extends PrivateBase {
      * @param request - Get comments request
      * @param request.testCaseKey - Test case key (e.g., 'PROJ-T1'). The numeric ID will be looked up automatically if Zephyr Connector is available.
      * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @param request.version - Optional version number (absolute, 1-based: 1 = first version ever created, 2 = second version, etc. The highest number is the current/latest version). If not provided, uses the latest version.
      * @returns Array of comments
      * @throws {BadRequestError} If the request is invalid
      * @throws {UnauthorizedError} If authentication fails
@@ -32,15 +33,21 @@ export class PrivateComments extends PrivateBase {
         let testCaseId;
         if (this.testCaseGroup) {
             try {
-                const testCase = await this.testCaseGroup.getTestCase({ testCaseKey: request.testCaseKey });
+                // If version is specified, get the versioned test case; otherwise get the current version
+                const testCase = request.version !== undefined && request.version > 0
+                    ? await this.testCaseGroup.getTestCaseVersion({
+                        testCaseKey: request.testCaseKey,
+                        version: request.version,
+                    })
+                    : await this.testCaseGroup.getTestCase({ testCaseKey: request.testCaseKey });
                 if (!testCase) {
-                    throw new NotFoundError(`Test case with key '${request.testCaseKey}' not found.`);
+                    throw new NotFoundError(`Test case with key '${request.testCaseKey}'${request.version !== undefined && request.version > 0 ? ` version ${request.version}` : ''} not found.`);
                 }
                 testCaseId = testCase.id;
             }
             catch (error) {
                 if (error instanceof NotFoundError) {
-                    throw new NotFoundError(`Test case with key '${request.testCaseKey}' not found.`);
+                    throw new NotFoundError(`Test case with key '${request.testCaseKey}'${request.version !== undefined && request.version > 0 ? ` version ${request.version}` : ''} not found.`);
                 }
                 throw new UnexpectedError(`Failed to look up test case ID from key '${request.testCaseKey}'. Ensure Zephyr Connector is configured.`, error);
             }
@@ -72,7 +79,7 @@ export class PrivateComments extends PrivateBase {
                     throw new ForbiddenError('Insufficient permissions to get comments.');
                 }
                 if (response.status === 404) {
-                    throw new NotFoundError(`Test case with key '${request.testCaseKey}' not found.`);
+                    throw new NotFoundError(`Test case with key '${request.testCaseKey}'${request.version !== undefined && request.version > 0 ? ` version ${request.version}` : ''} not found.`);
                 }
                 throw new ServerError(`Failed to get comments. Status: ${response.status}`, response.status, response.statusText);
             }

package/dist/groups/Private/PrivateConfig.d.ts

@@ -7,6 +7,7 @@
  *
  * ⚠️ WARNING: These methods use private APIs that are not officially supported.
  */
+import type { PrivateApiCredentials, ArchiveConfigRequest, ArchiveConfigResponse } from '../../types';
 import type { ZephyrApiConnection } from '../../index';
 import { PrivateBase } from './PrivateBase';
 import { PrivateCustomFields } from './PrivateCustomFields';
@@ -31,5 +32,51 @@ export declare class PrivateConfig extends PrivateBase {
      */
     readonly DataSets: PrivateDataSets;
     constructor(apiConnection?: ZephyrApiConnection);
+    /**
+     * Archive a config item (Environment or Iteration) using private API
+     *
+     * Archives an Environment or Iteration by setting its `isArchived` flag to `true`.
+     *
+     * ⚠️ 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 - Archive config request
+     * @param request.type - Type of config item: 'Environment' or 'Iteration'
+     * @param request.id - Numeric ID of the environment or iteration to archive
+     * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @returns Archive response with the ID of the archived item
+     * @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 environment or iteration is not found
+     * @throws {ServerError} If the server returns an error
+     */
+    archiveConfig(credentials: PrivateApiCredentials, request: ArchiveConfigRequest): Promise<ArchiveConfigResponse>;
+    /**
+     * Unarchive a config item (Environment or Iteration) using private API
+     *
+     * Unarchives an Environment or Iteration by setting its `isArchived` flag to `false`.
+     *
+     * ⚠️ 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 - Archive config request (same interface as archive, but sets isArchived to false)
+     * @param request.type - Type of config item: 'Environment' or 'Iteration'
+     * @param request.id - Numeric ID of the environment or iteration to unarchive
+     * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @returns Archive response with the ID of the unarchived item
+     * @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 environment or iteration is not found
+     * @throws {ServerError} If the server returns an error
+     */
+    unarchiveConfig(credentials: PrivateApiCredentials, request: ArchiveConfigRequest): Promise<ArchiveConfigResponse>;
+    /**
+     * Internal method to update archive status
+     */
+    private updateArchiveStatus;
 }
 //# sourceMappingURL=PrivateConfig.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PrivateConfig.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qBAAa,aAAc,SAAQ,WAAW;IAC7C;;OAEG;IACH,SAAgB,YAAY,EAAE,mBAAmB,CAAC;IAElD;;OAEG;IACH,SAAgB,MAAM,EAAE,aAAa,CAAC;IAEtC;;OAEG;IACH,SAAgB,UAAU,EAAE,iBAAiB,CAAC;IAE9C;;OAEG;IACH,SAAgB,QAAQ,EAAE,eAAe,CAAC;gBAE9B,aAAa,CAAC,EAAE,mBAAmB;CAO/C"}
+{"version":3,"file":"PrivateConfig.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EAErB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAUpD,qBAAa,aAAc,SAAQ,WAAW;IAC7C;;OAEG;IACH,SAAgB,YAAY,EAAE,mBAAmB,CAAC;IAElD;;OAEG;IACH,SAAgB,MAAM,EAAE,aAAa,CAAC;IAEtC;;OAEG;IACH,SAAgB,UAAU,EAAE,iBAAiB,CAAC;IAE9C;;OAEG;IACH,SAAgB,QAAQ,EAAE,eAAe,CAAC;gBAE9B,aAAa,CAAC,EAAE,mBAAmB;IAQ/C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,aAAa,CAClB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;;;;;;;;;;;;;;;;;;OAmBG;IACG,eAAe,CACpB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;OAEG;YACW,mBAAmB;CAuEjC"}