@codeguide/core 0.0.33 → 0.0.36

package/__tests__/services/usage/usage-service.test.ts

@@ -326,7 +326,7 @@ describe('UsageService', () => {
       expect(result.data.subscription).not.toBeNull()
       expect(result.data.subscription?.plan_name).toBe('Monthly Plan')
       expect(result.data.codespace_task_limit).toBeNull()
-      expect(result.data.plan_limits.limits.codespace_tasks.is_unlimited).toBe(true)
+      expect(result.data.plan_limits?.limits.codespace_tasks.is_unlimited).toBe(true)
     })
   })
 
@@ -706,25 +706,37 @@ describe('UsageService', () => {
       const response: UsageSummaryResponse = {
         status: 'success',
         data: {
-          current_period: {
+          period: {
+            start: '2024-01-25',
+            end: '2024-01-31',
+          },
+          usage: {
             credits_consumed: 13870,
             cost_usd: 41.61,
             requests_count: 142,
           },
-          previous_period: {
-            credits_consumed: 11990,
-            cost_usd: 35.97,
-            requests_count: 131,
-          },
-          billing_cycle: {
-            total_allotted: 50000,
-            total_consumed: 28450,
-            remaining_credits: 21550,
+          breakdown: {
+            docs: 5230,
+            chat: 4120,
+            codespace_task: 4520,
           },
-          utilization_percentage: 56.9,
-          remaining_credits: 21550,
-          daily_average: 1981.43,
-          projected_monthly: 59443,
+          service_breakdown: [
+            {
+              service_type: 'docs',
+              credits_consumed: 5230,
+              requests_count: 58,
+            },
+            {
+              service_type: 'chat',
+              credits_consumed: 4120,
+              requests_count: 47,
+            },
+            {
+              service_type: 'codespace_task',
+              credits_consumed: 4520,
+              requests_count: 37,
+            },
+          ],
         },
       }
 
@@ -744,25 +756,37 @@ describe('UsageService', () => {
       const response: UsageSummaryResponse = {
         status: 'success',
         data: {
-          current_period: {
+          period: {
+            start: '2024-01-01',
+            end: '2024-01-31',
+          },
+          usage: {
             credits_consumed: 25000,
             cost_usd: 75.0,
             requests_count: 300,
           },
-          previous_period: {
-            credits_consumed: 22000,
-            cost_usd: 66.0,
-            requests_count: 275,
-          },
-          billing_cycle: {
-            total_allotted: 50000,
-            total_consumed: 47000,
-            remaining_credits: 3000,
+          breakdown: {
+            docs: 10000,
+            chat: 8000,
+            codespace_task: 7000,
           },
-          utilization_percentage: 94.0,
-          remaining_credits: 3000,
-          daily_average: 806.45,
-          projected_monthly: 25000,
+          service_breakdown: [
+            {
+              service_type: 'docs',
+              credits_consumed: 10000,
+              requests_count: 120,
+            },
+            {
+              service_type: 'chat',
+              credits_consumed: 8000,
+              requests_count: 95,
+            },
+            {
+              service_type: 'codespace_task',
+              credits_consumed: 7000,
+              requests_count: 85,
+            },
+          ],
         },
       }
 

package/codeguide.ts

@@ -20,6 +20,9 @@ import {
   SecurityKeysService,
   UserService,
   StarterKitsService,
+  ChatService,
+  DataManagementService,
+  PromptGenerationsService,
 } from './services'
 import { APIServiceConfig, CodeGuideOptions } from './types'
 
@@ -37,6 +40,9 @@ export class CodeGuide {
   public securityKeys: SecurityKeysService
   public users: UserService
   public starterKits: StarterKitsService
+  public chat: ChatService
+  public dataManagement: DataManagementService
+  public promptGenerations: PromptGenerationsService
   private options: CodeGuideOptions
 
   constructor(config: APIServiceConfig, options: CodeGuideOptions = {}) {
@@ -56,6 +62,9 @@ export class CodeGuide {
     this.securityKeys = new SecurityKeysService(config)
     this.users = new UserService(config)
     this.starterKits = new StarterKitsService(config)
+    this.chat = new ChatService(config)
+    this.dataManagement = new DataManagementService(config)
+    this.promptGenerations = new PromptGenerationsService(config)
   }
 
   // Convenience method for backward compatibility

package/dist/codeguide.d.ts

@@ -1,4 +1,4 @@
-import { GenerationService, ProjectService, UsageService, RepositoryAnalysisService, TaskService, ApiKeyEnhancedService, SubscriptionService, CancellationFunnelService, CodespaceService, ExternalTokenService, SecurityKeysService, UserService, StarterKitsService } from './services';
+import { GenerationService, ProjectService, UsageService, RepositoryAnalysisService, TaskService, ApiKeyEnhancedService, SubscriptionService, CancellationFunnelService, CodespaceService, ExternalTokenService, SecurityKeysService, UserService, StarterKitsService, ChatService, DataManagementService, PromptGenerationsService } from './services';
 import { APIServiceConfig, CodeGuideOptions } from './types';
 export declare class CodeGuide {
     generation: GenerationService;
@@ -14,6 +14,9 @@ export declare class CodeGuide {
     securityKeys: SecurityKeysService;
     users: UserService;
     starterKits: StarterKitsService;
+    chat: ChatService;
+    dataManagement: DataManagementService;
+    promptGenerations: PromptGenerationsService;
     private options;
     constructor(config: APIServiceConfig, options?: CodeGuideOptions);
     getGuidance(prompt: string): Promise<any>;

package/dist/codeguide.js

@@ -29,6 +29,9 @@ class CodeGuide {
         this.securityKeys = new services_1.SecurityKeysService(config);
         this.users = new services_1.UserService(config);
         this.starterKits = new services_1.StarterKitsService(config);
+        this.chat = new services_1.ChatService(config);
+        this.dataManagement = new services_1.DataManagementService(config);
+        this.promptGenerations = new services_1.PromptGenerationsService(config);
     }
     // Convenience method for backward compatibility
     async getGuidance(prompt) {

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 export { CodeGuide } from './codeguide';
 export * from './services';
 export * from './types';
-export type { ConnectRepositoryRequest, ConnectRepositoryResponse, ProjectRepository, GetProjectsRequest, PaginatedProjectsRequest, PaginatedProjectsResponse, } from './services/projects/project-types';
+export type { ConnectRepositoryRequest, ConnectRepositoryResponse, ProjectRepository, GetProjectsRequest, PaginatedProjectsRequest, PaginatedProjectsResponse, AITool, GetAiToolsRequest, GetAiToolsResponse, } from './services/projects/project-types';
 export type { CreateCodespaceTaskRequestV2 as CreateCodespaceTaskRequest, CreateCodespaceTaskResponseV2 as CreateCodespaceTaskResponse, CreateBackgroundCodespaceTaskRequest, CreateBackgroundCodespaceTaskResponse, ModelApiKey, Attachment, GetCodespaceTaskResponse, CodespaceTaskData, TechnicalDocument, GetProjectTasksByCodespaceResponse, } from './services/codespace/codespace-types';
 export type { StoreExternalTokenRequest, StoreExternalTokenResponse, ListTokensQuery, ListTokensResponse, ValidateTokenRequest, ValidateTokenResponse, FindBestMatchRequest, FindBestMatchResponse, Platform, TokenType, } from './services/external-tokens/external-tokens-types';
 export type { StarterKit, StarterKitMetadata, GetStarterKitsRequest, GetStarterKitsResponse, } from './services/starter-kits/starter-kits-types';
+export type { DataStatsResponse, DeleteAllDataRequest, DeleteAllDataResponse, } from './services/data-management/data-management-types';

package/dist/services/chat/chat-service.d.ts

@@ -0,0 +1,44 @@
+import { BaseService } from '../base/base-service';
+import { GetDocumentTypesRequest, GetDocumentTypesResponse, GetChatsByDocumentTypeRequest, GetChatsByDocumentTypeResponse, GetChatHistoryRequest, GetChatHistoryResponse, ListDocumentChatsRequest, ListDocumentChatsResponse, GetChatByDocumentIdRequest, GetChatByDocumentIdResponse } from './chat-types';
+export declare class ChatService extends BaseService {
+    /**
+     * 1. GET /chat/document/types/{project_id}
+     * Get document types for UI grouping
+     *
+     * @param request - Project ID to get document types for
+     * @returns Document types available for the project
+     */
+    getDocumentTypes(request: GetDocumentTypesRequest): Promise<GetDocumentTypesResponse>;
+    /**
+     * 2. GET /chat/document/by-type/{project_id}/{document_type}
+     * List all chats for a specific document type (PRIMARY endpoint for UI)
+     *
+     * @param request - Filter parameters for document type chats
+     * @returns Paginated list of document chats for the specified type
+     */
+    getChatsByDocumentType(request: GetChatsByDocumentTypeRequest): Promise<GetChatsByDocumentTypeResponse>;
+    /**
+     * 3. GET /chat/document/history/{conversation_id}
+     * Get full chat history with messages
+     *
+     * @param request - Conversation ID to get history for
+     * @returns Conversation details with all messages
+     */
+    getChatHistory(request: GetChatHistoryRequest): Promise<GetChatHistoryResponse>;
+    /**
+     * 4. GET /chat/document/list
+     * List all chats for current user (with optional filters)
+     *
+     * @param request - Filter parameters for listing chats
+     * @returns Paginated list of all document chats for the user
+     */
+    listDocumentChats(request?: ListDocumentChatsRequest): Promise<ListDocumentChatsResponse>;
+    /**
+     * 5. GET /chat/document/by-document/{document_id}
+     * Get chat by specific document version ID (Legacy)
+     *
+     * @param request - Document ID to get chat for
+     * @returns Conversation and messages for the specific document
+     */
+    getChatByDocumentId(request: GetChatByDocumentIdRequest): Promise<GetChatByDocumentIdResponse>;
+}

package/dist/services/chat/chat-service.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatService = void 0;
+const base_service_1 = require("../base/base-service");
+class ChatService extends base_service_1.BaseService {
+    /**
+     * 1. GET /chat/document/types/{project_id}
+     * Get document types for UI grouping
+     *
+     * @param request - Project ID to get document types for
+     * @returns Document types available for the project
+     */
+    async getDocumentTypes(request) {
+        return this.get(`/chat/document/types/${request.project_id}`);
+    }
+    /**
+     * 2. GET /chat/document/by-type/{project_id}/{document_type}
+     * List all chats for a specific document type (PRIMARY endpoint for UI)
+     *
+     * @param request - Filter parameters for document type chats
+     * @returns Paginated list of document chats for the specified type
+     */
+    async getChatsByDocumentType(request) {
+        const { project_id, document_type, chat_status = 'active', limit = 50, offset = 0 } = request;
+        // Build query parameters
+        const params = new URLSearchParams();
+        if (chat_status)
+            params.append('chat_status', chat_status);
+        if (limit !== undefined)
+            params.append('limit', limit.toString());
+        if (offset !== undefined)
+            params.append('offset', offset.toString());
+        const queryString = params.toString();
+        const url = `/chat/document/by-type/${project_id}/${document_type}${queryString ? `?${queryString}` : ''}`;
+        return this.get(url);
+    }
+    /**
+     * 3. GET /chat/document/history/{conversation_id}
+     * Get full chat history with messages
+     *
+     * @param request - Conversation ID to get history for
+     * @returns Conversation details with all messages
+     */
+    async getChatHistory(request) {
+        return this.get(`/chat/document/history/${request.conversation_id}`);
+    }
+    /**
+     * 4. GET /chat/document/list
+     * List all chats for current user (with optional filters)
+     *
+     * @param request - Filter parameters for listing chats
+     * @returns Paginated list of all document chats for the user
+     */
+    async listDocumentChats(request = {}) {
+        const { project_id, document_type, template, chat_status = 'active', limit = 50, offset = 0, } = request;
+        // Build query parameters
+        const params = new URLSearchParams();
+        if (project_id)
+            params.append('project_id', project_id);
+        if (document_type)
+            params.append('document_type', document_type);
+        if (template)
+            params.append('template', template);
+        if (chat_status)
+            params.append('chat_status', chat_status);
+        if (limit !== undefined)
+            params.append('limit', limit.toString());
+        if (offset !== undefined)
+            params.append('offset', offset.toString());
+        const queryString = params.toString();
+        const url = `/chat/document/list${queryString ? `?${queryString}` : ''}`;
+        return this.get(url);
+    }
+    /**
+     * 5. GET /chat/document/by-document/{document_id}
+     * Get chat by specific document version ID (Legacy)
+     *
+     * @param request - Document ID to get chat for
+     * @returns Conversation and messages for the specific document
+     */
+    async getChatByDocumentId(request) {
+        return this.get(`/chat/document/by-document/${request.document_id}`);
+    }
+}
+exports.ChatService = ChatService;

package/dist/services/chat/chat-types.d.ts

@@ -0,0 +1,88 @@
+export interface GetDocumentTypesRequest {
+    project_id: string;
+}
+export interface GetDocumentTypesResponse {
+    project_id: string;
+    project_name: string;
+    document_types: DocumentType[];
+}
+export type DocumentType = 'project_requirements_document' | 'app_flow_document' | 'tech_stack_document' | 'frontend_guidelines_document' | 'database_schema_document' | 'api_documentation_document' | 'deployment_document' | 'testing_document' | 'custom_document';
+export interface GetChatsByDocumentTypeRequest {
+    project_id: string;
+    document_type: DocumentType;
+    chat_status?: ChatStatus;
+    limit?: number;
+    offset?: number;
+}
+export interface GetChatsByDocumentTypeResponse {
+    chats: DocumentChatSummary[];
+    count: number;
+    project_id: string;
+    document_type: DocumentType;
+    limit: number;
+    offset: number;
+}
+export interface GetChatHistoryRequest {
+    conversation_id: string;
+}
+export interface GetChatHistoryResponse {
+    conversation: DocumentConversation;
+    messages: ChatMessage[];
+}
+export interface ListDocumentChatsRequest {
+    project_id?: string;
+    document_type?: DocumentType;
+    template?: 'blueprint' | 'wireframe';
+    chat_status?: ChatStatus;
+    limit?: number;
+    offset?: number;
+}
+export interface ListDocumentChatsResponse {
+    chats: DocumentChatSummary[];
+    count: number;
+    limit: number;
+    offset: number;
+}
+export interface GetChatByDocumentIdRequest {
+    document_id: string;
+}
+export interface GetChatByDocumentIdResponse {
+    conversation: DocumentConversation;
+    messages: ChatMessage[];
+}
+export type ChatStatus = 'active' | 'archived' | 'deleted';
+export interface DocumentChatSummary {
+    id: string;
+    project_id: string;
+    document_type: DocumentType;
+    title: string;
+    template: 'blueprint' | 'wireframe';
+    status: ChatStatus;
+    last_message_at: string;
+    metadata?: Record<string, any>;
+}
+export interface DocumentConversation {
+    id: string;
+    project_id: string;
+    document_type: DocumentType;
+    title: string;
+    template: 'blueprint' | 'wireframe';
+    status: ChatStatus;
+    created_at: string;
+    last_message_at: string;
+}
+export interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    tool_calls?: ChatToolCall[];
+    created_at: string;
+}
+export interface ChatToolCall {
+    id: string;
+    type: string;
+    function?: {
+        name: string;
+        arguments: string;
+    };
+}

package/dist/services/chat/chat-types.js

@@ -0,0 +1,5 @@
+"use strict";
+// ============================================================================
+// Document Chat GET Endpoint Types
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/services/chat/index.d.ts

@@ -0,0 +1,2 @@
+export { ChatService } from './chat-service';
+export * from './chat-types';

package/dist/services/chat/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatService = void 0;
+var chat_service_1 = require("./chat-service");
+Object.defineProperty(exports, "ChatService", { enumerable: true, get: function () { return chat_service_1.ChatService; } });
+__exportStar(require("./chat-types"), exports);

package/dist/services/data-management/data-management-service.d.ts

@@ -0,0 +1,53 @@
+import { BaseService } from '../base/base-service';
+import { DataStatsResponse, DeleteAllDataRequest, DeleteAllDataResponse, DataExportResponse } from './data-management-types';
+export declare class DataManagementService extends BaseService {
+    /**
+     * Get comprehensive statistics of all user data
+     *
+     * Calls GET /data/stats to retrieve aggregate counts of:
+     * - Projects
+     * - Project documents
+     * - Project repositories
+     * - Project tasks
+     * - Task groups
+     * - Chat conversations
+     * - Chat messages
+     * - Codespace tasks
+     *
+     * @returns Promise resolving to DataStatsResponse with counts for each entity type
+     */
+    getDataStats(): Promise<DataStatsResponse>;
+    /**
+     * Export all user data
+     *
+     * Calls GET /data/export to retrieve complete export of all user data.
+     * This includes all projects, documents, repositories, tasks, conversations,
+     * messages, and codespace tasks with their full details.
+     *
+     * Use this for:
+     * - Creating backups
+     * - Migrating data to another system
+     * - Data analysis
+     * - Compliance and auditing
+     *
+     * @returns Promise resolving to DataExportResponse with complete user data
+     */
+    exportData(): Promise<DataExportResponse>;
+    /**
+     * Delete all user data with explicit confirmation
+     *
+     * Calls DELETE /data/all to perform bulk deletion of all user data.
+     * This operation requires confirmation to prevent accidental data loss.
+     *
+     * The deletion will affect:
+     * - All projects (including documents and repositories)
+     * - All task groups and project tasks
+     * - All chat conversations and messages
+     * - All codespace tasks
+     *
+     * @param request - DeleteAllDataRequest with confirm flag set to true
+     * @returns Promise resolving to DeleteAllDataResponse with deletion summary
+     * @throws Error if confirmation is not true
+     */
+    deleteAllData(request: DeleteAllDataRequest): Promise<DeleteAllDataResponse>;
+}

package/dist/services/data-management/data-management-service.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataManagementService = void 0;
+const base_service_1 = require("../base/base-service");
+class DataManagementService extends base_service_1.BaseService {
+    /**
+     * Get comprehensive statistics of all user data
+     *
+     * Calls GET /data/stats to retrieve aggregate counts of:
+     * - Projects
+     * - Project documents
+     * - Project repositories
+     * - Project tasks
+     * - Task groups
+     * - Chat conversations
+     * - Chat messages
+     * - Codespace tasks
+     *
+     * @returns Promise resolving to DataStatsResponse with counts for each entity type
+     */
+    async getDataStats() {
+        return this.get('/data/stats');
+    }
+    /**
+     * Export all user data
+     *
+     * Calls GET /data/export to retrieve complete export of all user data.
+     * This includes all projects, documents, repositories, tasks, conversations,
+     * messages, and codespace tasks with their full details.
+     *
+     * Use this for:
+     * - Creating backups
+     * - Migrating data to another system
+     * - Data analysis
+     * - Compliance and auditing
+     *
+     * @returns Promise resolving to DataExportResponse with complete user data
+     */
+    async exportData() {
+        return this.get('/data/export');
+    }
+    /**
+     * Delete all user data with explicit confirmation
+     *
+     * Calls DELETE /data/all to perform bulk deletion of all user data.
+     * This operation requires confirmation to prevent accidental data loss.
+     *
+     * The deletion will affect:
+     * - All projects (including documents and repositories)
+     * - All task groups and project tasks
+     * - All chat conversations and messages
+     * - All codespace tasks
+     *
+     * @param request - DeleteAllDataRequest with confirm flag set to true
+     * @returns Promise resolving to DeleteAllDataResponse with deletion summary
+     * @throws Error if confirmation is not true
+     */
+    async deleteAllData(request) {
+        // Validate confirmation flag to prevent accidental deletion
+        if (!request.confirm) {
+            throw new Error('Confirmation required. Set confirm: true to delete all data. This action cannot be undone.');
+        }
+        return this.delete('/data/all');
+    }
+}
+exports.DataManagementService = DataManagementService;