Initial commit: ged2json.com GEDCOM to JSON converter

Author: ChasingImpact

.env.example

@@ -0,0 +1,5 @@
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+RATE_LIMIT_MAX=100
+RATE_LIMIT_WINDOW=86400000
+FILE_DELETION_TIMEOUT=3600000
+

.eslintrc.json

@@ -0,0 +1,4 @@
+{
+  "extends": "next/core-web-vitals"
+}
+

.github/workflows/test.yml

@@ -0,0 +1,30 @@
+name: Test
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '18'
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Run linter
+      run: npm run lint
+    
+    - name: Build
+      run: npm run build
+

.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pkg
+/.next
+/out
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+.env
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+# temp files
+/tmp
+

README.md

@@ -0,0 +1,152 @@
+# ged2json.com
+
+A privacy-first GEDCOM to JSON converter. Files are automatically deleted after 60 minutes.
+
+**Production Site:** https://ged2json.com/
+
+**API Documentation:** https://ged2json.com/developers
+
+## Features
+
+- Bidirectional conversion between GEDCOM and JSON formats
+- Zero data retention - files auto-delete after 60 minutes
+- Rate limiting (100 conversions per day per IP)
+- Family tree analytics and visualization
+- Dark/light theme support
+- Mobile responsive design
+
+## Tech Stack
+
+- Next.js 14 (App Router)
+- React 18
+- TypeScript
+- Tailwind CSS
+- Radix UI components
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18+
+- npm
+
+### Installation
+
+```bash
+npm install
+```
+
+### Development
+
+```bash
+npm run dev
+```
+
+Open http://localhost:3000 in your browser.
+
+### Build
+
+```bash
+npm run build
+npm start
+```
+
+## Environment Variables
+
+Copy `.env.example` to `.env.local` and configure:
+
+```
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+RATE_LIMIT_MAX=100
+RATE_LIMIT_WINDOW=86400000
+FILE_DELETION_TIMEOUT=3600000
+```
+
+## API Usage
+
+### Convert GEDCOM to JSON
+
+```bash
+curl -X POST https://ged2json.com/api/convert \
+  -F "[email protected]" \
+  -F "direction=ged-to-json"
+```
+
+### Convert JSON to GEDCOM
+
+```bash
+curl -X POST https://ged2json.com/api/convert \
+  -F "[email protected]" \
+  -F "direction=json-to-ged"
+```
+
+### Response
+
+```json
+{
+  "success": true,
+  "fileId": "uuid",
+  "treeUrl": "https://ged2json.com/api/download/{fileId}/tree",
+  "jsonUrl": "https://ged2json.com/api/download/{fileId}/json",
+  "deleteIn": "59:59",
+  "remaining": 99
+}
+```
+
+## Project Structure
+
+```
+ged2json/
+|-- app/
+|   |-- api/
+|   |   |-- convert/       # Main conversion endpoint
+|   |   |-- download/      # File download handler
+|   |   +-- email/         # Email collection
+|   |-- layout.tsx
+|   +-- page.tsx
+|-- components/
+|   |-- ui/                # Radix UI components
+|   |-- UploadZone.tsx
+|   |-- TreeVisualizer.tsx
+|   |-- JSONPreview.tsx
+|   +-- ...
+|-- lib/
+|   |-- parser.ts          # GEDCOM/JSON conversion
+|   |-- storage.ts         # Temp file management
+|   |-- rate-limit.ts      # Rate limiting
+|   |-- analytics.ts       # Family tree analytics
+|   +-- types.ts           # TypeScript types
++-- tmp/                   # Temporary file storage
+```
+
+## Supported GEDCOM Features
+
+- Individuals (names, genders, dates, places)
+- Families (marriages, divorces, children)
+- Events (birth, death, marriage, etc.)
+- Sources and citations
+- Repositories
+- Notes
+- Multimedia links
+- GEDCOM 5.5.1, 5.5.5, and 7.0 features
+
+## Deployment
+
+### Vercel (Recommended)
+
+1. Push your code to GitHub
+2. Import project in Vercel
+3. Deploy
+
+### Other Platforms
+
+The app can be deployed to any platform that supports Next.js:
+- Netlify
+- Railway
+- Render
+- AWS Amplify
+- Self-hosted
+
+## License
+
+MIT

