copit 1.0.0

package/README.md

@@ -0,0 +1,134 @@
+# copit
+
+A GitHub File Fetcher TUI application that allows you to browse and download files from GitHub repositories with OAuth authentication, fuzzy search, and download history management.
+
+## Features
+
+- 🔐 **GitHub OAuth Authentication** - Secure Device Flow authentication
+- 🔍 **Fuzzy Search** - Fast file and repository search using fuse.js
+- 📋 **Download History** - Track and quickly re-download recent files
+- 🚀 **Terminal UI** - Beautiful terminal interface built with ink + React
+- 💾 **Encrypted Storage** - Secure token storage with AES-256-GCM encryption
+- 🛡️ **Security** - Path traversal protection and input validation
+
+## Installation
+
+### Global Installation
+
+```bash
+# Install globally via npm
+npm install -g copit
+
+# Or install via bunx (recommended)
+bunx copit
+```
+
+### Local Development
+
+```bash
+# Clone the repository
+git clone https://github.com/mrsekut/copit.git
+cd copit
+
+# Install dependencies
+bun install
+
+# Run in development mode
+bun run dev
+```
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Run the application
+copit
+
+# Or with bunx
+bunx copit
+```
+
+### Environment Variables
+
+Create a `.env` file or set environment variables:
+
+```bash
+# GitHub OAuth Client ID (optional - uses default if not set)
+GITHUB_CLIENT_ID=your_github_client_id
+```
+
+### First Run
+
+1. Run `copit` command
+2. Follow the OAuth authentication flow
+3. Browse repositories and download files
+4. Use Tab to switch between History and Browse modes
+
+### Navigation
+
+- **↑/↓** - Navigate through lists
+- **Enter** - Select/Download files
+- **Tab** - Switch between History and Browse modes
+- **Esc** - Go back or exit
+- **Type** - Fuzzy search in any list
+
+## GitHub OAuth Setup
+
+To use your own GitHub OAuth App:
+
+1. Go to [GitHub Developer Settings](https://github.com/settings/applications/new)
+2. Create a new OAuth App with these settings:
+   - Application name: `copit` (or your preferred name)
+   - Homepage URL: `https://github.com/mrsekut/copit`
+   - Authorization callback URL: `http://localhost` (not used for device flow)
+3. Enable "Device Flow" in the app settings
+4. Copy the Client ID and set it as `GITHUB_CLIENT_ID` environment variable
+
+## Architecture
+
+Built with modern technologies and patterns:
+
+- **Runtime**: Bun
+- **UI**: ink + React for terminal interface
+- **State Management**: jotai
+- **Authentication**: GitHub OAuth Device Flow
+- **Search**: fuse.js for fuzzy search
+- **Architecture**: Package by Feature pattern
+- **Language**: TypeScript with strict type checking
+
+## Security
+
+- OAuth tokens are encrypted using AES-256-GCM
+- Path traversal protection for file downloads
+- Input validation and sanitization
+- No hardcoded secrets (configurable via environment variables)
+
+## Scripts
+
+```bash
+# Development
+bun run dev          # Start development server
+bun run build        # Build for production
+bun run typecheck    # Run TypeScript type checking
+bun run lint         # Run ESLint
+bun run format       # Format code with Prettier
+bun run test         # Run tests
+bun run check        # Run all checks (typecheck + lint + format + test)
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run `bun run check` to ensure code quality
+5. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Author
+
+[mrsekut](https://github.com/mrsekut)

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "copit",
+  "version": "1.0.0",
+  "description": "GitHub File Fetcher TUI - Download files from GitHub repositories with OAuth authentication, fuzzy search, and download history",
+  "module": "src/index.tsx",
+  "type": "module",
+  "private": false,
+  "bin": {
+    "copit": "./dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "github",
+    "cli",
+    "download"
+  ],
+  "author": "mrsekut",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrsekut/copit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mrsekut/copit/issues"
+  },
+  "homepage": "https://github.com/mrsekut/copit#readme",
+  "scripts": {
+    "dev": "bun run src/index.tsx",
+    "build": "bun build src/index.tsx --outdir dist --target node",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --ext .ts,.tsx --fix",
+    "format": "prettier --write .",
+    "test": "vitest",
+    "check": "bun typecheck && bun lint && bun format && bun test"
+  },
+  "dependencies": {
+    "@octokit/auth-oauth-device": "^8.0.1",
+    "@octokit/rest": "^21.0.2",
+    "fuse.js": "^7.0.0",
+    "ink": "^5.0.1",
+    "ink-select-input": "^6.2.0",
+    "ink-text-input": "^6.0.0",
+    "jotai": "^2.12.5",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^22.10.5",
+    "@types/react": "^18.3.18",
+    "@typescript-eslint/eslint-plugin": "^8.20.0",
+    "@typescript-eslint/parser": "^8.20.0",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-react": "^7.37.3",
+    "eslint-plugin-react-hooks": "^5.1.0",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  }
+}