@codeguide/core 0.0.1

package/services/generation/generation-service.ts

@@ -0,0 +1,81 @@
+import { BaseService } from '../base/base-service'
+import {
+  RefinePromptRequest,
+  RefinePromptResponse,
+  GenerateTitleRequest,
+  GenerateTitleResponse,
+  GenerateQuestionnaireRequest,
+  GenerateQuestionnaireResponse,
+  GeneratePRDRequest,
+  GeneratePRDResponse,
+  GenerateCategoryRequest,
+  GenerateCategoryResponse,
+  GenerateOutlineRequest,
+  GenerateOutlineResponse,
+  GenerateDocumentRequest,
+  GenerateDocumentResponse,
+  GenerateMultipleDocumentsRequest,
+  GenerateMultipleDocumentsResponse,
+  GenerateMissingDocumentsRequest,
+  GenerateMissingDocumentsResponse,
+  BackgroundGenerationRequest,
+  BackgroundGenerationResponse,
+  BackgroundGenerationStatusResponse,
+} from './generation-types'
+
+export class GenerationService extends BaseService {
+  async refinePrompt(request: RefinePromptRequest): Promise<RefinePromptResponse> {
+    return this.post<RefinePromptResponse>('/generate/refine-prompt', request)
+  }
+
+  async generateTitle(request: GenerateTitleRequest): Promise<GenerateTitleResponse> {
+    return this.post<GenerateTitleResponse>('/generate/title', request)
+  }
+
+  async generateQuestionnaire(
+    request: GenerateQuestionnaireRequest
+  ): Promise<GenerateQuestionnaireResponse> {
+    return this.post<GenerateQuestionnaireResponse>('/generate/questionnaire', request)
+  }
+
+  async generatePRD(request: GeneratePRDRequest): Promise<GeneratePRDResponse> {
+    return this.post<GeneratePRDResponse>('/generate/prd', request)
+  }
+
+  async generateCategory(request: GenerateCategoryRequest): Promise<GenerateCategoryResponse> {
+    return this.post<GenerateCategoryResponse>('/generate/category', request)
+  }
+
+  async generateOutline(request: GenerateOutlineRequest): Promise<GenerateOutlineResponse> {
+    return this.post<GenerateOutlineResponse>('/generate/outline', request)
+  }
+
+  async generateDocument(request: GenerateDocumentRequest): Promise<GenerateDocumentResponse> {
+    return this.post<GenerateDocumentResponse>('/generate/document', request)
+  }
+
+  async generateMultipleDocuments(
+    request: GenerateMultipleDocumentsRequest
+  ): Promise<GenerateMultipleDocumentsResponse> {
+    return this.post<GenerateMultipleDocumentsResponse>('/generate/multiple-documents', request)
+  }
+
+  async generateMissingDocuments(
+    request: GenerateMissingDocumentsRequest
+  ): Promise<GenerateMissingDocumentsResponse> {
+    return this.post<GenerateMissingDocumentsResponse>(
+      '/generate/generate-missing-documents',
+      request
+    )
+  }
+
+  async startBackgroundGeneration(
+    request: BackgroundGenerationRequest
+  ): Promise<BackgroundGenerationResponse> {
+    return this.post<BackgroundGenerationResponse>('/generate/background', request)
+  }
+
+  async getBackgroundGenerationStatus(jobId: string): Promise<BackgroundGenerationStatusResponse> {
+    return this.get<BackgroundGenerationStatusResponse>(`/generate/background/${jobId}/status`)
+  }
+}

package/services/generation/generation-types.ts

