@axonflow/sdk 1.12.0 → 1.14.0

package/dist/esm/client.js

@@ -8,6 +8,7 @@ import { generateRequestId, debugLog } from './utils/helpers.js';
 export class AxonFlow {
     constructor(config) {
         this.interceptors = [];
+        this.sessionCookie = null;
         // Set defaults first to determine endpoint
         const endpoint = config.endpoint || 'https://staging-eu.getaxonflow.com';
         // Credentials are optional for community/self-hosted deployments
@@ -19,6 +20,7 @@ export class AxonFlow {
             licenseKey: config.licenseKey,
             endpoint,
             orchestratorEndpoint: config.orchestratorEndpoint,
+            portalEndpoint: config.portalEndpoint,
             mode: config.mode || (hasCredentials ? 'production' : 'sandbox'),
             tenant: config.tenant || 'default',
             debug: config.debug || false,
@@ -309,6 +311,56 @@ export class AxonFlow {
             };
         }
     }
+    /**
+     * Check the health of the AxonFlow Orchestrator service.
+     *
+     * @returns Promise resolving to health status
+     * @example
+     * ```typescript
+     * const health = await axonflow.orchestratorHealthCheck();
+     * if (health.status === 'healthy') {
+     *   console.log('Orchestrator is healthy');
+     * }
+     * ```
+     */
+    async orchestratorHealthCheck() {
+        const url = `${this.getOrchestratorUrl()}/health`;
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                signal: AbortSignal.timeout(this.config.timeout),
+            });
+            if (!response.ok) {
+                return {
+                    status: 'unhealthy',
+                    components: {
+                        orchestrator: { status: 'error', message: `HTTP ${response.status}` },
+                    },
+                };
+            }
+            const data = await response.json();
+            return {
+                status: data.status === 'healthy' ? 'healthy' : 'degraded',
+                version: data.version,
+                uptime: data.uptime,
+                components: data.components,
+            };
+        }
+        catch (error) {
+            if (this.config.debug) {
+                debugLog('Orchestrator health check failed', error);
+            }
+            return {
+                status: 'unhealthy',
+                components: {
+                    orchestrator: {
+                        status: 'error',
+                        message: error instanceof Error ? error.message : 'Unknown error',
+                    },
+                },
+            };
+        }
+    }
     /**
      * Execute a query through AxonFlow with policy enforcement (Proxy Mode).
      *
@@ -425,15 +477,9 @@ export class AxonFlow {
      * List all available MCP connectors from the marketplace
      */
     async listConnectors() {
-        const url = `${this.config.endpoint}/api/connectors`;
-        const response = await fetch(url, {
-            method: 'GET',
-            signal: AbortSignal.timeout(this.config.timeout),
-        });
-        if (!response.ok) {
-            throw new Error(`Failed to list connectors: ${response.status} ${response.statusText}`);
-        }
-        const connectors = await response.json();
+        const response = await this.orchestratorRequest('GET', '/api/v1/connectors');
+        // Handle wrapped response
+        const connectors = Array.isArray(response) ? response : response.connectors || [];
         if (this.config.debug) {
             debugLog('Listed connectors', { count: connectors.length });
         }
@@ -443,30 +489,41 @@ export class AxonFlow {
      * Install an MCP connector from the marketplace
      */
     async installConnector(request) {
-        const url = `${this.config.endpoint}/api/connectors/install`;
-        const headers = {
-            'Content-Type': 'application/json',
-        };
-        // Add authentication headers
-        if (this.config.licenseKey) {
-            headers['X-License-Key'] = this.config.licenseKey;
+        // Extract connector_id from request for URL path
+        const { connector_id, ...body } = request;
+        await this.orchestratorRequest('POST', `/api/v1/connectors/${connector_id}/install`, body);
+        if (this.config.debug) {
+            debugLog('Connector installed', { name: request.name });
         }
-        else if (this.config.apiKey) {
-            headers['X-Client-Secret'] = this.config.apiKey;
+    }
+    /**
+     * Uninstall an MCP connector
+     */
+    async uninstallConnector(connectorName) {
+        await this.orchestratorRequest('DELETE', `/api/v1/connectors/${connectorName}`);
+        if (this.config.debug) {
+            debugLog('Connector uninstalled', { name: connectorName });
         }
-        const response = await fetch(url, {
-            method: 'POST',
-            headers,
-            body: JSON.stringify(request),
-            signal: AbortSignal.timeout(this.config.timeout),
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Failed to install connector: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    /**
+     * Get details for a specific connector by ID
+     */
+    async getConnector(connectorId) {
+        const connector = await this.orchestratorRequest('GET', `/api/v1/connectors/${connectorId}`);
+        if (this.config.debug) {
+            debugLog('Got connector', { id: connectorId });
         }
+        return connector;
+    }
+    /**
+     * Get health status of an installed connector
+     */
+    async getConnectorHealth(connectorId) {
+        const health = await this.orchestratorRequest('GET', `/api/v1/connectors/${connectorId}/health`);
         if (this.config.debug) {
-            debugLog('Connector installed', { name: request.name });
+            debugLog('Got connector health', { id: connectorId, healthy: health.healthy });
         }
+        return health;
     }
     /**
      * Execute a query against an installed MCP connector
@@ -1191,17 +1248,15 @@ export class AxonFlow {
      * @example
      * ```typescript
      * const policies = await axonflow.listDynamicPolicies({
-     *   category: 'dynamic-cost',
+     *   type: 'cost',
      *   enabled: true
      * });
      * ```
      */
     async listDynamicPolicies(options) {
         const params = new URLSearchParams();
-        if (options?.category)
-            params.set('category', options.category);
-        if (options?.tier)
-            params.set('tier', options.tier);
+        if (options?.type)
+            params.set('type', options.type);
         if (options?.enabled !== undefined)
             params.set('enabled', String(options.enabled));
         if (options?.limit)
@@ -1215,11 +1270,11 @@ export class AxonFlow {
         if (options?.search)
             params.set('search', options.search);
         const queryString = params.toString();
-        const path = `/api/v1/policies${queryString ? `?${queryString}` : ''}`;
+        const path = `/api/v1/policies/dynamic${queryString ? `?${queryString}` : ''}`;
         if (this.config.debug) {
             debugLog('Listing dynamic policies', { options });
         }
-        return this.policyRequest('GET', path);
+        return this.orchestratorRequest('GET', path);
     }
     /**
      * Get a specific dynamic policy by ID.
@@ -1231,7 +1286,7 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Getting dynamic policy', { id });
         }
-        return this.policyRequest('GET', `/api/v1/policies/${id}`);
+        return this.orchestratorRequest('GET', `/api/v1/policies/dynamic/${id}`);
     }
     /**
      * Create a new dynamic policy.
@@ -1256,7 +1311,7 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Creating dynamic policy', { name: policy.name });
         }
-        return this.policyRequest('POST', '/api/v1/policies', policy);
+        return this.orchestratorRequest('POST', '/api/v1/policies/dynamic', policy);
     }
     /**
      * Update an existing dynamic policy.
@@ -1269,7 +1324,7 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Updating dynamic policy', { id, updates: Object.keys(policy) });
         }
-        return this.policyRequest('PUT', `/api/v1/policies/${id}`, policy);
+        return this.orchestratorRequest('PUT', `/api/v1/policies/dynamic/${id}`, policy);
     }
     /**
      * Delete a dynamic policy.
@@ -1280,7 +1335,7 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Deleting dynamic policy', { id });
         }
-        await this.policyRequest('DELETE', `/api/v1/policies/${id}`);
+        await this.orchestratorRequest('DELETE', `/api/v1/policies/dynamic/${id}`);
     }
     /**
      * Toggle a dynamic policy's enabled status.
@@ -1293,7 +1348,9 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Toggling dynamic policy', { id, enabled });
         }
-        return this.policyRequest('PATCH', `/api/v1/policies/${id}`, { enabled });
+        return this.orchestratorRequest('PATCH', `/api/v1/policies/dynamic/${id}`, {
+            enabled,
+        });
     }
     /**
      * Get effective dynamic policies with tier inheritance applied.
@@ -1308,11 +1365,95 @@ export class AxonFlow {
         if (options?.includeDisabled)
             params.set('include_disabled', 'true');
         const queryString = params.toString();
-        const path = `/api/v1/policies/effective${queryString ? `?${queryString}` : ''}`;
+        const path = `/api/v1/policies/dynamic/effective${queryString ? `?${queryString}` : ''}`;
         if (this.config.debug) {
             debugLog('Getting effective dynamic policies', { options });
         }
-        return this.policyRequest('GET', path);
+        return this.orchestratorRequest('GET', path);
+    }
+    // ============================================================================
+    // Portal Authentication Methods (Enterprise)
+    // ============================================================================
+    /**
+     * Login to Customer Portal and store session cookie.
+     * Required before using Code Governance methods.
+     *
+     * @param orgId - Organization ID
+     * @param password - Organization password
+     * @returns Login response with session info
+     *
+     * @example
+     * ```typescript
+     * const login = await axonflow.loginToPortal('test-org-001', 'test123');
+     * console.log(`Logged in as ${login.name}`);
+     *
+     * // Now you can use Code Governance methods
+     * const providers = await axonflow.listGitProviders();
+     * ```
+     */
+    async loginToPortal(orgId, password) {
+        const url = `${this.getPortalUrl()}/api/v1/auth/login`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ org_id: orgId, password }),
+            signal: AbortSignal.timeout(this.config.timeout),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new AuthenticationError(`Login failed: ${errorText}`);
+        }
+        const result = (await response.json());
+        // Extract session cookie from response
+        const cookies = response.headers.get('set-cookie');
+        if (cookies) {
+            const match = cookies.match(/axonflow_session=([^;]+)/);
+            if (match) {
+                this.sessionCookie = match[1];
+            }
+        }
+        // Fallback to session_id in response body
+        if (!this.sessionCookie && result.session_id) {
+            this.sessionCookie = result.session_id;
+        }
+        if (this.config.debug) {
+            debugLog('Portal login successful', { orgId });
+        }
+        return {
+            sessionId: result.session_id,
+            orgId: result.org_id,
+            email: result.email,
+            name: result.name,
+            expiresAt: result.expires_at,
+        };
+    }
+    /**
+     * Logout from Customer Portal and clear session cookie.
+     */
+    async logoutFromPortal() {
+        if (!this.sessionCookie) {
+            return;
+        }
+        try {
+            await fetch(`${this.getPortalUrl()}/api/v1/auth/logout`, {
+                method: 'POST',
+                headers: { Cookie: `axonflow_session=${this.sessionCookie}` },
+                signal: AbortSignal.timeout(this.config.timeout),
+            });
+        }
+        catch {
+            // Ignore logout errors
+        }
+        this.sessionCookie = null;
+        if (this.config.debug) {
+            debugLog('Portal logout successful');
+        }
+    }
+    /**
+     * Check if logged in to Customer Portal.
+     */
+    isLoggedIn() {
+        return this.sessionCookie !== null;
     }
     // ============================================================================
     // Code Governance Methods (Enterprise)
@@ -1356,7 +1497,7 @@ export class AxonFlow {
             apiRequest.installation_id = request.installationId;
         if (request.privateKey)
             apiRequest.private_key = request.privateKey;
-        return this.policyRequest('POST', '/api/v1/code-governance/git-providers/validate', apiRequest);
+        return this.portalRequest('POST', '/api/v1/code-governance/git-providers/validate', apiRequest);
     }
     /**
      * Configure a Git provider for code governance.
@@ -1407,7 +1548,7 @@ export class AxonFlow {
             apiRequest.installation_id = request.installationId;
         if (request.privateKey)
             apiRequest.private_key = request.privateKey;
-        return this.policyRequest('POST', '/api/v1/code-governance/git-providers', apiRequest);
+        return this.portalRequest('POST', '/api/v1/code-governance/git-providers', apiRequest);
     }
     /**
      * List all configured Git providers for the tenant.
@@ -1425,7 +1566,7 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Listing Git providers');
         }
-        return this.policyRequest('GET', '/api/v1/code-governance/git-providers');
+        return this.portalRequest('GET', '/api/v1/code-governance/git-providers');
     }
     /**
      * Delete a configured Git provider.
@@ -1441,7 +1582,7 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Deleting Git provider', { type });
         }
-        await this.policyRequest('DELETE', `/api/v1/code-governance/git-providers/${type}`);
+        await this.portalRequest('DELETE', `/api/v1/code-governance/git-providers/${type}`);
     }
     /**
      * Create a Pull Request from LLM-generated code.
@@ -1509,7 +1650,7 @@ export class AxonFlow {
             apiRequest.secrets_detected = request.secretsDetected;
         if (request.unsafePatterns !== undefined)
             apiRequest.unsafe_patterns = request.unsafePatterns;
-        const response = await this.policyRequest('POST', '/api/v1/code-governance/prs', apiRequest);
+        const response = await this.portalRequest('POST', '/api/v1/code-governance/prs', apiRequest);
         // Transform snake_case response to camelCase
         return {
             prId: response.pr_id,
@@ -1554,10 +1695,10 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Listing PRs', { options });
         }
-        const response = await this.policyRequest('GET', path);
+        const response = await this.portalRequest('GET', path);
         // Transform snake_case response to camelCase
         return {
-            prs: response.prs.map(pr => ({
+            prs: (response.prs || []).map(pr => ({
                 id: pr.id,
                 prNumber: pr.pr_number,
                 prUrl: pr.pr_url,
@@ -1593,7 +1734,7 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Getting PR', { prId });
         }
-        const response = await this.policyRequest('GET', `/api/v1/code-governance/prs/${prId}`);
+        const response = await this.portalRequest('GET', `/api/v1/code-governance/prs/${prId}`);
         // Transform snake_case response to camelCase
         return {
             id: response.id,
@@ -1630,7 +1771,7 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Syncing PR status', { prId });
         }
-        const response = await this.policyRequest('POST', `/api/v1/code-governance/prs/${prId}/sync`);
+        const response = await this.portalRequest('POST', `/api/v1/code-governance/prs/${prId}/sync`);
         // Transform snake_case response to camelCase
         return {
             id: response.id,
@@ -1670,7 +1811,7 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Getting code governance metrics');
         }
-        const response = await this.policyRequest('GET', '/api/v1/code-governance/metrics');
+        const response = await this.portalRequest('GET', '/api/v1/code-governance/metrics');
         return {
             tenantId: response.tenant_id,
             totalPrs: response.total_prs,
@@ -1718,9 +1859,9 @@ export class AxonFlow {
         if (this.config.debug) {
             debugLog('Exporting code governance data', { path });
         }
-        const response = await this.policyRequest('GET', path);
+        const response = await this.portalRequest('GET', path);
         return {
-            records: response.records.map(r => ({
+            records: (response.records || []).map(r => ({
                 id: r.id,
                 prNumber: r.pr_number,
                 prUrl: r.pr_url,
@@ -1741,6 +1882,36 @@ export class AxonFlow {
             exportedAt: response.exported_at,
         };
     }
+    /**
+     * Export code governance data as CSV.
+     *
+     * Returns raw CSV data suitable for saving to file or streaming.
+     *
+     * @param options - Export options (date filters, state filter)
+     * @returns Raw CSV data
+     *
+     * @example
+     * ```typescript
+     * const csvData = await axonflow.exportCodeGovernanceDataCSV();
+     * fs.writeFileSync('pr-audit.csv', csvData);
+     * ```
+     */
+    async exportCodeGovernanceDataCSV(options) {
+        const params = new URLSearchParams();
+        params.set('format', 'csv');
+        if (options?.startDate)
+            params.set('start_date', options.startDate);
+        if (options?.endDate)
+            params.set('end_date', options.endDate);
+        if (options?.state)
+            params.set('state', options.state);
+        const query = params.toString();
+        const path = `/api/v1/code-governance/export${query ? '?' + query : ''}`;
+        if (this.config.debug) {
+            debugLog('Exporting code governance data as CSV', { path });
+        }
+        return this.portalRequestText('GET', path);
+    }
     // ============================================================================
     // Execution Replay Methods
     // ============================================================================
@@ -1793,6 +1964,65 @@ export class AxonFlow {
         }
         return response.json();
     }
+    /**
+     * Get the portal URL for enterprise PR workflow features.
+     * Falls back to agent endpoint with port 8082 if not configured.
+     */
+    getPortalUrl() {
+        if (this.config.portalEndpoint) {
+            return this.config.portalEndpoint;
+        }
+        // Default: assume portal is on same host as agent, port 8082
+        try {
+            const url = new URL(this.config.endpoint);
+            url.port = '8082';
+            return url.toString().replace(/\/$/, '');
+        }
+        catch {
+            return 'http://localhost:8082';
+        }
+    }
+    /**
+     * Generic HTTP request helper for Customer Portal APIs (enterprise features).
+     * Requires prior authentication via loginToPortal().
+     */
+    async portalRequest(method, path, body) {
+        if (!this.sessionCookie) {
+            throw new AuthenticationError('Not logged in to Customer Portal. Call loginToPortal() first.');
+        }
+        const url = `${this.getPortalUrl()}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            Cookie: `axonflow_session=${this.sessionCookie}`,
+        };
+        const options = {
+            method,
+            headers,
+            signal: AbortSignal.timeout(this.config.timeout),
+        };
+        if (body && (method === 'POST' || method === 'PUT' || method === 'PATCH')) {
+            options.body = JSON.stringify(body);
+        }
+        if (this.config.debug) {
+            debugLog('Portal request', { method, path });
+        }
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            const errorText = await response.text();
+            if (response.status === 401 || response.status === 403) {
+                throw new AuthenticationError(`Request failed: ${errorText}`);
+            }
+            if (response.status === 404) {
+                throw new APIError(404, 'Not Found', errorText);
+            }
+            throw new APIError(response.status, response.statusText, errorText);
+        }
+        // Handle DELETE responses with no body
+        if (response.status === 204 || method === 'DELETE') {
+            return undefined;
+        }
+        return response.json();
+    }
     /**
      * List workflow executions with optional filtering and pagination.
      *
@@ -2349,5 +2579,36 @@ export class AxonFlow {
             },
         };
     }
+    /**
+     * Generic HTTP request helper for Customer Portal APIs that returns raw text.
+     * Used for CSV exports and other non-JSON responses.
+     * Requires prior authentication via loginToPortal().
+     */
+    async portalRequestText(method, path) {
+        if (!this.sessionCookie) {
+            throw new AuthenticationError('Not logged in to Customer Portal. Call loginToPortal() first.');
+        }
+        const url = `${this.getPortalUrl()}${path}`;
+        const headers = {
+            Cookie: `axonflow_session=${this.sessionCookie}`,
+        };
+        const options = {
+            method,
+            headers,
+            signal: AbortSignal.timeout(this.config.timeout),
+        };
+        if (this.config.debug) {
+            debugLog('Portal request (text)', { method, path });
+        }
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            const errorText = await response.text();
+            if (response.status === 401 || response.status === 403) {
+                throw new AuthenticationError(`Request failed: ${errorText}`);
+            }
+            throw new APIError(response.status, response.statusText, errorText);
+        }
+        return response.text();
+    }
 }
 //# sourceMappingURL=client.js.map