@codeguide/core 0.0.33 → 0.0.36

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

@@ -45,8 +45,8 @@ export interface CreditBalance {
     remaining_credits: number;
     is_over_limit: boolean;
     utilization_percentage: number;
-    billing_cycle_start: string;
-    billing_cycle_end: string;
+    billing_cycle_start?: string;
+    billing_cycle_end?: string;
 }
 export interface LimitInfo {
     allowed?: boolean;
@@ -69,17 +69,18 @@ export interface PlanLimits {
         storage_gb: LimitInfo;
         projects: LimitInfo;
         collaborators: LimitInfo;
+        softwarev2_access?: LimitInfo;
     };
 }
 export interface AuthorizationSubscription {
-    id: string;
-    status: string;
-    interval: string;
-    current_period_start: string;
-    current_period_end: string;
-    price_id: string;
-    product_name: string | null;
-    plan_name: string;
+    id?: string;
+    status?: string;
+    interval?: string;
+    current_period_start?: string;
+    current_period_end?: string;
+    price_id?: string;
+    product_name?: string | null;
+    plan_name?: string;
 }
 export interface AuthorizationData {
     user_id: string;
@@ -93,7 +94,7 @@ export interface AuthorizationData {
     can_create_tasks: boolean;
     can_analyze_repos: boolean;
     can_access_previous_projects: boolean;
-    plan_limits: PlanLimits;
+    plan_limits?: PlanLimits | null;
     codespace_task_limit: LimitInfo | null;
 }
 export interface AuthorizationResponse {
@@ -253,31 +254,23 @@ export interface UsageSummaryRequest {
     start_date?: string;
     end_date?: string;
 }
-export interface CurrentPeriodUsage {
-    credits_consumed: number;
-    cost_usd: number;
-    requests_count: number;
-}
-export interface PreviousPeriodUsage {
-    credits_consumed: number;
-    cost_usd: number;
-    requests_count: number;
-}
-export interface BillingCycleInfo {
-    total_allotted: number;
-    total_consumed: number;
-    remaining_credits: number;
-}
 export interface UsageSummaryResponse {
     status: string;
     data: {
-        current_period: CurrentPeriodUsage;
-        previous_period: PreviousPeriodUsage;
-        billing_cycle: BillingCycleInfo;
-        utilization_percentage: number;
-        remaining_credits: number;
-        daily_average: number;
-        projected_monthly: number;
+        period: {
+            start?: string;
+            end?: string;
+        };
+        usage: {
+            [key: string]: number;
+        };
+        breakdown: {
+            [key: string]: number;
+        };
+        service_breakdown: Array<{
+            service_type: string;
+            [key: string]: any;
+        }>;
     };
 }
 export interface ServiceBreakdownRequest {
@@ -303,3 +296,86 @@ export interface ServiceBreakdownResponse {
     status: string;
     data: ServiceBreakdownData;
 }
+export type HeatmapPeriodType = '3m' | '6m' | '1y';
+export type ActivityLevel = 0 | 1 | 2 | 3 | 4;
+export interface ActivityHeatmapRequest {
+    period?: HeatmapPeriodType;
+    start_date?: string;
+    end_date?: string;
+}
+export interface HeatmapDayData {
+    date: string;
+    count: number;
+    level: ActivityLevel;
+}
+export interface ActivityHeatmapData {
+    period: PeriodInfo;
+    days: HeatmapDayData[];
+    total_tasks: number;
+    most_active_day: string | null;
+    max_daily_count: number;
+    average_daily: number;
+    active_days: number;
+}
+export interface ActivityHeatmapResponse {
+    status: string;
+    data: ActivityHeatmapData;
+}
+export type RepoAnalysisPeriodType = '7d' | '1w' | '1m' | '3m' | '6m' | '1y';
+export interface RepositoryAnalysisSummaryRequest {
+    period?: RepoAnalysisPeriodType;
+    start_date?: string;
+    end_date?: string;
+}
+export interface RepositoryAnalysisSummaryData {
+    total_repositories: number;
+    total_lines: number;
+    total_files_processed: number;
+    total_files_found: number;
+    total_directories: number;
+    total_characters: number;
+    estimated_tokens_total: number;
+    total_size_bytes: number;
+    binary_files_skipped: number;
+    large_files_skipped: number;
+    encoding_errors: number;
+    average_lines_per_repo: number;
+    average_files_per_repo: number;
+    period: PeriodInfo | null;
+}
+export interface RepositoryAnalysisSummaryResponse {
+    status: string;
+    data: RepositoryAnalysisSummaryData;
+}
+export type TimelineGranularity = 'daily' | 'weekly' | 'monthly';
+export interface RepositoryAnalysisTimelineRequest {
+    period?: RepoAnalysisPeriodType;
+    start_date?: string;
+    end_date?: string;
+    granularity?: TimelineGranularity;
+}
+export interface RepositoryAnalysisTimelineItem {
+    date: string;
+    repos_analyzed: number;
+    total_lines: number;
+    total_files: number;
+    total_characters: number;
+    estimated_tokens: number;
+}
+export interface RepositoryAnalysisTimelineTotals {
+    repos_analyzed: number;
+    total_lines: number;
+    total_files: number;
+    total_characters: number;
+    estimated_tokens: number;
+}
+export interface RepositoryAnalysisTimelineData {
+    period: PeriodInfo;
+    granularity: TimelineGranularity;
+    timeline: RepositoryAnalysisTimelineItem[];
+    totals: RepositoryAnalysisTimelineTotals;
+}
+export interface RepositoryAnalysisTimelineResponse {
+    status: string;
+    data: RepositoryAnalysisTimelineData;
+}

package/dist/services/users/user-service.d.ts

@@ -1,5 +1,5 @@
 import { BaseService } from '../base/base-service';
-import { GetCurrentClerkUserResponse } from './user-types';
+import { GetCurrentClerkUserResponse, CheckAdminStatusResponse } from './user-types';
 export declare class UserService extends BaseService {
     /**
      * Get the current Clerk user information
@@ -9,4 +9,12 @@ export declare class UserService extends BaseService {
      * @returns Promise resolving to the current Clerk user data
      */
     getCurrentClerkUser(): Promise<GetCurrentClerkUserResponse>;
+    /**
+     * Check if the current authenticated user has admin role
+     *
+     * GET /users/me/admin
+     *
+     * @returns Promise resolving to admin status data
+     */
+    checkAdminStatus(): Promise<CheckAdminStatusResponse>;
 }

package/dist/services/users/user-service.js

@@ -13,5 +13,15 @@ class UserService extends base_service_1.BaseService {
     async getCurrentClerkUser() {
         return this.get('/users/me/clerk');
     }
+    /**
+     * Check if the current authenticated user has admin role
+     *
+     * GET /users/me/admin
+     *
+     * @returns Promise resolving to admin status data
+     */
+    async checkAdminStatus() {
+        return this.get('/users/me/admin');
+    }
 }
 exports.UserService = UserService;

package/dist/services/users/user-types.d.ts

@@ -53,3 +53,17 @@ export interface GetCurrentClerkUserResponse {
     status: 'success' | 'error';
     data: ClerkUserData;
 }
+/**
+ * Admin status check data
+ */
+export interface AdminStatusData {
+    is_admin: boolean;
+    user_id: string;
+}
+/**
+ * Response for checking if current user is admin
+ */
+export interface CheckAdminStatusResponse {
+    status: 'success' | 'error';
+    data: AdminStatusData;
+}

package/index.ts

@@ -19,6 +19,9 @@ export type {
   GetProjectsRequest,
   PaginatedProjectsRequest,
   PaginatedProjectsResponse,
+  AITool,
+  GetAiToolsRequest,
+  GetAiToolsResponse,
 } from './services/projects/project-types'
 export type {
   CreateCodespaceTaskRequestV2 as CreateCodespaceTaskRequest,
@@ -54,3 +57,10 @@ export type {
   GetStarterKitsRequest,
   GetStarterKitsResponse,
 } from './services/starter-kits/starter-kits-types'
+
+// Export data management types for convenience
+export type {
+  DataStatsResponse,
+  DeleteAllDataRequest,
+  DeleteAllDataResponse,
+} from './services/data-management/data-management-types'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeguide/core",
-  "version": "0.0.33",
+  "version": "0.0.36",
   "description": "Core package for code guidance with programmatic API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/services/chat/chat-service.ts

@@ -0,0 +1,110 @@
+import { BaseService } from '../base/base-service'
+import {
+  GetDocumentTypesRequest,
+  GetDocumentTypesResponse,
+  GetChatsByDocumentTypeRequest,
+  GetChatsByDocumentTypeResponse,
+  GetChatHistoryRequest,
+  GetChatHistoryResponse,
+  ListDocumentChatsRequest,
+  ListDocumentChatsResponse,
+  GetChatByDocumentIdRequest,
+  GetChatByDocumentIdResponse,
+} from './chat-types'
+
+export 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
+   */
+  async getDocumentTypes(request: GetDocumentTypesRequest): Promise<GetDocumentTypesResponse> {
+    return this.get<GetDocumentTypesResponse>(`/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: GetChatsByDocumentTypeRequest
+  ): Promise<GetChatsByDocumentTypeResponse> {
+    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<GetChatsByDocumentTypeResponse>(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: GetChatHistoryRequest): Promise<GetChatHistoryResponse> {
+    return this.get<GetChatHistoryResponse>(`/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: ListDocumentChatsRequest = {}
+  ): Promise<ListDocumentChatsResponse> {
+    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<ListDocumentChatsResponse>(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: GetChatByDocumentIdRequest
+  ): Promise<GetChatByDocumentIdResponse> {
+    return this.get<GetChatByDocumentIdResponse>(
+      `/chat/document/by-document/${request.document_id}`
+    )
+  }
+}

package/services/chat/chat-types.ts

@@ -0,0 +1,145 @@
+// ============================================================================
+// Document Chat GET Endpoint Types
+// ============================================================================
+
+// ============================================================================
+// 1. GET /chat/document/types/{project_id}
+// Get document types for UI grouping
+// ============================================================================
+
+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'
+
+// ============================================================================
+// 2. GET /chat/document/by-type/{project_id}/{document_type}
+// List all chats for a specific document type (PRIMARY endpoint for UI)
+// ============================================================================
+
+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
+}
+
+// ============================================================================
+// 3. GET /chat/document/history/{conversation_id}
+// Get full chat history with messages
+// ============================================================================
+
+export interface GetChatHistoryRequest {
+  conversation_id: string
+}
+
+export interface GetChatHistoryResponse {
+  conversation: DocumentConversation
+  messages: ChatMessage[]
+}
+
+// ============================================================================
+// 4. GET /chat/document/list
+// List all chats for current user (with optional filters)
+// ============================================================================
+
+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
+}
+
+// ============================================================================
+// 5. GET /chat/document/by-document/{document_id}
+// Get chat by specific document version ID (Legacy)
+// ============================================================================
+
+export interface GetChatByDocumentIdRequest {
+  document_id: string
+}
+
+export interface GetChatByDocumentIdResponse {
+  conversation: DocumentConversation
+  messages: ChatMessage[]
+}
+
+// ============================================================================
+// Common Types
+// ============================================================================
+
+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/services/chat/index.ts

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

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

@@ -0,0 +1,74 @@
+import { BaseService } from '../base/base-service'
+import {
+  DataStatsResponse,
+  DeleteAllDataRequest,
+  DeleteAllDataResponse,
+  DataExportResponse,
+} from './data-management-types'
+
+export 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
+   */
+  async getDataStats(): Promise<DataStatsResponse> {
+    return this.get<DataStatsResponse>('/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(): Promise<DataExportResponse> {
+    return this.get<DataExportResponse>('/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: DeleteAllDataRequest): Promise<DeleteAllDataResponse> {
+    // 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<DeleteAllDataResponse>('/data/all')
+  }
+}