@@ -0,0 +1,131 @@
+export interface RefinePromptRequest {
+  user_prompt: string
+  image_urls?: string[]
+  language?: string
+  context?: string
+}
+
+export interface RefinePromptResponse {
+  refined_prompt: string
+}
+
+export interface GenerateTitleRequest {
+  description: string
+  is_deep_research?: boolean
+}
+
+export interface GenerateTitleResponse {
+  title: string
+}
+
+export interface GenerateQuestionnaireRequest {
+  project_context: string
+}
+
+export interface GenerateQuestionnaireResponse {
+  questions: string[]
+}
+
+export interface GeneratePRDRequest {
+  description: string
+  selected_tools: string[]
+  answers: Record<string, any>
+  outline?: string
+}
+
+export interface GeneratePRDResponse {
+  content: string
+}
+
+export interface GenerateCategoryRequest {
+  title: string
+  existing_categories?: string[]
+}
+
+export interface GenerateCategoryResponse {
+  category: string
+}
+
+export interface GenerateOutlineRequest {
+  project_type: string
+  description: string
+  selected_tools: string[]
+  answers: Record<string, any>
+  custom_document_type?: string
+  title?: string
+  outline?: string
+  prd?: string
+  app_flow?: string
+  tech_stack_doc?: string
+  starter_kit?: string
+}
+
+export interface GenerateOutlineResponse {
+  outline: string
+}
+
+export interface GenerateDocumentRequest {
+  project_type?: string
+  description: string
+  selected_tools: string[]
+  answers: Record<string, any>
+  outline?: string
+  custom_document_type?: string
+  prd?: string
+  app_flow?: string
+  tech_stack_doc?: string
+  title?: string
+  starter_kit?: string
+}
+
+export interface GenerateDocumentResponse {
+  content: string
+}
+
+export interface GenerateMultipleDocumentsRequest {
+  project_id: string
+  description: string
+  selected_tools: string[]
+  document_types: string[]
+  answers: Record<string, any>
+  outline?: string
+  prd?: string
+  app_flow?: string
+  tech_stack_doc?: string
+  starter_kit?: string
+}
+
+export interface GenerateMultipleDocumentsResponse {
+  success: boolean
+  error?: string
+}
+
+export interface BackgroundGenerationRequest {
+  project_id: string
+  document_types?: string[]
+}
+
+export interface BackgroundGenerationResponse {
+  job_id: string
+  status: string
+  message: string
+}
+
+export interface BackgroundGenerationStatusResponse {
+  job_id: string
+  status: string
+  progress: Record<string, any>
+  results: Record<string, any>
+  error?: string
+}
+
+export interface GenerateMissingDocumentsRequest {
+  project_id: string
+}
+
+export interface GenerateMissingDocumentsResponse {
+  success: boolean
+  message?: string
+  error?: string
+  generated_documents?: string[]
+}

package/services/generation/index.ts

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

package/services/index.ts

@@ -0,0 +1,22 @@
+import dotenv from 'dotenv'
+import path from 'path'
+
+// Load environment variables from project root
+dotenv.config({
+  path: path.resolve(__dirname, '../../../.env'),
+  quiet: true,
+})
+
+export { BaseService } from './base'
+export { GenerationService } from './generation'
+export { ProjectService } from './projects'
+export { UsageService } from './usage'
+export { RepositoryAnalysisService } from './repository-analysis'
+export { TaskService } from './tasks'
+
+// Re-export all types for convenience
+export * from './generation'
+export * from './projects'
+export * from './usage'
+export * from './repository-analysis'
+export * from './tasks'

package/services/projects/index.ts

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

package/services/projects/project-service.ts

