promptarchitect 0.6.0

package/src/api.ts

@@ -0,0 +1,223 @@
+/**
+ * PromptArchitect API Client
+ * 
+ * Connects to the hosted PromptArchitect API.
+ * Requires authentication for all requests.
+ */
+
+interface GeneratePromptRequest {
+  idea: string;
+  template?: string;
+  context?: string;
+  targetModel?: string;
+}
+
+interface GeneratePromptResponse {
+  prompt: string;
+  template: string;
+  metadata: {
+    wordCount: number;
+    targetModel: string;
+  };
+}
+
+interface RefinePromptRequest {
+  prompt: string;
+  feedback: string;
+  preserveStructure?: boolean;
+  targetModel?: string;
+}
+
+interface RefinePromptResponse {
+  refinedPrompt: string;
+  changes: string[];
+  metadata: {
+    originalWordCount: number;
+    refinedWordCount: number;
+    structurePreserved: boolean;
+  };
+}
+
+interface AnalyzePromptRequest {
+  prompt: string;
+  evaluationCriteria?: string[];
+}
+
+interface AnalyzePromptResponse {
+  overallScore: number;
+  scores: {
+    clarity: number;
+    specificity: number;
+    structure: number;
+    actionability: number;
+  };
+  strengths: string[];
+  weaknesses: string[];
+  suggestions: string[];
+}
+
+interface ChatRequest {
+  message: string;
+  history?: Array<{ role: string; content: string }>;
+  context?: string;
+}
+
+interface ChatResponse {
+  reply: string;
+  usage?: {
+    promptTokens: number;
+    completionTokens: number;
+  };
+}
+
+export class PromptArchitectAPI {
+  private baseUrl: string;
+  private timeout = 30000;
+  private accessToken: string | null = null;
+
+  constructor(baseUrl: string) {
+    this.baseUrl = baseUrl.replace(/\/$/, ''); // Remove trailing slash
+  }
+
+  /**
+   * Set the access token for authenticated requests
+   */
+  setAccessToken(token: string | null): void {
+    this.accessToken = token;
+  }
+
+  /**
+   * Get current access token
+   */
+  getAccessToken(): string | null {
+    return this.accessToken;
+  }
+
+  /**
+   * Generate a prompt from an idea
+   */
+  async generatePrompt(request: GeneratePromptRequest): Promise<GeneratePromptResponse> {
+    return this.post<GeneratePromptResponse>('/vscode/generate', request);
+  }
+
+  /**
+   * Refine an existing prompt
+   */
+  async refinePrompt(request: RefinePromptRequest): Promise<RefinePromptResponse> {
+    return this.post<RefinePromptResponse>('/vscode/refine', request);
+  }
+
+  /**
+   * Analyze prompt quality
+   */
+  async analyzePrompt(request: AnalyzePromptRequest): Promise<AnalyzePromptResponse> {
+    return this.post<AnalyzePromptResponse>('/vscode/analyze', request);
+  }
+
+  /**
+   * Chat with AI - send a message and get a response
+   */
+  async chat(request: ChatRequest): Promise<ChatResponse> {
+    return this.post<ChatResponse>('/vscode/chat', request);
+  }
+
+  /**
+   * Check API health/availability
+   */
+  async healthCheck(): Promise<{ status: string; service: string }> {
+    return this.get<{ status: string; service: string }>('/vscode/health');
+  }
+
+  /**
+   * HTTP GET request
+   */
+  private async get<T>(path: string): Promise<T> {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      'X-Client': 'vscode-extension',
+      'X-Client-Version': '0.5.0',
+    };
+
+    // Add auth token if available
+    if (this.accessToken) {
+      headers['Authorization'] = `Bearer ${this.accessToken}`;
+    }
+
+    try {
+      const response = await fetch(`${this.baseUrl}${path}`, {
+        method: 'GET',
+        headers,
+        signal: controller.signal,
+      });
+
+      clearTimeout(timeoutId);
+
+      if (response.status === 401) {
+        throw new Error('Authentication required. Please sign in.');
+      }
+
+      if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`API error (${response.status}): ${error}`);
+      }
+
+      return response.json() as T;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof Error && error.name === 'AbortError') {
+        throw new Error('Request timed out. Please try again.');
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * HTTP POST request
+   */
+  private async post<T>(path: string, body: unknown): Promise<T> {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      'X-Client': 'vscode-extension',
+      'X-Client-Version': '0.5.0',
+    };
+
+    // Add auth token if available
+    if (this.accessToken) {
+      headers['Authorization'] = `Bearer ${this.accessToken}`;
+    }
+
+    try {
+      const response = await fetch(`${this.baseUrl}${path}`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(body),
+        signal: controller.signal,
+      });
+
+      clearTimeout(timeoutId);
+
+      if (response.status === 401) {
+        throw new Error('Authentication required. Please sign in.');
+      }
+
+      if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`API error (${response.status}): ${error}`);
+      }
+
+      return response.json() as T;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof Error && error.name === 'AbortError') {
+        throw new Error('Request timed out. Please try again.');
+      }
+      throw error;
+    }
+  }
+}