@codeguide/core 0.0.27 → 0.0.29

package/services/repository-analysis/repository-types.ts

@@ -9,6 +9,7 @@ export interface AnalyzeRepositoryRequest {
   codespace_task_description?: string
   codespace_branch?: string
   codespace_base_branch?: string
+  execution_mode?: 'implementation' | 'docs-only' | 'direct'
   model_api_keys?: {
     model_name: string
     api_key: string

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/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,45 +45,73 @@ export interface CreditCheckResponse {
   model_key: string
 }
 
-export interface UsageSummaryRequest {
-  start_date?: string
-  end_date?: string
+
+export interface CreditBalance {
+  total_allotted: number
+  total_consumed: number
+  remaining_credits: number
+  is_over_limit: boolean
+  utilization_percentage: number
+  billing_cycle_start: string
+  billing_cycle_end: 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 LimitInfo {
+  allowed?: boolean
+  current_usage?: number
+  limit: number
+  remaining?: number
+  period_type?: string
+  period_start?: string | null
+  period_end?: string | null
+  message?: string
+  is_unlimited: boolean
+  period?: string
+  description?: string
+}
+
+export interface PlanLimits {
+  plan_type: string
+  limits: {
+    codespace_tasks: LimitInfo
+    api_calls: LimitInfo
+    storage_gb: LimitInfo
+    projects: LimitInfo
+    collaborators: LimitInfo
   }
 }
 
-export interface AuthorizationResponse {
+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
+}
+
+export interface AuthorizationData {
   user_id: string
-  subscription: {
-    plan: string
-    status: string
-    features: string[]
-  }
-  usage_limits: {
-    monthly_credits: number
-    max_calls_per_day: number
-  }
-  permissions: string[]
+  subscription: AuthorizationSubscription | null
+  credit_balance: CreditBalance
+  has_active_subscription: boolean
+  has_previous_subscriptions: boolean
+  is_within_credit_limit: boolean
+  authorization_level: string
+  restrictions: string[]
+  can_create_tasks: boolean
+  can_analyze_repos: boolean
+  can_access_previous_projects: boolean
+  plan_limits: PlanLimits
+  codespace_task_limit: LimitInfo | null
+}
+
+export interface AuthorizationResponse {
+  success: boolean
+  data: AuthorizationData
+  message: string
 }
 
 export interface FreeUserStatusResponse {
@@ -145,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
+}

package/services/users/index.ts

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

package/services/users/user-service.ts

@@ -0,0 +1,15 @@
+import { BaseService } from '../base/base-service'
+import { GetCurrentClerkUserResponse } from './user-types'
+
+export class UserService extends BaseService {
+  /**
+   * Get the current Clerk user information
+   *
+   * GET /users/me/clerk
+   *
+   * @returns Promise resolving to the current Clerk user data
+   */
+  async getCurrentClerkUser(): Promise<GetCurrentClerkUserResponse> {
+    return this.get<GetCurrentClerkUserResponse>('/users/me/clerk')
+  }
+}

package/services/users/user-types.ts

@@ -0,0 +1,59 @@
+/**
+ * Email address verification information
+ */
+export interface EmailVerification {
+  status: 'verified' | 'unverified'
+  strategy: string
+}
+
+/**
+ * Email address information
+ */
+export interface EmailAddress {
+  id: string
+  email_address: string
+  verification: EmailVerification
+}
+
+/**
+ * Clerk user metadata
+ */
+export interface ClerkUserMetadata {
+  [key: string]: any
+}
+
+/**
+ * Clerk user data structure
+ */
+export interface ClerkUserData {
+  user_id: string
+  first_name: string | null
+  last_name: string | null
+  username: string | null
+  email_addresses: EmailAddress[]
+  phone_numbers: Array<{
+    id: string
+    phone_number: string
+    verification: {
+      status: 'verified' | 'unverified'
+      strategy: string
+    }
+  }>
+  primary_email_address: string | null
+  primary_phone_number: string | null
+  image_url: string | null
+  created_at: number
+  updated_at: number
+  last_sign_in_at: number | null
+  public_metadata: ClerkUserMetadata
+  private_metadata: ClerkUserMetadata
+  unsafe_metadata: ClerkUserMetadata
+}
+
+/**
+ * Response for getting current Clerk user
+ */
+export interface GetCurrentClerkUserResponse {
+  status: 'success' | 'error'
+  data: ClerkUserData
+}