From 5e2d33231e71ced349e215bedc8847535588a4b8 Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Sat, 28 Feb 2026 11:00:00 +0100 Subject: [PATCH 01/27] add IDE cache folder to git ignore --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index 92f05024..29225669 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,3 @@ +.idea/ .DS_STORE .env \ No newline at end of file From 69cf063e24c366a14a6d6e9b3aafd86b2eead6df Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Sat, 28 Feb 2026 23:16:57 +0100 Subject: [PATCH 02/27] backend-mid-specialism skeleton --- api/.env-template | 3 + api/.gitignore | 7 +- api/README.md | 27 ++ api/package-lock.json | 259 +++++++++++++++++- api/package.json | 22 +- .../database.js} | 7 +- api/src/configs/swagger.js | 127 +++++++++ api/src/controllers/events.js | 65 +++++ api/src/db/migrate.js | 14 + .../20260228120000_create_event_table.js | 20 ++ api/src/db/seed.js | 14 + api/src/db/seeds/001_events.js | 76 +++++ api/src/index.mjs | 34 ++- api/src/middlewares/index.js | 3 + api/src/models/events.js | 178 ++++++++++++ api/src/routers/api.js | 10 + api/src/routers/events.js | 79 ++++++ api/src/routers/index.js | 8 + api/src/routers/nested.js | 10 - api/src/routers/undocumented.js | 7 + app/README.md | 15 +- 21 files changed, 938 insertions(+), 47 deletions(-) rename api/src/{database_client.js => configs/database.js} (65%) create mode 100644 api/src/configs/swagger.js create mode 100644 api/src/controllers/events.js create mode 100644 api/src/db/migrate.js create mode 100644 api/src/db/migrations/20260228120000_create_event_table.js create mode 100644 api/src/db/seed.js create mode 100644 api/src/db/seeds/001_events.js create mode 100644 api/src/middlewares/index.js create mode 100644 api/src/models/events.js create mode 100644 api/src/routers/api.js create mode 100644 api/src/routers/events.js create mode 100644 api/src/routers/index.js delete mode 100644 api/src/routers/nested.js create mode 100644 api/src/routers/undocumented.js diff --git a/api/.env-template b/api/.env-template index e81deae0..d70a7946 100644 --- a/api/.env-template +++ b/api/.env-template @@ -1,3 +1,6 @@ +# this is the name of the app to be shown in API documentation +APP_NAME=Backend-Mid-Specialism + # This is the port the API will be available at PORT=3001 diff --git a/api/.gitignore b/api/.gitignore index 1dcef2d9..a39a902f 100644 --- a/api/.gitignore +++ b/api/.gitignore @@ -1,2 +1,7 @@ node_modules -.env \ No newline at end of file +.env +# Ignore local SQLite database files +# If you intentionally want to version a database file, +# remove this rule and commit it explicitly. +src/db/*.sqlite +src/db/*.db \ No newline at end of file diff --git a/api/README.md b/api/README.md index dab5abf0..599ef2ac 100644 --- a/api/README.md +++ b/api/README.md @@ -33,6 +33,33 @@ Combined, these two techniques make it very easy to experiment with changes to y It also makes it possible to share temporary schema changes with others during Pull Request testing. +### Running migrations and seeds + +This project includes helper scripts for running Knex migrations and seeds: + +- `npm run db:migrate` – runs all pending migrations +- `npm run db:seed` – runs all seed files +- `npm run db:setup` – runs migrations and then seeds (fresh setup) + +The `db:setup` command is useful when: + +- You are starting the project for the first time +- You want to reset your local database +- You are running the demo version of the API + +### Important for trainees + +Knex migrations and seeds are an **advanced database management technique** often used in professional backend projects. + +For homework and learning purposes, you are expected to: + +- Design your own database schema +- Write your own SQL queries +- Understand how your tables are structured + +You should not rely blindly on the provided migrations if your assignment requires you to build your own schema. +If needed, modify or remove the existing migrations and seeds to match your database coursework. + ## Deploying > Last tested: 2025-07-08 diff --git a/api/package-lock.json b/api/package-lock.json index aa4e4a20..c6e3d581 100644 --- a/api/package-lock.json +++ b/api/package-lock.json @@ -10,12 +10,16 @@ "dependencies": { "body-parser": "^1.20.2", "cors": "^2.8.5", + "deepmerge": "^4.3.1", "dotenv": "^16.4.5", "express": "^4.19.2", + "express-list-endpoints": "^7.1.1", "knex": "^3.1.0", "mysql2": "^3.10.0", "pg": "^8.11.5", - "sqlite3": "^5.1.7" + "sqlite3": "^5.1.7", + "swagger-jsdoc": "^6.2.8", + "swagger-ui-express": "^5.0.0" }, "devDependencies": { "@eslint/js": "^9.0.0", @@ -38,6 +42,46 @@ "node": ">=0.10.0" } }, + "node_modules/@apidevtools/json-schema-ref-parser": { + "version": "9.1.2", + "resolved": "https://registry.npmjs.org/@apidevtools/json-schema-ref-parser/-/json-schema-ref-parser-9.1.2.tgz", + "integrity": "sha512-r1w81DpR+KyRWd3f+rk6TNqMgedmAxZP5v5KWlXQWlgMUUtyEJch0DKEci1SorPMiSeM8XPl7MZ3miJ60JIpQg==", + "dependencies": { + "@jsdevtools/ono": "^7.1.3", + "@types/json-schema": "^7.0.6", + "call-me-maybe": "^1.0.1", + "js-yaml": "^4.1.0" + } + }, + "node_modules/@apidevtools/openapi-schemas": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/@apidevtools/openapi-schemas/-/openapi-schemas-2.1.0.tgz", + "integrity": "sha512-Zc1AlqrJlX3SlpupFGpiLi2EbteyP7fXmUOGup6/DnkRgjP9bgMM/ag+n91rsv0U1Gpz0H3VILA/o3bW7Ua6BQ==", + "engines": { + "node": ">=10" + } + }, + "node_modules/@apidevtools/swagger-methods": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@apidevtools/swagger-methods/-/swagger-methods-3.0.2.tgz", + "integrity": "sha512-QAkD5kK2b1WfjDS/UQn/qQkbwF31uqRjPTrsCs5ZG9BQGAkjwvqGFjjPqAuzac/IYzpPtRzjCP1WrTuAIjMrXg==" + }, + "node_modules/@apidevtools/swagger-parser": { + "version": "10.0.3", + "resolved": "https://registry.npmjs.org/@apidevtools/swagger-parser/-/swagger-parser-10.0.3.tgz", + "integrity": "sha512-sNiLY51vZOmSPFZA5TF35KZ2HbgYklQnTSDnkghamzLb3EkNtcQnrBQEj5AOCxHpTtXpqMCRM1CrmV2rG6nw4g==", + "dependencies": { + "@apidevtools/json-schema-ref-parser": "^9.0.6", + "@apidevtools/openapi-schemas": "^2.0.4", + "@apidevtools/swagger-methods": "^3.0.2", + "@jsdevtools/ono": "^7.1.3", + "call-me-maybe": "^1.0.1", + "z-schema": "^5.0.1" + }, + "peerDependencies": { + "openapi-types": ">=7" + } + }, "node_modules/@eslint-community/eslint-utils": { "version": "4.4.0", "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.4.0.tgz", @@ -203,6 +247,11 @@ "integrity": "sha512-93zYdMES/c1D69yZiKDBj0V24vqNzB/koF26KPaagAfd3P/4gUlh3Dys5ogAK+Exi9QyzlD8x/08Zt7wIKcDcA==", "dev": true }, + "node_modules/@jsdevtools/ono": { + "version": "7.1.3", + "resolved": "https://registry.npmjs.org/@jsdevtools/ono/-/ono-7.1.3.tgz", + "integrity": "sha512-4JQNk+3mVzK3xh2rqd6RB4J46qUR19azEHBneZyTZM+c456qOrbbM/5xcR8huNCCcbVt7+UmizG6GuUvPvKUYg==" + }, "node_modules/@nodelib/fs.scandir": { "version": "2.1.5", "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", @@ -262,6 +311,12 @@ "node": ">=10" } }, + "node_modules/@scarf/scarf": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@scarf/scarf/-/scarf-1.4.0.tgz", + "integrity": "sha512-xxeapPiUXdZAE3che6f3xogoJPeZgig6omHEy1rIY5WVsB3H2BHNnZH+gHG6x91SCWyQCzWGsuL2Hh3ClO5/qQ==", + "hasInstallScript": true + }, "node_modules/@tootallnate/once": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/@tootallnate/once/-/once-1.1.2.tgz", @@ -271,6 +326,11 @@ "node": ">= 6" } }, + "node_modules/@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==" + }, "node_modules/abbrev": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.1.1.tgz", @@ -446,8 +506,7 @@ "node_modules/argparse": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", - "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", - "dev": true + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==" }, "node_modules/array-flatten": { "version": "1.1.1", @@ -457,8 +516,7 @@ "node_modules/balanced-match": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", - "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", - "devOptional": true + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==" }, "node_modules/base64-js": { "version": "1.5.1", @@ -536,7 +594,6 @@ "version": "1.1.11", "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==", - "devOptional": true, "dependencies": { "balanced-match": "^1.0.0", "concat-map": "0.0.1" @@ -644,6 +701,11 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/call-me-maybe": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.2.tgz", + "integrity": "sha512-HpX65o1Hnr9HH25ojC1YGs7HCQLq0GCOibSaWER0eNpgJ/Z1MZv2mTc7+xh6WOPxbRVcmgbv4hGU+uSQ/2xFZQ==" + }, "node_modules/callsites": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", @@ -765,8 +827,7 @@ "node_modules/concat-map": { "version": "0.0.1", "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", - "devOptional": true + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==" }, "node_modules/console-control-strings": { "version": "1.1.0", @@ -868,6 +929,14 @@ "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", "dev": true }, + "node_modules/deepmerge": { + "version": "4.3.1", + "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz", + "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/define-data-property": { "version": "1.1.4", "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz", @@ -923,6 +992,17 @@ "node": ">=8" } }, + "node_modules/doctrine": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-3.0.0.tgz", + "integrity": "sha512-yS+Q5i3hBf7GBkd4KG8a7eBNNWNGLTaEwwYWUijIYM7zrlYDM0BFXHjjPWlWZ1Rg7UaddZeIDmi9jF3HmqiQ2w==", + "dependencies": { + "esutils": "^2.0.2" + }, + "engines": { + "node": ">=6.0.0" + } + }, "node_modules/dotenv": { "version": "16.4.5", "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.4.5.tgz", @@ -1205,7 +1285,6 @@ "version": "2.0.3", "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", - "dev": true, "engines": { "node": ">=0.10.0" } @@ -1267,6 +1346,14 @@ "node": ">= 0.10.0" } }, + "node_modules/express-list-endpoints": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/express-list-endpoints/-/express-list-endpoints-7.1.1.tgz", + "integrity": "sha512-SA6YHH1r6DrioJ4fFJNqiwu1FweGFqJZO9KBApMzwPosoSGPOX2AW0wiMepOXjojjEXDuP9whIvckomheErbJA==", + "engines": { + "node": ">=18" + } + }, "node_modules/fast-deep-equal": { "version": "3.1.3", "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", @@ -1410,8 +1497,7 @@ "node_modules/fs.realpath": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", - "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", - "optional": true + "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==" }, "node_modules/fsevents": { "version": "2.3.3", @@ -1819,7 +1905,6 @@ "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.", - "optional": true, "dependencies": { "once": "^1.3.0", "wrappy": "1" @@ -1956,7 +2041,6 @@ "version": "4.1.0", "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", - "dev": true, "dependencies": { "argparse": "^2.0.1" }, @@ -2109,12 +2193,29 @@ "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==" }, + "node_modules/lodash.get": { + "version": "4.4.2", + "resolved": "https://registry.npmjs.org/lodash.get/-/lodash.get-4.4.2.tgz", + "integrity": "sha512-z+Uw/vLuy6gQe8cfaFWD7p0wVv8fJl3mbzXh33RS+0oW2wvUqiRXiQ69gLWSLpgB5/6sU+r6BlQR0MBILadqTQ==", + "deprecated": "This package is deprecated. Use the optional chaining (?.) operator instead." + }, + "node_modules/lodash.isequal": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/lodash.isequal/-/lodash.isequal-4.5.0.tgz", + "integrity": "sha512-pDo3lu8Jhfjqls6GkMgpahsF9kCyayhgykjyLMNFTKWrpVdAQtYyB4muAMWozBB4ig/dtWAmsMxLEI8wuz+DYQ==", + "deprecated": "This package is deprecated. Use require('node:util').isDeepStrictEqual instead." + }, "node_modules/lodash.merge": { "version": "4.6.2", "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", "dev": true }, + "node_modules/lodash.mergewith": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.mergewith/-/lodash.mergewith-4.6.2.tgz", + "integrity": "sha512-GK3g5RPZWTRSeLSpgP8Xhra+pnjBC56q9FZYe1d5RN3TJ35dbkGy3YqBSMbyCrlbi+CM9Z3Jk5yTL7RCsqboyQ==" + }, "node_modules/long": { "version": "5.2.3", "resolved": "https://registry.npmjs.org/long/-/long-5.2.3.tgz", @@ -2233,7 +2334,6 @@ "version": "3.1.2", "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", - "devOptional": true, "dependencies": { "brace-expansion": "^1.1.7" }, @@ -2627,6 +2727,12 @@ "wrappy": "1" } }, + "node_modules/openapi-types": { + "version": "12.1.3", + "resolved": "https://registry.npmjs.org/openapi-types/-/openapi-types-12.1.3.tgz", + "integrity": "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==", + "peer": true + }, "node_modules/optionator": { "version": "0.9.3", "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.3.tgz", @@ -2722,7 +2828,6 @@ "version": "1.0.1", "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", - "optional": true, "engines": { "node": ">=0.10.0" } @@ -3597,6 +3702,86 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/swagger-jsdoc": { + "version": "6.2.8", + "resolved": "https://registry.npmjs.org/swagger-jsdoc/-/swagger-jsdoc-6.2.8.tgz", + "integrity": "sha512-VPvil1+JRpmJ55CgAtn8DIcpBs0bL5L3q5bVQvF4tAW/k/9JYSj7dCpaYCAv5rufe0vcCbBRQXGvzpkWjvLklQ==", + "dependencies": { + "commander": "6.2.0", + "doctrine": "3.0.0", + "glob": "7.1.6", + "lodash.mergewith": "^4.6.2", + "swagger-parser": "^10.0.3", + "yaml": "2.0.0-1" + }, + "bin": { + "swagger-jsdoc": "bin/swagger-jsdoc.js" + }, + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/swagger-jsdoc/node_modules/commander": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-6.2.0.tgz", + "integrity": "sha512-zP4jEKbe8SHzKJYQmq8Y9gYjtO/POJLgIdKgV7B9qNmABVFVc+ctqSX6iXh4mCpJfRBOabiZ2YKPg8ciDw6C+Q==", + "engines": { + "node": ">= 6" + } + }, + "node_modules/swagger-jsdoc/node_modules/glob": { + "version": "7.1.6", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.6.tgz", + "integrity": "sha512-LwaxwyZ72Lk7vZINtNNrywX0ZuLyStrdDtabefZKAY5ZGJhVtgdznluResxNmPitE0SAO+O26sWTHeKSI2wMBA==", + "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me", + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.0.4", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/swagger-parser": { + "version": "10.0.3", + "resolved": "https://registry.npmjs.org/swagger-parser/-/swagger-parser-10.0.3.tgz", + "integrity": "sha512-nF7oMeL4KypldrQhac8RyHerJeGPD1p2xDh900GPvc+Nk7nWP6jX2FcC7WmkinMoAmoO774+AFXcWsW8gMWEIg==", + "dependencies": { + "@apidevtools/swagger-parser": "10.0.3" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/swagger-ui-dist": { + "version": "5.32.0", + "resolved": "https://registry.npmjs.org/swagger-ui-dist/-/swagger-ui-dist-5.32.0.tgz", + "integrity": "sha512-nKZB0OuDvacB0s/lC2gbge+RigYvGRGpLLMWMFxaTUwfM+CfndVk9Th2IaTinqXiz6Mn26GK2zriCpv6/+5m3Q==", + "dependencies": { + "@scarf/scarf": "=1.4.0" + } + }, + "node_modules/swagger-ui-express": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/swagger-ui-express/-/swagger-ui-express-5.0.1.tgz", + "integrity": "sha512-SrNU3RiBGTLLmFU8GIJdOdanJTl4TOmT27tt3bWWHppqYmAZ6IDuEuBvMU6nZq0zLEe6b/1rACXCgLZqO6ZfrA==", + "dependencies": { + "swagger-ui-dist": ">=5.0.0" + }, + "engines": { + "node": ">= v0.10.32" + }, + "peerDependencies": { + "express": ">=4.0.0 || >=5.0.0-beta" + } + }, "node_modules/tar": { "version": "6.2.1", "resolved": "https://registry.npmjs.org/tar/-/tar-6.2.1.tgz", @@ -3795,6 +3980,14 @@ "node": ">= 0.4.0" } }, + "node_modules/validator": { + "version": "13.15.26", + "resolved": "https://registry.npmjs.org/validator/-/validator-13.15.26.tgz", + "integrity": "sha512-spH26xU080ydGggxRyR1Yhcbgx+j3y5jbNXk/8L+iRvdIEQ4uTRH2Sgf2dokud6Q4oAtsbNvJ1Ft+9xmm6IZcA==", + "engines": { + "node": ">= 0.10" + } + }, "node_modules/vary": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz", @@ -3845,6 +4038,14 @@ "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==" }, + "node_modules/yaml": { + "version": "2.0.0-1", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.0.0-1.tgz", + "integrity": "sha512-W7h5dEhywMKenDJh2iX/LABkbFnBxasD27oyXWDS/feDsxiw0dD5ncXdYXgkvAsXIY2MpW/ZKkr9IU30DBdMNQ==", + "engines": { + "node": ">= 6" + } + }, "node_modules/yocto-queue": { "version": "0.1.0", "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", @@ -3856,6 +4057,34 @@ "funding": { "url": "https://github.com/sponsors/sindresorhus" } + }, + "node_modules/z-schema": { + "version": "5.0.5", + "resolved": "https://registry.npmjs.org/z-schema/-/z-schema-5.0.5.tgz", + "integrity": "sha512-D7eujBWkLa3p2sIpJA0d1pr7es+a7m0vFAnZLlCEKq/Ij2k0MLi9Br2UPxoxdYystm5K1yeBGzub0FlYUEWj2Q==", + "dependencies": { + "lodash.get": "^4.4.2", + "lodash.isequal": "^4.5.0", + "validator": "^13.7.0" + }, + "bin": { + "z-schema": "bin/z-schema" + }, + "engines": { + "node": ">=8.0.0" + }, + "optionalDependencies": { + "commander": "^9.4.1" + } + }, + "node_modules/z-schema/node_modules/commander": { + "version": "9.5.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-9.5.0.tgz", + "integrity": "sha512-KRs7WVDKg86PWiuAqhDrAQnTXZKraVcCc6vFdL14qrZ/DcWwuRo7VoiYXalXO7S5GKpqYiVEwCbgFDfxNHKJBQ==", + "optional": true, + "engines": { + "node": "^12.20.0 || >=14" + } } } } diff --git a/api/package.json b/api/package.json index ff9cc342..a0054a76 100644 --- a/api/package.json +++ b/api/package.json @@ -12,17 +12,24 @@ "dev": "nodemon src/index.mjs", "start": "node src/index.mjs", "format": "npx prettier . --write", - "check": "npx eslint . --fix" + "check": "npx eslint . --fix", + "db:migrate": "node src/db/migrate.js", + "db:seed": "node src/db/seed.js", + "db:setup": "npm run db:migrate && npm run db:seed" }, "dependencies": { - "body-parser": "^1.20.2", + "body-parser": "^1.22.2", "cors": "^2.8.5", + "deepmerge": "^4.3.1", "dotenv": "^16.4.5", "express": "^4.19.2", + "express-list-endpoints": "^7.1.1", "knex": "^3.1.0", "mysql2": "^3.10.0", "pg": "^8.11.5", - "sqlite3": "^5.1.7" + "sqlite3": "^5.1.7", + "swagger-jsdoc": "^6.2.8", + "swagger-ui-express": "^5.0.0" }, "devDependencies": { "@eslint/js": "^9.0.0", @@ -30,5 +37,14 @@ "globals": "^15.0.0", "nodemon": "^3.1.0", "prettier": "^3.2.5" + }, + "imports": { + "#configs/*": "./src/configs/*", + "#controllers/*": "./src/controllers/*", + "#middlewares": "./src/middlewares/index.js", + "#middlewares/*": "./src/middlewares/*", + "#models/*": "./src/models/*", + "#routers": "./src/routers/index.js", + "#routers/*": "./src/routers/*" } } diff --git a/api/src/database_client.js b/api/src/configs/database.js similarity index 65% rename from api/src/database_client.js rename to api/src/configs/database.js index a311c1b5..29f03d1c 100644 --- a/api/src/database_client.js +++ b/api/src/configs/database.js @@ -1,14 +1,17 @@ import knex from "knex"; +const client = process.env.DB_CLIENT ?? "sqlite3"; +const default_db_filename = client === "sqlite3" ? "src/db/database.sqlite" : null; + const connection = knex({ - client: process.env.DB_CLIENT, + client: client, connection: { host: process.env.DB_HOST, port: process.env.DB_PORT, user: process.env.DB_USER, password: process.env.DB_PASSWORD, database: process.env.DB_DATABASE_NAME, - filename: process.env.DB_SQLITE_FILENAME, // For SQLite + filename: process.env.DB_SQLITE_FILENAME ?? default_db_filename, // For SQLite ssl: process.env.DB_USE_SSL === "true" ? { rejectUnauthorized: false } : false, }, diff --git a/api/src/configs/swagger.js b/api/src/configs/swagger.js new file mode 100644 index 00000000..1f9c6580 --- /dev/null +++ b/api/src/configs/swagger.js @@ -0,0 +1,127 @@ +/** + * Swagger configuration module. + * + * Hybrid approach: + * - Automatically discovers all Express controllers at runtime. + * - Merges them with manually documented @swagger JSDoc blocks. + * - Undocumented controllers still appear with a default stub. + * - Documented controllers override the stub with full OpenAPI definitions. + */ + +import swaggerUi from "swagger-ui-express"; +import swaggerJsdoc from "swagger-jsdoc"; +import listEndpoints from "express-list-endpoints"; +import deepmerge from "deepmerge"; + +/** + * Base Swagger (OpenAPI 3) configuration. + * This defines general API metadata and tells swagger-jsdoc + * where to scan for @swagger annotations. + */ +const swaggerOptions = { + definition: { + openapi: "3.0.0", + info: { + title: process.env.APP_NAME ?? "Backend-Mid-Specialism", + version: process.env.APP_VERSION ?? "0.0.1", + description: "API documentation", + }, + }, + + /** + * Files that contain @swagger JSDoc blocks. + * Adjust paths if router structure changes. + */ + apis: ["./src/routers/**/*.js", "./src/routers/*.js"], +}; + +/** + * Default OpenAPI operation stub. + * + * Used when an endpoint has NO @swagger documentation. + * Ensures that every route still appears in Swagger UI. + */ +const openApiEndpointSpecStub = { + tags: ["Undocumented"], + responses: { + 200: { description: "OK" }, + }, +}; + +/** + * swagger-jsdoc generated specification + * based only on @swagger JSDoc blocks. + */ +const swaggerSpec = swaggerJsdoc(swaggerOptions); + +/** + * Swagger UI static middleware. + */ +const swaggerServe = swaggerUi.serve; + +/** + * Generates OpenAPI "paths" object automatically + * by inspecting the Express app router stack. + * + * @param {import("express").Application} app - Express application instance + * @returns {object} OpenAPI-compatible paths object + * + * Example output: + * { + * "/api/users": { + * get: { ... }, + * post: { ... } + * } + * } + */ +const generateOpenApiSpecs = (app) => { + const specs = {}; + + for (const ep of listEndpoints(app)) { + // Ensure path object exists + specs[ep.path] ??= {}; + + for (const method of ep.methods) { + const m = method.toLowerCase(); + + // Only add stub if not already defined + specs[ep.path][m] ??= { + ...openApiEndpointSpecStub, + summary: `Undocumented: ${method} ${ep.path}`, + }; + } + } + + return specs; +}; + +/** + * Initializes Swagger UI with merged specification. + * + * Steps: + * 1. Auto-generate path specs from Express routes + * 2. Merge with swagger-jsdoc output + * (Manual @swagger docs override auto stubs) + * 3. Mount Swagger UI at /docs + * + * @param {import("express").Application} app - Express application instance + */ +const swaggerSetup = (app) => { + const autoGeneratedSpecs = generateOpenApiSpecs(app); + + // Start from the jsdoc spec (source of truth) + const mergedSpec = { ...swaggerSpec }; + mergedSpec.paths ??= {}; + + // Only add stubs where docs are missing + for (const [path, ops] of Object.entries(autoGeneratedSpecs)) { + mergedSpec.paths[path] ??= {}; + for (const [method, opSpec] of Object.entries(ops)) { + mergedSpec.paths[path][method] ??= opSpec; // keep documented op if it exists + } + } + + app.use("/docs", swaggerServe, swaggerUi.setup(mergedSpec)); +}; + +export default swaggerSetup; \ No newline at end of file diff --git a/api/src/controllers/events.js b/api/src/controllers/events.js new file mode 100644 index 00000000..26926224 --- /dev/null +++ b/api/src/controllers/events.js @@ -0,0 +1,65 @@ +import { listEvents, countEvents } from "#models/events.js"; + +/** + * GET /api/events + * + * Query Parameters: + * - page (number, optional, default = 0) + * + * Pagination Strategy: + * - Fixed page size (PAGE_SIZE) + * - offset = page * PAGE_SIZE + * - totalItems calculated via countEvents() + * - totalPages = ceil(totalItems / PAGE_SIZE) + * + * Response Shape: + * { + * data: Array, + * meta: { + * page: number, + * pageSize: number, + * totalItems: number, + * totalPages: number + * } + * } + * + * Notes: + * - Filtering can be added later by mapping req.query → filters object. + * - Sorting validation should be handled before passing orderBy. + */ +export async function getEvents(req, res, next) { + try { + const PAGE_SIZE = 5; + + // Parse page safely (ensure non-negative integer) + const page = Math.max(Number(req.query.page ?? 0), 0); + const offset = page * PAGE_SIZE; + + const filters = {}; // future: map req.query filters here + + // Run queries in parallel for better performance + const [data, totalItems] = await Promise.all([ + listEvents(filters, { + limit: PAGE_SIZE, + offset, + orderBy: "id", + order: "asc", + }), + countEvents(filters), + ]); + + const totalPages = Math.ceil(totalItems / PAGE_SIZE); + + res.json({ + data, + meta: { + page, + pageSize: PAGE_SIZE, + totalItems, + totalPages, + }, + }); + } catch (error) { + next(error); // Delegate to Express error middleware + } +} \ No newline at end of file diff --git a/api/src/db/migrate.js b/api/src/db/migrate.js new file mode 100644 index 00000000..7c04d62f --- /dev/null +++ b/api/src/db/migrate.js @@ -0,0 +1,14 @@ +import knex from "#configs/database.js"; + +(async () => { + try { + const [batch, files] = await knex.migrate.latest({ directory: "src/db/migrations" }); + console.log(`[db] ✅ migrated (batch ${batch}):`, files); + await knex.destroy(); + process.exit(0); + } catch (err) { + console.error("[db] ❌ migrate failed:", err); + try { await knex.destroy(); } catch {} + process.exit(1); + } +})(); \ No newline at end of file diff --git a/api/src/db/migrations/20260228120000_create_event_table.js b/api/src/db/migrations/20260228120000_create_event_table.js new file mode 100644 index 00000000..282d553c --- /dev/null +++ b/api/src/db/migrations/20260228120000_create_event_table.js @@ -0,0 +1,20 @@ +/** + * @param {import("knex").Knex} knex + */ +export async function up(knex) { + await knex.schema.createTable("event", (t) => { + t.integer("id").primary(); + t.decimal("price", 10, 2).notNullable(); + t.string("currency", 3).notNullable(); + t.string("title").notNullable(); + t.text("description"); + t.timestamps(true, true); + }); +} + +/** + * @param {import("knex").Knex} knex + */ +export async function down(knex) { + await knex.schema.dropTableIfExists("event"); +} \ No newline at end of file diff --git a/api/src/db/seed.js b/api/src/db/seed.js new file mode 100644 index 00000000..d15f694d --- /dev/null +++ b/api/src/db/seed.js @@ -0,0 +1,14 @@ +import knex from "#configs/database.js"; + +(async () => { + try { + const res = await knex.seed.run({ directory: "src/db/seeds" }); + console.log("[db] ✅ seeded:", res); + await knex.destroy(); + process.exit(0); + } catch (err) { + console.error("[db] ❌ seed failed:", err); + try { await knex.destroy(); } catch {} + process.exit(1); + } +})(); \ No newline at end of file diff --git a/api/src/db/seeds/001_events.js b/api/src/db/seeds/001_events.js new file mode 100644 index 00000000..040df3ab --- /dev/null +++ b/api/src/db/seeds/001_events.js @@ -0,0 +1,76 @@ +/** + * @param {import("knex").Knex} knex + */ +export async function seed(knex) { + await knex("event").del(); + + await knex("event") + .insert([ + { + id: 1, + price: 100, + currency: "DKK", + title: "Copenhagen Coffee Crawl", + description: + "A relaxed Saturday walk between 4 specialty cafés. Includes tasting notes, small pastry, and a guide to brewing styles.", + }, + { + id: 2, + price: 150, + currency: "DKK", + title: "After-Work Board Games Night", + description: + "Drop in with friends or come solo. We’ll teach quick games, set you up at a table, and keep the vibe cozy and social.", + }, + { + id: 3, + price: 250, + currency: "DKK", + title: "Beginner Pasta Workshop", + description: + "Hands-on workshop: mix dough, roll sheets, shape pasta, and finish with a simple sauce. You’ll leave with a small take-home pack.", + }, + { + id: 4, + price: 0, + currency: "DKK", + title: "Sunday Park Run & Stretch", + description: + "Easy-paced community run (5K-ish) followed by guided stretching. All levels welcome—walkers included.", + }, + { + id: 5, + price: 75, + currency: "DKK", + title: "Indie Film Screening: Short Nights", + description: + "A curated set of local short films with a short Q&A after. Seats are limited—arrive early for the best spots.", + }, + { + id: 6, + price: 180, + currency: "DKK", + title: "Photography Walk: City Lights", + description: + "Evening photo walk focused on street scenes and reflections. Bring any camera—even a phone—and we’ll share tips on composition and exposure.", + }, + { + id: 7, + price: 120, + currency: "DKK", + title: "Bread & Butter Tasting", + description: + "Taste 6 breads and 5 butters (classic + flavored). Learn what makes a good crumb, crust, and fermentation—and why butter matters.", + }, + { + id: 8, + price: 300, + currency: "DKK", + title: "Live Jazz Trio at the Loft", + description: + "An intimate set with modern standards and originals. Ticket includes a welcome drink; doors open 19:00.", + }, + ]) + .onConflict("id") + .merge(); +} \ No newline at end of file diff --git a/api/src/index.mjs b/api/src/index.mjs index 6d32183c..cad45401 100644 --- a/api/src/index.mjs +++ b/api/src/index.mjs @@ -2,27 +2,31 @@ import "dotenv/config"; import express from "express"; import cors from "cors"; import bodyParser from "body-parser"; -import knex from "./database_client.js"; -import nestedRouter from "./routers/nested.js"; +import rootRouter from "#routers"; +import swaggerSetup from "#configs/swagger.js"; +import middlewares from "#middlewares"; const app = express(); + app.use(cors()); app.use(bodyParser.json()); -const apiRouter = express.Router(); +for (const middleware of middlewares) { + app.use(middleware); +} -// This is an example of how to set up a route. Replace it with your own. -apiRouter.get("/", async (req, res) => { - // Here is an example of making a query to the database you set up: - const query = "SELECT 'Hello, world!' AS message;"; - const result = await knex.raw(query); - res.json(result); -}); -// Here is an example of optionally setting up nested routes. Replace it or delete as needed. -apiRouter.use("/nested", nestedRouter); +app.use("/", rootRouter); + +// must be last call before listen to ensure all endpoints was detected, regardless they are documented or not +swaggerSetup(app) + +const port = process.env.PORT ?? 3000; -app.use("/api", apiRouter); -app.listen(process.env.PORT, () => { - console.log(`API listening on port ${process.env.PORT}`); +app.listen(port, () => { + console.info(`${process.env.APP_NAME || "Backend-Mid-Specialism"} app started on port ${port }`); }); + + + + diff --git a/api/src/middlewares/index.js b/api/src/middlewares/index.js new file mode 100644 index 00000000..95db95ca --- /dev/null +++ b/api/src/middlewares/index.js @@ -0,0 +1,3 @@ +const middlewares = [] + +export default middlewares \ No newline at end of file diff --git a/api/src/models/events.js b/api/src/models/events.js new file mode 100644 index 00000000..99b1dc89 --- /dev/null +++ b/api/src/models/events.js @@ -0,0 +1,178 @@ +import db from "#configs/database.js"; + +const TABLE = "event"; + +/** + * Returns a base query builder for the event table. + * + * @param {import("knex").Knex} [trx=db] - Optional transaction + * @returns {import("knex").Knex.QueryBuilder} + */ +function baseQuery(trx = db) { + return trx(TABLE); +} + +/** + * Applies common event filters to a query builder. + * + * This helper ensures filtering logic is defined in one place + * and reused by both list and count queries. + * + * @param {import("knex").Knex.QueryBuilder} qb + * @param {Object} filters + * @param {string} [filters.currency] + * @param {number} [filters.minPrice] + * @param {number} [filters.maxPrice] + * @param {string} [filters.search] + * + * @returns {import("knex").Knex.QueryBuilder} + */ +function applyEventFilters(qb, filters = {}) { + if (filters.currency) { + qb.where("currency", filters.currency); + } + + if (filters.minPrice != null) { + qb.where("price", ">=", filters.minPrice); + } + + if (filters.maxPrice != null) { + qb.where("price", "<=", filters.maxPrice); + } + + // Portable case-insensitive search (pg/mysql/sqlite) + if (filters.search) { + const q = `%${String(filters.search).toLowerCase()}%`; + + qb.where((builder) => { + builder + .whereRaw("LOWER(title) LIKE ?", [q]) + .orWhereRaw("LOWER(description) LIKE ?", [q]); + }); + } + + return qb; +} + +/** + * Count events matching optional filters. + * + * Used for pagination metadata (totalItems / totalPages). + * + * @param {Object} [filters={}] + * @param {Object} [options={}] + * @param {import("knex").Knex} [options.trx] - Optional transaction + * + * @returns {Promise} Total matching rows + */ +export async function countEvents(filters = {}, options = {}) { + const { trx } = options; + + const qb = applyEventFilters(baseQuery(trx), filters); + + const row = await qb.count({ count: "*" }).first(); + + // PostgreSQL returns string counts, normalize across dialects + const count = row?.count ?? row?.["count(*)"] ?? 0; + + return Number(count); +} + +/** + * List events with optional filters and offset-based pagination. + * + * NOTE: + * - Supports limit + offset only. + * - Page calculation should be handled at API/controller level. + * + * @param {Object} [filters={}] + * @param {string} [filters.currency] + * @param {number} [filters.minPrice] + * @param {number} [filters.maxPrice] + * @param {string} [filters.search] + * + * @param {Object} [options={}] + * @param {number} [options.limit] + * @param {number} [options.offset] + * @param {string} [options.orderBy="id"] + * @param {"asc"|"desc"} [options.order="asc"] + * @param {import("knex").Knex} [options.trx] + * + * @returns {Promise>} + */ +export async function listEvents(filters = {}, options = {}) { + const { + limit, + offset, + orderBy = "id", + order = "asc", + trx, + } = options; + + const qb = applyEventFilters( + baseQuery(trx).select("*"), + filters + ); + + qb.orderBy( + orderBy, + String(order).toLowerCase() === "desc" ? "desc" : "asc" + ); + + if (limit != null) qb.limit(limit); + if (offset != null) qb.offset(offset); + + return qb; +} + +/** + * Find a single event by id. + * + * @param {number|string} id + * @param {Object} [options={}] + * @param {import("knex").Knex} [options.trx] + * + * @returns {Promise} + */ +export async function findEventById(id, { trx } = {}) { + const row = await baseQuery(trx) + .where({ id }) + .first(); + + return row ?? null; +} + +/** + * Create a new event. + * + * TODO: + * - Validate input + * - Insert row + * - Return created row (dialect-safe) + */ +export async function createEvent() { + throw new Error("TODO: createEvent is not implemented yet"); +} + +/** + * Update an existing event by id. + * + * TODO: + * - Validate patch fields + * - Perform update + * - Return updated row (or null if not found) + */ +export async function updateEvent() { + throw new Error("TODO: updateEvent is not implemented yet"); +} + +/** + * Delete an event by id. + * + * TODO: + * - Delete row + * - Return true/false depending on whether a row was deleted + */ +export async function deleteEvent() { + throw new Error("TODO: deleteEvent is not implemented yet"); +} \ No newline at end of file diff --git a/api/src/routers/api.js b/api/src/routers/api.js new file mode 100644 index 00000000..37c694c4 --- /dev/null +++ b/api/src/routers/api.js @@ -0,0 +1,10 @@ +import express from "express"; +import eventsRouter from "#routers/events.js"; +import unDocumentedDemo from "#routers/undocumented.js"; + +const apiRouter = express.Router(); + +apiRouter.use("/events", eventsRouter); +apiRouter.use("/undocumented", unDocumentedDemo); + +export default apiRouter; \ No newline at end of file diff --git a/api/src/routers/events.js b/api/src/routers/events.js new file mode 100644 index 00000000..c3bb02b8 --- /dev/null +++ b/api/src/routers/events.js @@ -0,0 +1,79 @@ +import express from "express"; +import { getEvents } from "#controllers/events.js"; + +const eventsRouter = express.Router(); + +/** + * @swagger + * /api/events: + * get: + * summary: Get paginated list of events + * description: Returns a paginated list of events. Pagination is zero-based. + * tags: + * - Events + * parameters: + * - in: query + * name: page + * schema: + * type: integer + * minimum: 0 + * default: 0 + * required: false + * description: Page number (zero-based) + * responses: + * 200: + * description: Paginated list of events + * content: + * application/json: + * schema: + * type: object + * properties: + * data: + * type: array + * items: + * type: object + * properties: + * id: + * type: integer + * example: 1 + * price: + * type: number + * example: 150 + * currency: + * type: string + * example: DKK + * title: + * type: string + * example: Live Jazz Trio + * description: + * type: string + * example: An intimate jazz evening. + * created_at: + * type: string + * format: date-time + * updated_at: + * type: string + * format: date-time + * meta: + * type: object + * properties: + * page: + * type: integer + * example: 0 + * pageSize: + * type: integer + * example: 5 + * totalItems: + * type: integer + * example: 245 + * totalPages: + * type: integer + * example: 49 + * 400: + * description: Invalid query parameters + * 500: + * description: Server error + */ +eventsRouter.get("/", getEvents); + +export default eventsRouter; \ No newline at end of file diff --git a/api/src/routers/index.js b/api/src/routers/index.js new file mode 100644 index 00000000..08ee53ac --- /dev/null +++ b/api/src/routers/index.js @@ -0,0 +1,8 @@ +import express from "express"; +import apiRouter from "#routers/api.js"; + +const rootRouter = express.Router(); + +rootRouter.use("/api", apiRouter); + +export default rootRouter; \ No newline at end of file diff --git a/api/src/routers/nested.js b/api/src/routers/nested.js deleted file mode 100644 index b2781737..00000000 --- a/api/src/routers/nested.js +++ /dev/null @@ -1,10 +0,0 @@ -import express from "express"; - -// This router can be deleted once you add your own router -const nestedRouter = express.Router(); - -nestedRouter.get("/", (req, res) => { - res.json({ message: "Hello nested router" }); -}); - -export default nestedRouter; diff --git a/api/src/routers/undocumented.js b/api/src/routers/undocumented.js new file mode 100644 index 00000000..8e7be861 --- /dev/null +++ b/api/src/routers/undocumented.js @@ -0,0 +1,7 @@ +import express from "express"; + +const unDocumentedDemo = express.Router(); + +unDocumentedDemo.get("/", (_req, res) => res.json({message: "Hello I'm undocumented endpoint!"})) + +export default unDocumentedDemo; \ No newline at end of file diff --git a/app/README.md b/app/README.md index 46995750..00780827 100644 --- a/app/README.md +++ b/app/README.md @@ -1 +1,14 @@ -This is where your web app code will live. Start from scratch, or copy a template from `templates/app` to get up and running quickly. Read the [main readme](../README.md) for more help. \ No newline at end of file +# Frontend (Not Required) + +This project is a **backend skeleton project**. + +A frontend application is **not required** for this repository. + +The `app/` folder exists only to respect the standard Hack Your Future project structure, where repositories are typically organized into: + +- `api/` – Backend code +- `app/` – Frontend code + +Even though this project does not require a frontend, the folder is included to remain consistent with the HYF fullstack project structure. + +You can safely ignore this folder unless you decide to build a frontend later. \ No newline at end of file From 4ee74d21e0666c8020678d4239cf4c6b86bb9051 Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Sat, 28 Feb 2026 23:26:54 +0100 Subject: [PATCH 03/27] freeze commend for index.mjs --- api/src/index.mjs | 75 +++++++++++++++++++++++++++++++++++++---------- 1 file changed, 59 insertions(+), 16 deletions(-) diff --git a/api/src/index.mjs b/api/src/index.mjs index cad45401..e700177b 100644 --- a/api/src/index.mjs +++ b/api/src/index.mjs @@ -1,32 +1,75 @@ -import "dotenv/config"; -import express from "express"; -import cors from "cors"; -import bodyParser from "body-parser"; -import rootRouter from "#routers"; -import swaggerSetup from "#configs/swagger.js"; -import middlewares from "#middlewares"; +/** + * ================================================================ + * 🚨 DO NOT MODIFY THIS FILE 🚨 + * ================================================================ + * + * This is the main application entry point. + * It is intentionally minimal and structured to ensure: + * + * - All middleware is registered in the correct order + * - All routes are properly mounted + * - Swagger detects every endpoint + * - The application starts consistently in all environments + * + * Any application logic, middleware, or route changes + * MUST be implemented in their respective modules. + * + * This file should remain unchanged. + * ================================================================ + */ + +import "dotenv/config"; // Loads environment variables from .env +import express from "express"; // Express web framework +import cors from "cors"; // Cross-Origin Resource Sharing middleware +import bodyParser from "body-parser"; // JSON body parsing +import rootRouter from "#routers"; // Main router aggregator +import swaggerSetup from "#configs/swagger.js"; // Swagger documentation setup +import middlewares from "#middlewares"; // Global middleware array + +// ------------------------------------------------------------------ +// Application Initialization +// ------------------------------------------------------------------ const app = express(); +// Enable CORS for all incoming requests app.use(cors()); + +// Parse incoming JSON request bodies app.use(bodyParser.json()); +// ------------------------------------------------------------------ +// Register Global Middlewares +// ------------------------------------------------------------------ +// Middlewares are applied in sequence before route handlers. +// This allows centralized handling (e.g. logging, error formatting, etc.) for (const middleware of middlewares) { app.use(middleware); } - +// ------------------------------------------------------------------ +// Register Application Routes +// ------------------------------------------------------------------ +// All API routes are mounted through the root router. app.use("/", rootRouter); -// must be last call before listen to ensure all endpoints was detected, regardless they are documented or not -swaggerSetup(app) +// ------------------------------------------------------------------ +// Swagger Setup +// ------------------------------------------------------------------ +// IMPORTANT: +// This MUST be called after routes are registered. +// Swagger scans the app and detects all available endpoints, +// regardless of whether they are documented or not. +swaggerSetup(app); + +// ------------------------------------------------------------------ +// Start Server +// ------------------------------------------------------------------ const port = process.env.PORT ?? 3000; app.listen(port, () => { - console.info(`${process.env.APP_NAME || "Backend-Mid-Specialism"} app started on port ${port }`); -}); - - - - + console.info( + `${process.env.APP_NAME || "Backend-Mid-Specialism"} app started on port ${port}` + ); +}); \ No newline at end of file From d64aca75380750f144b1be6d58b5ba6a7779d51b Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Mon, 2 Mar 2026 20:31:19 +0100 Subject: [PATCH 04/27] Update api/README.md Co-authored-by: Adam Blanchard --- api/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/README.md b/api/README.md index 599ef2ac..7aec85b0 100644 --- a/api/README.md +++ b/api/README.md @@ -51,7 +51,7 @@ The `db:setup` command is useful when: Knex migrations and seeds are an **advanced database management technique** often used in professional backend projects. -For homework and learning purposes, you are expected to: +For your tasks, assignments and learning purposes, you are expected to: - Design your own database schema - Write your own SQL queries From 9b4e837d80c310b53fe8354331a7e72e374b9317 Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Mon, 2 Mar 2026 20:34:37 +0100 Subject: [PATCH 05/27] Update api/README.md Co-authored-by: Adam Blanchard --- api/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/README.md b/api/README.md index 7aec85b0..85ab5165 100644 --- a/api/README.md +++ b/api/README.md @@ -58,7 +58,7 @@ For your tasks, assignments and learning purposes, you are expected to: - Understand how your tables are structured You should not rely blindly on the provided migrations if your assignment requires you to build your own schema. -If needed, modify or remove the existing migrations and seeds to match your database coursework. +If needed, modify or remove the existing migrations and seeds to match your database assignments. ## Deploying From d3415752b18d368c2a7278f2e90af3fcba561685 Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Mon, 2 Mar 2026 20:35:16 +0100 Subject: [PATCH 06/27] Update api/src/controllers/events.js Co-authored-by: Adam Blanchard --- api/src/controllers/events.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/src/controllers/events.js b/api/src/controllers/events.js index 26926224..17ec942d 100644 --- a/api/src/controllers/events.js +++ b/api/src/controllers/events.js @@ -35,7 +35,7 @@ export async function getEvents(req, res, next) { const page = Math.max(Number(req.query.page ?? 0), 0); const offset = page * PAGE_SIZE; - const filters = {}; // future: map req.query filters here + const filters = {}; // TODO: map req.query filters here // Run queries in parallel for better performance const [data, totalItems] = await Promise.all([ From cf36a277c207c41e66d73f00e3d37744d145cb1e Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Mon, 2 Mar 2026 21:08:26 +0100 Subject: [PATCH 07/27] remove already implemented pagination implementation --- api/src/models/events.js | 60 ++++------------------------------------ 1 file changed, 6 insertions(+), 54 deletions(-) diff --git a/api/src/models/events.js b/api/src/models/events.js index 99b1dc89..4fae4aa8 100644 --- a/api/src/models/events.js +++ b/api/src/models/events.js @@ -12,48 +12,6 @@ function baseQuery(trx = db) { return trx(TABLE); } -/** - * Applies common event filters to a query builder. - * - * This helper ensures filtering logic is defined in one place - * and reused by both list and count queries. - * - * @param {import("knex").Knex.QueryBuilder} qb - * @param {Object} filters - * @param {string} [filters.currency] - * @param {number} [filters.minPrice] - * @param {number} [filters.maxPrice] - * @param {string} [filters.search] - * - * @returns {import("knex").Knex.QueryBuilder} - */ -function applyEventFilters(qb, filters = {}) { - if (filters.currency) { - qb.where("currency", filters.currency); - } - - if (filters.minPrice != null) { - qb.where("price", ">=", filters.minPrice); - } - - if (filters.maxPrice != null) { - qb.where("price", "<=", filters.maxPrice); - } - - // Portable case-insensitive search (pg/mysql/sqlite) - if (filters.search) { - const q = `%${String(filters.search).toLowerCase()}%`; - - qb.where((builder) => { - builder - .whereRaw("LOWER(title) LIKE ?", [q]) - .orWhereRaw("LOWER(description) LIKE ?", [q]); - }); - } - - return qb; -} - /** * Count events matching optional filters. * @@ -66,13 +24,13 @@ function applyEventFilters(qb, filters = {}) { * @returns {Promise} Total matching rows */ export async function countEvents(filters = {}, options = {}) { - const { trx } = options; + let { trx } = options; + const qb = baseQuery(trx) - const qb = applyEventFilters(baseQuery(trx), filters); + // TODO: apply filters const row = await qb.count({ count: "*" }).first(); - // PostgreSQL returns string counts, normalize across dialects const count = row?.count ?? row?.["count(*)"] ?? 0; return Number(count); @@ -102,26 +60,20 @@ export async function countEvents(filters = {}, options = {}) { */ export async function listEvents(filters = {}, options = {}) { const { - limit, - offset, orderBy = "id", order = "asc", trx, } = options; - const qb = applyEventFilters( - baseQuery(trx).select("*"), - filters - ); + const qb = baseQuery(trx).select("*"); + + // TODO: apply filters qb.orderBy( orderBy, String(order).toLowerCase() === "desc" ? "desc" : "asc" ); - if (limit != null) qb.limit(limit); - if (offset != null) qb.offset(offset); - return qb; } From a808974ed34b5ee42e077db2a769bb224ca9401b Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Mon, 2 Mar 2026 21:10:11 +0100 Subject: [PATCH 08/27] remove already Promisse.all, by chatGPT, and use direct awaits instead --- api/src/controllers/events.js | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/api/src/controllers/events.js b/api/src/controllers/events.js index 17ec942d..e73cc8aa 100644 --- a/api/src/controllers/events.js +++ b/api/src/controllers/events.js @@ -37,16 +37,14 @@ export async function getEvents(req, res, next) { const filters = {}; // TODO: map req.query filters here - // Run queries in parallel for better performance - const [data, totalItems] = await Promise.all([ - listEvents(filters, { - limit: PAGE_SIZE, - offset, - orderBy: "id", - order: "asc", - }), - countEvents(filters), - ]); + const data = await listEvents(filters, { + limit: PAGE_SIZE, + offset, + orderBy: "id", + order: "asc", + }); + + const totalItems = await countEvents(filters) const totalPages = Math.ceil(totalItems / PAGE_SIZE); From 2f263c0c2a55434e527cce29d396694eb0bae596 Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Sun, 15 Mar 2026 21:28:29 +0100 Subject: [PATCH 09/27] remove undocumented example --- api/src/routers/undocumented.js | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 api/src/routers/undocumented.js diff --git a/api/src/routers/undocumented.js b/api/src/routers/undocumented.js deleted file mode 100644 index 8e7be861..00000000 --- a/api/src/routers/undocumented.js +++ /dev/null @@ -1,7 +0,0 @@ -import express from "express"; - -const unDocumentedDemo = express.Router(); - -unDocumentedDemo.get("/", (_req, res) => res.json({message: "Hello I'm undocumented endpoint!"})) - -export default unDocumentedDemo; \ No newline at end of file From 7604d64d2564288ead2278c3735bf937716ab447 Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Sun, 15 Mar 2026 21:30:19 +0100 Subject: [PATCH 10/27] fix issues making duplicates documented and undocumentented because of Swagger/Express path wars definition descripency --- api/src/configs/swagger.js | 55 +++++++++++++++++--------------------- 1 file changed, 25 insertions(+), 30 deletions(-) diff --git a/api/src/configs/swagger.js b/api/src/configs/swagger.js index 1f9c6580..9c49dd7b 100644 --- a/api/src/configs/swagger.js +++ b/api/src/configs/swagger.js @@ -1,17 +1,6 @@ -/** - * Swagger configuration module. - * - * Hybrid approach: - * - Automatically discovers all Express controllers at runtime. - * - Merges them with manually documented @swagger JSDoc blocks. - * - Undocumented controllers still appear with a default stub. - * - Documented controllers override the stub with full OpenAPI definitions. - */ - import swaggerUi from "swagger-ui-express"; import swaggerJsdoc from "swagger-jsdoc"; import listEndpoints from "express-list-endpoints"; -import deepmerge from "deepmerge"; /** * Base Swagger (OpenAPI 3) configuration. @@ -27,11 +16,6 @@ const swaggerOptions = { description: "API documentation", }, }, - - /** - * Files that contain @swagger JSDoc blocks. - * Adjust paths if router structure changes. - */ apis: ["./src/routers/**/*.js", "./src/routers/*.js"], }; @@ -48,23 +32,33 @@ const openApiEndpointSpecStub = { }, }; -/** - * swagger-jsdoc generated specification - * based only on @swagger JSDoc blocks. - */ const swaggerSpec = swaggerJsdoc(swaggerOptions); +const swaggerServe = swaggerUi.serve; /** - * Swagger UI static middleware. + * Convert Express route params to OpenAPI path params. + * + * Examples: + * - /api/events/:id -> /api/events/{id} + * - /api/users/:userId/orders/:orderId -> /api/users/{userId}/orders/{orderId} + * + * @param {string} path + * @returns {string} */ -const swaggerServe = swaggerUi.serve; +function expressPathToOpenApiPath(path) { + return path.replace(/:([A-Za-z0-9_]+)/g, "{$1}"); +} /** * Generates OpenAPI "paths" object automatically * by inspecting the Express app router stack. * - * @param {import("express").Application} app - Express application instance - * @returns {object} OpenAPI-compatible paths object + * Undocumented routes are converted into OpenAPI-compatible + * path syntax so they can merge correctly with manually + * documented @swagger definitions. + * + * @param {import("express").Application} app + * @returns {object} * * Example output: * { @@ -78,16 +72,16 @@ const generateOpenApiSpecs = (app) => { const specs = {}; for (const ep of listEndpoints(app)) { - // Ensure path object exists - specs[ep.path] ??= {}; + const normalizedPath = expressPathToOpenApiPath(ep.path); + + specs[normalizedPath] ??= {}; for (const method of ep.methods) { const m = method.toLowerCase(); - // Only add stub if not already defined - specs[ep.path][m] ??= { + specs[normalizedPath][m] ??= { ...openApiEndpointSpecStub, - summary: `Undocumented: ${method} ${ep.path}`, + summary: `Undocumented: ${method} ${normalizedPath}`, }; } } @@ -116,8 +110,9 @@ const swaggerSetup = (app) => { // Only add stubs where docs are missing for (const [path, ops] of Object.entries(autoGeneratedSpecs)) { mergedSpec.paths[path] ??= {}; + for (const [method, opSpec] of Object.entries(ops)) { - mergedSpec.paths[path][method] ??= opSpec; // keep documented op if it exists + mergedSpec.paths[path][method] ??= opSpec; } } From 0a9259f6fcf398bcb4523052ccc69e5e0e00e128 Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Sun, 15 Mar 2026 21:32:24 +0100 Subject: [PATCH 11/27] refactor: improve MVC examples and clarify comments describing implementation scope --- api/src/controllers/events.js | 132 ++++++++++++++++++++++++++++++++-- api/src/models/events.js | 87 +++++++++++++++------- api/src/routers/events.js | 113 ++++++++++++++++++++++++++++- 3 files changed, 299 insertions(+), 33 deletions(-) diff --git a/api/src/controllers/events.js b/api/src/controllers/events.js index e73cc8aa..2c97203d 100644 --- a/api/src/controllers/events.js +++ b/api/src/controllers/events.js @@ -1,8 +1,38 @@ -import { listEvents, countEvents } from "#models/events.js"; +import { + listEvents, + countEvents, + findEventById, + createEvent, + updateEvent, + deleteEvent, +} from "#models/events.js"; + +/** + * Event controller (MVC example) + * + * This controller intentionally demonstrates how route handlers are grouped + * for a single domain entity inside an MVC-style backend structure. + * + * The trainee is not expected to already be familiar with MVC as a pattern, + * but they are expected to continue working within the structure established + * by this skeleton. + * + * For that reason, this file serves two purposes: + * 1. provide a working example of a controller handler used in the project + * 2. show the expected controller shape as the API grows + * + * Important: + * - Not every exported handler in this file is part of the required trainee scope + * - Some handlers are placeholders included only to demonstrate controller structure + * - Optional placeholders should only be implemented if optional/additional + * project scope is explicitly taken on + */ /** * GET /api/events * + * Working required example of a controller-layer "list" handler. + * * Query Parameters: * - page (number, optional, default = 0) * @@ -24,8 +54,8 @@ import { listEvents, countEvents } from "#models/events.js"; * } * * Notes: - * - Filtering can be added later by mapping req.query → filters object. - * - Sorting validation should be handled before passing orderBy. + * - Filtering can be added later by mapping req.query -> filters object + * - Sorting validation should be handled before passing orderBy */ export async function getEvents(req, res, next) { try { @@ -35,7 +65,7 @@ export async function getEvents(req, res, next) { const page = Math.max(Number(req.query.page ?? 0), 0); const offset = page * PAGE_SIZE; - const filters = {}; // TODO: map req.query filters here + const filters = {}; // TODO (required project work): map req.query filters here const data = await listEvents(filters, { limit: PAGE_SIZE, @@ -44,8 +74,7 @@ export async function getEvents(req, res, next) { order: "asc", }); - const totalItems = await countEvents(filters) - + const totalItems = await countEvents(filters); const totalPages = Math.ceil(totalItems / PAGE_SIZE); res.json({ @@ -58,6 +87,95 @@ export async function getEvents(req, res, next) { }, }); } catch (error) { - next(error); // Delegate to Express error middleware + next(error); + } +} + +/** + * OPTIONAL STRUCTURE PLACEHOLDER + * + * This handler is included to demonstrate how a controller file may contain + * additional entity actions beyond "list". + * + * It is NOT part of the required trainee scope unless optional/admin + * functionality is explicitly added to the project. + */ +export async function getEventById(req, res, next) { + try { + const event = await findEventById(req.params.id); + + if (!event) { + return res.status(404).json({ + error: "Event not found", + }); + } + + res.json({ data: event }); + } catch (error) { + next(error); + } +} + +/** + * OPTIONAL STRUCTURE PLACEHOLDER + * + * This handler exists only to illustrate where a controller-layer "create" + * action would live in the MVC structure. + * + * It is NOT required for the base trainee project unless optional/admin + * scope is explicitly added. + */ +export async function postEvent(req, res, next) { + try { + await createEvent(req.body); + + return res.status(501).json({ + error: + "Optional placeholder: postEvent is intentionally not implemented in the base skeleton", + }); + } catch (error) { + next(error); + } +} + +/** + * OPTIONAL STRUCTURE PLACEHOLDER + * + * This handler exists only as an example of expected controller structure + * for future entity update actions. + * + * It is NOT part of the required trainee implementation in the default scope. + */ +export async function patchEvent(req, res, next) { + try { + await updateEvent(req.params.id, req.body); + + return res.status(501).json({ + error: + "Optional placeholder: patchEvent is intentionally not implemented in the base skeleton", + }); + } catch (error) { + next(error); + } +} + +/** + * OPTIONAL STRUCTURE PLACEHOLDER + * + * This handler exists only to illustrate where a controller-layer "delete" + * action would be placed in the same MVC controller file. + * + * It is NOT part of the required trainee implementation in the default scope. + */ +export async function removeEvent(req, res, next) { + try { + await deleteEvent(req.params.id); + + return res.status(501).json({ + error: + "Optional placeholder: removeEvent is intentionally not implemented in the base skeleton", + }); + } catch (error) { + next(error); } } \ No newline at end of file diff --git a/api/src/models/events.js b/api/src/models/events.js index 4fae4aa8..480c1987 100644 --- a/api/src/models/events.js +++ b/api/src/models/events.js @@ -2,6 +2,27 @@ import db from "#configs/database.js"; const TABLE = "event"; +/** + * Event model (MVC example) + * + * This file intentionally demonstrates how a model file can group multiple + * database actions for the same domain entity inside an MVC-style structure. + * + * The trainee is not expected to already be familiar with MVC as a pattern, + * but they are expected to continue working within the structure established + * by this skeleton. + * + * For that reason, this file serves two purposes: + * 1. provide working examples of how model functions are organized + * 2. show the expected shape of a model as the project grows + * + * Important: + * - Not every function in this file is part of the required trainee scope + * - Some functions are included as placeholders to demonstrate structure only + * - Optional placeholders should only be implemented if the trainee chooses + * to work on additional / optional features + */ + /** * Returns a base query builder for the event table. * @@ -15,7 +36,8 @@ function baseQuery(trx = db) { /** * Count events matching optional filters. * - * Used for pagination metadata (totalItems / totalPages). + * This is a working example of a model-layer function used by the controller + * to support API response metadata such as totalItems / totalPages. * * @param {Object} [filters={}] * @param {Object} [options={}] @@ -24,13 +46,12 @@ function baseQuery(trx = db) { * @returns {Promise} Total matching rows */ export async function countEvents(filters = {}, options = {}) { - let { trx } = options; - const qb = baseQuery(trx) + const { trx } = options; + const qb = baseQuery(trx); - // TODO: apply filters + // TODO (required project work): apply supported filters when filter features are implemented const row = await qb.count({ count: "*" }).first(); - const count = row?.count ?? row?.["count(*)"] ?? 0; return Number(count); @@ -39,9 +60,11 @@ export async function countEvents(filters = {}, options = {}) { /** * List events with optional filters and offset-based pagination. * + * This is a working example of a model-layer "read many" function. + * * NOTE: - * - Supports limit + offset only. - * - Page calculation should be handled at API/controller level. + * - Supports limit + offset only + * - Page calculation should be handled at API/controller level * * @param {Object} [filters={}] * @param {string} [filters.currency] @@ -67,7 +90,7 @@ export async function listEvents(filters = {}, options = {}) { const qb = baseQuery(trx).select("*"); - // TODO: apply filters + // TODO (required project work): apply supported filters qb.orderBy( orderBy, @@ -80,6 +103,8 @@ export async function listEvents(filters = {}, options = {}) { /** * Find a single event by id. * + * This is a working example of a model-layer "read one" function. + * * @param {number|string} id * @param {Object} [options={}] * @param {import("knex").Knex} [options.trx] @@ -95,36 +120,48 @@ export async function findEventById(id, { trx } = {}) { } /** - * Create a new event. + * OPTIONAL STRUCTURE PLACEHOLDER + * + * This function is included to demonstrate that a model file in this project + * may contain multiple actions for the same entity, not only "list" and "find". * - * TODO: - * - Validate input - * - Insert row - * - Return created row (dialect-safe) + * It is NOT part of the required trainee scope unless optional/admin features + * are explicitly implemented. + * + * If optional admin functionality is added, this placeholder can be replaced + * with a real implementation. */ export async function createEvent() { - throw new Error("TODO: createEvent is not implemented yet"); + throw new Error( + "Optional placeholder: createEvent is intentionally not implemented in the base skeleton" + ); } /** - * Update an existing event by id. + * OPTIONAL STRUCTURE PLACEHOLDER * - * TODO: - * - Validate patch fields - * - Perform update - * - Return updated row (or null if not found) + * This function exists only as an example of expected MVC model structure for + * future entity actions. + * + * It is NOT required for the base trainee project unless optional/admin scope + * is added. */ export async function updateEvent() { - throw new Error("TODO: updateEvent is not implemented yet"); + throw new Error( + "Optional placeholder: updateEvent is intentionally not implemented in the base skeleton" + ); } /** - * Delete an event by id. + * OPTIONAL STRUCTURE PLACEHOLDER * - * TODO: - * - Delete row - * - Return true/false depending on whether a row was deleted + * This function exists only to illustrate how additional model actions would + * be placed in the same MVC model file. + * + * It is NOT part of the required trainee implementation in the default scope. */ export async function deleteEvent() { - throw new Error("TODO: deleteEvent is not implemented yet"); + throw new Error( + "Optional placeholder: deleteEvent is intentionally not implemented in the base skeleton" + ); } \ No newline at end of file diff --git a/api/src/routers/events.js b/api/src/routers/events.js index c3bb02b8..b798e752 100644 --- a/api/src/routers/events.js +++ b/api/src/routers/events.js @@ -1,8 +1,28 @@ import express from "express"; -import { getEvents } from "#controllers/events.js"; +import { + getEvents, + getEventById, + postEvent, + patchEvent, + removeEvent, +} from "#controllers/events.js"; const eventsRouter = express.Router(); +/** + * Events router (MVC example) + * + * This router demonstrates how HTTP routes are mapped to controller handlers + * within the MVC structure used in this backend skeleton. + * + * Only some routes are required for the base trainee assignment. + * Additional routes are included as OPTIONAL placeholders to illustrate + * how the API structure may grow (for example with admin functionality). + * + * Optional routes should only be implemented if the trainee decides to + * extend the project beyond the required scope. + */ + /** * @swagger * /api/events: @@ -76,4 +96,95 @@ const eventsRouter = express.Router(); */ eventsRouter.get("/", getEvents); +/** + * OPTIONAL ROUTE PLACEHOLDER + * + * Demonstrates how a "get single resource" endpoint would be added. + * Not required in the base trainee assignment unless optional scope + * is implemented. + * + * @swagger + * /api/events/{id}: + * get: + * summary: Get event by ID + * tags: + * - Events + * parameters: + * - in: path + * name: id + * required: true + * schema: + * type: integer + * description: Event ID + * responses: + * 200: + * description: Event found + * 404: + * description: Event not found + */ +eventsRouter.get("/:id", getEventById); + +/** + * OPTIONAL ROUTE PLACEHOLDER + * + * Example of a "create event" endpoint (typically admin functionality). + * + * @swagger + * /api/events: + * post: + * summary: Create event (optional/admin) + * tags: + * - Events + * responses: + * 501: + * description: Not implemented in base skeleton + */ +eventsRouter.post("/", postEvent); + +/** + * OPTIONAL ROUTE PLACEHOLDER + * + * Example of an "update event" endpoint. + * + * @swagger + * /api/events/{id}: + * patch: + * summary: Update event (optional/admin) + * tags: + * - Events + * parameters: + * - in: path + * name: id + * required: true + * schema: + * type: integer + * responses: + * 501: + * description: Not implemented in base skeleton + */ +eventsRouter.patch("/:id", patchEvent); + +/** + * OPTIONAL ROUTE PLACEHOLDER + * + * Example of a "delete event" endpoint. + * + * @swagger + * /api/events/{id}: + * delete: + * summary: Delete event (optional/admin) + * tags: + * - Events + * parameters: + * - in: path + * name: id + * required: true + * schema: + * type: integer + * responses: + * 501: + * description: Not implemented in base skeleton + */ +eventsRouter.delete("/:id", removeEvent); + export default eventsRouter; \ No newline at end of file From 332550993ecf0496fe9a7a28646379c45137d06f Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Sun, 15 Mar 2026 21:33:44 +0100 Subject: [PATCH 12/27] update router according to latest changes --- api/src/routers/api.js | 2 -- 1 file changed, 2 deletions(-) diff --git a/api/src/routers/api.js b/api/src/routers/api.js index 37c694c4..a78f5e02 100644 --- a/api/src/routers/api.js +++ b/api/src/routers/api.js @@ -1,10 +1,8 @@ import express from "express"; import eventsRouter from "#routers/events.js"; -import unDocumentedDemo from "#routers/undocumented.js"; const apiRouter = express.Router(); apiRouter.use("/events", eventsRouter); -apiRouter.use("/undocumented", unDocumentedDemo); export default apiRouter; \ No newline at end of file From 28efbc06a52dba8bc4aa5dbd1163bf7f2fae6654 Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Sun, 15 Mar 2026 21:38:46 +0100 Subject: [PATCH 13/27] add section explaining MVC structure and trainee responsibilities --- api/README.md | 30 ++++++++++++++++++++++++++---- 1 file changed, 26 insertions(+), 4 deletions(-) diff --git a/api/README.md b/api/README.md index 85ab5165..5f2fa4e7 100644 --- a/api/README.md +++ b/api/README.md @@ -49,13 +49,34 @@ The `db:setup` command is useful when: ### Important for trainees -Knex migrations and seeds are an **advanced database management technique** often used in professional backend projects. +This skeleton includes a simple **MVC-style structure**: + +- **Routers** define API endpoints +- **Controllers** handle HTTP request/response logic +- **Models** contain database access logic + +MVC is introduced intentionally in this project, even if it has not been deeply covered as a formal pattern during the course. + +The reason is to simulate a more realistic backend project environment: +you may join a codebase where the overall structure was already chosen by a more experienced developer, and your task is to understand it, follow it, and continue building within it. + +At the same time, this project keeps the implementation aligned with the JavaScript level of the course: + +- modules and exported functions +- no class-based OOP requirement +- no advanced framework abstractions +- SQL and Knex used in a direct and readable way + +So while the **project structure** is slightly more professional and opinionated than a blank beginner project, the **coding style itself** remains intentionally simple and compatible with the modular JavaScript you have learned. + +Knex migrations and seeds are also included as an **advanced database management technique** often used in professional backend projects. For your tasks, assignments and learning purposes, you are expected to: -- Design your own database schema -- Write your own SQL queries -- Understand how your tables are structured +- design your own database schema +- write your own SQL queries +- understand how your tables are structured +- continue working within the provided MVC structure You should not rely blindly on the provided migrations if your assignment requires you to build your own schema. If needed, modify or remove the existing migrations and seeds to match your database assignments. @@ -162,3 +183,4 @@ In the next screen you'll see the output of your build step which is downloading Once you see the text "Your service is live" you can test your API with Postman by using the deployed URL, which should be something like `https://hyf-template-api.onrender.com/api`. You should see the output the response from your "/" route. If you've got this far, you probably want to deploy your web app next. Head over to the README.md in your app directory for instructions. + From 9876baf5810adbfd8ea1a6a74a7cf2df056cdc05 Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Mon, 16 Mar 2026 15:52:10 +0100 Subject: [PATCH 14/27] add a todo statement for IDE highlight and beter look up for reviewers --- api/src/controllers/events.js | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/api/src/controllers/events.js b/api/src/controllers/events.js index 2c97203d..2375987b 100644 --- a/api/src/controllers/events.js +++ b/api/src/controllers/events.js @@ -126,6 +126,8 @@ export async function getEventById(req, res, next) { * scope is explicitly added. */ export async function postEvent(req, res, next) { + + // OPTIONAL TODO: implement this handler only if optional scope is taken on try { await createEvent(req.body); @@ -147,6 +149,7 @@ export async function postEvent(req, res, next) { * It is NOT part of the required trainee implementation in the default scope. */ export async function patchEvent(req, res, next) { + // OPTIONAL TODO: implement this handler only if optional scope is taken on try { await updateEvent(req.params.id, req.body); @@ -168,6 +171,7 @@ export async function patchEvent(req, res, next) { * It is NOT part of the required trainee implementation in the default scope. */ export async function removeEvent(req, res, next) { + // OPTIONAL TODO: implement this handler only if optional scope is taken on try { await deleteEvent(req.params.id); From 85317c8650a1316cd69d18a911338dde8e388b67 Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Mon, 16 Mar 2026 15:52:25 +0100 Subject: [PATCH 15/27] missing autoincrement --- api/src/db/migrations/20260228120000_create_event_table.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/src/db/migrations/20260228120000_create_event_table.js b/api/src/db/migrations/20260228120000_create_event_table.js index 282d553c..143f22c4 100644 --- a/api/src/db/migrations/20260228120000_create_event_table.js +++ b/api/src/db/migrations/20260228120000_create_event_table.js @@ -3,7 +3,7 @@ */ export async function up(knex) { await knex.schema.createTable("event", (t) => { - t.integer("id").primary(); + t.increments("id").primary(); t.decimal("price", 10, 2).notNullable(); t.string("currency", 3).notNullable(); t.string("title").notNullable(); From 6604621049051c40940664e6fff0e0bd2134b8ba Mon Sep 17 00:00:00 2001 From: oleksiybondar Date: Mon, 16 Mar 2026 15:53:00 +0100 Subject: [PATCH 16/27] remove package-lock with arm64 specific dependencies --- api/package-lock.json | 4090 ----------------------------------------- api/src/db/migrate.js | 1 + api/src/db/seed.js | 1 + 3 files changed, 2 insertions(+), 4090 deletions(-) delete mode 100644 api/package-lock.json diff --git a/api/package-lock.json b/api/package-lock.json deleted file mode 100644 index c6e3d581..00000000 --- a/api/package-lock.json +++ /dev/null @@ -1,4090 +0,0 @@ -{ - "name": "api", - "version": "1.0.0", - "lockfileVersion": 3, - "requires": true, - "packages": { - "": { - "name": "api", - "version": "1.0.0", - "dependencies": { - "body-parser": "^1.20.2", - "cors": "^2.8.5", - "deepmerge": "^4.3.1", - "dotenv": "^16.4.5", - "express": "^4.19.2", - "express-list-endpoints": "^7.1.1", - "knex": "^3.1.0", - "mysql2": "^3.10.0", - "pg": "^8.11.5", - "sqlite3": "^5.1.7", - "swagger-jsdoc": "^6.2.8", - "swagger-ui-express": "^5.0.0" - }, - "devDependencies": { - "@eslint/js": "^9.0.0", - "eslint": "^9.0.0", - "globals": "^15.0.0", - "nodemon": "^3.1.0", - "prettier": "^3.2.5" - }, - "engines": { - "node": "^20.12.1", - "npm": "^10.5.0" - } - }, - "node_modules/@aashutoshrathi/word-wrap": { - "version": "1.2.6", - "resolved": "https://registry.npmjs.org/@aashutoshrathi/word-wrap/-/word-wrap-1.2.6.tgz", - "integrity": "sha512-1Yjs2SvM8TflER/OD3cOjhWWOZb58A2t7wpE2S9XfBYTiIl+XFhQG2bjy4Pu1I+EAlCNUzRDYDdFwFYUKvXcIA==", - "dev": true, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/@apidevtools/json-schema-ref-parser": { - "version": "9.1.2", - "resolved": "https://registry.npmjs.org/@apidevtools/json-schema-ref-parser/-/json-schema-ref-parser-9.1.2.tgz", - "integrity": "sha512-r1w81DpR+KyRWd3f+rk6TNqMgedmAxZP5v5KWlXQWlgMUUtyEJch0DKEci1SorPMiSeM8XPl7MZ3miJ60JIpQg==", - "dependencies": { - "@jsdevtools/ono": "^7.1.3", - "@types/json-schema": "^7.0.6", - "call-me-maybe": "^1.0.1", - "js-yaml": "^4.1.0" - } - }, - "node_modules/@apidevtools/openapi-schemas": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/@apidevtools/openapi-schemas/-/openapi-schemas-2.1.0.tgz", - "integrity": "sha512-Zc1AlqrJlX3SlpupFGpiLi2EbteyP7fXmUOGup6/DnkRgjP9bgMM/ag+n91rsv0U1Gpz0H3VILA/o3bW7Ua6BQ==", - "engines": { - "node": ">=10" - } - }, - "node_modules/@apidevtools/swagger-methods": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/@apidevtools/swagger-methods/-/swagger-methods-3.0.2.tgz", - "integrity": "sha512-QAkD5kK2b1WfjDS/UQn/qQkbwF31uqRjPTrsCs5ZG9BQGAkjwvqGFjjPqAuzac/IYzpPtRzjCP1WrTuAIjMrXg==" - }, - "node_modules/@apidevtools/swagger-parser": { - "version": "10.0.3", - "resolved": "https://registry.npmjs.org/@apidevtools/swagger-parser/-/swagger-parser-10.0.3.tgz", - "integrity": "sha512-sNiLY51vZOmSPFZA5TF35KZ2HbgYklQnTSDnkghamzLb3EkNtcQnrBQEj5AOCxHpTtXpqMCRM1CrmV2rG6nw4g==", - "dependencies": { - "@apidevtools/json-schema-ref-parser": "^9.0.6", - "@apidevtools/openapi-schemas": "^2.0.4", - "@apidevtools/swagger-methods": "^3.0.2", - "@jsdevtools/ono": "^7.1.3", - "call-me-maybe": "^1.0.1", - "z-schema": "^5.0.1" - }, - "peerDependencies": { - "openapi-types": ">=7" - } - }, - "node_modules/@eslint-community/eslint-utils": { - "version": "4.4.0", - "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.4.0.tgz", - "integrity": "sha512-1/sA4dwrzBAyeUoQ6oxahHKmrZvsnLCg4RfxW3ZFGGmQkSNQPFNLV9CUEFQP1x9EYXHTo5p6xdhZM1Ne9p/AfA==", - "dev": true, - "dependencies": { - "eslint-visitor-keys": "^3.3.0" - }, - "engines": { - "node": "^12.22.0 || ^14.17.0 || >=16.0.0" - }, - "peerDependencies": { - "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" - } - }, - "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": { - "version": "3.4.3", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", - "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", - "dev": true, - "engines": { - "node": "^12.22.0 || ^14.17.0 || >=16.0.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/@eslint-community/regexpp": { - "version": "4.10.0", - "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.10.0.tgz", - "integrity": "sha512-Cu96Sd2By9mCNTx2iyKOmq10v22jUVQv0lQnlGNy16oE9589yE+QADPbrMGCkA51cKZSg3Pu/aTJVTGfL/qjUA==", - "dev": true, - "engines": { - "node": "^12.0.0 || ^14.0.0 || >=16.0.0" - } - }, - "node_modules/@eslint/eslintrc": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.0.2.tgz", - "integrity": "sha512-wV19ZEGEMAC1eHgrS7UQPqsdEiCIbTKTasEfcXAigzoXICcqZSjBZEHlZwNVvKg6UBCjSlos84XiLqsRJnIcIg==", - "dev": true, - "dependencies": { - "ajv": "^6.12.4", - "debug": "^4.3.2", - "espree": "^10.0.1", - "globals": "^14.0.0", - "ignore": "^5.2.0", - "import-fresh": "^3.2.1", - "js-yaml": "^4.1.0", - "minimatch": "^3.1.2", - "strip-json-comments": "^3.1.1" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/@eslint/eslintrc/node_modules/debug": { - "version": "4.3.4", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz", - "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==", - "dev": true, - "dependencies": { - "ms": "2.1.2" - }, - "engines": { - "node": ">=6.0" - }, - "peerDependenciesMeta": { - "supports-color": { - "optional": true - } - } - }, - "node_modules/@eslint/eslintrc/node_modules/globals": { - "version": "14.0.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz", - "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==", - "dev": true, - "engines": { - "node": ">=18" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/@eslint/eslintrc/node_modules/ms": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", - "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==", - "dev": true - }, - "node_modules/@eslint/js": { - "version": "9.0.0", - "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.0.0.tgz", - "integrity": "sha512-RThY/MnKrhubF6+s1JflwUjPEsnCEmYCWwqa/aRISKWNXGZ9epUwft4bUMM35SdKF9xvBrLydAM1RDHd1Z//ZQ==", - "dev": true, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - } - }, - "node_modules/@gar/promisify": { - "version": "1.1.3", - "resolved": "https://registry.npmjs.org/@gar/promisify/-/promisify-1.1.3.tgz", - "integrity": "sha512-k2Ty1JcVojjJFwrg/ThKi2ujJ7XNLYaFGNB/bWT9wGR+oSMJHMa5w+CUq6p/pVrKeNNgA7pCqEcjSnHVoqJQFw==", - "optional": true - }, - "node_modules/@humanwhocodes/config-array": { - "version": "0.12.3", - "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.12.3.tgz", - "integrity": "sha512-jsNnTBlMWuTpDkeE3on7+dWJi0D6fdDfeANj/w7MpS8ztROCoLvIO2nG0CcFj+E4k8j4QrSTh4Oryi3i2G669g==", - "dev": true, - "dependencies": { - "@humanwhocodes/object-schema": "^2.0.3", - "debug": "^4.3.1", - "minimatch": "^3.0.5" - }, - "engines": { - "node": ">=10.10.0" - } - }, - "node_modules/@humanwhocodes/config-array/node_modules/debug": { - "version": "4.3.4", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz", - "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==", - "dev": true, - "dependencies": { - "ms": "2.1.2" - }, - "engines": { - "node": ">=6.0" - }, - "peerDependenciesMeta": { - "supports-color": { - "optional": true - } - } - }, - "node_modules/@humanwhocodes/config-array/node_modules/ms": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", - "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==", - "dev": true - }, - "node_modules/@humanwhocodes/module-importer": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", - "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", - "dev": true, - "engines": { - "node": ">=12.22" - }, - "funding": { - "type": "github", - "url": "https://github.com/sponsors/nzakas" - } - }, - "node_modules/@humanwhocodes/object-schema": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-2.0.3.tgz", - "integrity": "sha512-93zYdMES/c1D69yZiKDBj0V24vqNzB/koF26KPaagAfd3P/4gUlh3Dys5ogAK+Exi9QyzlD8x/08Zt7wIKcDcA==", - "dev": true - }, - "node_modules/@jsdevtools/ono": { - "version": "7.1.3", - "resolved": "https://registry.npmjs.org/@jsdevtools/ono/-/ono-7.1.3.tgz", - "integrity": "sha512-4JQNk+3mVzK3xh2rqd6RB4J46qUR19azEHBneZyTZM+c456qOrbbM/5xcR8huNCCcbVt7+UmizG6GuUvPvKUYg==" - }, - "node_modules/@nodelib/fs.scandir": { - "version": "2.1.5", - "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", - "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", - "dev": true, - "dependencies": { - "@nodelib/fs.stat": "2.0.5", - "run-parallel": "^1.1.9" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/@nodelib/fs.stat": { - "version": "2.0.5", - "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", - "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", - "dev": true, - "engines": { - "node": ">= 8" - } - }, - "node_modules/@nodelib/fs.walk": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", - "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", - "dev": true, - "dependencies": { - "@nodelib/fs.scandir": "2.1.5", - "fastq": "^1.6.0" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/@npmcli/fs": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/@npmcli/fs/-/fs-1.1.1.tgz", - "integrity": "sha512-8KG5RD0GVP4ydEzRn/I4BNDuxDtqVbOdm8675T49OIG/NGhaK0pjPX7ZcDlvKYbA+ulvVK3ztfcF4uBdOxuJbQ==", - "optional": true, - "dependencies": { - "@gar/promisify": "^1.0.1", - "semver": "^7.3.5" - } - }, - "node_modules/@npmcli/move-file": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/@npmcli/move-file/-/move-file-1.1.2.tgz", - "integrity": "sha512-1SUf/Cg2GzGDyaf15aR9St9TWlb+XvbZXWpDx8YKs7MLzMH/BCeopv+y9vzrzgkfykCGuWOlSu3mZhj2+FQcrg==", - "deprecated": "This functionality has been moved to @npmcli/fs", - "optional": true, - "dependencies": { - "mkdirp": "^1.0.4", - "rimraf": "^3.0.2" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/@scarf/scarf": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/@scarf/scarf/-/scarf-1.4.0.tgz", - "integrity": "sha512-xxeapPiUXdZAE3che6f3xogoJPeZgig6omHEy1rIY5WVsB3H2BHNnZH+gHG6x91SCWyQCzWGsuL2Hh3ClO5/qQ==", - "hasInstallScript": true - }, - "node_modules/@tootallnate/once": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/@tootallnate/once/-/once-1.1.2.tgz", - "integrity": "sha512-RbzJvlNzmRq5c3O09UipeuXno4tA1FE6ikOjxZK0tuxVv3412l64l5t1W5pj4+rJq9vpkm/kwiR07aZXnsKPxw==", - "optional": true, - "engines": { - "node": ">= 6" - } - }, - "node_modules/@types/json-schema": { - "version": "7.0.15", - "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", - "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==" - }, - "node_modules/abbrev": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.1.1.tgz", - "integrity": "sha512-nne9/IiQ/hzIhY6pdDnbBtz7DjPTKrY00P/zvPSm5pOFkl6xuGrGnXn/VtTNNfNtAfZ9/1RtehkszU9qcTii0Q==", - "devOptional": true - }, - "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==", - "dependencies": { - "mime-types": "~2.1.34", - "negotiator": "0.6.3" - }, - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/acorn": { - "version": "8.11.3", - "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.11.3.tgz", - "integrity": "sha512-Y9rRfJG5jcKOE0CLisYbojUjIrIEE7AGMzA/Sm4BslANhbS+cDMpgBdcPT91oJ7OuJ9hYJBx59RjbhxVnrF8Xg==", - "dev": true, - "bin": { - "acorn": "bin/acorn" - }, - "engines": { - "node": ">=0.4.0" - } - }, - "node_modules/acorn-jsx": { - "version": "5.3.2", - "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", - "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", - "dev": true, - "peerDependencies": { - "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" - } - }, - "node_modules/agent-base": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz", - "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==", - "optional": true, - "dependencies": { - "debug": "4" - }, - "engines": { - "node": ">= 6.0.0" - } - }, - "node_modules/agent-base/node_modules/debug": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz", - "integrity": "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==", - "optional": true, - "dependencies": { - "ms": "^2.1.3" - }, - "engines": { - "node": ">=6.0" - }, - "peerDependenciesMeta": { - "supports-color": { - "optional": true - } - } - }, - "node_modules/agent-base/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==", - "optional": true - }, - "node_modules/agentkeepalive": { - "version": "4.6.0", - "resolved": "https://registry.npmjs.org/agentkeepalive/-/agentkeepalive-4.6.0.tgz", - "integrity": "sha512-kja8j7PjmncONqaTsB8fQ+wE2mSU2DJ9D4XKoJ5PFWIdRMa6SLSN1ff4mOr4jCbfRSsxR4keIiySJU0N9T5hIQ==", - "optional": true, - "dependencies": { - "humanize-ms": "^1.2.1" - }, - "engines": { - "node": ">= 8.0.0" - } - }, - "node_modules/aggregate-error": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/aggregate-error/-/aggregate-error-3.1.0.tgz", - "integrity": "sha512-4I7Td01quW/RpocfNayFdFVk1qSuoh0E7JrbRJ16nH01HhKFQ88INq9Sd+nd72zqRySlr9BmDA8xlEJ6vJMrYA==", - "optional": true, - "dependencies": { - "clean-stack": "^2.0.0", - "indent-string": "^4.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/ajv": { - "version": "6.12.6", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", - "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", - "dev": true, - "dependencies": { - "fast-deep-equal": "^3.1.1", - "fast-json-stable-stringify": "^2.0.0", - "json-schema-traverse": "^0.4.1", - "uri-js": "^4.2.2" - }, - "funding": { - "type": "github", - "url": "https://github.com/sponsors/epoberezkin" - } - }, - "node_modules/ansi-regex": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", - "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", - "devOptional": true, - "engines": { - "node": ">=8" - } - }, - "node_modules/ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "dev": true, - "dependencies": { - "color-convert": "^2.0.1" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" - } - }, - "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, - "dependencies": { - "normalize-path": "^3.0.0", - "picomatch": "^2.0.4" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/aproba": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/aproba/-/aproba-2.0.0.tgz", - "integrity": "sha512-lYe4Gx7QT+MKGbDsA+Z+he/Wtef0BiwDOlK/XkBrdfsh9J/jPPXbX0tE9x9cl27Tmu5gg3QUbUrQYa/y+KOHPQ==", - "optional": true - }, - "node_modules/are-we-there-yet": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/are-we-there-yet/-/are-we-there-yet-3.0.1.tgz", - "integrity": "sha512-QZW4EDmGwlYur0Yyf/b2uGucHQMa8aFUP7eu9ddR73vvhFyt4V0Vl3QHPcTNJ8l6qYOBdxgXdnBXQrHilfRQBg==", - "deprecated": "This package is no longer supported.", - "optional": true, - "dependencies": { - "delegates": "^1.0.0", - "readable-stream": "^3.6.0" - }, - "engines": { - "node": "^12.13.0 || ^14.15.0 || >=16.0.0" - } - }, - "node_modules/argparse": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", - "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==" - }, - "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==" - }, - "node_modules/balanced-match": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", - "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==" - }, - "node_modules/base64-js": { - "version": "1.5.1", - "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", - "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ] - }, - "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, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/bindings": { - "version": "1.5.0", - "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz", - "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==", - "dependencies": { - "file-uri-to-path": "1.0.0" - } - }, - "node_modules/bl": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz", - "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==", - "dependencies": { - "buffer": "^5.5.0", - "inherits": "^2.0.4", - "readable-stream": "^3.4.0" - } - }, - "node_modules/body-parser": { - "version": "1.20.2", - "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.2.tgz", - "integrity": "sha512-ml9pReCu3M61kGlqoTm2umSXTlRTuGTx0bfYj+uIUKKYycG5NtSbeetV3faSU6R7ajOPw0g/J1PvK4qNy7s5bA==", - "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.0", - "iconv-lite": "0.4.24", - "on-finished": "2.4.1", - "qs": "6.11.0", - "raw-body": "2.5.2", - "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": "1.1.11", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", - "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==", - "dependencies": { - "balanced-match": "^1.0.0", - "concat-map": "0.0.1" - } - }, - "node_modules/braces": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.2.tgz", - "integrity": "sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A==", - "dev": true, - "dependencies": { - "fill-range": "^7.0.1" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/buffer": { - "version": "5.7.1", - "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz", - "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==", - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ], - "dependencies": { - "base64-js": "^1.3.1", - "ieee754": "^1.1.13" - } - }, - "node_modules/bytes": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", - "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", - "engines": { - "node": ">= 0.8" - } - }, - "node_modules/cacache": { - "version": "15.3.0", - "resolved": "https://registry.npmjs.org/cacache/-/cacache-15.3.0.tgz", - "integrity": "sha512-VVdYzXEn+cnbXpFgWs5hTT7OScegHVmLhJIR8Ufqk3iFD6A6j5iSX1KuBTfNEv4tdJWE2PzA6IVFtcLC7fN9wQ==", - "optional": true, - "dependencies": { - "@npmcli/fs": "^1.0.0", - "@npmcli/move-file": "^1.0.1", - "chownr": "^2.0.0", - "fs-minipass": "^2.0.0", - "glob": "^7.1.4", - "infer-owner": "^1.0.4", - "lru-cache": "^6.0.0", - "minipass": "^3.1.1", - "minipass-collect": "^1.0.2", - "minipass-flush": "^1.0.5", - "minipass-pipeline": "^1.2.2", - "mkdirp": "^1.0.3", - "p-map": "^4.0.0", - "promise-inflight": "^1.0.1", - "rimraf": "^3.0.2", - "ssri": "^8.0.1", - "tar": "^6.0.2", - "unique-filename": "^1.1.1" - }, - "engines": { - "node": ">= 10" - } - }, - "node_modules/cacache/node_modules/lru-cache": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", - "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", - "optional": true, - "dependencies": { - "yallist": "^4.0.0" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/call-bind": { - "version": "1.0.7", - "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.7.tgz", - "integrity": "sha512-GHTSNSYICQ7scH7sZ+M2rFopRoLh8t2bLSW6BbgrtLsahOIB5iyAVJf9GjWK3cYTDaMj4XdBpM1cA6pIS0Kv2w==", - "dependencies": { - "es-define-property": "^1.0.0", - "es-errors": "^1.3.0", - "function-bind": "^1.1.2", - "get-intrinsic": "^1.2.4", - "set-function-length": "^1.2.1" - }, - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/call-me-maybe": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.2.tgz", - "integrity": "sha512-HpX65o1Hnr9HH25ojC1YGs7HCQLq0GCOibSaWER0eNpgJ/Z1MZv2mTc7+xh6WOPxbRVcmgbv4hGU+uSQ/2xFZQ==" - }, - "node_modules/callsites": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", - "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", - "dev": true, - "engines": { - "node": ">=6" - } - }, - "node_modules/chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", - "dev": true, - "dependencies": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/chalk/chalk?sponsor=1" - } - }, - "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, - "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/chokidar/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, - "dependencies": { - "is-glob": "^4.0.1" - }, - "engines": { - "node": ">= 6" - } - }, - "node_modules/chownr": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/chownr/-/chownr-2.0.0.tgz", - "integrity": "sha512-bIomtDF5KGpdogkLd9VspvFzk9KfpyyGlS8YFVZl7TGPBHL5snIOnxeshwVgPteQ9b4Eydl+pVbIyE1DcvCWgQ==", - "engines": { - "node": ">=10" - } - }, - "node_modules/clean-stack": { - "version": "2.2.0", - "resolved": "https://registry.npmjs.org/clean-stack/-/clean-stack-2.2.0.tgz", - "integrity": "sha512-4diC9HaTE+KRAMWhDhrGOECgWZxoevMc5TlkObMqNSsVU62PYzXZ/SMTjzyGAFF1YusgxGcSWTEXBhp0CPwQ1A==", - "optional": true, - "engines": { - "node": ">=6" - } - }, - "node_modules/color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "dev": true, - "dependencies": { - "color-name": "~1.1.4" - }, - "engines": { - "node": ">=7.0.0" - } - }, - "node_modules/color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "dev": true - }, - "node_modules/color-support": { - "version": "1.1.3", - "resolved": "https://registry.npmjs.org/color-support/-/color-support-1.1.3.tgz", - "integrity": "sha512-qiBjkpbMLO/HL68y+lh4q0/O1MZFj2RX6X/KmMa3+gJD3z+WwI1ZzDHysvqHGS3mP6mznPckpXmw1nI9cJjyRg==", - "optional": true, - "bin": { - "color-support": "bin.js" - } - }, - "node_modules/colorette": { - "version": "2.0.19", - "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.19.tgz", - "integrity": "sha512-3tlv/dIP7FWvj3BsbHrGLJ6l/oKh1O3TcgBqMn+yyCagOxc23fyzDS6HypQbgxWbkpDnf52p1LuR4eWDQ/K9WQ==" - }, - "node_modules/commander": { - "version": "10.0.1", - "resolved": "https://registry.npmjs.org/commander/-/commander-10.0.1.tgz", - "integrity": "sha512-y4Mg2tXshplEbSGzx7amzPwKKOCGuoSRP/CjEdwwk0FOGlUbq6lKuoyDZTNZkmxHdJtp54hdfY/JUrdL7Xfdug==", - "engines": { - "node": ">=14" - } - }, - "node_modules/concat-map": { - "version": "0.0.1", - "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==" - }, - "node_modules/console-control-strings": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/console-control-strings/-/console-control-strings-1.1.0.tgz", - "integrity": "sha512-ty/fTekppD2fIwRvnZAVdeOiGd1c7YXEixbgJTNzqcxJWKQnjJ/V1bNEEE6hygpM3WjwHFUVK6HTjWSzV4a8sQ==", - "optional": true - }, - "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==", - "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==", - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/cookie": { - "version": "0.6.0", - "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.6.0.tgz", - "integrity": "sha512-U71cyTamuh1CRNCfpGY6to28lxvNwPG4Guz/EVjgf3Jmzv0vlDp1atT9eS5dDjMYHucpHbWns6Lwf3BKz6svdw==", - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/cookie-signature": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz", - "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==" - }, - "node_modules/cors": { - "version": "2.8.5", - "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.5.tgz", - "integrity": "sha512-KIHbLJqu73RGr/hnbrO9uBeixNGuvSQjul/jdFvS/KFSIH1hWVd1ng7zOHx+YrEfInLG7q4n6GHQ9cDtxv/P6g==", - "dependencies": { - "object-assign": "^4", - "vary": "^1" - }, - "engines": { - "node": ">= 0.10" - } - }, - "node_modules/cross-spawn": { - "version": "7.0.3", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz", - "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==", - "dev": true, - "dependencies": { - "path-key": "^3.1.0", - "shebang-command": "^2.0.0", - "which": "^2.0.1" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/debug": { - "version": "2.6.9", - "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", - "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", - "dependencies": { - "ms": "2.0.0" - } - }, - "node_modules/decompress-response": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz", - "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==", - "dependencies": { - "mimic-response": "^3.1.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/deep-extend": { - "version": "0.6.0", - "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz", - "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==", - "engines": { - "node": ">=4.0.0" - } - }, - "node_modules/deep-is": { - "version": "0.1.4", - "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", - "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", - "dev": true - }, - "node_modules/deepmerge": { - "version": "4.3.1", - "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz", - "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/define-data-property": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz", - "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==", - "dependencies": { - "es-define-property": "^1.0.0", - "es-errors": "^1.3.0", - "gopd": "^1.0.1" - }, - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/delegates": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/delegates/-/delegates-1.0.0.tgz", - "integrity": "sha512-bd2L678uiWATM6m5Z1VzNCErI3jiGzt6HGY8OVICs40JQq/HALfbyNJmp0UDakEY4pMMaN0Ly5om/B1VI/+xfQ==", - "optional": true - }, - "node_modules/denque": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/denque/-/denque-2.1.0.tgz", - "integrity": "sha512-HVQE3AAb/pxF8fQAoiqpvg9i3evqug3hoiwakOyZAwJm+6vZehbkYXZ0l4JxS+I3QxM97v5aaRNhj8v5oBhekw==", - "engines": { - "node": ">=0.10" - } - }, - "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==", - "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==", - "engines": { - "node": ">= 0.8", - "npm": "1.2.8000 || >= 1.4.16" - } - }, - "node_modules/detect-libc": { - "version": "2.0.4", - "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.4.tgz", - "integrity": "sha512-3UDv+G9CsCKO1WKMGw9fwq/SWJYbI0c5Y7LU1AXYoDdbhE2AHQ6N6Nb34sG8Fj7T5APy8qXDCKuuIHd1BR0tVA==", - "engines": { - "node": ">=8" - } - }, - "node_modules/doctrine": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-3.0.0.tgz", - "integrity": "sha512-yS+Q5i3hBf7GBkd4KG8a7eBNNWNGLTaEwwYWUijIYM7zrlYDM0BFXHjjPWlWZ1Rg7UaddZeIDmi9jF3HmqiQ2w==", - "dependencies": { - "esutils": "^2.0.2" - }, - "engines": { - "node": ">=6.0.0" - } - }, - "node_modules/dotenv": { - "version": "16.4.5", - "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.4.5.tgz", - "integrity": "sha512-ZmdL2rui+eB2YwhsWzjInR8LldtZHGDoQ1ugH85ppHKwpUHL7j7rN0Ti9NCnGiQbhaZ11FpR+7ao1dNsmduNUg==", - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://dotenvx.com" - } - }, - "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==" - }, - "node_modules/emoji-regex": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", - "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", - "optional": true - }, - "node_modules/encodeurl": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz", - "integrity": "sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w==", - "engines": { - "node": ">= 0.8" - } - }, - "node_modules/encoding": { - "version": "0.1.13", - "resolved": "https://registry.npmjs.org/encoding/-/encoding-0.1.13.tgz", - "integrity": "sha512-ETBauow1T35Y/WZMkio9jiM0Z5xjHHmJ4XmjZOq1l/dXz3lr2sRn87nJy20RupqSh1F2m3HHPSp8ShIPQJrJ3A==", - "optional": true, - "dependencies": { - "iconv-lite": "^0.6.2" - } - }, - "node_modules/encoding/node_modules/iconv-lite": { - "version": "0.6.3", - "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", - "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", - "optional": true, - "dependencies": { - "safer-buffer": ">= 2.1.2 < 3.0.0" - }, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/end-of-stream": { - "version": "1.4.5", - "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz", - "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==", - "dependencies": { - "once": "^1.4.0" - } - }, - "node_modules/env-paths": { - "version": "2.2.1", - "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz", - "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==", - "optional": true, - "engines": { - "node": ">=6" - } - }, - "node_modules/err-code": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/err-code/-/err-code-2.0.3.tgz", - "integrity": "sha512-2bmlRpNKBxT/CRmPOlyISQpNj+qSeYvcym/uT0Jx2bMOlKLtSy1ZmLuVxSEKKyor/N5yhvp/ZiG1oE3DEYMSFA==", - "optional": true - }, - "node_modules/es-define-property": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.0.tgz", - "integrity": "sha512-jxayLKShrEqqzJ0eumQbVhTYQM27CfT1T35+gCgDFoL82JLsXqTJ76zv6A0YLOgEnLUMvLzsDsGIrl8NFpT2gQ==", - "dependencies": { - "get-intrinsic": "^1.2.4" - }, - "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==", - "engines": { - "node": ">= 0.4" - } - }, - "node_modules/escalade": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.1.2.tgz", - "integrity": "sha512-ErCHMCae19vR8vQGe50xIsVomy19rg6gFu3+r3jkEO46suLMWBksvVyoGgQV+jOfl84ZSOSlmv6Gxa89PmTGmA==", - "engines": { - "node": ">=6" - } - }, - "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==" - }, - "node_modules/escape-string-regexp": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", - "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", - "dev": true, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/eslint": { - "version": "9.0.0", - "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.0.0.tgz", - "integrity": "sha512-IMryZ5SudxzQvuod6rUdIUz29qFItWx281VhtFVc2Psy/ZhlCeD/5DT6lBIJ4H3G+iamGJoTln1v+QSuPw0p7Q==", - "dev": true, - "dependencies": { - "@eslint-community/eslint-utils": "^4.2.0", - "@eslint-community/regexpp": "^4.6.1", - "@eslint/eslintrc": "^3.0.2", - "@eslint/js": "9.0.0", - "@humanwhocodes/config-array": "^0.12.3", - "@humanwhocodes/module-importer": "^1.0.1", - "@nodelib/fs.walk": "^1.2.8", - "ajv": "^6.12.4", - "chalk": "^4.0.0", - "cross-spawn": "^7.0.2", - "debug": "^4.3.2", - "escape-string-regexp": "^4.0.0", - "eslint-scope": "^8.0.1", - "eslint-visitor-keys": "^4.0.0", - "espree": "^10.0.1", - "esquery": "^1.4.2", - "esutils": "^2.0.2", - "fast-deep-equal": "^3.1.3", - "file-entry-cache": "^8.0.0", - "find-up": "^5.0.0", - "glob-parent": "^6.0.2", - "graphemer": "^1.4.0", - "ignore": "^5.2.0", - "imurmurhash": "^0.1.4", - "is-glob": "^4.0.0", - "is-path-inside": "^3.0.3", - "json-stable-stringify-without-jsonify": "^1.0.1", - "levn": "^0.4.1", - "lodash.merge": "^4.6.2", - "minimatch": "^3.1.2", - "natural-compare": "^1.4.0", - "optionator": "^0.9.3", - "strip-ansi": "^6.0.1", - "text-table": "^0.2.0" - }, - "bin": { - "eslint": "bin/eslint.js" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/eslint-scope": { - "version": "8.0.1", - "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.0.1.tgz", - "integrity": "sha512-pL8XjgP4ZOmmwfFE8mEhSxA7ZY4C+LWyqjQ3o4yWkkmD0qcMT9kkW3zWHOczhWcjTSgqycYAgwSlXvZltv65og==", - "dev": true, - "dependencies": { - "esrecurse": "^4.3.0", - "estraverse": "^5.2.0" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/eslint-visitor-keys": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.0.0.tgz", - "integrity": "sha512-OtIRv/2GyiF6o/d8K7MYKKbXrOUBIK6SfkIRM4Z0dY3w+LiQ0vy3F57m0Z71bjbyeiWFiHJ8brqnmE6H6/jEuw==", - "dev": true, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/eslint/node_modules/debug": { - "version": "4.3.4", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz", - "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==", - "dev": true, - "dependencies": { - "ms": "2.1.2" - }, - "engines": { - "node": ">=6.0" - }, - "peerDependenciesMeta": { - "supports-color": { - "optional": true - } - } - }, - "node_modules/eslint/node_modules/ms": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", - "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==", - "dev": true - }, - "node_modules/esm": { - "version": "3.2.25", - "resolved": "https://registry.npmjs.org/esm/-/esm-3.2.25.tgz", - "integrity": "sha512-U1suiZ2oDVWv4zPO56S0NcR5QriEahGtdN2OR6FiOG4WJvcjBVFB0qI4+eKoWFH483PKGuLuu6V8Z4T5g63UVA==", - "engines": { - "node": ">=6" - } - }, - "node_modules/espree": { - "version": "10.0.1", - "resolved": "https://registry.npmjs.org/espree/-/espree-10.0.1.tgz", - "integrity": "sha512-MWkrWZbJsL2UwnjxTX3gG8FneachS/Mwg7tdGXce011sJd5b0JG54vat5KHnfSBODZ3Wvzd2WnjxyzsRoVv+ww==", - "dev": true, - "dependencies": { - "acorn": "^8.11.3", - "acorn-jsx": "^5.3.2", - "eslint-visitor-keys": "^4.0.0" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/esquery": { - "version": "1.5.0", - "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.5.0.tgz", - "integrity": "sha512-YQLXUplAwJgCydQ78IMJywZCceoqk1oH01OERdSAJc/7U2AylwjhSCLDEtqwg811idIS/9fIU5GjG73IgjKMVg==", - "dev": true, - "dependencies": { - "estraverse": "^5.1.0" - }, - "engines": { - "node": ">=0.10" - } - }, - "node_modules/esrecurse": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", - "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", - "dev": true, - "dependencies": { - "estraverse": "^5.2.0" - }, - "engines": { - "node": ">=4.0" - } - }, - "node_modules/estraverse": { - "version": "5.3.0", - "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", - "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", - "dev": true, - "engines": { - "node": ">=4.0" - } - }, - "node_modules/esutils": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", - "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/etag": { - "version": "1.8.1", - "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", - "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/expand-template": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz", - "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==", - "engines": { - "node": ">=6" - } - }, - "node_modules/express": { - "version": "4.19.2", - "resolved": "https://registry.npmjs.org/express/-/express-4.19.2.tgz", - "integrity": "sha512-5T6nhjsT+EOMzuck8JjBHARTHfMht0POzlA60WV2pMD3gyXw2LZnZ+ueGdNxG+0calOJcWKbpFcuzLZ91YWq9Q==", - "dependencies": { - "accepts": "~1.3.8", - "array-flatten": "1.1.1", - "body-parser": "1.20.2", - "content-disposition": "0.5.4", - "content-type": "~1.0.4", - "cookie": "0.6.0", - "cookie-signature": "1.0.6", - "debug": "2.6.9", - "depd": "2.0.0", - "encodeurl": "~1.0.2", - "escape-html": "~1.0.3", - "etag": "~1.8.1", - "finalhandler": "1.2.0", - "fresh": "0.5.2", - "http-errors": "2.0.0", - "merge-descriptors": "1.0.1", - "methods": "~1.1.2", - "on-finished": "2.4.1", - "parseurl": "~1.3.3", - "path-to-regexp": "0.1.7", - "proxy-addr": "~2.0.7", - "qs": "6.11.0", - "range-parser": "~1.2.1", - "safe-buffer": "5.2.1", - "send": "0.18.0", - "serve-static": "1.15.0", - "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" - } - }, - "node_modules/express-list-endpoints": { - "version": "7.1.1", - "resolved": "https://registry.npmjs.org/express-list-endpoints/-/express-list-endpoints-7.1.1.tgz", - "integrity": "sha512-SA6YHH1r6DrioJ4fFJNqiwu1FweGFqJZO9KBApMzwPosoSGPOX2AW0wiMepOXjojjEXDuP9whIvckomheErbJA==", - "engines": { - "node": ">=18" - } - }, - "node_modules/fast-deep-equal": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", - "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", - "dev": true - }, - "node_modules/fast-json-stable-stringify": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", - "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", - "dev": true - }, - "node_modules/fast-levenshtein": { - "version": "2.0.6", - "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", - "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", - "dev": true - }, - "node_modules/fastq": { - "version": "1.17.1", - "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.17.1.tgz", - "integrity": "sha512-sRVD3lWVIXWg6By68ZN7vho9a1pQcN/WBFaAAsDDFzlJjvoGx0P8z7V1t72grFJfJhu3YPZBuu25f7Kaw2jN1w==", - "dev": true, - "dependencies": { - "reusify": "^1.0.4" - } - }, - "node_modules/file-entry-cache": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", - "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==", - "dev": true, - "dependencies": { - "flat-cache": "^4.0.0" - }, - "engines": { - "node": ">=16.0.0" - } - }, - "node_modules/file-uri-to-path": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz", - "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==" - }, - "node_modules/fill-range": { - "version": "7.0.1", - "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.0.1.tgz", - "integrity": "sha512-qOo9F+dMUmC2Lcb4BbVvnKJxTPjCm+RRpe4gDuGrzkL7mEVl/djYSu2OdQ2Pa302N4oqkSg9ir6jaLWJ2USVpQ==", - "dev": true, - "dependencies": { - "to-regex-range": "^5.0.1" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/finalhandler": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.2.0.tgz", - "integrity": "sha512-5uXcUVftlQMFnWC9qu/svkWv3GTd2PfUhK/3PLkYNAe7FbqJMt3515HaxE6eRL74GdsriiwujiawdaB1BpEISg==", - "dependencies": { - "debug": "2.6.9", - "encodeurl": "~1.0.2", - "escape-html": "~1.0.3", - "on-finished": "2.4.1", - "parseurl": "~1.3.3", - "statuses": "2.0.1", - "unpipe": "~1.0.0" - }, - "engines": { - "node": ">= 0.8" - } - }, - "node_modules/find-up": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", - "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", - "dev": true, - "dependencies": { - "locate-path": "^6.0.0", - "path-exists": "^4.0.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/flat-cache": { - "version": "4.0.1", - "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz", - "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==", - "dev": true, - "dependencies": { - "flatted": "^3.2.9", - "keyv": "^4.5.4" - }, - "engines": { - "node": ">=16" - } - }, - "node_modules/flatted": { - "version": "3.3.1", - "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.1.tgz", - "integrity": "sha512-X8cqMLLie7KsNUDSdzeN8FYK9rEt4Dt67OsG/DNGnYTSDBG4uFAJFBnUeiV+zCVAvwFy56IjM9sH51jVaEhNxw==", - "dev": true - }, - "node_modules/forwarded": { - "version": "0.2.0", - "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz", - "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", - "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==", - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/fs-constants": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz", - "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==" - }, - "node_modules/fs-minipass": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/fs-minipass/-/fs-minipass-2.1.0.tgz", - "integrity": "sha512-V/JgOLFCS+R6Vcq0slCuaeWEdNC3ouDlJMNIsacH2VtALiu9mV4LPrHc5cDl8k5aw6J8jwgWWpiTo5RYhmIzvg==", - "dependencies": { - "minipass": "^3.0.0" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/fs.realpath": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", - "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==" - }, - "node_modules/fsevents": { - "version": "2.3.3", - "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", - "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", - "dev": true, - "hasInstallScript": true, - "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==", - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/gauge": { - "version": "4.0.4", - "resolved": "https://registry.npmjs.org/gauge/-/gauge-4.0.4.tgz", - "integrity": "sha512-f9m+BEN5jkg6a0fZjleidjN51VE1X+mPFQ2DJ0uv1V39oCLCbsGe6yjbBnp7eK7z/+GAon99a3nHuqbuuthyPg==", - "deprecated": "This package is no longer supported.", - "optional": true, - "dependencies": { - "aproba": "^1.0.3 || ^2.0.0", - "color-support": "^1.1.3", - "console-control-strings": "^1.1.0", - "has-unicode": "^2.0.1", - "signal-exit": "^3.0.7", - "string-width": "^4.2.3", - "strip-ansi": "^6.0.1", - "wide-align": "^1.1.5" - }, - "engines": { - "node": "^12.13.0 || ^14.15.0 || >=16.0.0" - } - }, - "node_modules/generate-function": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/generate-function/-/generate-function-2.3.1.tgz", - "integrity": "sha512-eeB5GfMNeevm/GRYq20ShmsaGcmI81kIX2K9XQx5miC8KdHaC6Jm0qQ8ZNeGOi7wYB8OsdxKs+Y2oVuTFuVwKQ==", - "dependencies": { - "is-property": "^1.0.2" - } - }, - "node_modules/get-intrinsic": { - "version": "1.2.4", - "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.2.4.tgz", - "integrity": "sha512-5uYhsJH8VJBTv7oslg4BznJYhDoRI6waYCxMmCdnTrcCrHA/fCFKoTFz2JKKE0HdDFUF7/oQuhzumXJK7paBRQ==", - "dependencies": { - "es-errors": "^1.3.0", - "function-bind": "^1.1.2", - "has-proto": "^1.0.1", - "has-symbols": "^1.0.3", - "hasown": "^2.0.0" - }, - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/get-package-type": { - "version": "0.1.0", - "resolved": "https://registry.npmjs.org/get-package-type/-/get-package-type-0.1.0.tgz", - "integrity": "sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==", - "engines": { - "node": ">=8.0.0" - } - }, - "node_modules/getopts": { - "version": "2.3.0", - "resolved": "https://registry.npmjs.org/getopts/-/getopts-2.3.0.tgz", - "integrity": "sha512-5eDf9fuSXwxBL6q5HX+dhDj+dslFGWzU5thZ9kNKUkcPtaPdatmUFKwHFrLb/uf/WpA4BHET+AX3Scl56cAjpA==" - }, - "node_modules/github-from-package": { - "version": "0.0.0", - "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz", - "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==" - }, - "node_modules/glob": { - "version": "7.2.3", - "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", - "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", - "deprecated": "Glob versions prior to v9 are no longer supported", - "optional": true, - "dependencies": { - "fs.realpath": "^1.0.0", - "inflight": "^1.0.4", - "inherits": "2", - "minimatch": "^3.1.1", - "once": "^1.3.0", - "path-is-absolute": "^1.0.0" - }, - "engines": { - "node": "*" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, - "node_modules/glob-parent": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", - "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", - "dev": true, - "dependencies": { - "is-glob": "^4.0.3" - }, - "engines": { - "node": ">=10.13.0" - } - }, - "node_modules/globals": { - "version": "15.0.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-15.0.0.tgz", - "integrity": "sha512-m/C/yR4mjO6pXDTm9/R/SpYTAIyaUB4EOzcaaMEl7mds7Mshct9GfejiJNQGjHHbdMPey13Kpu4TMbYi9ex1pw==", - "dev": true, - "engines": { - "node": ">=18" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/gopd": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.0.1.tgz", - "integrity": "sha512-d65bNlIadxvpb/A2abVdlqKqV563juRnZ1Wtk6s1sIR8uNsXR70xqIzVqxVf1eTqDunwT2MkczEeaezCKTZhwA==", - "dependencies": { - "get-intrinsic": "^1.1.3" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/graceful-fs": { - "version": "4.2.11", - "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", - "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", - "optional": true - }, - "node_modules/graphemer": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz", - "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==", - "dev": true - }, - "node_modules/has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", - "dev": true, - "engines": { - "node": ">=8" - } - }, - "node_modules/has-property-descriptors": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz", - "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==", - "dependencies": { - "es-define-property": "^1.0.0" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/has-proto": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.0.3.tgz", - "integrity": "sha512-SJ1amZAJUiZS+PhsVLf5tGydlaVB8EdFpaSO4gmiUKUOxk8qzn5AIy4ZeJUmh22znIdk/uMAUT2pl3FxzVUH+Q==", - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/has-symbols": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.0.3.tgz", - "integrity": "sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==", - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/has-unicode": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/has-unicode/-/has-unicode-2.0.1.tgz", - "integrity": "sha512-8Rf9Y83NBReMnx0gFzA8JImQACstCYWUplepDa9xprwwtmgEZUF0h/i5xSA625zB/I37EtrswSST6OXxwaaIJQ==", - "optional": true - }, - "node_modules/hasown": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", - "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", - "dependencies": { - "function-bind": "^1.1.2" - }, - "engines": { - "node": ">= 0.4" - } - }, - "node_modules/http-cache-semantics": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz", - "integrity": "sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==", - "optional": true - }, - "node_modules/http-errors": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz", - "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==", - "dependencies": { - "depd": "2.0.0", - "inherits": "2.0.4", - "setprototypeof": "1.2.0", - "statuses": "2.0.1", - "toidentifier": "1.0.1" - }, - "engines": { - "node": ">= 0.8" - } - }, - "node_modules/http-proxy-agent": { - "version": "4.0.1", - "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-4.0.1.tgz", - "integrity": "sha512-k0zdNgqWTGA6aeIRVpvfVob4fL52dTfaehylg0Y4UvSySvOq/Y+BOyPrgpUrA7HylqvU8vIZGsRuXmspskV0Tg==", - "optional": true, - "dependencies": { - "@tootallnate/once": "1", - "agent-base": "6", - "debug": "4" - }, - "engines": { - "node": ">= 6" - } - }, - "node_modules/http-proxy-agent/node_modules/debug": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz", - "integrity": "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==", - "optional": true, - "dependencies": { - "ms": "^2.1.3" - }, - "engines": { - "node": ">=6.0" - }, - "peerDependenciesMeta": { - "supports-color": { - "optional": true - } - } - }, - "node_modules/http-proxy-agent/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==", - "optional": true - }, - "node_modules/https-proxy-agent": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz", - "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==", - "optional": true, - "dependencies": { - "agent-base": "6", - "debug": "4" - }, - "engines": { - "node": ">= 6" - } - }, - "node_modules/https-proxy-agent/node_modules/debug": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz", - "integrity": "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==", - "optional": true, - "dependencies": { - "ms": "^2.1.3" - }, - "engines": { - "node": ">=6.0" - }, - "peerDependenciesMeta": { - "supports-color": { - "optional": true - } - } - }, - "node_modules/https-proxy-agent/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==", - "optional": true - }, - "node_modules/humanize-ms": { - "version": "1.2.1", - "resolved": "https://registry.npmjs.org/humanize-ms/-/humanize-ms-1.2.1.tgz", - "integrity": "sha512-Fl70vYtsAFb/C06PTS9dZBo7ihau+Tu/DNCk/OyHhea07S+aeMWpFFkUaXRa8fI+ScZbEI8dfSxwY7gxZ9SAVQ==", - "optional": true, - "dependencies": { - "ms": "^2.0.0" - } - }, - "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==", - "dependencies": { - "safer-buffer": ">= 2.1.2 < 3" - }, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/ieee754": { - "version": "1.2.1", - "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", - "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ] - }, - "node_modules/ignore": { - "version": "5.3.1", - "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.1.tgz", - "integrity": "sha512-5Fytz/IraMjqpwfd34ke28PTVMjZjJG2MPn5t7OE4eUCUNf8BAa7b5WUS9/Qvr6mwOQS7Mk6vdsMno5he+T8Xw==", - "dev": true, - "engines": { - "node": ">= 4" - } - }, - "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 - }, - "node_modules/import-fresh": { - "version": "3.3.0", - "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.0.tgz", - "integrity": "sha512-veYYhQa+D1QBKznvhUHxb8faxlrwUnxseDAbAp457E0wLNio2bOSKnjYDhMj+YiAq61xrMGhQk9iXVk5FzgQMw==", - "dev": true, - "dependencies": { - "parent-module": "^1.0.0", - "resolve-from": "^4.0.0" - }, - "engines": { - "node": ">=6" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/imurmurhash": { - "version": "0.1.4", - "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", - "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", - "devOptional": true, - "engines": { - "node": ">=0.8.19" - } - }, - "node_modules/indent-string": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-4.0.0.tgz", - "integrity": "sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==", - "optional": true, - "engines": { - "node": ">=8" - } - }, - "node_modules/infer-owner": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/infer-owner/-/infer-owner-1.0.4.tgz", - "integrity": "sha512-IClj+Xz94+d7irH5qRyfJonOdfTzuDaifE6ZPWfx0N0+/ATZCbuTPq2prFl526urkQd90WyUKIh1DfBQ2hMz9A==", - "optional": true - }, - "node_modules/inflight": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", - "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", - "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.", - "dependencies": { - "once": "^1.3.0", - "wrappy": "1" - } - }, - "node_modules/inherits": { - "version": "2.0.4", - "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", - "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==" - }, - "node_modules/ini": { - "version": "1.3.8", - "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz", - "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==" - }, - "node_modules/interpret": { - "version": "2.2.0", - "resolved": "https://registry.npmjs.org/interpret/-/interpret-2.2.0.tgz", - "integrity": "sha512-Ju0Bz/cEia55xDwUWEa8+olFpCiQoypjnQySseKtmjNrnps3P+xfpUmGr90T7yjlVJmOtybRvPXhKMbHr+fWnw==", - "engines": { - "node": ">= 0.10" - } - }, - "node_modules/ip-address": { - "version": "9.0.5", - "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-9.0.5.tgz", - "integrity": "sha512-zHtQzGojZXTwZTHQqra+ETKd4Sn3vgi7uBmlPoXVWZqYvuKmtI0l/VZTjqGmJY9x88GGOaZ9+G9ES8hC4T4X8g==", - "optional": true, - "dependencies": { - "jsbn": "1.1.0", - "sprintf-js": "^1.1.3" - }, - "engines": { - "node": ">= 12" - } - }, - "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==", - "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, - "dependencies": { - "binary-extensions": "^2.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/is-core-module": { - "version": "2.13.1", - "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.13.1.tgz", - "integrity": "sha512-hHrIjvZsftOsvKSn2TRYl63zvxsgE0K+0mYMoH6gD4omR5IWB2KynivBQczo3+wF1cCkjzvptnI9Q0sPU66ilw==", - "dependencies": { - "hasown": "^2.0.0" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "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, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/is-fullwidth-code-point": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", - "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", - "optional": true, - "engines": { - "node": ">=8" - } - }, - "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, - "dependencies": { - "is-extglob": "^2.1.1" - }, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/is-lambda": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/is-lambda/-/is-lambda-1.0.1.tgz", - "integrity": "sha512-z7CMFGNrENq5iFB9Bqo64Xk6Y9sg+epq1myIcdHaGnbMTYOxvzsEtdYqQUylB7LxfkvgrrjP32T6Ywciio9UIQ==", - "optional": true - }, - "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, - "engines": { - "node": ">=0.12.0" - } - }, - "node_modules/is-path-inside": { - "version": "3.0.3", - "resolved": "https://registry.npmjs.org/is-path-inside/-/is-path-inside-3.0.3.tgz", - "integrity": "sha512-Fd4gABb+ycGAmKou8eMftCupSir5lRxqf4aD/vd0cD2qc4HL07OjCeuHMr8Ro4CoMaeCKDB0/ECBOVWjTwUvPQ==", - "dev": true, - "engines": { - "node": ">=8" - } - }, - "node_modules/is-property": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/is-property/-/is-property-1.0.2.tgz", - "integrity": "sha512-Ks/IoX00TtClbGQr4TWXemAnktAQvYB7HzcCxDGqEZU6oCmb2INHuOoKxbtR+HFkmYWBKv/dOZtGRiAjDhj92g==" - }, - "node_modules/isexe": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", - "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", - "devOptional": true - }, - "node_modules/js-yaml": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", - "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", - "dependencies": { - "argparse": "^2.0.1" - }, - "bin": { - "js-yaml": "bin/js-yaml.js" - } - }, - "node_modules/jsbn": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/jsbn/-/jsbn-1.1.0.tgz", - "integrity": "sha512-4bYVV3aAMtDTTu4+xsDYa6sy9GyJ69/amsu9sYF2zqjiEoZA5xJi3BrfX3uY+/IekIu7MwdObdbDWpoZdBv3/A==", - "optional": true - }, - "node_modules/json-buffer": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", - "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", - "dev": true - }, - "node_modules/json-schema-traverse": { - "version": "0.4.1", - "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", - "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", - "dev": true - }, - "node_modules/json-stable-stringify-without-jsonify": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", - "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", - "dev": true - }, - "node_modules/keyv": { - "version": "4.5.4", - "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", - "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", - "dev": true, - "dependencies": { - "json-buffer": "3.0.1" - } - }, - "node_modules/knex": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/knex/-/knex-3.1.0.tgz", - "integrity": "sha512-GLoII6hR0c4ti243gMs5/1Rb3B+AjwMOfjYm97pu0FOQa7JH56hgBxYf5WK2525ceSbBY1cjeZ9yk99GPMB6Kw==", - "dependencies": { - "colorette": "2.0.19", - "commander": "^10.0.0", - "debug": "4.3.4", - "escalade": "^3.1.1", - "esm": "^3.2.25", - "get-package-type": "^0.1.0", - "getopts": "2.3.0", - "interpret": "^2.2.0", - "lodash": "^4.17.21", - "pg-connection-string": "2.6.2", - "rechoir": "^0.8.0", - "resolve-from": "^5.0.0", - "tarn": "^3.0.2", - "tildify": "2.0.0" - }, - "bin": { - "knex": "bin/cli.js" - }, - "engines": { - "node": ">=16" - }, - "peerDependenciesMeta": { - "better-sqlite3": { - "optional": true - }, - "mysql": { - "optional": true - }, - "mysql2": { - "optional": true - }, - "pg": { - "optional": true - }, - "pg-native": { - "optional": true - }, - "sqlite3": { - "optional": true - }, - "tedious": { - "optional": true - } - } - }, - "node_modules/knex/node_modules/debug": { - "version": "4.3.4", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz", - "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==", - "dependencies": { - "ms": "2.1.2" - }, - "engines": { - "node": ">=6.0" - }, - "peerDependenciesMeta": { - "supports-color": { - "optional": true - } - } - }, - "node_modules/knex/node_modules/ms": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", - "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==" - }, - "node_modules/knex/node_modules/resolve-from": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", - "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", - "engines": { - "node": ">=8" - } - }, - "node_modules/levn": { - "version": "0.4.1", - "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", - "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", - "dev": true, - "dependencies": { - "prelude-ls": "^1.2.1", - "type-check": "~0.4.0" - }, - "engines": { - "node": ">= 0.8.0" - } - }, - "node_modules/locate-path": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", - "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", - "dev": true, - "dependencies": { - "p-locate": "^5.0.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/lodash": { - "version": "4.17.21", - "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", - "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==" - }, - "node_modules/lodash.get": { - "version": "4.4.2", - "resolved": "https://registry.npmjs.org/lodash.get/-/lodash.get-4.4.2.tgz", - "integrity": "sha512-z+Uw/vLuy6gQe8cfaFWD7p0wVv8fJl3mbzXh33RS+0oW2wvUqiRXiQ69gLWSLpgB5/6sU+r6BlQR0MBILadqTQ==", - "deprecated": "This package is deprecated. Use the optional chaining (?.) operator instead." - }, - "node_modules/lodash.isequal": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/lodash.isequal/-/lodash.isequal-4.5.0.tgz", - "integrity": "sha512-pDo3lu8Jhfjqls6GkMgpahsF9kCyayhgykjyLMNFTKWrpVdAQtYyB4muAMWozBB4ig/dtWAmsMxLEI8wuz+DYQ==", - "deprecated": "This package is deprecated. Use require('node:util').isDeepStrictEqual instead." - }, - "node_modules/lodash.merge": { - "version": "4.6.2", - "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", - "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", - "dev": true - }, - "node_modules/lodash.mergewith": { - "version": "4.6.2", - "resolved": "https://registry.npmjs.org/lodash.mergewith/-/lodash.mergewith-4.6.2.tgz", - "integrity": "sha512-GK3g5RPZWTRSeLSpgP8Xhra+pnjBC56q9FZYe1d5RN3TJ35dbkGy3YqBSMbyCrlbi+CM9Z3Jk5yTL7RCsqboyQ==" - }, - "node_modules/long": { - "version": "5.2.3", - "resolved": "https://registry.npmjs.org/long/-/long-5.2.3.tgz", - "integrity": "sha512-lcHwpNoggQTObv5apGNCTdJrO69eHOZMi4BNC+rTLER8iHAqGrUVeLh/irVIM7zTw2bOXA8T6uNPeujwOLg/2Q==" - }, - "node_modules/lru-cache": { - "version": "8.0.5", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-8.0.5.tgz", - "integrity": "sha512-MhWWlVnuab1RG5/zMRRcVGXZLCXrZTgfwMikgzCegsPnG62yDQo5JnqKkrK4jO5iKqDAZGItAqN5CtKBCBWRUA==", - "engines": { - "node": ">=16.14" - } - }, - "node_modules/make-fetch-happen": { - "version": "9.1.0", - "resolved": "https://registry.npmjs.org/make-fetch-happen/-/make-fetch-happen-9.1.0.tgz", - "integrity": "sha512-+zopwDy7DNknmwPQplem5lAZX/eCOzSvSNNcSKm5eVwTkOBzoktEfXsa9L23J/GIRhxRsaxzkPEhrJEpE2F4Gg==", - "optional": true, - "dependencies": { - "agentkeepalive": "^4.1.3", - "cacache": "^15.2.0", - "http-cache-semantics": "^4.1.0", - "http-proxy-agent": "^4.0.1", - "https-proxy-agent": "^5.0.0", - "is-lambda": "^1.0.1", - "lru-cache": "^6.0.0", - "minipass": "^3.1.3", - "minipass-collect": "^1.0.2", - "minipass-fetch": "^1.3.2", - "minipass-flush": "^1.0.5", - "minipass-pipeline": "^1.2.4", - "negotiator": "^0.6.2", - "promise-retry": "^2.0.1", - "socks-proxy-agent": "^6.0.0", - "ssri": "^8.0.0" - }, - "engines": { - "node": ">= 10" - } - }, - "node_modules/make-fetch-happen/node_modules/lru-cache": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", - "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", - "optional": true, - "dependencies": { - "yallist": "^4.0.0" - }, - "engines": { - "node": ">=10" - } - }, - "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==", - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/merge-descriptors": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.1.tgz", - "integrity": "sha512-cCi6g3/Zr1iqQi6ySbseM1Xvooa98N0w31jzUYrXPX2xqObmFGHJ0tQ5u74H3mVh7wLouTseZyYIq39g8cNp1w==" - }, - "node_modules/methods": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", - "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", - "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==", - "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==", - "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==", - "dependencies": { - "mime-db": "1.52.0" - }, - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/mimic-response": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz", - "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==", - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/minimatch": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", - "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", - "dependencies": { - "brace-expansion": "^1.1.7" - }, - "engines": { - "node": "*" - } - }, - "node_modules/minimist": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", - "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/minipass": { - "version": "3.3.6", - "resolved": "https://registry.npmjs.org/minipass/-/minipass-3.3.6.tgz", - "integrity": "sha512-DxiNidxSEK+tHG6zOIklvNOwm3hvCrbUrdtzY74U6HKTJxvIDfOUL5W5P2Ghd3DTkhhKPYGqeNUIh5qcM4YBfw==", - "dependencies": { - "yallist": "^4.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/minipass-collect": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/minipass-collect/-/minipass-collect-1.0.2.tgz", - "integrity": "sha512-6T6lH0H8OG9kITm/Jm6tdooIbogG9e0tLgpY6mphXSm/A9u8Nq1ryBG+Qspiub9LjWlBPsPS3tWQ/Botq4FdxA==", - "optional": true, - "dependencies": { - "minipass": "^3.0.0" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/minipass-fetch": { - "version": "1.4.1", - "resolved": "https://registry.npmjs.org/minipass-fetch/-/minipass-fetch-1.4.1.tgz", - "integrity": "sha512-CGH1eblLq26Y15+Azk7ey4xh0J/XfJfrCox5LDJiKqI2Q2iwOLOKrlmIaODiSQS8d18jalF6y2K2ePUm0CmShw==", - "optional": true, - "dependencies": { - "minipass": "^3.1.0", - "minipass-sized": "^1.0.3", - "minizlib": "^2.0.0" - }, - "engines": { - "node": ">=8" - }, - "optionalDependencies": { - "encoding": "^0.1.12" - } - }, - "node_modules/minipass-flush": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/minipass-flush/-/minipass-flush-1.0.5.tgz", - "integrity": "sha512-JmQSYYpPUqX5Jyn1mXaRwOda1uQ8HP5KAT/oDSLCzt1BYRhQU0/hDtsB1ufZfEEzMZ9aAVmsBw8+FWsIXlClWw==", - "optional": true, - "dependencies": { - "minipass": "^3.0.0" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/minipass-pipeline": { - "version": "1.2.4", - "resolved": "https://registry.npmjs.org/minipass-pipeline/-/minipass-pipeline-1.2.4.tgz", - "integrity": "sha512-xuIq7cIOt09RPRJ19gdi4b+RiNvDFYe5JH+ggNvBqGqpQXcru3PcRmOZuHBKWK1Txf9+cQ+HMVN4d6z46LZP7A==", - "optional": true, - "dependencies": { - "minipass": "^3.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/minipass-sized": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/minipass-sized/-/minipass-sized-1.0.3.tgz", - "integrity": "sha512-MbkQQ2CTiBMlA2Dm/5cY+9SWFEN8pzzOXi6rlM5Xxq0Yqbda5ZQy9sU75a673FE9ZK0Zsbr6Y5iP6u9nktfg2g==", - "optional": true, - "dependencies": { - "minipass": "^3.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/minizlib": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/minizlib/-/minizlib-2.1.2.tgz", - "integrity": "sha512-bAxsR8BVfj60DWXHE3u30oHzfl4G7khkSuPW+qvpd7jFRHm7dLxOjUk1EHACJ/hxLY8phGJ0YhYHZo7jil7Qdg==", - "dependencies": { - "minipass": "^3.0.0", - "yallist": "^4.0.0" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/mkdirp": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-1.0.4.tgz", - "integrity": "sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw==", - "bin": { - "mkdirp": "bin/cmd.js" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/mkdirp-classic": { - "version": "0.5.3", - "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz", - "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==" - }, - "node_modules/ms": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", - "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==" - }, - "node_modules/mysql2": { - "version": "3.10.0", - "resolved": "https://registry.npmjs.org/mysql2/-/mysql2-3.10.0.tgz", - "integrity": "sha512-qx0mfWYt1DpTPkw8mAcHW/OwqqyNqBLBHvY5IjN8+icIYTjt6znrgYJ+gxqNNRpVknb5Wc/gcCM4XjbCR0j5tw==", - "dependencies": { - "denque": "^2.1.0", - "generate-function": "^2.3.1", - "iconv-lite": "^0.6.3", - "long": "^5.2.1", - "lru-cache": "^8.0.0", - "named-placeholders": "^1.1.3", - "seq-queue": "^0.0.5", - "sqlstring": "^2.3.2" - }, - "engines": { - "node": ">= 8.0" - } - }, - "node_modules/mysql2/node_modules/iconv-lite": { - "version": "0.6.3", - "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", - "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", - "dependencies": { - "safer-buffer": ">= 2.1.2 < 3.0.0" - }, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/named-placeholders": { - "version": "1.1.3", - "resolved": "https://registry.npmjs.org/named-placeholders/-/named-placeholders-1.1.3.tgz", - "integrity": "sha512-eLoBxg6wE/rZkJPhU/xRX1WTpkFEwDJEN96oxFrTsqBdbT5ec295Q+CoHrL9IT0DipqKhmGcaZmwOt8OON5x1w==", - "dependencies": { - "lru-cache": "^7.14.1" - }, - "engines": { - "node": ">=12.0.0" - } - }, - "node_modules/named-placeholders/node_modules/lru-cache": { - "version": "7.18.3", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-7.18.3.tgz", - "integrity": "sha512-jumlc0BIUrS3qJGgIkWZsyfAM7NCWiBcCDhnd+3NNM5KbBmLTgHVfWBcg6W+rLUsIpzpERPsvwUP7CckAQSOoA==", - "engines": { - "node": ">=12" - } - }, - "node_modules/napi-build-utils": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-2.0.0.tgz", - "integrity": "sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==" - }, - "node_modules/natural-compare": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", - "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", - "dev": true - }, - "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==", - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/node-abi": { - "version": "3.75.0", - "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.75.0.tgz", - "integrity": "sha512-OhYaY5sDsIka7H7AtijtI9jwGYLyl29eQn/W623DiN/MIv5sUqc4g7BIDThX+gb7di9f6xK02nkp8sdfFWZLTg==", - "dependencies": { - "semver": "^7.3.5" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/node-addon-api": { - "version": "7.1.1", - "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-7.1.1.tgz", - "integrity": "sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==" - }, - "node_modules/node-gyp": { - "version": "8.4.1", - "resolved": "https://registry.npmjs.org/node-gyp/-/node-gyp-8.4.1.tgz", - "integrity": "sha512-olTJRgUtAb/hOXG0E93wZDs5YiJlgbXxTwQAFHyNlRsXQnYzUaF2aGgujZbw+hR8aF4ZG/rST57bWMWD16jr9w==", - "optional": true, - "dependencies": { - "env-paths": "^2.2.0", - "glob": "^7.1.4", - "graceful-fs": "^4.2.6", - "make-fetch-happen": "^9.1.0", - "nopt": "^5.0.0", - "npmlog": "^6.0.0", - "rimraf": "^3.0.2", - "semver": "^7.3.5", - "tar": "^6.1.2", - "which": "^2.0.2" - }, - "bin": { - "node-gyp": "bin/node-gyp.js" - }, - "engines": { - "node": ">= 10.12.0" - } - }, - "node_modules/node-gyp/node_modules/nopt": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/nopt/-/nopt-5.0.0.tgz", - "integrity": "sha512-Tbj67rffqceeLpcRXrT7vKAN8CwfPeIBgM7E6iBkmKLV7bEMwpGgYLGv0jACUsECaa/vuxP0IjEont6umdMgtQ==", - "optional": true, - "dependencies": { - "abbrev": "1" - }, - "bin": { - "nopt": "bin/nopt.js" - }, - "engines": { - "node": ">=6" - } - }, - "node_modules/nodemon": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/nodemon/-/nodemon-3.1.0.tgz", - "integrity": "sha512-xqlktYlDMCepBJd43ZQhjWwMw2obW/JRvkrLxq5RCNcuDDX1DbcPT+qT1IlIIdf+DhnWs90JpTMe+Y5KxOchvA==", - "dev": true, - "dependencies": { - "chokidar": "^3.5.2", - "debug": "^4", - "ignore-by-default": "^1.0.1", - "minimatch": "^3.1.2", - "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.3.4", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz", - "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==", - "dev": true, - "dependencies": { - "ms": "2.1.2" - }, - "engines": { - "node": ">=6.0" - }, - "peerDependenciesMeta": { - "supports-color": { - "optional": true - } - } - }, - "node_modules/nodemon/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, - "engines": { - "node": ">=4" - } - }, - "node_modules/nodemon/node_modules/ms": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", - "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==", - "dev": true - }, - "node_modules/nodemon/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, - "dependencies": { - "has-flag": "^3.0.0" - }, - "engines": { - "node": ">=4" - } - }, - "node_modules/nopt": { - "version": "1.0.10", - "resolved": "https://registry.npmjs.org/nopt/-/nopt-1.0.10.tgz", - "integrity": "sha512-NWmpvLSqUrgrAC9HCuxEvb+PSloHpqVu+FqcO4eeF2h5qYRhA7ev6KvelyQAKtegUbC6RypJnlEOhd8vloNKYg==", - "dev": true, - "dependencies": { - "abbrev": "1" - }, - "bin": { - "nopt": "bin/nopt.js" - }, - "engines": { - "node": "*" - } - }, - "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, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/npmlog": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/npmlog/-/npmlog-6.0.2.tgz", - "integrity": "sha512-/vBvz5Jfr9dT/aFWd0FIRf+T/Q2WBsLENygUaFUqstqsycmZAP/t5BvFJTK0viFmSUxiUKTUplWy5vt+rvKIxg==", - "deprecated": "This package is no longer supported.", - "optional": true, - "dependencies": { - "are-we-there-yet": "^3.0.0", - "console-control-strings": "^1.1.0", - "gauge": "^4.0.3", - "set-blocking": "^2.0.0" - }, - "engines": { - "node": "^12.13.0 || ^14.15.0 || >=16.0.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==", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/object-inspect": { - "version": "1.13.1", - "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.1.tgz", - "integrity": "sha512-5qoj1RUiKOMsCCNLV1CBiPYE10sziTsnmNxkAI/rZhiD63CF7IqdFGC/XzjWjpSgLf0LxXX3bDFIh0E18f6UhQ==", - "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==", - "dependencies": { - "ee-first": "1.1.1" - }, - "engines": { - "node": ">= 0.8" - } - }, - "node_modules/once": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", - "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", - "dependencies": { - "wrappy": "1" - } - }, - "node_modules/openapi-types": { - "version": "12.1.3", - "resolved": "https://registry.npmjs.org/openapi-types/-/openapi-types-12.1.3.tgz", - "integrity": "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==", - "peer": true - }, - "node_modules/optionator": { - "version": "0.9.3", - "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.3.tgz", - "integrity": "sha512-JjCoypp+jKn1ttEFExxhetCKeJt9zhAgAve5FXHixTvFDW/5aEktX9bufBKLRRMdU7bNtpLfcGu94B3cdEJgjg==", - "dev": true, - "dependencies": { - "@aashutoshrathi/word-wrap": "^1.2.3", - "deep-is": "^0.1.3", - "fast-levenshtein": "^2.0.6", - "levn": "^0.4.1", - "prelude-ls": "^1.2.1", - "type-check": "^0.4.0" - }, - "engines": { - "node": ">= 0.8.0" - } - }, - "node_modules/p-limit": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", - "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", - "dev": true, - "dependencies": { - "yocto-queue": "^0.1.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/p-locate": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", - "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", - "dev": true, - "dependencies": { - "p-limit": "^3.0.2" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/p-map": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/p-map/-/p-map-4.0.0.tgz", - "integrity": "sha512-/bjOqmgETBYB5BoEeGVea8dmvHb2m9GLy1E9W43yeyfP6QQCZGFNa+XRceJEuDB6zqr+gKpIAmlLebMpykw/MQ==", - "optional": true, - "dependencies": { - "aggregate-error": "^3.0.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/parent-module": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", - "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", - "dev": true, - "dependencies": { - "callsites": "^3.0.0" - }, - "engines": { - "node": ">=6" - } - }, - "node_modules/parseurl": { - "version": "1.3.3", - "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", - "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", - "engines": { - "node": ">= 0.8" - } - }, - "node_modules/path-exists": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", - "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", - "dev": true, - "engines": { - "node": ">=8" - } - }, - "node_modules/path-is-absolute": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", - "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/path-key": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", - "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", - "dev": true, - "engines": { - "node": ">=8" - } - }, - "node_modules/path-parse": { - "version": "1.0.7", - "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz", - "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==" - }, - "node_modules/path-to-regexp": { - "version": "0.1.7", - "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.7.tgz", - "integrity": "sha512-5DFkuoqlv1uYQKxy8omFBeJPQcdoE07Kv2sferDCrAq1ohOU+MSDswDIbnx3YAM60qIOnYa53wBhXW0EbMonrQ==" - }, - "node_modules/pg": { - "version": "8.11.5", - "resolved": "https://registry.npmjs.org/pg/-/pg-8.11.5.tgz", - "integrity": "sha512-jqgNHSKL5cbDjFlHyYsCXmQDrfIX/3RsNwYqpd4N0Kt8niLuNoRNH+aazv6cOd43gPh9Y4DjQCtb+X0MH0Hvnw==", - "dependencies": { - "pg-connection-string": "^2.6.4", - "pg-pool": "^3.6.2", - "pg-protocol": "^1.6.1", - "pg-types": "^2.1.0", - "pgpass": "1.x" - }, - "engines": { - "node": ">= 8.0.0" - }, - "optionalDependencies": { - "pg-cloudflare": "^1.1.1" - }, - "peerDependencies": { - "pg-native": ">=3.0.1" - }, - "peerDependenciesMeta": { - "pg-native": { - "optional": true - } - } - }, - "node_modules/pg-cloudflare": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.1.1.tgz", - "integrity": "sha512-xWPagP/4B6BgFO+EKz3JONXv3YDgvkbVrGw2mTo3D6tVDQRh1e7cqVGvyR3BE+eQgAvx1XhW/iEASj4/jCWl3Q==", - "optional": true - }, - "node_modules/pg-connection-string": { - "version": "2.6.2", - "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.6.2.tgz", - "integrity": "sha512-ch6OwaeaPYcova4kKZ15sbJ2hKb/VP48ZD2gE7i1J+L4MspCtBMAx8nMgz7bksc7IojCIIWuEhHibSMFH8m8oA==" - }, - "node_modules/pg-int8": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/pg-int8/-/pg-int8-1.0.1.tgz", - "integrity": "sha512-WCtabS6t3c8SkpDBUlb1kjOs7l66xsGdKpIPZsg4wR+B3+u9UAum2odSsF9tnvxg80h4ZxLWMy4pRjOsFIqQpw==", - "engines": { - "node": ">=4.0.0" - } - }, - "node_modules/pg-pool": { - "version": "3.6.2", - "resolved": "https://registry.npmjs.org/pg-pool/-/pg-pool-3.6.2.tgz", - "integrity": "sha512-Htjbg8BlwXqSBQ9V8Vjtc+vzf/6fVUuak/3/XXKA9oxZprwW3IMDQTGHP+KDmVL7rtd+R1QjbnCFPuTHm3G4hg==", - "peerDependencies": { - "pg": ">=8.0" - } - }, - "node_modules/pg-protocol": { - "version": "1.6.1", - "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.6.1.tgz", - "integrity": "sha512-jPIlvgoD63hrEuihvIg+tJhoGjUsLPn6poJY9N5CnlPd91c2T18T/9zBtLxZSb1EhYxBRoZJtzScCaWlYLtktg==" - }, - "node_modules/pg-types": { - "version": "2.2.0", - "resolved": "https://registry.npmjs.org/pg-types/-/pg-types-2.2.0.tgz", - "integrity": "sha512-qTAAlrEsl8s4OiEQY69wDvcMIdQN6wdz5ojQiOy6YRMuynxenON0O5oCpJI6lshc6scgAY8qvJ2On/p+CXY0GA==", - "dependencies": { - "pg-int8": "1.0.1", - "postgres-array": "~2.0.0", - "postgres-bytea": "~1.0.0", - "postgres-date": "~1.0.4", - "postgres-interval": "^1.1.0" - }, - "engines": { - "node": ">=4" - } - }, - "node_modules/pg/node_modules/pg-connection-string": { - "version": "2.6.4", - "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.6.4.tgz", - "integrity": "sha512-v+Z7W/0EO707aNMaAEfiGnGL9sxxumwLl2fJvCQtMn9Fxsg+lPpPkdcyBSv/KFgpGdYkMfn+EI1Or2EHjpgLCA==" - }, - "node_modules/pgpass": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/pgpass/-/pgpass-1.0.5.tgz", - "integrity": "sha512-FdW9r/jQZhSeohs1Z3sI1yxFQNFvMcnmfuj4WBMUTxOrAyLMaTcE1aAMBiTlbMNaXvBCQuVi0R7hd8udDSP7ug==", - "dependencies": { - "split2": "^4.1.0" - } - }, - "node_modules/picomatch": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", - "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", - "dev": true, - "engines": { - "node": ">=8.6" - }, - "funding": { - "url": "https://github.com/sponsors/jonschlinkert" - } - }, - "node_modules/postgres-array": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/postgres-array/-/postgres-array-2.0.0.tgz", - "integrity": "sha512-VpZrUqU5A69eQyW2c5CA1jtLecCsN2U/bD6VilrFDWq5+5UIEVO7nazS3TEcHf1zuPYO/sqGvUvW62g86RXZuA==", - "engines": { - "node": ">=4" - } - }, - "node_modules/postgres-bytea": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/postgres-bytea/-/postgres-bytea-1.0.0.tgz", - "integrity": "sha512-xy3pmLuQqRBZBXDULy7KbaitYqLcmxigw14Q5sj8QBVLqEwXfeybIKVWiqAXTlcvdvb0+xkOtDbfQMOf4lST1w==", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/postgres-date": { - "version": "1.0.7", - "resolved": "https://registry.npmjs.org/postgres-date/-/postgres-date-1.0.7.tgz", - "integrity": "sha512-suDmjLVQg78nMK2UZ454hAG+OAW+HQPZ6n++TNDUX+L0+uUlLywnoxJKDou51Zm+zTCjrCl0Nq6J9C5hP9vK/Q==", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/postgres-interval": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/postgres-interval/-/postgres-interval-1.2.0.tgz", - "integrity": "sha512-9ZhXKM/rw350N1ovuWHbGxnGh/SNJ4cnxHiM0rxE4VN41wsg8P8zWn9hv/buK00RP4WvlOyr/RBDiptyxVbkZQ==", - "dependencies": { - "xtend": "^4.0.0" - }, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/prebuild-install": { - "version": "7.1.3", - "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.3.tgz", - "integrity": "sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug==", - "dependencies": { - "detect-libc": "^2.0.0", - "expand-template": "^2.0.3", - "github-from-package": "0.0.0", - "minimist": "^1.2.3", - "mkdirp-classic": "^0.5.3", - "napi-build-utils": "^2.0.0", - "node-abi": "^3.3.0", - "pump": "^3.0.0", - "rc": "^1.2.7", - "simple-get": "^4.0.0", - "tar-fs": "^2.0.0", - "tunnel-agent": "^0.6.0" - }, - "bin": { - "prebuild-install": "bin.js" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/prelude-ls": { - "version": "1.2.1", - "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", - "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", - "dev": true, - "engines": { - "node": ">= 0.8.0" - } - }, - "node_modules/prettier": { - "version": "3.2.5", - "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.2.5.tgz", - "integrity": "sha512-3/GWa9aOC0YeD7LUfvOG2NiDyhOWRvt1k+rcKhOuYnMY24iiCphgneUfJDyFXd6rZCAnuLBv6UeAULtrhT/F4A==", - "dev": true, - "bin": { - "prettier": "bin/prettier.cjs" - }, - "engines": { - "node": ">=14" - }, - "funding": { - "url": "https://github.com/prettier/prettier?sponsor=1" - } - }, - "node_modules/promise-inflight": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/promise-inflight/-/promise-inflight-1.0.1.tgz", - "integrity": "sha512-6zWPyEOFaQBJYcGMHBKTKJ3u6TBsnMFOIZSa6ce1e/ZrrsOlnHRHbabMjLiBYKp+n44X9eUI6VUPaukCXHuG4g==", - "optional": true - }, - "node_modules/promise-retry": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/promise-retry/-/promise-retry-2.0.1.tgz", - "integrity": "sha512-y+WKFlBR8BGXnsNlIHFGPZmyDf3DFMoLhaflAnyZgV6rG6xu+JwesTo2Q9R6XwYmtmwAFCkAk3e35jEdoeh/3g==", - "optional": true, - "dependencies": { - "err-code": "^2.0.2", - "retry": "^0.12.0" - }, - "engines": { - "node": ">=10" - } - }, - "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==", - "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 - }, - "node_modules/pump": { - "version": "3.0.3", - "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.3.tgz", - "integrity": "sha512-todwxLMY7/heScKmntwQG8CXVkWUOdYxIvY2s0VWAAMh/nd8SoYiRaKjlr7+iCs984f2P8zvrfWcDDYVb73NfA==", - "dependencies": { - "end-of-stream": "^1.1.0", - "once": "^1.3.1" - } - }, - "node_modules/punycode": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", - "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", - "dev": true, - "engines": { - "node": ">=6" - } - }, - "node_modules/qs": { - "version": "6.11.0", - "resolved": "https://registry.npmjs.org/qs/-/qs-6.11.0.tgz", - "integrity": "sha512-MvjoMCJwEarSbUYk5O+nmoSzSutSsTwF85zcHPQ9OrlFoZOYIjaqBAJIqIXjptyD5vThxGq52Xu/MaJzRkIk4Q==", - "dependencies": { - "side-channel": "^1.0.4" - }, - "engines": { - "node": ">=0.6" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/queue-microtask": { - "version": "1.2.3", - "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", - "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", - "dev": true, - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ] - }, - "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==", - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/raw-body": { - "version": "2.5.2", - "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz", - "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==", - "dependencies": { - "bytes": "3.1.2", - "http-errors": "2.0.0", - "iconv-lite": "0.4.24", - "unpipe": "1.0.0" - }, - "engines": { - "node": ">= 0.8" - } - }, - "node_modules/rc": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz", - "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==", - "dependencies": { - "deep-extend": "^0.6.0", - "ini": "~1.3.0", - "minimist": "^1.2.0", - "strip-json-comments": "~2.0.1" - }, - "bin": { - "rc": "cli.js" - } - }, - "node_modules/rc/node_modules/strip-json-comments": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz", - "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/readable-stream": { - "version": "3.6.2", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", - "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", - "dependencies": { - "inherits": "^2.0.3", - "string_decoder": "^1.1.1", - "util-deprecate": "^1.0.1" - }, - "engines": { - "node": ">= 6" - } - }, - "node_modules/readdirp": { - "version": "3.6.0", - "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz", - "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==", - "dev": true, - "dependencies": { - "picomatch": "^2.2.1" - }, - "engines": { - "node": ">=8.10.0" - } - }, - "node_modules/rechoir": { - "version": "0.8.0", - "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.8.0.tgz", - "integrity": "sha512-/vxpCXddiX8NGfGO/mTafwjq4aFa/71pvamip0++IQk3zG8cbCj0fifNPrjjF1XMXUne91jL9OoxmdykoEtifQ==", - "dependencies": { - "resolve": "^1.20.0" - }, - "engines": { - "node": ">= 10.13.0" - } - }, - "node_modules/resolve": { - "version": "1.22.8", - "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.8.tgz", - "integrity": "sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw==", - "dependencies": { - "is-core-module": "^2.13.0", - "path-parse": "^1.0.7", - "supports-preserve-symlinks-flag": "^1.0.0" - }, - "bin": { - "resolve": "bin/resolve" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/resolve-from": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", - "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", - "dev": true, - "engines": { - "node": ">=4" - } - }, - "node_modules/retry": { - "version": "0.12.0", - "resolved": "https://registry.npmjs.org/retry/-/retry-0.12.0.tgz", - "integrity": "sha512-9LkiTwjUh6rT555DtE9rTX+BKByPfrMzEAtnlEtdEwr3Nkffwiihqe2bWADg+OQRjt9gl6ICdmB/ZFDCGAtSow==", - "optional": true, - "engines": { - "node": ">= 4" - } - }, - "node_modules/reusify": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.0.4.tgz", - "integrity": "sha512-U9nH88a3fc/ekCF1l0/UP1IosiuIjyTh7hBvXVMHYgVcfGvt897Xguj2UOLDeI5BG2m7/uwyaLVT6fbtCwTyzw==", - "dev": true, - "engines": { - "iojs": ">=1.0.0", - "node": ">=0.10.0" - } - }, - "node_modules/rimraf": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz", - "integrity": "sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==", - "deprecated": "Rimraf versions prior to v4 are no longer supported", - "optional": true, - "dependencies": { - "glob": "^7.1.3" - }, - "bin": { - "rimraf": "bin.js" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, - "node_modules/run-parallel": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", - "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", - "dev": true, - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ], - "dependencies": { - "queue-microtask": "^1.2.2" - } - }, - "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" - } - ] - }, - "node_modules/safer-buffer": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", - "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==" - }, - "node_modules/semver": { - "version": "7.6.0", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.0.tgz", - "integrity": "sha512-EnwXhrlwXMk9gKu5/flx5sv/an57AkRplG3hTK68W7FRDN+k+OWBj65M7719OkA82XLBxrcX0KSHj+X5COhOVg==", - "dependencies": { - "lru-cache": "^6.0.0" - }, - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/semver/node_modules/lru-cache": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", - "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", - "dependencies": { - "yallist": "^4.0.0" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/send": { - "version": "0.18.0", - "resolved": "https://registry.npmjs.org/send/-/send-0.18.0.tgz", - "integrity": "sha512-qqWzuOjSFOuqPjFe4NOsMLafToQQwBSOEpS+FwEt3A2V3vKubTquT3vmLTQpFgMXp8AlFWFuP1qKaJZOtPpVXg==", - "dependencies": { - "debug": "2.6.9", - "depd": "2.0.0", - "destroy": "1.2.0", - "encodeurl": "~1.0.2", - "escape-html": "~1.0.3", - "etag": "~1.8.1", - "fresh": "0.5.2", - "http-errors": "2.0.0", - "mime": "1.6.0", - "ms": "2.1.3", - "on-finished": "2.4.1", - "range-parser": "~1.2.1", - "statuses": "2.0.1" - }, - "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==" - }, - "node_modules/seq-queue": { - "version": "0.0.5", - "resolved": "https://registry.npmjs.org/seq-queue/-/seq-queue-0.0.5.tgz", - "integrity": "sha512-hr3Wtp/GZIc/6DAGPDcV4/9WoZhjrkXsi5B/07QgX8tsdc6ilr7BFM6PM6rbdAX1kFSDYeZGLipIZZKyQP0O5Q==" - }, - "node_modules/serve-static": { - "version": "1.15.0", - "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.15.0.tgz", - "integrity": "sha512-XGuRDNjXUijsUL0vl6nSD7cwURuzEgglbOaFuZM9g3kwDXOWVTck0jLzjPzGD+TazWbboZYu52/9/XPdUgne9g==", - "dependencies": { - "encodeurl": "~1.0.2", - "escape-html": "~1.0.3", - "parseurl": "~1.3.3", - "send": "0.18.0" - }, - "engines": { - "node": ">= 0.8.0" - } - }, - "node_modules/set-blocking": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/set-blocking/-/set-blocking-2.0.0.tgz", - "integrity": "sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw==", - "optional": true - }, - "node_modules/set-function-length": { - "version": "1.2.2", - "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz", - "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==", - "dependencies": { - "define-data-property": "^1.1.4", - "es-errors": "^1.3.0", - "function-bind": "^1.1.2", - "get-intrinsic": "^1.2.4", - "gopd": "^1.0.1", - "has-property-descriptors": "^1.0.2" - }, - "engines": { - "node": ">= 0.4" - } - }, - "node_modules/setprototypeof": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", - "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==" - }, - "node_modules/shebang-command": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", - "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", - "dev": true, - "dependencies": { - "shebang-regex": "^3.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/shebang-regex": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", - "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", - "dev": true, - "engines": { - "node": ">=8" - } - }, - "node_modules/side-channel": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.0.6.tgz", - "integrity": "sha512-fDW/EZ6Q9RiO8eFG8Hj+7u/oW+XrPTIChwCOM2+th2A6OblDtYYIpve9m+KvI9Z4C9qSEXlaGR6bTEYHReuglA==", - "dependencies": { - "call-bind": "^1.0.7", - "es-errors": "^1.3.0", - "get-intrinsic": "^1.2.4", - "object-inspect": "^1.13.1" - }, - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/signal-exit": { - "version": "3.0.7", - "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz", - "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", - "optional": true - }, - "node_modules/simple-concat": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz", - "integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==", - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ] - }, - "node_modules/simple-get": { - "version": "4.0.1", - "resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz", - "integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==", - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ], - "dependencies": { - "decompress-response": "^6.0.0", - "once": "^1.3.1", - "simple-concat": "^1.0.0" - } - }, - "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, - "dependencies": { - "semver": "^7.5.3" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/smart-buffer": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/smart-buffer/-/smart-buffer-4.2.0.tgz", - "integrity": "sha512-94hK0Hh8rPqQl2xXc3HsaBoOXKV20MToPkcXvwbISWLEs+64sBq5kFgn2kJDHb1Pry9yrP0dxrCI9RRci7RXKg==", - "optional": true, - "engines": { - "node": ">= 6.0.0", - "npm": ">= 3.0.0" - } - }, - "node_modules/socks": { - "version": "2.8.5", - "resolved": "https://registry.npmjs.org/socks/-/socks-2.8.5.tgz", - "integrity": "sha512-iF+tNDQla22geJdTyJB1wM/qrX9DMRwWrciEPwWLPRWAUEM8sQiyxgckLxWT1f7+9VabJS0jTGGr4QgBuvi6Ww==", - "optional": true, - "dependencies": { - "ip-address": "^9.0.5", - "smart-buffer": "^4.2.0" - }, - "engines": { - "node": ">= 10.0.0", - "npm": ">= 3.0.0" - } - }, - "node_modules/socks-proxy-agent": { - "version": "6.2.1", - "resolved": "https://registry.npmjs.org/socks-proxy-agent/-/socks-proxy-agent-6.2.1.tgz", - "integrity": "sha512-a6KW9G+6B3nWZ1yB8G7pJwL3ggLy1uTzKAgCb7ttblwqdz9fMGJUuTy3uFzEP48FAs9FLILlmzDlE2JJhVQaXQ==", - "optional": true, - "dependencies": { - "agent-base": "^6.0.2", - "debug": "^4.3.3", - "socks": "^2.6.2" - }, - "engines": { - "node": ">= 10" - } - }, - "node_modules/socks-proxy-agent/node_modules/debug": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz", - "integrity": "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==", - "optional": true, - "dependencies": { - "ms": "^2.1.3" - }, - "engines": { - "node": ">=6.0" - }, - "peerDependenciesMeta": { - "supports-color": { - "optional": true - } - } - }, - "node_modules/socks-proxy-agent/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==", - "optional": true - }, - "node_modules/split2": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz", - "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==", - "engines": { - "node": ">= 10.x" - } - }, - "node_modules/sprintf-js": { - "version": "1.1.3", - "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.3.tgz", - "integrity": "sha512-Oo+0REFV59/rz3gfJNKQiBlwfHaSESl1pcGyABQsnnIfWOFt6JNj5gCog2U6MLZ//IGYD+nA8nI+mTShREReaA==", - "optional": true - }, - "node_modules/sqlite3": { - "version": "5.1.7", - "resolved": "https://registry.npmjs.org/sqlite3/-/sqlite3-5.1.7.tgz", - "integrity": "sha512-GGIyOiFaG+TUra3JIfkI/zGP8yZYLPQ0pl1bH+ODjiX57sPhrLU5sQJn1y9bDKZUFYkX1crlrPfSYt0BKKdkog==", - "hasInstallScript": true, - "dependencies": { - "bindings": "^1.5.0", - "node-addon-api": "^7.0.0", - "prebuild-install": "^7.1.1", - "tar": "^6.1.11" - }, - "optionalDependencies": { - "node-gyp": "8.x" - }, - "peerDependencies": { - "node-gyp": "8.x" - }, - "peerDependenciesMeta": { - "node-gyp": { - "optional": true - } - } - }, - "node_modules/sqlstring": { - "version": "2.3.3", - "resolved": "https://registry.npmjs.org/sqlstring/-/sqlstring-2.3.3.tgz", - "integrity": "sha512-qC9iz2FlN7DQl3+wjwn3802RTyjCx7sDvfQEXchwa6CWOx07/WVfh91gBmQ9fahw8snwGEWU3xGzOt4tFyHLxg==", - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/ssri": { - "version": "8.0.1", - "resolved": "https://registry.npmjs.org/ssri/-/ssri-8.0.1.tgz", - "integrity": "sha512-97qShzy1AiyxvPNIkLWoGua7xoQzzPjQ0HAH4B0rWKo7SZ6USuPcrUiAFrws0UH8RrbWmgq3LMTObhPIHbbBeQ==", - "optional": true, - "dependencies": { - "minipass": "^3.1.1" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/statuses": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz", - "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==", - "engines": { - "node": ">= 0.8" - } - }, - "node_modules/string_decoder": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", - "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", - "dependencies": { - "safe-buffer": "~5.2.0" - } - }, - "node_modules/string-width": { - "version": "4.2.3", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", - "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", - "optional": true, - "dependencies": { - "emoji-regex": "^8.0.0", - "is-fullwidth-code-point": "^3.0.0", - "strip-ansi": "^6.0.1" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/strip-ansi": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", - "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "devOptional": true, - "dependencies": { - "ansi-regex": "^5.0.1" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/strip-json-comments": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", - "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", - "dev": true, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", - "dev": true, - "dependencies": { - "has-flag": "^4.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/supports-preserve-symlinks-flag": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz", - "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==", - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/swagger-jsdoc": { - "version": "6.2.8", - "resolved": "https://registry.npmjs.org/swagger-jsdoc/-/swagger-jsdoc-6.2.8.tgz", - "integrity": "sha512-VPvil1+JRpmJ55CgAtn8DIcpBs0bL5L3q5bVQvF4tAW/k/9JYSj7dCpaYCAv5rufe0vcCbBRQXGvzpkWjvLklQ==", - "dependencies": { - "commander": "6.2.0", - "doctrine": "3.0.0", - "glob": "7.1.6", - "lodash.mergewith": "^4.6.2", - "swagger-parser": "^10.0.3", - "yaml": "2.0.0-1" - }, - "bin": { - "swagger-jsdoc": "bin/swagger-jsdoc.js" - }, - "engines": { - "node": ">=12.0.0" - } - }, - "node_modules/swagger-jsdoc/node_modules/commander": { - "version": "6.2.0", - "resolved": "https://registry.npmjs.org/commander/-/commander-6.2.0.tgz", - "integrity": "sha512-zP4jEKbe8SHzKJYQmq8Y9gYjtO/POJLgIdKgV7B9qNmABVFVc+ctqSX6iXh4mCpJfRBOabiZ2YKPg8ciDw6C+Q==", - "engines": { - "node": ">= 6" - } - }, - "node_modules/swagger-jsdoc/node_modules/glob": { - "version": "7.1.6", - "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.6.tgz", - "integrity": "sha512-LwaxwyZ72Lk7vZINtNNrywX0ZuLyStrdDtabefZKAY5ZGJhVtgdznluResxNmPitE0SAO+O26sWTHeKSI2wMBA==", - "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me", - "dependencies": { - "fs.realpath": "^1.0.0", - "inflight": "^1.0.4", - "inherits": "2", - "minimatch": "^3.0.4", - "once": "^1.3.0", - "path-is-absolute": "^1.0.0" - }, - "engines": { - "node": "*" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, - "node_modules/swagger-parser": { - "version": "10.0.3", - "resolved": "https://registry.npmjs.org/swagger-parser/-/swagger-parser-10.0.3.tgz", - "integrity": "sha512-nF7oMeL4KypldrQhac8RyHerJeGPD1p2xDh900GPvc+Nk7nWP6jX2FcC7WmkinMoAmoO774+AFXcWsW8gMWEIg==", - "dependencies": { - "@apidevtools/swagger-parser": "10.0.3" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/swagger-ui-dist": { - "version": "5.32.0", - "resolved": "https://registry.npmjs.org/swagger-ui-dist/-/swagger-ui-dist-5.32.0.tgz", - "integrity": "sha512-nKZB0OuDvacB0s/lC2gbge+RigYvGRGpLLMWMFxaTUwfM+CfndVk9Th2IaTinqXiz6Mn26GK2zriCpv6/+5m3Q==", - "dependencies": { - "@scarf/scarf": "=1.4.0" - } - }, - "node_modules/swagger-ui-express": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/swagger-ui-express/-/swagger-ui-express-5.0.1.tgz", - "integrity": "sha512-SrNU3RiBGTLLmFU8GIJdOdanJTl4TOmT27tt3bWWHppqYmAZ6IDuEuBvMU6nZq0zLEe6b/1rACXCgLZqO6ZfrA==", - "dependencies": { - "swagger-ui-dist": ">=5.0.0" - }, - "engines": { - "node": ">= v0.10.32" - }, - "peerDependencies": { - "express": ">=4.0.0 || >=5.0.0-beta" - } - }, - "node_modules/tar": { - "version": "6.2.1", - "resolved": "https://registry.npmjs.org/tar/-/tar-6.2.1.tgz", - "integrity": "sha512-DZ4yORTwrbTj/7MZYq2w+/ZFdI6OZ/f9SFHR+71gIVUZhOQPHzVCLpvRnPgyaMpfWxxk/4ONva3GQSyNIKRv6A==", - "dependencies": { - "chownr": "^2.0.0", - "fs-minipass": "^2.0.0", - "minipass": "^5.0.0", - "minizlib": "^2.1.1", - "mkdirp": "^1.0.3", - "yallist": "^4.0.0" - }, - "engines": { - "node": ">=10" - } - }, - "node_modules/tar-fs": { - "version": "2.1.3", - "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.3.tgz", - "integrity": "sha512-090nwYJDmlhwFwEW3QQl+vaNnxsO2yVsd45eTKRBzSzu+hlb1w2K9inVq5b0ngXuLVqQ4ApvsUHHnu/zQNkWAg==", - "dependencies": { - "chownr": "^1.1.1", - "mkdirp-classic": "^0.5.2", - "pump": "^3.0.0", - "tar-stream": "^2.1.4" - } - }, - "node_modules/tar-fs/node_modules/chownr": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz", - "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==" - }, - "node_modules/tar-stream": { - "version": "2.2.0", - "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-2.2.0.tgz", - "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==", - "dependencies": { - "bl": "^4.0.3", - "end-of-stream": "^1.4.1", - "fs-constants": "^1.0.0", - "inherits": "^2.0.3", - "readable-stream": "^3.1.1" - }, - "engines": { - "node": ">=6" - } - }, - "node_modules/tar/node_modules/minipass": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/minipass/-/minipass-5.0.0.tgz", - "integrity": "sha512-3FnjYuehv9k6ovOEbyOswadCDPX1piCfhV8ncmYtHOjuPwylVWsghTLo7rabjC3Rx5xD4HDx8Wm1xnMF7S5qFQ==", - "engines": { - "node": ">=8" - } - }, - "node_modules/tarn": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/tarn/-/tarn-3.0.2.tgz", - "integrity": "sha512-51LAVKUSZSVfI05vjPESNc5vwqqZpbXCsU+/+wxlOrUjk2SnFTt97v9ZgQrD4YmxYW1Px6w2KjaDitCfkvgxMQ==", - "engines": { - "node": ">=8.0.0" - } - }, - "node_modules/text-table": { - "version": "0.2.0", - "resolved": "https://registry.npmjs.org/text-table/-/text-table-0.2.0.tgz", - "integrity": "sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw==", - "dev": true - }, - "node_modules/tildify": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/tildify/-/tildify-2.0.0.tgz", - "integrity": "sha512-Cc+OraorugtXNfs50hU9KS369rFXCfgGLpfCfvlc+Ud5u6VWmUQsOAa9HbTvheQdYnrdJqqv1e5oIqXppMYnSw==", - "engines": { - "node": ">=8" - } - }, - "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, - "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==", - "engines": { - "node": ">=0.6" - } - }, - "node_modules/touch": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/touch/-/touch-3.1.0.tgz", - "integrity": "sha512-WBx8Uy5TLtOSRtIq+M03/sKDrXCLHxwDcquSP2c43Le03/9serjQBIztjRz6FkJez9D/hleyAXTBGLwwZUw9lA==", - "dev": true, - "dependencies": { - "nopt": "~1.0.10" - }, - "bin": { - "nodetouch": "bin/nodetouch.js" - } - }, - "node_modules/tunnel-agent": { - "version": "0.6.0", - "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", - "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==", - "dependencies": { - "safe-buffer": "^5.0.1" - }, - "engines": { - "node": "*" - } - }, - "node_modules/type-check": { - "version": "0.4.0", - "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", - "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", - "dev": true, - "dependencies": { - "prelude-ls": "^1.2.1" - }, - "engines": { - "node": ">= 0.8.0" - } - }, - "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==", - "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 - }, - "node_modules/unique-filename": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/unique-filename/-/unique-filename-1.1.1.tgz", - "integrity": "sha512-Vmp0jIp2ln35UTXuryvjzkjGdRyf9b2lTXuSYUiPmzRcl3FDtYqAwOnTJkAngD9SWhnoJzDbTKwaOrZ+STtxNQ==", - "optional": true, - "dependencies": { - "unique-slug": "^2.0.0" - } - }, - "node_modules/unique-slug": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/unique-slug/-/unique-slug-2.0.2.tgz", - "integrity": "sha512-zoWr9ObaxALD3DOPfjPSqxt4fnZiWblxHIgeWqW8x7UqDzEtHEQLzji2cuJYQFCU6KmoJikOYAZlrTHHebjx2w==", - "optional": true, - "dependencies": { - "imurmurhash": "^0.1.4" - } - }, - "node_modules/unpipe": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz", - "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==", - "engines": { - "node": ">= 0.8" - } - }, - "node_modules/uri-js": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", - "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", - "dev": true, - "dependencies": { - "punycode": "^2.1.0" - } - }, - "node_modules/util-deprecate": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", - "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==" - }, - "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==", - "engines": { - "node": ">= 0.4.0" - } - }, - "node_modules/validator": { - "version": "13.15.26", - "resolved": "https://registry.npmjs.org/validator/-/validator-13.15.26.tgz", - "integrity": "sha512-spH26xU080ydGggxRyR1Yhcbgx+j3y5jbNXk/8L+iRvdIEQ4uTRH2Sgf2dokud6Q4oAtsbNvJ1Ft+9xmm6IZcA==", - "engines": { - "node": ">= 0.10" - } - }, - "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==", - "engines": { - "node": ">= 0.8" - } - }, - "node_modules/which": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", - "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", - "devOptional": true, - "dependencies": { - "isexe": "^2.0.0" - }, - "bin": { - "node-which": "bin/node-which" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/wide-align": { - "version": "1.1.5", - "resolved": "https://registry.npmjs.org/wide-align/-/wide-align-1.1.5.tgz", - "integrity": "sha512-eDMORYaPNZ4sQIuuYPDHdQvf4gyCF9rEEV/yPxGfwPkRodwEgiMUUXTx/dex+Me0wxx53S+NgUHaP7y3MGlDmg==", - "optional": true, - "dependencies": { - "string-width": "^1.0.2 || 2 || 3 || 4" - } - }, - "node_modules/wrappy": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", - "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==" - }, - "node_modules/xtend": { - "version": "4.0.2", - "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz", - "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==", - "engines": { - "node": ">=0.4" - } - }, - "node_modules/yallist": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", - "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==" - }, - "node_modules/yaml": { - "version": "2.0.0-1", - "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.0.0-1.tgz", - "integrity": "sha512-W7h5dEhywMKenDJh2iX/LABkbFnBxasD27oyXWDS/feDsxiw0dD5ncXdYXgkvAsXIY2MpW/ZKkr9IU30DBdMNQ==", - "engines": { - "node": ">= 6" - } - }, - "node_modules/yocto-queue": { - "version": "0.1.0", - "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", - "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", - "dev": true, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/z-schema": { - "version": "5.0.5", - "resolved": "https://registry.npmjs.org/z-schema/-/z-schema-5.0.5.tgz", - "integrity": "sha512-D7eujBWkLa3p2sIpJA0d1pr7es+a7m0vFAnZLlCEKq/Ij2k0MLi9Br2UPxoxdYystm5K1yeBGzub0FlYUEWj2Q==", - "dependencies": { - "lodash.get": "^4.4.2", - "lodash.isequal": "^4.5.0", - "validator": "^13.7.0" - }, - "bin": { - "z-schema": "bin/z-schema" - }, - "engines": { - "node": ">=8.0.0" - }, - "optionalDependencies": { - "commander": "^9.4.1" - } - }, - "node_modules/z-schema/node_modules/commander": { - "version": "9.5.0", - "resolved": "https://registry.npmjs.org/commander/-/commander-9.5.0.tgz", - "integrity": "sha512-KRs7WVDKg86PWiuAqhDrAQnTXZKraVcCc6vFdL14qrZ/DcWwuRo7VoiYXalXO7S5GKpqYiVEwCbgFDfxNHKJBQ==", - "optional": true, - "engines": { - "node": "^12.20.0 || >=14" - } - } - } -} diff --git a/api/src/db/migrate.js b/api/src/db/migrate.js index 7c04d62f..1e5ca72c 100644 --- a/api/src/db/migrate.js +++ b/api/src/db/migrate.js @@ -1,3 +1,4 @@ +import "dotenv/config"; import knex from "#configs/database.js"; (async () => { diff --git a/api/src/db/seed.js b/api/src/db/seed.js index d15f694d..1c48329a 100644 --- a/api/src/db/seed.js +++ b/api/src/db/seed.js @@ -1,3 +1,4 @@ +import "dotenv/config"; import knex from "#configs/database.js"; (async () => { From 18b114624b59cf7e80c61f543080e83538d90932 Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Wed, 15 Apr 2026 09:09:32 +0200 Subject: [PATCH 17/27] Update database configuration for PostgreSQL in `.env-template` and documentation --- README.md | 28 +++++++++++++++++++++++----- api/.env-template | 28 ++++++++++++++++------------ api/README.md | 30 +++++++++++++++++++++++------- 3 files changed, 62 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index b405f603..11f11c14 100644 --- a/README.md +++ b/README.md @@ -21,12 +21,15 @@ Both packages are as small as possible, but feel free to add more tools and temp ### Setting up the Database -This project template defaults to using an SQLite database, which is stored in a generated file in the api directory. It doesn't need a separate service to run. +For the Events Startup Project, PostgreSQL is the required database. -If you wish to use MySQL instead, here's a quick way to get one set up and running using Docker: -`docker run --name mysql -e MYSQL_ROOT_PASSWORD=mysql-root-password -e MYSQL_DATABASE=my-database -d -p 3306:3306 mysql:latest` +This repository started from a general template, so the API package includes SQLite, MySQL, and PostgreSQL clients. For this course project, you should configure and use PostgreSQL. -Whichever database you set up, connect to it using any database management tool of your choice, such as MySQL Workbench or DBeaver, to create your tables and add data. +Here is a quick way to start PostgreSQL locally with Docker: + +`docker run --name events-postgres -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=events_startup -d -p 5432:5432 postgres:16` + +After the container is running, you can connect to it using a database management tool such as DBeaver or pgAdmin. ![Testing your database](./images/db_test.png) ### Setting up the API @@ -38,12 +41,27 @@ cd api cp .env-template .env ``` -Open your .env file and configure the options as appropriate. The first thing you need to do is comment out/in the correct section in Database Configuration, depending on the database you chose in the first step. Set the variables to the correct values based on your set up. +Open your `.env` file and configure the options for PostgreSQL. + +For the course project, a local PostgreSQL `.env` will usually look like this: + +```env +PORT=3001 + +DB_CLIENT=pg +DB_HOST=localhost +DB_PORT=5432 +DB_USER=postgres +DB_PASSWORD=postgres +DB_DATABASE_NAME=events_startup +DB_USE_SSL=false +``` Then you're ready to start it up: ``` npm install +npm run db:setup npm run dev ``` diff --git a/api/.env-template b/api/.env-template index d70a7946..9c80dd7f 100644 --- a/api/.env-template +++ b/api/.env-template @@ -5,24 +5,28 @@ APP_NAME=Backend-Mid-Specialism PORT=3001 # -- Database configuration -- -# If you set up and use a database, you'll need to use the corresponding configuration -# below as a starting point. Uncomment the section you need and customise with your -# own correct values. -# -# The default enabled configuration is for SQLite. +# For the Events Startup Project, PostgreSQL is the required database. +# This file still includes SQLite and MySQL examples because the repository +# was created from a shared starter template. # General configuration DB_HOST=localhost -DB_PORT=330 +DB_PORT=5432 DB_USE_SSL=false # The database you use for local development most likely doesn't use SSL (encryption) but when you deploy it, you should set this to true on that environment. -# SQLite configuration - comment out/uncomment as needed -DB_CLIENT=sqlite3 -DB_SQLITE_FILENAME="./src/database.sqlite3" -DB_USE_NULL_AS_DEFAULT=true +# Recommended PostgreSQL configuration for this course project +DB_CLIENT=pg +DB_USER=postgres +DB_PASSWORD=postgres +DB_DATABASE_NAME=events_startup -# MySQL/PostgreSQL configuration - comment out/uncomment as needed -#DB_CLIENT=mysql2 # mysql2 or pg +# Optional SQLite configuration from the shared template +#DB_CLIENT=sqlite3 +#DB_SQLITE_FILENAME="./src/database.sqlite3" +#DB_USE_NULL_AS_DEFAULT=true + +# Optional MySQL configuration from the shared template +#DB_CLIENT=mysql2 #DB_USER=root #DB_PASSWORD=root_password #DB_DATABASE_NAME=database_name diff --git a/api/README.md b/api/README.md index 5f2fa4e7..a4d089be 100644 --- a/api/README.md +++ b/api/README.md @@ -1,6 +1,6 @@ # The API package -This package sets up a [Express](https://expressjs.com/) API server and a connection to a database (SQLite by default) using [Knex](https://knexjs.org/). +This package sets up a [Express](https://expressjs.com/) API server and a connection to a database using [Knex](https://knexjs.org/). For development you can run the command `npm run dev` which uses `nodemon` to watch files and restarts the server when a change happens. You can find the API at [http://localhost:3001/api](http://localhost:3001/api). @@ -16,12 +16,29 @@ When you start a fresh project, check out `.env-template` to get started. Create ## Database clients -The package comes installed with an SQLite, MySQL, and PostgreSQL client. Here's a quick suggestion for use cases: -1. SQLite for quick, simple file-based storage -2. MySQL for more advanced data storage (requires you to run a database service) -3. PostgreSQL, similar to MySQL and used on our recommended hosting platform Render.com +The package comes installed with SQLite, MySQL, and PostgreSQL clients because it is based on a shared template. -You can decide which client to use by changing the `DB_CLIENT` environment variable. See `.env-template` for more info. +For the Events Startup Project, PostgreSQL is the required database. You should set `DB_CLIENT=pg` and configure the remaining PostgreSQL environment variables in your `.env` file. + +Example local PostgreSQL setup with Docker: + +`docker run --name events-postgres -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=events_startup -d -p 5432:5432 postgres:16` + +Example `.env` values for that setup: + +```env +PORT=3001 + +DB_CLIENT=pg +DB_HOST=localhost +DB_PORT=5432 +DB_USER=postgres +DB_PASSWORD=postgres +DB_DATABASE_NAME=events_startup +DB_USE_SSL=false +``` + +See `.env-template` for the full list of available configuration variables. ## Advanced database management @@ -183,4 +200,3 @@ In the next screen you'll see the output of your build step which is downloading Once you see the text "Your service is live" you can test your API with Postman by using the deployed URL, which should be something like `https://hyf-template-api.onrender.com/api`. You should see the output the response from your "/" route. If you've got this far, you probably want to deploy your web app next. Head over to the README.md in your app directory for instructions. - From 925e051f94e2c4c0f165f6908928efc352a2c811 Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Wed, 15 Apr 2026 09:29:27 +0200 Subject: [PATCH 18/27] Integrate Knex.js for database migrations and seeding; update configuration and scripts accordingly. --- api/README.md | 18 ++++++++++++++++++ api/knexfile.js | 4 ++++ api/package.json | 11 +++++++---- api/src/configs/database.js | 19 ++----------------- api/src/configs/knex-config.js | 28 ++++++++++++++++++++++++++++ 5 files changed, 59 insertions(+), 21 deletions(-) create mode 100644 api/knexfile.js create mode 100644 api/src/configs/knex-config.js diff --git a/api/README.md b/api/README.md index a4d089be..212e1f59 100644 --- a/api/README.md +++ b/api/README.md @@ -57,6 +57,24 @@ This project includes helper scripts for running Knex migrations and seeds: - `npm run db:migrate` – runs all pending migrations - `npm run db:seed` – runs all seed files - `npm run db:setup` – runs migrations and then seeds (fresh setup) +- `npm run db:migrate:make ` – creates a new migration file using the standard Knex CLI +- `npm run db:seed:make ` – creates a new seed file using the standard Knex CLI + +You can use either the npm scripts above or the Knex CLI directly from inside the `api` directory. + +Example: + +```bash +npm run db:migrate:make create_user_table +``` + +Direct Knex CLI example: + +```bash +npx knex migrate:make create_user_table +``` + +Both commands create a timestamped migration file in `src/db/migrations`. The `db:setup` command is useful when: diff --git a/api/knexfile.js b/api/knexfile.js new file mode 100644 index 00000000..ca00be9b --- /dev/null +++ b/api/knexfile.js @@ -0,0 +1,4 @@ +import "dotenv/config"; +import { createKnexConfig } from "./src/configs/knex-config.js"; + +export default createKnexConfig(); diff --git a/api/package.json b/api/package.json index a0054a76..3867df06 100644 --- a/api/package.json +++ b/api/package.json @@ -13,12 +13,14 @@ "start": "node src/index.mjs", "format": "npx prettier . --write", "check": "npx eslint . --fix", - "db:migrate": "node src/db/migrate.js", - "db:seed": "node src/db/seed.js", - "db:setup": "npm run db:migrate && npm run db:seed" + "db:migrate": "npx knex migrate:latest", + "db:seed": "npx knex seed:run", + "db:setup": "npm run db:migrate && npm run db:seed", + "db:migrate:make": "npx knex migrate:make", + "db:seed:make": "npx knex seed:make" }, "dependencies": { - "body-parser": "^1.22.2", + "body-parser": "^2.2.2", "cors": "^2.8.5", "deepmerge": "^4.3.1", "dotenv": "^16.4.5", @@ -40,6 +42,7 @@ }, "imports": { "#configs/*": "./src/configs/*", + "#configs/knex-config.js": "./src/configs/knex-config.js", "#controllers/*": "./src/controllers/*", "#middlewares": "./src/middlewares/index.js", "#middlewares/*": "./src/middlewares/*", diff --git a/api/src/configs/database.js b/api/src/configs/database.js index 29f03d1c..ee94ccfd 100644 --- a/api/src/configs/database.js +++ b/api/src/configs/database.js @@ -1,21 +1,6 @@ import knex from "knex"; +import { createKnexConfig } from "#configs/knex-config.js"; -const client = process.env.DB_CLIENT ?? "sqlite3"; -const default_db_filename = client === "sqlite3" ? "src/db/database.sqlite" : null; - -const connection = knex({ - client: client, - connection: { - host: process.env.DB_HOST, - port: process.env.DB_PORT, - user: process.env.DB_USER, - password: process.env.DB_PASSWORD, - database: process.env.DB_DATABASE_NAME, - filename: process.env.DB_SQLITE_FILENAME ?? default_db_filename, // For SQLite - ssl: - process.env.DB_USE_SSL === "true" ? { rejectUnauthorized: false } : false, - }, - useNullAsDefault: process.env.DB_USE_NULL_AS_DEFAULT === "true", // For SQLite -}); +const connection = knex(createKnexConfig()); export default connection; diff --git a/api/src/configs/knex-config.js b/api/src/configs/knex-config.js new file mode 100644 index 00000000..a10e1433 --- /dev/null +++ b/api/src/configs/knex-config.js @@ -0,0 +1,28 @@ +const client = process.env.DB_CLIENT ?? "sqlite3"; +const defaultDbFilename = + client === "sqlite3" ? "src/db/database.sqlite" : null; + +export function createKnexConfig() { + return { + client, + connection: { + host: process.env.DB_HOST, + port: process.env.DB_PORT, + user: process.env.DB_USER, + password: process.env.DB_PASSWORD, + database: process.env.DB_DATABASE_NAME, + filename: process.env.DB_SQLITE_FILENAME ?? defaultDbFilename, + ssl: + process.env.DB_USE_SSL === "true" + ? { rejectUnauthorized: false } + : false, + }, + useNullAsDefault: process.env.DB_USE_NULL_AS_DEFAULT === "true", + migrations: { + directory: "src/db/migrations", + }, + seeds: { + directory: "src/db/seeds", + }, + }; +} From fbc64afa2ab238232da5ee79caf700ca40b9b96b Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Wed, 15 Apr 2026 09:49:23 +0200 Subject: [PATCH 19/27] Expand `api/README.md` with guidance on JavaScript module syntax and instructions for creating migrations and seeds. --- api/README.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/api/README.md b/api/README.md index 212e1f59..f2278852 100644 --- a/api/README.md +++ b/api/README.md @@ -14,6 +14,13 @@ You can set environment variables in the `.env` file or in the Render.com enviro When you start a fresh project, check out `.env-template` to get started. Create a file called `.env` and copy the contents of the template as a starting point (or just run `cp .env-template .env`). You should comment in/out the sections you need, and add any additional configuration as necessary. +## Important for trainees + +This project uses modern JavaScript modules throughout the codebase. + +- Use `import` / `export` syntax in project files +- If you see older Node.js examples online using `require()` and `module.exports`, that is CommonJS syntax and not the style used in this repository + ## Database clients The package comes installed with SQLite, MySQL, and PostgreSQL clients because it is based on a shared template. @@ -76,6 +83,41 @@ npx knex migrate:make create_user_table Both commands create a timestamped migration file in `src/db/migrations`. +### Creating a new migration or seed + +Migrations and seeds are considered advanced project tooling in this repository, so the README only documents the local project conventions and the basic commands. For more complete usage patterns, refer to the official Knex documentation. + +Create a migration: + +```bash +npm run db:migrate:make create_user_table +``` + +Create a seed: + +```bash +npm run db:seed:make 002_users +``` + +New migration files are created in `src/db/migrations`, and new seed files are created in `src/db/seeds`. + +For migrations, Knex expects an `up()` function for applying the schema change and a `down()` function for rolling it back: + +```js +export async function up(knex) { + await knex.schema.createTable("user", (table) => { + table.increments("id").primary(); + table.string("email").notNullable().unique(); + }); +} + +export async function down(knex) { + await knex.schema.dropTableIfExists("user"); +} +``` + +See the [Knex migration documentation](https://knexjs.org/guide/migrations.html) and [Knex seed documentation](https://knexjs.org/guide/migrations.html#seed-files) for more details. + The `db:setup` command is useful when: - You are starting the project for the first time From 3a61940c05b4a6390c5ee155f9afbb2bb928c9d6 Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Wed, 15 Apr 2026 10:03:35 +0200 Subject: [PATCH 20/27] Update README files with clarification on `db:setup` usage and schema compatibility --- README.md | 9 ++++++++- api/README.md | 4 ++++ 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 11f11c14..34e7566a 100644 --- a/README.md +++ b/README.md @@ -61,10 +61,17 @@ Then you're ready to start it up: ``` npm install -npm run db:setup npm run dev ``` +If you are using the included demo migration and seed files, run this before `npm run dev`: + +```bash +npm run db:setup +``` + +If you created your own PostgreSQL schema during the earlier database weeks and imported it separately, you do not need to run the included demo migrations and seeds. In that case, make sure your database schema matches the API code you are running. + You can then test the API using [Postman](https://www.postman.com/) at [http://localhost:3001/api](http://localhost:3001/api) - or just open it in your browser, for a quick peek that things are connecting successfully! ![Testing the API with Postman](./images/api_test.png) diff --git a/api/README.md b/api/README.md index f2278852..56eb0f54 100644 --- a/api/README.md +++ b/api/README.md @@ -67,6 +67,10 @@ This project includes helper scripts for running Knex migrations and seeds: - `npm run db:migrate:make ` – creates a new migration file using the standard Knex CLI - `npm run db:seed:make ` – creates a new seed file using the standard Knex CLI +If you are using the included example schema in this repository, run `npm run db:setup` before starting the API. + +If you built your own PostgreSQL schema during the database weeks and imported it separately, the included demo migration and seed files are optional. In that case, your own schema becomes the source of truth, and it must match the API code you are running. + You can use either the npm scripts above or the Knex CLI directly from inside the `api` directory. Example: From fcee03cf96f714c47dd61b5dc957da829401417d Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Wed, 15 Apr 2026 11:32:35 +0200 Subject: [PATCH 21/27] Refactor middleware structure: split into `globalMiddlewares` and `terminalMiddlewares`. Add error handlers (`apiNotFoundHandler`, `apiErrorHandler`) and update setup in `index.mjs`. Expand README with middleware usage guidelines. --- api/README.md | 40 +++++++++++++++++++++++++++++ api/src/index.mjs | 17 ++++++++++--- api/src/middlewares/errors.js | 48 +++++++++++++++++++++++++++++++++++ api/src/middlewares/index.js | 29 +++++++++++++++++++-- 4 files changed, 129 insertions(+), 5 deletions(-) create mode 100644 api/src/middlewares/errors.js diff --git a/api/README.md b/api/README.md index 56eb0f54..c5ece101 100644 --- a/api/README.md +++ b/api/README.md @@ -21,6 +21,46 @@ This project uses modern JavaScript modules throughout the codebase. - Use `import` / `export` syntax in project files - If you see older Node.js examples online using `require()` and `module.exports`, that is CommonJS syntax and not the style used in this repository +## Middleware placement + +This project uses middleware in more than one place, depending on what the middleware is supposed to do. + +- Use `globalMiddlewares` for middleware that should run before all routes +- Use `terminalMiddlewares` for fallback and error handling after routes +- Use router-level or route-level middleware for protected endpoints or feature-specific behavior + +Examples: + +- logging middleware can be global +- an optional auth extractor can be global if it does not block public routes +- `requireAuth` should usually be attached on protected routers or routes +- 404 and error handlers belong in the terminal middleware group + +In general, if a middleware would block public endpoints such as `/api/events`, do not add it as a global middleware. + +### Example + +Router-level middleware protects all routes in that router: + +```js +import express from "express"; +import { requireAuth } from "#middlewares/auth.js"; + +const ordersRouter = express.Router(); + +ordersRouter.use(requireAuth); + +ordersRouter.get("/", getOrders); +ordersRouter.get("/:id", getOrderById); +``` + +Route-level middleware protects only one specific route: + +```js +eventsRouter.get("/", getEvents); // public +eventsRouter.post("/", requireAuth, postEvent); // protected +``` + ## Database clients The package comes installed with SQLite, MySQL, and PostgreSQL clients because it is based on a shared template. diff --git a/api/src/index.mjs b/api/src/index.mjs index e700177b..617e1410 100644 --- a/api/src/index.mjs +++ b/api/src/index.mjs @@ -24,7 +24,10 @@ import cors from "cors"; // Cross-Origin Resource Sharing middleware import bodyParser from "body-parser"; // JSON body parsing import rootRouter from "#routers"; // Main router aggregator import swaggerSetup from "#configs/swagger.js"; // Swagger documentation setup -import middlewares from "#middlewares"; // Global middleware array +import { + globalMiddlewares, + terminalMiddlewares, +} from "#middlewares"; // Middleware groups // ------------------------------------------------------------------ // Application Initialization @@ -43,7 +46,7 @@ app.use(bodyParser.json()); // ------------------------------------------------------------------ // Middlewares are applied in sequence before route handlers. // This allows centralized handling (e.g. logging, error formatting, etc.) -for (const middleware of middlewares) { +for (const middleware of globalMiddlewares) { app.use(middleware); } @@ -62,6 +65,14 @@ app.use("/", rootRouter); // regardless of whether they are documented or not. swaggerSetup(app); +// ------------------------------------------------------------------ +// Register Terminal Middlewares +// ------------------------------------------------------------------ +// These run after route handlers and documentation routes. +for (const middleware of terminalMiddlewares) { + app.use(middleware); +} + // ------------------------------------------------------------------ // Start Server // ------------------------------------------------------------------ @@ -72,4 +83,4 @@ app.listen(port, () => { console.info( `${process.env.APP_NAME || "Backend-Mid-Specialism"} app started on port ${port}` ); -}); \ No newline at end of file +}); diff --git a/api/src/middlewares/errors.js b/api/src/middlewares/errors.js new file mode 100644 index 00000000..28def564 --- /dev/null +++ b/api/src/middlewares/errors.js @@ -0,0 +1,48 @@ +function getErrorStatus(error) { + const status = Number(error?.status ?? error?.statusCode); + + if (Number.isInteger(status) && status >= 400 && status <= 599) { + return status; + } + + return 500; +} + +export function apiNotFoundHandler(req, res) { + res.status(404).json({ + error: { + message: `Route not found: ${req.method} ${req.originalUrl}`, + }, + }); +} + +export function apiErrorHandler(error, req, res, next) { + const status = getErrorStatus(error); + const isServerError = status >= 500; + const shouldExposeDetails = process.env.NODE_ENV !== "production"; + void next; + + const message = !isServerError && error?.message + ? error.message + : "Internal server error"; + + const payload = { + error: { + message, + }, + }; + + if (shouldExposeDetails && error?.message) { + payload.error.details = error.message; + } + + if (shouldExposeDetails) { + payload.error.path = req.originalUrl; + } + + if (shouldExposeDetails && error?.stack) { + payload.error.stack = error.stack; + } + + res.status(status).json(payload); +} diff --git a/api/src/middlewares/index.js b/api/src/middlewares/index.js index 95db95ca..0e2d9a49 100644 --- a/api/src/middlewares/index.js +++ b/api/src/middlewares/index.js @@ -1,3 +1,28 @@ -const middlewares = [] +import { + apiErrorHandler, + apiNotFoundHandler, +} from "#middlewares/errors.js"; -export default middlewares \ No newline at end of file +/** + * Middlewares that should run for every request before route handlers. + * + * Examples: + * - logging + * - request parsing helpers + * - optional auth extraction that does not reject public requests + * + * Route protection middleware such as requireAuth should usually be attached + * on specific routers or routes, not here. + */ +export const globalMiddlewares = []; + +/** + * Middlewares that should run after routes. + * + * These are used for fallback and error handling after Express has tried + * to match the request against the registered routes. + */ +export const terminalMiddlewares = [ + apiNotFoundHandler, + apiErrorHandler, +]; From b53963124f2011507b0faca824993b6b7268651b Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Wed, 15 Apr 2026 11:42:27 +0200 Subject: [PATCH 22/27] Expand README files with guidance on extending the starter repository, adding dependencies, and managing environment variables. --- README.md | 6 ++++++ api/README.md | 5 +++++ 2 files changed, 11 insertions(+) diff --git a/README.md b/README.md index 34e7566a..37e326b1 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,12 @@ Both packages are as small as possible, but feel free to add more tools and temp ## Pre-requisites +This repository is a starter, not a complete final-project implementation. + +- The overall structure is provided for you +- As you build project-specific features, you may need to install additional dependencies and add new environment variables +- Keep the project structure clear as you extend it, rather than trying to fit every new feature into the starter exactly as-is + ## Getting started diff --git a/api/README.md b/api/README.md index c5ece101..0431d873 100644 --- a/api/README.md +++ b/api/README.md @@ -20,6 +20,11 @@ This project uses modern JavaScript modules throughout the codebase. - Use `import` / `export` syntax in project files - If you see older Node.js examples online using `require()` and `module.exports`, that is CommonJS syntax and not the style used in this repository +- This skeleton intentionally includes only the dependencies and environment variables needed for the base starter setup +- As you implement new features, you are expected to install additional packages and extend `.env` with any new variables you need +- Common examples for auth work are `bcryptjs` for password hashing, `jsonwebtoken` for JWT handling, and a `JWT_SECRET` environment variable for signing tokens + +The goal is to keep the project structure and separation of concerns consistent while still allowing you to extend the implementation as your project grows. ## Middleware placement From 7f98bc0559aeb6e146907357e28753f932ecef98 Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Wed, 15 Apr 2026 12:54:34 +0200 Subject: [PATCH 23/27] Integrate Zod for request validation and normalize inputs in event controllers. Update `listEvents` with pagination, add new schemas for events, and improve error handling with detailed `ZodError` support. Update README with validation examples and guidance. --- api/README.md | 43 +++++++++ api/package.json | 6 +- api/src/controllers/events.js | 47 +++++---- api/src/middlewares/errors.js | 21 +++- api/src/models/events.js | 12 ++- api/src/schemas/events.js | 176 ++++++++++++++++++++++++++++++++++ 6 files changed, 282 insertions(+), 23 deletions(-) create mode 100644 api/src/schemas/events.js diff --git a/api/README.md b/api/README.md index 0431d873..fd761d1e 100644 --- a/api/README.md +++ b/api/README.md @@ -26,6 +26,49 @@ This project uses modern JavaScript modules throughout the codebase. The goal is to keep the project structure and separation of concerns consistent while still allowing you to extend the implementation as your project grows. +## Input validation + +Backend input validation is also expected in this project for request bodies, path params, and query params. + +This starter now includes [Zod](https://zod.dev/) as a simple schema-based example for input validation. It was chosen intentionally because the schema definitions stay compact, readable, and close to the actual data shape. + +The included examples live in `src/schemas/events.js` as named schemas for request input. + +- Use it as a reference if you want a schema-based approach +- Zod schemas can validate and normalize input in one step with `.parse(...)` +- If `.parse(...)` fails, Zod throws a `ZodError`, which this starter maps to a `400` JSON response +- You may still use manual validation if that fits your learning process better +- You may also choose a different validation library if you have a good reason + +The important part is that incoming input is validated before it is used by controllers or models. + +### Example + +```js +import { EventInput, EventListQuery } from "#schemas/events.js"; + +export async function postEvent(req, res, next) { + try { + const eventInput = EventInput.parse(req.body); + // continue with validated and normalized input + } catch (error) { + next(error); + } +} +``` + +`EventInput.parse(req.body)` returns a validated object ready to use in the controller. + +For query params, the same pattern can be used: + +```js +const { page, pageSize } = EventListQuery.parse(req.query); +``` + +If you prefer manual validation, the wiring is similar: parse the input near the start of the controller, throw a `400`-type error when a value is invalid, and pass only normalized values deeper into the model layer. + +For comparison, `src/schemas/events.js` also includes commented manual alternatives that throw on invalid input and return normalized values on success. + ## Middleware placement This project uses middleware in more than one place, depending on what the middleware is supposed to do. diff --git a/api/package.json b/api/package.json index 3867df06..f337c051 100644 --- a/api/package.json +++ b/api/package.json @@ -31,7 +31,8 @@ "pg": "^8.11.5", "sqlite3": "^5.1.7", "swagger-jsdoc": "^6.2.8", - "swagger-ui-express": "^5.0.0" + "swagger-ui-express": "^5.0.0", + "zod": "^3.23.8" }, "devDependencies": { "@eslint/js": "^9.0.0", @@ -48,6 +49,7 @@ "#middlewares/*": "./src/middlewares/*", "#models/*": "./src/models/*", "#routers": "./src/routers/index.js", - "#routers/*": "./src/routers/*" + "#routers/*": "./src/routers/*", + "#schemas/*": "./src/schemas/*" } } diff --git a/api/src/controllers/events.js b/api/src/controllers/events.js index 2375987b..cd39bd9f 100644 --- a/api/src/controllers/events.js +++ b/api/src/controllers/events.js @@ -6,6 +6,12 @@ import { updateEvent, deleteEvent, } from "#models/events.js"; +import { + EventIdParams, + EventInput, + EventListQuery, + EventPatchInput, +} from "#schemas/events.js"; /** * Event controller (MVC example) @@ -35,12 +41,13 @@ import { * * Query Parameters: * - page (number, optional, default = 0) + * - pageSize (number, optional, default = 20) * * Pagination Strategy: - * - Fixed page size (PAGE_SIZE) - * - offset = page * PAGE_SIZE + * - Query params are validated and normalized with EventListQuery + * - offset = page * pageSize * - totalItems calculated via countEvents() - * - totalPages = ceil(totalItems / PAGE_SIZE) + * - totalPages = ceil(totalItems / pageSize) * * Response Shape: * { @@ -59,29 +66,27 @@ import { */ export async function getEvents(req, res, next) { try { - const PAGE_SIZE = 5; - - // Parse page safely (ensure non-negative integer) - const page = Math.max(Number(req.query.page ?? 0), 0); - const offset = page * PAGE_SIZE; + // Parse and normalize query params before calculating pagination. + const { page, pageSize } = EventListQuery.parse(req.query); + const offset = page * pageSize; const filters = {}; // TODO (required project work): map req.query filters here const data = await listEvents(filters, { - limit: PAGE_SIZE, + limit: pageSize, offset, orderBy: "id", order: "asc", }); const totalItems = await countEvents(filters); - const totalPages = Math.ceil(totalItems / PAGE_SIZE); + const totalPages = Math.ceil(totalItems / pageSize); res.json({ data, meta: { page, - pageSize: PAGE_SIZE, + pageSize, totalItems, totalPages, }, @@ -102,7 +107,8 @@ export async function getEvents(req, res, next) { */ export async function getEventById(req, res, next) { try { - const event = await findEventById(req.params.id); + const { id } = EventIdParams.parse(req.params); + const event = await findEventById(id); if (!event) { return res.status(404).json({ @@ -126,10 +132,10 @@ export async function getEventById(req, res, next) { * scope is explicitly added. */ export async function postEvent(req, res, next) { - // OPTIONAL TODO: implement this handler only if optional scope is taken on try { - await createEvent(req.body); + // Parse the request body before handing data to the model layer. + await createEvent(EventInput.parse(req.body)); return res.status(501).json({ error: @@ -151,7 +157,11 @@ export async function postEvent(req, res, next) { export async function patchEvent(req, res, next) { // OPTIONAL TODO: implement this handler only if optional scope is taken on try { - await updateEvent(req.params.id, req.body); + // Validate both the route params and the partial PATCH payload. + const { id } = EventIdParams.parse(req.params); + const eventPatchInput = EventPatchInput.parse(req.body); + + await updateEvent(id, eventPatchInput); return res.status(501).json({ error: @@ -173,7 +183,10 @@ export async function patchEvent(req, res, next) { export async function removeEvent(req, res, next) { // OPTIONAL TODO: implement this handler only if optional scope is taken on try { - await deleteEvent(req.params.id); + // DELETE only needs validated route params. + const { id } = EventIdParams.parse(req.params); + + await deleteEvent(id); return res.status(501).json({ error: @@ -182,4 +195,4 @@ export async function removeEvent(req, res, next) { } catch (error) { next(error); } -} \ No newline at end of file +} diff --git a/api/src/middlewares/errors.js b/api/src/middlewares/errors.js index 28def564..30f4fb7c 100644 --- a/api/src/middlewares/errors.js +++ b/api/src/middlewares/errors.js @@ -1,4 +1,10 @@ +import { ZodError } from "zod"; + function getErrorStatus(error) { + if (error instanceof ZodError) { + return 400; + } + const status = Number(error?.status ?? error?.statusCode); if (Number.isInteger(status) && status >= 400 && status <= 599) { @@ -22,9 +28,11 @@ export function apiErrorHandler(error, req, res, next) { const shouldExposeDetails = process.env.NODE_ENV !== "production"; void next; - const message = !isServerError && error?.message - ? error.message - : "Internal server error"; + const message = error instanceof ZodError + ? "Invalid request input" + : !isServerError && error?.message + ? error.message + : "Internal server error"; const payload = { error: { @@ -36,6 +44,13 @@ export function apiErrorHandler(error, req, res, next) { payload.error.details = error.message; } + if (error instanceof ZodError) { + payload.error.issues = error.issues.map((issue) => ({ + path: issue.path.join("."), + message: issue.message, + })); + } + if (shouldExposeDetails) { payload.error.path = req.originalUrl; } diff --git a/api/src/models/events.js b/api/src/models/events.js index 480c1987..532771d5 100644 --- a/api/src/models/events.js +++ b/api/src/models/events.js @@ -83,6 +83,8 @@ export async function countEvents(filters = {}, options = {}) { */ export async function listEvents(filters = {}, options = {}) { const { + limit, + offset, orderBy = "id", order = "asc", trx, @@ -97,6 +99,14 @@ export async function listEvents(filters = {}, options = {}) { String(order).toLowerCase() === "desc" ? "desc" : "asc" ); + if (Number.isInteger(limit) && limit > 0) { + qb.limit(limit); + } + + if (Number.isInteger(offset) && offset >= 0) { + qb.offset(offset); + } + return qb; } @@ -164,4 +174,4 @@ export async function deleteEvent() { throw new Error( "Optional placeholder: deleteEvent is intentionally not implemented in the base skeleton" ); -} \ No newline at end of file +} diff --git a/api/src/schemas/events.js b/api/src/schemas/events.js new file mode 100644 index 00000000..8ba6b14b --- /dev/null +++ b/api/src/schemas/events.js @@ -0,0 +1,176 @@ +import { z } from "zod"; + +/** + * Skeleton-ready query schema for listing events. + * + * This is included as a concrete example of how query params can be validated + * and normalized before they reach the controller logic. + * + * Trainees may update the allowed fields and limits to match their own API. + * + * EventListQuery.parse(req.query): + * - returns a normalized object when the input is valid + * - throws a ZodError when a type or condition is not met + */ +export const EventListQuery = z.object({ + page: z.coerce.number().int().min(0).default(0), + pageSize: z.coerce.number().int().min(1).max(100).default(20), +}); + +/** + * Skeleton-ready path params schema for event routes using :id. + * + * This shows how route params can be validated before they are used in + * controller or model code. + * + * EventIdParams.parse(req.params): + * - returns a normalized object such as { id: 12 } when valid + * - throws a ZodError if the value cannot be parsed into a positive integer + */ +export const EventIdParams = z.object({ + id: z.coerce.number().int().positive("id must be a positive integer"), +}); + +/** + * Skeleton-ready body schema for creating an event. + * + * This schema intentionally matches the demo event fields used in the starter. + * A trainee should update this schema when their project fields change. + * + * The rules below are examples of common validation requirements: + * - `title` is required and must not be empty after trimming + * - `price` is coerced to a number and must be non-negative + * - `currency` is normalized to uppercase and must have length 3 + * - `description` is optional + * + * EventInput.parse(req.body): + * - returns a validated and normalized object when valid + * - throws a ZodError when a field is missing, has the wrong type, or fails a rule + */ +export const EventInput = z.object({ + title: z.string().trim().min(1, "title is required"), + price: z.coerce.number().min(0, "price must be a non-negative number"), + currency: z + .string() + .trim() + .toUpperCase() + .length(3, "currency must be a 3-letter code"), + description: z.string().trim().optional(), +}); + +/** + * Skeleton-ready body schema for partially updating an event. + * + * PATCH routes typically allow partial input, so every field is optional here. + * + * EventPatchInput.parse(req.body): + * - accepts any subset of the EventInput fields + * - still applies the same type checks and conditions to provided fields + * - throws a ZodError if any provided field is invalid + */ +export const EventPatchInput = EventInput.partial(); + +/* +Manual alternatives without a validation library: + +export function parseEventListQuery(query) { + const page = Number(query.page ?? 0); + const pageSize = Number(query.pageSize ?? 20); + + // Validate the page number before using it for offset calculations. + if (!Number.isInteger(page) || page < 0) { + const error = new Error("page must be a non-negative integer"); + error.status = 400; + throw error; + } + + // Keep the page size within a simple and predictable range. + if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > 100) { + const error = new Error("pageSize must be an integer between 1 and 100"); + error.status = 400; + throw error; + } + + return { page, pageSize }; +} + +export function parseEventIdParams(params) { + const id = Number(params.id); + + // Route params are strings by default, so convert before validating. + if (!Number.isInteger(id) || id < 1) { + const error = new Error("id must be a positive integer"); + error.status = 400; + throw error; + } + + return { id }; +} + +export function parseEventInput(body) { + const title = String(body.title ?? "").trim(); + const price = Number(body.price); + const currency = String(body.currency ?? "").trim().toUpperCase(); + const description = body.description == null + ? undefined + : String(body.description).trim(); + + // Required string field: reject missing or empty values. + if (!title) { + const error = new Error("title is required"); + error.status = 400; + throw error; + } + + // Number field: coerce first, then validate the business rule. + if (!Number.isFinite(price) || price < 0) { + const error = new Error("price must be a non-negative number"); + error.status = 400; + throw error; + } + + // Normalize currency before checking its expected shape. + if (currency.length !== 3) { + const error = new Error("currency must be a 3-letter code"); + error.status = 400; + throw error; + } + + return { + title, + price, + currency, + description, + }; +} + +export function parseEventPatchInput(body) { + // Reuse the same normalization logic, but only return fields that were sent. + const parsed = parseEventInput({ + title: body.title ?? "placeholder", + price: body.price ?? 0, + currency: body.currency ?? "XXX", + description: body.description, + }); + + const result = {}; + + if (body.title !== undefined) { + result.title = parsed.title; + } + + if (body.price !== undefined) { + result.price = parsed.price; + } + + if (body.currency !== undefined) { + result.currency = parsed.currency; + } + + if (body.description !== undefined) { + result.description = parsed.description; + } + + return result; +} +*/ From 66b200752a09a08aa73a6f756e7c2bd170b82bdd Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Wed, 15 Apr 2026 13:08:59 +0200 Subject: [PATCH 24/27] Clarify project scope and usage of starter code in `README.md` and `api/README.md`. Add guidance on aligning starter examples with project contracts. --- README.md | 8 ++++++++ api/README.md | 18 ++++++++++++++++++ 2 files changed, 26 insertions(+) diff --git a/README.md b/README.md index 37e326b1..37e349e7 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,14 @@ This repository is a starter, not a complete final-project implementation. > Before you start, make sure no other projects are running, in order to have the required ports free. +## Project scope notes + +This repository is a starter for the Events Startup Project, not the full project specification. + +- Course requirements, weekly scope, and endpoint contracts should still be taken from the program documents +- The starter includes some illustrative placeholder routes and example structures that are meant to show patterns, not to redefine the assignment +- If the starter and the project contract seem to differ, prefer the project contract and update the starter code accordingly + ### Setting up the Database For the Events Startup Project, PostgreSQL is the required database. diff --git a/api/README.md b/api/README.md index fd761d1e..60ef8dfd 100644 --- a/api/README.md +++ b/api/README.md @@ -14,6 +14,24 @@ You can set environment variables in the `.env` file or in the Render.com enviro When you start a fresh project, check out `.env-template` to get started. Create a file called `.env` and copy the contents of the template as a starting point (or just run `cp .env-template .env`). You should comment in/out the sections you need, and add any additional configuration as necessary. +## Scope clarifications + +This README explains how the starter API is structured. It does not replace the project contract, PRD, or weekly plan. + +- Some routes in the starter exist mainly as examples of controller/router/model structure +- Placeholder admin-style CRUD routes are illustrative and may be optional depending on the course scope +- Core project scope should still be taken from the program requirements and contract + +When designing your own database and API, a few practical conventions are worth keeping in mind: + +- Avoid reserved database table names such as `user` and `order`; use safer names if needed +- Route params such as `itemId` should identify the record named by the route, for example a cart line item rather than a catalog event +- If the project contract specifies a route shape, follow that contract even if another route design could also work + +Design hint: + +If your cart API uses a route such as `/api/cart/items/{itemId}`, that usually implies a single unique identifier for the cart line item itself. If your database instead identifies a cart line by a composite key such as `(cart_id, line_no)`, the route shape would typically need to reflect that design as well, for example `/api/carts/{cartId}/lines/{lineNo}`. + ## Important for trainees This project uses modern JavaScript modules throughout the codebase. From dfb641c5b01cb7537ae147ef30fa65f49de06eec Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Wed, 15 Apr 2026 13:10:11 +0200 Subject: [PATCH 25/27] Update import path in `knexfile.js` to use alias `#configs` --- api/knexfile.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/knexfile.js b/api/knexfile.js index ca00be9b..13329d94 100644 --- a/api/knexfile.js +++ b/api/knexfile.js @@ -1,4 +1,4 @@ import "dotenv/config"; -import { createKnexConfig } from "./src/configs/knex-config.js"; +import { createKnexConfig } from "#configs/knex-config.js"; export default createKnexConfig(); From 34b50ac5accc50061c3dd48cdb6e4834cf484e53 Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Thu, 16 Apr 2026 12:21:52 +0200 Subject: [PATCH 26/27] Update README.md Co-authored-by: Adam Blanchard --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 37e349e7..c5a15f35 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ Both packages are as small as possible, but feel free to add more tools and temp ## Pre-requisites -This repository is a starter, not a complete final-project implementation. +This repository is a starter, not a complete working implementation. - The overall structure is provided for you - As you build project-specific features, you may need to install additional dependencies and add new environment variables From 10e8134abe7705d584ab48a5acd8656361b43662 Mon Sep 17 00:00:00 2001 From: Oleksiy Bondar Date: Thu, 16 Apr 2026 12:27:56 +0200 Subject: [PATCH 27/27] Address PR comments --- README.md | 8 -------- api/README.md | 26 ++++---------------------- 2 files changed, 4 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index c5a15f35..5be32151 100644 --- a/README.md +++ b/README.md @@ -25,14 +25,6 @@ This repository is a starter, not a complete working implementation. > Before you start, make sure no other projects are running, in order to have the required ports free. -## Project scope notes - -This repository is a starter for the Events Startup Project, not the full project specification. - -- Course requirements, weekly scope, and endpoint contracts should still be taken from the program documents -- The starter includes some illustrative placeholder routes and example structures that are meant to show patterns, not to redefine the assignment -- If the starter and the project contract seem to differ, prefer the project contract and update the starter code accordingly - ### Setting up the Database For the Events Startup Project, PostgreSQL is the required database. diff --git a/api/README.md b/api/README.md index 60ef8dfd..0312aa67 100644 --- a/api/README.md +++ b/api/README.md @@ -32,7 +32,7 @@ Design hint: If your cart API uses a route such as `/api/cart/items/{itemId}`, that usually implies a single unique identifier for the cart line item itself. If your database instead identifies a cart line by a composite key such as `(cart_id, line_no)`, the route shape would typically need to reflect that design as well, for example `/api/carts/{cartId}/lines/{lineNo}`. -## Important for trainees +## Node & Packages This project uses modern JavaScript modules throughout the codebase. @@ -131,27 +131,9 @@ eventsRouter.post("/", requireAuth, postEvent); // protected The package comes installed with SQLite, MySQL, and PostgreSQL clients because it is based on a shared template. -For the Events Startup Project, PostgreSQL is the required database. You should set `DB_CLIENT=pg` and configure the remaining PostgreSQL environment variables in your `.env` file. +For the Events Startup Project, keep the course-specific database setup in the [main README](../README.md), including the required `DB_CLIENT=pg` setting, local Docker example, and example `.env` values. -Example local PostgreSQL setup with Docker: - -`docker run --name events-postgres -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=events_startup -d -p 5432:5432 postgres:16` - -Example `.env` values for that setup: - -```env -PORT=3001 - -DB_CLIENT=pg -DB_HOST=localhost -DB_PORT=5432 -DB_USER=postgres -DB_PASSWORD=postgres -DB_DATABASE_NAME=events_startup -DB_USE_SSL=false -``` - -See `.env-template` for the full list of available configuration variables. +See `.env-template` for the full list of available configuration variables supported by this package. ## Advanced database management @@ -234,7 +216,7 @@ The `db:setup` command is useful when: - You want to reset your local database - You are running the demo version of the API -### Important for trainees +### Project structure This skeleton includes a simple **MVC-style structure**: