Files

T

arsam 0d17401286 Import documentation: backend/README.md

Import the existing local project snapshot. This commit organizes existing files; it does not represent newly developed functionality.

2026-09-18 23:15:34 +03:30

src

Import source: backend/src/worker

2026-09-18 23:13:47 +03:30

test

Import tests: backend/test/api

2026-09-18 23:13:49 +03:30

.env.example

Import source: backend/.env.example

2026-09-18 23:12:21 +03:30

.gitignore

Import project configuration: backend/.gitignore

2026-09-18 23:12:14 +03:30

ecosystem.config.cjs

Import project configuration: backend/ecosystem.config.cjs

2026-09-18 23:12:15 +03:30

eslint.config.mjs

Import project configuration: backend/eslint.config.mjs

2026-09-18 23:12:15 +03:30

package-lock.json

Import JavaScript dependencies for backend

2026-09-18 23:12:12 +03:30

package.json

Import JavaScript dependencies for backend

2026-09-18 23:12:12 +03:30

README.md

Import documentation: backend/README.md

2026-09-18 23:15:34 +03:30

tsconfig.json

Import project configuration: backend/tsconfig.json

2026-09-18 23:12:16 +03:30

README.md

CShare Backend

This is the local production-path API scaffold from CONTINUE.md. It uses Express 5 and TypeScript with local JSON metadata plus disk storage so upload, share, preview, download, dashboard, and auth flows work without external infrastructure.

Commands

npm install
npm run dev
npm run check
npm test
npm run build

The API listens on http://localhost:4001 by default. Frontend requests use VITE_API_BASE_URL; in production, the frontend falls back to same-origin API calls when the variable is omitted.

Implemented Locally

GET /health
POST /api/auth/register, POST /api/auth/login, POST /api/auth/refresh, POST /api/auth/logout, GET /api/auth/me
POST /api/v1/files/upload
GET /api/v1/files, GET /api/v1/files/:id, DELETE /api/v1/files/:id
GET /api/v1/links/:linkId, GET /api/v1/links/:linkId/download
GET /api/v1/links/:linkId/preview
GET /api/v1/dashboard/stats
GET /api/admin/overview, /api/admin/files, /api/admin/users, /api/admin/events protected by x-admin-key

Production Adapters Still Needed

The remaining roadmap items require provisioned services and credentials: PostgreSQL/Drizzle migrations, Redis/BullMQ, Cloudflare R2, Resend, Stripe, Sentry, PM2, Nginx, TLS, firewall rules, backups, and DNS. The local API keeps storage and persistence isolated so those adapters can replace the JSON/disk implementation without changing frontend routes.