@dichovsky/testrail-api-client 1.0.0 → 2.1.0

package/dist/client.js

@@ -1,5 +1,21 @@
 import { TestRailClientCore } from './client-core.js';
-import { TestRailValidationError } from './errors.js';
+import { ProjectModule } from './modules/projects.js';
+import { SuiteModule } from './modules/suites.js';
+import { SectionModule } from './modules/sections.js';
+import { CaseModule } from './modules/cases.js';
+import { PlanModule } from './modules/plans.js';
+import { RunModule } from './modules/runs.js';
+import { TestModule } from './modules/tests.js';
+import { ResultModule } from './modules/results.js';
+import { MilestoneModule } from './modules/milestones.js';
+import { UsersModule } from './modules/users.js';
+import { MetadataModule } from './modules/metadata.js';
+import { ConfigurationModule } from './modules/configurations.js';
+import { AttachmentModule } from './modules/attachments.js';
+import { SharedStepModule } from './modules/sharedSteps.js';
+import { VariableModule } from './modules/variables.js';
+import { DatasetModule } from './modules/datasets.js';
+import { ReportModule } from './modules/reports.js';
 export { TestRailApiError, TestRailValidationError } from './errors.js';
 /**
  * TestRail API Client
@@ -9,6 +25,44 @@ export { TestRailApiError, TestRailValidationError } from './errors.js';
  * Extends {@link TestRailClientCore} for HTTP pipeline, caching, rate limiting, and retry.
  */
 export class TestRailClient extends TestRailClientCore {
+    // ── Domain modules ────────────────────────────────────────────────────────
+    projects;
+    suites;
+    sections;
+    cases;
+    plans;
+    runs;
+    tests;
+    results;
+    milestones;
+    users;
+    metadata;
+    configurations;
+    attachments;
+    sharedSteps;
+    variables;
+    datasets;
+    reports;
+    constructor(...args) {
+        super(...args);
+        this.projects = new ProjectModule(this);
+        this.suites = new SuiteModule(this);
+        this.sections = new SectionModule(this);
+        this.cases = new CaseModule(this);
+        this.plans = new PlanModule(this);
+        this.runs = new RunModule(this);
+        this.tests = new TestModule(this);
+        this.results = new ResultModule(this);
+        this.milestones = new MilestoneModule(this);
+        this.users = new UsersModule(this);
+        this.metadata = new MetadataModule(this);
+        this.configurations = new ConfigurationModule(this);
+        this.attachments = new AttachmentModule(this);
+        this.sharedSteps = new SharedStepModule(this);
+        this.variables = new VariableModule(this);
+        this.datasets = new DatasetModule(this);
+        this.reports = new ReportModule(this);
+    }
     // ── Projects ──────────────────────────────────────────────────────────────
     /**
      * Get a project by ID.
@@ -16,8 +70,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getProject(projectId) {
-        this.validateId(projectId, 'projectId');
-        return this.request('GET', `get_project/${projectId}`);
+        return this.projects.getProject(projectId);
     }
     /**
      * Get all projects.
@@ -25,17 +78,14 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getProjects(limit, offset) {
-        this.validatePaginationParams(limit, offset);
-        const endpoint = this.buildEndpoint('get_projects', { limit, offset });
-        const response = await this.request('GET', endpoint);
-        return response.projects ?? [];
+        return this.projects.getProjects(limit, offset);
     }
     /**
      * Add a new project.
      * @throws {TestRailApiError} When the API request fails
      */
     async addProject(payload) {
-        return this.request('POST', 'add_project', payload);
+        return this.projects.addProject(payload);
     }
     /**
      * Update an existing project.
@@ -43,8 +93,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async updateProject(projectId, payload) {
-        this.validateId(projectId, 'projectId');
-        return this.request('POST', `update_project/${projectId}`, payload);
+        return this.projects.updateProject(projectId, payload);
     }
     /**
      * Delete a project.
@@ -52,8 +101,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteProject(projectId) {
-        this.validateId(projectId, 'projectId');
-        await this.request('POST', `delete_project/${projectId}`);
+        return this.projects.deleteProject(projectId);
     }
     // ── Suites ────────────────────────────────────────────────────────────────
     /**
@@ -62,8 +110,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getSuite(suiteId) {
-        this.validateId(suiteId, 'suiteId');
-        return this.request('GET', `get_suite/${suiteId}`);
+        return this.suites.getSuite(suiteId);
     }
     /**
      * Get all suites for a project.
@@ -71,8 +118,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getSuites(projectId) {
-        this.validateId(projectId, 'projectId');
-        return this.request('GET', `get_suites/${projectId}`);
+        return this.suites.getSuites(projectId);
     }
     /**
      * Add a suite to a project.
@@ -80,8 +126,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async addSuite(projectId, payload) {
-        this.validateId(projectId, 'projectId');
-        return this.request('POST', `add_suite/${projectId}`, payload);
+        return this.suites.addSuite(projectId, payload);
     }
     /**
      * Update a suite.
@@ -89,8 +134,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async updateSuite(suiteId, payload) {
-        this.validateId(suiteId, 'suiteId');
-        return this.request('POST', `update_suite/${suiteId}`, payload);
+        return this.suites.updateSuite(suiteId, payload);
     }
     /**
      * Delete a suite.
@@ -98,8 +142,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteSuite(suiteId) {
-        this.validateId(suiteId, 'suiteId');
-        await this.request('POST', `delete_suite/${suiteId}`);
+        return this.suites.deleteSuite(suiteId);
     }
     // ── Sections ──────────────────────────────────────────────────────────────
     /**
@@ -108,8 +151,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getSection(sectionId) {
-        this.validateId(sectionId, 'sectionId');
-        return this.request('GET', `get_section/${sectionId}`);
+        return this.sections.getSection(sectionId);
     }
     /**
      * Get all sections for a project, optionally filtered by suite.
@@ -120,15 +162,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getSections(projectId, options) {
-        this.validateId(projectId, 'projectId');
-        const { suiteId, limit, offset } = options ?? {};
-        if (suiteId !== undefined) {
-            this.validateId(suiteId, 'suiteId');
-        }
-        this.validatePaginationParams(limit, offset);
-        const endpoint = this.buildEndpoint(`get_sections/${projectId}`, { suite_id: suiteId, limit, offset });
-        const response = await this.request('GET', endpoint);
-        return response.sections ?? [];
+        return this.sections.getSections(projectId, options);
     }
     /**
      * Add a new section to a project.
@@ -136,8 +170,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async addSection(projectId, payload) {
-        this.validateId(projectId, 'projectId');
-        return this.request('POST', `add_section/${projectId}`, payload);
+        return this.sections.addSection(projectId, payload);
     }
     /**
      * Update an existing section.
@@ -145,8 +178,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async updateSection(sectionId, payload) {
-        this.validateId(sectionId, 'sectionId');
-        return this.request('POST', `update_section/${sectionId}`, payload);
+        return this.sections.updateSection(sectionId, payload);
     }
     /**
      * Delete a section.
@@ -154,8 +186,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteSection(sectionId) {
-        this.validateId(sectionId, 'sectionId');
-        await this.request('POST', `delete_section/${sectionId}`);
+        return this.sections.deleteSection(sectionId);
     }
     // ── Cases ─────────────────────────────────────────────────────────────────
     /**
@@ -164,8 +195,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getCase(caseId) {
-        this.validateId(caseId, 'caseId');
-        return this.request('GET', `get_case/${caseId}`);
+        return this.cases.getCase(caseId);
     }
     /**
      * Get all cases for a project with optional filters.
@@ -185,37 +215,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getCases(projectId, options) {
-        this.validateId(projectId, 'projectId');
-        const { suiteId, sectionId, typeId, priorityId, templateId, milestoneId, createdAfter, createdBefore, updatedAfter, updatedBefore, limit, offset, } = options ?? {};
-        if (suiteId !== undefined)
-            this.validateId(suiteId, 'suiteId');
-        if (sectionId !== undefined)
-            this.validateId(sectionId, 'sectionId');
-        if (typeId !== undefined)
-            this.validateId(typeId, 'typeId');
-        if (priorityId !== undefined)
-            this.validateId(priorityId, 'priorityId');
-        if (templateId !== undefined)
-            this.validateId(templateId, 'templateId');
-        if (milestoneId !== undefined)
-            this.validateId(milestoneId, 'milestoneId');
-        this.validatePaginationParams(limit, offset);
-        const endpoint = this.buildEndpoint(`get_cases/${projectId}`, {
-            suite_id: suiteId,
-            section_id: sectionId,
-            type_id: typeId,
-            priority_id: priorityId,
-            template_id: templateId,
-            milestone_id: milestoneId,
-            created_after: createdAfter,
-            created_before: createdBefore,
-            updated_after: updatedAfter,
-            updated_before: updatedBefore,
-            limit,
-            offset,
-        });
-        const response = await this.request('GET', endpoint);
-        return response.cases ?? [];
+        return this.cases.getCases(projectId, options);
     }
     /**
      * Add a new case to a section.
@@ -223,8 +223,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async addCase(sectionId, payload) {
-        this.validateId(sectionId, 'sectionId');
-        return this.request('POST', `add_case/${sectionId}`, payload);
+        return this.cases.addCase(sectionId, payload);
     }
     /**
      * Update an existing case.
@@ -232,8 +231,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async updateCase(caseId, payload) {
-        this.validateId(caseId, 'caseId');
-        return this.request('POST', `update_case/${caseId}`, payload);
+        return this.cases.updateCase(caseId, payload);
     }
     /**
      * Delete a case.
@@ -241,8 +239,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteCase(caseId) {
-        this.validateId(caseId, 'caseId');
-        await this.request('POST', `delete_case/${caseId}`);
+        return this.cases.deleteCase(caseId);
     }
     // ── Plans ─────────────────────────────────────────────────────────────────
     /**
@@ -251,8 +248,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getPlan(planId) {
-        this.validateId(planId, 'planId');
-        return this.request('GET', `get_plan/${planId}`);
+        return this.plans.getPlan(planId);
     }
     /**
      * Get all plans for a project with optional filters.
@@ -263,19 +259,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getPlans(projectId, options) {
-        this.validateId(projectId, 'projectId');
-        this.validatePaginationParams(options?.limit, options?.offset);
-        const endpoint = this.buildEndpoint(`get_plans/${projectId}`, {
-            created_after: options?.created_after,
-            created_before: options?.created_before,
-            created_by: this.serializeIdList(options?.created_by),
-            is_completed: options?.is_completed,
-            milestone_id: this.serializeIdList(options?.milestone_id),
-            limit: options?.limit,
-            offset: options?.offset,
-        });
-        const response = await this.request('GET', endpoint);
-        return response.plans ?? [];
+        return this.plans.getPlans(projectId, options);
     }
     /**
      * Add a new plan to a project.
@@ -283,8 +267,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async addPlan(projectId, payload) {
-        this.validateId(projectId, 'projectId');
-        return this.request('POST', `add_plan/${projectId}`, payload);
+        return this.plans.addPlan(projectId, payload);
     }
     /**
      * Update a plan.
@@ -292,8 +275,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async updatePlan(planId, payload) {
-        this.validateId(planId, 'planId');
-        return this.request('POST', `update_plan/${planId}`, payload);
+        return this.plans.updatePlan(planId, payload);
     }
     /**
      * Close a plan.
@@ -301,8 +283,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async closePlan(planId) {
-        this.validateId(planId, 'planId');
-        return this.request('POST', `close_plan/${planId}`);
+        return this.plans.closePlan(planId);
     }
     /**
      * Delete a plan.
@@ -310,8 +291,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async deletePlan(planId) {
-        this.validateId(planId, 'planId');
-        await this.request('POST', `delete_plan/${planId}`);
+        return this.plans.deletePlan(planId);
     }
     /**
      * Add a plan entry (run) to a plan.
@@ -319,8 +299,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async addPlanEntry(planId, payload) {
-        this.validateId(planId, 'planId');
-        return this.request('POST', `add_plan_entry/${planId}`, payload);
+        return this.plans.addPlanEntry(planId, payload);
     }
     /**
      * Update an existing plan entry.
@@ -328,9 +307,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async updatePlanEntry(planId, entryId, payload) {
-        this.validateId(planId, 'planId');
-        this.validateEntryId(entryId);
-        return this.request('POST', `update_plan_entry/${planId}/${entryId}`, payload);
+        return this.plans.updatePlanEntry(planId, entryId, payload);
     }
     /**
      * Delete a plan entry.
@@ -338,9 +315,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async deletePlanEntry(planId, entryId) {
-        this.validateId(planId, 'planId');
-        this.validateEntryId(entryId);
-        await this.request('POST', `delete_plan_entry/${planId}/${entryId}`);
+        return this.plans.deletePlanEntry(planId, entryId);
     }
     // ── Runs ──────────────────────────────────────────────────────────────────
     /**
@@ -349,8 +324,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getRun(runId) {
-        this.validateId(runId, 'runId');
-        return this.request('GET', `get_run/${runId}`);
+        return this.runs.getRun(runId);
     }
     /**
      * Get all runs for a project, with optional filters.
@@ -361,32 +335,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getRuns(projectId, options) {
-        this.validateId(projectId, 'projectId');
-        const { createdAfter, createdBefore, createdBy, isCompleted, milestoneId, refsFilter, suiteId, limit, offset } = options ?? {};
-        this.validatePaginationParams(limit, offset);
-        if (milestoneId !== undefined) {
-            this.validateId(milestoneId, 'milestoneId');
-        }
-        if (suiteId !== undefined) {
-            this.validateId(suiteId, 'suiteId');
-        }
-        if (createdBy !== undefined) {
-            createdBy.forEach((userId) => this.validateId(userId, 'createdBy'));
-        }
-        const createdByFilter = createdBy && createdBy.length > 0 ? createdBy.join(',') : undefined;
-        const endpoint = this.buildEndpoint(`get_runs/${projectId}`, {
-            created_after: createdAfter,
-            created_before: createdBefore,
-            created_by: createdByFilter,
-            is_completed: isCompleted !== undefined ? (isCompleted ? 1 : 0) : undefined,
-            milestone_id: milestoneId,
-            refs_filter: refsFilter,
-            suite_id: suiteId,
-            limit,
-            offset,
-        });
-        const response = await this.request('GET', endpoint);
-        return response.runs ?? [];
+        return this.runs.getRuns(projectId, options);
     }
     /**
      * Add a new run to a project.
@@ -394,8 +343,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async addRun(projectId, payload) {
-        this.validateId(projectId, 'projectId');
-        return this.request('POST', `add_run/${projectId}`, payload);
+        return this.runs.addRun(projectId, payload);
     }
     /**
      * Update a run.
@@ -403,8 +351,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async updateRun(runId, payload) {
-        this.validateId(runId, 'runId');
-        return this.request('POST', `update_run/${runId}`, payload);
+        return this.runs.updateRun(runId, payload);
     }
     /**
      * Close a run.
@@ -412,8 +359,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async closeRun(runId) {
-        this.validateId(runId, 'runId');
-        return this.request('POST', `close_run/${runId}`);
+        return this.runs.closeRun(runId);
     }
     /**
      * Delete a run.
@@ -421,8 +367,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteRun(runId) {
-        this.validateId(runId, 'runId');
-        await this.request('POST', `delete_run/${runId}`);
+        return this.runs.deleteRun(runId);
     }
     // ── Tests ─────────────────────────────────────────────────────────────────
     /**
@@ -431,8 +376,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getTest(testId) {
-        this.validateId(testId, 'testId');
-        return this.request('GET', `get_test/${testId}`);
+        return this.tests.getTest(testId);
     }
     /**
      * Get all tests for a run with optional filters.
@@ -442,15 +386,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getTests(runId, options) {
-        this.validateId(runId, 'runId');
-        this.validatePaginationParams(options?.limit, options?.offset);
-        const endpoint = this.buildEndpoint(`get_tests/${runId}`, {
-            status_id: this.serializeIdList(options?.status_id),
-            limit: options?.limit,
-            offset: options?.offset,
-        });
-        const response = await this.request('GET', endpoint);
-        return response.tests ?? [];
+        return this.tests.getTests(runId, options);
     }
     // ── Results ───────────────────────────────────────────────────────────────
     /**
@@ -462,18 +398,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getResults(testId, options) {
-        this.validateId(testId, 'testId');
-        this.validatePaginationParams(options?.limit, options?.offset);
-        const endpoint = this.buildEndpoint(`get_results/${testId}`, {
-            created_after: options?.created_after,
-            created_before: options?.created_before,
-            created_by: this.serializeIdList(options?.created_by),
-            status_id: this.serializeIdList(options?.status_id),
-            limit: options?.limit,
-            offset: options?.offset,
-        });
-        const response = await this.request('GET', endpoint);
-        return response.results ?? [];
+        return this.results.getResults(testId, options);
     }
     /**
      * Get results for a specific case within a run with optional filters.
@@ -485,19 +410,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getResultsForCase(runId, caseId, options) {
-        this.validateId(runId, 'runId');
-        this.validateId(caseId, 'caseId');
-        this.validatePaginationParams(options?.limit, options?.offset);
-        const endpoint = this.buildEndpoint(`get_results_for_case/${runId}/${caseId}`, {
-            created_after: options?.created_after,
-            created_before: options?.created_before,
-            created_by: this.serializeIdList(options?.created_by),
-            status_id: this.serializeIdList(options?.status_id),
-            limit: options?.limit,
-            offset: options?.offset,
-        });
-        const response = await this.request('GET', endpoint);
-        return response.results ?? [];
+        return this.results.getResultsForCase(runId, caseId, options);
     }
     /**
      * Get all results for a run with optional filters.
@@ -508,18 +421,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getResultsForRun(runId, options) {
-        this.validateId(runId, 'runId');
-        this.validatePaginationParams(options?.limit, options?.offset);
-        const endpoint = this.buildEndpoint(`get_results_for_run/${runId}`, {
-            created_after: options?.created_after,
-            created_before: options?.created_before,
-            created_by: this.serializeIdList(options?.created_by),
-            status_id: this.serializeIdList(options?.status_id),
-            limit: options?.limit,
-            offset: options?.offset,
-        });
-        const response = await this.request('GET', endpoint);
-        return response.results ?? [];
+        return this.results.getResultsForRun(runId, options);
     }
     /**
      * Add a result for a test.
@@ -527,8 +429,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async addResult(testId, payload) {
-        this.validateId(testId, 'testId');
-        return this.request('POST', `add_result/${testId}`, payload);
+        return this.results.addResult(testId, payload);
     }
     /**
      * Add a result for a specific case within a run.
@@ -536,9 +437,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async addResultForCase(runId, caseId, payload) {
-        this.validateId(runId, 'runId');
-        this.validateId(caseId, 'caseId');
-        return this.request('POST', `add_result_for_case/${runId}/${caseId}`, payload);
+        return this.results.addResultForCase(runId, caseId, payload);
     }
     /**
      * Add multiple results for cases in a run.
@@ -546,8 +445,7 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async addResultsForCases(runId, payload) {
-        this.validateId(runId, 'runId');
-        return this.request('POST', `add_results_for_cases/${runId}`, payload);
+        return this.results.addResultsForCases(runId, payload);
     }
     // ── Milestones ────────────────────────────────────────────────────────────
     /**
@@ -556,551 +454,594 @@ export class TestRailClient extends TestRailClientCore {
      * @throws {TestRailApiError} When the API request fails
      */
     async getMilestone(milestoneId) {
-        this.validateId(milestoneId, 'milestoneId');
-        return this.request('GET', `get_milestone/${milestoneId}`);
+        return this.milestones.getMilestone(milestoneId);
     }
     /**
-     * Get all milestones for a project with optional filters.
-     * @param projectId - The project ID
-     * @param options - Optional filter parameters (is_completed, limit, offset)
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Get milestones.
+     *
+     * @param projectId - Project identifier.
+     * @param options - Optional filters and pagination settings.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getMilestones(projectId, options) {
-        this.validateId(projectId, 'projectId');
-        this.validatePaginationParams(options?.limit, options?.offset);
-        const endpoint = this.buildEndpoint(`get_milestones/${projectId}`, {
-            is_completed: options?.is_completed,
-            limit: options?.limit,
-            offset: options?.offset,
-        });
-        const response = await this.request('GET', endpoint);
-        return response.milestones ?? [];
-    }
-    /**
-     * Add a new milestone to a project.
-     * @throws {TestRailValidationError} When projectId is invalid
+        return this.milestones.getMilestones(projectId, options);
+    }
+    /**
+     * Add milestone.
+     *
+     * @param projectId - Project identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addMilestone(projectId, payload) {
-        this.validateId(projectId, 'projectId');
-        return this.request('POST', `add_milestone/${projectId}`, payload);
+        return this.milestones.addMilestone(projectId, payload);
     }
     /**
-     * Update an existing milestone.
-     * @throws {TestRailValidationError} When milestoneId is invalid
+     * Update milestone.
+     *
+     * @param milestoneId - Milestone identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async updateMilestone(milestoneId, payload) {
-        this.validateId(milestoneId, 'milestoneId');
-        return this.request('POST', `update_milestone/${milestoneId}`, payload);
+        return this.milestones.updateMilestone(milestoneId, payload);
     }
     /**
-     * Delete a milestone.
-     * @throws {TestRailValidationError} When milestoneId is invalid
+     * Delete milestone.
+     *
+     * @param milestoneId - Milestone identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteMilestone(milestoneId) {
-        this.validateId(milestoneId, 'milestoneId');
-        await this.request('POST', `delete_milestone/${milestoneId}`);
+        return this.milestones.deleteMilestone(milestoneId);
     }
     // ── Users ─────────────────────────────────────────────────────────────────
     /**
-     * Get a user by ID.
-     * @throws {TestRailValidationError} When userId is invalid
+     * Get user.
+     *
+     * @param userId - User identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getUser(userId) {
-        this.validateId(userId, 'userId');
-        return this.request('GET', `get_user/${userId}`);
+        return this.users.getUser(userId);
     }
     /**
-     * Get a user by email address.
+     * Get user by email.
+     *
+     * @param email - Email address to look up.
      * @throws {TestRailValidationError} When email format is invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getUserByEmail(email) {
-        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-        if (!emailRegex.test(email)) {
-            throw new TestRailValidationError('Invalid email format');
-        }
-        // buildEndpoint now encodes all values via encodeURIComponent internally.
-        return this.request('GET', this.buildEndpoint('get_user_by_email', { email }));
+        return this.users.getUserByEmail(email);
     }
     /**
-     * Get all users, optionally scoped to a project.
-     * @param limit - Maximum number of users to return
-     * @param offset - Number of users to skip
-     * @param projectId - When provided, returns only users with access to the specified project
-     * @throws {TestRailValidationError} When pagination or projectId is invalid
+     * Get users.
+     *
+     * @param limit - Optional maximum number of results to return.
+     * @param offset - Optional number of results to skip before returning results.
+     * @param projectId - Optional project identifier to scope results when provided.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getUsers(limit, offset, projectId) {
-        this.validatePaginationParams(limit, offset);
-        if (projectId !== undefined) {
-            this.validateId(projectId, 'projectId');
-        }
-        const endpoint = this.buildEndpoint(projectId !== undefined ? `get_users/${projectId}` : 'get_users', {
-            limit,
-            offset,
-        });
-        const response = await this.request('GET', endpoint);
-        return response.users ?? [];
+        return this.users.getUsers(limit, offset, projectId);
     }
     /**
      * Get the currently authenticated user.
      * @throws {TestRailApiError} When the API request fails
      */
     async getCurrentUser() {
-        return this.request('GET', 'get_current_user');
+        return this.users.getCurrentUser();
+    }
+    /**
+     * Add user.
+     *
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailApiError} When the API request fails
+     */
+    async addUser(payload) {
+        return this.users.addUser(payload);
+    }
+    /**
+     * Update user.
+     *
+     * @param userId - User identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
+     * @throws {TestRailApiError} When the API request fails
+     */
+    async updateUser(userId, payload) {
+        return this.users.updateUser(userId, payload);
     }
     // ── Statuses ──────────────────────────────────────────────────────────────
     /**
-     * Get all test statuses.
+     * Get statuses.
      * @throws {TestRailApiError} When the API request fails
      */
     async getStatuses() {
-        return this.request('GET', 'get_statuses');
+        return this.metadata.getStatuses();
     }
     // ── Priorities ────────────────────────────────────────────────────────────
     /**
-     * Get all case priorities.
+     * Get priorities.
      * @throws {TestRailApiError} When the API request fails
      */
     async getPriorities() {
-        return this.request('GET', 'get_priorities');
+        return this.metadata.getPriorities();
     }
     // ── Result Fields ─────────────────────────────────────────────────────────
     /**
-     * Get all available custom result fields.
+     * Get result fields.
      * @throws {TestRailApiError} When the API request fails
      */
     async getResultFields() {
-        return this.request('GET', 'get_result_fields');
+        return this.metadata.getResultFields();
     }
     // ── Case Fields & Types ───────────────────────────────────────────────────
     /**
-     * Get all available custom case fields.
+     * Get case fields.
      * @throws {TestRailApiError} When the API request fails
      */
     async getCaseFields() {
-        return this.request('GET', 'get_case_fields');
+        return this.metadata.getCaseFields();
     }
     /**
-     * Get all available case types.
+     * Get case types.
      * @throws {TestRailApiError} When the API request fails
      */
     async getCaseTypes() {
-        return this.request('GET', 'get_case_types');
+        return this.metadata.getCaseTypes();
     }
     // ── Templates ─────────────────────────────────────────────────────────────
     /**
-     * Get all available case templates for a project (requires TestRail 5.2+).
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Get templates.
+     *
+     * @param projectId - Project identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getTemplates(projectId) {
-        this.validateId(projectId, 'projectId');
-        return this.request('GET', `get_templates/${projectId}`);
+        return this.metadata.getTemplates(projectId);
     }
     // ── Configurations ────────────────────────────────────────────────────────
     /**
-     * Get all configuration groups and their configurations for a project.
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Get configurations.
+     *
+     * @param projectId - Project identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getConfigurations(projectId) {
-        this.validateId(projectId, 'projectId');
-        return this.request('GET', `get_configs/${projectId}`);
+        return this.configurations.getConfigurations(projectId);
     }
     /**
-     * Add a new configuration group to a project.
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Add configuration group.
+     *
+     * @param projectId - Project identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addConfigurationGroup(projectId, payload) {
-        this.validateId(projectId, 'projectId');
-        return this.request('POST', `add_config_group/${projectId}`, payload);
+        return this.configurations.addConfigurationGroup(projectId, payload);
     }
     /**
-     * Update an existing configuration group.
-     * @throws {TestRailValidationError} When configGroupId is invalid
+     * Update configuration group.
+     *
+     * @param configGroupId - Config group identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async updateConfigurationGroup(configGroupId, payload) {
-        this.validateId(configGroupId, 'configGroupId');
-        return this.request('POST', `update_config_group/${configGroupId}`, payload);
+        return this.configurations.updateConfigurationGroup(configGroupId, payload);
     }
     /**
-     * Delete an existing configuration group and all its configurations.
-     * @throws {TestRailValidationError} When configGroupId is invalid
+     * Delete configuration group.
+     *
+     * @param configGroupId - Config group identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteConfigurationGroup(configGroupId) {
-        this.validateId(configGroupId, 'configGroupId');
-        await this.request('POST', `delete_config_group/${configGroupId}`);
+        return this.configurations.deleteConfigurationGroup(configGroupId);
     }
     /**
-     * Add a new configuration to a configuration group.
-     * @throws {TestRailValidationError} When configGroupId is invalid
+     * Add configuration.
+     *
+     * @param configGroupId - Config group identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addConfiguration(configGroupId, payload) {
-        this.validateId(configGroupId, 'configGroupId');
-        return this.request('POST', `add_config/${configGroupId}`, payload);
+        return this.configurations.addConfiguration(configGroupId, payload);
     }
     /**
-     * Update an existing configuration.
-     * @throws {TestRailValidationError} When configId is invalid
+     * Update configuration.
+     *
+     * @param configId - Config identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async updateConfiguration(configId, payload) {
-        this.validateId(configId, 'configId');
-        return this.request('POST', `update_config/${configId}`, payload);
+        return this.configurations.updateConfiguration(configId, payload);
     }
     /**
-     * Delete an existing configuration.
-     * @throws {TestRailValidationError} When configId is invalid
+     * Delete configuration.
+     *
+     * @param configId - Config identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteConfiguration(configId) {
-        this.validateId(configId, 'configId');
-        await this.request('POST', `delete_config/${configId}`);
-    }
-    // ── User Management (TASK-024, requires TestRail 7.3+) ────────────────────
-    /**
-     * Create a new TestRail user (requires TestRail 7.3+).
-     * @throws {TestRailApiError} When the API request fails
-     */
-    async addUser(payload) {
-        return this.request('POST', 'add_user', payload);
-    }
-    /**
-     * Update an existing TestRail user (requires TestRail 7.3+).
-     * @throws {TestRailValidationError} When userId is invalid
-     * @throws {TestRailApiError} When the API request fails
-     */
-    async updateUser(userId, payload) {
-        this.validateId(userId, 'userId');
-        return this.request('POST', `update_user/${userId}`, payload);
+        return this.configurations.deleteConfiguration(configId);
     }
-    // ── Roles (TASK-025, requires TestRail 7.3+) ──────────────────────────────
+    // ── Roles ─────────────────────────────────────────────────────────────────
     /**
-     * Get all available user roles (requires TestRail 7.3+).
+     * Get roles.
      * @throws {TestRailApiError} When the API request fails
      */
     async getRoles() {
-        return this.request('GET', 'get_roles');
+        return this.metadata.getRoles();
     }
-    // ── Groups (TASK-026, requires TestRail 7.5+) ─────────────────────────────
+    // ── Groups ────────────────────────────────────────────────────────────────
     /**
-     * Get a single group by ID (requires TestRail 7.5+).
-     * @throws {TestRailValidationError} When groupId is invalid
+     * Get group.
+     *
+     * @param groupId - Group identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getGroup(groupId) {
-        this.validateId(groupId, 'groupId');
-        return this.request('GET', `get_group/${groupId}`);
+        return this.users.getGroup(groupId);
     }
     /**
-     * Get all groups (requires TestRail 7.5+).
+     * Get groups.
      * @throws {TestRailApiError} When the API request fails
      */
     async getGroups() {
-        return this.request('GET', 'get_groups');
+        return this.users.getGroups();
     }
     /**
-     * Create a new group (requires TestRail 7.5+).
+     * Add group.
+     *
+     * @param payload - Request payload for this operation.
      * @throws {TestRailApiError} When the API request fails
      */
     async addGroup(payload) {
-        return this.request('POST', 'add_group', payload);
+        return this.users.addGroup(payload);
     }
     /**
-     * Update an existing group (requires TestRail 7.5+).
-     * @throws {TestRailValidationError} When groupId is invalid
+     * Update group.
+     *
+     * @param groupId - Group identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async updateGroup(groupId, payload) {
-        this.validateId(groupId, 'groupId');
-        return this.request('POST', `update_group/${groupId}`, payload);
+        return this.users.updateGroup(groupId, payload);
     }
     /**
-     * Delete a group (requires TestRail 7.5+).
-     * @throws {TestRailValidationError} When groupId is invalid
+     * Delete group.
+     *
+     * @param groupId - Group identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteGroup(groupId) {
-        this.validateId(groupId, 'groupId');
-        await this.request('POST', `delete_group/${groupId}`);
+        return this.users.deleteGroup(groupId);
     }
-    // ── Attachments (TASK-027) ────────────────────────────────────────────────
+    // ── Attachments ───────────────────────────────────────────────────────────
     /**
-     * Get all attachments for a test case.
-     * @throws {TestRailValidationError} When caseId is invalid
+     * Get attachments for case.
+     *
+     * @param caseId - Case identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getAttachmentsForCase(caseId) {
-        this.validateId(caseId, 'caseId');
-        const response = await this.request('GET', `get_attachments_for_case/${caseId}`);
-        return response.attachments ?? [];
+        return this.attachments.getAttachmentsForCase(caseId);
     }
     /**
-     * Get all attachments for a test run.
-     * @throws {TestRailValidationError} When runId is invalid
+     * Get attachments for run.
+     *
+     * @param runId - Run identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getAttachmentsForRun(runId) {
-        this.validateId(runId, 'runId');
-        const response = await this.request('GET', `get_attachments_for_run/${runId}`);
-        return response.attachments ?? [];
+        return this.attachments.getAttachmentsForRun(runId);
     }
     /**
-     * Get all attachments for a test.
-     * @throws {TestRailValidationError} When testId is invalid
+     * Get attachments for test.
+     *
+     * @param testId - Test identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getAttachmentsForTest(testId) {
-        this.validateId(testId, 'testId');
-        const response = await this.request('GET', `get_attachments_for_test/${testId}`);
-        return response.attachments ?? [];
+        return this.attachments.getAttachmentsForTest(testId);
     }
     /**
-     * Get all attachments for a test plan.
-     * @throws {TestRailValidationError} When planId is invalid
+     * Get attachments for plan.
+     *
+     * @param planId - Plan identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getAttachmentsForPlan(planId) {
-        this.validateId(planId, 'planId');
-        const response = await this.request('GET', `get_attachments_for_plan/${planId}`);
-        return response.attachments ?? [];
+        return this.attachments.getAttachmentsForPlan(planId);
     }
     /**
-     * Get all attachments for a specific plan entry.
-     * @throws {TestRailValidationError} When planId or entryId is invalid
+     * Get attachments for plan entry.
+     *
+     * @param planId - Plan identifier.
+     * @param entryId - Plan entry identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getAttachmentsForPlanEntry(planId, entryId) {
-        this.validateId(planId, 'planId');
-        this.validateId(entryId, 'entryId');
-        const response = await this.request('GET', `get_attachments_for_plan_entry/${planId}/${entryId}`);
-        return response.attachments ?? [];
+        return this.attachments.getAttachmentsForPlanEntry(planId, entryId);
     }
     /**
-     * Download the raw binary content of an attachment.
-     * @param attachmentId - The attachment ID (numeric)
-     * @throws {TestRailValidationError} When attachmentId is invalid
+     * Download an attachment by ID.
+     *
+     * @param attachmentId - Attachment identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getAttachment(attachmentId) {
-        this.validateId(attachmentId, 'attachmentId');
-        return this.requestBinary(`get_attachment/${attachmentId}`);
+        return this.attachments.getAttachment(attachmentId);
     }
     /**
-     * Upload a file attachment to a test case.
-     * @throws {TestRailValidationError} When caseId is invalid
+     * Add attachment to case.
+     *
+     * @param caseId - Case identifier.
+     * @param file - Attachment contents to upload.
+     * @param filename - Filename to send with the uploaded attachment.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addAttachmentToCase(caseId, file, filename) {
-        this.validateId(caseId, 'caseId');
-        return this.requestMultipart(`add_attachment_to_case/${caseId}`, file, filename);
+        return this.attachments.addAttachmentToCase(caseId, file, filename);
     }
     /**
-     * Upload a file attachment to a test result.
-     * @throws {TestRailValidationError} When resultId is invalid
+     * Add attachment to result.
+     *
+     * @param resultId - Result identifier.
+     * @param file - Attachment contents to upload.
+     * @param filename - Filename to send with the uploaded attachment.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addAttachmentToResult(resultId, file, filename) {
-        this.validateId(resultId, 'resultId');
-        return this.requestMultipart(`add_attachment_to_result/${resultId}`, file, filename);
+        return this.attachments.addAttachmentToResult(resultId, file, filename);
     }
     /**
-     * Upload a file attachment to a test run.
-     * @throws {TestRailValidationError} When runId is invalid
+     * Add attachment to run.
+     *
+     * @param runId - Run identifier.
+     * @param file - Attachment contents to upload.
+     * @param filename - Filename to send with the uploaded attachment.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addAttachmentToRun(runId, file, filename) {
-        this.validateId(runId, 'runId');
-        return this.requestMultipart(`add_attachment_to_run/${runId}`, file, filename);
+        return this.attachments.addAttachmentToRun(runId, file, filename);
     }
     /**
-     * Upload a file attachment to a test plan (requires TestRail 6.5.2+).
-     * @throws {TestRailValidationError} When planId is invalid
+     * Add attachment to plan.
+     *
+     * @param planId - Plan identifier.
+     * @param file - Attachment contents to upload.
+     * @param filename - Filename to send with the uploaded attachment.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addAttachmentToPlan(planId, file, filename) {
-        this.validateId(planId, 'planId');
-        return this.requestMultipart(`add_attachment_to_plan/${planId}`, file, filename);
+        return this.attachments.addAttachmentToPlan(planId, file, filename);
     }
     /**
-     * Upload a file attachment to a specific plan entry (requires TestRail 6.5.2+).
-     * @throws {TestRailValidationError} When planId or entryId is invalid
+     * Add attachment to plan entry.
+     *
+     * @param planId - Plan identifier.
+     * @param entryId - Plan entry identifier.
+     * @param file - Attachment contents to upload.
+     * @param filename - Filename to send with the uploaded attachment.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addAttachmentToPlanEntry(planId, entryId, file, filename) {
-        this.validateId(planId, 'planId');
-        this.validateId(entryId, 'entryId');
-        return this.requestMultipart(`add_attachment_to_plan_entry/${planId}/${entryId}`, file, filename);
+        return this.attachments.addAttachmentToPlanEntry(planId, entryId, file, filename);
     }
     /**
-     * Delete an attachment by ID.
-     * @throws {TestRailValidationError} When attachmentId is invalid
+     * Delete attachment.
+     *
+     * @param attachmentId - Attachment identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteAttachment(attachmentId) {
-        this.validateId(attachmentId, 'attachmentId');
-        await this.request('POST', `delete_attachment/${attachmentId}`);
+        return this.attachments.deleteAttachment(attachmentId);
     }
-    // ── Shared Steps (TASK-028, requires TestRail 7.0+) ───────────────────────
+    // ── Shared Steps ──────────────────────────────────────────────────────────
     /**
-     * Get a single shared step by ID (requires TestRail 7.0+).
-     * @throws {TestRailValidationError} When sharedStepId is invalid
+     * Get shared step.
+     *
+     * @param sharedStepId - Shared step identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getSharedStep(sharedStepId) {
-        this.validateId(sharedStepId, 'sharedStepId');
-        return this.request('GET', `get_shared_step/${sharedStepId}`);
+        return this.sharedSteps.getSharedStep(sharedStepId);
     }
     /**
-     * Get all shared steps for a project (requires TestRail 7.0+).
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Get shared steps.
+     *
+     * @param projectId - Project identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getSharedSteps(projectId) {
-        this.validateId(projectId, 'projectId');
-        return this.request('GET', `get_shared_steps/${projectId}`);
+        return this.sharedSteps.getSharedSteps(projectId);
     }
     /**
-     * Create a new shared step in a project (requires TestRail 7.0+).
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Add shared step.
+     *
+     * @param projectId - Project identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addSharedStep(projectId, payload) {
-        this.validateId(projectId, 'projectId');
-        return this.request('POST', `add_shared_step/${projectId}`, payload);
+        return this.sharedSteps.addSharedStep(projectId, payload);
     }
     /**
-     * Update an existing shared step (requires TestRail 7.0+).
-     * @throws {TestRailValidationError} When sharedStepId is invalid
+     * Update shared step.
+     *
+     * @param sharedStepId - Shared step identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async updateSharedStep(sharedStepId, payload) {
-        this.validateId(sharedStepId, 'sharedStepId');
-        return this.request('POST', `update_shared_step/${sharedStepId}`, payload);
+        return this.sharedSteps.updateSharedStep(sharedStepId, payload);
     }
     /**
-     * Delete a shared step (requires TestRail 7.0+).
-     * @throws {TestRailValidationError} When sharedStepId is invalid
+     * Delete shared step.
+     *
+     * @param sharedStepId - Shared step identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteSharedStep(sharedStepId) {
-        this.validateId(sharedStepId, 'sharedStepId');
-        await this.request('POST', `delete_shared_step/${sharedStepId}`);
+        return this.sharedSteps.deleteSharedStep(sharedStepId);
     }
-    // ── Variables (TASK-029) ──────────────────────────────────────────────────
+    // ── Variables ─────────────────────────────────────────────────────────────
     /**
-     * Get all variables for a project.
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Get variables.
+     *
+     * @param projectId - Project identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getVariables(projectId) {
-        this.validateId(projectId, 'projectId');
-        return this.request('GET', `get_variables/${projectId}`);
+        return this.variables.getVariables(projectId);
     }
     /**
-     * Create a new variable in a project.
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Add variable.
+     *
+     * @param projectId - Project identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addVariable(projectId, payload) {
-        this.validateId(projectId, 'projectId');
-        return this.request('POST', `add_variable/${projectId}`, payload);
+        return this.variables.addVariable(projectId, payload);
     }
     /**
-     * Update an existing variable.
-     * @throws {TestRailValidationError} When variableId is invalid
+     * Update variable.
+     *
+     * @param variableId - Variable identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async updateVariable(variableId, payload) {
-        this.validateId(variableId, 'variableId');
-        return this.request('POST', `update_variable/${variableId}`, payload);
+        return this.variables.updateVariable(variableId, payload);
     }
     /**
-     * Delete a variable.
-     * @throws {TestRailValidationError} When variableId is invalid
+     * Delete variable.
+     *
+     * @param variableId - Variable identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteVariable(variableId) {
-        this.validateId(variableId, 'variableId');
-        await this.request('POST', `delete_variable/${variableId}`);
+        return this.variables.deleteVariable(variableId);
     }
-    // ── Datasets (TASK-030) ───────────────────────────────────────────────────
+    // ── Datasets ──────────────────────────────────────────────────────────────
     /**
-     * Get a single dataset by ID.
-     * @throws {TestRailValidationError} When datasetId is invalid
+     * Get dataset.
+     *
+     * @param datasetId - Dataset identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getDataset(datasetId) {
-        this.validateId(datasetId, 'datasetId');
-        return this.request('GET', `get_dataset/${datasetId}`);
+        return this.datasets.getDataset(datasetId);
     }
     /**
-     * Get all datasets for a project.
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Get datasets.
+     *
+     * @param projectId - Project identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getDatasets(projectId) {
-        this.validateId(projectId, 'projectId');
-        return this.request('GET', `get_datasets/${projectId}`);
+        return this.datasets.getDatasets(projectId);
     }
     /**
-     * Create a new dataset in a project.
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Add dataset.
+     *
+     * @param projectId - Project identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async addDataset(projectId, payload) {
-        this.validateId(projectId, 'projectId');
-        return this.request('POST', `add_dataset/${projectId}`, payload);
+        return this.datasets.addDataset(projectId, payload);
     }
     /**
-     * Update an existing dataset.
-     * @throws {TestRailValidationError} When datasetId is invalid
+     * Update dataset.
+     *
+     * @param datasetId - Dataset identifier.
+     * @param payload - Request payload for this operation.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async updateDataset(datasetId, payload) {
-        this.validateId(datasetId, 'datasetId');
-        return this.request('POST', `update_dataset/${datasetId}`, payload);
+        return this.datasets.updateDataset(datasetId, payload);
     }
     /**
-     * Delete a dataset.
-     * @throws {TestRailValidationError} When datasetId is invalid
+     * Delete dataset.
+     *
+     * @param datasetId - Dataset identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async deleteDataset(datasetId) {
-        this.validateId(datasetId, 'datasetId');
-        await this.request('POST', `delete_dataset/${datasetId}`);
+        return this.datasets.deleteDataset(datasetId);
     }
-    // ── Reports (TASK-031) ────────────────────────────────────────────────────
+    // ── Reports ───────────────────────────────────────────────────────────────
     /**
-     * Get all available report templates for a project.
-     * @throws {TestRailValidationError} When projectId is invalid
+     * Get reports.
+     *
+     * @param projectId - Project identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async getReports(projectId) {
-        this.validateId(projectId, 'projectId');
-        return this.request('GET', `get_reports/${projectId}`);
+        return this.reports.getReports(projectId);
     }
     /**
-     * Execute a report template and return URLs to the generated output.
-     * @throws {TestRailValidationError} When reportTemplateId is invalid
+     * Run report.
+     *
+     * @param reportTemplateId - Report template identifier.
+     * @throws {TestRailValidationError} When identifiers or request parameters are invalid
      * @throws {TestRailApiError} When the API request fails
      */
     async runReport(reportTemplateId) {
-        this.validateId(reportTemplateId, 'reportTemplateId');
-        return this.request('GET', `run_report/${reportTemplateId}`);
-    }
-    serializeIdList(ids) {
-        return ids !== undefined && ids.length > 0 ? ids.join(',') : undefined;
+        return this.reports.runReport(reportTemplateId);
     }
 }
 //# sourceMappingURL=client.js.map