CoLA — Cost of Living Advisor

Node.js + TypeScript API that compares cost-of-living baskets across cities. Includes Jest tests, Docker, Jenkins pipeline, and SonarCloud config.

Quick Start

npm ci
npm run dev
# http://localhost:3000/health

Tests & Coverage

npm test
npm run coverage

Docker

docker build -t cola:latest .
docker run -p 3000:3000 cola:latest

Jenkins

• Manage Jenkins → Tools → NodeJS → add tool named Node18
• Create pipeline from this repo (uses Jenkinsfile)
• Add credential: Secret text with ID SONAR_TOKEN (your SonarCloud token)
• Build → SonarCloud Analysis uploads results

Endpoints

• GET /health
• GET /locations / GET /locations/:id
• GET /compare?from=mel&to=syd&income=5000
• GET /expenses / POST /expenses / PUT /expenses/:id / DELETE /expenses/:id