@rbaileysr/zephyr-managed-api 1.3.0 → 1.3.2

package/dist/groups/Priority.d.ts

@@ -21,7 +21,7 @@ export declare class PriorityGroup {
      * @param options.startAt - Zero-indexed starting position (must be multiple of maxResults)
      * @returns Paginated list of priorities with metadata (total, isLast, etc.)
      *
-     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/v2/#operation/listPriorities Official API Documentation}
+     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/listPriorities Official API Documentation}
      */
     listPriorities(options: ListPrioritiesOptions): Promise<PriorityList>;
     /**
@@ -33,7 +33,7 @@ export declare class PriorityGroup {
      * @param options.priorityId - The priority ID
      * @returns Priority object with all fields
      *
-     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/v2/#operation/getPriority Official API Documentation}
+     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/getPriority Official API Documentation}
      */
     getPriority(options: GetPriorityOptions): Promise<Priority>;
     /**
@@ -52,7 +52,7 @@ export declare class PriorityGroup {
      * @param request.body.color - Priority color (optional)
      * @returns Created priority object
      *
-     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/v2/#operation/createPriority Official API Documentation}
+     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/createPriority Official API Documentation}
      */
     createPriority(request: CreatePriorityRequest): Promise<Priority>;
     /**
@@ -73,7 +73,7 @@ export declare class PriorityGroup {
      * @param request.body.color - Priority color (optional)
      * @returns Updated priority object
      *
-     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/v2/#operation/updatePriority Official API Documentation}
+     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/updatePriority Official API Documentation}
      */
     updatePriority(request: UpdatePriorityRequest): Promise<Priority>;
 }

package/dist/groups/Priority.js

