@codeguide/core 0.0.28 → 0.0.29

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/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,32 +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
@@ -199,3 +177,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
+}