app/api/convert/route.ts

@@ -0,0 +1,105 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { checkRateLimit } from '@/lib/rate-limit';
+import { saveFile, saveConvertedFiles, getTimeUntilDeletion, getFileMetadata } from '@/lib/storage';
+import { gedcomToJson, jsonToGedcom } from '@/lib/parser';
+
+export const runtime = 'nodejs';
+export const maxDuration = 30;
+
+export async function POST(request: NextRequest) {
+  try {
+    const rateLimit = checkRateLimit(request);
+    if (!rateLimit.allowed) {
+      return NextResponse.json(
+        {
+          success: false,
+          error: 'Rate limit exceeded. Maximum 100 conversions per day.',
+          resetTime: rateLimit.resetTime,
+        },
+        { status: 429 }
+      );
+    }
+
+    const formData = await request.formData();
+    const file = formData.get('file') as File;
+    const direction = formData.get('direction') as string;
+
+    if (!file) {
+      return NextResponse.json(
+        { success: false, error: 'No file provided' },
+        { status: 400 }
+      );
+    }
+
+    if (!direction || !['ged-to-json', 'json-to-ged'].includes(direction)) {
+      return NextResponse.json(
+        { success: false, error: 'Invalid direction. Must be "ged-to-json" or "json-to-ged"' },
+        { status: 400 }
+      );
+    }
+
+    const arrayBuffer = await file.arrayBuffer();
+    const buffer = Buffer.from(arrayBuffer);
+    const fileContent = buffer.toString('utf-8');
+
+    const fileId = saveFile(buffer, file.name, direction as 'ged-to-json' | 'json-to-ged');
+
+    let jsonContent: string | undefined;
+    let gedcomContent: string | undefined;
+
+    try {
+      if (direction === 'ged-to-json') {
+        const jsonData = gedcomToJson(fileContent);
+        jsonContent = JSON.stringify(jsonData, null, 2);
+        saveConvertedFiles(fileId, jsonContent);
+      } else {
+        const jsonData = JSON.parse(fileContent);
+        jsonContent = JSON.stringify(jsonData, null, 2);
+        gedcomContent = jsonToGedcom(jsonData);
+        saveConvertedFiles(fileId, jsonContent, gedcomContent);
+      }
+    } catch (error: any) {
+      return NextResponse.json(
+        {
+          success: false,
+          error: `Conversion failed: ${error.message || 'Invalid file format'}`,
+        },
+        { status: 400 }
+      );
+    }
+
+    const timeRemaining = getTimeUntilDeletion(fileId);
+    const metadata = getFileMetadata(fileId);
+    const uploadedAt = metadata?.uploadedAt || Date.now();
+
+    const baseUrl = process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000';
+    const treeUrl = `${baseUrl}/api/download/${fileId}/tree`;
+    const jsonUrl = direction === 'ged-to-json' 
+      ? `${baseUrl}/api/download/${fileId}/json`
+      : undefined;
+    const gedUrl = direction === 'json-to-ged'
+      ? `${baseUrl}/api/download/${fileId}/ged`
+      : undefined;
+
+    return NextResponse.json({
+      success: true,
+      fileId,
+      treeUrl,
+      jsonUrl,
+      gedUrl,
+      uploadedAt,
+      deleteIn: `${Math.floor(timeRemaining / 60000)}:${Math.floor((timeRemaining % 60000) / 1000).toString().padStart(2, '0')}`,
+      remaining: rateLimit.remaining,
+    });
+  } catch (error: any) {
+    console.error('Conversion error:', error);
+    return NextResponse.json(
+      {
+        success: false,
+        error: error.message || 'Internal server error',
+      },
+      { status: 500 }
+    );
+  }
+}
+