first commit

Author: TatyOko28

.eslintrc.js

@@ -0,0 +1,49 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint', 'jest', 'react-hooks'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:jest/recommended',
+    'plugin:react-hooks/recommended',
+    'next/core-web-vitals',
+  ],
+  env: {
+    browser: true,
+    es2021: true,
+    node: true,
+    jest: true,
+  },
+  rules: {
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'warn',
+    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+    '@typescript-eslint/no-non-null-assertion': 'warn',
+
+    'react-hooks/rules-of-hooks': 'error',
+    'react-hooks/exhaustive-deps': 'warn',
+    'react/prop-types': 'off',
+    'react/react-in-jsx-scope': 'off',
+
+    'no-console': ['warn', { allow: ['warn', 'error'] }],
+    'no-debugger': 'warn',
+    'no-duplicate-imports': 'error',
+    'no-unused-vars': 'off', 
+  },
+  settings: {
+    react: {
+      version: 'detect',
+    },
+  },
+  ignorePatterns: [
+    'node_modules/',
+    '.next/',
+    'out/',
+    'dist/',
+    'build/',
+    '*.config.js',
+    '*.setup.js',
+  ],
+}; 

.github/workflows/ci.yml

@@ -0,0 +1,69 @@
+name: CI/CD
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x]
+
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v3
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Run linting
+      run: npm run lint
+    
+    - name: Run tests
+      run: npm test
+      env:
+        CI: true
+
+  deploy:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Use Node.js 18.x
+      uses: actions/setup-node@v3
+      with:
+        node-version: 18.x
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Build
+      run: npm run build
+      env:
+        NEXT_PUBLIC_API_URL: ${{ secrets.NEXT_PUBLIC_API_URL }}
+        SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
+        SUPABASE_SERVICE_ROLE_KEY: ${{ secrets.SUPABASE_SERVICE_ROLE_KEY }}
+    
+    - name: Deploy Web App
+      run: npm run deploy:web
+      env:
+        VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+    
+    - name: Deploy Worker
+      run: npm run deploy:worker
+      env:
+        CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}

.gitignore

@@ -0,0 +1,34 @@
+# Node modules
+node_modules/
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+pnpm-debug.log*
+
+# Next.js build output
+.next/
+out/
+
+# TypeScript build output
+dist/
+
+# Generated docs
+docs/
+
+# Worker build
+apps/worker/dist/
+
+# VSCode
+.vscode/
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Mac
+.DS_Store
+
+# Yarn
+yarn-error.log

.prettierrc

@@ -0,0 +1,11 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "endOfLine": "lf"
+} 

Dockerfile

@@ -0,0 +1,32 @@
+# Build stage
+FROM node:18-alpine AS builder
+
+WORKDIR /app
+
+
+COPY package*.json ./
+COPY apps/web/package*.json ./apps/web/
+COPY apps/api/package*.json ./apps/api/
+COPY packages/core/package*.json ./packages/core/
+COPY packages/llm/package*.json ./packages/llm/
+COPY packages/storage/package*.json ./packages/storage/
+ 
+RUN npm install
+
+COPY . .
+
+RUN npm run build
+
+FROM node:18-alpine
+
+WORKDIR /app
+
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package*.json ./
+ENV NODE_ENV=production
+ENV PORT=3000
+
+EXPOSE 3000
+
+CMD ["npm", "start"] 

README.md

@@ -0,0 +1,151 @@
+# TypeScript Documentation Generator
+
+A powerful tool that automatically generates documentation for your TypeScript code using AI-powered docstring generation and TypeDoc.
+
+## Features
+
+- 🚀 AI-powered docstring generation using OpenAI/Anthropic/Gemini
+- 📝 Automatic TypeScript documentation generation
+- 💻 Modern web interface with Monaco Editor
+- 📁 File upload and processing
+- 📊 Real-time progress tracking
+- 📦 Multiple output formats (HTML/Markdown)
+- 🎨 Customizable documentation templates
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18+ and npm/yarn
+- OpenAI/Anthropic/Gemini API key (for AI docstring generation)
+
+### Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/yourusername/ts-docgen.git
+cd ts-docgen
+```
+
+2. Install dependencies:
+```bash
+npm install
+```
+
+3. Set up environment variables:
+```bash
+cp .env.example .env
+# Edit .env with your API keys and configuration
+```
+
+4. Start the development server:
+```bash
+npm run dev:web
+```
+
+```bash
+cd ..
+```
+```bash
+cd worker
+```
+```bash
+npm run dev:worker
+```
+
+## Usage
+
+1. Open the web interface at `http://localhost:3000`
+2. Upload your TypeScript files or paste code directly
+3. Configure documentation settings
+4. Generate documentation
+5. Download or preview the results
+
+## API Documentation
+
+### Endpoints
+
+#### POST /api/upload
+Upload TypeScript files for documentation generation.
+
+**Request Body:**
+```typescript
+{
+  files: File[]
+}
+```
+
+
+
+#### GET /api/status/:key
+Get the status of a documentation generation job.
+
+
+**Response:**
+Documentation file (HTML/Markdown)
+
+## Services
+
+### VersioningService
+
+The VersioningService provides version control functionality for documentation files, allowing you to track changes, compare versions, and manage documentation history.
+
+#### Features
+
+- Create and manage versions of documentation files
+- Track changes and authors for each version
+- Compare different versions of documentation
+- Tag versions for better organization
+- Retrieve specific versions or the latest version
+
+
+## Configuration
+
+The application can be configured through environment variables:
+
+- `OPENAI_API_KEY`: OpenAI API key
+- `ANTHROPIC_API_KEY`: Anthropic API key
+- `GEMINI_API_KEY`: Gemini API key
+- `SUPABASE_URL`: Supabase project URL
+- `SUPABASE_SERVICE_ROLE_KEY`: Supabase service role key for storage access
+
+## Development
+
+
+
+### Running Tests
+
+```bash
+npm test
+```
+
+### Building for Production
+
+```bash
+npm run build
+```
+
+## Deployment
+
+### Production Deployment
+
+1. Build the application:
+```bash
+npm run build
+```
+
+2. Start the production server:
+```bash
+npm start
+```
+
+
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+

apps/web/.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts