specweave 0.13.6 → 0.15.0

package/dist/plugins/specweave-ado/lib/ado-client.js

@@ -0,0 +1,257 @@
+/**
+ * Azure DevOps REST API Client
+ *
+ * Provides TypeScript interface to Azure DevOps REST API v7.1
+ * for work item management and SpecWeave integration.
+ *
+ * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/
+ */
+import https from 'https';
+// ============================================================================
+// Azure DevOps Client
+// ============================================================================
+export class AdoClient {
+    constructor(config) {
+        this.config = config;
+        this.baseUrl = `https://dev.azure.com/${config.organization}/${config.project}`;
+        // Basic Auth: base64(":PAT")
+        this.authHeader = 'Basic ' + Buffer.from(`:${config.personalAccessToken}`).toString('base64');
+    }
+    // ==========================================================================
+    // Work Item Operations
+    // ==========================================================================
+    /**
+     * Create a new work item
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/create
+     */
+    async createWorkItem(request) {
+        const workItemType = this.config.workItemType || 'Epic';
+        const url = `${this.baseUrl}/_apis/wit/workitems/$${workItemType}?api-version=7.1`;
+        // Build JSON Patch document
+        const operations = [
+            {
+                op: 'add',
+                path: '/fields/System.Title',
+                value: request.title,
+            },
+        ];
+        if (request.description) {
+            operations.push({
+                op: 'add',
+                path: '/fields/System.Description',
+                value: `<pre>${request.description}</pre>`,
+            });
+        }
+        if (request.areaPath || this.config.areaPath) {
+            operations.push({
+                op: 'add',
+                path: '/fields/System.AreaPath',
+                value: request.areaPath || this.config.areaPath,
+            });
+        }
+        if (request.iterationPath || this.config.iterationPath) {
+            operations.push({
+                op: 'add',
+                path: '/fields/System.IterationPath',
+                value: request.iterationPath || this.config.iterationPath,
+            });
+        }
+        if (request.tags && request.tags.length > 0) {
+            operations.push({
+                op: 'add',
+                path: '/fields/System.Tags',
+                value: request.tags.join('; '),
+            });
+        }
+        const response = await this.request('POST', url, operations, {
+            'Content-Type': 'application/json-patch+json',
+        });
+        return response;
+    }
+    /**
+     * Get work item by ID
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/get-work-item
+     */
+    async getWorkItem(id) {
+        const url = `${this.baseUrl}/_apis/wit/workitems/${id}?api-version=7.1`;
+        return this.request('GET', url);
+    }
+    /**
+     * Update work item
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/update
+     */
+    async updateWorkItem(id, request) {
+        const url = `${this.baseUrl}/_apis/wit/workitems/${id}?api-version=7.1`;
+        const operations = [];
+        if (request.state) {
+            operations.push({
+                op: 'add',
+                path: '/fields/System.State',
+                value: request.state,
+            });
+        }
+        if (request.title) {
+            operations.push({
+                op: 'add',
+                path: '/fields/System.Title',
+                value: request.title,
+            });
+        }
+        if (request.description) {
+            operations.push({
+                op: 'add',
+                path: '/fields/System.Description',
+                value: `<pre>${request.description}</pre>`,
+            });
+        }
+        if (request.tags) {
+            operations.push({
+                op: 'add',
+                path: '/fields/System.Tags',
+                value: request.tags.join('; '),
+            });
+        }
+        return this.request('PATCH', url, operations, {
+            'Content-Type': 'application/json-patch+json',
+        });
+    }
+    /**
+     * Delete work item (move to Recycle Bin)
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/delete
+     */
+    async deleteWorkItem(id) {
+        const url = `${this.baseUrl}/_apis/wit/workitems/${id}?api-version=7.1`;
+        await this.request('DELETE', url);
+    }
+    // ==========================================================================
+    // Comment Operations
+    // ==========================================================================
+    /**
+     * Add comment to work item
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/comments/add
+     */
+    async addComment(workItemId, text) {
+        const url = `${this.baseUrl}/_apis/wit/workitems/${workItemId}/comments?api-version=7.1`;
+        const response = await this.request('POST', url, { text });
+        return response;
+    }
+    /**
+     * Get comments for work item
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/comments/list
+     */
+    async getComments(workItemId) {
+        const url = `${this.baseUrl}/_apis/wit/workitems/${workItemId}/comments?api-version=7.1`;
+        const response = await this.request('GET', url);
+        return response.comments || [];
+    }
+    // ==========================================================================
+    // Helper Methods
+    // ==========================================================================
+    /**
+     * Make HTTP request to ADO API
+     */
+    async request(method, url, body, additionalHeaders) {
+        return new Promise((resolve, reject) => {
+            const urlObj = new URL(url);
+            const options = {
+                hostname: urlObj.hostname,
+                port: 443,
+                path: urlObj.pathname + urlObj.search,
+                method,
+                headers: {
+                    'Authorization': this.authHeader,
+                    'Accept': 'application/json',
+                    ...additionalHeaders,
+                },
+            };
+            const req = https.request(options, (res) => {
+                let data = '';
+                res.on('data', (chunk) => {
+                    data += chunk;
+                });
+                res.on('end', () => {
+                    if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                        try {
+                            const parsed = data ? JSON.parse(data) : {};
+                            resolve(parsed);
+                        }
+                        catch (error) {
+                            reject(new Error(`Failed to parse JSON response: ${error}`));
+                        }
+                    }
+                    else {
+                        let errorMessage = `ADO API error: ${res.statusCode} ${res.statusMessage}`;
+                        try {
+                            const errorData = JSON.parse(data);
+                            if (errorData.message) {
+                                errorMessage += ` - ${errorData.message}`;
+                            }
+                        }
+                        catch {
+                            // Ignore JSON parse errors for error responses
+                        }
+                        reject(new Error(errorMessage));
+                    }
+                });
+            });
+            req.on('error', (error) => {
+                reject(new Error(`HTTP request failed: ${error.message}`));
+            });
+            if (body) {
+                req.write(JSON.stringify(body));
+            }
+            req.end();
+        });
+    }
+    /**
+     * Test connection to ADO
+     */
+    async testConnection() {
+        try {
+            // Simple test: list work item types
+            const url = `${this.baseUrl}/_apis/wit/workitemtypes?api-version=7.1`;
+            await this.request('GET', url);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create ADO client from environment variables and config
+ */
+export function createAdoClient(config = {}) {
+    const fullConfig = {
+        organization: config.organization || process.env.AZURE_DEVOPS_ORG || '',
+        project: config.project || process.env.AZURE_DEVOPS_PROJECT || '',
+        personalAccessToken: config.personalAccessToken || process.env.AZURE_DEVOPS_PAT || '',
+        workItemType: config.workItemType,
+        areaPath: config.areaPath,
+        iterationPath: config.iterationPath,
+    };
+    if (!fullConfig.organization) {
+        throw new Error('ADO organization not configured');
+    }
+    if (!fullConfig.project) {
+        throw new Error('ADO project not configured');
+    }
+    if (!fullConfig.personalAccessToken) {
+        throw new Error('AZURE_DEVOPS_PAT not set');
+    }
+    return new AdoClient(fullConfig);
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export default AdoClient;
+//# sourceMappingURL=ado-client.js.map

package/dist/plugins/specweave-ado/lib/ado-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-client.js","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/ado-client.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-ado/lib/ado-hierarchical-sync.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Azure DevOps Hierarchical Sync Implementation
+ *
+ * Supports three sync strategies:
+ * 1. Simple: One project, all work items (backward compatible)
+ * 2. Filtered: Multiple projects + area paths + filters
+ * 3. Custom: Raw WIQL query
+ */
+import { SyncProfile, SyncContainer } from '../../../src/core/types/sync-profile.js';
+import { WorkItem } from './ado-client-v2.js';
+/**
+ * Build hierarchical WIQL query from containers
+ *
+ * Example output:
+ * SELECT [System.Id], [System.Title], [System.State]
+ * FROM WorkItems
+ * WHERE (
+ *   ([System.TeamProject] = 'PROJECT-A' AND [System.AreaPath] UNDER 'PROJECT-A\\Team Alpha')
+ *   OR
+ *   ([System.TeamProject] = 'PROJECT-B' AND [System.AreaPath] UNDER 'PROJECT-B\\Platform')
+ * )
+ * AND [System.WorkItemType] IN ('User Story', 'Bug')
+ * AND [System.State] IN ('Active', 'New')
+ *
+ * @param organization Organization name
+ * @param pat Personal Access Token
+ * @param containers Array of containers (projects) with filters
+ * @returns WIQL query string
+ */
+export declare function buildHierarchicalWIQL(organization: string, pat: string, containers: SyncContainer[]): Promise<string>;
+/**
+ * Fetch work items hierarchically based on sync strategy
+ *
+ * @param profile Sync profile with strategy
+ * @param pat Personal Access Token
+ * @param timeRange Time range preset
+ * @returns Array of work items
+ */
+export declare function fetchWorkItemsHierarchical(profile: SyncProfile, pat: string, timeRange?: string): Promise<WorkItem[]>;
+//# sourceMappingURL=ado-hierarchical-sync.d.ts.map

package/dist/plugins/specweave-ado/lib/ado-hierarchical-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-hierarchical-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/ado-hierarchical-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EAMd,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,aAAa,EAAE,GAC1B,OAAO,CAAC,MAAM,CAAC,CA+DjB;AAoID;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAqBrB"}

package/dist/plugins/specweave-ado/lib/ado-hierarchical-sync.js

@@ -0,0 +1,370 @@
+/**
+ * Azure DevOps Hierarchical Sync Implementation
+ *
+ * Supports three sync strategies:
+ * 1. Simple: One project, all work items (backward compatible)
+ * 2. Filtered: Multiple projects + area paths + filters
+ * 3. Custom: Raw WIQL query
+ */
+import { isSimpleStrategy, isFilteredStrategy, isCustomStrategy, } from '../../../src/core/types/sync-profile.js';
+import { getAreaPaths } from './ado-board-resolver.js';
+import https from 'https';
+/**
+ * Build hierarchical WIQL query from containers
+ *
+ * Example output:
+ * SELECT [System.Id], [System.Title], [System.State]
+ * FROM WorkItems
+ * WHERE (
+ *   ([System.TeamProject] = 'PROJECT-A' AND [System.AreaPath] UNDER 'PROJECT-A\\Team Alpha')
+ *   OR
+ *   ([System.TeamProject] = 'PROJECT-B' AND [System.AreaPath] UNDER 'PROJECT-B\\Platform')
+ * )
+ * AND [System.WorkItemType] IN ('User Story', 'Bug')
+ * AND [System.State] IN ('Active', 'New')
+ *
+ * @param organization Organization name
+ * @param pat Personal Access Token
+ * @param containers Array of containers (projects) with filters
+ * @returns WIQL query string
+ */
+export async function buildHierarchicalWIQL(organization, pat, containers) {
+    const projectClauses = [];
+    for (const container of containers) {
+        const parts = [];
+        // Project clause
+        parts.push(`[System.TeamProject] = '${container.id}'`);
+        // Area path filtering (sub-organizations)
+        if (container.subOrganizations && container.subOrganizations.length > 0) {
+            try {
+                const areaPaths = await getAreaPaths(organization, container.id, pat, container.subOrganizations);
+                if (areaPaths.length > 0) {
+                    const areaPathClauses = areaPaths
+                        .map((path) => `[System.AreaPath] UNDER '${path}'`)
+                        .join(' OR ');
+                    parts.push(`(${areaPathClauses})`);
+                }
+                else {
+                    console.warn(`⚠️  No valid area paths found for project ${container.id}, syncing all areas`);
+                }
+            }
+            catch (error) {
+                console.warn(`⚠️  Failed to resolve area paths for ${container.id}, syncing all areas:`, error.message);
+            }
+        }
+        // Combine parts with AND
+        projectClauses.push(`(${parts.join(' AND ')})`);
+    }
+    // Build WHERE clause with project clauses
+    let whereClause = projectClauses.join(' OR ');
+    // Add global filters (apply to all projects)
+    const filters = containers[0]?.filters;
+    if (filters) {
+        const filterClauses = buildFilterClauses(filters);
+        if (filterClauses.length > 0) {
+            whereClause = `(${whereClause}) AND ${filterClauses.join(' AND ')}`;
+        }
+    }
+    // Build complete WIQL query
+    return `
+    SELECT [System.Id], [System.Title], [System.Description], [System.State],
+           [System.CreatedDate], [System.ChangedDate], [System.WorkItemType],
+           [System.AreaPath], [System.IterationPath], [System.Tags]
+    FROM WorkItems
+    WHERE ${whereClause}
+    ORDER BY [System.CreatedDate] DESC
+  `.trim();
+}
+/**
+ * Build filter clauses from container filters
+ *
+ * @param filters Container filters
+ * @returns Array of WIQL filter clauses
+ */
+function buildFilterClauses(filters) {
+    const clauses = [];
+    // Work item types (ADO-specific)
+    if (filters.workItemTypes && filters.workItemTypes.length > 0) {
+        const types = filters.workItemTypes.map((t) => `'${t}'`).join(', ');
+        clauses.push(`[System.WorkItemType] IN (${types})`);
+    }
+    // Status categories (ADO uses State field)
+    if (filters.statusCategories && filters.statusCategories.length > 0) {
+        const states = filters.statusCategories.map((s) => `'${s}'`).join(', ');
+        clauses.push(`[System.State] IN (${states})`);
+    }
+    // Area paths (additional filtering beyond sub-organizations)
+    if (filters.areaPaths && filters.areaPaths.length > 0) {
+        const areaPathClauses = filters.areaPaths
+            .map((path) => `[System.AreaPath] UNDER '${path}'`)
+            .join(' OR ');
+        clauses.push(`(${areaPathClauses})`);
+    }
+    // Iteration paths (sprints in ADO)
+    if (filters.iterationPaths && filters.iterationPaths.length > 0) {
+        const iterationClauses = filters.iterationPaths
+            .map((path) => `[System.IterationPath] UNDER '${path}'`)
+            .join(' OR ');
+        clauses.push(`(${iterationClauses})`);
+    }
+    // Tags (labels in ADO)
+    if (filters.includeLabels && filters.includeLabels.length > 0) {
+        const tagClauses = filters.includeLabels
+            .map((tag) => `[System.Tags] CONTAINS '${tag}'`)
+            .join(' OR ');
+        clauses.push(`(${tagClauses})`);
+    }
+    // Exclude labels/tags
+    if (filters.excludeLabels && filters.excludeLabels.length > 0) {
+        for (const tag of filters.excludeLabels) {
+            clauses.push(`NOT [System.Tags] CONTAINS '${tag}'`);
+        }
+    }
+    // Assignees (assigned to)
+    if (filters.assignees && filters.assignees.length > 0) {
+        const assigneeClauses = filters.assignees
+            .map((assignee) => `[System.AssignedTo] = '${assignee}'`)
+            .join(' OR ');
+        clauses.push(`(${assigneeClauses})`);
+    }
+    return clauses;
+}
+/**
+ * Add time range filter to WIQL query
+ *
+ * @param wiql Base WIQL query
+ * @param timeRange Time range preset (1W, 1M, 3M, 6M, ALL)
+ * @returns WIQL with time range filter
+ */
+function addTimeRangeFilter(wiql, timeRange) {
+    if (timeRange === 'ALL') {
+        return wiql; // No time filter
+    }
+    const { since, until } = calculateTimeRange(timeRange);
+    // Add time range to WHERE clause
+    const timeFilter = `[System.CreatedDate] >= '${since}' AND [System.CreatedDate] <= '${until}'`;
+    // Insert before ORDER BY if present, otherwise append
+    if (wiql.includes('ORDER BY')) {
+        return wiql.replace('ORDER BY', `AND ${timeFilter} ORDER BY`);
+    }
+    else {
+        return `${wiql} AND ${timeFilter}`;
+    }
+}
+/**
+ * Calculate date range from time range preset
+ */
+function calculateTimeRange(timeRange) {
+    const now = new Date();
+    const since = new Date(now);
+    switch (timeRange) {
+        case '1W':
+            since.setDate(now.getDate() - 7);
+            break;
+        case '2W':
+            since.setDate(now.getDate() - 14);
+            break;
+        case '1M':
+            since.setMonth(now.getMonth() - 1);
+            break;
+        case '3M':
+            since.setMonth(now.getMonth() - 3);
+            break;
+        case '6M':
+            since.setMonth(now.getMonth() - 6);
+            break;
+        case '1Y':
+            since.setFullYear(now.getFullYear() - 1);
+            break;
+        case 'ALL':
+            return {
+                since: '1970-01-01T00:00:00Z',
+                until: now.toISOString(),
+            };
+    }
+    return {
+        since: since.toISOString(),
+        until: now.toISOString(),
+    };
+}
+/**
+ * Fetch work items hierarchically based on sync strategy
+ *
+ * @param profile Sync profile with strategy
+ * @param pat Personal Access Token
+ * @param timeRange Time range preset
+ * @returns Array of work items
+ */
+export async function fetchWorkItemsHierarchical(profile, pat, timeRange = '1M') {
+    const config = profile.config;
+    // Strategy 1: SIMPLE (backward compatible)
+    if (isSimpleStrategy(profile)) {
+        return fetchWorkItemsSimple(config, pat, timeRange);
+    }
+    // Strategy 2: CUSTOM (raw WIQL)
+    if (isCustomStrategy(profile)) {
+        return fetchWorkItemsCustom(config, pat, timeRange);
+    }
+    // Strategy 3: FILTERED (hierarchical)
+    if (isFilteredStrategy(profile)) {
+        return fetchWorkItemsFiltered(config, pat, timeRange);
+    }
+    // Default to simple if strategy not recognized
+    console.warn('⚠️  Unknown strategy, defaulting to simple');
+    return fetchWorkItemsSimple(config, pat, timeRange);
+}
+/**
+ * Fetch work items using SIMPLE strategy (one project, all work items)
+ *
+ * @param config ADO configuration
+ * @param pat Personal Access Token
+ * @param timeRange Time range preset
+ * @returns Array of work items
+ */
+async function fetchWorkItemsSimple(config, pat, timeRange) {
+    const organization = config.organization;
+    const project = config.project;
+    if (!project) {
+        throw new Error('Simple strategy requires project in config');
+    }
+    let wiql = `
+    SELECT [System.Id], [System.Title], [System.State], [System.CreatedDate]
+    FROM WorkItems
+    WHERE [System.TeamProject] = '${project}'
+  `.trim();
+    // Add time range
+    wiql = addTimeRangeFilter(wiql, timeRange);
+    console.log('🔍 Fetching work items (SIMPLE strategy):', wiql);
+    return executeQuery(organization, project, pat, wiql);
+}
+/**
+ * Fetch work items using CUSTOM strategy (raw WIQL)
+ *
+ * @param config ADO configuration
+ * @param pat Personal Access Token
+ * @param timeRange Time range preset
+ * @returns Array of work items
+ */
+async function fetchWorkItemsCustom(config, pat, timeRange) {
+    const organization = config.organization;
+    const project = config.project || 'DefaultProject';
+    const customQuery = config.customQuery;
+    if (!customQuery) {
+        throw new Error('Custom strategy requires customQuery in config');
+    }
+    // Add time range to custom query
+    const wiql = addTimeRangeFilter(customQuery, timeRange);
+    console.log('🔍 Fetching work items (CUSTOM strategy):', wiql);
+    return executeQuery(organization, project, pat, wiql);
+}
+/**
+ * Fetch work items using FILTERED strategy (multiple projects + area paths + filters)
+ *
+ * @param config ADO configuration
+ * @param pat Personal Access Token
+ * @param timeRange Time range preset
+ * @returns Array of work items
+ */
+async function fetchWorkItemsFiltered(config, pat, timeRange) {
+    const organization = config.organization;
+    const containers = config.containers;
+    if (!containers || containers.length === 0) {
+        throw new Error('Filtered strategy requires containers array in config');
+    }
+    // Build hierarchical WIQL
+    const baseWiql = await buildHierarchicalWIQL(organization, pat, containers);
+    // Add time range
+    const wiql = addTimeRangeFilter(baseWiql, timeRange);
+    console.log('🔍 Fetching work items (FILTERED strategy):', wiql);
+    // Use first project for API endpoint (WIQL can query across projects)
+    const project = containers[0].id;
+    return executeQuery(organization, project, pat, wiql);
+}
+/**
+ * Execute WIQL query and return work items
+ *
+ * @param organization Organization name
+ * @param project Project name
+ * @param pat Personal Access Token
+ * @param wiql WIQL query string
+ * @returns Array of work items
+ */
+async function executeQuery(organization, project, pat, wiql) {
+    const baseUrl = `https://dev.azure.com/${organization}/${project}`;
+    // Execute query
+    const queryUrl = `${baseUrl}/_apis/wit/wiql?api-version=7.1`;
+    const queryResult = await makeRequest(queryUrl, pat, 'POST', { query: wiql });
+    if (!queryResult.workItems || queryResult.workItems.length === 0) {
+        return [];
+    }
+    // Get full work item details (batch request)
+    const ids = queryResult.workItems.map((wi) => wi.id);
+    const batchUrl = `${baseUrl}/_apis/wit/workitemsbatch?api-version=7.1`;
+    const response = await makeRequest(batchUrl, pat, 'POST', {
+        ids,
+        fields: [
+            'System.Id',
+            'System.Title',
+            'System.Description',
+            'System.State',
+            'System.CreatedDate',
+            'System.ChangedDate',
+            'System.WorkItemType',
+            'System.AreaPath',
+            'System.IterationPath',
+            'System.Tags',
+        ],
+    });
+    return response.value || [];
+}
+/**
+ * Make HTTPS request to ADO API
+ */
+function makeRequest(url, pat, method = 'GET', body) {
+    return new Promise((resolve, reject) => {
+        const { hostname, pathname, search } = new URL(url);
+        const authHeader = 'Basic ' + Buffer.from(`:${pat}`).toString('base64');
+        const headers = {
+            Authorization: authHeader,
+            Accept: 'application/json',
+        };
+        if (body) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const options = {
+            hostname,
+            path: pathname + search,
+            method,
+            headers,
+        };
+        const req = https.request(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => {
+                data += chunk;
+            });
+            res.on('end', () => {
+                try {
+                    const parsed = JSON.parse(data);
+                    if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                        resolve(parsed);
+                    }
+                    else {
+                        reject(new Error(`HTTP ${res.statusCode}: ${parsed.message || data}`));
+                    }
+                }
+                catch (error) {
+                    reject(new Error(`Failed to parse response: ${data}`));
+                }
+            });
+        });
+        req.on('error', (error) => {
+            reject(error);
+        });
+        // Send body if present
+        if (body) {
+            req.write(JSON.stringify(body));
+        }
+        req.end();
+    });
+}
+//# sourceMappingURL=ado-hierarchical-sync.js.map