@@ -17,7 +17,7 @@ export class PriorityGroup {
      * @param options.startAt - Zero-indexed starting position (must be multiple of maxResults)
      * @returns Paginated list of priorities with metadata (total, isLast, etc.)
      *
-     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/v2/#operation/listPriorities Official API Documentation}
+     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/listPriorities Official API Documentation}
      */
     async listPriorities(options) {
         const queryString = buildQueryString(options);
@@ -33,7 +33,7 @@ export class PriorityGroup {
      * @param options.priorityId - The priority ID
      * @returns Priority object with all fields
      *
-     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/v2/#operation/getPriority Official API Documentation}
+     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/getPriority Official API Documentation}
      */
     async getPriority(options) {
         const response = await this.api.fetch(`/priorities/${options.priorityId}`);
@@ -55,7 +55,7 @@ export class PriorityGroup {
      * @param request.body.color - Priority color (optional)
      * @returns Created priority object
      *
-     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/v2/#operation/createPriority Official API Documentation}
+     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/createPriority Official API Documentation}
      */
     async createPriority(request) {
         const response = await this.api.fetch('/priorities', {
@@ -83,7 +83,7 @@ export class PriorityGroup {
      * @param request.body.color - Priority color (optional)
      * @returns Updated priority object
      *
-     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/v2/#operation/updatePriority Official API Documentation}
+     * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/updatePriority Official API Documentation}
      */
     async updatePriority(request) {
         const response = await this.api.fetch(`/priorities/${request.priorityId}`, {

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

@@ -0,0 +1,35 @@
+/*!
+ * Copyright Adaptavist 2025 (c) All rights reserved
+ */
+/**
+ * Private API Config sub-group
+ * Handles configuration-related operations: Custom Fields, Labels, Iterations, and DataSets
+ *
+ * ⚠️ WARNING: These methods use private APIs that are not officially supported.
+ */
+import type { ZephyrApiConnection } from '../../index';
+import { PrivateBase } from './PrivateBase';
+import { PrivateCustomFields } from './PrivateCustomFields';
+import { PrivateLabels } from './PrivateLabels';
+import { PrivateIterations } from './PrivateIterations';
+import { PrivateDataSets } from './PrivateDataSets';
+export declare class PrivateConfig extends PrivateBase {
+    /**
+     * CustomFields sub-group - Create and get custom fields
+     */
+    readonly CustomFields: PrivateCustomFields;
+    /**
+     * Labels sub-group - Create and get labels
+     */
+    readonly Labels: PrivateLabels;
+    /**
+     * Iterations sub-group - Create and get iterations
+     */
+    readonly Iterations: PrivateIterations;
+    /**
+     * DataSets sub-group - Create, get, and update data sets
+     */
+    readonly DataSets: PrivateDataSets;
+    constructor(apiConnection?: ZephyrApiConnection);
+}
+//# sourceMappingURL=PrivateConfig.d.ts.map

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

@@ -0,0 +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"}

package/dist/groups/Private/PrivateConfig.js

@@ -0,0 +1,17 @@
+/*!
+ * Copyright Adaptavist 2025 (c) All rights reserved
+ */
+import { PrivateBase } from './PrivateBase';
+import { PrivateCustomFields } from './PrivateCustomFields';
+import { PrivateLabels } from './PrivateLabels';
+import { PrivateIterations } from './PrivateIterations';
+import { PrivateDataSets } from './PrivateDataSets';
+export class PrivateConfig extends PrivateBase {
+    constructor(apiConnection) {
+        super(apiConnection);
+        this.CustomFields = new PrivateCustomFields(apiConnection);
+        this.Labels = new PrivateLabels(apiConnection);
+        this.Iterations = new PrivateIterations(apiConnection);
+        this.DataSets = new PrivateDataSets(apiConnection);
+    }
+}

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

@@ -0,0 +1,66 @@
+/*!
+ * Copyright Adaptavist 2025 (c) All rights reserved
+ */
+/**
+ * Private API DataSets sub-group
+ * Handles data set creation, retrieval, and updating
+ *
+ * ⚠️ WARNING: These methods use private APIs that are not officially supported.
+ */
+import type { PrivateApiCredentials, CreateDataSetRequest, CreateDataSetResponse, UpdateDataSetRequest, UpdateDataSetResponse, GetDataSetsRequest, PrivateDataSet } from '../../types';
+import { PrivateBase } from './PrivateBase';
+import type { ZephyrApiConnection } from '../../index';
+export declare class PrivateDataSets extends PrivateBase {
+    constructor(apiConnection?: ZephyrApiConnection);
+    /**
+     * Get all data sets for a project using private API
+     *
+     * ⚠️ 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 data sets request
+     * @returns Array of data sets
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    getDataSets(credentials: PrivateApiCredentials, request: GetDataSetsRequest): Promise<PrivateDataSet[]>;
+    /**
+     * Create a data set using private API
+     *
+     * Note: Data sets are created empty. Use updateDataSet to add items/options.
+     *
+     * ⚠️ 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 - Create data set request
+     * @returns Created data set response
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    createDataSet(credentials: PrivateApiCredentials, request: CreateDataSetRequest): Promise<CreateDataSetResponse>;
+    /**
+     * Update a data set using private API
+     *
+     * Use this method to add items/options to an existing data set.
+     * The request should include all existing items plus any new items to add.
+     *
+     * ⚠️ 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 data set request (must include id field)
+     * @returns Updated data set response
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    updateDataSet(credentials: PrivateApiCredentials, request: UpdateDataSetRequest): Promise<UpdateDataSetResponse>;
+}
+//# sourceMappingURL=PrivateDataSets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PrivateDataSets.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateDataSets.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,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;;;;;;;;;;;;;OAaG;IACG,WAAW,CAAC,WAAW,EAAE,qBAAqB,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAsD7G;;;;;;;;;;;;;;;OAeG;IACG,aAAa,CAClB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,qBAAqB,CAAC;IA+DjC;;;;;;;;;;;;;;;;OAgBG;IACG,aAAa,CAClB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,qBAAqB,CAAC;CAsDjC"}

package/dist/groups/Private/PrivateDataSets.js

@@ -0,0 +1,198 @@
+/*!
+ * Copyright Adaptavist 2025 (c) All rights reserved
+ */
+import { PrivateBase } from './PrivateBase';
+import { BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ServerError, UnexpectedError, } from '../../utils';
+export class PrivateDataSets extends PrivateBase {
+    constructor(apiConnection) {
+        super(apiConnection);
+    }
+    /**
+     * Get all data sets for a project using private API
+     *
+     * ⚠️ 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 data sets request
+     * @returns Array of data sets
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    async getDataSets(credentials, request) {
+        // Get Context JWT
+        const contextJwt = await this.getContextJwt(credentials);
+        const url = `${this.privateApiBaseUrl}/dataset?projectId=${request.projectId}`;
+        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) {
+                    const errorText = await response.text().catch(() => 'Bad Request');
+                    throw new BadRequestError(`Failed to get data sets: ${errorText}`, response.statusText);
+                }
+                if (response.status === 401) {
+                    throw new UnauthorizedError('Authentication failed. Please check your credentials.');
+                }
+                if (response.status === 403) {
+                    throw new ForbiddenError('You do not have permission to get data sets in this project.');
+                }
+                if (response.status === 404) {
+                    throw new NotFoundError('Project not found.');
+                }
+                throw new ServerError(`Failed to get data sets. Status: ${response.status}`, response.status, response.statusText);
+            }
+            const dataSets = await response.json();
+            return dataSets;
+        }
+        catch (error) {
+            if (error instanceof BadRequestError ||
+                error instanceof UnauthorizedError ||
+                error instanceof ForbiddenError ||
+                error instanceof NotFoundError ||
+                error instanceof ServerError) {
+                throw error;
+            }
+            throw new UnexpectedError('Failed to get data sets due to an unexpected error', error);
+        }
+    }
+    /**
+     * Create a data set using private API
+     *
+     * Note: Data sets are created empty. Use updateDataSet to add items/options.
+     *
+     * ⚠️ 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 - Create data set request
+     * @returns Created data set response
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    async createDataSet(credentials, request) {
+        // Get Context JWT
+        const contextJwt = await this.getContextJwt(credentials);
+        const url = `${this.privateApiBaseUrl}/dataset`;
+        const headers = {
+            'Content-Type': 'application/json',
+            authorization: `JWT ${contextJwt}`,
+            'jira-project-id': String(request.projectId),
+        };
+        try {
+            // Hardcode color, index, and items as they're not used by the API
+            const requestBody = {
+                ...request,
+                color: '#FFFFFF',
+                index: 0,
+                items: [],
+            };
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(requestBody),
+            });
+            if (!response.ok) {
+                if (response.status === 400) {
+                    const errorText = await response.text().catch(() => 'Bad Request');
+                    throw new BadRequestError(`Failed to create data set: ${errorText}`, response.statusText);
+                }
+                if (response.status === 401) {
+                    throw new UnauthorizedError('Authentication failed. Please check your credentials.');
+                }
+                if (response.status === 403) {
+                    throw new ForbiddenError('You do not have permission to create data sets in this project.');
+                }
+                if (response.status === 404) {
+                    throw new NotFoundError('Project not found.');
+                }
+                throw new ServerError(`Failed to create data set. Status: ${response.status}`, response.status, response.statusText);
+            }
+            const result = await response.json();
+            return result;
+        }
+        catch (error) {
+            if (error instanceof BadRequestError ||
+                error instanceof UnauthorizedError ||
+                error instanceof ForbiddenError ||
+                error instanceof NotFoundError ||
+                error instanceof ServerError) {
+                throw error;
+            }
+            throw new UnexpectedError('Failed to create data set due to an unexpected error', error);
+        }
+    }
+    /**
+     * Update a data set using private API
+     *
+     * Use this method to add items/options to an existing data set.
+     * The request should include all existing items plus any new items to add.
+     *
+     * ⚠️ 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 data set request (must include id field)
+     * @returns Updated data set response
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    async updateDataSet(credentials, request) {
+        // Get Context JWT
+        const contextJwt = await this.getContextJwt(credentials);
+        const url = `${this.privateApiBaseUrl}/dataset/${request.id}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            authorization: `JWT ${contextJwt}`,
+            'jira-project-id': String(request.projectId),
+        };
+        try {
+            const response = await fetch(url, {
+                method: 'PUT',
+                headers,
+                body: JSON.stringify(request),
+            });
+            if (!response.ok) {
+                if (response.status === 400) {
+                    const errorText = await response.text().catch(() => 'Bad Request');
+                    throw new BadRequestError(`Failed to update data set: ${errorText}`, response.statusText);
+                }
+                if (response.status === 401) {
+                    throw new UnauthorizedError('Authentication failed. Please check your credentials.');
+                }
+                if (response.status === 403) {
+                    throw new ForbiddenError('You do not have permission to update data sets in this project.');
+                }
+                if (response.status === 404) {
+                    throw new NotFoundError('Data set not found.');
+                }
+                throw new ServerError(`Failed to update data set. Status: ${response.status}`, response.status, response.statusText);
+            }
+            const result = await response.json();
+            return result;
+        }
+        catch (error) {
+            if (error instanceof BadRequestError ||
+                error instanceof UnauthorizedError ||
+                error instanceof ForbiddenError ||
+                error instanceof NotFoundError ||
+                error instanceof ServerError) {
+                throw error;
+            }
+            throw new UnexpectedError('Failed to update data set due to an unexpected error', error);
+        }
+    }
+}

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

@@ -0,0 +1,46 @@
+/*!
+ * Copyright Adaptavist 2025 (c) All rights reserved
+ */
+/**
+ * Private API Iterations sub-group
+ * Handles iteration creation and retrieval
+ *
+ * ⚠️ WARNING: These methods use private APIs that are not officially supported.
+ */
+import type { PrivateApiCredentials, CreateIterationRequest, CreateIterationResponse, GetIterationsRequest, PrivateIteration } from '../../types';
+import { PrivateBase } from './PrivateBase';
+import type { ZephyrApiConnection } from '../../index';
+export declare class PrivateIterations extends PrivateBase {
+    constructor(apiConnection?: ZephyrApiConnection);
+    /**
+     * Get all iterations for a project using private API
+     *
+     * ⚠️ 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 iterations request
+     * @returns Array of iterations
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    getIterations(credentials: PrivateApiCredentials, request: GetIterationsRequest): Promise<PrivateIteration[]>;
+    /**
+     * Create an iteration using private API
+     *
+     * ⚠️ 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 - Create iteration request
+     * @returns Created iteration response with ID
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    createIteration(credentials: PrivateApiCredentials, request: CreateIterationRequest): Promise<CreateIterationResponse>;
+}
+//# sourceMappingURL=PrivateIterations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PrivateIterations.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateIterations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAS5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,iBAAkB,SAAQ,WAAW;gBACrC,aAAa,CAAC,EAAE,mBAAmB;IAI/C;;;;;;;;;;;;;OAaG;IACG,aAAa,CAAC,WAAW,EAAE,qBAAqB,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAsDnH;;;;;;;;;;;;;OAaG;IACG,eAAe,CACpB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC;CA8DnC"}

package/dist/groups/Private/PrivateIterations.js

@@ -0,0 +1,134 @@
+/*!
+ * Copyright Adaptavist 2025 (c) All rights reserved
+ */
+import { PrivateBase } from './PrivateBase';
+import { BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ServerError, UnexpectedError, } from '../../utils';
+export class PrivateIterations extends PrivateBase {
+    constructor(apiConnection) {
+        super(apiConnection);
+    }
+    /**
+     * Get all iterations for a project using private API
+     *
+     * ⚠️ 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 iterations request
+     * @returns Array of iterations
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    async getIterations(credentials, request) {
+        // Get Context JWT
+        const contextJwt = await this.getContextJwt(credentials);
+        const url = `${this.privateApiBaseUrl}/iteration?projectId=${request.projectId}`;
+        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) {
+                    const errorText = await response.text().catch(() => 'Bad Request');
+                    throw new BadRequestError(`Failed to get iterations: ${errorText}`, response.statusText);
+                }
+                if (response.status === 401) {
+                    throw new UnauthorizedError('Authentication failed. Please check your credentials.');
+                }
+                if (response.status === 403) {
+                    throw new ForbiddenError('You do not have permission to get iterations in this project.');
+                }
+                if (response.status === 404) {
+                    throw new NotFoundError('Project not found.');
+                }
+                throw new ServerError(`Failed to get iterations. Status: ${response.status}`, response.status, response.statusText);
+            }
+            const iterations = await response.json();
+            return iterations;
+        }
+        catch (error) {
+            if (error instanceof BadRequestError ||
+                error instanceof UnauthorizedError ||
+                error instanceof ForbiddenError ||
+                error instanceof NotFoundError ||
+                error instanceof ServerError) {
+                throw error;
+            }
+            throw new UnexpectedError('Failed to get iterations due to an unexpected error', error);
+        }
+    }
+    /**
+     * Create an iteration using private API
+     *
+     * ⚠️ 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 - Create iteration request
+     * @returns Created iteration response with ID
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    async createIteration(credentials, request) {
+        // Get Context JWT
+        const contextJwt = await this.getContextJwt(credentials);
+        const url = `${this.privateApiBaseUrl}/iteration`;
+        const headers = {
+            'Content-Type': 'application/json',
+            authorization: `JWT ${contextJwt}`,
+            'jira-project-id': String(request.projectId),
+        };
+        try {
+            // Hardcode color, index, and items as they're not used by the API
+            const requestBody = {
+                ...request,
+                color: '#FFFFFF',
+                index: 0,
+                items: [],
+            };
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(requestBody),
+            });
+            if (!response.ok) {
+                if (response.status === 400) {
+                    const errorText = await response.text().catch(() => 'Bad Request');
+                    throw new BadRequestError(`Failed to create iteration: ${errorText}`, response.statusText);
+                }
+                if (response.status === 401) {
+                    throw new UnauthorizedError('Authentication failed. Please check your credentials.');
+                }
+                if (response.status === 403) {
+                    throw new ForbiddenError('You do not have permission to create iterations in this project.');
+                }
+                if (response.status === 404) {
+                    throw new NotFoundError('Project not found.');
+                }
+                throw new ServerError(`Failed to create iteration. Status: ${response.status}`, response.status, response.statusText);
+            }
+            const result = await response.json();
+            return result;
+        }
+        catch (error) {
+            if (error instanceof BadRequestError ||
+                error instanceof UnauthorizedError ||
+                error instanceof ForbiddenError ||
+                error instanceof NotFoundError ||
+                error instanceof ServerError) {
+                throw error;
+            }
+            throw new UnexpectedError('Failed to create iteration due to an unexpected error', error);
+        }
+    }
+}

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

@@ -0,0 +1,46 @@
+/*!
+ * Copyright Adaptavist 2025 (c) All rights reserved
+ */
+/**
+ * Private API Labels sub-group
+ * Handles label creation and retrieval
+ *
+ * ⚠️ WARNING: These methods use private APIs that are not officially supported.
+ */
+import type { PrivateApiCredentials, CreateLabelRequest, GetLabelsRequest, PrivateLabel } from '../../types';
+import { PrivateBase } from './PrivateBase';
+import type { ZephyrApiConnection } from '../../index';
+export declare class PrivateLabels extends PrivateBase {
+    constructor(apiConnection?: ZephyrApiConnection);
+    /**
+     * Get all labels for a project using private API
+     *
+     * ⚠️ 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 labels request
+     * @returns Array of labels
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    getLabels(credentials: PrivateApiCredentials, request: GetLabelsRequest): Promise<PrivateLabel[]>;
+    /**
+     * Create a label using private API
+     *
+     * ⚠️ 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 - Create label request
+     * @returns Empty response (no content)
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     */
+    createLabel(credentials: PrivateApiCredentials, request: CreateLabelRequest): Promise<void>;
+}
+//# sourceMappingURL=PrivateLabels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PrivateLabels.d.ts","sourceRoot":"","sources":["../../../groups/Private/PrivateLabels.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAS5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,aAAc,SAAQ,WAAW;gBACjC,aAAa,CAAC,EAAE,mBAAmB;IAI/C;;;;;;;;;;;;;OAaG;IACG,SAAS,CAAC,WAAW,EAAE,qBAAqB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsDvG;;;;;;;;;;;;;OAaG;IACG,WAAW,CAAC,WAAW,EAAE,qBAAqB,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CA8DjG"}