@@ -0,0 +1,67 @@
+import { BaseService } from '../base/base-service'
+import {
+  Project,
+  CreateProjectRequest,
+  UpdateProjectRequest,
+  ProjectListResponse,
+  ProjectResponse,
+  PaginatedProjectsRequest,
+  PaginatedProjectsResponse,
+  GetProjectDocumentsRequest,
+  GetProjectDocumentsResponse,
+} from './project-types'
+
+export class ProjectService extends BaseService {
+  async getAllProjects(): Promise<Project[]> {
+    const response = await this.get<ProjectListResponse>('/projects')
+    return response.data
+  }
+
+  async getPaginatedProjects(params: PaginatedProjectsRequest): Promise<PaginatedProjectsResponse> {
+    const queryParams = new URLSearchParams()
+
+    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.search_query) queryParams.append('search_query', params.search_query)
+    if (params.status) queryParams.append('status', params.status)
+    if (params.start_date) queryParams.append('start_date', params.start_date)
+    if (params.end_date) queryParams.append('end_date', params.end_date)
+    if (params.sort_by_date) queryParams.append('sort_by_date', params.sort_by_date)
+
+    const url = `/projects/paginated${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
+    return this.get<PaginatedProjectsResponse>(url)
+  }
+
+  async getProjectById(projectId: string): Promise<Project> {
+    const response = await this.get<ProjectResponse>(`/projects/${projectId}`)
+    return response.data
+  }
+
+  async createProject(request: CreateProjectRequest): Promise<Project> {
+    const response = await this.post<ProjectResponse>('/projects', request)
+    return response.data
+  }
+
+  async updateProject(projectId: string, request: UpdateProjectRequest): Promise<Project> {
+    const response = await this.put<ProjectResponse>(`/projects/${projectId}`, request)
+    return response.data
+  }
+
+  async deleteProject(projectId: string): Promise<{ status: string; message: string }> {
+    return this.delete<{ status: string; message: string }>(`/projects/${projectId}`)
+  }
+
+  async getProjectDocuments(
+    projectId: string,
+    params?: GetProjectDocumentsRequest
+  ): Promise<GetProjectDocumentsResponse> {
+    const queryParams = new URLSearchParams()
+
+    if (params?.current_version_only !== undefined) {
+      queryParams.append('current_version_only', params.current_version_only.toString())
+    }
+
+    const url = `/projects/${projectId}/documents${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
+    return this.get<GetProjectDocumentsResponse>(url)
+  }
+}

package/services/projects/project-types.ts

@@ -0,0 +1,108 @@
+export interface Project {
+  id: string
+  title: string
+  description: string
+  user_id: string
+  created_at: string
+  updated_at: string
+  project_documents: ProjectDocument[]
+  category?: Category
+  codie_tool?: CodieTool
+  github_url?: string
+  status?: string
+  tools_selected?: string[]
+  ai_questionaire?: Record<string, any>
+  project_outline?: Record<string, any>
+}
+
+export interface ProjectDocument {
+  id: string
+  created_at: string
+  updated_at: string | null
+  project_id: string
+  user_id: string
+  title: string
+  document_type: string
+  description: string | null
+  content: string
+  custom_document_type: string
+  last_action: string
+  is_current_version: boolean
+  status: string
+}
+
+export interface GetProjectDocumentsRequest {
+  current_version_only?: boolean
+}
+
+export interface GetProjectDocumentsResponse {
+  status: string
+  data: ProjectDocument[]
+}
+
+export interface Category {
+  id: string
+  name: string
+  description?: string
+}
+
+export interface CodieTool {
+  id: string
+  name: string
+  description?: string
+  category?: string
+}
+
+export interface CreateProjectRequest {
+  title: string
+  description: string
+  category_id?: string
+  codie_tool_id?: string
+  tools_selected?: string[]
+  ai_questionaire?: Record<string, any>
+  project_outline?: Record<string, any>
+  github_url?: string
+}
+
+export interface UpdateProjectRequest {
+  title?: string
+  description?: string
+  category_id?: string
+  codie_tool_id?: string
+  tools_selected?: string[]
+  ai_questionaire?: Record<string, any>
+  project_outline?: Record<string, any>
+  github_url?: string
+  status?: string
+}
+
+export interface ProjectListResponse {
+  status: string
+  data: Project[]
+}
+
+export interface ProjectResponse {
+  status: string
+  data: Project
+}
+
+export interface PaginatedProjectsRequest {
+  page?: number
+  page_size?: number
+  search_query?: string
+  status?: string
+  start_date?: string
+  end_date?: string
+  sort_by_date?: 'asc' | 'desc'
+}
+
+export interface PaginatedProjectsResponse {
+  status: string
+  data: Project[]
+  pagination: {
+    total: number
+    page: number
+    page_size: number
+    total_pages: number
+  }
+}

package/services/repository-analysis/index.ts

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

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

