@codeguide/core 0.0.28 → 0.0.33

package/services/projects/project-types.ts

@@ -1,31 +1,50 @@
+
 export interface ProjectRepository {
   id: string
-  project_id: string
+  name: string
   repo_url: string
   branch: string
+  project_id: string
+  user_id: string
+  files_processed: number
+  total_characters: number
+  total_lines: number
+  total_files_found: number
+  total_directories: number
   author: string
-  name: string
-  connection_status: 'pending' | 'connected' | 'failed'
+  estimated_tokens: number
+  estimated_size_bytes: number
+  tree_structure?: string
   created_at: string
-  updated_at: string
 }
 
 export interface Project {
   id: string
   title: string
   description: string
-  user_id: string
+  status: string
+  category_id: string
+  starter_kit_id?: string
+  ai_questionaire?: {
+    experience_level?: string
+    timeline?: string
+    team_size?: number
+  }
+  tools_selected?: string[]
+  project_outline?: {
+    features?: string[]
+    architecture?: string
+  }
+  codie_tool_id?: string
+  existing_project_repo_url?: string | null
   created_at: string
   updated_at: string
+  user_id: string
   project_documents: ProjectDocument[]
-  project_repositories: ProjectRepository[]
   category?: Category
+  starter_kit?: StarterKitReference
   codie_tool?: CodieTool
-  github_url?: string
-  status?: string
-  tools_selected?: string[]
-  ai_questionaire?: Record<string, any>
-  project_outline?: Record<string, any>
+  project_repositories: ProjectRepository[]
 }
 
 export interface ProjectDocument {
@@ -56,37 +75,62 @@ export interface GetProjectDocumentsResponse {
 export interface Category {
   id: string
   name: string
-  description?: string
+  description: string
 }
 
 export interface CodieTool {
   id: string
   name: string
-  description?: string
-  category?: string
+  description: string
+  type: string
+  api_endpoint?: string
+  created_at?: string
+  updated_at?: string
+}
+
+export interface StarterKitReference {
+  id: string
+  name: string
+  description: string
 }
 
 export interface CreateProjectRequest {
   title: string
   description: string
   category_id?: string
-  codie_tool_id?: string
+  starter_kit_id?: string
+  ai_questionaire?: {
+    experience_level?: string
+    timeline?: string
+    team_size?: number
+  }
   tools_selected?: string[]
-  ai_questionaire?: Record<string, any>
-  project_outline?: Record<string, any>
-  github_url?: string
+  project_outline?: {
+    features?: string[]
+    architecture?: string
+  }
+  codie_tool_id?: string
+  existing_project_repo_url?: string
 }
 
 export interface UpdateProjectRequest {
   title?: string
   description?: string
+  status?: string
   category_id?: string
-  codie_tool_id?: string
+  starter_kit_id?: string
+  ai_questionaire?: {
+    experience_level?: string
+    timeline?: string
+    team_size?: number
+  }
   tools_selected?: string[]
-  ai_questionaire?: Record<string, any>
-  project_outline?: Record<string, any>
-  github_url?: string
-  status?: string
+  project_outline?: {
+    features?: string[]
+    architecture?: string
+  }
+  codie_tool_id?: string
+  existing_project_repo_url?: string
 }
 
 export interface ProjectListResponse {
@@ -131,13 +175,6 @@ export interface ConnectRepositoryRequest {
 
 export interface ConnectRepositoryResponse {
   status: string
-  data: {
-    id: string
-    project_id: string
-    repo_url: string
-    branch: string
-    connection_status: 'pending' | 'connected' | 'failed'
-    created_at: string
-    updated_at: string
-  }
+  data: ProjectRepository
 }
+

package/services/starter-kits/index.ts

@@ -0,0 +1,2 @@
+export { StarterKitsService } from './starter-kits-service'
+export * from './starter-kits-types'

package/services/starter-kits/starter-kits-service.ts

@@ -0,0 +1,33 @@
+import { BaseService } from '../base/base-service'
+import {
+  StarterKit,
+  GetStarterKitsRequest,
+  GetStarterKitsResponse,
+} from './starter-kits-types'
+
+export class StarterKitsService extends BaseService {
+  /**
+   * Get starter kits with optional filtering
+   *
+   * GET /starter-kits/
+   *
+   * @param params Optional query parameters for filtering
+   * @returns Promise resolving to an array of starter kits
+   */
+  async getStarterKits(params?: GetStarterKitsRequest): Promise<StarterKit[]> {
+    const queryParams = new URLSearchParams()
+
+    if (params?.name) {
+      queryParams.append('name', params.name)
+    }
+
+    if (params?.repo_name) {
+      queryParams.append('repo_name', params.repo_name)
+    }
+
+    const url = `/starter-kits${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
+    const response = await this.get<GetStarterKitsResponse>(url)
+    return response.data
+  }
+}
+

package/services/starter-kits/starter-kits-types.ts

@@ -0,0 +1,38 @@
+/**
+ * Starter Kit metadata
+ */
+export interface StarterKitMetadata {
+  [key: string]: any
+}
+
+/**
+ * Starter Kit data structure
+ */
+export interface StarterKit {
+  id: string
+  created_at: string
+  updated_at: string
+  name: string
+  repo_name: string | null
+  kit_name: string | null
+  metadata: StarterKitMetadata | null
+  project_structure: string | null
+  ordinal: number | null
+}
+
+/**
+ * Request parameters for getting starter kits
+ */
+export interface GetStarterKitsRequest {
+  name?: string
+  repo_name?: string
+}
+
+/**
+ * Response for getting starter kits
+ */
+export interface GetStarterKitsResponse {
+  status: 'success' | 'error'
+  data: StarterKit[]
+}
+

package/services/subscriptions/subscription-service.ts

@@ -4,6 +4,9 @@ import {
   UserSubscriptionsResponse,
   CancelSubscriptionRequest,
   CancelSubscriptionResponse,
+  SubscriptionProductsResponse,
+  CreateCheckoutSessionRequest,
+  CreateCheckoutSessionResponse,
 } from '../../types'
 
 export class SubscriptionService extends BaseService {
@@ -11,6 +14,16 @@ export class SubscriptionService extends BaseService {
     super(config)
   }
 
+  /**
+   * Create a Stripe checkout session for subscription purchase
+   * POST /subscriptions/create-checkout-session
+   */
+  async createCheckoutSession(
+    request: CreateCheckoutSessionRequest
+  ): Promise<CreateCheckoutSessionResponse> {
+    return this.post<CreateCheckoutSessionResponse>('/subscriptions/create-checkout-session', request)
+  }
+
   /**
    * Get the currently active subscription for the authenticated user
    * GET /subscriptions/current
@@ -27,6 +40,14 @@ export class SubscriptionService extends BaseService {
     return this.get<UserSubscriptionsResponse>('/subscriptions/')
   }
 
+  /**
+   * Get all available subscription products and their prices
+   * GET /subscriptions/products
+   */
+  async getSubscriptionProducts(): Promise<SubscriptionProductsResponse> {
+    return this.get<SubscriptionProductsResponse>('/subscriptions/products')
+  }
+
   /**
    * Cancel subscription but keep it active until the end of the current billing period
    * POST /subscriptions/{subscription_id}/cancel
@@ -35,10 +56,7 @@ export class SubscriptionService extends BaseService {
     subscriptionId: string,
     request: CancelSubscriptionRequest
   ): Promise<CancelSubscriptionResponse> {
-    return this.post<CancelSubscriptionResponse>(
-      `/subscriptions/${subscriptionId}/cancel`,
-      request
-    )
+    return this.post<CancelSubscriptionResponse>(`/subscriptions/${subscriptionId}/cancel`, request)
   }
 
   /**
@@ -144,4 +162,4 @@ export class SubscriptionService extends BaseService {
   }> {
     return this.get(`/subscriptions/${subscriptionId}/history`)
   }
-}
+}

package/services/tasks/task-service.ts

@@ -173,4 +173,14 @@ export class TaskService extends BaseService {
   async updateTask(taskId: string, request: UpdateTaskRequest): Promise<UpdateTaskResponse> {
     return this.put<UpdateTaskResponse>(`/project-tasks/${taskId}`, request)
   }
+
+  // Get Project Tasks by Codespace
+  async getProjectTasksbyCodespace(codespaceTaskId: string): Promise<ProjectTaskListResponse> {
+    if (!codespaceTaskId) {
+      throw new Error('Codespace task ID is required')
+    }
+
+    const url = `/project-tasks/by-codespace/${codespaceTaskId}`
+    return this.get<ProjectTaskListResponse>(url)
+  }
 }

package/services/tasks/task-types.ts

@@ -23,19 +23,41 @@ export interface RawTask {
   status?: string
 }
 
-export interface ProjectTask {
+export interface ProjectTaskSubtask {
   id: string
   title: string
-  description?: string
+  description: string
+  details: string
   status: string
-  priority?: string
-  user_id: string
+  test_strategy: string
+  priority: string
+  ordinal: number
   task_group_id: string
-  parent_task_id?: string
+  parent_task_id: string
+  ai_result: string
+  created_at: string
+  user_id: string
+}
+
+export interface ProjectTask {
+  id: string
+  title: string
+  description: string
+  details: string
+  status: string
+  test_strategy: string
+  priority: string
   ordinal: number
+  task_group_id: string
+  parent_task_id: string
+  ai_result: string
   created_at: string
-  updated_at: string
-  subtasks?: ProjectTask[]
+  user_id: string
+  subtasks?: ProjectTaskSubtask[]
+  // Optional fields for backward compatibility
+  updated_at?: string
+  // Legacy support for simpler subtask structure
+  subtasks_legacy?: ProjectTask[]
 }
 
 export interface CreateTaskGroupRequest {

package/services/usage/usage-service.ts

@@ -15,6 +15,12 @@ import {
   TrackCodespaceUsageResponse,
   CodespaceTaskUsageResponse,
   HealthResponse,
+  DashboardAnalyticsRequest,
+  DashboardAnalyticsResponse,
+  UsageDetailsRequest,
+  UsageDetailsResponse,
+  ServiceBreakdownRequest,
+  ServiceBreakdownResponse,
 } from './usage-types'
 
 export class UsageService extends BaseService {
@@ -29,6 +35,7 @@ export class UsageService extends BaseService {
   async checkCredits(params: CreditCheckRequest): Promise<CreditCheckResponse> {
     const queryParams = new URLSearchParams()
 
+    queryParams.append('model_key', params.model_key)
     if (params.input_tokens !== undefined)
       queryParams.append('input_tokens', params.input_tokens.toString())
     if (params.output_tokens !== undefined)
@@ -40,16 +47,7 @@ export class UsageService extends BaseService {
     return this.get<CreditCheckResponse>(url)
   }
 
-  async getUsageSummary(params?: UsageSummaryRequest): Promise<UsageSummaryResponse> {
-    const queryParams = new URLSearchParams()
-
-    if (params?.start_date) queryParams.append('start_date', params.start_date)
-    if (params?.end_date) queryParams.append('end_date', params.end_date)
-
-    const url = `/usage/summary${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
-    return this.get<UsageSummaryResponse>(url)
-  }
-
+  
   async getAuthorization(): Promise<AuthorizationResponse> {
     return this.get<AuthorizationResponse>('/usage/authorization')
   }
@@ -93,4 +91,55 @@ export class UsageService extends BaseService {
       return false
     }
   }
+
+  // Dashboard Analytics Methods
+  async getDashboardAnalytics(params?: DashboardAnalyticsRequest): Promise<DashboardAnalyticsResponse> {
+    const queryParams = new URLSearchParams()
+
+    if (params?.period) queryParams.append('period', params.period)
+    if (params?.start_date) queryParams.append('start_date', params.start_date)
+    if (params?.end_date) queryParams.append('end_date', params.end_date)
+    if (params?.service_type) queryParams.append('service_type', params.service_type)
+
+    const url = `/usage/dashboard/analytics${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
+    return this.get<DashboardAnalyticsResponse>(url)
+  }
+
+  async getUsageDetails(params?: UsageDetailsRequest): Promise<UsageDetailsResponse> {
+    const queryParams = new URLSearchParams()
+
+    if (params?.period) queryParams.append('period', params.period)
+    if (params?.start_date) queryParams.append('start_date', params.start_date)
+    if (params?.end_date) queryParams.append('end_date', params.end_date)
+    if (params?.service_type) queryParams.append('service_type', params.service_type)
+    if (params?.page !== undefined) queryParams.append('page', params.page.toString())
+    if (params?.page_size !== undefined) queryParams.append('page_size', params.page_size.toString())
+    if (params?.sort_by) queryParams.append('sort_by', params.sort_by)
+    if (params?.sort_order) queryParams.append('sort_order', params.sort_order)
+
+    const url = `/usage/dashboard/details${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
+    return this.get<UsageDetailsResponse>(url)
+  }
+
+  async getUsageSummary(params?: UsageSummaryRequest): Promise<UsageSummaryResponse> {
+    const queryParams = new URLSearchParams()
+
+    if (params?.period) queryParams.append('period', params.period)
+    if (params?.start_date) queryParams.append('start_date', params.start_date)
+    if (params?.end_date) queryParams.append('end_date', params.end_date)
+
+    const url = `/usage/dashboard/summary${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
+    return this.get<UsageSummaryResponse>(url)
+  }
+
+  async getServiceBreakdown(params?: ServiceBreakdownRequest): Promise<ServiceBreakdownResponse> {
+    const queryParams = new URLSearchParams()
+
+    if (params?.period) queryParams.append('period', params.period)
+    if (params?.start_date) queryParams.append('start_date', params.start_date)
+    if (params?.end_date) queryParams.append('end_date', params.end_date)
+
+    const url = `/usage/dashboard/services${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
+    return this.get<ServiceBreakdownResponse>(url)
+  }
 }

package/services/usage/usage-types.ts

@@ -13,7 +13,7 @@ export interface TrackUsageResponse {
   message: string
 }
 
-export interface CreditBalanceResponse {
+export interface CreditBalanceData {
   user_id: string
   total_consumed: number
   total_allotted: number
@@ -27,6 +27,10 @@ export interface CreditBalanceResponse {
   }
 }
 
+export interface CreditBalanceResponse {
+  data: CreditBalanceData
+}
+
 export interface CreditCheckRequest {
   model_key: string
   input_tokens?: number
@@ -41,33 +45,6 @@ export interface CreditCheckResponse {
   model_key: string
 }
 
-export interface UsageSummaryRequest {
-  start_date?: string
-  end_date?: string
-}
-
-export interface UsageSummaryResponse {
-  user_id: string
-  period: {
-    start_date: string
-    end_date: string
-  }
-  usage_summary: {
-    total_credits_used: number
-    total_calls: number
-    model_breakdown: Record<string, any>
-    daily_usage: Array<{
-      date: string
-      credits_used: number
-      calls: number
-    }>
-  }
-  subscription: {
-    plan: string
-    status: string
-  }
-}
-
 export interface CreditBalance {
   total_allotted: number
   total_consumed: number
@@ -183,15 +160,15 @@ export interface TrackCodespaceUsageResponse {
   created_at: string
 }
 
+export interface CodespaceTaskUsageData {
+  total_records: number
+  total_credits_consumed: number
+  latest_usage: string
+}
+
 export interface CodespaceTaskUsageResponse {
-  codespace_task_id: string
-  total_usage: {
-    total_input_tokens: number
-    total_output_tokens: number
-    total_call_seconds: number
-    total_cost: number
-  }
-  usage_records: TrackCodespaceUsageResponse[]
+  status: string
+  data: CodespaceTaskUsageData
 }
 
 export interface HealthResponse {
@@ -199,3 +176,176 @@ export interface HealthResponse {
   timestamp: string
   version: string
 }
+
+// Dashboard Analytics Types
+export type PeriodType = '7d' | '1w' | '1m' | '3m'
+export type ServiceType = 'docs' | 'chat' | 'codespace_task' | 'api'
+export type SortOrder = 'asc' | 'desc'
+export type SortByField = 'created_at' | 'credits_consumed' | 'cost_amount'
+
+export interface DashboardAnalyticsRequest {
+  period?: PeriodType
+  start_date?: string
+  end_date?: string
+  service_type?: ServiceType
+}
+
+export interface DailyUsage {
+  date: string
+  credits_consumed: number
+  cost_usd: number
+  requests_count: number
+  average_credits_per_request: number
+}
+
+export interface ServiceUsage {
+  service_type: ServiceType
+  credits_consumed: number
+  requests_count: number
+}
+
+export interface AnalyticsTotals {
+  credits_consumed: number
+  cost_usd: number
+  requests_count: number
+}
+
+export interface AnalyticsAverages {
+  daily_credits: number
+  daily_requests: number
+}
+
+export interface AnalyticsTrends {
+  credits_consumed: number
+  requests_count: number
+}
+
+export interface PeriodInfo {
+  start: string
+  end: string
+  label: string
+}
+
+export interface DashboardAnalyticsResponse {
+  status: string
+  data: {
+    period: PeriodInfo
+    daily_usage: DailyUsage[]
+    totals: AnalyticsTotals
+    averages: AnalyticsAverages
+    trends: AnalyticsTrends
+    top_services: ServiceUsage[]
+  }
+}
+
+// Usage Details Types
+export interface UsageDetailsRequest {
+  period?: PeriodType
+  start_date?: string
+  end_date?: string
+  service_type?: ServiceType
+  page?: number
+  page_size?: number
+  sort_by?: SortByField
+  sort_order?: SortOrder
+}
+
+export interface UsageDetailRecord {
+  id: string
+  created_at: string
+  service_type: ServiceType
+  model_name: string
+  usage_type: string
+  units_consumed: number
+  credits_consumed: number
+  cost_amount: number | null
+}
+
+export interface UsageDetailsPagination {
+  page: number
+  page_size: number
+  total_count: number
+  total_pages: number
+  has_next: boolean
+  has_prev: boolean
+}
+
+export interface UsageDetailsFilters {
+  period: string | null
+  start_date: string | null
+  end_date: string | null
+  service_type: string | null
+}
+
+export interface UsageDetailsResponse {
+  status: string
+  data: UsageDetailRecord[]
+  pagination: UsageDetailsPagination
+  filters: UsageDetailsFilters
+}
+
+// Usage Summary Types
+export interface UsageSummaryRequest {
+  period?: PeriodType
+  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
+  }
+}
+
+// Service Breakdown Types
+export interface ServiceBreakdownRequest {
+  period?: PeriodType
+  start_date?: string
+  end_date?: string
+}
+
+export interface ServiceBreakdown {
+  service_type: ServiceType
+  credits_consumed: number
+  percentage: number
+  cost_usd: number
+  requests_count: number
+  trend: number
+}
+
+export interface ServiceBreakdownData {
+  period: PeriodInfo
+  services: ServiceBreakdown[]
+  total_credits: number
+  total_cost: number
+}
+
+export interface ServiceBreakdownResponse {
+  status: string
+  data: ServiceBreakdownData
+}