diff --git a/Frontend/1 het/backend/.env.example b/Frontend/1 het/backend/.env.example new file mode 100644 index 0000000..d1034ef --- /dev/null +++ b/Frontend/1 het/backend/.env.example @@ -0,0 +1,7 @@ +PORT=3000 +NODE_ENV=development +DATABASE_URL=postgresql://webstore_user:webstore_password@localhost:5432/webstore_db?schema=public +JWT_SECRET=replace-with-a-long-random-secret +JWT_EXPIRES_IN=7d +COOKIE_NAME=webstore_token +COOKIE_SECURE=false \ No newline at end of file diff --git a/Frontend/1 het/backend/.gitignore b/Frontend/1 het/backend/.gitignore new file mode 100644 index 0000000..92f5a56 --- /dev/null +++ b/Frontend/1 het/backend/.gitignore @@ -0,0 +1,6 @@ +node_modules/ +.env +npm-debug.log* +public/images/ +!public/images/.gitkeep +prisma/dev.db \ No newline at end of file diff --git a/Frontend/1 het/backend/Dockerfile b/Frontend/1 het/backend/Dockerfile new file mode 100644 index 0000000..7b784f6 --- /dev/null +++ b/Frontend/1 het/backend/Dockerfile @@ -0,0 +1,14 @@ +FROM node:20-alpine + +WORKDIR /app + +COPY package*.json ./ +RUN apk add --no-cache openssl && npm install --ignore-scripts + +COPY . . + +RUN npm run prisma:generate + +EXPOSE 3000 + +CMD ["npm", "run", "dev"] \ No newline at end of file diff --git a/Frontend/1 het/backend/README.md b/Frontend/1 het/backend/README.md new file mode 100644 index 0000000..37c37e5 --- /dev/null +++ b/Frontend/1 het/backend/README.md @@ -0,0 +1,88 @@ +# Webstore Backend (Laxer + CQRS + Prisma) + +Educational Node.js backend for frontend students. + +## Structure + +``` +backend/ + prisma/ + schema.prisma + seed.js + public/ + images/ + scripts/ + extract-images-from-build.bat + src/ + Api/ + Controller/ + Router/ + Middleware/ + app.js + server.js + Application/ + User/ + Command/ + command.js + commandhandler.js + Querry/ + query.js + queryhandler.js + Services/ + DTO/ + Domain/ + IRepository/ + Models/ + Infrastructure/ + Repository/ + config/ + env.js + prisma.js +``` + +## Run with Docker Compose + +```bash +docker compose up --build +``` + +This starts PostgreSQL and API, runs Prisma generate/db push/seed automatically. + +## Auth (JWT in Cookie) + +- `POST /api/users/register` +- `POST /api/users/login` +- `GET /api/users/me` (requires cookie) +- `POST /api/users/logout` (requires cookie) + +Cookie is HTTP-only and set with `sameSite=lax`. + +## Shop endpoints + +- `GET /api/health` +- `GET /api/shop/categories` +- `GET /api/shop/products` +- `POST /api/shop/orders` + +Order payload: + +```json +{ + "customer_name": "Jane Doe", + "customer_email": "jane@example.com", + "items": [ + { "product_id": 1, "quantity": 2 } + ] +} +``` + +## Image extraction batch + +```bat +scripts\extract-images-from-build.bat "..\build" ".\public\images" +``` + +Defaults (if arguments omitted): + +- Source: `..\build` +- Target: `.\public\images` \ No newline at end of file diff --git a/Frontend/1 het/backend/docker-compose.yml b/Frontend/1 het/backend/docker-compose.yml new file mode 100644 index 0000000..803dd17 --- /dev/null +++ b/Frontend/1 het/backend/docker-compose.yml @@ -0,0 +1,39 @@ +services: + db: + image: postgres:16-alpine + container_name: webstore_db + restart: unless-stopped + environment: + POSTGRES_DB: webstore_db + POSTGRES_USER: webstore_user + POSTGRES_PASSWORD: webstore_password + ports: + - "5432:5432" + volumes: + - postgres_data:/var/lib/postgresql/data + + api: + build: + context: . + dockerfile: Dockerfile + container_name: webstore_api + restart: unless-stopped + depends_on: + - db + environment: + PORT: 3000 + NODE_ENV: development + DATABASE_URL: postgresql://webstore_user:webstore_password@db:5432/webstore_db?schema=public + JWT_SECRET: dev-secret-change-me + JWT_EXPIRES_IN: 7d + COOKIE_NAME: webstore_token + COOKIE_SECURE: "false" + ports: + - "3000:3000" + volumes: + - .:/app + - /app/node_modules + command: sh -c "npm run prisma:generate && npm run prisma:push && npm run prisma:seed && npm run dev" + +volumes: + postgres_data: \ No newline at end of file diff --git a/Frontend/1 het/backend/images/.production.env b/Frontend/1 het/backend/images/.production.env new file mode 100644 index 0000000..4ac044d --- /dev/null +++ b/Frontend/1 het/backend/images/.production.env @@ -0,0 +1,19 @@ +# Copy and edit values for your production/student environment. + +# API +PORT=3000 +NODE_ENV=production +DATABASE_URL=postgresql://webstore_user:webstore_password@db:5432/webstore_db?schema=public +JWT_SECRET=change-me-in-real-use +JWT_EXPIRES_IN=7d +COOKIE_NAME=webstore_token +COOKIE_SECURE=false + +# Database container bootstrap +POSTGRES_DB=webstore_db +POSTGRES_USER=webstore_user +POSTGRES_PASSWORD=webstore_password + +# Optional: host port overrides +API_PORT=3000 +DB_PORT=5432 \ No newline at end of file diff --git a/Frontend/1 het/backend/images/production.compose.yml b/Frontend/1 het/backend/images/production.compose.yml new file mode 100644 index 0000000..bcdf27a --- /dev/null +++ b/Frontend/1 het/backend/images/production.compose.yml @@ -0,0 +1,36 @@ +services: + db: + image: postgres:16-alpine + container_name: webstore_db_prod + restart: unless-stopped + environment: + POSTGRES_DB: ${POSTGRES_DB} + POSTGRES_USER: ${POSTGRES_USER} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD} + ports: + - "${DB_PORT:-5432}:5432" + volumes: + - postgres_data_prod:/var/lib/postgresql/data + + api: + image: webstore-api:prod + container_name: webstore_api_prod + restart: unless-stopped + depends_on: + - db + env_file: + - .production.env + environment: + NODE_ENV: production + DATABASE_URL: ${DATABASE_URL} + PORT: ${PORT} + JWT_SECRET: ${JWT_SECRET} + JWT_EXPIRES_IN: ${JWT_EXPIRES_IN} + COOKIE_NAME: ${COOKIE_NAME} + COOKIE_SECURE: ${COOKIE_SECURE} + command: sh -c "npm run prisma:generate && npm run prisma:push && npm run prisma:seed && npm start" + ports: + - "${API_PORT:-3000}:3000" + +volumes: + postgres_data_prod: \ No newline at end of file diff --git a/Frontend/1 het/backend/images/run-student-production.bat b/Frontend/1 het/backend/images/run-student-production.bat new file mode 100644 index 0000000..66647ed --- /dev/null +++ b/Frontend/1 het/backend/images/run-student-production.bat @@ -0,0 +1,69 @@ +@echo off +setlocal EnableExtensions EnableDelayedExpansion + +set "ROOT_DIR=%~dp0" +set "ENV_FILE=%ROOT_DIR%\.production.env" +set "COMPOSE_FILE=%ROOT_DIR%\production.compose.yml" +set "ARCHIVE_FILE=%ROOT_DIR%\images\webstore-production-images.tar" + +set "API_IMAGE=webstore-api:prod" + +echo [1/7] Checking Docker + Compose... +docker --version >nul 2>&1 +if errorlevel 1 ( + echo ERROR: Docker CLI is not available. + exit /b 1 +) +docker compose version >nul 2>&1 +if errorlevel 1 ( + echo ERROR: Docker Compose plugin is not available. + exit /b 1 +) + +echo [2/7] Validating required files... +if not exist "%ENV_FILE%" ( + echo ERROR: Missing env file: "%ENV_FILE%" + exit /b 1 +) +if not exist "%COMPOSE_FILE%" ( + echo ERROR: Missing compose file: "%COMPOSE_FILE%" + exit /b 1 +) + +echo [3/7] Loading prebuilt image archive if present... +if exist "%ARCHIVE_FILE%" ( + docker load -i "%ARCHIVE_FILE%" + if errorlevel 1 ( + echo ERROR: Failed to load image archive. + exit /b 1 + ) +) else ( + echo WARN: "%ARCHIVE_FILE%" not found. Assuming images already exist locally. +) + +echo [4/7] Ensuring API image exists locally... +docker image inspect "%API_IMAGE%" >nul 2>&1 +if errorlevel 1 ( + echo ERROR: API image "%API_IMAGE%" not found. + echo Run scripts\build-production-images.bat first or provide the archive in images\. + exit /b 1 +) + +echo [5/7] Starting production stack for students... +pushd "%ROOT_DIR%" >nul +docker compose --env-file .production.env -f production.compose.yml up -d +if errorlevel 1 ( + popd >nul + echo ERROR: Failed to start compose stack. + exit /b 1 +) + +echo [6/7] Showing running services... +docker compose --env-file .production.env -f production.compose.yml ps + +echo [7/7] Done. +echo API should be available at http://localhost:3000 (or API_PORT in .production.env) +echo Stop stack with: +echo docker compose --env-file .production.env -f production.compose.yml down +popd >nul +exit /b 0 \ No newline at end of file diff --git a/Frontend/1 het/backend/images/webstore-production-images.tar b/Frontend/1 het/backend/images/webstore-production-images.tar new file mode 100644 index 0000000..30e0b90 Binary files /dev/null and b/Frontend/1 het/backend/images/webstore-production-images.tar differ diff --git a/Frontend/1 het/backend/package-lock.json b/Frontend/1 het/backend/package-lock.json new file mode 100644 index 0000000..0394b19 --- /dev/null +++ b/Frontend/1 het/backend/package-lock.json @@ -0,0 +1,1534 @@ +{ + "name": "webstore-backend", + "version": "1.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "webstore-backend", + "version": "1.0.0", + "hasInstallScript": true, + "license": "MIT", + "dependencies": { + "@prisma/client": "^5.20.0", + "bcryptjs": "^2.4.3", + "cookie-parser": "^1.4.6", + "cors": "^2.8.5", + "dotenv": "^16.4.5", + "express": "^4.19.2", + "helmet": "^7.1.0", + "jsonwebtoken": "^9.0.2", + "morgan": "^1.10.0" + }, + "devDependencies": { + "nodemon": "^3.1.4", + "prisma": "^5.20.0" + } + }, + "node_modules/@prisma/client": { + "version": "5.22.0", + "resolved": "https://registry.npmjs.org/@prisma/client/-/client-5.22.0.tgz", + "integrity": "sha512-M0SVXfyHnQREBKxCgyo7sffrKttwE6R8PMq330MIUF0pTwjUhLbW84pFDlf06B27XyCR++VtjugEnIHdr07SVA==", + "hasInstallScript": true, + "license": "Apache-2.0", + "engines": { + "node": ">=16.13" + }, + "peerDependencies": { + "prisma": "*" + }, + "peerDependenciesMeta": { + "prisma": { + "optional": true + } + } + }, + "node_modules/@prisma/debug": { + "version": "5.22.0", + "resolved": "https://registry.npmjs.org/@prisma/debug/-/debug-5.22.0.tgz", + "integrity": "sha512-AUt44v3YJeggO2ZU5BkXI7M4hu9BF2zzH2iF2V5pyXT/lRTyWiElZ7It+bRH1EshoMRxHgpYg4VB6rCM+mG5jQ==", + "devOptional": true, + "license": "Apache-2.0" + }, + "node_modules/@prisma/engines": { + "version": "5.22.0", + "resolved": "https://registry.npmjs.org/@prisma/engines/-/engines-5.22.0.tgz", + "integrity": "sha512-UNjfslWhAt06kVL3CjkuYpHAWSO6L4kDCVPegV6itt7nD1kSJavd3vhgAEhjglLJJKEdJ7oIqDJ+yHk6qO8gPA==", + "devOptional": true, + "hasInstallScript": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "5.22.0", + "@prisma/engines-version": "5.22.0-44.605197351a3c8bdd595af2d2a9bc3025bca48ea2", + "@prisma/fetch-engine": "5.22.0", + "@prisma/get-platform": "5.22.0" + } + }, + "node_modules/@prisma/engines-version": { + "version": "5.22.0-44.605197351a3c8bdd595af2d2a9bc3025bca48ea2", + "resolved": "https://registry.npmjs.org/@prisma/engines-version/-/engines-version-5.22.0-44.605197351a3c8bdd595af2d2a9bc3025bca48ea2.tgz", + "integrity": "sha512-2PTmxFR2yHW/eB3uqWtcgRcgAbG1rwG9ZriSvQw+nnb7c4uCr3RAcGMb6/zfE88SKlC1Nj2ziUvc96Z379mHgQ==", + "devOptional": true, + "license": "Apache-2.0" + }, + "node_modules/@prisma/fetch-engine": { + "version": "5.22.0", + "resolved": "https://registry.npmjs.org/@prisma/fetch-engine/-/fetch-engine-5.22.0.tgz", + "integrity": "sha512-bkrD/Mc2fSvkQBV5EpoFcZ87AvOgDxbG99488a5cexp5Ccny+UM6MAe/UFkUC0wLYD9+9befNOqGiIJhhq+HbA==", + "devOptional": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "5.22.0", + "@prisma/engines-version": "5.22.0-44.605197351a3c8bdd595af2d2a9bc3025bca48ea2", + "@prisma/get-platform": "5.22.0" + } + }, + "node_modules/@prisma/get-platform": { + "version": "5.22.0", + "resolved": "https://registry.npmjs.org/@prisma/get-platform/-/get-platform-5.22.0.tgz", + "integrity": "sha512-pHhpQdr1UPFpt+zFfnPazhulaZYCUqeIcPpJViYoq9R+D/yw4fjE+CtnsnKzPYm0ddUbeXUzjGVGIRVgPDCk4Q==", + "devOptional": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "5.22.0" + } + }, + "node_modules/accepts": { + "version": "1.3.8", + "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz", + "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==", + "license": "MIT", + "dependencies": { + "mime-types": "~2.1.34", + "negotiator": "0.6.3" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/anymatch": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", + "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", + "dev": true, + "license": "ISC", + "dependencies": { + "normalize-path": "^3.0.0", + "picomatch": "^2.0.4" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/array-flatten": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz", + "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==", + "license": "MIT" + }, + "node_modules/balanced-match": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", + "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/basic-auth": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/basic-auth/-/basic-auth-2.0.1.tgz", + "integrity": "sha512-NF+epuEdnUYVlGuhaxbbq+dvJttwLnGY+YixlXlME5KpQ5W3CnXA5cVTneY3SPbPDRkcjMbifrwmFYcClgOZeg==", + "license": "MIT", + "dependencies": { + "safe-buffer": "5.1.2" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/basic-auth/node_modules/safe-buffer": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", + "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", + "license": "MIT" + }, + "node_modules/bcryptjs": { + "version": "2.4.3", + "resolved": "https://registry.npmjs.org/bcryptjs/-/bcryptjs-2.4.3.tgz", + "integrity": "sha512-V/Hy/X9Vt7f3BbPJEi8BdVFMByHi+jNXrYkW3huaybV/kQ0KJg0Y6PkEMbn+zeT+i+SiKZ/HMqJGIIt4LZDqNQ==", + "license": "MIT" + }, + "node_modules/binary-extensions": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz", + "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/body-parser": { + "version": "1.20.4", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.4.tgz", + "integrity": "sha512-ZTgYYLMOXY9qKU/57FAo8F+HA2dGX7bqGc71txDRC1rS4frdFI5R7NhluHxH6M0YItAP0sHB4uqAOcYKxO6uGA==", + "license": "MIT", + "dependencies": { + "bytes": "~3.1.2", + "content-type": "~1.0.5", + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "~1.2.0", + "http-errors": "~2.0.1", + "iconv-lite": "~0.4.24", + "on-finished": "~2.4.1", + "qs": "~6.14.0", + "raw-body": "~2.5.3", + "type-is": "~1.6.18", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/brace-expansion": { + "version": "5.0.4", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.4.tgz", + "integrity": "sha512-h+DEnpVvxmfVefa4jFbCf5HdH5YMDXRsmKflpf1pILZWRFlTbJpxeU55nJl4Smt5HQaGzg1o6RHFPJaOqnmBDg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^4.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/buffer-equal-constant-time": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz", + "integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==", + "license": "BSD-3-Clause" + }, + "node_modules/bytes": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", + "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/call-bound": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz", + "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "get-intrinsic": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/chokidar": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz", + "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "anymatch": "~3.1.2", + "braces": "~3.0.2", + "glob-parent": "~5.1.2", + "is-binary-path": "~2.1.0", + "is-glob": "~4.0.1", + "normalize-path": "~3.0.0", + "readdirp": "~3.6.0" + }, + "engines": { + "node": ">= 8.10.0" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + }, + "optionalDependencies": { + "fsevents": "~2.3.2" + } + }, + "node_modules/content-disposition": { + "version": "0.5.4", + "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz", + "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==", + "license": "MIT", + "dependencies": { + "safe-buffer": "5.2.1" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/content-type": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz", + "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/cookie": { + "version": "0.7.2", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz", + "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/cookie-parser": { + "version": "1.4.7", + "resolved": "https://registry.npmjs.org/cookie-parser/-/cookie-parser-1.4.7.tgz", + "integrity": "sha512-nGUvgXnotP3BsjiLX2ypbQnWoGUPIIfHQNZkkC668ntrzGWEZVW70HDEB1qnNGMicPje6EttlIgzo51YSwNQGw==", + "license": "MIT", + "dependencies": { + "cookie": "0.7.2", + "cookie-signature": "1.0.6" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/cookie-parser/node_modules/cookie-signature": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz", + "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==", + "license": "MIT" + }, + "node_modules/cookie-signature": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.7.tgz", + "integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==", + "license": "MIT" + }, + "node_modules/cors": { + "version": "2.8.6", + "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz", + "integrity": "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==", + "license": "MIT", + "dependencies": { + "object-assign": "^4", + "vary": "^1" + }, + "engines": { + "node": ">= 0.10" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/depd": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz", + "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/destroy": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz", + "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==", + "license": "MIT", + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/dotenv": { + "version": "16.6.1", + "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz", + "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://dotenvx.com" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/ecdsa-sig-formatter": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/ecdsa-sig-formatter/-/ecdsa-sig-formatter-1.0.11.tgz", + "integrity": "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ==", + "license": "Apache-2.0", + "dependencies": { + "safe-buffer": "^5.0.1" + } + }, + "node_modules/ee-first": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", + "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==", + "license": "MIT" + }, + "node_modules/encodeurl": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz", + "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", + "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/escape-html": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", + "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==", + "license": "MIT" + }, + "node_modules/etag": { + "version": "1.8.1", + "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", + "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/express": { + "version": "4.22.1", + "resolved": "https://registry.npmjs.org/express/-/express-4.22.1.tgz", + "integrity": "sha512-F2X8g9P1X7uCPZMA3MVf9wcTqlyNp7IhH5qPCI0izhaOIYXaW9L535tGA3qmjRzpH+bZczqq7hVKxTR4NWnu+g==", + "license": "MIT", + "dependencies": { + "accepts": "~1.3.8", + "array-flatten": "1.1.1", + "body-parser": "~1.20.3", + "content-disposition": "~0.5.4", + "content-type": "~1.0.4", + "cookie": "~0.7.1", + "cookie-signature": "~1.0.6", + "debug": "2.6.9", + "depd": "2.0.0", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "finalhandler": "~1.3.1", + "fresh": "~0.5.2", + "http-errors": "~2.0.0", + "merge-descriptors": "1.0.3", + "methods": "~1.1.2", + "on-finished": "~2.4.1", + "parseurl": "~1.3.3", + "path-to-regexp": "~0.1.12", + "proxy-addr": "~2.0.7", + "qs": "~6.14.0", + "range-parser": "~1.2.1", + "safe-buffer": "5.2.1", + "send": "~0.19.0", + "serve-static": "~1.16.2", + "setprototypeof": "1.2.0", + "statuses": "~2.0.1", + "type-is": "~1.6.18", + "utils-merge": "1.0.1", + "vary": "~1.1.2" + }, + "engines": { + "node": ">= 0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/finalhandler": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz", + "integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==", + "license": "MIT", + "dependencies": { + "debug": "2.6.9", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "on-finished": "~2.4.1", + "parseurl": "~1.3.3", + "statuses": "~2.0.2", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/forwarded": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz", + "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/fresh": { + "version": "0.5.2", + "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz", + "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", + "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/helmet": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/helmet/-/helmet-7.2.0.tgz", + "integrity": "sha512-ZRiwvN089JfMXokizgqEPXsl2Guk094yExfoDXR0cBYWxtBbaSww/w+vT4WEJsBW2iTUi1GgZ6swmoug3Oy4Xw==", + "license": "MIT", + "engines": { + "node": ">=16.0.0" + } + }, + "node_modules/http-errors": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz", + "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==", + "license": "MIT", + "dependencies": { + "depd": "~2.0.0", + "inherits": "~2.0.4", + "setprototypeof": "~1.2.0", + "statuses": "~2.0.2", + "toidentifier": "~1.0.1" + }, + "engines": { + "node": ">= 0.8" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/iconv-lite": { + "version": "0.4.24", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz", + "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==", + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/ignore-by-default": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/ignore-by-default/-/ignore-by-default-1.0.1.tgz", + "integrity": "sha512-Ius2VYcGNk7T90CppJqcIkS5ooHUZyIQK+ClZfMfMNFEF9VSE73Fq+906u/CWu92x4gzZMWOwfFYckPObzdEbA==", + "dev": true, + "license": "ISC" + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "license": "ISC" + }, + "node_modules/ipaddr.js": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz", + "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==", + "license": "MIT", + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/is-binary-path": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz", + "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==", + "dev": true, + "license": "MIT", + "dependencies": { + "binary-extensions": "^2.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/jsonwebtoken": { + "version": "9.0.3", + "resolved": "https://registry.npmjs.org/jsonwebtoken/-/jsonwebtoken-9.0.3.tgz", + "integrity": "sha512-MT/xP0CrubFRNLNKvxJ2BYfy53Zkm++5bX9dtuPbqAeQpTVe0MQTFhao8+Cp//EmJp244xt6Drw/GVEGCUj40g==", + "license": "MIT", + "dependencies": { + "jws": "^4.0.1", + "lodash.includes": "^4.3.0", + "lodash.isboolean": "^3.0.3", + "lodash.isinteger": "^4.0.4", + "lodash.isnumber": "^3.0.3", + "lodash.isplainobject": "^4.0.6", + "lodash.isstring": "^4.0.1", + "lodash.once": "^4.0.0", + "ms": "^2.1.1", + "semver": "^7.5.4" + }, + "engines": { + "node": ">=12", + "npm": ">=6" + } + }, + "node_modules/jsonwebtoken/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/jwa": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/jwa/-/jwa-2.0.1.tgz", + "integrity": "sha512-hRF04fqJIP8Abbkq5NKGN0Bbr3JxlQ+qhZufXVr0DvujKy93ZCbXZMHDL4EOtodSbCWxOqR8MS1tXA5hwqCXDg==", + "license": "MIT", + "dependencies": { + "buffer-equal-constant-time": "^1.0.1", + "ecdsa-sig-formatter": "1.0.11", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/jws": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/jws/-/jws-4.0.1.tgz", + "integrity": "sha512-EKI/M/yqPncGUUh44xz0PxSidXFr/+r0pA70+gIYhjv+et7yxM+s29Y+VGDkovRofQem0fs7Uvf4+YmAdyRduA==", + "license": "MIT", + "dependencies": { + "jwa": "^2.0.1", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/lodash.includes": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/lodash.includes/-/lodash.includes-4.3.0.tgz", + "integrity": "sha512-W3Bx6mdkRTGtlJISOvVD/lbqjTlPPUDTMnlXZFnVwi9NKJ6tiAk6LVdlhZMm17VZisqhKcgzpO5Wz91PCt5b0w==", + "license": "MIT" + }, + "node_modules/lodash.isboolean": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/lodash.isboolean/-/lodash.isboolean-3.0.3.tgz", + "integrity": "sha512-Bz5mupy2SVbPHURB98VAcw+aHh4vRV5IPNhILUCsOzRmsTmSQ17jIuqopAentWoehktxGd9e/hbIXq980/1QJg==", + "license": "MIT" + }, + "node_modules/lodash.isinteger": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/lodash.isinteger/-/lodash.isinteger-4.0.4.tgz", + "integrity": "sha512-DBwtEWN2caHQ9/imiNeEA5ys1JoRtRfY3d7V9wkqtbycnAmTvRRmbHKDV4a0EYc678/dia0jrte4tjYwVBaZUA==", + "license": "MIT" + }, + "node_modules/lodash.isnumber": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/lodash.isnumber/-/lodash.isnumber-3.0.3.tgz", + "integrity": "sha512-QYqzpfwO3/CWf3XP+Z+tkQsfaLL/EnUlXWVkIk5FUPc4sBdTehEqZONuyRt2P67PXAk+NXmTBcc97zw9t1FQrw==", + "license": "MIT" + }, + "node_modules/lodash.isplainobject": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz", + "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==", + "license": "MIT" + }, + "node_modules/lodash.isstring": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz", + "integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==", + "license": "MIT" + }, + "node_modules/lodash.once": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz", + "integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg==", + "license": "MIT" + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/media-typer": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz", + "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/merge-descriptors": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz", + "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/methods": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", + "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", + "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", + "license": "MIT", + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/minimatch": { + "version": "10.2.4", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.4.tgz", + "integrity": "sha512-oRjTw/97aTBN0RHbYCdtF1MQfvusSIBQM0IZEgzl6426+8jSC0nF1a/GmnVLpfB9yyr6g6FTqWqiZVbxrtaCIg==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "brace-expansion": "^5.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/morgan": { + "version": "1.10.1", + "resolved": "https://registry.npmjs.org/morgan/-/morgan-1.10.1.tgz", + "integrity": "sha512-223dMRJtI/l25dJKWpgij2cMtywuG/WiUKXdvwfbhGKBhy1puASqXwFzmWZ7+K73vUPoR7SS2Qz2cI/g9MKw0A==", + "license": "MIT", + "dependencies": { + "basic-auth": "~2.0.1", + "debug": "2.6.9", + "depd": "~2.0.0", + "on-finished": "~2.3.0", + "on-headers": "~1.1.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/morgan/node_modules/on-finished": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.3.0.tgz", + "integrity": "sha512-ikqdkGAAyf/X/gPhXGvfgAytDZtDbr+bkNUJ0N9h5MI/dmdgCs3l6hoHrcUv41sRKew3jIwrp4qQDXiK99Utww==", + "license": "MIT", + "dependencies": { + "ee-first": "1.1.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/negotiator": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz", + "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/nodemon": { + "version": "3.1.14", + "resolved": "https://registry.npmjs.org/nodemon/-/nodemon-3.1.14.tgz", + "integrity": "sha512-jakjZi93UtB3jHMWsXL68FXSAosbLfY0In5gtKq3niLSkrWznrVBzXFNOEMJUfc9+Ke7SHWoAZsiMkNP3vq6Jw==", + "dev": true, + "license": "MIT", + "dependencies": { + "chokidar": "^3.5.2", + "debug": "^4", + "ignore-by-default": "^1.0.1", + "minimatch": "^10.2.1", + "pstree.remy": "^1.1.8", + "semver": "^7.5.3", + "simple-update-notifier": "^2.0.0", + "supports-color": "^5.5.0", + "touch": "^3.1.0", + "undefsafe": "^2.0.5" + }, + "bin": { + "nodemon": "bin/nodemon.js" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/nodemon" + } + }, + "node_modules/nodemon/node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/nodemon/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/normalize-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", + "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-assign": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", + "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-inspect": { + "version": "1.13.4", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz", + "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/on-finished": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz", + "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", + "license": "MIT", + "dependencies": { + "ee-first": "1.1.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/on-headers": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/on-headers/-/on-headers-1.1.0.tgz", + "integrity": "sha512-737ZY3yNnXy37FHkQxPzt4UZ2UWPWiCZWLvFZ4fu5cueciegX0zGPnrlY6bwRg4FdQOe9YU8MkmJwGhoMybl8A==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/parseurl": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", + "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/path-to-regexp": { + "version": "0.1.12", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.12.tgz", + "integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==", + "license": "MIT" + }, + "node_modules/picomatch": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/prisma": { + "version": "5.22.0", + "resolved": "https://registry.npmjs.org/prisma/-/prisma-5.22.0.tgz", + "integrity": "sha512-vtpjW3XuYCSnMsNVBjLMNkTj6OZbudcPPTPYHqX0CJfpcdWciI1dM8uHETwmDxxiqEwCIE6WvXucWUetJgfu/A==", + "devOptional": true, + "hasInstallScript": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/engines": "5.22.0" + }, + "bin": { + "prisma": "build/index.js" + }, + "engines": { + "node": ">=16.13" + }, + "optionalDependencies": { + "fsevents": "2.3.3" + } + }, + "node_modules/proxy-addr": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", + "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==", + "license": "MIT", + "dependencies": { + "forwarded": "0.2.0", + "ipaddr.js": "1.9.1" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/pstree.remy": { + "version": "1.1.8", + "resolved": "https://registry.npmjs.org/pstree.remy/-/pstree.remy-1.1.8.tgz", + "integrity": "sha512-77DZwxQmxKnu3aR542U+X8FypNzbfJ+C5XQDk3uWjWxn6151aIMGthWYRXTqT1E5oJvg+ljaa2OJi+VfvCOQ8w==", + "dev": true, + "license": "MIT" + }, + "node_modules/qs": { + "version": "6.14.2", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.2.tgz", + "integrity": "sha512-V/yCWTTF7VJ9hIh18Ugr2zhJMP01MY7c5kh4J870L7imm6/DIzBsNLTXzMwUA3yZ5b/KBqLx8Kp3uRvd7xSe3Q==", + "license": "BSD-3-Clause", + "dependencies": { + "side-channel": "^1.1.0" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/range-parser": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz", + "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/raw-body": { + "version": "2.5.3", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.3.tgz", + "integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==", + "license": "MIT", + "dependencies": { + "bytes": "~3.1.2", + "http-errors": "~2.0.1", + "iconv-lite": "~0.4.24", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/readdirp": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz", + "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==", + "dev": true, + "license": "MIT", + "dependencies": { + "picomatch": "^2.2.1" + }, + "engines": { + "node": ">=8.10.0" + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "license": "MIT" + }, + "node_modules/semver": { + "version": "7.7.4", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz", + "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/send": { + "version": "0.19.2", + "resolved": "https://registry.npmjs.org/send/-/send-0.19.2.tgz", + "integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==", + "license": "MIT", + "dependencies": { + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "fresh": "~0.5.2", + "http-errors": "~2.0.1", + "mime": "1.6.0", + "ms": "2.1.3", + "on-finished": "~2.4.1", + "range-parser": "~1.2.1", + "statuses": "~2.0.2" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/send/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/serve-static": { + "version": "1.16.3", + "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.3.tgz", + "integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==", + "license": "MIT", + "dependencies": { + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "parseurl": "~1.3.3", + "send": "~0.19.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/setprototypeof": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", + "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", + "license": "ISC" + }, + "node_modules/side-channel": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz", + "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3", + "side-channel-list": "^1.0.0", + "side-channel-map": "^1.0.1", + "side-channel-weakmap": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-list": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz", + "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-map": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz", + "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-weakmap": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz", + "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==", + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3", + "side-channel-map": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/simple-update-notifier": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/simple-update-notifier/-/simple-update-notifier-2.0.0.tgz", + "integrity": "sha512-a2B9Y0KlNXl9u/vsW6sTIu9vGEpfKu2wRV6l1H3XEas/0gUIzGzBoP/IouTcUQbm9JWZLH3COxyn03TYlFax6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "semver": "^7.5.3" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/statuses": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz", + "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/supports-color": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz", + "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^3.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/toidentifier": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", + "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", + "license": "MIT", + "engines": { + "node": ">=0.6" + } + }, + "node_modules/touch": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/touch/-/touch-3.1.1.tgz", + "integrity": "sha512-r0eojU4bI8MnHr8c5bNo7lJDdI2qXlWWJk6a9EAFG7vbhTjElYhBVS3/miuE0uOuoLdb8Mc/rVfsmm6eo5o9GA==", + "dev": true, + "license": "ISC", + "bin": { + "nodetouch": "bin/nodetouch.js" + } + }, + "node_modules/type-is": { + "version": "1.6.18", + "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz", + "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==", + "license": "MIT", + "dependencies": { + "media-typer": "0.3.0", + "mime-types": "~2.1.24" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/undefsafe": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/undefsafe/-/undefsafe-2.0.5.tgz", + "integrity": "sha512-WxONCrssBM8TSPRqN5EmsjVrsv4A8X12J4ArBiiayv3DyyG3ZlIg6yysuuSYdZsVz3TKcTg2fd//Ujd4CHV1iA==", + "dev": true, + "license": "MIT" + }, + "node_modules/unpipe": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz", + "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/utils-merge": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz", + "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==", + "license": "MIT", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/vary": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz", + "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + } + } +} diff --git a/Frontend/1 het/backend/package.json b/Frontend/1 het/backend/package.json new file mode 100644 index 0000000..1277912 --- /dev/null +++ b/Frontend/1 het/backend/package.json @@ -0,0 +1,37 @@ +{ + "name": "webstore-backend", + "version": "1.0.0", + "description": "Teaching backend for a webstore using Node.js, Express, and PostgreSQL", + "main": "src/Api/server.js", + "scripts": { + "dev": "nodemon src/Api/server.js", + "start": "node src/Api/server.js", + "prisma:generate": "prisma generate", + "prisma:push": "prisma db push", + "prisma:seed": "node prisma/seed.js", + "postinstall": "prisma generate" + }, + "keywords": [ + "express", + "postgres", + "webstore", + "backend" + ], + "author": "", + "license": "MIT", + "dependencies": { + "bcryptjs": "^2.4.3", + "cookie-parser": "^1.4.6", + "cors": "^2.8.5", + "dotenv": "^16.4.5", + "express": "^4.19.2", + "helmet": "^7.1.0", + "jsonwebtoken": "^9.0.2", + "morgan": "^1.10.0", + "@prisma/client": "^5.20.0" + }, + "devDependencies": { + "nodemon": "^3.1.4", + "prisma": "^5.20.0" + } +} \ No newline at end of file diff --git a/Frontend/1 het/backend/prisma/schema.prisma b/Frontend/1 het/backend/prisma/schema.prisma new file mode 100644 index 0000000..67d8f4c --- /dev/null +++ b/Frontend/1 het/backend/prisma/schema.prisma @@ -0,0 +1,56 @@ +generator client { + provider = "prisma-client-js" +} + +datasource db { + provider = "postgresql" + url = env("DATABASE_URL") +} + +model User { + id Int @id @default(autoincrement()) + name String + email String @unique + passwordHash String + createdAt DateTime @default(now()) +} + +model Category { + id Int @id @default(autoincrement()) + name String @unique + slug String @unique + createdAt DateTime @default(now()) + products Product[] +} + +model Product { + id Int @id @default(autoincrement()) + categoryId Int + name String @unique + description String? + price Decimal @db.Decimal(10, 2) + imageUrl String? + stock Int @default(0) + createdAt DateTime @default(now()) + category Category @relation(fields: [categoryId], references: [id], onDelete: Restrict) + orderItems OrderItem[] +} + +model Order { + id Int @id @default(autoincrement()) + customerName String + customerEmail String + totalPrice Decimal @db.Decimal(10, 2) + createdAt DateTime @default(now()) + items OrderItem[] +} + +model OrderItem { + id Int @id @default(autoincrement()) + orderId Int + productId Int + quantity Int + unitPrice Decimal @db.Decimal(10, 2) + order Order @relation(fields: [orderId], references: [id], onDelete: Cascade) + product Product @relation(fields: [productId], references: [id], onDelete: Restrict) +} \ No newline at end of file diff --git a/Frontend/1 het/backend/prisma/seed.js b/Frontend/1 het/backend/prisma/seed.js new file mode 100644 index 0000000..15ca131 --- /dev/null +++ b/Frontend/1 het/backend/prisma/seed.js @@ -0,0 +1,77 @@ +const { PrismaClient } = require("@prisma/client"); + +const prisma = new PrismaClient(); + +async function main() { + const categories = [ + { name: "Shoes", slug: "shoes" }, + { name: "Bags", slug: "bags" }, + { name: "Accessories", slug: "accessories" } + ]; + + for (const category of categories) { + await prisma.category.upsert({ + where: { slug: category.slug }, + update: {}, + create: category + }); + } + + const shoes = await prisma.category.findUnique({ where: { slug: "shoes" } }); + const bags = await prisma.category.findUnique({ where: { slug: "bags" } }); + const accessories = await prisma.category.findUnique({ where: { slug: "accessories" } }); + + const products = [ + { + categoryId: shoes.id, + name: "Street Runner", + description: "Lightweight city sneaker.", + price: "18990.00", + imageUrl: "/images/street-runner.jpg", + stock: 24 + }, + { + categoryId: shoes.id, + name: "Trail Edge", + description: "Stable shoe for outdoor tracks.", + price: "24990.00", + imageUrl: "/images/trail-edge.jpg", + stock: 13 + }, + { + categoryId: bags.id, + name: "Urban Tote", + description: "Everyday tote with zipper top.", + price: "14990.00", + imageUrl: "/images/urban-tote.jpg", + stock: 30 + }, + { + categoryId: accessories.id, + name: "Classic Cap", + description: "Adjustable cotton cap.", + price: "6990.00", + imageUrl: "/images/classic-cap.jpg", + stock: 42 + } + ]; + + for (const product of products) { + await prisma.product.upsert({ + where: { name: product.name }, + update: {}, + create: product + }); + } +} + +main() + .then(async () => { + await prisma.$disconnect(); + console.log("Prisma seed completed."); + }) + .catch(async (error) => { + console.error(error); + await prisma.$disconnect(); + process.exit(1); + }); \ No newline at end of file diff --git a/Frontend/1 het/backend/scripts/build-production-images.bat b/Frontend/1 het/backend/scripts/build-production-images.bat new file mode 100644 index 0000000..5ea58cf --- /dev/null +++ b/Frontend/1 het/backend/scripts/build-production-images.bat @@ -0,0 +1,49 @@ +@echo off +setlocal EnableExtensions EnableDelayedExpansion + +set "ROOT_DIR=%~dp0.." +set "IMAGE_OUT_DIR=%ROOT_DIR%\images" +set "ARCHIVE_FILE=%IMAGE_OUT_DIR%\webstore-production-images.tar" + +set "API_IMAGE=webstore-api:prod" +set "DB_IMAGE=postgres:16-alpine" + +echo [1/6] Checking Docker availability... +docker --version >nul 2>&1 +if errorlevel 1 ( + echo ERROR: Docker CLI is not available. Install Docker Desktop first. + exit /b 1 +) + +echo [2/6] Building production API image: %API_IMAGE% +pushd "%ROOT_DIR%" >nul +docker build -t "%API_IMAGE%" -f Dockerfile . +if errorlevel 1 ( + popd >nul + echo ERROR: Failed to build API image. + exit /b 1 +) +popd >nul + +echo [3/6] Pulling database image: %DB_IMAGE% +docker pull "%DB_IMAGE%" +if errorlevel 1 ( + echo ERROR: Failed to pull database image. + exit /b 1 +) + +echo [4/6] Preparing image output directory: %IMAGE_OUT_DIR% +if not exist "%IMAGE_OUT_DIR%" mkdir "%IMAGE_OUT_DIR%" + +echo [5/6] Exporting images to archive... +if exist "%ARCHIVE_FILE%" del /f /q "%ARCHIVE_FILE%" +docker save -o "%ARCHIVE_FILE%" "%API_IMAGE%" "%DB_IMAGE%" +if errorlevel 1 ( + echo ERROR: Failed to export Docker images. + exit /b 1 +) + +echo [6/6] Done. +echo Created archive: "%ARCHIVE_FILE%" +echo Share this file with students together with production.compose.yml and .production.env. +exit /b 0 \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Api/Controller/shop.controller.js b/Frontend/1 het/backend/src/Api/Controller/shop.controller.js new file mode 100644 index 0000000..a4a72b1 --- /dev/null +++ b/Frontend/1 het/backend/src/Api/Controller/shop.controller.js @@ -0,0 +1,57 @@ +const GetCategoriesQuery = require("../../Application/Shop/Query/GetCategoriesQuery"); +const GetProductsQuery = require("../../Application/Shop/Query/GetProductsQuery"); +const CreateOrderCommand = require("../../Application/Shop/Command/CreateOrderCommand"); +const CreateProductCommand = require("../../Application/Shop/Command/CreateProductCommand"); +const container = require("../../Infrastructure/DI/container"); + +const getCategoriesHandler = container.resolve("GetCategoriesQueryHandler"); +const getProductsHandler = container.resolve("GetProductsQueryHandler"); +const createOrderHandler = container.resolve("CreateOrderCommandHandler"); +const createProductHandler = container.resolve("CreateProductCommandHandler"); + +const getCategories = async (req, res, next) => { + try { + const query = new GetCategoriesQuery(); + const data = await getCategoriesHandler.handle(query); + return res.json({ data }); + } catch (error) { + return next(error); + } +}; + +const getProducts = async (req, res, next) => { + try { + const query = new GetProductsQuery(); + const data = await getProductsHandler.handle(query); + return res.json({ data }); + } catch (error) { + return next(error); + } +}; + +const createProduct = async (req, res, next) => { + try { + const command = new CreateProductCommand(req.body); + const data = await createProductHandler.handle(command); + return res.status(201).json({ data }); + } catch (error) { + return next(error); + } +}; + +const createOrder = async (req, res, next) => { + try { + const command = new CreateOrderCommand(req.body); + const data = await createOrderHandler.handle(command); + return res.status(201).json({ data }); + } catch (error) { + return next(error); + } +}; + +module.exports = { + getCategories, + getProducts, + createProduct, + createOrder +}; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Api/Controller/user.controller.js b/Frontend/1 het/backend/src/Api/Controller/user.controller.js new file mode 100644 index 0000000..fd5e48e --- /dev/null +++ b/Frontend/1 het/backend/src/Api/Controller/user.controller.js @@ -0,0 +1,64 @@ +const RegisterUserCommand = require("../../Application/User/Command/RegisterUserCommand"); +const LoginUserCommand = require("../../Application/User/Command/LoginUserCommand"); +const LogoutUserCommand = require("../../Application/User/Command/LogoutUserCommand"); +const GetCurrentUserQuery = require("../../Application/User/Query/GetCurrentUserQuery"); +const container = require("../../Infrastructure/DI/container"); + +const authService = container.resolve("AuthService"); +const registerHandler = container.resolve("RegisterUserCommandHandler"); +const loginHandler = container.resolve("LoginUserCommandHandler"); +const logoutHandler = container.resolve("LogoutUserCommandHandler"); +const currentUserQueryHandler = container.resolve("GetCurrentUserQueryHandler"); + +const register = async (req, res, next) => { + try { + const command = new RegisterUserCommand(req.body); + const result = await registerHandler.handle(command); + + res.cookie(authService.cookieName, result.token, authService.cookieOptions()); + return res.status(201).json({ data: result.user }); + } catch (error) { + return next(error); + } +}; + +const login = async (req, res, next) => { + try { + const command = new LoginUserCommand(req.body); + const result = await loginHandler.handle(command); + + res.cookie(authService.cookieName, result.token, authService.cookieOptions()); + return res.json({ data: result.user }); + } catch (error) { + return next(error); + } +}; + +const me = async (req, res, next) => { + try { + const query = new GetCurrentUserQuery({ userId: req.auth.userId }); + const result = await currentUserQueryHandler.handle(query); + return res.json({ data: result }); + } catch (error) { + return next(error); + } +}; + +const logout = async (req, res, next) => { + try { + const command = new LogoutUserCommand({ userId: req.auth.userId }); + await logoutHandler.handle(command); + + res.clearCookie(authService.cookieName, authService.clearCookieOptions()); + return res.status(204).send(); + } catch (error) { + return next(error); + } +}; + +module.exports = { + register, + login, + me, + logout +}; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Api/Middleware/auth.middleware.js b/Frontend/1 het/backend/src/Api/Middleware/auth.middleware.js new file mode 100644 index 0000000..b7e18fe --- /dev/null +++ b/Frontend/1 het/backend/src/Api/Middleware/auth.middleware.js @@ -0,0 +1,20 @@ +const AuthService = require("../../Application/Services/AuthService"); + +const authService = new AuthService(); + +const authMiddleware = (req, res, next) => { + try { + const token = req.cookies[authService.cookieName]; + + if (!token) { + return res.status(401).json({ message: "Authentication required." }); + } + + req.auth = authService.verifyToken(token); + return next(); + } catch (error) { + return res.status(401).json({ message: "Invalid or expired token." }); + } +}; + +module.exports = authMiddleware; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Api/Middleware/errorHandler.js b/Frontend/1 het/backend/src/Api/Middleware/errorHandler.js new file mode 100644 index 0000000..8fed651 --- /dev/null +++ b/Frontend/1 het/backend/src/Api/Middleware/errorHandler.js @@ -0,0 +1,12 @@ +const errorHandler = (err, req, res, next) => { + if (res.headersSent) { + return next(err); + } + + const status = err.statusCode || 500; + return res.status(status).json({ + message: err.message || "Internal server error" + }); +}; + +module.exports = errorHandler; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Api/Middleware/notFound.js b/Frontend/1 het/backend/src/Api/Middleware/notFound.js new file mode 100644 index 0000000..8010bc3 --- /dev/null +++ b/Frontend/1 het/backend/src/Api/Middleware/notFound.js @@ -0,0 +1,5 @@ +const notFound = (req, res) => { + res.status(404).json({ message: "Route not found" }); +}; + +module.exports = notFound; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Api/Router/shop.router.js b/Frontend/1 het/backend/src/Api/Router/shop.router.js new file mode 100644 index 0000000..04a0ab4 --- /dev/null +++ b/Frontend/1 het/backend/src/Api/Router/shop.router.js @@ -0,0 +1,11 @@ +const express = require("express"); +const controller = require("../Controller/shop.controller"); + +const router = express.Router(); + +router.get("/categories", controller.getCategories); +router.get("/products", controller.getProducts); +router.post("/products", controller.createProduct); +router.post("/orders", controller.createOrder); + +module.exports = router; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Api/Router/user.router.js b/Frontend/1 het/backend/src/Api/Router/user.router.js new file mode 100644 index 0000000..387154c --- /dev/null +++ b/Frontend/1 het/backend/src/Api/Router/user.router.js @@ -0,0 +1,12 @@ +const express = require("express"); +const controller = require("../Controller/user.controller"); +const authMiddleware = require("../Middleware/auth.middleware"); + +const router = express.Router(); + +router.post("/register", controller.register); +router.post("/login", controller.login); +router.get("/me", authMiddleware, controller.me); +router.post("/logout", authMiddleware, controller.logout); + +module.exports = router; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Api/app.js b/Frontend/1 het/backend/src/Api/app.js new file mode 100644 index 0000000..78e58f5 --- /dev/null +++ b/Frontend/1 het/backend/src/Api/app.js @@ -0,0 +1,30 @@ +const express = require("express"); +const helmet = require("helmet"); +const cors = require("cors"); +const morgan = require("morgan"); +const cookieParser = require("cookie-parser"); + +const userRouter = require("./Router/user.router"); +const shopRouter = require("./Router/shop.router"); +const notFound = require("./Middleware/notFound"); +const errorHandler = require("./Middleware/errorHandler"); + +const app = express(); + +app.use(helmet()); +app.use(cors({ origin: true, credentials: true })); +app.use(morgan("dev")); +app.use(express.json()); +app.use(cookieParser()); + +app.get("/api/health", (req, res) => { + res.json({ status: "ok", message: "CQRS backend running" }); +}); + +app.use("/api/users", userRouter); +app.use("/api/shop", shopRouter); + +app.use(notFound); +app.use(errorHandler); + +module.exports = app; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Api/server.js b/Frontend/1 het/backend/src/Api/server.js new file mode 100644 index 0000000..c07057a --- /dev/null +++ b/Frontend/1 het/backend/src/Api/server.js @@ -0,0 +1,6 @@ +const app = require("./app"); +const env = require("../config/env"); + +app.listen(env.port, () => { + console.log(`Server listening on port ${env.port}`); +}); \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/DTO/UserDTO.js b/Frontend/1 het/backend/src/Application/DTO/UserDTO.js new file mode 100644 index 0000000..a7bb5ee --- /dev/null +++ b/Frontend/1 het/backend/src/Application/DTO/UserDTO.js @@ -0,0 +1,10 @@ +class UserDTO { + constructor(user) { + this.id = user.id; + this.name = user.name; + this.email = user.email; + this.createdAt = user.createdAt; + } +} + +module.exports = UserDTO; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/Services/AuthService.js b/Frontend/1 het/backend/src/Application/Services/AuthService.js new file mode 100644 index 0000000..804c20e --- /dev/null +++ b/Frontend/1 het/backend/src/Application/Services/AuthService.js @@ -0,0 +1,37 @@ +const jwt = require("jsonwebtoken"); +const env = require("../../config/env"); + +class AuthService { + constructor() { + this.cookieName = env.cookieName; + } + + signToken(payload) { + return jwt.sign(payload, env.jwtSecret, { expiresIn: env.jwtExpiresIn }); + } + + verifyToken(token) { + return jwt.verify(token, env.jwtSecret); + } + + cookieOptions() { + return { + httpOnly: true, + sameSite: "lax", + secure: env.cookieSecure, + path: "/", + maxAge: 7 * 24 * 60 * 60 * 1000 + }; + } + + clearCookieOptions() { + return { + httpOnly: true, + sameSite: "lax", + secure: env.cookieSecure, + path: "/" + }; + } +} + +module.exports = AuthService; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/Services/PasswordService.js b/Frontend/1 het/backend/src/Application/Services/PasswordService.js new file mode 100644 index 0000000..5e7c10b --- /dev/null +++ b/Frontend/1 het/backend/src/Application/Services/PasswordService.js @@ -0,0 +1,13 @@ +const bcrypt = require("bcryptjs"); + +class PasswordService { + async hash(rawPassword) { + return bcrypt.hash(rawPassword, 10); + } + + async compare(rawPassword, hash) { + return bcrypt.compare(rawPassword, hash); + } +} + +module.exports = PasswordService; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/Shop/Command/CreateOrderCommand.js b/Frontend/1 het/backend/src/Application/Shop/Command/CreateOrderCommand.js new file mode 100644 index 0000000..e8f15df --- /dev/null +++ b/Frontend/1 het/backend/src/Application/Shop/Command/CreateOrderCommand.js @@ -0,0 +1,9 @@ +class CreateOrderCommand { + constructor(payload) { + this.customer_name = payload.customer_name; + this.customer_email = payload.customer_email; + this.items = payload.items; + } +} + +module.exports = CreateOrderCommand; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/Shop/Command/CreateOrderCommandHandler.js b/Frontend/1 het/backend/src/Application/Shop/Command/CreateOrderCommandHandler.js new file mode 100644 index 0000000..553fa30 --- /dev/null +++ b/Frontend/1 het/backend/src/Application/Shop/Command/CreateOrderCommandHandler.js @@ -0,0 +1,11 @@ +class CreateOrderCommandHandler { + constructor(shopRepository) { + this.shopRepository = shopRepository; + } + + async handle(command) { + return this.shopRepository.createOrder(command); + } +} + +module.exports = CreateOrderCommandHandler; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/Shop/Command/CreateProductCommand.js b/Frontend/1 het/backend/src/Application/Shop/Command/CreateProductCommand.js new file mode 100644 index 0000000..52e78af --- /dev/null +++ b/Frontend/1 het/backend/src/Application/Shop/Command/CreateProductCommand.js @@ -0,0 +1,12 @@ +class CreateProductCommand { + constructor(payload) { + this.category_id = payload.category_id; + this.name = payload.name; + this.description = payload.description; + this.price = payload.price; + this.image_url = payload.image_url; + this.stock = payload.stock; + } +} + +module.exports = CreateProductCommand; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/Shop/Command/CreateProductCommandHandler.js b/Frontend/1 het/backend/src/Application/Shop/Command/CreateProductCommandHandler.js new file mode 100644 index 0000000..9bba82b --- /dev/null +++ b/Frontend/1 het/backend/src/Application/Shop/Command/CreateProductCommandHandler.js @@ -0,0 +1,11 @@ +class CreateProductCommandHandler { + constructor(shopRepository) { + this.shopRepository = shopRepository; + } + + async handle(command) { + return this.shopRepository.createProduct(command); + } +} + +module.exports = CreateProductCommandHandler; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/Shop/Query/GetCategoriesQuery.js b/Frontend/1 het/backend/src/Application/Shop/Query/GetCategoriesQuery.js new file mode 100644 index 0000000..c0a710b --- /dev/null +++ b/Frontend/1 het/backend/src/Application/Shop/Query/GetCategoriesQuery.js @@ -0,0 +1,3 @@ +class GetCategoriesQuery {} + +module.exports = GetCategoriesQuery; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/Shop/Query/GetCategoriesQueryHandler.js b/Frontend/1 het/backend/src/Application/Shop/Query/GetCategoriesQueryHandler.js new file mode 100644 index 0000000..3321ad7 --- /dev/null +++ b/Frontend/1 het/backend/src/Application/Shop/Query/GetCategoriesQueryHandler.js @@ -0,0 +1,11 @@ +class GetCategoriesQueryHandler { + constructor(shopRepository) { + this.shopRepository = shopRepository; + } + + async handle() { + return this.shopRepository.findCategories(); + } +} + +module.exports = GetCategoriesQueryHandler; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/Shop/Query/GetProductsQuery.js b/Frontend/1 het/backend/src/Application/Shop/Query/GetProductsQuery.js new file mode 100644 index 0000000..1e80020 --- /dev/null +++ b/Frontend/1 het/backend/src/Application/Shop/Query/GetProductsQuery.js @@ -0,0 +1,3 @@ +class GetProductsQuery {} + +module.exports = GetProductsQuery; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/Shop/Query/GetProductsQueryHandler.js b/Frontend/1 het/backend/src/Application/Shop/Query/GetProductsQueryHandler.js new file mode 100644 index 0000000..ae348e3 --- /dev/null +++ b/Frontend/1 het/backend/src/Application/Shop/Query/GetProductsQueryHandler.js @@ -0,0 +1,11 @@ +class GetProductsQueryHandler { + constructor(shopRepository) { + this.shopRepository = shopRepository; + } + + async handle() { + return this.shopRepository.findProducts(); + } +} + +module.exports = GetProductsQueryHandler; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/User/Command/LoginUserCommand.js b/Frontend/1 het/backend/src/Application/User/Command/LoginUserCommand.js new file mode 100644 index 0000000..af85a39 --- /dev/null +++ b/Frontend/1 het/backend/src/Application/User/Command/LoginUserCommand.js @@ -0,0 +1,8 @@ +class LoginUserCommand { + constructor(payload) { + this.email = payload.email; + this.password = payload.password; + } +} + +module.exports = LoginUserCommand; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/User/Command/LoginUserCommandHandler.js b/Frontend/1 het/backend/src/Application/User/Command/LoginUserCommandHandler.js new file mode 100644 index 0000000..39cdab1 --- /dev/null +++ b/Frontend/1 het/backend/src/Application/User/Command/LoginUserCommandHandler.js @@ -0,0 +1,37 @@ +const PasswordService = require("../../Services/PasswordService"); +const UserDTO = require("../../DTO/UserDTO"); + +class LoginUserCommandHandler { + constructor(userRepository, authService) { + this.userRepository = userRepository; + this.authService = authService; + this.passwordService = new PasswordService(); + } + + async handle(command) { + if (!command.email || !command.password) { + const error = new Error("email and password are required"); + error.statusCode = 400; + throw error; + } + + const user = await this.userRepository.findByEmail(command.email); + if (!user) { + const error = new Error("Invalid credentials"); + error.statusCode = 401; + throw error; + } + + const isValid = await this.passwordService.compare(command.password, user.passwordHash); + if (!isValid) { + const error = new Error("Invalid credentials"); + error.statusCode = 401; + throw error; + } + + const token = this.authService.signToken({ userId: user.id, email: user.email }); + return { user: new UserDTO(user), token }; + } +} + +module.exports = LoginUserCommandHandler; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/User/Command/LogoutUserCommand.js b/Frontend/1 het/backend/src/Application/User/Command/LogoutUserCommand.js new file mode 100644 index 0000000..42d13f0 --- /dev/null +++ b/Frontend/1 het/backend/src/Application/User/Command/LogoutUserCommand.js @@ -0,0 +1,7 @@ +class LogoutUserCommand { + constructor(payload) { + this.userId = payload.userId; + } +} + +module.exports = LogoutUserCommand; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/User/Command/LogoutUserCommandHandler.js b/Frontend/1 het/backend/src/Application/User/Command/LogoutUserCommandHandler.js new file mode 100644 index 0000000..f23c919 --- /dev/null +++ b/Frontend/1 het/backend/src/Application/User/Command/LogoutUserCommandHandler.js @@ -0,0 +1,11 @@ +class LogoutUserCommandHandler { + async handle(command) { + if (!command.userId) { + const error = new Error("Unauthorized"); + error.statusCode = 401; + throw error; + } + } +} + +module.exports = LogoutUserCommandHandler; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/User/Command/RegisterUserCommand.js b/Frontend/1 het/backend/src/Application/User/Command/RegisterUserCommand.js new file mode 100644 index 0000000..f42219d --- /dev/null +++ b/Frontend/1 het/backend/src/Application/User/Command/RegisterUserCommand.js @@ -0,0 +1,9 @@ +class RegisterUserCommand { + constructor(payload) { + this.name = payload.name; + this.email = payload.email; + this.password = payload.password; + } +} + +module.exports = RegisterUserCommand; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/User/Command/RegisterUserCommandHandler.js b/Frontend/1 het/backend/src/Application/User/Command/RegisterUserCommandHandler.js new file mode 100644 index 0000000..1ad7dda --- /dev/null +++ b/Frontend/1 het/backend/src/Application/User/Command/RegisterUserCommandHandler.js @@ -0,0 +1,37 @@ +const PasswordService = require("../../Services/PasswordService"); +const UserDTO = require("../../DTO/UserDTO"); + +class RegisterUserCommandHandler { + constructor(userRepository, authService) { + this.userRepository = userRepository; + this.authService = authService; + this.passwordService = new PasswordService(); + } + + async handle(command) { + if (!command.name || !command.email || !command.password) { + const error = new Error("name, email and password are required"); + error.statusCode = 400; + throw error; + } + + const existing = await this.userRepository.findByEmail(command.email); + if (existing) { + const error = new Error("Email already in use"); + error.statusCode = 409; + throw error; + } + + const passwordHash = await this.passwordService.hash(command.password); + const user = await this.userRepository.create({ + name: command.name, + email: command.email, + passwordHash + }); + + const token = this.authService.signToken({ userId: user.id, email: user.email }); + return { user: new UserDTO(user), token }; + } +} + +module.exports = RegisterUserCommandHandler; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/User/Query/GetCurrentUserQuery.js b/Frontend/1 het/backend/src/Application/User/Query/GetCurrentUserQuery.js new file mode 100644 index 0000000..6e9b2e8 --- /dev/null +++ b/Frontend/1 het/backend/src/Application/User/Query/GetCurrentUserQuery.js @@ -0,0 +1,7 @@ +class GetCurrentUserQuery { + constructor(payload) { + this.userId = payload.userId; + } +} + +module.exports = GetCurrentUserQuery; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Application/User/Query/GetCurrentUserQueryHandler.js b/Frontend/1 het/backend/src/Application/User/Query/GetCurrentUserQueryHandler.js new file mode 100644 index 0000000..7d6c948 --- /dev/null +++ b/Frontend/1 het/backend/src/Application/User/Query/GetCurrentUserQueryHandler.js @@ -0,0 +1,26 @@ +const UserDTO = require("../../DTO/UserDTO"); + +class GetCurrentUserQueryHandler { + constructor(userRepository) { + this.userRepository = userRepository; + } + + async handle(query) { + if (!query.userId) { + const error = new Error("Unauthorized"); + error.statusCode = 401; + throw error; + } + + const user = await this.userRepository.findById(query.userId); + if (!user) { + const error = new Error("User not found"); + error.statusCode = 404; + throw error; + } + + return new UserDTO(user); + } +} + +module.exports = GetCurrentUserQueryHandler; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Domain/IRepository/IUserRepository.js b/Frontend/1 het/backend/src/Domain/IRepository/IUserRepository.js new file mode 100644 index 0000000..e5d7a32 --- /dev/null +++ b/Frontend/1 het/backend/src/Domain/IRepository/IUserRepository.js @@ -0,0 +1,15 @@ +class IUserRepository { + async findById(_id) { + throw new Error("Method not implemented"); + } + + async findByEmail(_email) { + throw new Error("Method not implemented"); + } + + async create(_data) { + throw new Error("Method not implemented"); + } +} + +module.exports = IUserRepository; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Domain/Models/User.js b/Frontend/1 het/backend/src/Domain/Models/User.js new file mode 100644 index 0000000..5d578a7 --- /dev/null +++ b/Frontend/1 het/backend/src/Domain/Models/User.js @@ -0,0 +1,11 @@ +class User { + constructor({ id, name, email, passwordHash, createdAt }) { + this.id = id; + this.name = name; + this.email = email; + this.passwordHash = passwordHash; + this.createdAt = createdAt; + } +} + +module.exports = User; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Infrastructure/DI/DIContainer.js b/Frontend/1 het/backend/src/Infrastructure/DI/DIContainer.js new file mode 100644 index 0000000..4116a85 --- /dev/null +++ b/Frontend/1 het/backend/src/Infrastructure/DI/DIContainer.js @@ -0,0 +1,32 @@ +class DIContainer { + constructor() { + this.registry = new Map(); + this.singletons = new Map(); + } + + registerSingleton(token, factory) { + this.registry.set(token, { factory, lifetime: "singleton" }); + } + + registerTransient(token, factory) { + this.registry.set(token, { factory, lifetime: "transient" }); + } + + resolve(token) { + const entry = this.registry.get(token); + if (!entry) { + throw new Error(`Dependency not registered: ${token}`); + } + + if (entry.lifetime === "singleton") { + if (!this.singletons.has(token)) { + this.singletons.set(token, entry.factory(this)); + } + return this.singletons.get(token); + } + + return entry.factory(this); + } +} + +module.exports = DIContainer; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Infrastructure/DI/container.js b/Frontend/1 het/backend/src/Infrastructure/DI/container.js new file mode 100644 index 0000000..899c49b --- /dev/null +++ b/Frontend/1 het/backend/src/Infrastructure/DI/container.js @@ -0,0 +1,57 @@ +const DIContainer = require("./DIContainer"); + +const AuthService = require("../../Application/Services/AuthService"); + +const UserPrismaRepository = require("../Repository/UserPrismaRepository"); +const ShopPrismaRepository = require("../Repository/ShopPrismaRepository"); + +const RegisterUserCommandHandler = require("../../Application/User/Command/RegisterUserCommandHandler"); +const LoginUserCommandHandler = require("../../Application/User/Command/LoginUserCommandHandler"); +const LogoutUserCommandHandler = require("../../Application/User/Command/LogoutUserCommandHandler"); +const GetCurrentUserQueryHandler = require("../../Application/User/Query/GetCurrentUserQueryHandler"); + +const GetCategoriesQueryHandler = require("../../Application/Shop/Query/GetCategoriesQueryHandler"); +const GetProductsQueryHandler = require("../../Application/Shop/Query/GetProductsQueryHandler"); +const CreateProductCommandHandler = require("../../Application/Shop/Command/CreateProductCommandHandler"); +const CreateOrderCommandHandler = require("../../Application/Shop/Command/CreateOrderCommandHandler"); + +const container = new DIContainer(); + +container.registerSingleton("AuthService", () => new AuthService()); + +container.registerSingleton("UserRepository", () => new UserPrismaRepository()); +container.registerSingleton("ShopRepository", () => new ShopPrismaRepository()); + +container.registerSingleton("RegisterUserCommandHandler", (c) => { + return new RegisterUserCommandHandler(c.resolve("UserRepository"), c.resolve("AuthService")); +}); + +container.registerSingleton("LoginUserCommandHandler", (c) => { + return new LoginUserCommandHandler(c.resolve("UserRepository"), c.resolve("AuthService")); +}); + +container.registerSingleton("LogoutUserCommandHandler", () => { + return new LogoutUserCommandHandler(); +}); + +container.registerSingleton("GetCurrentUserQueryHandler", (c) => { + return new GetCurrentUserQueryHandler(c.resolve("UserRepository")); +}); + +container.registerSingleton("GetCategoriesQueryHandler", (c) => { + return new GetCategoriesQueryHandler(c.resolve("ShopRepository")); +}); + +container.registerSingleton("GetProductsQueryHandler", (c) => { + return new GetProductsQueryHandler(c.resolve("ShopRepository")); +}); + +container.registerSingleton("CreateProductCommandHandler", (c) => { + return new CreateProductCommandHandler(c.resolve("ShopRepository")); +}); + +container.registerSingleton("CreateOrderCommandHandler", (c) => { + return new CreateOrderCommandHandler(c.resolve("ShopRepository")); +}); + +module.exports = container; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Infrastructure/Repository/ShopPrismaRepository.js b/Frontend/1 het/backend/src/Infrastructure/Repository/ShopPrismaRepository.js new file mode 100644 index 0000000..7305b70 --- /dev/null +++ b/Frontend/1 het/backend/src/Infrastructure/Repository/ShopPrismaRepository.js @@ -0,0 +1,126 @@ +const prisma = require("../../config/prisma"); + +class ShopPrismaRepository { + async findCategories() { + return prisma.category.findMany({ orderBy: { name: "asc" } }); + } + + async findProducts() { + return prisma.product.findMany({ + include: { + category: true + }, + orderBy: { id: "asc" } + }); + } + + async createProduct(payload) { + const categoryId = Number(payload.category_id); + const stock = payload.stock == null ? 0 : Number(payload.stock); + const price = Number(payload.price); + + if (Number.isNaN(categoryId) || !payload.name || Number.isNaN(price) || Number.isNaN(stock)) { + const error = new Error("category_id, name, price and stock are required"); + error.statusCode = 400; + throw error; + } + + if (price < 0 || stock < 0) { + const error = new Error("price and stock must be >= 0"); + error.statusCode = 400; + throw error; + } + + const category = await prisma.category.findUnique({ where: { id: categoryId } }); + if (!category) { + const error = new Error("Category not found"); + error.statusCode = 404; + throw error; + } + + return prisma.product.create({ + data: { + categoryId, + name: payload.name, + description: payload.description || null, + price, + imageUrl: payload.image_url || null, + stock + }, + include: { + category: true + } + }); + } + + async createOrder(payload) { + const { customer_name: customerName, customer_email: customerEmail, items } = payload; + + if (!customerName || !customerEmail || !Array.isArray(items) || items.length === 0) { + const error = new Error("customer_name, customer_email and items are required"); + error.statusCode = 400; + throw error; + } + + return prisma.$transaction(async (tx) => { + let totalPrice = 0; + const orderItems = []; + + for (const item of items) { + const productId = Number(item.product_id); + const quantity = Number(item.quantity); + + if (Number.isNaN(productId) || Number.isNaN(quantity) || quantity <= 0) { + const error = new Error("Each item needs product_id and quantity > 0"); + error.statusCode = 400; + throw error; + } + + const product = await tx.product.findUnique({ where: { id: productId } }); + if (!product) { + const error = new Error(`Product ${productId} not found`); + error.statusCode = 404; + throw error; + } + + if (product.stock < quantity) { + const error = new Error(`Not enough stock for product ${product.name}`); + error.statusCode = 400; + throw error; + } + + totalPrice += Number(product.price) * quantity; + orderItems.push({ product, quantity }); + } + + const order = await tx.order.create({ + data: { + customerName, + customerEmail, + totalPrice, + items: { + create: orderItems.map((entry) => ({ + productId: entry.product.id, + quantity: entry.quantity, + unitPrice: entry.product.price + })) + } + }, + include: { + items: true + } + }); + + for (const entry of orderItems) { + await tx.product.update({ + where: { id: entry.product.id }, + data: { stock: entry.product.stock - entry.quantity } + }); + } + + return order; + }); + } +} + +module.exports = ShopPrismaRepository; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/Infrastructure/Repository/UserPrismaRepository.js b/Frontend/1 het/backend/src/Infrastructure/Repository/UserPrismaRepository.js new file mode 100644 index 0000000..fd6e741 --- /dev/null +++ b/Frontend/1 het/backend/src/Infrastructure/Repository/UserPrismaRepository.js @@ -0,0 +1,29 @@ +const prisma = require("../../config/prisma"); +const IUserRepository = require("../../Domain/IRepository/IUserRepository"); +const User = require("../../Domain/Models/User"); + +class UserPrismaRepository extends IUserRepository { + async findById(id) { + const user = await prisma.user.findUnique({ where: { id: Number(id) } }); + return user ? new User(user) : null; + } + + async findByEmail(email) { + const user = await prisma.user.findUnique({ where: { email: email.toLowerCase() } }); + return user ? new User(user) : null; + } + + async create(data) { + const user = await prisma.user.create({ + data: { + name: data.name, + email: data.email.toLowerCase(), + passwordHash: data.passwordHash + } + }); + + return new User(user); + } +} + +module.exports = UserPrismaRepository; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/config/env.js b/Frontend/1 het/backend/src/config/env.js new file mode 100644 index 0000000..0de11d2 --- /dev/null +++ b/Frontend/1 het/backend/src/config/env.js @@ -0,0 +1,14 @@ +const path = require("path"); +const dotenv = require("dotenv"); + +dotenv.config({ path: path.resolve(process.cwd(), ".env") }); + +module.exports = { + port: Number(process.env.PORT || 3000), + nodeEnv: process.env.NODE_ENV || "development", + databaseUrl: process.env.DATABASE_URL, + jwtSecret: process.env.JWT_SECRET || "dev-secret", + jwtExpiresIn: process.env.JWT_EXPIRES_IN || "7d", + cookieName: process.env.COOKIE_NAME || "webstore_token", + cookieSecure: process.env.COOKIE_SECURE === "true" +}; \ No newline at end of file diff --git a/Frontend/1 het/backend/src/config/prisma.js b/Frontend/1 het/backend/src/config/prisma.js new file mode 100644 index 0000000..05898df --- /dev/null +++ b/Frontend/1 het/backend/src/config/prisma.js @@ -0,0 +1,5 @@ +const { PrismaClient } = require("@prisma/client"); + +const prisma = new PrismaClient(); + +module.exports = prisma; \ No newline at end of file diff --git a/TypeScript_ppt/common/it_logo.pdf b/TypeScript_ppt/common/it_logo.pdf new file mode 100644 index 0000000..dde9932 Binary files /dev/null and b/TypeScript_ppt/common/it_logo.pdf differ diff --git a/TypeScript_ppt/common/sze_logo.pdf b/TypeScript_ppt/common/sze_logo.pdf new file mode 100644 index 0000000..cbf22f9 Binary files /dev/null and b/TypeScript_ppt/common/sze_logo.pdf differ diff --git a/TypeScript_ppt/common/webfejl.sty b/TypeScript_ppt/common/webfejl.sty new file mode 100644 index 0000000..de69502 --- /dev/null +++ b/TypeScript_ppt/common/webfejl.sty @@ -0,0 +1,230 @@ +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +\usepackage[magyar]{babel} +\usepackage{indentfirst} +\usepackage{graphicx} +\usepackage{tikz} +\usetikzlibrary{positioning} +\usepackage{fancyvrb} +\usepackage{amssymb} +\usepackage{pifont} +\usepackage{newunicodechar} + +% Unicode szimbólumok definiálása +\newcommand{\cmark}{\ding{51}} % ✓ check mark +\newcommand{\xmark}{\ding{55}} % ✗ ballot x +\newunicodechar{✓}{\cmark} +\newunicodechar{✗}{\xmark} +\newunicodechar{❌}{\textcolor{red}{\xmark}} + +% Globális verbatim beállítás - tiny betűméret minden verbatim blokkhoz +\fvset{fontsize=\tiny} +\usepackage{listingsutf8} +\usepackage{textcomp} +\usepackage{eurosym} +\usepackage{mathtools} +\lstset{literate= + {á}{{\'a}}1 {é}{{\'e}}1 {í}{{\'i}}1 {ó}{{\'o}}1 {ú}{{\'u}}1 + {Á}{{\'A}}1 {É}{{\'E}}1 {Í}{{\'I}}1 {Ó}{{\'O}}1 {Ú}{{\'U}}1 + {à}{{\`a}}1 {è}{{\`e}}1 {ì}{{\`i}}1 {ò}{{\`o}}1 {ù}{{\`u}}1 + {À}{{\`A}}1 {È}{{\'E}}1 {Ì}{{\`I}}1 {Ò}{{\`O}}1 {Ù}{{\`U}}1 + {ä}{{\"a}}1 {ë}{{\"e}}1 {ï}{{\"i}}1 {ö}{{\"o}}1 {ü}{{\"u}}1 + {Ä}{{\"A}}1 {Ë}{{\"E}}1 {Ï}{{\"I}}1 {Ö}{{\"O}}1 {Ü}{{\"U}}1 + {â}{{\^a}}1 {ê}{{\^e}}1 {î}{{\^i}}1 {ô}{{\^o}}1 {û}{{\^u}}1 + {Â}{{\^A}}1 {Ê}{{\^E}}1 {Î}{{\^I}}1 {Ô}{{\^O}}1 {Û}{{\^U}}1 + {œ}{{\oe}}1 {Œ}{{\OE}}1 {æ}{{\ae}}1 {Æ}{{\AE}}1 {ß}{{\ss}}1 + {ç}{{\c c}}1 {Ç}{{\c C}}1 {ø}{{\o}}1 {å}{{\r a}}1 {Å}{{\r A}}1 + {€}{{\EUR}}1 {£}{{\pounds}}1 {ő}{{\H{o}}}1 {ű}{{\H{u}}}1 +} +% Docker nyelvdefiníció +\lstdefinelanguage{Docker}{ + keywords={FROM, RUN, CMD, LABEL, MAINTAINER, EXPOSE, ENV, ADD, COPY, + ENTRYPOINT, VOLUME, USER, WORKDIR, ARG, ONBUILD, STOPSIGNAL, + HEALTHCHECK, SHELL, AS}, + keywordstyle=\color{blue}\bfseries, + identifierstyle=\color{black}, + sensitive=false, + comment=[l]{\#}, + commentstyle=\color{purple}\ttfamily, + stringstyle=\color{red}\ttfamily, + morestring=[b]', + morestring=[b]" +} + +% JavaScript nyelvdefiníció +\lstdefinelanguage{JavaScript}{ + keywords={typeof, new, true, false, catch, function, return, null, catch, + switch, var, const, let, if, in, while, do, else, case, break, async, + await, class, export, import, extends, super, this, throw, try, default}, + keywordstyle=\color{blue}\bfseries, + ndkeywords={class, export, boolean, throw, implements, import, this}, + ndkeywordstyle=\color{darkgray}\bfseries, + identifierstyle=\color{black}, + sensitive=false, + comment=[l]{//}, + morecomment=[s]{/*}{*/}, + commentstyle=\color{purple}\ttfamily, + stringstyle=\color{red}\ttfamily, + morestring=[b]', + morestring=[b]" +} + +% YAML nyelvdefiníció +\lstdefinelanguage{yaml}{ + keywords={true,false,null,y,n}, + keywordstyle=\color{darkgray}\bfseries, + sensitive=false, + comment=[l]{\#}, + commentstyle=\color{purple}\ttfamily, + stringstyle=\color{red}\ttfamily, + morestring=[b]', + morestring=[b]", + basicstyle=\ttfamily\scriptsize, + breaklines=true, + columns=fullflexible, + keepspaces=true, + showstringspaces=false +} + +\lstdefinestyle{HTML}{ + language=HTML, + breaklines=true, + postbreak=\mbox{\textcolor{red}{$\hookrightarrow$}\space}, + stringstyle=\ttfamily, + inputencoding=utf8, + morekeywords={header, time, nav, main, article, section, aside, role, + footer, details, open, summary, srcdoc, list, datalist, placeholder, + pattern, required, min, max, step, enctype, formaction, formmethod, + formnovalidate, formtarget, output} +} + +\lstdefinestyle{JavaScript}{ + basicstyle=\ttfamily\scriptsize, + breaklines=true, + columns=fullflexible, + keepspaces=true, + showstringspaces=false, + literate={} +} +\lstdefinestyle{NodeJS}{ + basicstyle=\ttfamily\scriptsize, + breaklines=true, + columns=fullflexible, + keepspaces=true, + showstringspaces=false, + literate={} +} +\lstdefinestyle{Express}{ + basicstyle=\ttfamily\scriptsize, + breaklines=true, + columns=fullflexible, + keepspaces=true, + showstringspaces=false, + literate={} +} +\lstdefinestyle{Prisma}{ + basicstyle=\ttfamily\scriptsize, + breaklines=true, + columns=fullflexible, + keepspaces=true, + showstringspaces=false, + literate={} +} +\usepackage{hyperref} +\usepackage{attachfile} +\usepackage{multirow} +% Navigációs pöttyök hozzáadása subsection nélküli fejezetekhez +\usepackage{remreset} +\makeatletter +\@removefromreset{subsection}{section} +\makeatother +\setcounter{subsection}{1} +%%%%% +\attachfilesetup{color={1.0 0.6 0.0},author={MD},description={Kattintson duplán a minta % +megtekintéséhez!},icon=Paperclip} +% Széchenyi Egyetem arculati színek +\definecolor{szenavy}{RGB}{44,62,80} % Sötét kék (fejléc) +\definecolor{szecyan}{RGB}{0,168,225} % Világos kék (kiemelés, logó) +\definecolor{szezold}{RGB}{139,195,74} % Élénk zöld (akcentus) +\definecolor{szeszurke}{RGB}{96,96,96} % Sötét szürke +% Kompatibilitás a régi parancsokkal +\definecolor{kiemelesszin}{RGB}{0,168,225} % Kék kiemelés (szecyan) +\definecolor{kiemelesszinZ}{RGB}{139,195,74} % Zöld kiemelés (szezold) +\definecolor{kiemelesszinN}{RGB}{44,62,80} % Navy kiemelés (szenavy) +\definecolor{hivatkozasszin}{RGB}{0,168,225} % Kék hivatkozás +\newcommand{\kiemel}[1]{{\color{kiemelesszin}#1}} +\newcommand{\kiemelZ}[1]{{\color{kiemelesszinZ}#1}} +\newcommand{\kiemelN}[1]{{\color{kiemelesszinN}#1}} +\newcommand{\hiv}[1]{{\color{hivatkozasszin}#1}} +\newcommand{\logoalul}{ + \begin{picture}(0,0) + \put(120,-0){\hbox{\includegraphics[scale=.5]{./common/sze_logo.pdf}}} + \put(205,-6){\hbox{\includegraphics[scale=.4]{./common/it_logo.pdf}}} + \end{picture} +} + +\frenchspacing +\usetheme[compress]{Berlin} +\useoutertheme[subsection=false]{miniframes} +\setbeamerfont{section in head/foot}{size=\tiny} +\setbeamerfont{subsection in head/foot}{size=\tiny} + +% Adaptív, kattintható navigáció: +% sok section esetén az aktuális marad nagy és szöveges, +% a többi section lekicsinyített sorszámként jelenik meg. +\newcommand{\sectioncompactthreshold}{11} +\makeatletter +\providecommand{\totalsectionscount}{0} +\AtEndDocument{% + \immediate\write\@auxout{\string\gdef\string\totalsectionscount{\arabic{section}}}% +} +\makeatother + +\setbeamertemplate{section in head/foot}{% + {\fontsize{6}{7}\selectfont\bfseries\insertsectionhead}% +} +\setbeamertemplate{section in head/foot shaded}{% + \ifnum\totalsectionscount>\sectioncompactthreshold + {\fontsize{4.5}{5.5}\selectfont\insertsectionheadnumber}% + \else + {\fontsize{5}{6}\selectfont\insertsectionhead}% + \fi +} +\setbeamertemplate{headline} +{ + \leavevmode% + \hbox{% + \begin{beamercolorbox}[wd=\paperwidth,ht=2.5ex,dp=1.125ex]{section in head/foot}% + \insertsectionnavigationhorizontal{\paperwidth}{}{\hskip0pt plus1filll} + \end{beamercolorbox}% + } + \vskip0pt% +} + +% Kisebb betűméret a slide-okhoz +\setbeamerfont{frametitle}{size=\normalsize} +\setbeamerfont{framesubtitle}{size=\small} +\setbeamerfont{block title}{size=\small} +\setbeamerfont{block body}{size=\footnotesize} +\setbeamerfont{itemize/enumerate body}{size=\footnotesize} +\setbeamerfont{itemize/enumerate subbody}{size=\scriptsize} + +% Beamer színséma testreszabása Széchenyi arculathoz +\setbeamercolor{structure}{fg=szecyan} +\setbeamercolor{palette primary}{bg=szenavy,fg=white} +\setbeamercolor{palette secondary}{bg=szecyan,fg=white} +\setbeamercolor{palette tertiary}{bg=szezold,fg=white} +\setbeamercolor{palette quaternary}{bg=szeszurke,fg=white} +\setbeamercolor{titlelike}{parent=palette primary} +\setbeamercolor{frametitle}{bg=szenavy,fg=white} +\setbeamercolor{frametitle right}{bg=szenavy} +\setbeamercolor{block title}{bg=szecyan,fg=white} +\setbeamercolor{block body}{bg=szecyan!10,fg=black} +\setbeamercolor{block title alerted}{bg=szezold,fg=white} +\setbeamercolor{block body alerted}{bg=szezold!10,fg=black} +\setbeamercolor{item}{fg=szecyan} +\setbeamercolor{subitem}{fg=szezold} + +\author{Magda Donát} +\institute{Széchenyi István Egyetem, Győr} +\date{\hiv{\href{https://git.mdnd-it.cc/Donat/GKNB_MSTM071}{https://git.mdnd-it.cc/Donat/GKNB_MSTM071}}\\ \today} diff --git a/TypeScript_ppt/sections/01_intro_and_setup.tex b/TypeScript_ppt/sections/01_intro_and_setup.tex new file mode 100644 index 0000000..5a9aac9 --- /dev/null +++ b/TypeScript_ppt/sections/01_intro_and_setup.tex @@ -0,0 +1,86 @@ +\section{Alapok} + +\begin{frame}[fragile]{Mi a TypeScript?} +\begin{itemize} + \item A TypeScript a JavaScript \kiemel{típusos kiterjesztése}. + \item Fejlesztés közben jelez hibákat, mielőtt futna a kód. + \item A fordítás után sima JavaScript fut a böngészőben vagy Node.js alatt. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Hogyan gondolkodj róla kezdőként?} +\begin{itemize} + \item A JavaScript megmondja, \kiemel{hogyan} fusson a program. + \item A TypeScript megmutatja, \kiemel{milyen adatokkal} futhat biztonságosan. + \item A típusok dokumentációként is működnek, így a következő fejlesztő gyorsabban megérti a kódot. + \item A cél nem a bonyolult típusok gyártása, hanem a hibák korai kiszűrése. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Miért jó kezdőknek?} +\begin{itemize} + \item Könnyebb megérteni, milyen adatot vár egy függvény. + \item Biztonságosabb a refaktorálás. + \item Jobb IDE-támogatást kapsz (autocomplete, hibajelzések). + \item Kisebb az esélye a futásidejű meglepetéseknek. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Mire figyelj a tanulás elején?} +\begin{itemize} + \item Először a JavaScript alapokat erősítsd meg: változók, függvények, objektumok, tömbök. + \item Utána vezesd be a TypeScriptet kis lépésekben: előbb paraméter- és visszatérési típusokkal. + \item Ne használd túl korán az any típust, mert ezzel elveszíted a TypeScript fő előnyét. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Telepítés és első projekt} +\begin{lstlisting}[style=NodeJS] +mkdir ts-course +cd ts-course +npm init -y +npm install -D typescript ts-node @types/node +npx tsc --init +\end{lstlisting} +\end{frame} + +\begin{frame}[fragile]{Egyszerű tsconfig.json} +\begin{lstlisting}[style=JavaScript] +{ + "compilerOptions": { + "target": "ES2022", + "module": "NodeNext", + "moduleResolution": "NodeNext", + "strict": true, + "rootDir": "src", + "outDir": "dist", + "esModuleInterop": true + }, + "include": ["src"] +} +\end{lstlisting} +\begin{itemize} + \item strict: szigorúbb ellenőrzés, kevesebb rejtett hiba. + \item rootDir/outDir: tisztán elválasztja a forráskódot és a fordított kódot. + \item module NodeNext: modern ES-modulok Node környezetben. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Első TypeScript-kód} +\begin{lstlisting}[style=JavaScript] +// src/index.ts +function greet(name: string): string { + return `Hello, ${name}!`; +} + +console.log(greet("TypeScript")); +\end{lstlisting} +\begin{lstlisting}[style=NodeJS] +npx tsc +node dist/index.js +\end{lstlisting} +\begin{itemize} + \item Először a tsc fordító fut le, ez ellenőrzi a típusokat. + \item Ezután már JavaScript fut, vagyis a végrehajtás mindig JS-ben történik. +\end{itemize} +\end{frame} diff --git a/TypeScript_ppt/sections/02_basic_types.tex b/TypeScript_ppt/sections/02_basic_types.tex new file mode 100644 index 0000000..0858e7e --- /dev/null +++ b/TypeScript_ppt/sections/02_basic_types.tex @@ -0,0 +1,63 @@ +\section{Típusok} + +\begin{frame}[fragile]{Primitív típusok} +\begin{lstlisting}[style=JavaScript] +let userName: string = "Anna"; +let age: number = 20; +let isStudent: boolean = true; +let value: null = null; +let missing: undefined = undefined; +\end{lstlisting} +\begin{itemize} + \item Ezek a legalapvetőbb építőelemek, minden összetettebb típus ezekre épül. + \item A null és undefined kezelése kulcsfontosságú a stabil alkalmazásokhoz. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Típusinferencia} +\begin{lstlisting}[style=JavaScript] +let city = "Gyor"; // string +let points = 10; // number +const role = "admin"; // "admin" literal +\end{lstlisting} +\begin{itemize} + \item Nem kell mindig kiírni a típust. + \item Akkor érdemes explicit típust adni, ha nő tőle az olvashatóság. + \item Jó egyensúly: ahol egyértelmű, hagyd inferálni; ahol kétértelmű, írj explicit típust. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Tömbök és tuple} +\begin{lstlisting}[style=JavaScript] +const nums: number[] = [1, 2, 3]; +const tags: Array = ["ts", "js"]; + +const point: [number, number] = [10, 20]; +const personRow: [id: number, name: string] = [1, "Bela"]; +\end{lstlisting} +\begin{itemize} + \item Tömb: tetszőleges elemszám, azonos elemtípus. + \item Tuple: fix elemszám, pozíciónként meghatározott típus. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Objektumtípusok} +\begin{lstlisting}[style=JavaScript] +const user: { id: number; name: string; active: boolean } = { + id: 1, + name: "Kata", + active: true, +}; +\end{lstlisting} +\begin{itemize} + \item Objektumoknál a típus gyorsan hosszúvá válhat, ezért a következő lépés a type/interface használata. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Tipikus kezdő hibák típusoknál} +\begin{itemize} + \item Összekeverni a number és string értékeket (pl. "10" + 5). + \item Elfelejteni, hogy a const literál-típust is adhat. + \item Nem kezelni a null lehetőségét külső adatoknál. +\end{itemize} +\end{frame} diff --git a/TypeScript_ppt/sections/03_functions_and_unions.tex b/TypeScript_ppt/sections/03_functions_and_unions.tex new file mode 100644 index 0000000..7e50604 --- /dev/null +++ b/TypeScript_ppt/sections/03_functions_and_unions.tex @@ -0,0 +1,69 @@ +\section{Függvények} + +\begin{frame}[fragile]{Függvénytípusok} +\begin{lstlisting}[style=JavaScript] +function add(a: number, b: number): number { + return a + b; +} + +const multiply = (a: number, b: number): number => a * b; +\end{lstlisting} +\begin{itemize} + \item Mindig típusold a bemenetet, és lehetőség szerint a visszatérési értéket is. + \item Ettől egyértelműbb lesz a függvény szerződése. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Opcionális és alapértelmezett paraméter} +\begin{lstlisting}[style=JavaScript] +function greet(name: string, title?: string): string { + return title ? `${title} ${name}` : name; +} + +function power(base: number, exp = 2): number { + return base ** exp; +} +\end{lstlisting} +\begin{itemize} + \item Opcionális paraméter csak a paraméterlista végén legyen. + \item Az alapértelmezett paraméter csökkenti a hívó kód bonyolultságát. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Union típusok} +\begin{lstlisting}[style=JavaScript] +let id: string | number; +id = "A12"; +id = 12; + +type Direction = "up" | "down" | "left" | "right"; +let move: Direction = "left"; +\end{lstlisting} +\begin{itemize} + \item A union azt jelenti, hogy az adat többféle típusból érkezhet. + \item Literál unionnal szűk, előre ismert értékkészletet adhatsz meg. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Típusszűkítés (narrowing)} +\begin{lstlisting}[style=JavaScript] +function printId(value: string | number) { + if (typeof value === "string") { + console.log(value.toUpperCase()); + } else { + console.log(value.toFixed(0)); + } +} +\end{lstlisting} +\begin{itemize} + \item Narrowing nélkül a fordító nem engedné string- vagy number-specifikus metódusok hívását. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Gondolkodási minta union esetén} +\begin{itemize} + \item 1. lépés: sorold fel, milyen típusok jöhetnek. + \item 2. lépés: minden esetre írj megfelelő ellenőrzést. + \item 3. lépés: minden ágban csak az adott típushoz illő műveletet végezz. +\end{itemize} +\end{frame} diff --git a/TypeScript_ppt/sections/04_alias_interface_objects.tex b/TypeScript_ppt/sections/04_alias_interface_objects.tex new file mode 100644 index 0000000..1494f98 --- /dev/null +++ b/TypeScript_ppt/sections/04_alias_interface_objects.tex @@ -0,0 +1,61 @@ +\section{Típusaliasok és interfészek} + +\begin{frame}[fragile]{Type alias} +\begin{lstlisting}[style=JavaScript] +type User = { + id: number; + name: string; + email?: string; +}; + +const u: User = { id: 1, name: "Dora" }; +\end{lstlisting} +\begin{itemize} + \item A type kulcsszó jó választás, ha később unionöket vagy utility típusokat is használsz. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Interface} +\begin{lstlisting}[style=JavaScript] +interface Product { + sku: string; + price: number; + discount?: number; +} + +const p: Product = { sku: "A-1", price: 100 }; +\end{lstlisting} +\begin{itemize} + \item Az interface különösen hasznos API-szerződéseknél és osztályoknál. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Type vs interface (gyakorlat)} +\begin{itemize} + \item Interface: objektumszerződésekhez. + \item Type: unionokhoz, metszetekhez, utility típusokhoz. + \item Mindkettő használható objektumokhoz, a csapatdöntés a fontos. + \item A legfontosabb: kódbázison belül maradj következetes. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Readonly és opcionálisság} +\begin{lstlisting}[style=JavaScript] +type Settings = { + readonly appName: string; + theme?: "light" | "dark"; +}; +\end{lstlisting} +\begin{itemize} + \item readonly: a property létrehozás után nem módosítható. + \item ?: az adott mezőt nem kötelező minden esetben megadni. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Mikor válts type aliasról interface-re?} +\begin{itemize} + \item Ha objektumszerződést publikus API-ként szeretnél kommunikálni. + \item Ha osztály implementálja a szerződést. + \item Ha a csapatod konvenciója ezt preferálja. +\end{itemize} +\end{frame} diff --git a/TypeScript_ppt/sections/05_generics_and_utility_types.tex b/TypeScript_ppt/sections/05_generics_and_utility_types.tex new file mode 100644 index 0000000..1db62c6 --- /dev/null +++ b/TypeScript_ppt/sections/05_generics_and_utility_types.tex @@ -0,0 +1,65 @@ +\section{Középhaladó: Generikus típusok} + +\begin{frame}[fragile]{Generic alap} +\begin{lstlisting}[style=JavaScript] +function identity(value: T): T { + return value; +} + +const a = identity(42); // number +const b = identity("hello"); // string +\end{lstlisting} +\begin{itemize} + \item A generic lehetővé teszi, hogy ugyanaz a függvény több típusra is működjön. + \item A T helyére a fordító a hívás alapján következteti a típust. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Generic constraint} +\begin{lstlisting}[style=JavaScript] +function firstItem(items: T) { + return items[0]; +} + +const first = firstItem([10, 20, 30]); +\end{lstlisting} +\begin{itemize} + \item A constraint (extends) korlátozza, milyen típus adható a generic paraméternek. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Utility tipusok} +\begin{lstlisting}[style=JavaScript] +type User = { id: number; name: string; email: string }; + +type UserPatch = Partial; +type UserPublic = Pick; +type UserWithoutEmail = Omit; +\end{lstlisting} +\begin{itemize} + \item Utility típusokkal gyorsan előállíthatsz új típusokat manuális másolás nélkül. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Record es Readonly} +\begin{lstlisting}[style=JavaScript] +type ScoreByName = Record; + +type Config = Readonly<{ + apiUrl: string; + retries: number; +}>; +\end{lstlisting} +\begin{itemize} + \item Record: kulcs-érték struktúra típusosan. + \item Readonly: megakadályozza a véletlen módosításokat. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{A genericek tanulási sorrendje} +\begin{enumerate} + \item Először használj kész generic API-kat (pl. Promise, Array). + \item Utána írj egyszerű saját generic függvényt. + \item Végül vezesd be a constraintet és utility típusokat. +\end{enumerate} +\end{frame} diff --git a/TypeScript_ppt/sections/06_modules_async_and_api.tex b/TypeScript_ppt/sections/06_modules_async_and_api.tex new file mode 100644 index 0000000..873f3cc --- /dev/null +++ b/TypeScript_ppt/sections/06_modules_async_and_api.tex @@ -0,0 +1,70 @@ +\section{Középhaladó: Modulok és aszinkron működés} + +\begin{frame}[fragile]{Modulok: export/import} +\begin{lstlisting}[style=JavaScript] +// math.ts +export function add(a: number, b: number) { + return a + b; +} + +// app.ts +import { add } from "./math.js"; +console.log(add(2, 3)); +\end{lstlisting} +\begin{itemize} + \item Modulokra bontással átláthatóbb és újrafelhasználhatóbb kódot kapsz. + \item NodeNext módban importnál gyakran .js kiterjesztést használsz. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Async/Await tipusokkal} +\begin{lstlisting}[style=JavaScript] +type User = { id: number; name: string }; + +async function fetchUser(id: number): Promise { + const res = await fetch(`/api/users/${id}`); + if (!res.ok) throw new Error("Request failed"); + return res.json(); +} +\end{lstlisting} +\begin{itemize} + \item A Promise egyértelműen jelzi a hívó kódnak a várt eredményt. + \item Hibakezelés nélkül API-hívásnál nehezen diagnosztizálható hibák jelennek meg. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Kulso csomagok tipizalasa} +\begin{lstlisting}[style=NodeJS] +npm install lodash +npm install -D @types/lodash +\end{lstlisting} +\begin{itemize} + \item Sok csomag már tartalmaz beépített típusokat. + \item Ha nem, akkor @types csomagot kell telepíteni. + \item Típusok nélkül külső csomag használata gyorsan any-hoz vezet. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Axios pelda valasz-tipussal} +\begin{lstlisting}[style=JavaScript] +import axios from "axios"; + +type Todo = { id: number; title: string; done: boolean }; + +async function getTodo(id: number): Promise { + const r = await axios.get(`/api/todos/${id}`); + return r.data; +} +\end{lstlisting} +\begin{itemize} + \item A generic paraméterrel a válasz struktúrája már a hívás helyén ellenőrizhető. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Gyakorlati minta API-khoz} +\begin{itemize} + \item Definiálj külön típusokat a kérésekhez: Request DTO, Response DTO. + \item A hálózati réteget különítsd el service függvényekbe. + \item A komponensek csak a már tipizált adatot kapják. +\end{itemize} +\end{frame} diff --git a/TypeScript_ppt/sections/07_validation_and_best_practices.tex b/TypeScript_ppt/sections/07_validation_and_best_practices.tex new file mode 100644 index 0000000..3582d08 --- /dev/null +++ b/TypeScript_ppt/sections/07_validation_and_best_practices.tex @@ -0,0 +1,67 @@ +\section{Validáció} + +\begin{frame}[fragile]{any vs unknown} +\begin{lstlisting}[style=JavaScript] +let loose: any = 123; +loose = "bármi"; // nincs ellenőrzés + +let safe: unknown = JSON.parse('{"id":1}'); +if (typeof safe === "object" && safe !== null) { + // itt már szűkíthető +} +\end{lstlisting} +\begin{itemize} + \item Az any kikapcsolja a típusellenőrzést, ezért csak átmeneti esetben használd. + \item Az unknown biztonságosabb, mert használat előtt kötelező ellenőrizni. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Futásidejű validáció Type Guarddal} +\begin{lstlisting}[style=JavaScript] +function isUser(v: unknown): v is { id: number; name: string } { + return ( + typeof v === "object" && + v !== null && + "id" in v && + "name" in v + ); +} +\end{lstlisting} +\begin{itemize} + \item A TypeScript nem helyettesíti a futásidejű validációt. + \item Külső adatnál (API, localStorage, URL-paraméter) mindig ellenőrizz. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Strict mód bekapcsolása} +\begin{lstlisting}[style=JavaScript] +{ + "compilerOptions": { + "strict": true, + "noUncheckedIndexedAccess": true, + "exactOptionalPropertyTypes": true + } +} +\end{lstlisting} +\begin{itemize} + \item Ezek a beállítások kezdetben több hibát mutatnak, de hosszabb távon stabilabb kódot adnak. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Gyakori hibák} +\begin{itemize} + \item Túl sok any használata. + \item Null/undefined esetek figyelmen kívül hagyása. + \item Túl bonyolult típusok írása stabil alapok nélkül. + \item Típusok másolása utility típusok használata helyett. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Bevált gyakorlat röviden} +\begin{itemize} + \item Alapértelmezésben legyen bekapcsolva a strict mód. + \item Külső adatot mindig validálj. + \item Bonyolult típus helyett használj több kicsi, beszédes típust. + \item Legyen következetes kódstílus és linterbeállítás. +\end{itemize} +\end{frame} diff --git a/TypeScript_ppt/sections/08_learning_path_and_practice.tex b/TypeScript_ppt/sections/08_learning_path_and_practice.tex new file mode 100644 index 0000000..bd31658 --- /dev/null +++ b/TypeScript_ppt/sections/08_learning_path_and_practice.tex @@ -0,0 +1,53 @@ +\section{Tanulási Segédlet} + +\begin{frame}[fragile]{4 hetes tanulási terv} +\begin{enumerate} + \item 1. hét: típusok, tömbök, objektumok, függvények. + \item 2. hét: unionök, narrowing, aliasok, interfészek. + \item 3. hét: generics, utility típusok, modulok. + \item 4. hét: aszinkron kód, API-típusok, futásidejű validáció. +\end{enumerate} +\begin{itemize} + \item Napi 45-60 perc folyamatos gyakorlás már jól látható fejlődést ad. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Projektötletek kezdőknek} +\begin{itemize} + \item Teendőlista-alkalmazás (CRUD) típusosan. + \item Egyszerű REST API-kliens. + \item Jegyzetelő CLI fájlba mentéssel. +\end{itemize} +\begin{itemize} + \item Cél: az alaptípusok és a függvényszerződések rutinszerű használata. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Projektötletek középhaladóknak} +\begin{itemize} + \item Modulokra bontott mini backend. + \item Validációs réteggel rendelkező API-kliens. + \item Kis NPM-csomag saját típusdefiníciókkal. +\end{itemize} +\begin{itemize} + \item Cél: valós, projekt-szerű struktúrában gondolkodni. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Mit erdemes mindenkepp megtanulni?} +\begin{itemize} + \item A típusinferencia értése. + \item A union + narrowing magabiztos használata. + \item A generics és utility típusok alapjai. + \item Futásidejű validáció külső adat esetén. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Önellenőrző kérdések minden modul után} +\begin{itemize} + \item Meg tudom magyarázni, mit vár és mit ad vissza a függvényem? + \item Használtam-e any-t ott, ahol az unknown biztonságosabb lenne? + \item Tudok-e példát mondani a union + narrowing együtt használatára? + \item Validáltam-e a külső adatot, mielőtt használtam? +\end{itemize} +\end{frame} \ No newline at end of file diff --git a/TypeScript_ppt/sections/09_advanced_types.tex b/TypeScript_ppt/sections/09_advanced_types.tex new file mode 100644 index 0000000..07b06e9 --- /dev/null +++ b/TypeScript_ppt/sections/09_advanced_types.tex @@ -0,0 +1,57 @@ +\section{Haladó Típuskezelés} + +\begin{frame}[fragile]{keyof és indexed access} +\begin{lstlisting}[style=JavaScript] +type User = { + id: number; + name: string; + active: boolean; +}; + +type UserKey = keyof User; // "id" | "name" | "active" +type NameType = User["name"]; // string +\end{lstlisting} +\begin{itemize} + \item A keyof segítségével dinamikusan hivatkozhatsz egy típus kulcsaira. + \item Az indexed access típus pontosan kiolvassa egy mező típusát. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Mapped type alapminta} +\begin{lstlisting}[style=JavaScript] +type Optional = { + [K in keyof T]?: T[K]; +}; + +type ReadOnly = { + readonly [K in keyof T]: T[K]; +}; +\end{lstlisting} +\begin{itemize} + \item Mapped type-pal meglévő típusból generálhatsz új, következetes szerkezetet. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Conditional type és infer} +\begin{lstlisting}[style=JavaScript] +type ElementType = T extends (infer U)[] ? U : T; + +type A = ElementType; // string +type B = ElementType; // number +\end{lstlisting} +\begin{itemize} + \item A conditional type típus-szintű "if" logikát ad. + \item Az infer kulcsszóval résztípusokat tudsz kinyerni. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Mikor használd ezeket?} +\begin{itemize} + \item Ha sok hasonló DTO típust kell karbantartanod. + \item Ha könyvtárszintű, újrafelhasználható típus-API-t építesz. + \item Ha ismétlődő kézi típusmásolást látsz a projektben. +\end{itemize} +\begin{alertblock}{Szabály} +Haladó típust csak akkor vezess be, ha egyszerűbbé teszi a használatot. +\end{alertblock} +\end{frame} diff --git a/TypeScript_ppt/sections/10_oop_and_architecture.tex b/TypeScript_ppt/sections/10_oop_and_architecture.tex new file mode 100644 index 0000000..6c8e550 --- /dev/null +++ b/TypeScript_ppt/sections/10_oop_and_architecture.tex @@ -0,0 +1,60 @@ +\section{Osztályok és Architekturális Minták} + +\begin{frame}[fragile]{Osztályok TypeScriptben} +\begin{lstlisting}[style=JavaScript] +class Account { + constructor( + public owner: string, + private balance: number + ) {} + + deposit(amount: number): void { + this.balance += amount; + } + + getBalance(): number { + return this.balance; + } +} +\end{lstlisting} +\end{frame} + +\begin{frame}[fragile]{Interface + osztály együtt} +\begin{lstlisting}[style=JavaScript] +interface Logger { + log(message: string): void; +} + +class ConsoleLogger implements Logger { + log(message: string): void { + console.log(message); + } +} +\end{lstlisting} +\begin{itemize} + \item Az interface szerződés, az osztály ennek konkrét megvalósítása. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Rétegezett felépítés röviden} +\begin{itemize} + \item domain: üzleti logika és modellek + \item service: alkalmazási műveletek + \item infrastructure: API, adatbázis, külső kapcsolatok + \item ui/controller: bemenet-kimenet kezelése +\end{itemize} +\begin{block}{Előny} +A jól rétegzett struktúra könnyebben tesztelhető és bővíthető. +\end{block} +\end{frame} + +\begin{frame}[fragile]{Gyakori tervezési hiba} +\begin{itemize} + \item Minden logika egyetlen fájlban van. + \item Az API-hívás közvetlenül a komponensben történik típusos határ nélkül. + \item A validáció és üzleti szabályok keverednek. +\end{itemize} +\begin{itemize} + \item Megoldás: rétegek szétválasztása és tiszta típushatárok. +\end{itemize} +\end{frame} diff --git a/TypeScript_ppt/sections/11_debugging_and_error_reading.tex b/TypeScript_ppt/sections/11_debugging_and_error_reading.tex new file mode 100644 index 0000000..487c11c --- /dev/null +++ b/TypeScript_ppt/sections/11_debugging_and_error_reading.tex @@ -0,0 +1,42 @@ +\section{Hibakeresés és Fordítói Üzenetek} + +\begin{frame}[fragile]{Hogyan olvasd a TypeScript hibákat?} +\begin{itemize} + \item Először a hiba kódját nézd (pl. TS2322). + \item Utána nézd meg: "mit kaptam" és "mit vár a típus". + \item A hiba gyakran a hívási pontnál jelenik meg, de az ok lehet korábban. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Tipikus hiba: TS2322} +\begin{lstlisting}[style=JavaScript] +let count: number; +count = "10"; // TS2322 +\end{lstlisting} +\begin{itemize} + \item Jelentés: nem kompatibilis típus-hozzárendelés. + \item Javítás: konvertálj (Number("10")) vagy javítsd az adatforrást. +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Tipikus hiba: TS2532} +\begin{lstlisting}[style=JavaScript] +type User = { name?: string }; +const u: User = {}; + +console.log(u.name.toUpperCase()); // TS2532 +\end{lstlisting} +\begin{itemize} + \item Jelentés: az érték lehet undefined. + \item Javítás: ellenőrzés (if), optional chaining (u.name?.toUpperCase()). +\end{itemize} +\end{frame} + +\begin{frame}[fragile]{Gyakorlati hibakeresési rutin} +\begin{enumerate} + \item Szűkítsd a hibát a legkisebb reprodukálható példára. + \item Ellenőrizd a bemenet tényleges futásidejű értékét. + \item Egyeztesd a runtime adatot a deklarált típussal. + \item Írj tesztet, hogy a hiba ne térjen vissza. +\end{enumerate} +\end{frame} diff --git a/TypeScript_ppt/sections/12_practice_workshop.tex b/TypeScript_ppt/sections/12_practice_workshop.tex new file mode 100644 index 0000000..8f9eb6f --- /dev/null +++ b/TypeScript_ppt/sections/12_practice_workshop.tex @@ -0,0 +1,50 @@ +\section{Gyakorlóműhely} + +\begin{frame}[fragile]{Feladat 1: Típusos szűrés} +\begin{block}{Feladat} +Készíts függvényt, amely egy vegyes (string | number) tömbből csak a számokat adja vissza. +\end{block} +\begin{lstlisting}[style=JavaScript] +function onlyNumbers(values: Array): number[] { + return values.filter((v): v is number => typeof v === "number"); +} +\end{lstlisting} +\end{frame} + +\begin{frame}[fragile]{Feladat 2: Generic API válasz} +\begin{block}{Feladat} +Definiálj újrafelhasználható API-válasz típust data, ok és error mezőkkel. +\end{block} +\begin{lstlisting}[style=JavaScript] +type ApiResponse = { + data: T; + ok: boolean; + error?: string; +}; +\end{lstlisting} +\end{frame} + +\begin{frame}[fragile]{Feladat 3: Runtime validáció} +\begin{block}{Feladat} +Írj type guardot, amely ellenőrzi, hogy az adat Todo-e. +\end{block} +\begin{lstlisting}[style=JavaScript] +type Todo = { id: number; title: string; done: boolean }; + +function isTodo(v: unknown): v is Todo { + return ( + typeof v === "object" && v !== null && + "id" in v && "title" in v && "done" in v + ); +} +\end{lstlisting} +\end{frame} + +\begin{frame}[fragile]{Értékelési szempontok} +\begin{itemize} + \item Típusbiztonság: nincs felesleges any. + \item Olvashatóság: beszédes típus- és függvénynév. + \item Hibatűrés: külső adat validálása. + \item Bővíthetőség: új mező esetén is tiszta marad a kód. +\end{itemize} +\end{frame} diff --git a/TypeScript_ppt/typescript.pdf b/TypeScript_ppt/typescript.pdf new file mode 100644 index 0000000..489ef17 Binary files /dev/null and b/TypeScript_ppt/typescript.pdf differ diff --git a/TypeScript_ppt/typescript.tex b/TypeScript_ppt/typescript.tex new file mode 100644 index 0000000..ef996aa --- /dev/null +++ b/TypeScript_ppt/typescript.tex @@ -0,0 +1,19 @@ +\documentclass[usenames,dvipsnames,aspectratio=169]{beamer} +\usepackage{./common/webfejl} + +% Automatikus frame törés engedélyezése túl hosszú tartalomnál +\setbeamertemplate{frametitle continuation}[from second][\insertcontinuationcountroman] + +\title[Webtechnológia és webalkalmazás-fejlesztés - TypeScript]{Webtechnológia és webalkalmazás-fejlesztés - TypeScript} +\subtitle{TypeScript} + +\begin{document} + +\begin{frame}[plain] + \titlepage + \logoalul +\end{frame} + +\input{typescript_content.tex} + +\end{document} \ No newline at end of file diff --git a/TypeScript_ppt/typescript_content.tex b/TypeScript_ppt/typescript_content.tex new file mode 100644 index 0000000..35d2c3c --- /dev/null +++ b/TypeScript_ppt/typescript_content.tex @@ -0,0 +1,15 @@ +% TypeScript tananyag index fajl +% Ez a fajl csak osszefuzi a szekciokat kezdotol kozepes szintig. + +\input{sections/01_intro_and_setup.tex} +\input{sections/02_basic_types.tex} +\input{sections/03_functions_and_unions.tex} +\input{sections/04_alias_interface_objects.tex} +\input{sections/05_generics_and_utility_types.tex} +\input{sections/06_modules_async_and_api.tex} +\input{sections/07_validation_and_best_practices.tex} +\input{sections/08_learning_path_and_practice.tex} +\input{sections/09_advanced_types.tex} +\input{sections/10_oop_and_architecture.tex} +\input{sections/11_debugging_and_error_reading.tex} +\input{sections/12_practice_workshop.tex}