@@ -0,0 +1,42 @@
+import { BaseService } from '../base/base-service'
+import {
+  AnalyzeRepositoryRequest,
+  AnalyzeRepositoryResponse,
+  RepositoryAnalysisStatusResponse,
+  RepositoryAnalysisResultResponse,
+  RepositoryListResponse,
+  RepositoryDetailsResponse,
+  DeleteRepositoryResponse,
+} from './repository-types'
+
+export class RepositoryAnalysisService extends BaseService {
+  async analyzeRepository(request: AnalyzeRepositoryRequest): Promise<AnalyzeRepositoryResponse> {
+    return this.post<AnalyzeRepositoryResponse>('/repository-analysis/analyze', request)
+  }
+
+  async getAnalysisStatus(taskId: string): Promise<RepositoryAnalysisStatusResponse> {
+    return this.get<RepositoryAnalysisStatusResponse>(`/repository-analysis/tasks/${taskId}`)
+  }
+
+  async getAnalysisResult(taskId: string): Promise<RepositoryAnalysisResultResponse> {
+    return this.get<RepositoryAnalysisResultResponse>(`/repository-analysis/tasks/${taskId}/result`)
+  }
+
+  async listRepositories(skip?: number, limit?: number): Promise<RepositoryListResponse> {
+    const queryParams = new URLSearchParams()
+
+    if (skip !== undefined) queryParams.append('skip', skip.toString())
+    if (limit !== undefined) queryParams.append('limit', limit.toString())
+
+    const url = `/repository-analysis/repositories${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
+    return this.get<RepositoryListResponse>(url)
+  }
+
+  async getRepositoryDetails(repoId: string): Promise<RepositoryDetailsResponse> {
+    return this.get<RepositoryDetailsResponse>(`/repository-analysis/repositories/${repoId}`)
+  }
+
+  async deleteRepository(repoId: string): Promise<DeleteRepositoryResponse> {
+    return this.delete<DeleteRepositoryResponse>(`/repository-analysis/repositories/${repoId}`)
+  }
+}

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

@@ -0,0 +1,99 @@
+export interface AnalyzeRepositoryRequest {
+  repository_url: string
+  generate_documents?: boolean
+  create_codespace_task?: boolean
+  project_id?: string
+}
+
+export interface AnalyzeRepositoryResponse {
+  task_id: string
+  status: string
+  message: string
+}
+
+export interface RepositoryAnalysisStatusResponse {
+  task_id: string
+  status: string
+  message: string
+  progress?: number
+}
+
+export interface RepositoryAnalysisResultResponse {
+  task_id: string
+  status: string
+  result: {
+    repository: RepositoryInfo
+    documents: RepositoryDocument[]
+    statistics: RepositoryStatistics
+  }
+}
+
+export interface RepositoryInfo {
+  id: string
+  name: string
+  full_name: string
+  description?: string
+  language?: string
+  stars: number
+  forks: number
+  open_issues: number
+  default_branch: string
+  created_at: string
+  updated_at: string
+  clone_url: string
+  homepage?: string
+  owner: {
+    login: string
+    id: number
+    avatar_url: string
+  }
+}
+
+export interface RepositoryDocument {
+  id: string
+  filename: string
+  path: string
+  content: string
+  language?: string
+  size: number
+  type: string
+  created_at: string
+  updated_at: string
+}
+
+export interface RepositoryStatistics {
+  total_files: number
+  total_lines_of_code: number
+  languages: Record<string, number>
+  file_types: Record<string, number>
+  dependencies: string[]
+  complexity_metrics: {
+    average_complexity: number
+    max_complexity: number
+    min_complexity: number
+  }
+}
+
+export interface RepositoryListResponse {
+  repositories: RepositoryInfo[]
+  total: number
+}
+
+export interface RepositoryDetailsResponse {
+  id: string
+  repository_url: string
+  user_id: string
+  created_at: string
+  updated_at: string
+  analysis_results?: {
+    repository: RepositoryInfo
+    documents: RepositoryDocument[]
+    statistics: RepositoryStatistics
+    analyzed_at: string
+  }
+}
+
+export interface DeleteRepositoryResponse {
+  status: string
+  message: string
+}

package/services/tasks/index.ts

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