From f743ee10a2a4985e36029ff75f95c1e8645302e1 Mon Sep 17 00:00:00 2001 From: Ilya Date: Thu, 1 Oct 2026 19:29:22 +0300 Subject: [PATCH 1/4] feat: init after lab 1 --- Dockerfile | 29 + app/.gitignore | 59 + app/.prettierrc | 6 + app/README.md | 114 + app/nest-cli.json | 8 + app/oxlint.json | 10 + app/package-lock.json | 6446 +++++++++++++++++ app/package.json | 54 + app/src/app.module.ts | 10 + app/src/chats/chat.ts | 6 + app/src/chats/chats.controller.ts | 54 + app/src/chats/chats.module.ts | 13 + app/src/chats/chats.repository.ts | 19 + app/src/chats/chats.service.ts | 95 + app/src/chats/dto/create-chat.dto.ts | 26 + app/src/common/auth/current-user.guard.ts | 43 + app/src/common/errors/api-exception.filter.ts | 89 + app/src/common/http/cursor.ts | 54 + app/src/common/http/request-id.interceptor.ts | 35 + app/src/health/health.controller.ts | 17 + app/src/health/health.module.ts | 10 + app/src/health/health.service.spec.ts | 57 + app/src/health/health.service.ts | 45 + app/src/main.ts | 38 + app/src/messages/dto/create-message.dto.ts | 7 + app/src/messages/message.ts | 7 + app/src/messages/messages.controller.ts | 55 + app/src/messages/messages.module.ts | 13 + app/src/messages/messages.repository.spec.ts | 42 + app/src/messages/messages.repository.ts | 68 + app/src/messages/messages.service.ts | 75 + app/src/types.d.ts | 7 + app/src/users/dto/create-user.dto.ts | 11 + app/src/users/user.ts | 6 + app/src/users/users.controller.ts | 21 + app/src/users/users.module.ts | 12 + app/src/users/users.repository.ts | 25 + app/src/users/users.service.ts | 45 + app/test/app.e2e-spec.ts | 313 + app/tsconfig.build.json | 8 + app/tsconfig.json | 22 + app/vitest.config.e2e.ts | 11 + app/vitest.config.ts | 13 + docker-compose.yml | 13 + 44 files changed, 8111 insertions(+) create mode 100644 Dockerfile create mode 100644 app/.gitignore create mode 100644 app/.prettierrc create mode 100644 app/README.md create mode 100644 app/nest-cli.json create mode 100644 app/oxlint.json create mode 100644 app/package-lock.json create mode 100644 app/package.json create mode 100644 app/src/app.module.ts create mode 100644 app/src/chats/chat.ts create mode 100644 app/src/chats/chats.controller.ts create mode 100644 app/src/chats/chats.module.ts create mode 100644 app/src/chats/chats.repository.ts create mode 100644 app/src/chats/chats.service.ts create mode 100644 app/src/chats/dto/create-chat.dto.ts create mode 100644 app/src/common/auth/current-user.guard.ts create mode 100644 app/src/common/errors/api-exception.filter.ts create mode 100644 app/src/common/http/cursor.ts create mode 100644 app/src/common/http/request-id.interceptor.ts create mode 100644 app/src/health/health.controller.ts create mode 100644 app/src/health/health.module.ts create mode 100644 app/src/health/health.service.spec.ts create mode 100644 app/src/health/health.service.ts create mode 100644 app/src/main.ts create mode 100644 app/src/messages/dto/create-message.dto.ts create mode 100644 app/src/messages/message.ts create mode 100644 app/src/messages/messages.controller.ts create mode 100644 app/src/messages/messages.module.ts create mode 100644 app/src/messages/messages.repository.spec.ts create mode 100644 app/src/messages/messages.repository.ts create mode 100644 app/src/messages/messages.service.ts create mode 100644 app/src/types.d.ts create mode 100644 app/src/users/dto/create-user.dto.ts create mode 100644 app/src/users/user.ts create mode 100644 app/src/users/users.controller.ts create mode 100644 app/src/users/users.module.ts create mode 100644 app/src/users/users.repository.ts create mode 100644 app/src/users/users.service.ts create mode 100644 app/test/app.e2e-spec.ts create mode 100644 app/tsconfig.build.json create mode 100644 app/tsconfig.json create mode 100644 app/vitest.config.e2e.ts create mode 100644 app/vitest.config.ts create mode 100644 docker-compose.yml diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 00000000..c5fc7f9d --- /dev/null +++ b/Dockerfile @@ -0,0 +1,29 @@ +FROM node:25.7.0-slim AS build + +WORKDIR /usr/src/app + +COPY app/package.json app/package-lock.json ./ +RUN npm ci + +COPY app/ ./ +RUN npm run build + +FROM node:25.7.0-slim AS runtime + +WORKDIR /usr/src/app + +ENV NODE_ENV=production +ENV APP_PORT=8080 +ENV DRAIN_DELAY_MS=5000 +COPY --from=build /usr/src/app/package.json /usr/src/app/package-lock.json ./ +RUN npm ci --omit=dev && npm cache clean --force +COPY --from=build /usr/src/app/dist ./dist + +USER node + +EXPOSE 8080 + +HEALTHCHECK --interval=10s --timeout=3s --start-period=10s --retries=3 \ + CMD node -e "const port=process.env.APP_PORT||'8080'; fetch('http://127.0.0.1:'+port+'/health/ready').then((response) => { if (!response.ok) process.exit(1); }).catch(() => process.exit(1))" + +CMD ["node", "dist/main.js"] diff --git a/app/.gitignore b/app/.gitignore new file mode 100644 index 00000000..b266c548 --- /dev/null +++ b/app/.gitignore @@ -0,0 +1,59 @@ +# compiled output +/dist +/node_modules +/build + +# TypeScript build cache +*.tsbuildinfo + +# Logs +logs +*.log +npm-debug.log* +pnpm-debug.log* +yarn-debug.log* +yarn-error.log* +lerna-debug.log* + +# OS +.DS_Store + +# Tests +/coverage +/.nyc_output + +# IDEs and editors +/.idea +.project +.classpath +.c9/ +*.launch +.settings/ +*.sublime-workspace + +# IDE - VSCode +.vscode/* +!.vscode/settings.json +!.vscode/tasks.json +!.vscode/launch.json +!.vscode/extensions.json + +# dotenv environment variable files +.env +.env.development.local +.env.test.local +.env.production.local +.env.local + +# temp directory +.temp +.tmp + +# Runtime data +pids +*.pid +*.seed +*.pid.lock + +# Diagnostic reports (https://nodejs.org/api/report.html) +report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json diff --git a/app/.prettierrc b/app/.prettierrc new file mode 100644 index 00000000..b6528392 --- /dev/null +++ b/app/.prettierrc @@ -0,0 +1,6 @@ +{ + "singleQuote": true, + "trailingComma": "all", + "tabWidth": 4, + "useTabs": true +} diff --git a/app/README.md b/app/README.md new file mode 100644 index 00000000..07fc6fa4 --- /dev/null +++ b/app/README.md @@ -0,0 +1,114 @@ +

+ Nest Logo +

+ +[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456 +[circleci-url]: https://circleci.com/gh/nestjs/nest + +

A progressive Node.js framework for building efficient and scalable server-side applications.

+

+NPM Version +Package License +NPM Downloads +CircleCI +Discord +Backers on Open Collective +Sponsors on Open Collective + Donate us + Support us + Follow us on Twitter +

+ + +## Description + +[Nest](https://github.com/nestjs/nest) framework TypeScript starter repository. + +## Project setup + +```bash +$ npm install +``` + +## Compile and run the project + +```bash +# development +$ npm run start + +# watch mode +$ npm run start:dev + +# production mode +$ npm run start:prod +``` + +## Run tests + +```bash +# unit tests +$ npm run test + +# e2e tests +$ npm run test:e2e + +# test coverage +$ npm run test:cov +``` + +## Deployment + +When you're ready to deploy your NestJS application to production, there are some key steps you can take to ensure it runs as efficiently as possible. Check out the [deployment documentation](https://docs.nestjs.com/deployment) for more information. + +If you are looking for a cloud-based platform to deploy your NestJS application, check out [Mau](https://mau.nestjs.com), our official platform for deploying NestJS applications on AWS. Mau makes deployment straightforward and fast, requiring just a few simple steps: + +```bash +$ npm install -g @nestjs/mau +$ mau deploy +``` + +With Mau, you can deploy your application in just a few clicks, allowing you to focus on building features rather than managing infrastructure. + +## Observability + +In production applications, observability is essential for understanding how your system behaves, detecting issues early, and maintaining reliable performance. + +[NestJS Observe](https://observe.nestjs.com) automatically instruments your NestJS application, giving you deep visibility into your system with minimal setup: + +- **Distributed tracing:** Follow requests across services and understand how they flow through your system. +- **Waterfall analysis:** Visualize request execution and identify slow operations, bottlenecks, and unexpected delays. +- **Performance analysis:** Analyze application performance in real time and quickly pinpoint areas that need optimization. +- **Metrics:** Track key application and infrastructure metrics to understand system health and performance trends. +- **Logging:** Centralize and correlate logs with traces and other telemetry to make debugging easier. +- **Error tracking:** Detect errors quickly and investigate their root causes with the surrounding context. +- **SLA monitoring:** Track service-level objectives and identify when your application is approaching or exceeding defined thresholds. +- **Alarms and alerts:** Set up alerts for critical errors, performance degradation, SLA violations, and other anomalies so your team can react quickly. + +## Resources + +Check out a few resources that may come in handy when working with NestJS: + +- Visit the [NestJS Documentation](https://docs.nestjs.com) to learn more about the framework. +- For questions and support, please visit our [Discord channel](https://discord.gg/G7Qnnhy). +- To dive deeper and get more hands-on experience, check out our official video [courses](https://courses.nestjs.com/). +- Deploy your application to AWS with the help of [NestJS Mau](https://mau.nestjs.com) in just a few clicks. +- Auto-instrument your application with [NestJS Observer](https://observer.nestjs.com). Distributed tracing, metrics, and logging made easy. Error tracking and performance monitoring for your NestJS applications. +- Visualize your application graph and interact with the NestJS application in real-time using [NestJS Devtools](https://devtools.nestjs.com). +- Need help with your project (part-time to full-time)? Check out our official [enterprise support](https://enterprise.nestjs.com). +- To stay in the loop and get updates, follow us on [X](https://x.com/nestframework) and [LinkedIn](https://linkedin.com/company/nestjs). +- Looking for a job, or have a job to offer? Check out our official [Jobs board](https://jobs.nestjs.com). + +## Support + +Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support). + +## Stay in touch + +- Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec) +- Website - [https://nestjs.com](https://nestjs.com/) +- Twitter - [@nestframework](https://twitter.com/nestframework) + +## License + +Nest is [MIT licensed](https://github.com/nestjs/nest/blob/master/LICENSE). diff --git a/app/nest-cli.json b/app/nest-cli.json new file mode 100644 index 00000000..f9aa683b --- /dev/null +++ b/app/nest-cli.json @@ -0,0 +1,8 @@ +{ + "$schema": "https://json.schemastore.org/nest-cli", + "collection": "@nestjs/schematics", + "sourceRoot": "src", + "compilerOptions": { + "deleteOutDir": true + } +} diff --git a/app/oxlint.json b/app/oxlint.json new file mode 100644 index 00000000..07ec3bd5 --- /dev/null +++ b/app/oxlint.json @@ -0,0 +1,10 @@ +{ + "$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/crates/oxc_linter/src/rules.rs", + "rules": { + "@typescript-eslint/no-explicit-any": "off", + "@typescript-eslint/no-floating-promises": "warn" + }, + "env": { + "node": true + } +} diff --git a/app/package-lock.json b/app/package-lock.json new file mode 100644 index 00000000..6dc850fa --- /dev/null +++ b/app/package-lock.json @@ -0,0 +1,6446 @@ +{ + "name": "app", + "version": "0.0.1", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "app", + "version": "0.0.1", + "license": "UNLICENSED", + "dependencies": { + "@nestjs/common": "^12.0.1", + "@nestjs/config": "^12.0.0", + "@nestjs/core": "^12.0.1", + "@nestjs/platform-express": "^12.0.1", + "@nestjs/platform-fastify": "^12.0.3", + "class-transformer": "^0.5.1", + "class-validator": "^0.15.1", + "fastify": "^5.12.5", + "reflect-metadata": "^0.2.2", + "rxjs": "^7.8.1" + }, + "devDependencies": { + "@nestjs/cli": "^12.0.0", + "@nestjs/mau": "^0.2.6", + "@nestjs/schematics": "^12.0.0", + "@nestjs/testing": "^12.0.1", + "@types/express": "^5.0.0", + "@types/node": "^24.0.0", + "@types/supertest": "^7.0.0", + "@vitest/coverage-v8": "^4.1.2", + "oxlint": "^1.58.0", + "prettier": "^3.4.2", + "source-map-support": "^0.5.21", + "supertest": "^7.2.2", + "typescript": "^6.0.3", + "vite-tsconfig-paths": "^5.1.4", + "vitest": "^4.1.2" + } + }, + "node_modules/@angular-devkit/core": { + "version": "22.1.8", + "resolved": "https://registry.npmjs.org/@angular-devkit/core/-/core-22.1.8.tgz", + "integrity": "sha512-34lsgg2FwMVBX7nR/ZqzRUcdvdYPvSB8XAEr2GudXAyZwLI9ehzfQlagAWR/gEb8p4uCFZW0r7uU0toxydq4Rw==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "8.20.0", + "ajv-formats": "3.0.1", + "jsonc-parser": "3.3.1", + "picomatch": "4.0.5", + "rxjs": "7.8.2", + "source-map": "0.7.6" + }, + "engines": { + "node": "^22.22.3 || ^24.15.0 || >=26.0.0", + "npm": "^6.11.0 || ^7.5.6 || >=8.0.0", + "yarn": ">= 1.13.0" + }, + "peerDependencies": { + "chokidar": "^5.0.0" + }, + "peerDependenciesMeta": { + "chokidar": { + "optional": true + } + } + }, + "node_modules/@angular-devkit/schematics": { + "version": "22.1.8", + "resolved": "https://registry.npmjs.org/@angular-devkit/schematics/-/schematics-22.1.8.tgz", + "integrity": "sha512-Pv3cPa/44kvEwYcqwx4Ns5dhIDmcFNSHhbpheqiEG1Z/u4e2t4zHKDtE3eHZB+8o+IcC7xJj+d+AqGR44RoZDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@angular-devkit/core": "22.1.8", + "jsonc-parser": "3.3.1", + "magic-string": "1.0.0", + "ora": "9.4.1", + "rxjs": "7.8.2" + }, + "engines": { + "node": "^22.22.3 || ^24.15.0 || >=26.0.0", + "npm": "^6.11.0 || ^7.5.6 || >=8.0.0", + "yarn": ">= 1.13.0" + } + }, + "node_modules/@angular-devkit/schematics-cli": { + "version": "22.1.8", + "resolved": "https://registry.npmjs.org/@angular-devkit/schematics-cli/-/schematics-cli-22.1.8.tgz", + "integrity": "sha512-SsGG8ompVzprmYE9sHi2L7DYZ+i1sD+YDfun6Rg2vkTCusejtD4SSGVxwuR6++dT22ZpN16OqUTmii/0bhE4xA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@angular-devkit/core": "22.1.8", + "@angular-devkit/schematics": "22.1.8", + "@inquirer/prompts": "8.5.2" + }, + "bin": { + "schematics": "bin/schematics.js" + }, + "engines": { + "node": "^22.22.3 || ^24.15.0 || >=26.0.0", + "npm": "^6.11.0 || ^7.5.6 || >=8.0.0", + "yarn": ">= 1.13.0" + } + }, + "node_modules/@angular-devkit/schematics-cli/node_modules/@inquirer/prompts": { + "version": "8.5.2", + "resolved": "https://registry.npmjs.org/@inquirer/prompts/-/prompts-8.5.2.tgz", + "integrity": "sha512-IYR/3C/paEVVQYQvdDlFZVjRCJVYHHON0XXMH91KO9GSxs0TdKYWlUdvfQl2EfAHDxUaN3IBffkE/BDTh5nJ6g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/checkbox": "^5.2.1", + "@inquirer/confirm": "^6.1.1", + "@inquirer/editor": "^5.2.2", + "@inquirer/expand": "^5.1.1", + "@inquirer/input": "^5.1.2", + "@inquirer/number": "^4.1.1", + "@inquirer/password": "^5.1.1", + "@inquirer/rawlist": "^5.3.1", + "@inquirer/search": "^4.2.1", + "@inquirer/select": "^5.2.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz", + "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz", + "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.8", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.8.tgz", + "integrity": "sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.8" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.8", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz", + "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.29.7", + "@babel/helper-validator-identifier": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@bcoe/v8-coverage": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-1.0.2.tgz", + "integrity": "sha512-6zABk/ECA/QYSCQ1NGiVwwbQerUCZ+TQbp64Q3AgmfNvurHH0j8TtXa1qbShXA6qqkpAj4V5W8pP6mLe1mcMqA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/@borewit/text-codec": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/@borewit/text-codec/-/text-codec-0.2.2.tgz", + "integrity": "sha512-DDaRehssg1aNrH4+2hnj1B7vnUGEjU6OIlyRdkMd0aUdIUvKXrJfXsy8LVtXAy7DRvYVluWbMspsRhz2lcW0mQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/Borewit" + } + }, + "node_modules/@colors/colors": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz", + "integrity": "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==", + "dev": true, + "license": "MIT", + "optional": true, + "engines": { + "node": ">=0.1.90" + } + }, + "node_modules/@fastify/ajv-compiler": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/@fastify/ajv-compiler/-/ajv-compiler-4.0.6.tgz", + "integrity": "sha512-NtuzM0SfaMJbGlnjr9LWQUN5LzgSrbB8tf/wRZNas+4E1O/Nmzl53e7ruT61HDZyRCJGC6FxIogmNZO1c5ETBA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "ajv": "^8.12.0", + "ajv-formats": "^3.0.1", + "fast-uri": "^4.0.0" + } + }, + "node_modules/@fastify/ajv-compiler/node_modules/fast-uri": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-4.2.1.tgz", + "integrity": "sha512-TmHQgewjHtMq1E5QKA0tOE0yeYGQs25KZC/ziJpubRtWI15W92e6vPFydWOeZBVROSHBYw/QhD9d5OefdD6LDg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/@fastify/cors": { + "version": "11.3.0", + "resolved": "https://registry.npmjs.org/@fastify/cors/-/cors-11.3.0.tgz", + "integrity": "sha512-ggQGua+xHv1MvePbPr0v//xLYEsCXbWspquXCJS9Ot5YoRXq8J8ZWzHnxDBVnbtXosvistXo6LtNzOJswf64Fw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "fastify-plugin": "^6.0.0", + "toad-cache": "^3.7.0" + } + }, + "node_modules/@fastify/error": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/@fastify/error/-/error-4.2.0.tgz", + "integrity": "sha512-RSo3sVDXfHskiBZKBPRgnQTtIqpi/7zhJOEmAxCiBcM7d0uwdGdxLlsCaLzGs8v8NnxIRlfG0N51p5yFaOentQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT" + }, + "node_modules/@fastify/fast-json-stringify-compiler": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/@fastify/fast-json-stringify-compiler/-/fast-json-stringify-compiler-5.1.0.tgz", + "integrity": "sha512-PxcYtKLbQ8Z+yApiqjK8FwxIwvEj38k2OiLc17u8dkJSlmfi2wHHPaSnaoqBPQqtvF8YVsDgDpP2snDCfFrpfw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "fast-json-stringify": "^7.0.0" + } + }, + "node_modules/@fastify/formbody": { + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/@fastify/formbody/-/formbody-9.0.0.tgz", + "integrity": "sha512-T/af26CSrUARBCvsEmv+DJLPfZlrRKESzqironxP1j7qzuLyKcoZtj6MuTGShuKx1THXugoie2oFbUJxXfGFzA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "fast-querystring": "^1.1.2", + "fastify-plugin": "^6.0.0" + } + }, + "node_modules/@fastify/forwarded": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@fastify/forwarded/-/forwarded-3.0.2.tgz", + "integrity": "sha512-NE8HgKLgYejV9lDpqkEFaDKMLYelJBVfHekhB0UKvX0ghagXRJqg68feg8er1NPXxG4N9i6vPxzt8E+3wHfcmA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT" + }, + "node_modules/@fastify/merge-json-schemas": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/@fastify/merge-json-schemas/-/merge-json-schemas-0.2.1.tgz", + "integrity": "sha512-OA3KGBCy6KtIvLf8DINC5880o5iBlDX4SxzLQS8HorJAbqluzLRn80UXU0bxZn7UOFhFgpRJDasfwn9nG4FG4A==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "dequal": "^2.0.3" + } + }, + "node_modules/@fastify/middie": { + "version": "9.3.4", + "resolved": "https://registry.npmjs.org/@fastify/middie/-/middie-9.3.4.tgz", + "integrity": "sha512-dd8phTnVWzx3iKPBKSvtRUT8+Igvy/MP+P5HcY2tjejEyeVbyjkD4HgzKessUObue5RRM5J6PZdxtAqgbn84yw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "@fastify/error": "^4.0.0", + "fastify-plugin": "^6.0.0", + "find-my-way": "^9.5.0", + "path-to-regexp": "^8.1.0", + "reusify": "^1.0.4" + } + }, + "node_modules/@fastify/proxy-addr": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/@fastify/proxy-addr/-/proxy-addr-5.1.1.tgz", + "integrity": "sha512-zv07Y9GEuDsJPegZoDFd4SDWaZOW8N2pa0GSrYmKpId/tjt1Hgo3BjZBVjdVpfVrHaA+Qv5jawtS2O50J5xM9g==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "@fastify/forwarded": "^3.0.0", + "ipaddr.js": "^2.1.0" + } + }, + "node_modules/@fastify/proxy-addr/node_modules/ipaddr.js": { + "version": "2.5.0", + "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-2.5.0.tgz", + "integrity": "sha512-aq+t5NAc+cS6rZQQVWC2x98CPqGtKKTMDd4Gaodv0wShnItdKg/51djkGJ1hqH+Oy0ivDftCbSLCQob8zso01w==", + "license": "MIT", + "engines": { + "node": ">= 10" + } + }, + "node_modules/@inquirer/ansi": { + "version": "2.0.8", + "resolved": "https://registry.npmjs.org/@inquirer/ansi/-/ansi-2.0.8.tgz", + "integrity": "sha512-WpQM+Ti6Z40EFwwt+uL2p4UabT+W179zHp6HhLVOzfbwnVn05IPO/eXIZXGNqcT1jbQ15SujNLzQ39k4QPPxBQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + } + }, + "node_modules/@inquirer/checkbox": { + "version": "5.2.5", + "resolved": "https://registry.npmjs.org/@inquirer/checkbox/-/checkbox-5.2.5.tgz", + "integrity": "sha512-bRt8J8m+Fot9CXv+zNQGXUq2ET0MggR1fPz7v6edN6MFYmsbfGnMmkmWZJEegMKqrAC8ej/o1sqisHZXZJMAfQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/ansi": "^2.0.8", + "@inquirer/core": "^12.0.3", + "@inquirer/figures": "^2.0.9", + "@inquirer/type": "4.1.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/confirm": { + "version": "6.3.2", + "resolved": "https://registry.npmjs.org/@inquirer/confirm/-/confirm-6.3.2.tgz", + "integrity": "sha512-Xvr/0HggjddPtGppuqVmxhTw+Hr8PvsZ/k0HmOEaAqQEt80OITNkFWnsdNmyT0/eM4Ab+iJLx2R8rctlEyfSVg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/core": "^12.0.3", + "@inquirer/type": "4.1.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/core": { + "version": "12.0.3", + "resolved": "https://registry.npmjs.org/@inquirer/core/-/core-12.0.3.tgz", + "integrity": "sha512-wsSy0sznmXwkty+2PzZwx00Cazc/E0r0B7mAzdGROz2Ct+DFZXaK7WDjGZvgjRldxH5ZhFVfF2lgkYrqgOw2KA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/ansi": "^2.0.8", + "@inquirer/figures": "^2.0.9", + "@inquirer/type": "4.1.1", + "cli-width": "^4.1.0", + "fast-wrap-ansi": "^0.2.0", + "mute-stream": "^3.0.0", + "signal-exit": "^4.1.0" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/editor": { + "version": "5.3.3", + "resolved": "https://registry.npmjs.org/@inquirer/editor/-/editor-5.3.3.tgz", + "integrity": "sha512-YsKkS2q63IiLtaDK/9nqzdComN97SDQrmKiyNggN+ceP4ty+Z6VwyTz3FpjeUWeW1Efss2xHFKCC9sx7hnrsxg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/core": "^12.0.3", + "@inquirer/external-editor": "^3.0.5", + "@inquirer/type": "4.1.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/expand": { + "version": "5.1.5", + "resolved": "https://registry.npmjs.org/@inquirer/expand/-/expand-5.1.5.tgz", + "integrity": "sha512-uHuXLmXW+TtIfT/9vSBotypAkqn1n34Ul+CLGPos/xANyO4Ff5xZzkYhbKR4NEcfVK4a9mHQOpwVZzluSHFRGw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/core": "^12.0.3", + "@inquirer/type": "4.1.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/external-editor": { + "version": "3.0.5", + "resolved": "https://registry.npmjs.org/@inquirer/external-editor/-/external-editor-3.0.5.tgz", + "integrity": "sha512-f3QQJRIX5ZEneBHNUIuPjmbdzHnmRFJA8r2dkcb8q+OM5Uv5KtnuAttQumnrjcBVBM3mcTX1CkmtAkU58VRZxg==", + "dev": true, + "license": "MIT", + "dependencies": { + "chardet": "^2.1.1", + "iconv-lite": "^0.7.2" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/figures": { + "version": "2.0.9", + "resolved": "https://registry.npmjs.org/@inquirer/figures/-/figures-2.0.9.tgz", + "integrity": "sha512-EAWgUTGQ/Umgga51dE3B2PUHbufuXarDfg86uVgoSgNHNNQnyFKcOrQLWVqYMghuSyHh8+2HUH0Js9cTC1WAdg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + } + }, + "node_modules/@inquirer/input": { + "version": "5.1.6", + "resolved": "https://registry.npmjs.org/@inquirer/input/-/input-5.1.6.tgz", + "integrity": "sha512-HtcJhB2QFVXbLuJ5S3syhNbTUVxYvwqV4VRBDkQceBloC9bmTViUoRFP5PbSaDZb3HzfPmpuU/gG4ybVBz4FHA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/core": "^12.0.3", + "@inquirer/type": "4.1.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/number": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/@inquirer/number/-/number-4.2.3.tgz", + "integrity": "sha512-6Yuwh1NGSbu1Lo4N1EWjXs1jKRntLg/ZCwhmeorEHde90v1XxAozdbd4Iu30eOQLW+6h1hp2O9ujNfLSbTPJnA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/core": "^12.0.3", + "@inquirer/type": "4.1.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/password": { + "version": "5.2.2", + "resolved": "https://registry.npmjs.org/@inquirer/password/-/password-5.2.2.tgz", + "integrity": "sha512-W9zYdyzogK+6110mqwaSJWCBu2yA5Q/OfnGSjjZB1bNpHlmUozXxTl0+QOZBNeVd6Qo81/qT75gW05gLAtITxw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/ansi": "^2.0.8", + "@inquirer/core": "^12.0.3", + "@inquirer/type": "4.1.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/prompts": { + "version": "8.7.2", + "resolved": "https://registry.npmjs.org/@inquirer/prompts/-/prompts-8.7.2.tgz", + "integrity": "sha512-QoRB4wFIjgH5iOhSjoIKMkTvSHDuV+O3OITlIqAYO0oK5x364GJILXiMBvlPiE+klg7Xx9tq5XVqQHcGUDYYPA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/checkbox": "^5.2.5", + "@inquirer/confirm": "^6.3.2", + "@inquirer/editor": "^5.3.3", + "@inquirer/expand": "^5.1.5", + "@inquirer/input": "^5.1.6", + "@inquirer/number": "^4.2.3", + "@inquirer/password": "^5.2.2", + "@inquirer/rawlist": "^5.3.5", + "@inquirer/search": "^4.3.3", + "@inquirer/select": "^5.2.5" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/rawlist": { + "version": "5.3.5", + "resolved": "https://registry.npmjs.org/@inquirer/rawlist/-/rawlist-5.3.5.tgz", + "integrity": "sha512-1oHky1ONfCOwNrnkQGDE1oaSij/3fI6HFMSf2H/WsGO2lEyDX9My82iggITSy9ddSZ8yk8j9v41OI0fVoSIoaA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/core": "^12.0.3", + "@inquirer/type": "4.1.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/search": { + "version": "4.3.3", + "resolved": "https://registry.npmjs.org/@inquirer/search/-/search-4.3.3.tgz", + "integrity": "sha512-fyuIU1Nbpvwlikjg3gXwJFDI11+EFjqQ7P+iByfmivIKQ1vmaykNrD/vy5unHuUqUpsOsnvJ25//tPF7E/RBRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/core": "^12.0.3", + "@inquirer/figures": "^2.0.9", + "@inquirer/type": "4.1.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/select": { + "version": "5.2.5", + "resolved": "https://registry.npmjs.org/@inquirer/select/-/select-5.2.5.tgz", + "integrity": "sha512-9kc15hr8r/kI+3DO/xLog5nOzTz1jqsHXa6JBFzmQKhkoJ8Slda1I1L/uD8ZSZ9tF1yp79wwXe7mclvX1rqR2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@inquirer/ansi": "^2.0.8", + "@inquirer/core": "^12.0.3", + "@inquirer/figures": "^2.0.9", + "@inquirer/type": "4.1.1" + }, + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@inquirer/type": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/@inquirer/type/-/type-4.1.1.tgz", + "integrity": "sha512-yJoHYrMnxIsJZCY+0Vb66Dy3he3kL3e2wOBKhoSwWWAzZAY82emlxwgprCtp6yRixvNRNq9ztfRWQYPNr3Go7A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", + "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.6.0.tgz", + "integrity": "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.31", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz", + "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.1.0", + "@jridgewell/sourcemap-codec": "^1.4.14" + } + }, + "node_modules/@lukeed/csprng": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@lukeed/csprng/-/csprng-1.1.0.tgz", + "integrity": "sha512-Z7C/xXCiGWsg0KuKsHTKJxbWhpI3Vs5GwLfOean7MGyVFGqdRgBbAjOCh6u4bbjPc/8MJ2pZmK/0DLdCbivLDA==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@nestjs/cli": { + "version": "12.0.3", + "resolved": "https://registry.npmjs.org/@nestjs/cli/-/cli-12.0.3.tgz", + "integrity": "sha512-HofsPoiWsx6gZ7/IivaZJrgsq/3CTCb4FkCQzFu/Q3J2V+4xC7GYnit/HNB66EfuY8j3gWJCzasMKmF5VugmOA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@angular-devkit/core": "22.1.8", + "@angular-devkit/schematics": "22.1.8", + "@angular-devkit/schematics-cli": "22.1.8", + "@inquirer/prompts": "8.7.2", + "@nestjs/schematics": "^12.0.0", + "ansis": "4.4.0", + "chokidar": "5.0.0", + "cli-table3": "0.6.5", + "commander": "15.0.0", + "minimatch": "10.2.6", + "node-emoji": "2.2.0", + "ora": "9.4.1", + "tsconfig-paths": "4.2.0", + "typescript": "~6.0.2" + }, + "bin": { + "nest": "bin/nest.js" + }, + "engines": { + "node": ">= 20.11" + }, + "peerDependencies": { + "@rspack/core": "^1.7.7 || ^2.1.10", + "@swc/cli": "^0.8.0", + "@swc/core": "^1.15.18", + "fork-ts-checker-webpack-plugin": "^9.1.0", + "ts-loader": "^9.5.4", + "tsconfig-paths-webpack-plugin": "^4.2.0", + "webpack": "^5.105.4", + "webpack-node-externals": "^3.0.0" + }, + "peerDependenciesMeta": { + "@rspack/core": { + "optional": true + }, + "@swc/cli": { + "optional": true + }, + "@swc/core": { + "optional": true + }, + "fork-ts-checker-webpack-plugin": { + "optional": true + }, + "ts-loader": { + "optional": true + }, + "tsconfig-paths-webpack-plugin": { + "optional": true + }, + "webpack": { + "optional": true + }, + "webpack-node-externals": { + "optional": true + } + } + }, + "node_modules/@nestjs/common": { + "version": "12.0.3", + "resolved": "https://registry.npmjs.org/@nestjs/common/-/common-12.0.3.tgz", + "integrity": "sha512-Fosz6lHc9OagZNcF0LTrVHyJS8W7mtuNFBOo9RRccGwyeICBd0hiutjAi9zxnzBcP45RkYXeNB+idA/52jZhBQ==", + "license": "MIT", + "dependencies": { + "@standard-schema/spec": "1.1.0", + "file-type": "22.1.0", + "iterare": "1.2.1", + "load-esm": "1.0.3", + "tslib": "2.8.1", + "uid": "2.0.2" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/nest" + }, + "peerDependencies": { + "class-transformer": ">=0.4.1", + "class-validator": ">=0.13.2", + "reflect-metadata": "^0.1.12 || ^0.2.0", + "rxjs": "^7.1.0" + }, + "peerDependenciesMeta": { + "class-transformer": { + "optional": true + }, + "class-validator": { + "optional": true + } + } + }, + "node_modules/@nestjs/config": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@nestjs/config/-/config-12.0.0.tgz", + "integrity": "sha512-pG5+fFfCo3cdgVkLJLvvhUGfxEjwzv9hIAQ1aJVHvHlHVniDWfwX5pR/utgoAkJzSikv2oTR1BmIF03FXdi42Q==", + "license": "MIT", + "dependencies": { + "@standard-schema/spec": "1.1.0", + "dotenv": "17.4.2", + "dotenv-expand": "13.0.0", + "es-toolkit": "1.51.0" + }, + "peerDependencies": { + "@nestjs/common": "^11.0.0 || ^12.0.0", + "rxjs": "^7.1.0" + } + }, + "node_modules/@nestjs/core": { + "version": "12.0.3", + "resolved": "https://registry.npmjs.org/@nestjs/core/-/core-12.0.3.tgz", + "integrity": "sha512-Ouv++gAXOL50S8K8n6AN19QGmw51rnIo6v7y9AqUYoaf0NcZlufTu5XTDeC2RtpMz8oXRr9nykBngRjflcoQKA==", + "license": "MIT", + "dependencies": { + "fast-safe-stringify": "2.1.1", + "iterare": "1.2.1", + "path-to-regexp": "8.4.2", + "tslib": "2.8.1", + "uid": "2.0.2" + }, + "engines": { + "node": ">= 20" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/nest" + }, + "peerDependencies": { + "@nestjs/common": "^12.0.0", + "@nestjs/microservices": "^12.0.0", + "@nestjs/platform-express": "^12.0.0", + "@nestjs/websockets": "^12.0.0", + "reflect-metadata": "^0.1.12 || ^0.2.0", + "rxjs": "^7.1.0" + }, + "peerDependenciesMeta": { + "@nestjs/microservices": { + "optional": true + }, + "@nestjs/platform-express": { + "optional": true + }, + "@nestjs/websockets": { + "optional": true + } + } + }, + "node_modules/@nestjs/mau": { + "version": "0.2.8", + "resolved": "https://registry.npmjs.org/@nestjs/mau/-/mau-0.2.8.tgz", + "integrity": "sha512-nIb0i3c/KhKEbxZfYMEKv9Mcvk5miBdZcexnvkgnAUhoMO2BUjOGT+Khf2cZzu7B51Y7v01NG2JVl/HdQEUQ6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "4.1.2", + "cli-progress": "3.12.0", + "commander": "4.1.1", + "inquirer": "8.2.6", + "node-emoji": "2.1.3", + "ora": "5.4.1", + "undici": "6.20.1" + }, + "bin": { + "mau": "bin/mau.js" + }, + "engines": { + "node": ">= 20.0.0" + } + }, + "node_modules/@nestjs/mau/node_modules/cli-spinners": { + "version": "2.9.2", + "resolved": "https://registry.npmjs.org/cli-spinners/-/cli-spinners-2.9.2.tgz", + "integrity": "sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@nestjs/mau/node_modules/commander": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/commander/-/commander-4.1.1.tgz", + "integrity": "sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, + "node_modules/@nestjs/mau/node_modules/is-interactive": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-interactive/-/is-interactive-1.0.0.tgz", + "integrity": "sha512-2HvIEKRoqS62guEC+qBjpvRubdX910WCMuJTZ+I9yvqKU2/12eSL549HMwtabb4oupdj2sMP50k+XJfB/8JE6w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@nestjs/mau/node_modules/is-unicode-supported": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-0.1.0.tgz", + "integrity": "sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@nestjs/mau/node_modules/log-symbols": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-4.1.0.tgz", + "integrity": "sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^4.1.0", + "is-unicode-supported": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@nestjs/mau/node_modules/node-emoji": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/node-emoji/-/node-emoji-2.1.3.tgz", + "integrity": "sha512-E2WEOVsgs7O16zsURJ/eH8BqhF029wGpEOnv7Urwdo2wmQanOACwJQh0devF9D9RhoZru0+9JXIS0dBXIAz+lA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@sindresorhus/is": "^4.6.0", + "char-regex": "^1.0.2", + "emojilib": "^2.4.0", + "skin-tone": "^2.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/@nestjs/mau/node_modules/ora": { + "version": "5.4.1", + "resolved": "https://registry.npmjs.org/ora/-/ora-5.4.1.tgz", + "integrity": "sha512-5b6Y85tPxZZ7QytO+BQzysW31HJku27cRIlkbAXaNx+BdcVi+LlRFmVXzeF6a7JCwJpyw5c4b+YSVImQIrBpuQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "bl": "^4.1.0", + "chalk": "^4.1.0", + "cli-cursor": "^3.1.0", + "cli-spinners": "^2.5.0", + "is-interactive": "^1.0.0", + "is-unicode-supported": "^0.1.0", + "log-symbols": "^4.1.0", + "strip-ansi": "^6.0.0", + "wcwidth": "^1.0.1" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@nestjs/platform-express": { + "version": "12.0.3", + "resolved": "https://registry.npmjs.org/@nestjs/platform-express/-/platform-express-12.0.3.tgz", + "integrity": "sha512-q9ImjCMjbYYgqvRHHro6sAypNwhjspIAHad0RTL2ww5wYd9gwUGWMss7Q+ACCw5Sksu7Q8S/3rjSLhB+W6B6bg==", + "license": "MIT", + "dependencies": { + "cors": "2.8.6", + "express": "5.2.1", + "multer": "2.4.0", + "path-to-regexp": "8.4.2", + "tslib": "2.8.1" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/nest" + }, + "peerDependencies": { + "@nestjs/common": "^12.0.0", + "@nestjs/core": "^12.0.0" + } + }, + "node_modules/@nestjs/platform-fastify": { + "version": "12.0.3", + "resolved": "https://registry.npmjs.org/@nestjs/platform-fastify/-/platform-fastify-12.0.3.tgz", + "integrity": "sha512-Cn8jR8jwPJBk7ftkzunplz0LHDahnq7urAO9VjOV0OWkk1YCwaFMm4CElSk3BwBiDwP177anJjJUbVxTlASk4A==", + "license": "MIT", + "dependencies": { + "@fastify/cors": "11.3.0", + "@fastify/formbody": "9.0.0", + "@fastify/middie": "9.3.4", + "fast-querystring": "1.1.2", + "fastify": "5.12.4", + "find-my-way": "9.9.0", + "light-my-request": "6.6.0", + "path-to-regexp": "8.4.2", + "tslib": "2.8.1" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/nest" + }, + "peerDependencies": { + "@fastify/static": "^10.1.2", + "@fastify/view": "^10.0.0 || ^11.0.0 || ^12.0.0", + "@nestjs/common": "^12.0.0", + "@nestjs/core": "^12.0.0" + }, + "peerDependenciesMeta": { + "@fastify/static": { + "optional": true + }, + "@fastify/view": { + "optional": true + } + } + }, + "node_modules/@nestjs/platform-fastify/node_modules/fastify": { + "version": "5.12.4", + "resolved": "https://registry.npmjs.org/fastify/-/fastify-5.12.4.tgz", + "integrity": "sha512-zATD676fP6tBMsn+jQ7Q5/cO/Qo+149TXH0dUqUKel+1/hcZxwIbnflqtPa9EjlrvpY8eCZcL3M1UYrMc31Y7g==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "@fastify/ajv-compiler": "^4.0.5", + "@fastify/error": "^4.0.0", + "@fastify/fast-json-stringify-compiler": "^5.0.0", + "@fastify/proxy-addr": "^5.0.0", + "abstract-logging": "^2.0.1", + "avvio": "^9.0.0", + "fast-json-stringify": "^7.0.0", + "find-my-way": "^9.6.0", + "light-my-request": "^6.0.0", + "pino": "^9.14.0 || ^10.1.0", + "process-warning": "^5.1.0", + "rfdc": "^1.3.1", + "secure-json-parse": "^4.0.0", + "semver": "^7.6.0", + "toad-cache": "^3.7.0" + } + }, + "node_modules/@nestjs/schematics": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@nestjs/schematics/-/schematics-12.0.0.tgz", + "integrity": "sha512-ilsxam7i+SWd2psr12faLVSk86FYKnxRUGO6jAGNi1P9+O0kRaYVOScyrKeIj97W9T9UJoJF38fg+7KgjY/nOg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@angular-devkit/core": "22.1.5", + "@angular-devkit/schematics": "22.1.5", + "comment-json": "5.0.0", + "jsonc-parser": "3.3.1", + "pluralize": "8.0.0" + }, + "engines": { + "node": ">=22.12.0" + }, + "peerDependencies": { + "prettier": "^3.0.0", + "typescript": ">=6.0.0" + }, + "peerDependenciesMeta": { + "prettier": { + "optional": true + } + } + }, + "node_modules/@nestjs/schematics/node_modules/@angular-devkit/core": { + "version": "22.1.5", + "resolved": "https://registry.npmjs.org/@angular-devkit/core/-/core-22.1.5.tgz", + "integrity": "sha512-HiY6d5dkIdJs5grP9OHvgkf14QOcDIo+hbuT7YKuLItQ++ZxCwUabJMLCCJ5R0KrstE5NqED0dNcyk5WD01t5Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "8.20.0", + "ajv-formats": "3.0.1", + "jsonc-parser": "3.3.1", + "picomatch": "4.0.5", + "rxjs": "7.8.2", + "source-map": "0.7.6" + }, + "engines": { + "node": "^22.22.3 || ^24.15.0 || >=26.0.0", + "npm": "^6.11.0 || ^7.5.6 || >=8.0.0", + "yarn": ">= 1.13.0" + }, + "peerDependencies": { + "chokidar": "^5.0.0" + }, + "peerDependenciesMeta": { + "chokidar": { + "optional": true + } + } + }, + "node_modules/@nestjs/schematics/node_modules/@angular-devkit/schematics": { + "version": "22.1.5", + "resolved": "https://registry.npmjs.org/@angular-devkit/schematics/-/schematics-22.1.5.tgz", + "integrity": "sha512-HTmo9y8wjXKtJGVTYomTjZsjWzhirpu1pPRAzsVob3eiYOuxv1qDRAgWiHXNGp5CpnbHunZweXY/WffNGOFRyA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@angular-devkit/core": "22.1.5", + "jsonc-parser": "3.3.1", + "magic-string": "1.0.0", + "ora": "9.4.1", + "rxjs": "7.8.2" + }, + "engines": { + "node": "^22.22.3 || ^24.15.0 || >=26.0.0", + "npm": "^6.11.0 || ^7.5.6 || >=8.0.0", + "yarn": ">= 1.13.0" + } + }, + "node_modules/@nestjs/testing": { + "version": "12.0.3", + "resolved": "https://registry.npmjs.org/@nestjs/testing/-/testing-12.0.3.tgz", + "integrity": "sha512-TYDvBI8HvYeldNCmsuSaE4XqSs1Mg7IekSPlJf+zbrVt3+s5sqt4ySMUhbTs8JpMTFMyqCwtPTGVHIcFVuTBbQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "tslib": "2.8.1" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/nest" + }, + "peerDependencies": { + "@nestjs/common": "^12.0.0", + "@nestjs/core": "^12.0.0", + "@nestjs/microservices": "^12.0.0", + "@nestjs/platform-express": "^12.0.0" + }, + "peerDependenciesMeta": { + "@nestjs/microservices": { + "optional": true + }, + "@nestjs/platform-express": { + "optional": true + } + } + }, + "node_modules/@noble/hashes": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz", + "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^14.21.3 || >=16" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/@oxc-project/types": { + "version": "0.150.0", + "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.150.0.tgz", + "integrity": "sha512-rDS5/31E9HfPl/CIzGrn0DOlvBbXFseQ5URJ9sYMfstbKLD/c6Gm9vmRzRGDdAXyOIL4zmO37lc9RIwYqVruZw==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/oxc-project" + } + }, + "node_modules/@oxlint/binding-android-arm-eabi": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-android-arm-eabi/-/binding-android-arm-eabi-1.83.0.tgz", + "integrity": "sha512-0yGY24EwsLk5YDe6F+VkmZyRHSwJDALa3nIrPpq7FXmp2lV2d0TzvBCGeZk+wgiULRGr5blhyr4QMp5KCXJUqA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-android-arm64": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-android-arm64/-/binding-android-arm64-1.83.0.tgz", + "integrity": "sha512-hHfJ0vc17A4iUjH5p9BsTUPYbYRNxGpvD2lbu1aBRk54bzNIx9o5TtYF39QPZcV95DagZd+4DEAw2RH3G2ZsMg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-darwin-arm64": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-darwin-arm64/-/binding-darwin-arm64-1.83.0.tgz", + "integrity": "sha512-hsOjYjszLb/3zym/TkzUMPAoQlTJcuzSyEPOAyA+skXJIX9M0o+4JfOtqopX/Vf4hSLrJ98j0nvFo23gzk8auQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-darwin-x64": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-darwin-x64/-/binding-darwin-x64-1.83.0.tgz", + "integrity": "sha512-mjh5oH2EA+wl5yRJYT9K9G61O2zFlpuv+yf2JwZOi0+dq2FnTUtm1h8i+5Ik0fXPWIu/k84I1psZR9aQsLAnyA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-freebsd-x64": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-freebsd-x64/-/binding-freebsd-x64-1.83.0.tgz", + "integrity": "sha512-fNHr64/YaO8YssuoDVC8+F4Uk5enR86q5uxfHkQrjAPs1dbAILOrD2uaud+J7MO8Fx774g44ERLD0IGIvZE48w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-linux-arm-gnueabihf": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.83.0.tgz", + "integrity": "sha512-Qpwy3zzAwMj+8/lyYItHmkSMwbkprFNWTK7jPYDOxSyxEhaSLOWYUTCMkjF334J8/WD0nznCCsoBbIH6hpsuIw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-linux-arm-musleabihf": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-linux-arm-musleabihf/-/binding-linux-arm-musleabihf-1.83.0.tgz", + "integrity": "sha512-s+BirYLFq7JL2k9sP0XI3ZXJ9dYvJ8sX3jLCLoag7tt+zrSHpZxP0jqznfL+Gdgwu7ay0dYgGYJXrQvq3iWloA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-linux-arm64-gnu": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.83.0.tgz", + "integrity": "sha512-7lihXt3vKr+GIyapNbHrnFHm/biiW30le6Zv/DExbAFPF6YwCQXVFlONPFehxs0CpGO4CBfYPM9rdDT+XMoIlg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-linux-arm64-musl": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.83.0.tgz", + "integrity": "sha512-q63JalLYVkZiZvls1z3PPUnpmQluOMXp0khqQMznCeAPLGydfNY8JhvuA4WlK57JfrvikU8wB5lPVveqpIXvew==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-linux-ppc64-gnu": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.83.0.tgz", + "integrity": "sha512-krQmDF+dRbxvdqVPV88ZuOoPPu8X5BuqDA8Hd+qcS4YMRQCb+nexA57DazgGsc/rGdKBe3QmV0mnv0bdpW/p5g==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-linux-riscv64-gnu": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-linux-riscv64-gnu/-/binding-linux-riscv64-gnu-1.83.0.tgz", + "integrity": "sha512-MmOl8Y6txEAXZU1RG8Rr264jQ6D7VPmqFsU/45x/FeWsGe32hklTqGrLE6UxHzp5Rjt0wP+20tY8YXKgSFB3mw==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-linux-riscv64-musl": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-linux-riscv64-musl/-/binding-linux-riscv64-musl-1.83.0.tgz", + "integrity": "sha512-u1rMymh0W3JZkq370kzQsYPULGWqhE09pZRqnZvUSoYaI9pVO5yVX+iYIslmWuEgwuzH9YAaOsScJiobWCHoOw==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-linux-s390x-gnu": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.83.0.tgz", + "integrity": "sha512-y0zK3HNwGysu7rqtE+BQG/d0bx5gh/KwlOtghN8oWeK1KcWzeaLqtZrbm8owqdma1lFyrce/hTO5ismuNu+INQ==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-linux-x64-gnu": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.83.0.tgz", + "integrity": "sha512-rS5gM0NgD7ngmuJmbIehsidtrOwKkLFwCQbKEeb9KuyQrrWNq5Zkn0uV6AYdXOMJ0grrWEiLwBuvMxt8w5vsNw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-linux-x64-musl": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-linux-x64-musl/-/binding-linux-x64-musl-1.83.0.tgz", + "integrity": "sha512-W2IH4EtpcPaWcvNGCA95YoDg4vxqE/ZiPCi3arrxEEpsK7+JQN9WYwrlYFx9pcdP6KPXqRqkv3zdQPHcx7b6YQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-openharmony-arm64": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-openharmony-arm64/-/binding-openharmony-arm64-1.83.0.tgz", + "integrity": "sha512-6LyKkUyoajssTPLlZmDbZIbu4IZ5B4bGuRUnBgCGpEvHP3FQMaYITncHA/unPUo7q+Z+pIu2HhdkQ+8d1SG7iA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-win32-arm64-msvc": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.83.0.tgz", + "integrity": "sha512-Uz/fObEtF0jmNJQJ8CGRBKfefYstS0/wjD3s6IGzP8nUwsJykHQJBiN3npHwKiGRGn/vvBEgNr4B3cCzmmatvg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-win32-ia32-msvc": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-win32-ia32-msvc/-/binding-win32-ia32-msvc-1.83.0.tgz", + "integrity": "sha512-u7XcvPW6Bk58tY5iWs2ESb0vJjoE/kuSpHxopbwp/p3ZtWVQXZ6wor5w3ssVTHOqd/v8b+QdhSFWQ4grEUNWpA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@oxlint/binding-win32-x64-msvc": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/@oxlint/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.83.0.tgz", + "integrity": "sha512-LZRubd7ph13QmAg4fFecTYVZkiYbROR2Htaxh/ufWRkDhPOm2wrwaEYR89e0YpPFD3dqBrPoxS7myBw5hmYA7Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@paralleldrive/cuid2": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/@paralleldrive/cuid2/-/cuid2-2.3.1.tgz", + "integrity": "sha512-XO7cAxhnTZl0Yggq6jOgjiOHhbgcO4NqFqwSmQpjK3b6TEE6Uj/jfSk6wzYyemh3+I0sHirKSetjQwn5cZktFw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@noble/hashes": "^1.1.5" + } + }, + "node_modules/@pinojs/redact": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/@pinojs/redact/-/redact-0.4.0.tgz", + "integrity": "sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg==", + "license": "MIT" + }, + "node_modules/@rolldown/binding-android-arm-eabi": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.9.tgz", + "integrity": "sha512-tNISae1QEf/vkb3xkRcjV5SEdzPE97We5IVaa2Z8jSszQPZ8U60B/YCYpw4QI7VidYsBtKavczXf+DyDs9WGxw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-android-arm64": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.9.tgz", + "integrity": "sha512-YC8YsI30o606GTZi0VyzYlsDKFP8W61i/QzayHDkLbNEz/IShqAmTa+hsJRj13xTHA0H+6fk4b2UmGn+Q/cMlg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-darwin-arm64": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.9.tgz", + "integrity": "sha512-IwhlH3qK5urrY8hZiEgGkHKEFN901p/p2bjxCxJlr4GyNnF7wYpUvK+Y43uaRYuC4hpfjzbR3SJC3arX1jGvmw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-darwin-x64": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.9.tgz", + "integrity": "sha512-XxpJfVzFh+jilRxIXUqcfYAYcunIc/XEzIizsOL1fcJee5Sf7H3mH8WlLmfHfluz5amqR88QQo9izKtmMlavAw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-freebsd-x64": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.9.tgz", + "integrity": "sha512-kSfvhmgeWyfkbT3p/1s5vSgboogoah2zkm9fX2zjg2hHxSV7T4KhMWRUUaRk4OXNqoD3QAUeRqLcs1aZOK4U1g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-arm-gnueabihf": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.9.tgz", + "integrity": "sha512-1RVzG17pxqbTfYLC352JlLt6kKLG+6Hr30n8DlIJqsnV5luUDd2Qdx9Ayw1Cabfyb1K9k0jXEZ7evxkRoT+uiw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-arm64-gnu": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.9.tgz", + "integrity": "sha512-BXqPvZ2drqVD+/Z8UpKwcs4Mp7grM+eGFku4CAEKrEtcbAsUpzREphK1sogCRZGreVPiMkiiBtw0n3TPteuqvw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-arm64-musl": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.9.tgz", + "integrity": "sha512-11vWvo8YDwLzukt27J3aYDWU+gg2P7J+ZOmiJ0hkF5BXZDW7pVya7r40MXDy6ya0i9KamoENSVKIugvJNgFXIA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-ppc64-gnu": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.9.tgz", + "integrity": "sha512-a1tijMkdwsIARtc0F39ApURROkf3NwqinI6TOiSSWCTR7dT96dffNvMUtDHnq64wKNTIZOIlzKrFvvFUznJiyw==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-s390x-gnu": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.9.tgz", + "integrity": "sha512-x6SQNdAvv4c3hWqTMaWuawzMX9myaCs/yEmlGsxJzkdClnHW7FbrjQuSiRDhuSYzEYoEMhsaJy9qHG/XNemJPQ==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-x64-gnu": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.9.tgz", + "integrity": "sha512-9s0AZ8BFK5/n7B/TBoa2yJE3gI3KURrbXcPBlsAsvjU4VeJKgE90y1YtNxyEUIcHPQkg6/yfF3qihUrcM/Kf0Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-x64-musl": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.9.tgz", + "integrity": "sha512-P7VWAmV+WdJluH7ovnRGoiv2i8To7GAZ+kGzfGup635cyL7SyYl3lSUaA3Gp5THf0n/Co5EyEqb2zbqq+nMOHQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-openharmony-arm64": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.9.tgz", + "integrity": "sha512-1qixtsE4BK8h+yS3BfmZ09UhA7O/N4IACva6YBr7EBvCJraByTuRcgOTaiA62Tm0vey3UcKXLOaoGHtYmNGEVg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-win32-arm64-msvc": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.9.tgz", + "integrity": "sha512-ok8IQjcEPs1AKZfuEUznVBrJw+gK4soq+bx8b1X2XoMqVClarc1q5JDmVtWXY1xfr6ZuHTAsPXHTgTrqKTZeww==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-win32-x64-msvc": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.9.tgz", + "integrity": "sha512-Ip2mXoU0hM0boq3Rf+ekuT653OROSo6aSYcPT1VHE4q52KvyxgFkQgrgb/IEsxOuvQ2fZZbs8khJAyCEPM24/g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/pluginutils": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz", + "integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@sindresorhus/is": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@sindresorhus/is/-/is-4.6.0.tgz", + "integrity": "sha512-t09vSN3MdfsyCHoFcTRCH/iUtG7OJ0CsjzB8cjAmKc/va/kIgeDI/TxsigdncE/4be734m0cvIYwNaV4i2XqAw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sindresorhus/is?sponsor=1" + } + }, + "node_modules/@standard-schema/spec": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz", + "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==", + "license": "MIT" + }, + "node_modules/@tokenizer/inflate": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/@tokenizer/inflate/-/inflate-0.4.1.tgz", + "integrity": "sha512-2mAv+8pkG6GIZiF1kNg1jAjh27IDxEPKwdGul3snfztFerfPGI1LjDezZp3i7BElXompqEtPmoPx6c2wgtWsOA==", + "license": "MIT", + "dependencies": { + "debug": "^4.4.3", + "token-types": "^6.1.1" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/Borewit" + } + }, + "node_modules/@tokenizer/token": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/@tokenizer/token/-/token-0.3.0.tgz", + "integrity": "sha512-OvjF+z51L3ov0OyAU0duzsYuvO01PH7x4t6DJx+guahgTnBHkhJdG7soQeTSFLWN3efnHyibZ4Z8l2EuWwJN3A==", + "license": "MIT" + }, + "node_modules/@types/body-parser": { + "version": "1.19.6", + "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz", + "integrity": "sha512-HLFeCYgz89uk22N5Qg3dvGvsv46B8GLvKKo1zKG4NybA8U2DiEO3w9lqGg29t/tfLRJpJ6iQxnVw4OnB7MoM9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/connect": "*", + "@types/node": "*" + } + }, + "node_modules/@types/chai": { + "version": "5.2.3", + "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.3.tgz", + "integrity": "sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/deep-eql": "*", + "assertion-error": "^2.0.1" + } + }, + "node_modules/@types/connect": { + "version": "3.4.38", + "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz", + "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/cookiejar": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/@types/cookiejar/-/cookiejar-2.1.5.tgz", + "integrity": "sha512-he+DHOWReW0nghN24E1WUqM0efK4kI9oTqDm6XmK8ZPe2djZ90BSNdGnIyCLzCPw7/pogPlGbzI2wHGGmi4O/Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/deep-eql": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/@types/deep-eql/-/deep-eql-4.0.2.tgz", + "integrity": "sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/estree": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/express": { + "version": "5.0.6", + "resolved": "https://registry.npmjs.org/@types/express/-/express-5.0.6.tgz", + "integrity": "sha512-sKYVuV7Sv9fbPIt/442koC7+IIwK5olP1KWeD88e/idgoJqDm3JV/YUiPwkoKK92ylff2MGxSz1CSjsXelx0YA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/body-parser": "*", + "@types/express-serve-static-core": "^5.0.0", + "@types/serve-static": "^2" + } + }, + "node_modules/@types/express-serve-static-core": { + "version": "5.1.3", + "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-5.1.3.tgz", + "integrity": "sha512-dPfW8NFiOF4wOHc7+N/QSxlY9cfSsenewGbAz8C8U/MULPd/YZ27LvJUIlzaXie7e6Ove9YunJGgC9tbHD2cKw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*", + "@types/qs": "*", + "@types/range-parser": "*", + "@types/send": "*" + } + }, + "node_modules/@types/http-errors": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.5.tgz", + "integrity": "sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/methods": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/@types/methods/-/methods-1.1.4.tgz", + "integrity": "sha512-ymXWVrDiCxTBE3+RIrrP533E70eA+9qu7zdWoHuOmGujkYtzf4HQF96b8nwHLqhuf4ykX61IGRIB38CC6/sImQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/node": { + "version": "24.13.5", + "resolved": "https://registry.npmjs.org/@types/node/-/node-24.13.5.tgz", + "integrity": "sha512-TXyindR+lBr22aJIdMQzCFHPHR6cR4js838mRDCSz5hOKWZvZwsXSSiXDmjRj4iJmgl+sR9O+1mkoVBSMadNug==", + "dev": true, + "license": "MIT", + "dependencies": { + "undici-types": "~7.18.0" + } + }, + "node_modules/@types/qs": { + "version": "6.15.1", + "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.15.1.tgz", + "integrity": "sha512-GZHUBZR9hckSUhrxmp1nG6NwdpM9fCunJwyThLW1X3AyHgd9IlHb6VANpQQqDr2o/qQp6McZ3y/IA2rVzKzSbw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/range-parser": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.7.tgz", + "integrity": "sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/send": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/@types/send/-/send-1.2.1.tgz", + "integrity": "sha512-arsCikDvlU99zl1g69TcAB3mzZPpxgw0UQnaHeC1Nwb015xp8bknZv5rIfri9xTOcMuaVgvabfIRA7PSZVuZIQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/serve-static": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-2.2.0.tgz", + "integrity": "sha512-8mam4H1NHLtu7nmtalF7eyBH14QyOASmcxHhSfEoRyr0nP/YdoesEtU+uSRvMe96TW/HPTtkoKqQLl53N7UXMQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/http-errors": "*", + "@types/node": "*" + } + }, + "node_modules/@types/superagent": { + "version": "8.1.11", + "resolved": "https://registry.npmjs.org/@types/superagent/-/superagent-8.1.11.tgz", + "integrity": "sha512-KA7srSW/HENDtOw9DOqaFLgWuMqN9WgjEw62lh9dpvRaZDkhdOkazASd7X7i2eMUYLHa1U37ZttnePsH5zTDHw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/cookiejar": "^2.1.5", + "@types/methods": "^1.1.4", + "@types/node": "*", + "form-data": "^4.0.0" + } + }, + "node_modules/@types/supertest": { + "version": "7.2.1", + "resolved": "https://registry.npmjs.org/@types/supertest/-/supertest-7.2.1.tgz", + "integrity": "sha512-4CbBvoYVLHL7+yhbYrZET0vsvuyXTC05aRe7dNQkwMzm56auceoy6Yu3K50uZmwfHna1os3CMSgM/3QVkUtPTw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/methods": "^1.1.4", + "@types/superagent": "^8.1.0" + } + }, + "node_modules/@types/validator": { + "version": "13.15.10", + "resolved": "https://registry.npmjs.org/@types/validator/-/validator-13.15.10.tgz", + "integrity": "sha512-T8L6i7wCuyoK8A/ZeLYt1+q0ty3Zb9+qbSSvrIVitzT3YjZqkTZ40IbRsPanlB4h1QB3JVL1SYCdR6ngtFYcuA==", + "license": "MIT" + }, + "node_modules/@vitest/coverage-v8": { + "version": "4.1.11", + "resolved": "https://registry.npmjs.org/@vitest/coverage-v8/-/coverage-v8-4.1.11.tgz", + "integrity": "sha512-8MVGEFnJIcdGjcbfKmeq8z0pZHH0JlVtoVZH9Q/qwUp6wyFnEJUBMrw9DCaj+ra3vShGmhavjalMIhPNxZAUcw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@bcoe/v8-coverage": "^1.0.2", + "@vitest/utils": "4.1.11", + "ast-v8-to-istanbul": "^1.0.0", + "istanbul-lib-coverage": "^3.2.2", + "istanbul-lib-report": "^3.0.1", + "istanbul-reports": "^3.2.0", + "magicast": "^0.5.2", + "obug": "^2.1.1", + "std-env": "^4.0.0-rc.1", + "tinyrainbow": "^3.1.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "@vitest/browser": "4.1.11", + "vitest": "4.1.11" + }, + "peerDependenciesMeta": { + "@vitest/browser": { + "optional": true + } + } + }, + "node_modules/@vitest/expect": { + "version": "4.1.11", + "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.11.tgz", + "integrity": "sha512-VX2x5vNJXET47KAFzwERI+KRMtTTCSWTfSMKsW7JsUsXV4psq++e3DvZpuTDOpHcxytiDs6p2nhVb2tVDiiUYw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@standard-schema/spec": "^1.1.0", + "@types/chai": "^5.2.2", + "@vitest/spy": "4.1.11", + "@vitest/utils": "4.1.11", + "chai": "^6.2.2", + "tinyrainbow": "^3.1.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/mocker": { + "version": "4.1.11", + "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-4.1.11.tgz", + "integrity": "sha512-2XJVD55d1o5AZous5CCGKS74g/riOj9odEt2bQpCVZeblHyHdnMeFl4jl0XjU21stf4mbjUkew2eXQZt65g5CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/spy": "4.1.11", + "estree-walker": "^3.0.3", + "magic-string": "^0.30.21" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "msw": "^2.4.9", + "vite": "^6.0.0 || ^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "msw": { + "optional": true + }, + "vite": { + "optional": true + } + } + }, + "node_modules/@vitest/mocker/node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/@vitest/pretty-format": { + "version": "4.1.11", + "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-4.1.11.tgz", + "integrity": "sha512-yiZzPbGTS9Sr/JpFl8zHrcIkAofNbFV6k21vIgQN/cY/oxZeXhJv5sc/MBJ5jFKWmWs+oJHw0UXLZjmf931+Vw==", + "dev": true, + "license": "MIT", + "dependencies": { + "tinyrainbow": "^3.1.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/runner": { + "version": "4.1.11", + "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-4.1.11.tgz", + "integrity": "sha512-LztvUgdwMNJMIkj3hQnnxiC2Xy1zNxq928W/xhjCLaNCzqTZOudjwbQf6v9IntZGPw132i2Lq2rgTRZHD3JHNw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/utils": "4.1.11", + "pathe": "^2.0.3" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/snapshot": { + "version": "4.1.11", + "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-4.1.11.tgz", + "integrity": "sha512-pN7ikn1ON7h8ee4gIAp4AzyK+zBtJPzVbqOgu5LCEh4VaJVbPQcgYQYJIMGQPXVeJJq1fnfazis7a5pFNPahog==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/pretty-format": "4.1.11", + "@vitest/utils": "4.1.11", + "magic-string": "^0.30.21", + "pathe": "^2.0.3" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/snapshot/node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/@vitest/spy": { + "version": "4.1.11", + "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-4.1.11.tgz", + "integrity": "sha512-apNa/prQy2qCeywhnixOHPRCgGNhvg7T4Dapfl1GahLp/R+uhBm5cPyFoNVyqsNd2h1nJxL6BqqdIjiABL60YA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/utils": { + "version": "4.1.11", + "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-4.1.11.tgz", + "integrity": "sha512-zTCVGpyFsGWBhllOyKlTw/vnr6D9qxsfSDyfbyZmTyjHw5N/VuvzHpHoQjm2ZJzn4RJgx5w4r7V0er69CmLgPQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/pretty-format": "4.1.11", + "convert-source-map": "^2.0.0", + "tinyrainbow": "^3.1.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/abstract-logging": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/abstract-logging/-/abstract-logging-2.0.1.tgz", + "integrity": "sha512-2BjRTZxTPvheOvGbBslFSYOUkr+SjPtOnrLP33f+VIWLzezQpZcqVg7ja3L4dBXmzzgwT+a029jRx5PCi3JuiA==", + "license": "MIT" + }, + "node_modules/accepts": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz", + "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==", + "license": "MIT", + "dependencies": { + "mime-types": "^3.0.0", + "negotiator": "^1.0.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/ajv": { + "version": "8.20.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz", + "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ajv-formats": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz", + "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==", + "license": "MIT", + "dependencies": { + "ajv": "^8.0.0" + }, + "peerDependencies": { + "ajv": "^8.0.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, + "node_modules/ansi-escapes": { + "version": "4.3.2", + "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz", + "integrity": "sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "type-fest": "^0.21.3" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "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==", + "dev": true, + "license": "MIT", + "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, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/ansis": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/ansis/-/ansis-4.4.0.tgz", + "integrity": "sha512-9k3v7xcHwgdO/DruxGIg4HtjvlAZlcnsX/mzqUb1t3NkYnl9kK2UJ+Gq0io+vQf7iT//BD/HB/NBkUR1LWxoeA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=14" + } + }, + "node_modules/append-field": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/append-field/-/append-field-1.0.0.tgz", + "integrity": "sha512-klpgFSWLW1ZEs8svjfb7g4qWY0YS5imI82dTg+QahUvJ8YqAY0P10Uk8tTyh9ZGuYEZEMaeJYCF5BFuX552hsw==", + "license": "MIT" + }, + "node_modules/array-timsort": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/array-timsort/-/array-timsort-1.0.3.tgz", + "integrity": "sha512-/+3GRL7dDAGEfM6TseQk/U+mi18TU2Ms9I3UlLdUMhz2hbvGNTKdj9xniwXfUqgYhHxRx0+8UnKkvlNwVU+cWQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/asap": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/asap/-/asap-2.0.6.tgz", + "integrity": "sha512-BSHWgDSAiKs50o2Re8ppvp3seVHXSRM44cdSsT9FfNEUUZLOGWVCsiWaRPWM1Znn+mqZ1OfVZ3z3DWEzSp7hRA==", + "dev": true, + "license": "MIT" + }, + "node_modules/assertion-error": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz", + "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + } + }, + "node_modules/ast-v8-to-istanbul": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/ast-v8-to-istanbul/-/ast-v8-to-istanbul-1.0.6.tgz", + "integrity": "sha512-fvpl29helSO2w/z7utIbrkNXILdrLwDwAMH2I/zPKlGf5244+gf+B4cyS1sANcrPY2h+hWCGSgC8N61s/+AF9A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/trace-mapping": "^0.3.31", + "estree-walker": "^3.0.3", + "js-tokens": "^10.0.0" + } + }, + "node_modules/asynckit": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", + "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/atomic-sleep": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/atomic-sleep/-/atomic-sleep-1.0.0.tgz", + "integrity": "sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ==", + "license": "MIT", + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/avvio": { + "version": "9.3.0", + "resolved": "https://registry.npmjs.org/avvio/-/avvio-9.3.0.tgz", + "integrity": "sha512-g2tQ7LE7oOSqDfwEm3M+ZCMTJc7KiZCdJ4UwyZJb5ckTKyYu50OYmvv0mCFXPuYXoM4zkSt8zM9XQ9KCvxA74A==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "@fastify/error": "^4.0.0", + "fastq": "^1.17.1" + } + }, + "node_modules/balanced-match": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", + "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "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" + } + ], + "license": "MIT" + }, + "node_modules/bl": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz", + "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "buffer": "^5.5.0", + "inherits": "^2.0.4", + "readable-stream": "^3.4.0" + } + }, + "node_modules/body-parser": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.3.0.tgz", + "integrity": "sha512-2cGmJupaNgg+QUwVLAucDuWuoMZ6EX9iHDRswZ5lsNYEmwPaRknMPCLZz07yTzVq/83p4o/wzbDZbBrTvGGTIw==", + "license": "MIT", + "dependencies": { + "bytes": "^3.1.2", + "content-type": "^2.0.0", + "debug": "^4.4.3", + "http-errors": "^2.0.1", + "iconv-lite": "^0.7.2", + "on-finished": "^2.4.1", + "qs": "^6.15.2", + "raw-body": "^3.0.2", + "type-is": "^2.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/body-parser/node_modules/content-type": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-2.1.0.tgz", + "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/brace-expansion": { + "version": "5.0.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.12.tgz", + "integrity": "sha512-YovQ3rzhaLMIrDjNDMkNS01tea93qhEhG5xy8f6+R0l+dw3Ki+5sCoIoI942iuLZTHWogWktgwVDhU09iNEimQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^4.0.2" + }, + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/buffer": { + "version": "5.7.1", + "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz", + "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==", + "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" + } + ], + "license": "MIT", + "dependencies": { + "base64-js": "^1.3.1", + "ieee754": "^1.1.13" + } + }, + "node_modules/buffer-from": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz", + "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/busboy": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/busboy/-/busboy-1.6.0.tgz", + "integrity": "sha512-8SFQbg/0hQ9xy3UNTB0YEnsNBbWfhf7RtnzpL7TkBiTBRfrQ9Fxcnz7VJsleJpyp6rVLvXiuORqjlHi5q+PYuA==", + "dependencies": { + "streamsearch": "^1.1.0" + }, + "engines": { + "node": ">=10.16.0" + } + }, + "node_modules/bytes": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", + "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/call-bound": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz", + "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "get-intrinsic": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/chai": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/chai/-/chai-6.2.2.tgz", + "integrity": "sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "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, + "license": "MIT", + "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/char-regex": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/char-regex/-/char-regex-1.0.2.tgz", + "integrity": "sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/chardet": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/chardet/-/chardet-2.2.0.tgz", + "integrity": "sha512-rddelWYNPRrXq6PtNEN2S3f6t9ILzvqaN5pVgi4kqt9jHQaXIial9PznB5iSPVlQSLNaaH22ItWz3EJtQ10+OA==", + "dev": true, + "license": "MIT" + }, + "node_modules/chokidar": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz", + "integrity": "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==", + "dev": true, + "license": "MIT", + "dependencies": { + "readdirp": "^5.0.0" + }, + "engines": { + "node": ">= 20.19.0" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/class-transformer": { + "version": "0.5.1", + "resolved": "https://registry.npmjs.org/class-transformer/-/class-transformer-0.5.1.tgz", + "integrity": "sha512-SQa1Ws6hUbfC98vKGxZH3KFY0Y1lm5Zm0SY8XX9zbK7FJCyVEac3ATW0RIpwzW+oOfmHE5PMPufDG9hCfoEOMw==", + "license": "MIT" + }, + "node_modules/class-validator": { + "version": "0.15.1", + "resolved": "https://registry.npmjs.org/class-validator/-/class-validator-0.15.1.tgz", + "integrity": "sha512-LqoS80HBBSCVhz/3KloUly0ovokxpdOLR++Al3J3+dHXWt9sTKlKd4eYtoxhxyUjoe5+UcIM+5k9MIxyBWnRTw==", + "license": "MIT", + "dependencies": { + "@types/validator": "^13.15.3", + "libphonenumber-js": "^1.11.1", + "validator": "^13.15.22" + } + }, + "node_modules/cli-cursor": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-3.1.0.tgz", + "integrity": "sha512-I/zHAwsKf9FqGoXM4WWRACob9+SNukZTd94DWF57E4toouRulbCxcUh6RKUEOQlYTHJnzkPMySvPNaaSLNfLZw==", + "dev": true, + "license": "MIT", + "dependencies": { + "restore-cursor": "^3.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/cli-progress": { + "version": "3.12.0", + "resolved": "https://registry.npmjs.org/cli-progress/-/cli-progress-3.12.0.tgz", + "integrity": "sha512-tRkV3HJ1ASwm19THiiLIXLO7Im7wlTuKnvkYaTkyoAPefqjNg7W7DHKUlGRxy9vxDvbyCYQkQozvptuMkGCg8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "string-width": "^4.2.3" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/cli-spinners": { + "version": "3.4.0", + "resolved": "https://registry.npmjs.org/cli-spinners/-/cli-spinners-3.4.0.tgz", + "integrity": "sha512-bXfOC4QcT1tKXGorxL3wbJm6XJPDqEnij2gQ2m7ESQuE+/z9YFIWnl/5RpTiKWbMq3EVKR4fRLJGn6DVfu0mpw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18.20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cli-table3": { + "version": "0.6.5", + "resolved": "https://registry.npmjs.org/cli-table3/-/cli-table3-0.6.5.tgz", + "integrity": "sha512-+W/5efTR7y5HRD7gACw9yQjqMVvEMLBHmboM/kPWam+H+Hmyrgjh6YncVKK122YZkXrLudzTuAukUw9FnMf7IQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "string-width": "^4.2.0" + }, + "engines": { + "node": "10.* || >= 12.*" + }, + "optionalDependencies": { + "@colors/colors": "1.5.0" + } + }, + "node_modules/cli-width": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/cli-width/-/cli-width-4.1.0.tgz", + "integrity": "sha512-ouuZd4/dm2Sw5Gmqy6bGyNNNe1qt9RpmxveLSO7KcgsTnU7RXfsw+/bukWGo1abgBiMAic068rclZsO4IWmmxQ==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">= 12" + } + }, + "node_modules/clone": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/clone/-/clone-1.0.4.tgz", + "integrity": "sha512-JQHZ2QMW6l3aH/j6xCqQThY/9OH4D/9ls34cgkUBiEeocRTU04tHfKPBsUK1PqZCUQM7GiA0IIXJSuXHI64Kbg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8" + } + }, + "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, + "license": "MIT", + "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, + "license": "MIT" + }, + "node_modules/combined-stream": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", + "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", + "dev": true, + "license": "MIT", + "dependencies": { + "delayed-stream": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/commander": { + "version": "15.0.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-15.0.0.tgz", + "integrity": "sha512-z67u4ZhzCL/Tydu1lJARtEZYWbWaN7oYLHbsuzocr6y4N6WZAagG3RQ4FW61V1/0+jImpj293XfrcYnd1qxtPg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/comment-json": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/comment-json/-/comment-json-5.0.0.tgz", + "integrity": "sha512-uiqLcOiVDJtBP8WGkZHEP+FZIhTzP1dxvn59EfoYUi9gqupjrBWVQkO2atDrbnKPwLeotFYDsuNb26uBMqB+hw==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-timsort": "^1.0.3", + "esprima": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/component-emitter": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/component-emitter/-/component-emitter-1.3.1.tgz", + "integrity": "sha512-T0+barUSQRTUQASh8bx02dl+DhF54GtIDY13Y3m9oWTklKbb3Wv974meRpeZ3lp1JpLVECWWNHC4vaG2XHXouQ==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/content-disposition": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.1.0.tgz", + "integrity": "sha512-5jRCH9Z/+DRP7rkvY83B+yGIGX96OYdJmzngqnw2SBSxqCFPd0w2km3s5iawpGX8krnwSGmF0FW5Nhr0Hfai3g==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/content-type": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz", + "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/convert-source-map": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz", + "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==", + "dev": true, + "license": "MIT" + }, + "node_modules/cookie": { + "version": "0.7.2", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz", + "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/cookie-signature": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.2.2.tgz", + "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==", + "license": "MIT", + "engines": { + "node": ">=6.6.0" + } + }, + "node_modules/cookiejar": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/cookiejar/-/cookiejar-2.1.4.tgz", + "integrity": "sha512-LDx6oHrK+PhzLKJU9j5S7/Y3jM/mUHvD/DeI1WQmJn652iPC5Y4TBzC9l+5OMOXlyTTA+SmVUPm0HQUwpD5Jqw==", + "dev": true, + "license": "MIT" + }, + "node_modules/cors": { + "version": "2.8.6", + "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz", + "integrity": "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==", + "license": "MIT", + "dependencies": { + "object-assign": "^4", + "vary": "^1" + }, + "engines": { + "node": ">= 0.10" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/defaults": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/defaults/-/defaults-1.0.4.tgz", + "integrity": "sha512-eFuaLoy/Rxalv2kr+lqMlUnrDWV+3j4pljOIJgLIhI058IQfWJ7vXhyEIHu+HtC738klGALYxOKDO0bQP3tg8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "clone": "^1.0.2" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/delayed-stream": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", + "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/depd": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz", + "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/dequal": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz", + "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/detect-libc": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=8" + } + }, + "node_modules/dezalgo": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/dezalgo/-/dezalgo-1.0.4.tgz", + "integrity": "sha512-rXSP0bf+5n0Qonsb+SVVfNfIsimO4HEtmnIpPHY8Q1UCzKlQrDMfdobr8nJOOsRgWCyMRqeSBQzmWUMq7zvVig==", + "dev": true, + "license": "ISC", + "dependencies": { + "asap": "^2.0.0", + "wrappy": "1" + } + }, + "node_modules/dotenv": { + "version": "17.4.2", + "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.4.2.tgz", + "integrity": "sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://dotenvx.com" + } + }, + "node_modules/dotenv-expand": { + "version": "13.0.0", + "resolved": "https://registry.npmjs.org/dotenv-expand/-/dotenv-expand-13.0.0.tgz", + "integrity": "sha512-aBfBS8eYIeXmpHI9ThIlA7/WLq+SLt18iXUZhb52rW89QLKQFoIpPG1bPeewoPZsTyjSSO3T7234FBVUM1V2rA==", + "license": "BSD-2-Clause", + "dependencies": { + "dotenv": "^17.4.2" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://dotenvx.com" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/ee-first": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", + "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==", + "license": "MIT" + }, + "node_modules/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==", + "dev": true, + "license": "MIT" + }, + "node_modules/emojilib": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/emojilib/-/emojilib-2.4.0.tgz", + "integrity": "sha512-5U0rVMU5Y2n2+ykNLQqMoqklN9ICBT/KsvC1Gz6vqHbz2AXXGkG+Pm5rMWk/8Vjrr/mY9985Hi8DYzn1F09Nyw==", + "dev": true, + "license": "MIT" + }, + "node_modules/encodeurl": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz", + "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-module-lexer": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.3.2.tgz", + "integrity": "sha512-poHGpORABojJJucnV9KbOavETW8lBVnphkW77ER5/BQ5Fz7oXSoCNek7IH3vR5nRjdsEz926ibFYX8KtLQmdyw==", + "dev": true, + "license": "MIT" + }, + "node_modules/es-object-atoms": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz", + "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-set-tostringtag": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz", + "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.6", + "has-tostringtag": "^1.0.2", + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-toolkit": { + "version": "1.51.0", + "resolved": "https://registry.npmjs.org/es-toolkit/-/es-toolkit-1.51.0.tgz", + "integrity": "sha512-zC2lQGkM7QX+Gm6iM3+WIdZJzthsEd14LvRNJneSO2hzyz/zNBENR8+YXWo1cKxgPBtV6ksPYHELbcwBRzmdCw==", + "license": "MIT", + "workspaces": [ + "docs", + "benchmarks", + "tests/types", + "tests/browser-compat" + ] + }, + "node_modules/escape-html": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", + "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==", + "license": "MIT" + }, + "node_modules/escape-string-regexp": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz", + "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/esprima": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz", + "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==", + "dev": true, + "license": "BSD-2-Clause", + "bin": { + "esparse": "bin/esparse.js", + "esvalidate": "bin/esvalidate.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/estree-walker": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz", + "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0" + } + }, + "node_modules/etag": { + "version": "1.8.1", + "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", + "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/expect-type": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.4.0.tgz", + "integrity": "sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/express": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/express/-/express-5.2.1.tgz", + "integrity": "sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==", + "license": "MIT", + "dependencies": { + "accepts": "^2.0.0", + "body-parser": "^2.2.1", + "content-disposition": "^1.0.0", + "content-type": "^1.0.5", + "cookie": "^0.7.1", + "cookie-signature": "^1.2.1", + "debug": "^4.4.0", + "depd": "^2.0.0", + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "etag": "^1.8.1", + "finalhandler": "^2.1.0", + "fresh": "^2.0.0", + "http-errors": "^2.0.0", + "merge-descriptors": "^2.0.0", + "mime-types": "^3.0.0", + "on-finished": "^2.4.1", + "once": "^1.4.0", + "parseurl": "^1.3.3", + "proxy-addr": "^2.0.7", + "qs": "^6.14.0", + "range-parser": "^1.2.1", + "router": "^2.2.0", + "send": "^1.1.0", + "serve-static": "^2.2.0", + "statuses": "^2.0.1", + "type-is": "^2.0.1", + "vary": "^1.1.2" + }, + "engines": { + "node": ">= 18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/external-editor": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/external-editor/-/external-editor-3.1.0.tgz", + "integrity": "sha512-hMQ4CX1p1izmuLYyZqLMO/qGNw10wSv9QDCPfzXfyFrOaCSSoRfqE1Kf1s5an66J5JZC62NewG+mK49jOCtQew==", + "dev": true, + "license": "MIT", + "dependencies": { + "chardet": "^0.7.0", + "iconv-lite": "^0.4.24", + "tmp": "^0.0.33" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/external-editor/node_modules/chardet": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/chardet/-/chardet-0.7.0.tgz", + "integrity": "sha512-mT8iDcrh03qDGRRmoA2hmBJnxpllMR+0/0qlzjqZES6NdiWDcZkCNAk4rPFZ9Q85r27unkiNNg8ZOiwZXBHwcA==", + "dev": true, + "license": "MIT" + }, + "node_modules/external-editor/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==", + "dev": true, + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/fast-decode-uri-component": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/fast-decode-uri-component/-/fast-decode-uri-component-1.0.1.tgz", + "integrity": "sha512-WKgKWg5eUxvRZGwW8FvfbaH7AXSh2cL+3j5fMGzUMCxWBJ3dV3a7Wz8y2f/uQ0e3B6WmodD3oS54jTQ9HVTIIg==", + "license": "MIT" + }, + "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==", + "license": "MIT" + }, + "node_modules/fast-json-stringify": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/fast-json-stringify/-/fast-json-stringify-7.0.1.tgz", + "integrity": "sha512-eRSayARSbbwlBjpP4vnTTIRD5QPcIrmihPxDeN1DtKnHPg66UuJLx+8hlK1kaFdjvzyQ/dzALoi4vwAQ+T+iZA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "@fastify/merge-json-schemas": "^0.2.0", + "ajv": "^8.12.0", + "ajv-formats": "^3.0.1", + "fast-uri": "^4.0.0", + "json-schema-ref-resolver": "^3.0.0", + "rfdc": "^1.2.0" + } + }, + "node_modules/fast-json-stringify/node_modules/fast-uri": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-4.2.1.tgz", + "integrity": "sha512-TmHQgewjHtMq1E5QKA0tOE0yeYGQs25KZC/ziJpubRtWI15W92e6vPFydWOeZBVROSHBYw/QhD9d5OefdD6LDg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/fast-querystring": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/fast-querystring/-/fast-querystring-1.1.2.tgz", + "integrity": "sha512-g6KuKWmFXc0fID8WWH0jit4g0AGBoJhCkJMb1RmbsSEUNvQ+ZC8D6CUZ+GtF8nMzSPXnhiePyyqqipzNNEnHjg==", + "license": "MIT", + "dependencies": { + "fast-decode-uri-component": "^1.0.1" + } + }, + "node_modules/fast-safe-stringify": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/fast-safe-stringify/-/fast-safe-stringify-2.1.1.tgz", + "integrity": "sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==", + "license": "MIT" + }, + "node_modules/fast-string-truncated-width": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/fast-string-truncated-width/-/fast-string-truncated-width-3.0.3.tgz", + "integrity": "sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-string-width": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/fast-string-width/-/fast-string-width-3.0.2.tgz", + "integrity": "sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-string-truncated-width": "^3.0.2" + } + }, + "node_modules/fast-uri": { + "version": "3.1.8", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.8.tgz", + "integrity": "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/fast-wrap-ansi": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/fast-wrap-ansi/-/fast-wrap-ansi-0.2.2.tgz", + "integrity": "sha512-7F2Fl+TjRSenLqlU3UjSH0iyqopqoZIu7eZVpEirP2g1GtWa2G/ecEmBdgz31+Mxr+ELclgg6sokpSFIQiZ02Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-string-width": "^3.0.2" + } + }, + "node_modules/fastify": { + "version": "5.12.5", + "resolved": "https://registry.npmjs.org/fastify/-/fastify-5.12.5.tgz", + "integrity": "sha512-OB2k1dlxs5/NAABqeKV2FUHkSD2BbENsCak8yULVcymn3fHIPDVa9TI3SDnJSWYSllZmSYuZXy2gTnsT+Sut1A==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "@fastify/ajv-compiler": "^4.0.5", + "@fastify/error": "^4.0.0", + "@fastify/fast-json-stringify-compiler": "^5.0.0", + "@fastify/proxy-addr": "^5.0.0", + "abstract-logging": "^2.0.1", + "avvio": "^9.0.0", + "fast-json-stringify": "^7.0.0", + "find-my-way": "^9.6.0", + "light-my-request": "^6.0.0", + "pino": "^9.14.0 || ^10.1.0", + "process-warning": "^5.1.0", + "rfdc": "^1.3.1", + "secure-json-parse": "^4.0.0", + "semver": "^7.6.0", + "toad-cache": "^3.7.0" + } + }, + "node_modules/fastify-plugin": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/fastify-plugin/-/fastify-plugin-6.0.0.tgz", + "integrity": "sha512-fZOty7z3O7vOliF6d8bHE3wiEh1KcNnKEQensSgTk9C1DvN6nRLS++XVd86v33Hw/8u9Un8A1zDrQ8ujcQDHEg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT" + }, + "node_modules/fastq": { + "version": "1.20.3", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.3.tgz", + "integrity": "sha512-XKv5nnLs6nLF71NgiKJLIZFLkPyIEuOselLG7ujZnGrRfQK8HpvY+WqKhAJUAdLomwVHErVS4LfxFlPq0/FTAw==", + "license": "ISC", + "dependencies": { + "reusify": "^1.0.4" + } + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/figures": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/figures/-/figures-3.2.0.tgz", + "integrity": "sha512-yaduQFRKLXYOGgEn6AZau90j3ggSOyiqXU0F9JZfeXYhNa+Jk4X+s45A2zg5jns87GAFa34BBm2kXw4XpNcbdg==", + "dev": true, + "license": "MIT", + "dependencies": { + "escape-string-regexp": "^1.0.5" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/file-type": { + "version": "22.1.0", + "resolved": "https://registry.npmjs.org/file-type/-/file-type-22.1.0.tgz", + "integrity": "sha512-fbvf9u6jnHWr1EP6V8R99E9iLMhNLXgZkUzWBiPpJ5/89UJ/Atuxjn5YXR+XaZWo2hc2/8mGfTez+NDAgOcpLA==", + "license": "MIT", + "dependencies": { + "@tokenizer/inflate": "^0.4.1", + "strtok3": "^10.3.5", + "token-types": "^6.1.2", + "uint8array-extras": "^1.5.0" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/sindresorhus/file-type?sponsor=1" + } + }, + "node_modules/finalhandler": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz", + "integrity": "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==", + "license": "MIT", + "dependencies": { + "debug": "^4.4.0", + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "on-finished": "^2.4.1", + "parseurl": "^1.3.3", + "statuses": "^2.0.1" + }, + "engines": { + "node": ">= 18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/find-my-way": { + "version": "9.9.0", + "resolved": "https://registry.npmjs.org/find-my-way/-/find-my-way-9.9.0.tgz", + "integrity": "sha512-sJsgZ1sQH2UDuowPuMKg8az7Qc8F0jnj+SKkFWU/+T0xcFlgV5skgXOGUqmQzOdmW6ALA7AhJINWx3qFBkbLHA==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3", + "fast-querystring": "^1.0.0", + "safe-regex2": "^5.0.0" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/form-data": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.6.tgz", + "integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.8", + "es-set-tostringtag": "^2.1.0", + "hasown": "^2.0.4", + "mime-types": "^2.1.35" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/form-data/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==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/form-data/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==", + "dev": true, + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/formidable": { + "version": "3.5.4", + "resolved": "https://registry.npmjs.org/formidable/-/formidable-3.5.4.tgz", + "integrity": "sha512-YikH+7CUTOtP44ZTnUhR7Ic2UASBPOqmaRkRKxRbywPTe5VxF7RRCck4af9wutiZ/QKM5nME9Bie2fFaPz5Gug==", + "dev": true, + "license": "MIT", + "dependencies": { + "@paralleldrive/cuid2": "^2.2.2", + "dezalgo": "^1.0.4", + "once": "^1.4.0" + }, + "engines": { + "node": ">=14.0.0" + }, + "funding": { + "url": "https://ko-fi.com/tunnckoCore/commissions" + } + }, + "node_modules/forwarded": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz", + "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/fresh": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz", + "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "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, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-east-asian-width": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.7.0.tgz", + "integrity": "sha512-XjH1AECxf0giL2V1aU8vKyRR2ppRUb5c0EvT7zuJTokQ74bNo52zOtghqdWIqrhUD79fo3x0WfKZdOqxF6LG1Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/globrex": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/globrex/-/globrex-0.1.2.tgz", + "integrity": "sha512-uHJgbwAMwNFf5mLst7IWLNg14x1CkeqglJb/K3doi4dw6q2IvAAmM/Y81kevy83wP+Sst+nutFTYOGg3d1lsxg==", + "dev": true, + "license": "MIT" + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-tostringtag": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz", + "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-symbols": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz", + "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/html-escaper": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz", + "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==", + "dev": true, + "license": "MIT" + }, + "node_modules/http-errors": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz", + "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==", + "license": "MIT", + "dependencies": { + "depd": "~2.0.0", + "inherits": "~2.0.4", + "setprototypeof": "~1.2.0", + "statuses": "~2.0.2", + "toidentifier": "~1.0.1" + }, + "engines": { + "node": ">= 0.8" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/iconv-lite": { + "version": "0.7.3", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.3.tgz", + "integrity": "sha512-IKXpvIzjnC9XTAUbVBcMfGS0EPaIXtW6v+zr+RRp+hqULEpo0owZax6wyRwPOJbWbzjYspQwusTsfVr0ifh4uQ==", + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "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" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "license": "ISC" + }, + "node_modules/inquirer": { + "version": "8.2.6", + "resolved": "https://registry.npmjs.org/inquirer/-/inquirer-8.2.6.tgz", + "integrity": "sha512-M1WuAmb7pn9zdFRtQYk26ZBoY043Sse0wVDdk4Bppr+JOXyQYybdtvK+l9wUibhtjdjvtoiNy8tk+EgsYIUqKg==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-escapes": "^4.2.1", + "chalk": "^4.1.1", + "cli-cursor": "^3.1.0", + "cli-width": "^3.0.0", + "external-editor": "^3.0.3", + "figures": "^3.0.0", + "lodash": "^4.17.21", + "mute-stream": "0.0.8", + "ora": "^5.4.1", + "run-async": "^2.4.0", + "rxjs": "^7.5.5", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0", + "through": "^2.3.6", + "wrap-ansi": "^6.0.1" + }, + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/inquirer/node_modules/cli-spinners": { + "version": "2.9.2", + "resolved": "https://registry.npmjs.org/cli-spinners/-/cli-spinners-2.9.2.tgz", + "integrity": "sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/inquirer/node_modules/cli-width": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/cli-width/-/cli-width-3.0.0.tgz", + "integrity": "sha512-FxqpkPPwu1HjuN93Omfm4h8uIanXofW0RxVEW3k5RKx+mJJYSthzNhp32Kzxxy3YAEZ/Dc/EWN1vZRY0+kOhbw==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">= 10" + } + }, + "node_modules/inquirer/node_modules/is-interactive": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-interactive/-/is-interactive-1.0.0.tgz", + "integrity": "sha512-2HvIEKRoqS62guEC+qBjpvRubdX910WCMuJTZ+I9yvqKU2/12eSL549HMwtabb4oupdj2sMP50k+XJfB/8JE6w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/inquirer/node_modules/is-unicode-supported": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-0.1.0.tgz", + "integrity": "sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/inquirer/node_modules/log-symbols": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-4.1.0.tgz", + "integrity": "sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^4.1.0", + "is-unicode-supported": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/inquirer/node_modules/mute-stream": { + "version": "0.0.8", + "resolved": "https://registry.npmjs.org/mute-stream/-/mute-stream-0.0.8.tgz", + "integrity": "sha512-nnbWWOkoWyUsTjKrhgD0dcz22mdkSnpYqbEjIm2nhwhuxlSkpywJmBo8h0ZqJdkp73mb90SssHkN4rsRaBAfAA==", + "dev": true, + "license": "ISC" + }, + "node_modules/inquirer/node_modules/ora": { + "version": "5.4.1", + "resolved": "https://registry.npmjs.org/ora/-/ora-5.4.1.tgz", + "integrity": "sha512-5b6Y85tPxZZ7QytO+BQzysW31HJku27cRIlkbAXaNx+BdcVi+LlRFmVXzeF6a7JCwJpyw5c4b+YSVImQIrBpuQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "bl": "^4.1.0", + "chalk": "^4.1.0", + "cli-cursor": "^3.1.0", + "cli-spinners": "^2.5.0", + "is-interactive": "^1.0.0", + "is-unicode-supported": "^0.1.0", + "log-symbols": "^4.1.0", + "strip-ansi": "^6.0.0", + "wcwidth": "^1.0.1" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ipaddr.js": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz", + "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==", + "license": "MIT", + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/is-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==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-interactive": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-interactive/-/is-interactive-2.0.0.tgz", + "integrity": "sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-promise": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz", + "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==", + "license": "MIT" + }, + "node_modules/is-unicode-supported": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-2.1.0.tgz", + "integrity": "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/istanbul-lib-coverage": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz", + "integrity": "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=8" + } + }, + "node_modules/istanbul-lib-report": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz", + "integrity": "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "istanbul-lib-coverage": "^3.0.0", + "make-dir": "^4.0.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/istanbul-reports": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.2.0.tgz", + "integrity": "sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "html-escaper": "^2.0.0", + "istanbul-lib-report": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/iterare": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/iterare/-/iterare-1.2.1.tgz", + "integrity": "sha512-RKYVTCjAnRthyJes037NX/IiqeidgN1xc3j1RjFfECFp28A1GVwK9nA+i0rJPaHqSZwygLzRnFlzUuHFoWWy+Q==", + "license": "ISC", + "engines": { + "node": ">=6" + } + }, + "node_modules/js-tokens": { + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-10.0.0.tgz", + "integrity": "sha512-lM/UBzQmfJRo9ABXbPWemivdCW8V2G8FHaHdypQaIy523snUjog0W71ayWXTjiR+ixeMyVHN2XcpnTd/liPg/Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-schema-ref-resolver": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/json-schema-ref-resolver/-/json-schema-ref-resolver-3.0.0.tgz", + "integrity": "sha512-hOrZIVL5jyYFjzk7+y7n5JDzGlU8rfWDuYyHwGa2WA8/pcmMHezp2xsVwxrebD/Q9t8Nc5DboieySDpCp4WG4A==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "dequal": "^2.0.3" + } + }, + "node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/json5": { + "version": "2.2.3", + "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz", + "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==", + "dev": true, + "license": "MIT", + "bin": { + "json5": "lib/cli.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/jsonc-parser": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-3.3.1.tgz", + "integrity": "sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/libphonenumber-js": { + "version": "1.13.13", + "resolved": "https://registry.npmjs.org/libphonenumber-js/-/libphonenumber-js-1.13.13.tgz", + "integrity": "sha512-hV6SmWnyQ8U1QXhhqbqYBHIStNnscG7A5XbGodgdHhf/8N5PwhYpJA5U/yHDjYwPYTd8uNGXqq416XctuvK2PA==", + "license": "MIT" + }, + "node_modules/light-my-request": { + "version": "6.6.0", + "resolved": "https://registry.npmjs.org/light-my-request/-/light-my-request-6.6.0.tgz", + "integrity": "sha512-CHYbu8RtboSIoVsHZ6Ye4cj4Aw/yg2oAFimlF7mNvfDV192LR7nDiKtSIfCuLT7KokPSTn/9kfVLm5OGN0A28A==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause", + "dependencies": { + "cookie": "^1.0.1", + "process-warning": "^4.0.0", + "set-cookie-parser": "^2.6.0" + } + }, + "node_modules/light-my-request/node_modules/cookie": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.1.1.tgz", + "integrity": "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/light-my-request/node_modules/process-warning": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/process-warning/-/process-warning-4.0.1.tgz", + "integrity": "sha512-3c2LzQ3rY9d0hc1emcsHhfT9Jwz0cChib/QN89oME2R451w5fy3f0afAhERFZAwrbDU43wk12d0ORBpDVME50Q==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT" + }, + "node_modules/lightningcss": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.33.0.tgz", + "integrity": "sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==", + "dev": true, + "license": "MPL-2.0", + "dependencies": { + "detect-libc": "^2.0.3" + }, + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + }, + "optionalDependencies": { + "lightningcss-android-arm64": "1.33.0", + "lightningcss-darwin-arm64": "1.33.0", + "lightningcss-darwin-x64": "1.33.0", + "lightningcss-freebsd-x64": "1.33.0", + "lightningcss-linux-arm-gnueabihf": "1.33.0", + "lightningcss-linux-arm64-gnu": "1.33.0", + "lightningcss-linux-arm64-musl": "1.33.0", + "lightningcss-linux-x64-gnu": "1.33.0", + "lightningcss-linux-x64-musl": "1.33.0", + "lightningcss-win32-arm64-msvc": "1.33.0", + "lightningcss-win32-x64-msvc": "1.33.0" + } + }, + "node_modules/lightningcss-android-arm64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.33.0.tgz", + "integrity": "sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-darwin-arm64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.33.0.tgz", + "integrity": "sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-darwin-x64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.33.0.tgz", + "integrity": "sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-freebsd-x64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.33.0.tgz", + "integrity": "sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm-gnueabihf": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.33.0.tgz", + "integrity": "sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm64-gnu": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.33.0.tgz", + "integrity": "sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm64-musl": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.33.0.tgz", + "integrity": "sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-x64-gnu": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.33.0.tgz", + "integrity": "sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-x64-musl": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.33.0.tgz", + "integrity": "sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-win32-arm64-msvc": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.33.0.tgz", + "integrity": "sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-win32-x64-msvc": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.33.0.tgz", + "integrity": "sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/load-esm": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/load-esm/-/load-esm-1.0.3.tgz", + "integrity": "sha512-v5xlu8eHD1+6r8EHTg6hfmO97LN8ugKtiXcy5e6oN72iD2r6u0RPfLl6fxM+7Wnh2ZRq15o0russMst44WauPA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/Borewit" + }, + { + "type": "buymeacoffee", + "url": "https://buymeacoffee.com/borewit" + } + ], + "license": "MIT", + "engines": { + "node": ">=13.2.0" + } + }, + "node_modules/lodash": { + "version": "4.18.1", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz", + "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/log-symbols": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-7.0.1.tgz", + "integrity": "sha512-ja1E3yCr9i/0hmBVaM0bfwDjnGy8I/s6PP4DFp+yP+a+mrHO4Rm7DtmnqROTUkHIkqffC84YY7AeqX6oFk0WFg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-unicode-supported": "^2.0.0", + "yoctocolors": "^2.1.1" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/magic-string": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.0.0.tgz", + "integrity": "sha512-CGvjzMN08iv6w1mm4/x3Gh1hLb4VnyRUA15FFpl6CsCIGGoe36k7kY5KNz9QDbSBN5I/fWHM6ZlIkUTa5xdUEA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/magicast": { + "version": "0.5.5", + "resolved": "https://registry.npmjs.org/magicast/-/magicast-0.5.5.tgz", + "integrity": "sha512-UicdXN8zQ3JHlxVq+28afMXPr1z7WNY6+7EJnzTdQWkTAlMLF5fNCCKxJHBQwGaNGR11581EiQmQzx73+MvszA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.7", + "@babel/types": "^7.29.7", + "source-map-js": "^1.2.1" + } + }, + "node_modules/make-dir": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-4.0.0.tgz", + "integrity": "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==", + "dev": true, + "license": "MIT", + "dependencies": { + "semver": "^7.5.3" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/media-typer": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.1.tgz", + "integrity": "sha512-yz3xRaG20c6/BOzvYoDaGtPmGscs7YivItZEEqe6GbwNfHuxu9YNmvnEkMzKldAGY4/80pRcQRZSEnhquk9XuQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/merge-descriptors": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz", + "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/methods": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", + "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime": { + "version": "2.6.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-2.6.0.tgz", + "integrity": "sha512-USPkMeET31rOMiarsBNIHZKLGgvKc/LrjofAnBlOttf5ajRvqiRA8QsenbcooctK6d6Ts6aqZXBA+XbkKthiQg==", + "dev": true, + "license": "MIT", + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/mime-db": { + "version": "1.54.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz", + "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz", + "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==", + "license": "MIT", + "dependencies": { + "mime-db": "^1.54.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/mimic-fn": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz", + "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/mimic-function": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/mimic-function/-/mimic-function-5.0.1.tgz", + "integrity": "sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/minimatch": { + "version": "10.2.6", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.6.tgz", + "integrity": "sha512-vpLQEs+VLCr1nU0BXS07maYoFwlDAH0gngQuuttxIwutDFEMHq2blX+8vpgxDdK3J1PwjCJiep77OitTZ4Ll1A==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "brace-expansion": "^5.0.8" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/minimist": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", + "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/multer": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/multer/-/multer-2.4.0.tgz", + "integrity": "sha512-7dqa0ZcFfzbefdTuIkzOSMvZWC0J7FLqBOjJUZvDCXShIURWKxAyTT1wHhnE5q19c7jOJf43IYYKjBmZVZmvhg==", + "license": "MIT", + "dependencies": { + "append-field": "^1.0.0", + "busboy": "^1.6.0", + "type-is": "^1.6.18" + }, + "engines": { + "node": ">= 10.16.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/multer/node_modules/media-typer": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz", + "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/multer/node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/multer/node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/multer/node_modules/type-is": { + "version": "1.6.18", + "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz", + "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==", + "license": "MIT", + "dependencies": { + "media-typer": "0.3.0", + "mime-types": "~2.1.24" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mute-stream": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/mute-stream/-/mute-stream-3.0.0.tgz", + "integrity": "sha512-dkEJPVvun4FryqBmZ5KhDo0K9iDXAwn08tMLDinNdRBNPcYEDiWYysLcc6k3mjTMlbP9KyylvRpd4wFtwrT9rw==", + "dev": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/nanoid": { + "version": "3.3.19", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.19.tgz", + "integrity": "sha512-Y2tUNy4ouw6tq5oDSKeQYGOyhkUBhNOcGV/02KC+6kd9eDGqdZd++mjMiIDilrBYvjEnCYvVtsuHCuP+okSfug==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/negotiator": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.1.0.tgz", + "integrity": "sha512-NMPBRMJgiQHjbd8phG3Vebdx4kZ1H121rbl5IkMqeOsahptB9BKo/d7oJ3zTXqTgagn2bWlNSXkh0QUGM31RYg==", + "license": "MIT", + "dependencies": { + "content-type": "^2.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/negotiator/node_modules/content-type": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-2.1.0.tgz", + "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/node-emoji": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/node-emoji/-/node-emoji-2.2.0.tgz", + "integrity": "sha512-Z3lTE9pLaJF47NyMhd4ww1yFTAP8YhYI8SleJiHzM46Fgpm5cnNzSl9XfzFNqbaz+VlJrIj3fXQ4DeN1Rjm6cw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@sindresorhus/is": "^4.6.0", + "char-regex": "^1.0.2", + "emojilib": "^2.4.0", + "skin-tone": "^2.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/object-assign": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", + "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-inspect": { + "version": "1.13.4", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz", + "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/obug": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/obug/-/obug-2.2.1.tgz", + "integrity": "sha512-XrsrhT5sybtKI6wakr2SPOlGZWWYbUXZ7a0jT8/QOeAPau+1X/bSegNe5YR75oJmEZQbKningirmGOEJCIk61Q==", + "dev": true, + "funding": [ + "https://github.com/sponsors/sxzz", + "https://opencollective.com/debug" + ], + "license": "MIT", + "engines": { + "node": ">=12.20.0" + } + }, + "node_modules/on-exit-leak-free": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/on-exit-leak-free/-/on-exit-leak-free-2.1.2.tgz", + "integrity": "sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA==", + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/on-finished": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz", + "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", + "license": "MIT", + "dependencies": { + "ee-first": "1.1.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/once": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", + "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", + "license": "ISC", + "dependencies": { + "wrappy": "1" + } + }, + "node_modules/onetime": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz", + "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "mimic-fn": "^2.1.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ora": { + "version": "9.4.1", + "resolved": "https://registry.npmjs.org/ora/-/ora-9.4.1.tgz", + "integrity": "sha512-6VlU9MLXbjVQD04AZCMX28hVtA5bUoadvUqO76MUCVA0ilwJbMiHsITRPfyVm6p/BC0Av/BXMujx39WCe1LEqw==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^5.6.2", + "cli-cursor": "^5.0.0", + "cli-spinners": "^3.2.0", + "is-interactive": "^2.0.0", + "is-unicode-supported": "^2.1.0", + "log-symbols": "^7.0.1", + "stdin-discarder": "^0.3.2", + "string-width": "^8.1.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ora/node_modules/ansi-regex": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.3.0.tgz", + "integrity": "sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/ora/node_modules/chalk": { + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz", + "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.17.0 || ^14.13 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/ora/node_modules/cli-cursor": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-5.0.0.tgz", + "integrity": "sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==", + "dev": true, + "license": "MIT", + "dependencies": { + "restore-cursor": "^5.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ora/node_modules/onetime": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-7.0.0.tgz", + "integrity": "sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "mimic-function": "^5.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ora/node_modules/restore-cursor": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-5.1.0.tgz", + "integrity": "sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==", + "dev": true, + "license": "MIT", + "dependencies": { + "onetime": "^7.0.0", + "signal-exit": "^4.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ora/node_modules/string-width": { + "version": "8.2.2", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-8.2.2.tgz", + "integrity": "sha512-GaPUh5gfdrYzqeVNZvUfT23vYYxXzKYidUcnMtJg/3rxRV63EFZy3k6xfKlmfeJD0176lnUV/Usr3XcwSvFzpg==", + "dev": true, + "license": "MIT", + "dependencies": { + "get-east-asian-width": "^1.5.0", + "strip-ansi": "^7.1.2" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ora/node_modules/strip-ansi": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz", + "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.2.2" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/os-tmpdir": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz", + "integrity": "sha512-D2FR03Vir7FIu45XBY20mTb+/ZSWB00sjU9jdQXt83gDrI4Ztz5Fs7/yy74g2N5SVQY4xY1qDr4rNddwYRVX0g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/oxlint": { + "version": "1.83.0", + "resolved": "https://registry.npmjs.org/oxlint/-/oxlint-1.83.0.tgz", + "integrity": "sha512-cyDzSzaw3uzP0TeCeq3lLRPPoaUxkbB4ZOXj+kn+5r+BX9V+4bNVGk9lxer+WrgcpebH4JxLlJ3KQjveVztOLQ==", + "dev": true, + "license": "MIT", + "bin": { + "oxlint": "bin/oxlint" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "funding": { + "url": "https://github.com/sponsors/oxc-project" + }, + "optionalDependencies": { + "@oxlint/binding-android-arm-eabi": "1.83.0", + "@oxlint/binding-android-arm64": "1.83.0", + "@oxlint/binding-darwin-arm64": "1.83.0", + "@oxlint/binding-darwin-x64": "1.83.0", + "@oxlint/binding-freebsd-x64": "1.83.0", + "@oxlint/binding-linux-arm-gnueabihf": "1.83.0", + "@oxlint/binding-linux-arm-musleabihf": "1.83.0", + "@oxlint/binding-linux-arm64-gnu": "1.83.0", + "@oxlint/binding-linux-arm64-musl": "1.83.0", + "@oxlint/binding-linux-ppc64-gnu": "1.83.0", + "@oxlint/binding-linux-riscv64-gnu": "1.83.0", + "@oxlint/binding-linux-riscv64-musl": "1.83.0", + "@oxlint/binding-linux-s390x-gnu": "1.83.0", + "@oxlint/binding-linux-x64-gnu": "1.83.0", + "@oxlint/binding-linux-x64-musl": "1.83.0", + "@oxlint/binding-openharmony-arm64": "1.83.0", + "@oxlint/binding-win32-arm64-msvc": "1.83.0", + "@oxlint/binding-win32-ia32-msvc": "1.83.0", + "@oxlint/binding-win32-x64-msvc": "1.83.0" + }, + "peerDependencies": { + "oxlint-tsgolint": ">=7.0.2001", + "vite-plus": "*" + }, + "peerDependenciesMeta": { + "oxlint-tsgolint": { + "optional": true + }, + "vite-plus": { + "optional": true + } + } + }, + "node_modules/parseurl": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", + "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/path-to-regexp": { + "version": "8.4.2", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.2.tgz", + "integrity": "sha512-qRcuIdP69NPm4qbACK+aDogI5CBDMi1jKe0ry5rSQJz8JVLsC7jV8XpiJjGRLLol3N+R5ihGYcrPLTno6pAdBA==", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/pathe": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz", + "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==", + "dev": true, + "license": "MIT" + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.5.tgz", + "integrity": "sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pino": { + "version": "10.3.1", + "resolved": "https://registry.npmjs.org/pino/-/pino-10.3.1.tgz", + "integrity": "sha512-r34yH/GlQpKZbU1BvFFqOjhISRo1MNx1tWYsYvmj6KIRHSPMT2+yHOEb1SG6NMvRoHRF0a07kCOox/9yakl1vg==", + "license": "MIT", + "dependencies": { + "@pinojs/redact": "^0.4.0", + "atomic-sleep": "^1.0.0", + "on-exit-leak-free": "^2.1.0", + "pino-abstract-transport": "^3.0.0", + "pino-std-serializers": "^7.0.0", + "process-warning": "^5.0.0", + "quick-format-unescaped": "^4.0.3", + "real-require": "^0.2.0", + "safe-stable-stringify": "^2.3.1", + "sonic-boom": "^4.0.1", + "thread-stream": "^4.0.0" + }, + "bin": { + "pino": "bin.js" + } + }, + "node_modules/pino-abstract-transport": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/pino-abstract-transport/-/pino-abstract-transport-3.0.0.tgz", + "integrity": "sha512-wlfUczU+n7Hy/Ha5j9a/gZNy7We5+cXp8YL+X+PG8S0KXxw7n/JXA3c46Y0zQznIJ83URJiwy7Lh56WLokNuxg==", + "license": "MIT", + "dependencies": { + "split2": "^4.0.0" + } + }, + "node_modules/pino-std-serializers": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/pino-std-serializers/-/pino-std-serializers-7.1.0.tgz", + "integrity": "sha512-BndPH67/JxGExRgiX1dX0w1FvZck5Wa4aal9198SrRhZjH3GxKQUKIBnYJTdj2HDN3UQAS06HlfcSbQj2OHmaw==", + "license": "MIT" + }, + "node_modules/pluralize": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/pluralize/-/pluralize-8.0.0.tgz", + "integrity": "sha512-Nc3IT5yHzflTfbjgqWcCPpo7DaKy4FnpB0l/zCAW0Tc7jxAiuqSxHasntB3D7887LSrA93kDJ9IXovxJYxyLCA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/postcss": { + "version": "8.5.28", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.28.tgz", + "integrity": "sha512-RRuzqDtt5Y9h3quz5hWhK+TPnsmVs6WwSU6LkJMeY4HstUEDuYTG8UJSdawMRzmzAtV+KEoG8N3Qg2qLy5vM/A==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.18", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/prettier": { + "version": "3.9.8", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.9.8.tgz", + "integrity": "sha512-WRFq3Wn3WId7LLROfMLdH7xaFr2jR62wU8nLO6rQUOLOxNZUviyJQs1M0iIhLexSFy+L+w0ch66wtoO2jRjG0A==", + "dev": true, + "license": "MIT", + "bin": { + "prettier": "bin/prettier.cjs" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/prettier/prettier?sponsor=1" + } + }, + "node_modules/process-warning": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/process-warning/-/process-warning-5.1.0.tgz", + "integrity": "sha512-jQSaVHsPgtyw60e1rQ/A+/ArPEj/S8pS/vFnyGa/gYFXrKk/6RuDkoqVDQ5NI5MmS01698ltlAk0NoDBNLujRw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT" + }, + "node_modules/proxy-addr": { + "version": "2.0.8", + "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.8.tgz", + "integrity": "sha512-5nnx0yGyVUcY6t9RnWcARWtwT9F1D8O9rt08htPvnd49W1IgZtmLkhu9WfMzQj1cFxjHIO6connUNVW5k7AVyQ==", + "license": "MIT", + "dependencies": { + "forwarded": "0.2.0", + "ipaddr.js": "1.9.1" + }, + "engines": { + "node": ">= 0.10" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/qs": { + "version": "6.16.0", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.16.0.tgz", + "integrity": "sha512-h6fhOIaRrID2CbEY2fqs+7t+UXZo+MLAnU5gRIq85uFtdiUPCdsApMlHhXogKVM4HM2DVbIjGNTTYH2OcmP1vA==", + "license": "BSD-3-Clause", + "dependencies": { + "es-define-property": "^1.0.1", + "side-channel": "^1.1.1" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/quick-format-unescaped": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/quick-format-unescaped/-/quick-format-unescaped-4.0.4.tgz", + "integrity": "sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg==", + "license": "MIT" + }, + "node_modules/range-parser": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.3.0.tgz", + "integrity": "sha512-hek2mFQpPuI4E1BBKrSto+BU3e3x4xuarsbiwr3+lf7p44juvFMV0XFWQAP3xUyqXA4RrXLIoaSUGbSt056ZMw==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/raw-body": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-3.0.2.tgz", + "integrity": "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==", + "license": "MIT", + "dependencies": { + "bytes": "~3.1.2", + "http-errors": "~2.0.1", + "iconv-lite": "~0.7.0", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.10" + } + }, + "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==", + "dev": true, + "license": "MIT", + "dependencies": { + "inherits": "^2.0.3", + "string_decoder": "^1.1.1", + "util-deprecate": "^1.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/readdirp": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.1.1.tgz", + "integrity": "sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 20.19.0" + }, + "funding": { + "type": "individual", + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/real-require": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/real-require/-/real-require-0.2.0.tgz", + "integrity": "sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg==", + "license": "MIT", + "engines": { + "node": ">= 12.13.0" + } + }, + "node_modules/reflect-metadata": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/reflect-metadata/-/reflect-metadata-0.2.2.tgz", + "integrity": "sha512-urBwgfrvVP/eAyXx4hluJivBKzuEbSQs9rKWCrCkbSxNv8mxPcUZKeuoF3Uy4mJl3Lwprp6yy5/39VWigZ4K6Q==", + "license": "Apache-2.0" + }, + "node_modules/require-from-string": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", + "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/restore-cursor": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-3.1.0.tgz", + "integrity": "sha512-l+sSefzHpj5qimhFSE5a8nufZYAM3sBSVMAPtYkmC+4EH2anSGaEMXSD0izRQbu9nfyQ9y5JrVmp7E8oZrUjvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "onetime": "^5.1.0", + "signal-exit": "^3.0.2" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/restore-cursor/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==", + "dev": true, + "license": "ISC" + }, + "node_modules/ret": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/ret/-/ret-0.5.0.tgz", + "integrity": "sha512-I1XxrZSQ+oErkRR4jYbAyEEu2I0avBvvMM5JN+6EBprOGRCs63ENqZ3vjavq8fBw2+62G5LF5XelKwuJpcvcxw==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/reusify": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz", + "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==", + "license": "MIT", + "engines": { + "iojs": ">=1.0.0", + "node": ">=0.10.0" + } + }, + "node_modules/rfdc": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/rfdc/-/rfdc-1.4.1.tgz", + "integrity": "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==", + "license": "MIT" + }, + "node_modules/rolldown": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.9.tgz", + "integrity": "sha512-hx/Pv0N1haXRb11qkfnK5MXB/iqr7i0yjWQqmO9uHqZpBgQSqzc8UsSnEpalsh+j1I8qQ2CkXAkJC8Br3dKSlg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@oxc-project/types": "=0.150.0", + "@rolldown/pluginutils": "^1.0.0" + }, + "bin": { + "rolldown": "bin/cli.mjs" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "optionalDependencies": { + "@rolldown/binding-android-arm-eabi": "1.2.9", + "@rolldown/binding-android-arm64": "1.2.9", + "@rolldown/binding-darwin-arm64": "1.2.9", + "@rolldown/binding-darwin-x64": "1.2.9", + "@rolldown/binding-freebsd-x64": "1.2.9", + "@rolldown/binding-linux-arm-gnueabihf": "1.2.9", + "@rolldown/binding-linux-arm64-gnu": "1.2.9", + "@rolldown/binding-linux-arm64-musl": "1.2.9", + "@rolldown/binding-linux-ppc64-gnu": "1.2.9", + "@rolldown/binding-linux-s390x-gnu": "1.2.9", + "@rolldown/binding-linux-x64-gnu": "1.2.9", + "@rolldown/binding-linux-x64-musl": "1.2.9", + "@rolldown/binding-openharmony-arm64": "1.2.9", + "@rolldown/binding-win32-arm64-msvc": "1.2.9", + "@rolldown/binding-win32-x64-msvc": "1.2.9" + } + }, + "node_modules/router": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz", + "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==", + "license": "MIT", + "dependencies": { + "debug": "^4.4.0", + "depd": "^2.0.0", + "is-promise": "^4.0.0", + "parseurl": "^1.3.3", + "path-to-regexp": "^8.0.0" + }, + "engines": { + "node": ">= 18" + } + }, + "node_modules/run-async": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/run-async/-/run-async-2.4.1.tgz", + "integrity": "sha512-tvVnVv01b8c1RrA6Ep7JkStj85Guv/YrMcwqYQnwjsAS2cTmmPGBBjAjpCW7RrSodNSoE2/qg9O4bceNvUuDgQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/rxjs": { + "version": "7.8.2", + "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-7.8.2.tgz", + "integrity": "sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==", + "license": "Apache-2.0", + "dependencies": { + "tslib": "^2.1.0" + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "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" + } + ], + "license": "MIT" + }, + "node_modules/safe-regex2": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/safe-regex2/-/safe-regex2-5.1.1.tgz", + "integrity": "sha512-mOSBvHGDZMuIEZMdOz/aCEYDCv0E7nfcNsIhUF+/P+xC7Hyf3FkvymqgPbg9D1EdSGu+uKbJgy09K/RKKc7kJA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT", + "dependencies": { + "ret": "~0.5.0" + }, + "bin": { + "safe-regex2": "bin/safe-regex2.js" + } + }, + "node_modules/safe-stable-stringify": { + "version": "2.5.0", + "resolved": "https://registry.npmjs.org/safe-stable-stringify/-/safe-stable-stringify-2.5.0.tgz", + "integrity": "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "license": "MIT" + }, + "node_modules/secure-json-parse": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/secure-json-parse/-/secure-json-parse-4.1.0.tgz", + "integrity": "sha512-l4KnYfEyqYJxDwlNVyRfO2E4NTHfMKAWdUuA8J0yve2Dz/E/PdBepY03RvyJpssIpRFwJoCD55wA+mEDs6ByWA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/semver": { + "version": "7.8.5", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz", + "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/send": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/send/-/send-1.2.1.tgz", + "integrity": "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==", + "license": "MIT", + "dependencies": { + "debug": "^4.4.3", + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "etag": "^1.8.1", + "fresh": "^2.0.0", + "http-errors": "^2.0.1", + "mime-types": "^3.0.2", + "ms": "^2.1.3", + "on-finished": "^2.4.1", + "range-parser": "^1.2.1", + "statuses": "^2.0.2" + }, + "engines": { + "node": ">= 18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/serve-static": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.1.tgz", + "integrity": "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==", + "license": "MIT", + "dependencies": { + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "parseurl": "^1.3.3", + "send": "^1.2.0" + }, + "engines": { + "node": ">= 18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/set-cookie-parser": { + "version": "2.7.2", + "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.2.tgz", + "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==", + "license": "MIT" + }, + "node_modules/setprototypeof": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", + "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", + "license": "ISC" + }, + "node_modules/side-channel": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.1.tgz", + "integrity": "sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.4", + "side-channel-list": "^1.0.1", + "side-channel-map": "^1.0.1", + "side-channel-weakmap": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-list": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz", + "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-map": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz", + "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-weakmap": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz", + "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==", + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3", + "side-channel-map": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/siginfo": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz", + "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==", + "dev": true, + "license": "ISC" + }, + "node_modules/signal-exit": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", + "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/skin-tone": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/skin-tone/-/skin-tone-2.0.0.tgz", + "integrity": "sha512-kUMbT1oBJCpgrnKoSr0o6wPtvRWT9W9UKvGLwfJYO2WuahZRHOpEyL1ckyMGgMWh0UdpmaoFqKKD29WTomNEGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "unicode-emoji-modifier-base": "^1.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/sonic-boom": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/sonic-boom/-/sonic-boom-4.2.1.tgz", + "integrity": "sha512-w6AxtubXa2wTXAUsZMMWERrsIRAdrK0Sc+FUytWvYAhBJLyuI4llrMIC1DtlNSdI99EI86KZum2MMq3EAZlF9Q==", + "license": "MIT", + "dependencies": { + "atomic-sleep": "^1.0.0" + } + }, + "node_modules/source-map": { + "version": "0.7.6", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.6.tgz", + "integrity": "sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">= 12" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/source-map-support": { + "version": "0.5.21", + "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz", + "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==", + "dev": true, + "license": "MIT", + "dependencies": { + "buffer-from": "^1.0.0", + "source-map": "^0.6.0" + } + }, + "node_modules/source-map-support/node_modules/source-map": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", + "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/split2": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz", + "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==", + "license": "ISC", + "engines": { + "node": ">= 10.x" + } + }, + "node_modules/stackback": { + "version": "0.0.2", + "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz", + "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==", + "dev": true, + "license": "MIT" + }, + "node_modules/statuses": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz", + "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/std-env": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/std-env/-/std-env-4.2.0.tgz", + "integrity": "sha512-oCUKSupKTHX53EyjDtuZQ64pjLJ6yYCtpmEw0goYxtjG9KpbRe8KAsl2tBUGU9DyMcJ0RwJ8GqJAFzMXcXW1Rw==", + "dev": true, + "license": "MIT" + }, + "node_modules/stdin-discarder": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/stdin-discarder/-/stdin-discarder-0.3.2.tgz", + "integrity": "sha512-eCPu1qRxPVkl5605OTWF8Wz40b4Mf45NY5LQmVPQ599knfs5QhASUm9GbJ5BDMDOXgrnh0wyEdvzmL//YMlw0A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/streamsearch": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/streamsearch/-/streamsearch-1.1.0.tgz", + "integrity": "sha512-Mcc5wHehp9aXz1ax6bZUyY5afg9u2rv5cqQI3mRrYkGC8rW2hM02jWuwjtL++LS5qinSyhj2QfLyNsuc+VsExg==", + "engines": { + "node": ">=10.0.0" + } + }, + "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==", + "dev": true, + "license": "MIT", + "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==", + "dev": true, + "license": "MIT", + "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==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-bom": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz", + "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/strtok3": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/strtok3/-/strtok3-10.3.5.tgz", + "integrity": "sha512-ki4hZQfh5rX0QDLLkOCj+h+CVNkqmp/CMf8v8kZpkNVK6jGQooMytqzLZYUVYIZcFZ6yDB70EfD8POcFXiF5oA==", + "license": "MIT", + "dependencies": { + "@tokenizer/token": "^0.3.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/Borewit" + } + }, + "node_modules/superagent": { + "version": "10.3.0", + "resolved": "https://registry.npmjs.org/superagent/-/superagent-10.3.0.tgz", + "integrity": "sha512-B+4Ik7ROgVKrQsXTV0Jwp2u+PXYLSlqtDAhYnkkD+zn3yg8s/zjA2MeGayPoY/KICrbitwneDHrjSotxKL+0XQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "component-emitter": "^1.3.1", + "cookiejar": "^2.1.4", + "debug": "^4.3.7", + "fast-safe-stringify": "^2.1.1", + "form-data": "^4.0.5", + "formidable": "^3.5.4", + "methods": "^1.1.2", + "mime": "2.6.0", + "qs": "^6.14.1" + }, + "engines": { + "node": ">=14.18.0" + } + }, + "node_modules/supertest": { + "version": "7.2.2", + "resolved": "https://registry.npmjs.org/supertest/-/supertest-7.2.2.tgz", + "integrity": "sha512-oK8WG9diS3DlhdUkcFn4tkNIiIbBx9lI2ClF8K+b2/m8Eyv47LSawxUzZQSNKUrVb2KsqeTDCcjAAVPYaSLVTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "cookie-signature": "^1.2.2", + "methods": "^1.1.2", + "superagent": "^10.3.0" + }, + "engines": { + "node": ">=14.18.0" + } + }, + "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, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/thread-stream": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/thread-stream/-/thread-stream-4.2.0.tgz", + "integrity": "sha512-e2zZ96wSChazBsbENf/Pcm/4swHt2cEKQ92rhUjkL9GCKiTDJIaTBenjE/m9DXi0QBmTMDkFDdOomUy20A1tDQ==", + "license": "MIT", + "dependencies": { + "real-require": "^1.0.0" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/thread-stream/node_modules/real-require": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/real-require/-/real-require-1.0.0.tgz", + "integrity": "sha512-P4nbQYQfePJxRSmY+v/KINxVucm4NF3p3s7pJveMTtom52FR4YGltUQLB8idDXwDDWW+eYrWDFbuzUnjoWHF7g==", + "license": "MIT" + }, + "node_modules/through": { + "version": "2.3.8", + "resolved": "https://registry.npmjs.org/through/-/through-2.3.8.tgz", + "integrity": "sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==", + "dev": true, + "license": "MIT" + }, + "node_modules/tinybench": { + "version": "2.9.0", + "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz", + "integrity": "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/tinyexec": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.3.1.tgz", + "integrity": "sha512-GCvB3aoys96IuDFBMcTB46JOR6mdMtAToqwiW8JlWhsoh1mhHi/xn9ss/Dg7N555GiJyEt2qzoG/NHCwM6h1EA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.17", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz", + "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tinyrainbow": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-3.1.1.tgz", + "integrity": "sha512-yau8yJdTt989Mm0Bd/236QnzEiPf2xLLTqUZRUJOo/3CB078LSwzei343DgtJVmfJKJE3TMINY1u42SQsP6mXw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/tmp": { + "version": "0.0.33", + "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.0.33.tgz", + "integrity": "sha512-jRCJlojKnZ3addtTOjdIqoRuPEKBvNXcGYqzO6zWZX8KfKEpnGY5jfggJQ3EjKuu8D4bJRr0y+cYJFmYbImXGw==", + "dev": true, + "license": "MIT", + "dependencies": { + "os-tmpdir": "~1.0.2" + }, + "engines": { + "node": ">=0.6.0" + } + }, + "node_modules/toad-cache": { + "version": "3.7.4", + "resolved": "https://registry.npmjs.org/toad-cache/-/toad-cache-3.7.4.tgz", + "integrity": "sha512-m1TdR/rvT7kgGJZhspNtXdsdYk0fddFpJJFlG5s+UkPFo6lkLoZ3YLOaovPYjq1R75NP5JfeTlSHaOsE09peCg==", + "license": "MIT", + "engines": { + "node": ">=20" + } + }, + "node_modules/toidentifier": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", + "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", + "license": "MIT", + "engines": { + "node": ">=0.6" + } + }, + "node_modules/token-types": { + "version": "6.1.2", + "resolved": "https://registry.npmjs.org/token-types/-/token-types-6.1.2.tgz", + "integrity": "sha512-dRXchy+C0IgK8WPC6xvCHFRIWYUbqqdEIKPaKo/AcTUNzwLTK6AH7RjdLWsEZcAN/TBdtfUw3PYEgPr5VPr6ww==", + "license": "MIT", + "dependencies": { + "@borewit/text-codec": "^0.2.1", + "@tokenizer/token": "^0.3.0", + "ieee754": "^1.2.1" + }, + "engines": { + "node": ">=14.16" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/Borewit" + } + }, + "node_modules/tsconfig-paths": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/tsconfig-paths/-/tsconfig-paths-4.2.0.tgz", + "integrity": "sha512-NoZ4roiN7LnbKn9QqE1amc9DJfzvZXxF4xDavcOWt1BPkdx+m+0gJuPM+S0vCe7zTJMYUP0R8pO2XMr+Y8oLIg==", + "dev": true, + "license": "MIT", + "dependencies": { + "json5": "^2.2.2", + "minimist": "^1.2.6", + "strip-bom": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD" + }, + "node_modules/type-fest": { + "version": "0.21.3", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.21.3.tgz", + "integrity": "sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/type-is": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.1.0.tgz", + "integrity": "sha512-faYHw0anBbc/kWF3zFTEnxSFOAGUX9GFbOBthvDdLsIlEoWOFOtS0zgCiQYwIskL9iGXZL3kAXD8OoZ4GmMATA==", + "license": "MIT", + "dependencies": { + "content-type": "^2.0.0", + "media-typer": "^1.1.0", + "mime-types": "^3.0.0" + }, + "engines": { + "node": ">= 18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/type-is/node_modules/content-type": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-2.1.0.tgz", + "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/typescript": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.3.tgz", + "integrity": "sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/uid": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/uid/-/uid-2.0.2.tgz", + "integrity": "sha512-u3xV3X7uzvi5b1MncmZo3i2Aw222Zk1keqLA1YkHldREkAhAqi65wuPfe7lHx8H/Wzy+8CE7S7uS3jekIM5s8g==", + "license": "MIT", + "dependencies": { + "@lukeed/csprng": "^1.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/uint8array-extras": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/uint8array-extras/-/uint8array-extras-1.5.0.tgz", + "integrity": "sha512-rvKSBiC5zqCCiDZ9kAOszZcDvdAHwwIKJG33Ykj43OKcWsnmcBRL09YTU4nOeHZ8Y2a7l1MgTd08SBe9A8Qj6A==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/undici": { + "version": "6.20.1", + "resolved": "https://registry.npmjs.org/undici/-/undici-6.20.1.tgz", + "integrity": "sha512-AjQF1QsmqfJys+LXfGTNum+qw4S88CojRInG/6t31W/1fk6G59s92bnAvGz5Cmur+kQv2SURXEvvudLmbrE8QA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18.17" + } + }, + "node_modules/undici-types": { + "version": "7.18.2", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz", + "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==", + "dev": true, + "license": "MIT" + }, + "node_modules/unicode-emoji-modifier-base": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/unicode-emoji-modifier-base/-/unicode-emoji-modifier-base-1.0.0.tgz", + "integrity": "sha512-yLSH4py7oFH3oG/9K+XWrz1pSi3dfUrWEnInbxMfArOfc1+33BlGPQtLsOYwvdMy11AwUBetYuaRxSPqgkq+8g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=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==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "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==", + "dev": true, + "license": "MIT" + }, + "node_modules/validator": { + "version": "13.15.35", + "resolved": "https://registry.npmjs.org/validator/-/validator-13.15.35.tgz", + "integrity": "sha512-TQ5pAGhd5whStmqWvYF4OjQROlmv9SMFVt37qoCBdqRffuuklWYQlCNnEs2ZaIBD1kZRNnikiZOS1eqgkar0iw==", + "license": "MIT", + "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==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/vite": { + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/vite/-/vite-8.3.0.tgz", + "integrity": "sha512-lhZBVvEHefgE+HQZC9O7EBJgCU/nVzFNl7vkS4RE0APtWLP02/8QVIkQtzBxPquh7lq5/78NHipTj7ODQ6XuyQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "lightningcss": "^1.33.0", + "picomatch": "^4.0.7", + "postcss": "^8.5.28", + "rolldown": "~1.2.6", + "tinyglobby": "^0.2.17" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^20.19.0 || >=22.12.0", + "@vitejs/devtools": "^0.7.1", + "esbuild": "^0.27.0 || ^0.28.0", + "jiti": ">=1.21.0", + "less": "^4.0.0", + "sass": "^1.70.0", + "sass-embedded": "^1.70.0", + "stylus": ">=0.54.8", + "sugarss": "^5.0.0", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "@vitejs/devtools": { + "optional": true + }, + "esbuild": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/vite-tsconfig-paths": { + "version": "5.1.4", + "resolved": "https://registry.npmjs.org/vite-tsconfig-paths/-/vite-tsconfig-paths-5.1.4.tgz", + "integrity": "sha512-cYj0LRuLV2c2sMqhqhGpaO3LretdtMn/BVX4cPLanIZuwwrkVl+lK84E/miEXkCHWXuq65rhNN4rXsBcOB3S4w==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^4.1.1", + "globrex": "^0.1.2", + "tsconfck": "^3.0.3" + }, + "peerDependencies": { + "vite": "*" + }, + "peerDependenciesMeta": { + "vite": { + "optional": true + } + } + }, + "node_modules/vite-tsconfig-paths/node_modules/tsconfck": { + "version": "3.1.6", + "resolved": "https://registry.npmjs.org/tsconfck/-/tsconfck-3.1.6.tgz", + "integrity": "sha512-ks6Vjr/jEw0P1gmOVwutM3B7fWxoWBL2KRDb1JfqGVawBmO5UsvmWOQFGHBPl5yxYz4eERr19E6L7NMv+Fej4w==", + "deprecated": "unmaintained", + "dev": true, + "license": "MIT", + "bin": { + "tsconfck": "bin/tsconfck.js" + }, + "engines": { + "node": "^18 || >=20" + }, + "peerDependencies": { + "typescript": "^5.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/vite/node_modules/picomatch": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz", + "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/vitest": { + "version": "4.1.11", + "resolved": "https://registry.npmjs.org/vitest/-/vitest-4.1.11.tgz", + "integrity": "sha512-fhACrNXUidIbGSBr5FlbuBkO7VWC1ZyLl0DO4CU2DrQoAPxX84Ysxs+HeGQpii5lZWV1Q4gBZTTu49mF+A6Edw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/expect": "4.1.11", + "@vitest/mocker": "4.1.11", + "@vitest/pretty-format": "4.1.11", + "@vitest/runner": "4.1.11", + "@vitest/snapshot": "4.1.11", + "@vitest/spy": "4.1.11", + "@vitest/utils": "4.1.11", + "es-module-lexer": "^2.0.0", + "expect-type": "^1.3.0", + "magic-string": "^0.30.21", + "obug": "^2.1.1", + "pathe": "^2.0.3", + "picomatch": "^4.0.3", + "std-env": "^4.0.0-rc.1", + "tinybench": "^2.9.0", + "tinyexec": "^1.0.2", + "tinyglobby": "^0.2.15", + "tinyrainbow": "^3.1.0", + "vite": "^6.0.0 || ^7.0.0 || ^8.0.0", + "why-is-node-running": "^2.3.0" + }, + "bin": { + "vitest": "vitest.mjs" + }, + "engines": { + "node": "^20.0.0 || ^22.0.0 || >=24.0.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "@edge-runtime/vm": "*", + "@opentelemetry/api": "^1.9.0", + "@types/node": "^20.0.0 || ^22.0.0 || >=24.0.0", + "@vitest/browser-playwright": "4.1.11", + "@vitest/browser-preview": "4.1.11", + "@vitest/browser-webdriverio": "4.1.11", + "@vitest/coverage-istanbul": "4.1.11", + "@vitest/coverage-v8": "4.1.11", + "@vitest/ui": "4.1.11", + "happy-dom": "*", + "jsdom": "*", + "vite": "^6.0.0 || ^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "@edge-runtime/vm": { + "optional": true + }, + "@opentelemetry/api": { + "optional": true + }, + "@types/node": { + "optional": true + }, + "@vitest/browser-playwright": { + "optional": true + }, + "@vitest/browser-preview": { + "optional": true + }, + "@vitest/browser-webdriverio": { + "optional": true + }, + "@vitest/coverage-istanbul": { + "optional": true + }, + "@vitest/coverage-v8": { + "optional": true + }, + "@vitest/ui": { + "optional": true + }, + "happy-dom": { + "optional": true + }, + "jsdom": { + "optional": true + }, + "vite": { + "optional": false + } + } + }, + "node_modules/vitest/node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/wcwidth": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/wcwidth/-/wcwidth-1.0.1.tgz", + "integrity": "sha512-XHPEwS0q6TaxcvG85+8EYkbiCux2XtWG2mkc47Ng2A77BQu9+DqIOJldST4HgPkuea7dvKSj5VgX3P1d4rW8Tg==", + "dev": true, + "license": "MIT", + "dependencies": { + "defaults": "^1.0.3" + } + }, + "node_modules/why-is-node-running": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz", + "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==", + "dev": true, + "license": "MIT", + "dependencies": { + "siginfo": "^2.0.0", + "stackback": "0.0.2" + }, + "bin": { + "why-is-node-running": "cli.js" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/wrap-ansi": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-6.2.0.tgz", + "integrity": "sha512-r6lPcBGxZXlIcymEu7InxDMhdW0KDxpLgoFLcguasxCaJ/SOIZwINatK9KY/tf+ZrlywOKU0UDj3ATXUBfxJXA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "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==", + "license": "ISC" + }, + "node_modules/yoctocolors": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/yoctocolors/-/yoctocolors-2.2.0.tgz", + "integrity": "sha512-xYqdZFUK/VYazNl/oCDYN+3WloWQwMfZxBoiNt6qNyk+xfOdi598muWE42rNZFp1kNOiqW936q5RhUdnpqElSg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + } + } +} diff --git a/app/package.json b/app/package.json new file mode 100644 index 00000000..756fa414 --- /dev/null +++ b/app/package.json @@ -0,0 +1,54 @@ +{ + "name": "app", + "version": "0.0.1", + "description": "", + "author": "", + "private": true, + "license": "UNLICENSED", + "type": "module", + "scripts": { + "build": "nest build", + "deploy": "nest deploy", + "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"", + "start": "nest start", + "start:dev": "nest start --watch", + "start:debug": "nest start --debug --watch", + "start:prod": "node dist/main", + "lint": "oxlint src/ test/", + "test": "vitest run", + "test:unit": "vitest run --include 'src/**/*.spec.ts'", + "test:watch": "vitest", + "test:cov": "vitest run --coverage", + "test:debug": "vitest --inspect-brk --no-file-parallelism", + "test:e2e": "vitest run --config ./vitest.config.e2e.ts" + }, + "dependencies": { + "@nestjs/common": "^12.0.1", + "@nestjs/config": "^12.0.0", + "@nestjs/core": "^12.0.1", + "@nestjs/platform-express": "^12.0.1", + "@nestjs/platform-fastify": "^12.0.3", + "class-transformer": "^0.5.1", + "class-validator": "^0.15.1", + "fastify": "^5.12.5", + "reflect-metadata": "^0.2.2", + "rxjs": "^7.8.1" + }, + "devDependencies": { + "@nestjs/cli": "^12.0.0", + "@nestjs/mau": "^0.2.6", + "@nestjs/schematics": "^12.0.0", + "@nestjs/testing": "^12.0.1", + "@types/express": "^5.0.0", + "@types/node": "^24.0.0", + "@types/supertest": "^7.0.0", + "@vitest/coverage-v8": "^4.1.2", + "oxlint": "^1.58.0", + "prettier": "^3.4.2", + "source-map-support": "^0.5.21", + "supertest": "^7.2.2", + "typescript": "^6.0.3", + "vite-tsconfig-paths": "^5.1.4", + "vitest": "^4.1.2" + } +} diff --git a/app/src/app.module.ts b/app/src/app.module.ts new file mode 100644 index 00000000..39368296 --- /dev/null +++ b/app/src/app.module.ts @@ -0,0 +1,10 @@ +import { Module } from '@nestjs/common'; +import { ChatsModule } from './chats/chats.module.js'; +import { HealthModule } from './health/health.module.js'; +import { MessagesModule } from './messages/messages.module.js'; +import { UsersModule } from './users/users.module.js'; + +@Module({ + imports: [HealthModule, UsersModule, ChatsModule, MessagesModule], +}) +export class AppModule {} diff --git a/app/src/chats/chat.ts b/app/src/chats/chat.ts new file mode 100644 index 00000000..fb2e262e --- /dev/null +++ b/app/src/chats/chat.ts @@ -0,0 +1,6 @@ +export type Chat = { + id: string; + title: string; + member_ids: string[]; + created_at: string; +}; diff --git a/app/src/chats/chats.controller.ts b/app/src/chats/chats.controller.ts new file mode 100644 index 00000000..114e1385 --- /dev/null +++ b/app/src/chats/chats.controller.ts @@ -0,0 +1,54 @@ +import { + BadRequestException, + Body, + Controller, + DefaultValuePipe, + Get, + Param, + ParseIntPipe, + ParseUUIDPipe, + Post, + Query, + Req, + UseGuards, +} from '@nestjs/common'; +import { CurrentUserGuard } from '../common/auth/current-user.guard.js'; +import type { FastifyRequest } from 'fastify'; +import { ChatsService } from './chats.service.js'; +import { CreateChatDto } from './dto/create-chat.dto.js'; + +@Controller('api/v1/chats') +@UseGuards(CurrentUserGuard) +export class ChatsController { + constructor(private readonly chatsService: ChatsService) {} + + @Post() + create(@Body() body: CreateChatDto, @Req() request: FastifyRequest) { + return this.chatsService.create(body, request.currentUser!); + } + + @Get() + list( + @Req() request: FastifyRequest, + @Query('limit', new DefaultValuePipe(50), new ParseIntPipe()) limit: number, + @Query('cursor') cursor?: string, + ) { + if (limit < 1 || limit > 100) { + throw new BadRequestException('limit must be between 1 and 100'); + } + + return this.chatsService.listForUser( + request.currentUser!, + limit, + cursor, + ); + } + + @Get(':chatId') + get( + @Param('chatId', new ParseUUIDPipe()) chatId: string, + @Req() request: FastifyRequest, + ) { + return this.chatsService.getForUser(chatId, request.currentUser!); + } +} diff --git a/app/src/chats/chats.module.ts b/app/src/chats/chats.module.ts new file mode 100644 index 00000000..5163d386 --- /dev/null +++ b/app/src/chats/chats.module.ts @@ -0,0 +1,13 @@ +import { Module } from '@nestjs/common'; +import { ChatsController } from './chats.controller.js'; +import { UsersModule } from '../users/users.module.js'; +import { ChatsRepository } from './chats.repository.js'; +import { ChatsService } from './chats.service.js'; + +@Module({ + imports: [UsersModule], + controllers: [ChatsController], + providers: [ChatsRepository, ChatsService], + exports: [ChatsService], +}) +export class ChatsModule {} diff --git a/app/src/chats/chats.repository.ts b/app/src/chats/chats.repository.ts new file mode 100644 index 00000000..53d8cac1 --- /dev/null +++ b/app/src/chats/chats.repository.ts @@ -0,0 +1,19 @@ +import { Injectable } from '@nestjs/common'; +import { Chat } from './chat.js'; + +@Injectable() +export class ChatsRepository { + private readonly chatsById = new Map(); + + save(chat: Chat): void { + this.chatsById.set(chat.id, chat); + } + + findById(id: string): Chat | undefined { + return this.chatsById.get(id); + } + + findAll(): Chat[] { + return Array.from(this.chatsById.values()); + } +} diff --git a/app/src/chats/chats.service.ts b/app/src/chats/chats.service.ts new file mode 100644 index 00000000..63f22d64 --- /dev/null +++ b/app/src/chats/chats.service.ts @@ -0,0 +1,95 @@ +import { + BadRequestException, + Injectable, + NotFoundException, +} from '@nestjs/common'; +import { randomUUID } from 'node:crypto'; +import { + decodeCursor, + encodeCursor, + isAfter, +} from '../common/http/cursor.js'; +import type { User } from '../users/user.js'; +import { UsersService } from '../users/users.service.js'; +import type { Chat } from './chat.js'; +import type { CreateChatDto } from './dto/create-chat.dto.js'; +import { ChatsRepository } from './chats.repository.js'; + +@Injectable() +export class ChatsService { + constructor( + private readonly chatsRepository: ChatsRepository, + private readonly usersService: UsersService, + ) {} + + create(input: CreateChatDto, currentUser: User): Chat { + if (!input.member_ids.includes(currentUser.id)) { + throw new BadRequestException('Current user must be a chat member'); + } + + for (const memberId of input.member_ids) { + if (!this.usersService.findById(memberId)) { + throw new BadRequestException('Chat member does not exist'); + } + } + + const chat: Chat = { + id: randomUUID(), + title: input.title, + member_ids: [...input.member_ids], + created_at: new Date().toISOString(), + }; + + this.chatsRepository.save(chat); + return chat; + } + + getForUser(chatId: string, currentUser: User): Chat { + const chat = this.chatsRepository.findById(chatId); + + if (!chat || !chat.member_ids.includes(currentUser.id)) { + throw new NotFoundException(); + } + + return chat; + } + + listForUser( + currentUser: User, + limit: number, + cursorValue?: string, + ): { items: Chat[]; next_cursor: string | null } { + const scope = `chats:${currentUser.id}`; + const cursor = cursorValue + ? decodeCursor(cursorValue, scope) + : undefined; + + const chats = this.chatsRepository + .findAll() + .filter((chat) => chat.member_ids.includes(currentUser.id)) + .sort((left, right) => { + const byDate = left.created_at.localeCompare(right.created_at); + return byDate !== 0 ? byDate : left.id.localeCompare(right.id); + }); + + const start = cursor + ? chats.findIndex((chat) => isAfter(chat.created_at, chat.id, cursor)) + : 0; + const visible = chats.slice(start < 0 ? chats.length : start); + const items = visible.slice(0, limit); + const hasMore = visible.length > limit; + const last = items.at(-1); + + return { + items, + next_cursor: + hasMore && last + ? encodeCursor({ + scope, + created_at: last.created_at, + id: last.id, + }) + : null, + }; + } +} diff --git a/app/src/chats/dto/create-chat.dto.ts b/app/src/chats/dto/create-chat.dto.ts new file mode 100644 index 00000000..baeb07cc --- /dev/null +++ b/app/src/chats/dto/create-chat.dto.ts @@ -0,0 +1,26 @@ +import { + ArrayMaxSize, + ArrayMinSize, + ArrayUnique, + IsArray, + IsString, + IsUUID, + Length, + Matches, +} from 'class-validator'; + +export class CreateChatDto { + @IsString() + @Length(1, 100) + @Matches(/\S/, { + message: 'title must contain a non-whitespace character', + }) + title: string; + + @IsArray() + @ArrayMinSize(1) + @ArrayMaxSize(100) + @ArrayUnique() + @IsUUID('4', { each: true }) + member_ids: string[]; +} diff --git a/app/src/common/auth/current-user.guard.ts b/app/src/common/auth/current-user.guard.ts new file mode 100644 index 00000000..ea04f9a8 --- /dev/null +++ b/app/src/common/auth/current-user.guard.ts @@ -0,0 +1,43 @@ +import { + CanActivate, + ExecutionContext, + Injectable, + UnauthorizedException, +} from '@nestjs/common'; +import { isUUID } from 'class-validator'; +import type { User } from '../../users/user.js'; +import { UsersService } from '../../users/users.service.js'; + +export type RequestWithCurrentUser = { + headers: { + 'x-user-id'?: string | string[]; + }; + currentUser?: User; +}; + +@Injectable() +export class CurrentUserGuard implements CanActivate { + constructor(private readonly usersService: UsersService) {} + + canActivate(context: ExecutionContext): boolean { + const request = context + .switchToHttp() + .getRequest(); + + const header = request.headers['x-user-id']; + + if (typeof header !== 'string' || !isUUID(header)) { + throw new UnauthorizedException(); + } + + const user = this.usersService.findById(header); + + if (!user) { + throw new UnauthorizedException(); + } + + request.currentUser = user; + + return true; + } +} diff --git a/app/src/common/errors/api-exception.filter.ts b/app/src/common/errors/api-exception.filter.ts new file mode 100644 index 00000000..d49a0003 --- /dev/null +++ b/app/src/common/errors/api-exception.filter.ts @@ -0,0 +1,89 @@ +import { + ArgumentsHost, + Catch, + ExceptionFilter, + HttpException, + HttpStatus, +} from '@nestjs/common'; +import { randomUUID } from 'node:crypto'; + +type RequestWithId = { + requestId?: string; +}; + +type HttpResponse = { + header(name: string, value: string): void; + status(code: number): HttpResponse; + send(body: unknown): void; +}; + +function errorCodeForStatus(status: number): string { + switch (status) { + case HttpStatus.BAD_REQUEST: + return 'invalid_request'; + case HttpStatus.UNAUTHORIZED: + return 'unauthorized'; + case HttpStatus.NOT_FOUND: + return 'not_found'; + case HttpStatus.CONFLICT: + return 'conflict'; + case HttpStatus.PAYLOAD_TOO_LARGE: + return 'payload_too_large'; + case HttpStatus.UNSUPPORTED_MEDIA_TYPE: + return 'unsupported_media_type'; + case HttpStatus.TOO_MANY_REQUESTS: + return 'rate_limited'; + case HttpStatus.SERVICE_UNAVAILABLE: + return 'unavailable'; + default: + return 'internal_error'; + } +} + +@Catch() +export class ApiExceptionFilter implements ExceptionFilter { + catch(exception: any, host: ArgumentsHost) { + const context = host.switchToHttp(); + + const request = context.getRequest(); + + const response = context.getResponse(); + + const requestId = request.requestId ?? randomUUID(); + + request.requestId = requestId; + response.header('X-Request-Id', requestId); + + let status = HttpStatus.INTERNAL_SERVER_ERROR; + let message = 'Internal server error'; + + if (exception instanceof HttpException) { + status = exception.getStatus(); + const exceptionResponse = exception.getResponse(); + const rawMessage = + typeof exceptionResponse === 'object' && + exceptionResponse !== null && + 'message' in exceptionResponse + ? exceptionResponse.message + : undefined; + + message = Array.isArray(rawMessage) + ? rawMessage.join('; ') + : typeof rawMessage === 'string' + ? rawMessage + : 'Request failed'; + + if (status === HttpStatus.NOT_FOUND) { + message = 'Resource not found'; + } + } + + response.status(status).send({ + error: { + code: errorCodeForStatus(status), + message: message, + request_id: requestId, + }, + }); + } +} diff --git a/app/src/common/http/cursor.ts b/app/src/common/http/cursor.ts new file mode 100644 index 00000000..2d95d77a --- /dev/null +++ b/app/src/common/http/cursor.ts @@ -0,0 +1,54 @@ +import { BadRequestException } from '@nestjs/common'; + +export type Cursor = { + scope: string; + created_at: string; + id: string; +}; + +export function encodeCursor(cursor: Cursor): string { + return Buffer.from(JSON.stringify(cursor), 'utf8').toString('base64url'); +} + +export function decodeCursor(value: string, expectedScope: string): Cursor { + try { + const parsed: unknown = JSON.parse( + Buffer.from(value, 'base64url').toString('utf8'), + ); + + if ( + typeof parsed !== 'object' || + parsed === null || + !('scope' in parsed) || + !('created_at' in parsed) || + !('id' in parsed) || + typeof parsed.scope !== 'string' || + typeof parsed.created_at !== 'string' || + typeof parsed.id !== 'string' || + parsed.scope !== expectedScope || + parsed.created_at.length === 0 || + parsed.id.length === 0 + ) { + throw new Error('invalid cursor'); + } + + return { + scope: parsed.scope, + created_at: parsed.created_at, + id: parsed.id, + }; + } catch { + throw new BadRequestException('Invalid cursor'); + } +} + +export function isAfter( + createdAt: string, + id: string, + cursor: Cursor, +): boolean { + return ( + createdAt > cursor.created_at || + (createdAt === cursor.created_at && id > cursor.id) + ); +} diff --git a/app/src/common/http/request-id.interceptor.ts b/app/src/common/http/request-id.interceptor.ts new file mode 100644 index 00000000..4351566b --- /dev/null +++ b/app/src/common/http/request-id.interceptor.ts @@ -0,0 +1,35 @@ +import { + CallHandler, + ExecutionContext, + Injectable, + NestInterceptor, +} from '@nestjs/common'; +import { randomUUID } from 'node:crypto'; +import { Observable } from 'rxjs'; + +type RequestWithId = { + requestId?: string; +}; + +type ResponseWithHeader = { + header(name: string, value: string): void; +}; + +@Injectable() +export class RequestIdInterceptor implements NestInterceptor { + intercept( + context: ExecutionContext, + next: CallHandler, + ): Observable | Promise> { + const request = context.switchToHttp().getRequest(); + + const response = context.switchToHttp().getResponse(); + + const requestId = randomUUID(); + + request.requestId = requestId; + response.header('X-Request-Id', requestId); + + return next.handle(); + } +} diff --git a/app/src/health/health.controller.ts b/app/src/health/health.controller.ts new file mode 100644 index 00000000..68a59280 --- /dev/null +++ b/app/src/health/health.controller.ts @@ -0,0 +1,17 @@ +import { Controller, Get } from '@nestjs/common'; +import { HealthService } from './health.service.js'; + +@Controller('health') +export class HealthController { + constructor(private readonly healthService: HealthService) {} + + @Get('live') + getLive() { + return this.healthService.getLiveness(); + } + + @Get('ready') + getReady() { + return this.healthService.getReadiness(); + } +} diff --git a/app/src/health/health.module.ts b/app/src/health/health.module.ts new file mode 100644 index 00000000..90aadd3e --- /dev/null +++ b/app/src/health/health.module.ts @@ -0,0 +1,10 @@ +import { Module } from '@nestjs/common'; +import { HealthController } from './health.controller.js'; +import { HealthService } from './health.service.js'; + +@Module({ + imports: [], + controllers: [HealthController], + providers: [HealthService], +}) +export class HealthModule {} diff --git a/app/src/health/health.service.spec.ts b/app/src/health/health.service.spec.ts new file mode 100644 index 00000000..c772d50c --- /dev/null +++ b/app/src/health/health.service.spec.ts @@ -0,0 +1,57 @@ +import { ServiceUnavailableException } from '@nestjs/common'; +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; +import { HealthService } from './health.service.js'; + +describe('HealthService', () => { + const originalDrainDelay = process.env.DRAIN_DELAY_MS; + + beforeEach(() => { + vi.useFakeTimers(); + }); + + afterEach(() => { + vi.useRealTimers(); + if (originalDrainDelay === undefined) { + delete process.env.DRAIN_DELAY_MS; + } else { + process.env.DRAIN_DELAY_MS = originalDrainDelay; + } + }); + + it('reports live and ready before shutdown starts', () => { + const service = new HealthService(); + + expect(service.getLiveness()).toEqual({ status: 'ok' }); + expect(service.getReadiness()).toEqual({ status: 'ok' }); + }); + + it('keeps liveness healthy but rejects readiness while draining', () => { + const service = new HealthService(); + service.setDraining(); + + expect(service.getLiveness()).toEqual({ status: 'ok' }); + expect(() => service.getReadiness()).toThrow(ServiceUnavailableException); + expect(() => service.getReadiness()).toThrow('Service is shutting down'); + }); + + it('waits for the configured drain window after a termination signal', async () => { + process.env.DRAIN_DELAY_MS = '5000'; + const service = new HealthService(); + + const shutdown = service.beforeApplicationShutdown('SIGTERM'); + await vi.advanceTimersByTimeAsync(4999); + expect(() => service.getReadiness()).toThrow('Service is shutting down'); + + await vi.advanceTimersByTimeAsync(1); + await expect(shutdown).resolves.toBeUndefined(); + }); + + it('does not delay explicit application close without a signal', async () => { + process.env.DRAIN_DELAY_MS = '5000'; + const service = new HealthService(); + + await expect(service.beforeApplicationShutdown()).resolves.toBeUndefined(); + expect(() => service.getReadiness()).toThrow('Service is shutting down'); + expect(vi.getTimerCount()).toBe(0); + }); +}); diff --git a/app/src/health/health.service.ts b/app/src/health/health.service.ts new file mode 100644 index 00000000..4cae394f --- /dev/null +++ b/app/src/health/health.service.ts @@ -0,0 +1,45 @@ +import { + Injectable, + ServiceUnavailableException, +} from '@nestjs/common'; +import type { BeforeApplicationShutdown } from '@nestjs/common'; + +@Injectable() +export class HealthService implements BeforeApplicationShutdown { + private ready = true; + private readonly drainDelayMs = this.readDrainDelay(); + + getLiveness() { + return { status: 'ok' as const }; + } + + getReadiness() { + if (!this.ready) { + throw new ServiceUnavailableException('Service is shutting down'); + } + + return { status: 'ok' as const }; + } + + setDraining(): void { + this.ready = false; + } + + async beforeApplicationShutdown(signal?: string): Promise { + this.setDraining(); + + // Explicit app.close() in tests should remain immediate. Signals get a + // drain window so orchestrators can observe readiness=503 before Nest + // closes the HTTP server. + if (signal && this.drainDelayMs > 0) { + await new Promise((resolve) => { + setTimeout(resolve, this.drainDelayMs); + }); + } + } + + private readDrainDelay(): number { + const value = Number.parseInt(process.env.DRAIN_DELAY_MS ?? '5000', 10); + return Number.isFinite(value) && value >= 0 ? value : 5000; + } +} diff --git a/app/src/main.ts b/app/src/main.ts new file mode 100644 index 00000000..475cc389 --- /dev/null +++ b/app/src/main.ts @@ -0,0 +1,38 @@ +import { NestFactory } from '@nestjs/core'; +import { ValidationPipe } from '@nestjs/common'; +import { + FastifyAdapter, + NestFastifyApplication, +} from '@nestjs/platform-fastify'; +import { AppModule } from './app.module.js'; +import { ApiExceptionFilter } from './common/errors/api-exception.filter.js'; +import { RequestIdInterceptor } from './common/http/request-id.interceptor.js'; + +async function bootstrap() { + const app = await NestFactory.create( + AppModule, + new FastifyAdapter({ + logger: true, + }), + ); + + app.useGlobalInterceptors(new RequestIdInterceptor()); + app.useGlobalFilters(new ApiExceptionFilter()); + app.useGlobalPipes( + new ValidationPipe({ + whitelist: true, + forbidNonWhitelisted: true, + transform: true, + }), + ); + app.enableShutdownHooks(); + + const port = Number(process.env.APP_PORT ?? '8080'); + const host = process.env.APP_HOST ?? '0.0.0.0'; + if (!Number.isInteger(port) || port < 1 || port > 65535) { + throw new Error('APP_PORT must be an integer between 1 and 65535'); + } + + await app.listen(port, host); +} +await bootstrap(); diff --git a/app/src/messages/dto/create-message.dto.ts b/app/src/messages/dto/create-message.dto.ts new file mode 100644 index 00000000..a6cf1d1f --- /dev/null +++ b/app/src/messages/dto/create-message.dto.ts @@ -0,0 +1,7 @@ +import { IsString, Length } from 'class-validator'; + +export class CreateMessageDto { + @IsString() + @Length(1, 4000) + text!: string; +} diff --git a/app/src/messages/message.ts b/app/src/messages/message.ts new file mode 100644 index 00000000..e032cf34 --- /dev/null +++ b/app/src/messages/message.ts @@ -0,0 +1,7 @@ +export type Message = { + id: string; + chat_id: string; + sender_id: string; + text: string; + created_at: string; +}; diff --git a/app/src/messages/messages.controller.ts b/app/src/messages/messages.controller.ts new file mode 100644 index 00000000..a6eb956b --- /dev/null +++ b/app/src/messages/messages.controller.ts @@ -0,0 +1,55 @@ +import { + BadRequestException, + Body, + Controller, + DefaultValuePipe, + Get, + Param, + ParseIntPipe, + ParseUUIDPipe, + Post, + Query, + Req, + UseGuards, +} from '@nestjs/common'; +import type { FastifyRequest } from 'fastify'; +import { CurrentUserGuard } from '../common/auth/current-user.guard.js'; +import type { RequestWithCurrentUser } from '../common/auth/current-user.guard.js'; +import { CreateMessageDto } from './dto/create-message.dto.js'; +import { MessagesService } from './messages.service.js'; + +type MessageRequest = FastifyRequest & RequestWithCurrentUser; + +@Controller('api/v1/chats/:chatId/messages') +@UseGuards(CurrentUserGuard) +export class MessagesController { + constructor(private readonly messagesService: MessagesService) {} + + @Post() + create( + @Param('chatId', new ParseUUIDPipe()) chatId: string, + @Body() body: CreateMessageDto, + @Req() request: MessageRequest, + ) { + return this.messagesService.create(chatId, body, request.currentUser!); + } + + @Get() + list( + @Param('chatId', new ParseUUIDPipe()) chatId: string, + @Req() request: MessageRequest, + @Query('limit', new DefaultValuePipe(50), new ParseIntPipe()) limit: number, + @Query('cursor') cursor?: string, + ) { + if (limit < 1 || limit > 100) { + throw new BadRequestException('limit must be between 1 and 100'); + } + + return this.messagesService.list( + chatId, + request.currentUser!, + limit, + cursor, + ); + } +} diff --git a/app/src/messages/messages.module.ts b/app/src/messages/messages.module.ts new file mode 100644 index 00000000..96518e61 --- /dev/null +++ b/app/src/messages/messages.module.ts @@ -0,0 +1,13 @@ +import { Module } from '@nestjs/common'; +import { ChatsModule } from '../chats/chats.module.js'; +import { UsersModule } from '../users/users.module.js'; +import { MessagesController } from './messages.controller.js'; +import { MessagesRepository } from './messages.repository.js'; +import { MessagesService } from './messages.service.js'; + +@Module({ + imports: [UsersModule, ChatsModule], + controllers: [MessagesController], + providers: [MessagesRepository, MessagesService], +}) +export class MessagesModule {} diff --git a/app/src/messages/messages.repository.spec.ts b/app/src/messages/messages.repository.spec.ts new file mode 100644 index 00000000..834dd873 --- /dev/null +++ b/app/src/messages/messages.repository.spec.ts @@ -0,0 +1,42 @@ +import { describe, expect, it } from 'vitest'; +import type { Cursor } from '../common/http/cursor.js'; +import type { Message } from './message.js'; +import { MessagesRepository } from './messages.repository.js'; + +const message = (id: string, created_at: string): Message => ({ + id, + chat_id: 'chat', + sender_id: 'sender', + text: id, + created_at, +}); + +describe('MessagesRepository', () => { + it('appends messages whose key is after the current tail', () => { + const repository = new MessagesRepository(); + repository.save(message('1', '2026-01-01T00:00:00.000Z')); + repository.save(message('2', '2026-01-01T00:00:01.000Z')); + + expect(repository.findByChatId('chat').map((item) => item.id)).toEqual([ + '1', + '2', + ]); + }); + + it('keeps key order for delayed out-of-order messages', () => { + const repository = new MessagesRepository(); + repository.save(message('2', '2026-01-01T00:00:02.000Z')); + repository.save(message('1', '2026-01-01T00:00:01.000Z')); + repository.save(message('3', '2026-01-01T00:00:03.000Z')); + + const messages = repository.findByChatId('chat'); + expect(messages.map((item) => item.id)).toEqual(['1', '2', '3']); + + const cursor: Cursor = { + scope: 'messages:chat', + created_at: '2026-01-01T00:00:01.000Z', + id: '1', + }; + expect(repository.findFirstAfter('chat', cursor)).toBe(1); + }); +}); diff --git a/app/src/messages/messages.repository.ts b/app/src/messages/messages.repository.ts new file mode 100644 index 00000000..fe6a4956 --- /dev/null +++ b/app/src/messages/messages.repository.ts @@ -0,0 +1,68 @@ +import { Injectable } from '@nestjs/common'; +import type { Cursor } from '../common/http/cursor.js'; +import { isAfter } from '../common/http/cursor.js'; +import type { Message } from './message.js'; + +@Injectable() +export class MessagesRepository { + private readonly messagesByChatId = new Map(); + + save(message: Message): void { + const messages = this.messagesByChatId.get(message.chat_id) ?? []; + const last = messages.at(-1); + + if ( + !last || + last.created_at < message.created_at || + (last.created_at === message.created_at && last.id < message.id) + ) { + messages.push(message); + this.messagesByChatId.set(message.chat_id, messages); + return; + } + + // Preserve keyset order if a delayed request carries an older key. + let low = 0; + let high = messages.length; + + while (low < high) { + const middle = Math.floor((low + high) / 2); + const current = messages[middle]; + const comesAfter = + current.created_at > message.created_at || + (current.created_at === message.created_at && current.id > message.id); + + if (comesAfter) high = middle; + else low = middle + 1; + } + + messages.splice(low, 0, message); + this.messagesByChatId.set(message.chat_id, messages); + } + + findByChatId(chatId: string): Message[] { + return this.messagesByChatId.get(chatId) ?? []; + } + + findFirstAfter(chatId: string, cursor: Cursor): number { + const messages = this.messagesByChatId.get(chatId) ?? []; + if (process.env.BENCHMARK_CURSOR_SEARCH === 'linear') { + return messages.findIndex((message) => + isAfter(message.created_at, message.id, cursor), + ); + } + + let low = 0; + let high = messages.length; + while (low < high) { + const middle = Math.floor((low + high) / 2); + if (isAfter(messages[middle].created_at, messages[middle].id, cursor)) { + high = middle; + } else { + low = middle + 1; + } + } + + return low; + } +} diff --git a/app/src/messages/messages.service.ts b/app/src/messages/messages.service.ts new file mode 100644 index 00000000..b2523a85 --- /dev/null +++ b/app/src/messages/messages.service.ts @@ -0,0 +1,75 @@ +import { + BadRequestException, + Injectable, +} from '@nestjs/common'; +import { randomUUID } from 'node:crypto'; +import { decodeCursor, encodeCursor } from '../common/http/cursor.js'; +import type { User } from '../users/user.js'; +import { ChatsService } from '../chats/chats.service.js'; +import type { CreateMessageDto } from './dto/create-message.dto.js'; +import type { Message } from './message.js'; +import { MessagesRepository } from './messages.repository.js'; + +@Injectable() +export class MessagesService { + constructor( + private readonly messagesRepository: MessagesRepository, + private readonly chatsService: ChatsService, + ) {} + + create( + chatId: string, + input: CreateMessageDto, + currentUser: User, + ): Message { + const chat = this.chatsService.getForUser(chatId, currentUser); + + if ([...input.text].every((character) => /\s/u.test(character))) { + throw new BadRequestException('Message text cannot be blank'); + } + + const message: Message = { + id: randomUUID(), + chat_id: chat.id, + sender_id: currentUser.id, + text: input.text, + created_at: new Date().toISOString(), + }; + + this.messagesRepository.save(message); + return message; + } + + list( + chatId: string, + currentUser: User, + limit: number, + cursorValue?: string, + ): { items: Message[]; next_cursor: string | null } { + this.chatsService.getForUser(chatId, currentUser); + + const scope = `messages:${chatId}`; + const cursor = cursorValue + ? decodeCursor(cursorValue, scope) + : undefined; + const messages = this.messagesRepository.findByChatId(chatId); + const start = cursor + ? this.messagesRepository.findFirstAfter(chatId, cursor) + : 0; + const items = messages.slice(start, start + limit); + const hasMore = messages.length > start + limit; + const last = items.at(-1); + + return { + items, + next_cursor: + hasMore && last + ? encodeCursor({ + scope, + created_at: last.created_at, + id: last.id, + }) + : null, + }; + } +} diff --git a/app/src/types.d.ts b/app/src/types.d.ts new file mode 100644 index 00000000..6a215a66 --- /dev/null +++ b/app/src/types.d.ts @@ -0,0 +1,7 @@ +import { User } from './users/user.ts'; + +declare module 'fastify' { + interface FastifyRequest { + currentUser?: User; + } +} diff --git a/app/src/users/dto/create-user.dto.ts b/app/src/users/dto/create-user.dto.ts new file mode 100644 index 00000000..428760fb --- /dev/null +++ b/app/src/users/dto/create-user.dto.ts @@ -0,0 +1,11 @@ +import { IsNotEmpty, IsString, Matches } from 'class-validator'; + +export class CreateUserDTO { + @IsString() + @Matches(/^[a-z0-9_]{3,32}$/) + username: string; + + @IsString() + @IsNotEmpty() + display_name: string; +} diff --git a/app/src/users/user.ts b/app/src/users/user.ts new file mode 100644 index 00000000..9c91d9e7 --- /dev/null +++ b/app/src/users/user.ts @@ -0,0 +1,6 @@ +export type User = { + id: string; + username: string; + display_name: string; + created_at: string; +}; diff --git a/app/src/users/users.controller.ts b/app/src/users/users.controller.ts new file mode 100644 index 00000000..59e30d2b --- /dev/null +++ b/app/src/users/users.controller.ts @@ -0,0 +1,21 @@ +import { Body, Controller, Get, Post, Req, UseGuards } from '@nestjs/common'; +import { UsersService } from './users.service.js'; +import { CreateUserDTO } from './dto/create-user.dto.js'; +import type { FastifyRequest } from 'fastify'; +import { CurrentUserGuard } from '../common/auth/current-user.guard.js'; + +@Controller('api/v1/users') +export class UsersController { + constructor(private readonly usersService: UsersService) {} + + @Post() + create(@Body() body: CreateUserDTO) { + return this.usersService.create(body); + } + + @Get('/me') + @UseGuards(CurrentUserGuard) + getMe(@Req() request: FastifyRequest) { + return request.currentUser; + } +} diff --git a/app/src/users/users.module.ts b/app/src/users/users.module.ts new file mode 100644 index 00000000..13738a4e --- /dev/null +++ b/app/src/users/users.module.ts @@ -0,0 +1,12 @@ +import { Module } from '@nestjs/common'; +import { UsersController } from './users.controller.js'; +import { UsersRepository } from './users.repository.js'; +import { UsersService } from './users.service.js'; +import { CurrentUserGuard } from '../common/auth/current-user.guard.js'; + +@Module({ + controllers: [UsersController], + providers: [UsersRepository, UsersService, CurrentUserGuard], + exports: [UsersService, CurrentUserGuard], +}) +export class UsersModule {} diff --git a/app/src/users/users.repository.ts b/app/src/users/users.repository.ts new file mode 100644 index 00000000..f5a98400 --- /dev/null +++ b/app/src/users/users.repository.ts @@ -0,0 +1,25 @@ +import { Injectable } from '@nestjs/common'; +import { User } from './user.js'; + +@Injectable() +export class UsersRepository { + private readonly usersById = new Map(); + private readonly userIdByUsername = new Map(); + + findById(id: string): User | undefined { + return this.usersById.get(id); + } + + findByUsername(username: string): User | undefined { + const userId = this.userIdByUsername.get(username); + if (!userId) { + return undefined; + } + return this.usersById.get(userId); + } + + save(user: User): void { + this.usersById.set(user.id, user); + this.userIdByUsername.set(user.username, user.id); + } +} diff --git a/app/src/users/users.service.ts b/app/src/users/users.service.ts new file mode 100644 index 00000000..8f2a21fb --- /dev/null +++ b/app/src/users/users.service.ts @@ -0,0 +1,45 @@ +import { + BadRequestException, + ConflictException, + Injectable, +} from '@nestjs/common'; +import { UsersRepository } from './users.repository.js'; +import { CreateUserDTO } from './dto/create-user.dto.js'; +import { User } from './user.js'; +import { randomUUID } from 'node:crypto'; + +@Injectable() +export class UsersService { + constructor(private readonly usersRepository: UsersRepository) {} + + create(input: CreateUserDTO): User { + const displayNameLength = [...input.display_name].length; + + if ( + displayNameLength < 1 || + displayNameLength > 100 || + input.display_name.trim().length === 0 + ) { + throw new BadRequestException('Invalid display name'); + } + + if (this.usersRepository.findByUsername(input.username)) { + throw new ConflictException('Username already exists'); + } + + const user: User = { + id: randomUUID(), + username: input.username, + display_name: input.display_name, + created_at: new Date().toISOString(), + }; + + this.usersRepository.save(user); + + return user; + } + + findById(id: string): User | undefined { + return this.usersRepository.findById(id); + } +} diff --git a/app/test/app.e2e-spec.ts b/app/test/app.e2e-spec.ts new file mode 100644 index 00000000..dfd1a73f --- /dev/null +++ b/app/test/app.e2e-spec.ts @@ -0,0 +1,313 @@ +import { HealthService } from './../src/health/health.service.js'; + +import { Test, TestingModule } from '@nestjs/testing'; +import { INestApplication, ValidationPipe } from '@nestjs/common'; +import request from 'supertest'; +import { App } from 'supertest/types'; +import { AppModule } from './../src/app.module.js'; +import { RequestIdInterceptor } from './../src/common/http/request-id.interceptor.js'; +import { ApiExceptionFilter } from './../src/common/errors/api-exception.filter.js'; + +describe('Foundation HTTP contract', () => { + let app: INestApplication; + + beforeEach(async () => { + const moduleFixture: TestingModule = await Test.createTestingModule({ + imports: [AppModule], + }).compile(); + + app = moduleFixture.createNestApplication(); + + app.useGlobalInterceptors(new RequestIdInterceptor()); + app.useGlobalFilters(new ApiExceptionFilter()); + app.useGlobalPipes( + new ValidationPipe({ + whitelist: true, + forbidNonWhitelisted: true, + transform: true, + }), + ); + + await app.init(); + }); + + afterEach(async () => { + await app.close(); + }); + + it('returns liveness status with request id', async () => { + const response = await request(app.getHttpServer()) + .get('/health/live') + .expect(200); + + expect(response.body).toEqual({ status: 'ok' }); + expect(response.headers['x-request-id']).toEqual(expect.any(String)); + expect(response.headers['x-request-id']).not.toHaveLength(0); + }); + + it('returns readiness status with request id', async () => { + const response = await request(app.getHttpServer()) + .get('/health/ready') + .expect(200); + + expect(response.body).toEqual({ status: 'ok' }); + expect(response.headers['x-request-id']).toEqual(expect.any(String)); + }); + + it('keeps liveness alive while readiness is draining', async () => { + app.get(HealthService).setDraining(); + + const liveResponse = await request(app.getHttpServer()) + .get('/health/live') + .expect(200); + expect(liveResponse.body).toEqual({ status: 'ok' }); + + const readyResponse = await request(app.getHttpServer()) + .get('/health/ready') + .expect(503); + const requestId = readyResponse.headers['x-request-id']; + expect(requestId).toEqual(expect.any(String)); + expect(readyResponse.body).toEqual({ + error: { + code: 'unavailable', + message: 'Service is shutting down', + request_id: requestId, + }, + }); + }); + + it('returns contract error with matching request id for unknown route', async () => { + const response = await request(app.getHttpServer()) + .get('/health/unknown') + .expect(404); + + const requestId = response.headers['x-request-id']; + + expect(requestId).toEqual(expect.any(String)); + expect(response.body).toEqual({ + error: { + code: 'not_found', + message: 'Resource not found', + request_id: requestId, + }, + }); + }); + + it('registers a user and returns it from /me', async () => { + const created = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ + username: 'alice', + display_name: 'Алиса', + }) + .expect(201); + + const user = created.body; + + const current = await request(app.getHttpServer()) + .get('/api/v1/users/me') + .set('X-User-Id', user.id) + .expect(200); + + expect(current.body).toEqual(user); + }); + + it('rejects /me without X-User-Id', async () => { + const response = await request(app.getHttpServer()) + .get('/api/v1/users/me') + .expect(401); + + expect(response.body.error.code).toBe('unauthorized'); + expect(response.headers['x-request-id']).toBe( + response.body.error.request_id, + ); + }); + + it('rejects duplicate usernames', async () => { + await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ + username: 'duplicate_user', + display_name: 'Первый', + }) + .expect(201); + + const response = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ + username: 'duplicate_user', + display_name: 'Второй', + }) + .expect(409); + + expect(response.body.error.code).toBe('conflict'); + }); + + it('creates a chat and hides it from a non-member', async () => { + const aliceResponse = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ + username: 'alice_chat', + display_name: 'Алиса', + }) + .expect(201); + + const bobResponse = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ + username: 'bob_chat', + display_name: 'Боб', + }) + .expect(201); + + const aliceId = aliceResponse.body.id; + const bobId = bobResponse.body.id; + + const chatResponse = await request(app.getHttpServer()) + .post('/api/v1/chats') + .set('X-User-Id', aliceId) + .send({ + title: 'Учебный чат', + member_ids: [aliceId, bobId], + }) + .expect(201); + + expect(chatResponse.body.member_ids).toEqual([aliceId, bobId]); + + await request(app.getHttpServer()) + .get(`/api/v1/chats/${chatResponse.body.id}`) + .set('X-User-Id', bobId) + .expect(200); + + const outsiderResponse = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ + username: 'charlie_chat', + display_name: 'Чарли', + }) + .expect(201); + + await request(app.getHttpServer()) + .get(`/api/v1/chats/${chatResponse.body.id}`) + .set('X-User-Id', outsiderResponse.body.id) + .expect(404); + }); + + it('rejects chat when current user is not in member_ids', async () => { + const aliceResponse = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ + username: 'alice_member', + display_name: 'Алиса', + }) + .expect(201); + + const bobResponse = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ + username: 'bob_member', + display_name: 'Боб', + }) + .expect(201); + + const response = await request(app.getHttpServer()) + .post('/api/v1/chats') + .set('X-User-Id', aliceResponse.body.id) + .send({ + title: 'Неверный чат', + member_ids: [bobResponse.body.id], + }) + .expect(400); + + expect(response.body.error.code).toBe('invalid_request'); + }); + it('paginates chat history without repeating messages', async () => { + const alice = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ username: 'page_alice', display_name: 'Алиса' }) + .expect(201); + + const bob = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ username: 'page_bob', display_name: 'Боб' }) + .expect(201); + + const aliceId = alice.body.id; + const bobId = bob.body.id; + const chat = await request(app.getHttpServer()) + .post('/api/v1/chats') + .set('X-User-Id', aliceId) + .send({ title: 'История', member_ids: [aliceId, bobId] }) + .expect(201); + + const createdMessages: Array<{ id: string }> = []; + for (const text of ['one', 'two', 'three']) { + const response = await request(app.getHttpServer()) + .post(`/api/v1/chats/${chat.body.id}/messages`) + .set('X-User-Id', aliceId) + .send({ text }) + .expect(201); + + createdMessages.push(response.body); + } + + const firstPage = await request(app.getHttpServer()) + .get(`/api/v1/chats/${chat.body.id}/messages`) + .query({ limit: 2 }) + .set('X-User-Id', bobId) + .expect(200); + + expect(firstPage.body.items.map((item: { id: string }) => item.id)).toEqual( + createdMessages.slice(0, 2).map((item) => item.id), + ); + expect(firstPage.body.next_cursor).toEqual(expect.any(String)); + + const secondPage = await request(app.getHttpServer()) + .get(`/api/v1/chats/${chat.body.id}/messages`) + .query({ limit: 2, cursor: firstPage.body.next_cursor }) + .set('X-User-Id', bobId) + .expect(200); + + expect(secondPage.body.items.map((item: { id: string }) => item.id)).toEqual( + [createdMessages[2].id], + ); + expect(secondPage.body.next_cursor).toBeNull(); + }); + + it('rejects blank messages and sender spoofing fields', async () => { + const alice = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ username: 'blank_alice', display_name: 'Алиса' }) + .expect(201); + + const chat = await request(app.getHttpServer()) + .post('/api/v1/chats') + .set('X-User-Id', alice.body.id) + .send({ title: 'Проверка', member_ids: [alice.body.id] }) + .expect(201); + + const response = await request(app.getHttpServer()) + .post(`/api/v1/chats/${chat.body.id}/messages`) + .set('X-User-Id', alice.body.id) + .send({ text: ' ', sender_id: 'spoofed' }) + .expect(400); + + expect(response.body.error.code).toBe('invalid_request'); + }); + + it('rejects an invalid cursor and an invalid limit', async () => { + const alice = await request(app.getHttpServer()) + .post('/api/v1/users') + .send({ username: 'cursor_alice', display_name: 'Алиса' }) + .expect(201); + + const response = await request(app.getHttpServer()) + .get('/api/v1/chats') + .query({ limit: 101, cursor: 'not-a-cursor' }) + .set('X-User-Id', alice.body.id) + .expect(400); + + expect(response.body.error.code).toBe('invalid_request'); + }); + +}); diff --git a/app/tsconfig.build.json b/app/tsconfig.build.json new file mode 100644 index 00000000..2eafee0e --- /dev/null +++ b/app/tsconfig.build.json @@ -0,0 +1,8 @@ +{ + "extends": "./tsconfig.json", + "compilerOptions": { + "rootDir": "./src" + }, + "include": ["src"], + "exclude": ["node_modules", "test", "dist", "**/*spec.ts"] +} diff --git a/app/tsconfig.json b/app/tsconfig.json new file mode 100644 index 00000000..8109c41f --- /dev/null +++ b/app/tsconfig.json @@ -0,0 +1,22 @@ +{ + "compilerOptions": { + "module": "nodenext", + "moduleResolution": "nodenext", + "resolvePackageJsonExports": true, + "esModuleInterop": true, + "isolatedModules": true, + "declaration": true, + "removeComments": true, + "emitDecoratorMetadata": true, + "experimentalDecorators": true, + "allowSyntheticDefaultImports": true, + "target": "ES2023", + "sourceMap": true, + "outDir": "./dist", + "incremental": true, + "skipLibCheck": true, + "strict": true, + "strictPropertyInitialization": false, + "types": ["vitest/globals", "node"] + } +} diff --git a/app/vitest.config.e2e.ts b/app/vitest.config.e2e.ts new file mode 100644 index 00000000..b5b532cf --- /dev/null +++ b/app/vitest.config.e2e.ts @@ -0,0 +1,11 @@ +import { defineConfig } from 'vitest/config'; +import tsconfigPaths from 'vite-tsconfig-paths'; + +export default defineConfig({ + plugins: [tsconfigPaths()], + test: { + globals: true, + root: './', + include: ['**/*.e2e-spec.ts'], + }, +}); diff --git a/app/vitest.config.ts b/app/vitest.config.ts new file mode 100644 index 00000000..9384f47b --- /dev/null +++ b/app/vitest.config.ts @@ -0,0 +1,13 @@ +import { defineConfig } from 'vitest/config'; +import tsconfigPaths from 'vite-tsconfig-paths'; + +export default defineConfig({ + // Resolves the path aliases declared in tsconfig.json, including the ones + // added by `nest g library`. + plugins: [tsconfigPaths()], + test: { + globals: true, + root: './', + include: ['**/*.spec.ts'], + }, +}); diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 00000000..aa409656 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,13 @@ +services: + nest-app: + build: + context: . + dockerfile: Dockerfile + image: mtusi-messenger:lab2 + ports: + - ${APP_PUBLIC_PORT:-8080}:${APP_PORT:-8080} + env_file: + - .env + environment: + BENCHMARK_CURSOR_SEARCH: ${BENCHMARK_CURSOR_SEARCH:-binary} + stop_grace_period: 30s -- 2.54.0 From 575f8ee3863da07877a2687eee5877cb851a6d73 Mon Sep 17 00:00:00 2001 From: Ilya Date: Fri, 9 Oct 2026 15:48:03 +0300 Subject: [PATCH 2/4] feat: lab2 done --- .env.example | 48 +- .github/pull_request_template.md | 88 +- .gitignore | 3 + Dockerfile | 8 +- REPORT.md | 237 ++++- app/README.md | 232 +++-- app/nest-cli.json | 9 +- app/package-lock.json | 952 +++++++++++++++++- app/package.json | 11 +- app/scripts/graph-modules.ts | 123 +++ app/src/app.module.ts | 25 +- app/src/auth/auth.controller.ts | 79 ++ app/src/auth/auth.module.ts | 16 + app/src/auth/auth.service.ts | 63 ++ app/src/auth/session.repository.ts | 35 + app/src/chats/chats.controller.ts | 77 +- app/src/chats/chats.module.ts | 13 +- app/src/chats/chats.repository.ts | 112 ++- app/src/chats/chats.service.ts | 131 +-- app/src/common/auth/current-user.decorator.ts | 10 + app/src/common/auth/current-user.guard.ts | 92 +- app/src/common/errors/api-exception.filter.ts | 137 ++- app/src/common/http/cursor.ts | 83 +- app/src/common/http/request-id.interceptor.ts | 49 +- app/src/config/app-config.module.ts | 16 + app/src/config/app-config.schema.ts | 91 ++ app/src/database/database.client.ts | 75 ++ app/src/database/database.module.ts | 10 + app/src/database/migration.runner.ts | 63 ++ app/src/database/migrations/001_initial.sql | 41 + .../migrations/002_timestamp_precision.sql | 5 + app/src/health/health.controller.ts | 18 +- app/src/health/health.module.ts | 8 +- app/src/health/health.service.spec.ts | 89 +- app/src/health/health.service.ts | 82 +- app/src/main.ts | 29 +- .../cache/messages-cache.metrics.spec.ts | 37 + .../messages/cache/messages-cache.module.ts | 11 + .../cache/messages-cache.service.spec.ts | 72 ++ .../messages/cache/messages-cache.service.ts | 207 ++++ app/src/messages/dto/create-message.dto.ts | 6 +- app/src/messages/message.ts | 10 +- app/src/messages/messages.controller.ts | 77 +- app/src/messages/messages.module.ts | 19 +- app/src/messages/messages.repository.spec.ts | 69 +- app/src/messages/messages.repository.ts | 143 +-- app/src/messages/messages.service.ts | 126 +-- app/src/metrics/metrics.controller.ts | 43 + app/src/metrics/metrics.module.ts | 10 + app/src/metrics/metrics.service.spec.ts | 62 ++ app/src/metrics/metrics.service.ts | 69 ++ app/src/redis/redis.client.ts | 134 +++ app/src/redis/redis.module.ts | 10 + app/src/users/dto/create-user.dto.ts | 15 +- app/src/users/users.controller.ts | 13 +- app/src/users/users.module.ts | 6 +- app/src/users/users.repository.ts | 82 +- app/src/users/users.service.ts | 43 +- app/test/app.e2e-spec.ts | 684 +++++++------ app/vitest.config.e2e.ts | 15 +- bruno/README.md | 98 ++ bruno/auth/create-session-second.bru | 31 + bruno/auth/create-session-third.bru | 31 + bruno/auth/create-session.bru | 46 + bruno/auth/me.bru | 30 + bruno/auth/register-second-user.bru | 42 + bruno/auth/register-third-user.bru | 41 + bruno/auth/register-user.bru | 53 + bruno/bruno.json | 6 + bruno/chats/create-chat.bru | 46 + bruno/chats/get-chat.bru | 30 + bruno/chats/list-chats.bru | 30 + bruno/collection.bru | 29 + bruno/environments/local.bru | 5 + bruno/health/health-live.bru | 26 + bruno/health/health-ready.bru | 26 + bruno/internal/metrics-reset.bru | 30 + bruno/internal/metrics.bru | 33 + bruno/messages/history-first-page.bru | 40 + bruno/messages/history-next-page.bru | 31 + bruno/messages/send-message-second-user.bru | 40 + bruno/messages/send-message.bru | 46 + bruno/negative/basic-on-business-endpoint.bru | 31 + bruno/negative/blank-message.bru | 33 + bruno/negative/duplicate-username-409.bru | 34 + bruno/negative/invalid-limit-and-cursor.bru | 31 + bruno/negative/non-member-chat-404.bru | 30 + bruno/negative/wrong-password.bru | 35 + bruno/negative/x-user-id-alone.bru | 30 + bruno/negative/x-user-id-cannot-spoof.bru | 32 + bruno/zz-cleanup/logout-current-session.bru | 30 + bruno/zz-cleanup/revoked-token-rejected.bru | 30 + docker-compose.yml | 78 +- docs/architecture/README.md | 26 + docs/architecture/nest-dependency-graph.md | 247 +++++ docs/architecture/nest-module-details.json | 374 +++++++ docs/architecture/nest-module-graph.mmd | 116 +++ evidence/README.md | 57 +- evidence/level3-4-verification.md | 211 ++++ evidence/track1-cache-consistency.md | 181 ++++ evidence/track1-explain.md | 120 +++ scripts/restart.sh | 8 + scripts/track1_cache_benchmark.py | 283 ++++++ scripts/track1_verify.py | 207 ++++ 104 files changed, 7038 insertions(+), 1099 deletions(-) create mode 100644 app/scripts/graph-modules.ts create mode 100644 app/src/auth/auth.controller.ts create mode 100644 app/src/auth/auth.module.ts create mode 100644 app/src/auth/auth.service.ts create mode 100644 app/src/auth/session.repository.ts create mode 100644 app/src/common/auth/current-user.decorator.ts create mode 100644 app/src/config/app-config.module.ts create mode 100644 app/src/config/app-config.schema.ts create mode 100644 app/src/database/database.client.ts create mode 100644 app/src/database/database.module.ts create mode 100644 app/src/database/migration.runner.ts create mode 100644 app/src/database/migrations/001_initial.sql create mode 100644 app/src/database/migrations/002_timestamp_precision.sql create mode 100644 app/src/messages/cache/messages-cache.metrics.spec.ts create mode 100644 app/src/messages/cache/messages-cache.module.ts create mode 100644 app/src/messages/cache/messages-cache.service.spec.ts create mode 100644 app/src/messages/cache/messages-cache.service.ts create mode 100644 app/src/metrics/metrics.controller.ts create mode 100644 app/src/metrics/metrics.module.ts create mode 100644 app/src/metrics/metrics.service.spec.ts create mode 100644 app/src/metrics/metrics.service.ts create mode 100644 app/src/redis/redis.client.ts create mode 100644 app/src/redis/redis.module.ts create mode 100644 bruno/README.md create mode 100644 bruno/auth/create-session-second.bru create mode 100644 bruno/auth/create-session-third.bru create mode 100644 bruno/auth/create-session.bru create mode 100644 bruno/auth/me.bru create mode 100644 bruno/auth/register-second-user.bru create mode 100644 bruno/auth/register-third-user.bru create mode 100644 bruno/auth/register-user.bru create mode 100644 bruno/bruno.json create mode 100644 bruno/chats/create-chat.bru create mode 100644 bruno/chats/get-chat.bru create mode 100644 bruno/chats/list-chats.bru create mode 100644 bruno/collection.bru create mode 100644 bruno/environments/local.bru create mode 100644 bruno/health/health-live.bru create mode 100644 bruno/health/health-ready.bru create mode 100644 bruno/internal/metrics-reset.bru create mode 100644 bruno/internal/metrics.bru create mode 100644 bruno/messages/history-first-page.bru create mode 100644 bruno/messages/history-next-page.bru create mode 100644 bruno/messages/send-message-second-user.bru create mode 100644 bruno/messages/send-message.bru create mode 100644 bruno/negative/basic-on-business-endpoint.bru create mode 100644 bruno/negative/blank-message.bru create mode 100644 bruno/negative/duplicate-username-409.bru create mode 100644 bruno/negative/invalid-limit-and-cursor.bru create mode 100644 bruno/negative/non-member-chat-404.bru create mode 100644 bruno/negative/wrong-password.bru create mode 100644 bruno/negative/x-user-id-alone.bru create mode 100644 bruno/negative/x-user-id-cannot-spoof.bru create mode 100644 bruno/zz-cleanup/logout-current-session.bru create mode 100644 bruno/zz-cleanup/revoked-token-rejected.bru create mode 100644 docs/architecture/README.md create mode 100644 docs/architecture/nest-dependency-graph.md create mode 100644 docs/architecture/nest-module-details.json create mode 100644 docs/architecture/nest-module-graph.mmd create mode 100644 evidence/level3-4-verification.md create mode 100644 evidence/track1-cache-consistency.md create mode 100644 evidence/track1-explain.md create mode 100755 scripts/restart.sh create mode 100755 scripts/track1_cache_benchmark.py create mode 100755 scripts/track1_verify.py diff --git a/.env.example b/.env.example index 714c8076..d07fae21 100644 --- a/.env.example +++ b/.env.example @@ -1,11 +1,45 @@ -# Copy to .env for your LOCAL synthetic test environment; never commit .env. -# These are logical interface suggestions; map actual framework names in REPORT.md. APP_HOST=0.0.0.0 APP_PORT=8080 +APP_PUBLIC_PORT=8080 APP_ENV=lab SESSION_TTL_SECONDS=3600 -# Choose credentials locally. File paths contain no secret values. -DATABASE_URL_FILE=/run/secrets/database_url -# Optional on 3, required use on 4 in lab2; Redis OR Valkey: -SESSION_STORE=postgres -CACHE_URL_FILE=/run/secrets/cache_url + +# Credentials for the local synthetic stand. Never commit a real .env. +# Rationale and tradeoffs: REPORT.md, section "Конфигурация и секреты". +# POSTGRES_PASSWORD initializes the database volume; DATABASE_URL must use the +# same password, otherwise the API cannot connect to an existing volume. +POSTGRES_DB=messenger +POSTGRES_USER=messenger +POSTGRES_PASSWORD=change-me +DATABASE_URL=postgresql://messenger:change-me@postgres:5432/messenger +REDIS_URL=redis://redis:6379 + +# Application tuning +DATABASE_POOL_MAX=10 +DATABASE_CONNECTION_TIMEOUT_MS=5000 +DATABASE_STATEMENT_TIMEOUT_MS=5000 +CACHE_TTL_SECONDS=30 +CACHE_MODE=protected +CACHE_LOCK_TTL_MS=1000 +CACHE_MISS_DELAY_MS=0 +METRICS_TOKEN=change-me + +# Clean clone (run once, then `docker compose --env-file .env up -d --build`): +# cp .env.example .env +# password=$(openssl rand -hex 32) +# sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$password/" .env +# sed -i "s|^DATABASE_URL=.*|DATABASE_URL=postgresql://messenger:$password@postgres:5432/messenger|" .env +# sed -i "s/^METRICS_TOKEN=.*/METRICS_TOKEN=$(openssl rand -hex 16)/" .env +# unset password +# +# Existing postgres-data keeps its original password: changing POSTGRES_PASSWORD +# alone does not rotate it. Update DATABASE_URL to the volume's password, or +# rotate the password inside PostgreSQL explicitly. +# +# Alternative for docker-secrets or Swarm deployments: point DATABASE_URL_FILE / +# REDIS_URL_FILE at mounted secret files instead of inline URLs. The application +# reads the file, trims it, and validates it exactly like an inline value. + +# Optional file-based secret override (uncomment to use): +# DATABASE_URL_FILE=/run/secrets/database_url +# REDIS_URL_FILE=/run/secrets/redis_url diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 8ceefa10..3fe887f6 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,18 +1,78 @@ ## Лабораторная 2 -Автор / группа: TODO -Целевая оценка (3/4/5): TODO -Трек 5, если заявлен: TODO +Автор / группа: Тюнин Илья БВТ2303 +Целевая оценка (3/4/5): 5 +Трек 1, если заявлен: Трек 1 «Согласованность кэша» — при 32 конкурентных чтениях холодной страницы × 5 повторностей: **160 SQL-запросов истории в naive против 5 в protected (−96,9 %)**, read-after-write подтверждён, сессия и история переживают рестарт Redis -Что реализовано и что перенесено: TODO -Команды запуска из чистого clone: TODO -Результаты проверок и ссылка на REPORT.md: TODO -Ограничения / известные ошибки: TODO -Источники и использование ИИ: TODO +### Что реализовано -- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. -- [ ] Контракт и публичные тесты не ослаблены. -- [ ] make check и make test выполнены; приложен реальный вывод. -- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. -- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. -- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. +- **PostgreSQL 16.4 — источник истины**: `users`, `chats`, `chat_members`, `messages`; версионируемые миграции `001_initial.sql`, `002_timestamp_precision.sql`; raw `pg.Pool` с ограниченным пулом, connection/statement timeout и параметризованными запросами, без ORM. +- **Транзакционные границы**: создание чата (валидация участников + chat + membership) и отправка сообщения (membership + insert + `message_version`) — в одной транзакции с rollback; проверено отсутствие частичных данных. +- **Redis 7.4.2 с AOF — серверные Bearer-сессии** с TTL, expiry и logout; одновременно версионированный кэш истории с lock на конкретную страницу `(chat_id, message_version, cursor, limit)` и fallback в PostgreSQL при недоступности Redis. +- **Аутентификация по контракту lab2**: Basic только на `POST /auth/sessions` (UTF-8, первый `:`), Bearer на бизнес-endpoint, `X-User-Id` не аутентифицирует и не подменяет владельца, Argon2id, opaque-токен 256 бит. +- **Воспроизводимый стенд**: Compose с pinned-образами, именованными volumes, healthchecks, сервисом миграций перед API, конфигурацией через `.env`. +- **Наблюдаемость**: token-gated `GET /internal/metrics` и `POST /internal/metrics/reset` — SQL-метки, операции Redis, cache hit/miss/lock wait, session get/set/del, request count, агрегаты латентности; деградации кэша и зависимостей пишутся счётчиками и `warn`-логами, а не проглатываются. +- **Перенесено из lab1** с объявленным переходом: health, регистрация/пользователи, чаты и участники, сообщения, keyset-пагинация — переведены на новую аутентификацию. + +Подробности решения — [`REPORT.md`](../REPORT.md) (архитектура, схема, транзакции, политика кэша, команды, ограничения). +Проверки уровня 3/4 — [`evidence/level3-4-verification.md`](../evidence/level3-4-verification.md). +Трек 1 — [`evidence/track1-cache-consistency.md`](../evidence/track1-cache-consistency.md) и [`evidence/track1-explain.md`](../evidence/track1-explain.md). +Навигация по доказательствам — [`evidence/README.md`](../evidence/README.md). +Ручной клиент для разбора API — [`bruno/README.md`](../bruno/README.md). + +### Команды запуска из чистого clone + +```sh +cp .env.example .env +password=$(openssl rand -hex 32) +sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$password/" .env +sed -i "s|^DATABASE_URL=.*|DATABASE_URL=postgresql://messenger:$password@postgres:5432/messenger|" .env +sed -i "s/^METRICS_TOKEN=.*/METRICS_TOKEN=$(openssl rand -hex 16)/" .env +unset password + +docker compose --env-file .env config --quiet +docker compose --env-file .env up -d --build # postgres/redis healthy, migrate exit 0, api healthy +curl -fsS http://localhost:8080/health/ready +``` + +Пояснения по переменным и паролю существующего volume — [`.env.example`](../.env.example) и [REPORT.md § «Конфигурация и секреты»](../REPORT.md). + +### Результаты проверок (фактический вывод) + +```text +make check PASS +make validate PASS +make test BASE_URL=http://localhost:8080 PASS: lab2 public API scenario +make test-persistence ACTION_SCRIPT=scripts/restart.sh PASS: preserved confirmed data and existing session +(cd app && npm run build) PASS +(cd app && npm test) 5 files, 13 tests passed +(cd app && npx tsc --noEmit) PASS +integration suite (реальные PostgreSQL/Redis) 7 passed | 1 skipped +то же с SESSION_TTL_SECONDS=2 8 passed (expiry → 401) +коллекция Bruno (bru run -r --env local) 28 запросов, 56 проверок — все зелёные +``` + +Трек 1 (32 конкурентных GET × 5 повторностей, `CACHE_MISS_DELAY_MS=75`): + +| Режим | SQL `messages.history` | Cache hits | Ошибок | p50, мс | +| --------- | ---------------------: | ---------: | -----: | ------: | +| naive | 160 | 0 | 0 | ≈ 89 | +| protected | 5 | 155 | 0 | ≈ 20 | + +Отдельно проверены: гонка одинакового username (201 + 409, в таблице ровно 1 строка, unique-индекс), rollback при неизвестном участнике чата (`400`, строк не осталось), отказы Redis и PostgreSQL (`/health/ready` 503, анонимный доступ не выдаётся, процесс API жив, после старта — 200 с тем же токеном), `EXPLAIN (ANALYZE, BUFFERS)` на 10 002 сообщениях (Index Scan по `messages_chat_created_id_idx`, keyset-предикат в `Index Cond`). + +- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. +- [x] Контракт и публичные тесты не ослаблены (`contracts/` и `tests/` не изменялись). +- [x] `make check` и `make test` выполнены; приложен реальный вывод (выше и в evidence). +- [x] Сценарии отказов/безопасности своего уровня воспроизведены (отказы Redis/PostgreSQL, expiry, logout/replay, spoofing, rollback — [журнал](../evidence/level3-4-verification.md)). +- [x] Все секреты и приватные ключи находятся вне Git: `.env` и локальные секреты покрыты `.gitignore`, в отчёте и evidence нет токенов и паролей. +- [x] README задания сохранён, `REPORT.md` содержит инструкцию именно этого решения. + +### Ограничения / известные ошибки + +- Метрики локальны процессу API и сбрасываются при его рестарте; при нескольких репликах их нельзя суммировать как распределённый снимок. +- Измерения трека 1 — closed-loop на одном хосте (32 конкурентных читателя, 5 повторностей): это не production-пропускная способность. +- `redis-data` хранит действующие сессии: удаление volume осознанно разлогинивает пользователей; AOF плюс сохранённый volume — проверенная граница durability. +- `CACHE_MODE=naive` и `CACHE_MISS_DELAY_MS` предназначены только для эксперимента и задаются переменными окружения при пересоздании контейнера `api` (например, `CACHE_MODE=naive CACHE_MISS_DELAY_MS=75 docker compose --env-file .env up -d api`); задержка влияет только на naive-путь. +- Порты PostgreSQL/Redis наружу не публикуются, поэтому интеграционный набор запускается с адресами контейнеров (команда в [REPORT.md](../REPORT.md) § «Команды проверок»). +- Сырые прогоны бенчмарка не коммитятся (локальные идентификаторы); их хеши — в [`evidence/track1-cache-consistency.md`](../evidence/track1-cache-consistency.md) §8. diff --git a/.gitignore b/.gitignore index b5a71896..942a785c 100644 --- a/.gitignore +++ b/.gitignore @@ -30,3 +30,6 @@ coverage/ .vscode/ # Keep small, sanitized evidence summaries in evidence/ under version control. # Inspect git diff --cached: ignore rules are not a secret scanner. +secrets/ +.env +evidence/track1-raw/ diff --git a/Dockerfile b/Dockerfile index c5fc7f9d..ae3280e5 100644 --- a/Dockerfile +++ b/Dockerfile @@ -2,11 +2,15 @@ FROM node:25.7.0-slim AS build WORKDIR /usr/src/app +RUN apt-get update \ + && apt-get install -y --no-install-recommends python3 make g++ \ + && rm -rf /var/lib/apt/lists/* + COPY app/package.json app/package-lock.json ./ RUN npm ci COPY app/ ./ -RUN npm run build +RUN npm run build && npm prune --omit=dev FROM node:25.7.0-slim AS runtime @@ -16,7 +20,7 @@ ENV NODE_ENV=production ENV APP_PORT=8080 ENV DRAIN_DELAY_MS=5000 COPY --from=build /usr/src/app/package.json /usr/src/app/package-lock.json ./ -RUN npm ci --omit=dev && npm cache clean --force +COPY --from=build /usr/src/app/node_modules ./node_modules COPY --from=build /usr/src/app/dist ./dist USER node diff --git a/REPORT.md b/REPORT.md index e42f2b05..e4be4393 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,228 @@ # Отчёт — лабораторная 2 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Автор, группа: Тюнин Илья БВТ2303 +- Целевая оценка: 5, трек 1 («Согласованность кэша») +- Commit/PR: [вставьте после публикации] -## Запуск из чистого clone +## Карта документации -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +| Документ | Что содержит | +| -------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | +| Этот отчёт | Архитектура, схема данных, транзакции, аутентификация, политика кэша, методика и результаты трека 1, наблюдаемые проверки, ограничения. | +| [`evidence/README.md`](evidence/README.md) | Индекс доказательств: что какой файл подтверждает и как всё регенерировать. | +| [`evidence/level3-4-verification.md`](evidence/level3-4-verification.md) | Журнал проверок уровня 3/4 с наблюдаемым выводом команд и таблицей найденных дефектов. | +| [`evidence/track1-cache-consistency.md`](evidence/track1-cache-consistency.md) | Трек 1: окружение, методика, числа по повторностям, сравнение, read-after-write, рестарт Redis, хеши артефактов. | +| [`evidence/track1-explain.md`](evidence/track1-explain.md) | Тексты анализируемых SQL-запросов и `EXPLAIN (ANALYZE, BUFFERS)`. | +| [`.github/pull_request_template.md`](.github/pull_request_template.md) | Краткая сводка работы, команды запуска, результаты проверок, чек-лист сдачи. | +| [`tests/README.md`](tests/README.md) | Публичные проверки репозитория (`make check`, `make test`, persistence, load, TLS). | +| [`docs/architecture/`](docs/architecture/README.md) | Граф модулей и провайдеров NestJS (`npm run graph`). | +| [`bruno/README.md`](bruno/README.md) | Коллекция Bruno: ручные запросы на все эндпоинты, негативные кейсы и автосохранение токенов/ID между запросами. | +| [`scripts/track1_cache_benchmark.py`](scripts/track1_cache_benchmark.py), [`scripts/track1_verify.py`](scripts/track1_verify.py) | Инструменты измерения трека 1 и проверки рестарта Redis. | +| [`scripts/restart.sh`](scripts/restart.sh) | Хук перезапуска для `make test-persistence`. | -## Архитектура и решения +## Архитектура и роли компонентов -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab1, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +```text +Client + -> Fastify/Nest API + AuthController (Basic -> opaque Bearer session) + CurrentUserGuard (Bearer -> Redis session -> PostgreSQL user) + UsersController / ChatsController / MessagesController + -> UsersRepository -> pg.Pool -> PostgreSQL + -> ChatsRepository -> pg.Pool -> PostgreSQL (transaction) + -> MessagesRepository-> pg.Pool -> PostgreSQL (transaction) + -> MessagesCacheService -> Redis versioned message page + -> SessionRepository -> Redis session:{token} (AOF) + -> MetricsService -> token-gated /internal/metrics +``` -## Доказательства критериев +Источник истины: -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | -| --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +- PostgreSQL — пользователи, чаты, membership, сообщения. +- Redis — действующие безопасные сессии (AOF persistence) и производный кэш истории. +- Удаление Redis cache не теряет подтверждённые данные: они восстанавливаются из PostgreSQL. +- Отказ Redis не даёт анонимного доступа: сессионный путь возвращает ограниченную 503. +- Отказ PostgreSQL не убивает процесс API и даёт ограниченную 503. -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +### Схема данных и миграции -## Эксперименты и отказы +`001_initial.sql`: -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +- `users(id uuid pk, username unique, display_name, password_hash, created_at)`; +- `chats(id uuid pk, title, created_at, message_version bigint)`; +- `chat_members(chat_id, user_id)` — composite PK, cascade FK; +- `messages(id, chat_id, sender_id, text, created_at)`, FK на chat и на member; +- `messages_chat_created_id_idx (chat_id, created_at, id)`; +- `chat_members_user_chat_idx (user_id, chat_id)`. -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +`002_timestamp_precision.sql` приводит `created_at` к `timestamptz(3)`, чтобы значения совпадали с millisecond timestamps JavaScript. Без этого следующая страница keyset-пагинации повторяла последнее сообщение предыдущей. -## Ограничения и следующие шаги +Migration runner сам находит `NNN_*.sql`, сортирует по имени и применяет каждую незаписанную миграцию в отдельной транзакции через `schema_migrations`. Повторный запуск — no-op; сиды не выполняются. -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +### Транзакционные границы + +Создание чата: валидация `member_ids` через `ANY($1::uuid[])`, вставка `chats`, вставка всех `chat_members`, commit либо полный rollback. Создание сообщения: проверка membership, вставка `messages`, инкремент `chats.message_version`, commit либо rollback. + +## Аутентификация и доступ + +- `POST /api/v1/users` — регистрация с паролем 12–128 code points; Argon2id. +- `POST /api/v1/auth/sessions` — только Basic, UTF-8, разделение по первому `:`; тело не принимается. +- Токен — 32 случайных байта (Base64URL), серверная сессия в Redis с TTL. +- Бизнес-endpoint — только Bearer; истёкший/отозванный/неизвестный токен → 401 + `WWW-Authenticate: Bearer realm="messenger"`. +- `X-User-Id` не аутентифицирует и не подменяет владельца сессии. +- `DELETE /api/v1/auth/sessions/current` → 204 без тела; повтор с тем же токеном → 401. +- Ответы 401 содержат корректный challenge: Basic для создания сессии, Bearer для остальных. + +## Политика кэша и трек 1 + +Ключ страницы: `messages:{chat_id}:v{message_version}:c{cursor|start}:l{limit}`. + +Protected режим: exact-page lock `lock:{cache_key}` (`SET NX PX` + compare-owner Lua unlock), ограниченные повторы, повторная проверка кэша, запись результата владельцем, best-effort запись кэша и fallback в PostgreSQL при недоступности Redis. Любой commit сообщения увеличивает `message_version`, поэтому старые страницы становятся недостижимыми. + +Naive режим — управляемый baseline без распределённой блокировки; `CACHE_MISS_DELAY_MS` расширяет окно гонки. + +Гипотеза: при одном холодном ключе и `N` конкурентных читателях naive порождает около `N` SQL-запросов истории, protected — один запрос владельца, остальные ждут и попадают в кэш. + +## Воспроизводимый запуск + +```sh +cp .env.example .env +password=$(openssl rand -hex 32) +sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$password/" .env +sed -i "s|^DATABASE_URL=.*|DATABASE_URL=postgresql://messenger:$password@postgres:5432/messenger|" .env +sed -i "s/^METRICS_TOKEN=.*/METRICS_TOKEN=$(openssl rand -hex 16)/" .env +unset password + +docker compose --env-file .env config --quiet +docker compose --env-file .env up -d --build +curl -fsS http://localhost:8080/health/ready +``` + +- `postgres:16.4-alpine` c named volume `postgres-data`; +- `redis:7.4.2-alpine`, AOF (`appendonly yes`, `appendfsync everysec`), named volume `redis-data`; +- одноразовый сервис `migrate`; +- `api` с healthcheck `/health/ready`. + +### Конфигурация и секреты + +Все параметры, включая `POSTGRES_PASSWORD`, `DATABASE_URL` и `REDIS_URL`, задаются в `.env` +(вне Git). Это сознательный выбор для локального синтетического стенда: + +- `.env` уже игнорируется `.gitignore`; отдельных файлов секретов и лишнего маппинга не требуется; +- значения видны через `docker inspect`/`/proc//environ` — для учебного стенда с + синтетическими данными это допустимо, для production нужен внешний secret store; +- `postgres-data` хранит пароль, заданный при первой инициализации: смена `POSTGRES_PASSWORD` + сама по себе его не меняет, поэтому `DATABASE_URL` должен указывать на пароль этого volume; +- файловый вариант (`DATABASE_URL_FILE`, `REDIS_URL_FILE`, docker secrets/Swarm) поддержан в + конфигурации как опциональная альтернатива и описан в `.env.example`. + +`scripts/restart.sh` перезапускает `postgres redis api` и ждёт готовности, не удаляя volumes и не выполняя `FLUSHALL`. + +## Track 1: методика и результаты + +Методика: режим кэша и задержка промаха задаются переменными окружения при пересоздании контейнера (`CACHE_MODE`, `CACHE_MISS_DELAY_MS`; shell-значение перекрывает `.env`). Каждая повторность использует новый чат (холодный ключ), поэтому `FLUSHALL` не нужен. Барьер синхронизирует старт конкурентных GET, метрики сбрасываются через `POST /internal/metrics/reset`. + +Важно: `CACHE_MISS_DELAY_MS` действует только в naive-пути (пауза между промахом и запросом в PostgreSQL) и намеренно расширяет окно гонки. Protected-путь задержку не использует, поэтому замеренная разница p50/p95 между режимами включает эти 75 мс и не является «честным» сравнением скорости; независимая от задержки метрика — число SQL-запросов истории. + +Команды: + +```sh +printf '%s' "$METRICS_TOKEN" > /tmp/track1-metrics-token +CACHE_MODE=naive CACHE_MISS_DELAY_MS=75 docker compose --env-file .env up -d api +python3 scripts/track1_cache_benchmark.py --base-url http://localhost:8080 --mode naive \ + --concurrency 32 --repetitions 5 --metrics-token-file /tmp/track1-metrics-token \ + --runtime-version node=25.7.0 --runtime-version postgres=16.4 --runtime-version redis=7.4.2 \ + --output evidence/track1-raw/naive.json +CACHE_MODE=protected docker compose --env-file .env up -d api +python3 scripts/track1_cache_benchmark.py --base-url http://localhost:8080 --mode protected \ + --concurrency 32 --repetitions 5 --metrics-token-file /tmp/track1-metrics-token \ + --runtime-version node=25.7.0 --runtime-version postgres=16.4 --runtime-version redis=7.4.2 \ + --output evidence/track1-raw/protected.json +python3 scripts/track1_verify.py --summary \ + --naive-raw evidence/track1-raw/naive.json --protected-raw evidence/track1-raw/protected.json \ + --output evidence/track1-cache-consistency.md +``` + +Наблюдено (concurrency 32, 5 повторностей, 160 успешных GET в каждом режиме, ошибок 0): + +| Режим | `messages.history` SQL | Cache misses | Cache hits | Lock waits | +| --------- | ---------------------: | -----------: | ---------: | ---------: | +| naive | 160 | 160 | 0 | 0 | +| protected | 5 | 46 | 155 | 41 | + +Снижение числа SQL-запросов истории: **160 → 5 (96.9 %)**. Латентность успешных запросов: naive p50 ≈ 82–117 ms, protected p50 ≈ 28–44 ms (сырые значения в `evidence/track1-raw/`). Эта разница не является чистым сравнением скорости: в naive-путь искусственно добавлена пауза `CACHE_MISS_DELAY_MS=75` (задержка применяется только в naive), тогда как protected её не использует. Независимая от задержки метрика — число SQL-запросов истории. + +Read-after-write (protected, вторая действующая сессия): `asserted=true`, `stale_observed=false`. + +Рестарт Redis с сохранением AOF-volume и последующим удалением только `messages:*`: + +```json +{ + "restart_redis": true, + "same_token_users_me": true, + "history_equal": true, + "cache_eviction": { "requested": true, "message_keys_deleted": 9 } +} +``` + +## Уровень 3/4: наблюдаемые проверки + +| Проверка | Команда/сценарий | Наблюдаемый результат | +| ---------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | +| Публичный smoke | `make test` | `PASS: lab2 public API scenario` | +| Сохранность через полный рестарт | `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | `PASS: persistence preserved confirmed data and existing session` | +| Интеграционный набор (реальные PG/Redis) | `npx vitest run --config vitest.config.e2e.ts` | 7 passed, 1 gated | +| То же с `SESSION_TTL_SECONDS=2` | тот же набор с TTL=2 | 8 passed (включая expiry → 401) | +| Гонка одинакового username | набор: два одновременных POST + `select count(*)` | 201 и 409; в `users` ровно 1 строка (гарантия — unique index `users_username_key`, ошибка `23505` → 409) | +| Rollback чата с неизвестным участником | HTTP 400 + `select count(*)` | 400; строк в `chats` — 0 | +| Индекс истории | `EXPLAIN (ANALYZE, BUFFERS)` на 10 002 строках | `Index Scan using messages_chat_created_id_idx` для первой страницы (0.040 мс) и для keyset-продолжения (0.048 мс) | +| Отказ Redis | stop redis | `/health/ready` 503, `/users/me` 503 (анонимного доступа нет), после старта — 200 | +| Отказ PostgreSQL | stop postgres | `/health/ready` 503, `/users/me` 503; процесс API жив; после старта — 200 с тем же токеном | +| Логин/логаут/подмена | набор + `X-User-Id` | Basic на бизнес-endpoint 401, `X-User-Id` не меняет владельца, replay после logout 401 | +| Ручной клиент (Bruno) | `bru run -r --env local ...` из `bruno/` | 28 запросов, 56 проверок — все зелёные (включая негативные и метрики) | + +Отдельно исправлен реальный дефект: при падении PostgreSQL процесс API завершался из-за необработанного события `error` у idle-клиента пула. Добавлен обработчик `pool.on('error')`, а ошибки доступности БД в фильтре отображаются в ограниченную 503 вместо 500. + +Полный журнал проверок с наблюдаемым выводом команд — [`evidence/level3-4-verification.md`](evidence/level3-4-verification.md); методика и по-повторностные числа трека — [`evidence/track1-cache-consistency.md`](evidence/track1-cache-consistency.md). + +`EXPLAIN` (фрагмент): `Index Scan using messages_chat_created_id_idx on messages`, первая страница `actual time=0.020..0.028 ms` / `Execution Time: 0.040 ms`, keyset-продолжение `Index Cond: ((chat_id = ...) AND (ROW(created_at, id) > ROW(...)))` / `Execution Time: 0.048 ms` — полного скана истории нет, предикат продолжения уходит в индекс. Тексты проанализированных запросов и подготовка данных — [`evidence/track1-explain.md`](evidence/track1-explain.md). + +## Команды проверок + +```sh +make check +make validate +(cd app && npm run build && npm test && npx tsc --noEmit) +make test BASE_URL=http://localhost:8080 +make test-persistence ACTION_SCRIPT=scripts/restart.sh +(cd app && API_BASE_URL=http://localhost:8080 \ + DATABASE_URL=postgresql://messenger:@:5432/messenger \ + REDIS_URL=redis://:6379 npx vitest run --config ./vitest.config.e2e.ts) +``` + +Примечание: набор для интеграционных тестов читает `API_BASE_URL`, потому что Vitest сам устанавливает `process.env.BASE_URL`. + +## Наблюдаемость отказов + +`GET /internal/metrics` и `POST /internal/metrics/reset` открыты только с `Authorization: Bearer ` и возвращают `{counters, latency_ms}` без секретов и SQL-текста. Счётчики, по которым видно деградацию (а не «тихое» проглатывание ошибок): + +| Счётчик | Когда растёт | +| ------------------------------------------------- | --------------------------------------------------------------------------------- | +| `cache_hit` / `cache_miss` | попадание/промах страницы | +| `cache_lock_wait` / `cache_lock_timeout` | ожидание владельца lock; владелец не успел за отведённые повторы | +| `cache_fallback` | Redis недоступен на чтении/lock/повторном чтении, ответ отдан из PostgreSQL | +| `cache_write_error` / `cache_unlock_error` | не удалось записать страницу или снять lock (ответ не ломается) | +| `cache_corrupt_entry` | повреждённая запись кэша трактуется как промах и перезаписывается | +| `database.pool_error` / `database.rollback_error` | обрыв idle-клиента пула; ошибка `ROLLBACK` (исходная ошибка операции сохраняется) | +| `redis.error` | ошибка соединения/reconnect Redis | + +Те же события дополнительно пишутся в лог уровнем `warn` с контекстом, поэтому один сбойный запрос уже видно без разбора дампов. + +## Ограничения и границы + +- Метрики локальны процессу API и сбрасываются при его рестарте; PostgreSQL и Redis не затрагиваются. +- Измерения выполнены на одном локальном хосте (closed-loop, конкуренция 32, 5 повторностей); это не production-пропускная способность и не распределённая телеметрия. +- `redis-data` — источник истины сессий: удаление volume осознанно разлогинивает пользователей; сохранённый AOF — проверенная граница durability. +- `CACHE_MODE=naive` предназначен только для эксперимента и не должен включаться в штатном профиле. +- Файлы `evidence/track1-raw/*.json` игнорируются git (содержат локальные идентификаторы); в репозитории хранится санитизированная сводка. +- Публичные `contracts/` и `tests/` не изменялись. diff --git a/app/README.md b/app/README.md index 07fc6fa4..d73b4dfc 100644 --- a/app/README.md +++ b/app/README.md @@ -1,114 +1,172 @@ -

- Nest Logo -

+# app — API мессенджера (лабораторная 2) -[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456 -[circleci-url]: https://circleci.com/gh/nestjs/nest +NestJS 12 + Fastify, ESM TypeScript. PostgreSQL — источник истины бизнес-данных, +Redis — серверные Bearer-сессии и производный кэш истории сообщений. -

A progressive Node.js framework for building efficient and scalable server-side applications.

-

-NPM Version -Package License -NPM Downloads -CircleCI -Discord -Backers on Open Collective -Sponsors on Open Collective - Donate us - Support us - Follow us on Twitter -

- +Общая документация (в корне репозитория): -## Description +| Документ | Что содержит | +|---|---| +| [`../REPORT.md`](../REPORT.md) | архитектура, схема данных, транзакции, политика кэша, команды, результаты проверок и трека 1 | +| [`../evidence/README.md`](../evidence/README.md) | индекс доказательств: что подтверждено и как это воспроизвести | +| [`../bruno/README.md`](../bruno/README.md) | коллекция ручных запросов ко всем эндпоинтам | +| [`../contracts/openapi.json`](../contracts/openapi.json) | нормативный контракт API | +| [`../tests/README.md`](../tests/README.md) | публичные проверки репозитория (`make check`, `make test`, persistence) | +| [`../docs/architecture/README.md`](../docs/architecture/README.md) | граф модулей NestJS (`npm run graph`) | -[Nest](https://github.com/nestjs/nest) framework TypeScript starter repository. +## Что внутри -## Project setup - -```bash -$ npm install +```text +src/ + main.ts bootstrap: Fastify, ValidationPipe, shutdown hooks + app.module.ts сборка модулей приложения + config/ Zod-схема env + глобальный ConfigModule + database/ pg.Pool, транзакции, миграции (001, 002) + redis/ клиент Redis (AOF-совместимый, без offline queue) + auth/ Basic-вход, Redis-сессии, logout + users/ регистрация (Argon2id), профиль + chats/ создание чата в транзакции, список и чтение + messages/ отправка сообщения, keyset-история + cache/ версионированный кэш истории + lock на страницу + metrics/ /internal/metrics и /internal/metrics/reset + health/ liveness/readiness с проверкой зависимостей + common/ guard, exception filter, request-id, cursor, errors +test/ + app.e2e-spec.ts black-box набор против запущенного API (PG + Redis) +scripts/ + graph-modules.ts генератор графа зависимостей (nestjs-spelunker) ``` -## Compile and run the project +Принципы: raw `pg.Pool` без ORM, параметризованные запросы, никаких in-memory +хранилищ в боевых путях; кэш — производное состояние и всегда допускает +восстановление из PostgreSQL; отказ зависимости даёт ограниченную ошибку +(`503`), а не аварийное завершение процесса. -```bash -# development -$ npm run start +## Быстрый старт -# watch mode -$ npm run start:dev +Рекомендуемый путь — весь стенд из корня репозитория (PostgreSQL, Redis, миграции, API): -# production mode -$ npm run start:prod +```sh +cd .. +cp .env.example .env +password=$(openssl rand -hex 32) +sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$password/" .env +sed -i "s|^DATABASE_URL=.*|DATABASE_URL=postgresql://messenger:$password@postgres:5432/messenger|" .env +docker compose --env-file .env up -d --build +curl -fsS http://localhost:8080/health/ready ``` -## Run tests +Локальный запуск без Docker (нужны доступные PostgreSQL и Redis): -```bash -# unit tests -$ npm run test +```sh +cd app +npm ci +npm run build -# e2e tests -$ npm run test:e2e +export DATABASE_URL=postgresql://messenger:@127.0.0.1:5432/messenger +export REDIS_URL=redis://127.0.0.1:6379 +export APP_PORT=8080 +node dist/database/migration.runner.js # применяет миграции из dist/database/migrations -# test coverage -$ npm run test:cov +npm run start:dev # или npm run start:prod после build ``` -## Deployment +## Переменные окружения -When you're ready to deploy your NestJS application to production, there are some key steps you can take to ensure it runs as efficiently as possible. Check out the [deployment documentation](https://docs.nestjs.com/deployment) for more information. +Читаются только через конфигурационный слой (`src/config`), типы и диапазоны +проверяет Zod-схема на старте — при некорректном значении приложение падает +с понятной ошибкой. -If you are looking for a cloud-based platform to deploy your NestJS application, check out [Mau](https://mau.nestjs.com), our official platform for deploying NestJS applications on AWS. Mau makes deployment straightforward and fast, requiring just a few simple steps: +| Переменная | По умолчанию | Назначение | +|---|---|---| +| `APP_HOST` / `APP_PORT` | `0.0.0.0` / `8080` | адрес прослушивания | +| `APP_ENV` | `lab` | метка окружения | +| `DATABASE_URL` | — (обязательна) | строка подключения PostgreSQL | +| `REDIS_URL` | — (обязательна) | строка подключения Redis | +| `DATABASE_POOL_MAX` | `10` | размер пула соединений | +| `DATABASE_CONNECTION_TIMEOUT_MS` | `5000` | таймаут установки соединения | +| `DATABASE_STATEMENT_TIMEOUT_MS` | `5000` | таймаут SQL-запроса | +| `SESSION_TTL_SECONDS` | `3600` | TTL сессии (минимум 2) | +| `CACHE_TTL_SECONDS` | `30` | TTL страницы истории в Redis | +| `CACHE_MODE` | `protected` | `protected` (lock на страницу) или `naive` (только для эксперимента) | +| `CACHE_LOCK_TTL_MS` | `1000` | TTL lock-а страницы | +| `CACHE_MISS_DELAY_MS` | `0` | искусственная пауза на промахе; влияет только на `naive` | +| `METRICS_TOKEN` | — (необязательна) | токен доступа к `/internal/metrics*`; без него endpoint закрыт | +| `DRAIN_DELAY_MS` | `5000` | окно дрейна при получении сигнала завершения | -```bash -$ npm install -g @nestjs/mau -$ mau deploy +Поддерживаются также `DATABASE_URL_FILE` / `REDIS_URL_FILE`: если заданы, значение +читается из файла (docker secrets / Swarm). Подробности и компромиссы — +[`../REPORT.md`](../REPORT.md), раздел «Конфигурация и секреты». + +## Эндпоинты + +Публичный контракт — [`../contracts/openapi.json`](../contracts/openapi.json). + +| Метод и путь | Аутентификация | Назначение | +|---|---|---| +| `GET /health/live` | нет | процесс жив | +| `GET /health/ready` | нет | готовность: PostgreSQL и Redis доступны, иначе `503` | +| `POST /api/v1/users` | нет | регистрация с паролем (Argon2id) | +| `POST /api/v1/auth/sessions` | `Basic` | вход, выдаёт opaque Bearer-токен | +| `DELETE /api/v1/auth/sessions/current` | `Bearer` | отзыв текущей сессии, `204` | +| `GET /api/v1/users/me` | `Bearer` | текущий пользователь | +| `POST /api/v1/chats` | `Bearer` | создание чата (транзакция) | +| `GET /api/v1/chats` | `Bearer` | список доступных чатов | +| `GET /api/v1/chats/:chatId` | `Bearer` | чат по id (чужой — `404`) | +| `POST /api/v1/chats/:chatId/messages` | `Bearer` | отправка сообщения | +| `GET /api/v1/chats/:chatId/messages` | `Bearer` | история, keyset-пагинация `(created_at, id)` | +| `GET /internal/metrics` | `Bearer METRICS_TOKEN` | счётчики и агрегаты латентности | +| `POST /internal/metrics/reset` | `Bearer METRICS_TOKEN` | сброс счётчиков (`200`) | + +Правила: `Basic` принимается только на создании сессии, бизнес-запросы — только +`Bearer`; заголовок `X-User-Id` не аутентифицирует и не подменяет владельца +сессии; истёкший, отозванный или неизвестный токен — `401` с соответствующим +`WWW-Authenticate`. + +## npm-скрипты + +| Команда | Что делает | +|---|---| +| `npm run build` | сборка в `dist/` | +| `npm run start:dev` | watch-режим | +| `npm run start:prod` | запуск собранного приложения (`node dist/main`) | +| `npm test` / `npm run test:unit` | unit-тесты (vitest) | +| `npm run test:e2e` | black-box набор против запущенного API (см. ниже) | +| `npm run lint` | oxlint по `src/` и `test/` | +| `npm run format` | prettier | +| `npm run graph` | граф модулей и провайдеров через nestjs-spelunker (пишет `../docs/architecture/`) | + +## Тесты + +Unit-тесты не требуют инфраструктуры: + +```sh +npm test ``` -With Mau, you can deploy your application in just a few clicks, allowing you to focus on building features rather than managing infrastructure. +Интеграционный набор работает по HTTP против запущенного стенда и дополнительно +подключается к PostgreSQL (очистка тестовых данных) и Redis: -## Observability +```sh +export API_BASE_URL=http://localhost:8080 +export DATABASE_URL=postgresql://messenger:@:5432/messenger +export REDIS_URL=redis://:6379 +npm run test:e2e +``` -In production applications, observability is essential for understanding how your system behaves, detecting issues early, and maintaining reliable performance. +Название `API_BASE_URL` (а не `BASE_URL`) выбрано потому, что Vitest сам +устанавливает `process.env.BASE_URL` в значение Vite base. Кейс истечения сессии +включается переменной `SESSION_TTL_SECONDS=2` и у запущенного API, и у набора. -[NestJS Observe](https://observe.nestjs.com) automatically instruments your NestJS application, giving you deep visibility into your system with minimal setup: +## Метрики -- **Distributed tracing:** Follow requests across services and understand how they flow through your system. -- **Waterfall analysis:** Visualize request execution and identify slow operations, bottlenecks, and unexpected delays. -- **Performance analysis:** Analyze application performance in real time and quickly pinpoint areas that need optimization. -- **Metrics:** Track key application and infrastructure metrics to understand system health and performance trends. -- **Logging:** Centralize and correlate logs with traces and other telemetry to make debugging easier. -- **Error tracking:** Detect errors quickly and investigate their root causes with the surrounding context. -- **SLA monitoring:** Track service-level objectives and identify when your application is approaching or exceeding defined thresholds. -- **Alarms and alerts:** Set up alerts for critical errors, performance degradation, SLA violations, and other anomalies so your team can react quickly. +`GET /internal/metrics` возвращает `{counters, latency_ms}`: именованные SQL-метки, +операции Redis, `cache_hit`/`cache_miss`/`cache_lock_wait`, `session_get/set/del`, +`request_count` и процентили латентности (буфер ограничен). Деградации +наблюдаемы отдельными счётчиками: `cache_fallback`, `cache_write_error`, +`cache_unlock_error`, `cache_lock_timeout`, `cache_corrupt_entry`, +`database.pool_error`, `database.rollback_error`, `redis.error`. -## Resources - -Check out a few resources that may come in handy when working with NestJS: - -- Visit the [NestJS Documentation](https://docs.nestjs.com) to learn more about the framework. -- For questions and support, please visit our [Discord channel](https://discord.gg/G7Qnnhy). -- To dive deeper and get more hands-on experience, check out our official video [courses](https://courses.nestjs.com/). -- Deploy your application to AWS with the help of [NestJS Mau](https://mau.nestjs.com) in just a few clicks. -- Auto-instrument your application with [NestJS Observer](https://observer.nestjs.com). Distributed tracing, metrics, and logging made easy. Error tracking and performance monitoring for your NestJS applications. -- Visualize your application graph and interact with the NestJS application in real-time using [NestJS Devtools](https://devtools.nestjs.com). -- Need help with your project (part-time to full-time)? Check out our official [enterprise support](https://enterprise.nestjs.com). -- To stay in the loop and get updates, follow us on [X](https://x.com/nestframework) and [LinkedIn](https://linkedin.com/company/nestjs). -- Looking for a job, or have a job to offer? Check out our official [Jobs board](https://jobs.nestjs.com). - -## Support - -Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support). - -## Stay in touch - -- Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec) -- Website - [https://nestjs.com](https://nestjs.com/) -- Twitter - [@nestframework](https://twitter.com/nestframework) - -## License - -Nest is [MIT licensed](https://github.com/nestjs/nest/blob/master/LICENSE). +Счётчики локальны процессу: при нескольких репликах их нельзя суммировать как +распределённый снимок, а рестарт API обнуляет их (данные PostgreSQL и Redis при +этом не затрагиваются). diff --git a/app/nest-cli.json b/app/nest-cli.json index f9aa683b..5a21707a 100644 --- a/app/nest-cli.json +++ b/app/nest-cli.json @@ -3,6 +3,13 @@ "collection": "@nestjs/schematics", "sourceRoot": "src", "compilerOptions": { - "deleteOutDir": true + "deleteOutDir": true, + "assets": [ + { + "include": "database/migrations/*.sql", + "outDir": "dist" + } + ], + "watchAssets": true } } diff --git a/app/package-lock.json b/app/package-lock.json index 6dc850fa..0ef2c3ab 100644 --- a/app/package-lock.json +++ b/app/package-lock.json @@ -14,11 +14,15 @@ "@nestjs/core": "^12.0.1", "@nestjs/platform-express": "^12.0.1", "@nestjs/platform-fastify": "^12.0.3", + "argon2": "^0.45.1", "class-transformer": "^0.5.1", "class-validator": "^0.15.1", "fastify": "^5.12.5", + "pg": "^8.23.1", + "redis": "^6.3.0", "reflect-metadata": "^0.2.2", - "rxjs": "^7.8.1" + "rxjs": "^7.8.1", + "zod": "^4.6.5" }, "devDependencies": { "@nestjs/cli": "^12.0.0", @@ -27,12 +31,16 @@ "@nestjs/testing": "^12.0.1", "@types/express": "^5.0.0", "@types/node": "^24.0.0", + "@types/pg": "^8.23.1", "@types/supertest": "^7.0.0", "@vitest/coverage-v8": "^4.1.2", + "dotenv": "^18.0.5", + "nestjs-spelunker": "^1.3.2", "oxlint": "^1.58.0", "prettier": "^3.4.2", "source-map-support": "^0.5.21", "supertest": "^7.2.2", + "tsx": "^4.23.15", "typescript": "^6.0.3", "vite-tsconfig-paths": "^5.1.4", "vitest": "^4.1.2" @@ -216,6 +224,454 @@ "node": ">=0.1.90" } }, + "node_modules/@epic-web/invariant": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/@epic-web/invariant/-/invariant-1.0.0.tgz", + "integrity": "sha512-lrTPqgvfFQtR/eY/qkIzp98OGdNJu0m5ji3q/nJI8v3SXkRKEnWiOxMmbvcSoAIzv/cGiuvRy57k4suKQSAdwA==", + "license": "MIT" + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz", + "integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz", + "integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz", + "integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz", + "integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz", + "integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz", + "integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz", + "integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz", + "integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz", + "integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz", + "integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz", + "integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz", + "integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz", + "integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz", + "integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz", + "integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz", + "integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz", + "integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz", + "integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz", + "integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz", + "integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz", + "integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz", + "integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz", + "integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz", + "integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz", + "integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz", + "integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, "node_modules/@fastify/ajv-compiler": { "version": "4.0.6", "resolved": "https://registry.npmjs.org/@fastify/ajv-compiler/-/ajv-compiler-4.0.6.tgz", @@ -909,6 +1365,18 @@ "rxjs": "^7.1.0" } }, + "node_modules/@nestjs/config/node_modules/dotenv": { + "version": "17.4.2", + "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.4.2.tgz", + "integrity": "sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://dotenvx.com" + } + }, "node_modules/@nestjs/core": { "version": "12.0.3", "resolved": "https://registry.npmjs.org/@nestjs/core/-/core-12.0.3.tgz", @@ -1276,6 +1744,21 @@ "url": "https://paulmillr.com/funding/" } }, + "node_modules/@ogma/common": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/@ogma/common/-/common-1.2.0.tgz", + "integrity": "sha512-y2GHkT4t3B9CoI7ELfgZXeMHiiOC/X4XvdeqYLbP5A3keop7fANzjd5pQdtyYQvdQ0lPzcHJiMvOGkIINZHZHQ==", + "dev": true + }, + "node_modules/@ogma/styler": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@ogma/styler/-/styler-1.1.0.tgz", + "integrity": "sha512-OtwJ8Ump3sKEAv2DIUi+R2G2Y5v3cEzqRO/sH11MTWikAhac31GZR/xzU+3BoPRT0u8oIob7N5dtOKTdPhqq3w==", + "dev": true, + "dependencies": { + "@ogma/common": "^1.1.1" + } + }, "node_modules/@oxc-project/types": { "version": "0.150.0", "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.150.0.tgz", @@ -1619,12 +2102,90 @@ "@noble/hashes": "^1.1.5" } }, + "node_modules/@phc/format": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/@phc/format/-/format-1.0.0.tgz", + "integrity": "sha512-m7X9U6BG2+J+R1lSOdCiITLLrxm+cWlNI3HUFA92oLO77ObGNzaKdh8pMLqdZcshtkKuV84olNNXDfMc4FezBQ==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, "node_modules/@pinojs/redact": { "version": "0.4.0", "resolved": "https://registry.npmjs.org/@pinojs/redact/-/redact-0.4.0.tgz", "integrity": "sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg==", "license": "MIT" }, + "node_modules/@redis/bloom": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/@redis/bloom/-/bloom-6.3.0.tgz", + "integrity": "sha512-NQ5poYpZr0jv6zazN1cy6JY5kIipKFZ3R9GTL4kOUTX3a9YAfY29U8bsE4lWhVQEM+G4V0BXVC57mubIdDijeA==", + "license": "MIT", + "engines": { + "node": ">= 20.0.0" + }, + "peerDependencies": { + "@redis/client": "^6.3.0" + } + }, + "node_modules/@redis/client": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/@redis/client/-/client-6.3.0.tgz", + "integrity": "sha512-fHrjwGCBvAANGi+TuRuwKi83sIOzgHr8eh+Uf48w3fSX7Hhrz174NrWqfJhAC2vnN0d/tfaZpdr6+o6JC3QHwg==", + "license": "MIT", + "engines": { + "node": ">= 20.0.0" + }, + "peerDependencies": { + "@node-rs/xxhash": "^1.1.0", + "@opentelemetry/api": ">=1 <2" + }, + "peerDependenciesMeta": { + "@node-rs/xxhash": { + "optional": true + }, + "@opentelemetry/api": { + "optional": true + } + } + }, + "node_modules/@redis/json": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/@redis/json/-/json-6.3.0.tgz", + "integrity": "sha512-yt6vRfPBXtW/3qm53cF81TSQpLMjWdW4/2E9WQ2GgbvsKkuCKCFQIcMiKlil1ZMnezK+IQuS795xKU5psbaegw==", + "license": "MIT", + "engines": { + "node": ">= 20.0.0" + }, + "peerDependencies": { + "@redis/client": "^6.3.0" + } + }, + "node_modules/@redis/search": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/@redis/search/-/search-6.3.0.tgz", + "integrity": "sha512-RPXAZmKjZZG7Tm7m1w9keFdXzbL91PiSHQBfQRe9xwW40jNsTRbG0FwhIz4QlHPU4gKDAsCy8IQHj4yZl4H9rw==", + "license": "MIT", + "engines": { + "node": ">= 20.0.0" + }, + "peerDependencies": { + "@redis/client": "^6.3.0" + } + }, + "node_modules/@redis/time-series": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/@redis/time-series/-/time-series-6.3.0.tgz", + "integrity": "sha512-+fJOB8mN1z5WRakCJNh5lVdz1KqvHGSOistsKeitD24QsCtPwyRQXWC0iq6T/i/ubLE/YcguZqPm8F598MKk4A==", + "license": "MIT", + "engines": { + "node": ">= 20.0.0" + }, + "peerDependencies": { + "@redis/client": "^6.3.0" + } + }, "node_modules/@rolldown/binding-android-arm-eabi": { "version": "1.2.9", "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.9.tgz", @@ -2031,6 +2592,18 @@ "undici-types": "~7.18.0" } }, + "node_modules/@types/pg": { + "version": "8.23.1", + "resolved": "https://registry.npmjs.org/@types/pg/-/pg-8.23.1.tgz", + "integrity": "sha512-fKVHpikPdg4GKks3JuLEhvwSyvwzF23hnabPy6DD8ljVbC7+6J5dQzdv4arV6jqq57djnMgs1HKBxX4P8aBI3A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*", + "pg-protocol": "*", + "pg-types": "^2.2.0" + } + }, "node_modules/@types/qs": { "version": "6.15.1", "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.15.1.tgz", @@ -2370,6 +2943,22 @@ "integrity": "sha512-klpgFSWLW1ZEs8svjfb7g4qWY0YS5imI82dTg+QahUvJ8YqAY0P10Uk8tTyh9ZGuYEZEMaeJYCF5BFuX552hsw==", "license": "MIT" }, + "node_modules/argon2": { + "version": "0.45.1", + "resolved": "https://registry.npmjs.org/argon2/-/argon2-0.45.1.tgz", + "integrity": "sha512-skm+/WCjkGqCQxF7FG1LuZXM5yvbFjgbfiCGsud2oLgaDhh6b6dbH0b1EkghbM+xx4Bj8Ape+KKgixoIlWZicQ==", + "hasInstallScript": true, + "license": "MIT", + "dependencies": { + "@phc/format": "^1.0.0", + "cross-env": "^10.1.0", + "node-addon-api": "^8.9.0", + "node-gyp-build": "^4.8.4" + }, + "engines": { + "node": ">=16.17.0" + } + }, "node_modules/array-timsort": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/array-timsort/-/array-timsort-1.0.3.tgz", @@ -2906,6 +3495,37 @@ "url": "https://opencollective.com/express" } }, + "node_modules/cross-env": { + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/cross-env/-/cross-env-10.1.0.tgz", + "integrity": "sha512-GsYosgnACZTADcmEyJctkJIoqAhHjttw7RsFrVoJNXbsWWqaq6Ym+7kZjq6mS45O0jij6vtiReppKQEtqWy6Dw==", + "license": "MIT", + "dependencies": { + "@epic-web/invariant": "^1.0.0", + "cross-spawn": "^7.0.6" + }, + "bin": { + "cross-env": "dist/bin/cross-env.js", + "cross-env-shell": "dist/bin/cross-env-shell.js" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, "node_modules/debug": { "version": "4.4.3", "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", @@ -2986,10 +3606,14 @@ } }, "node_modules/dotenv": { - "version": "17.4.2", - "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.4.2.tgz", - "integrity": "sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==", + "version": "18.0.5", + "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-18.0.5.tgz", + "integrity": "sha512-aBrGvt6KhjxbEnatqMWOMidftwsrCiCvqh1yNIGB9QyF0J+VcWkKDMsvYOEm7ZS82oiV+BT1sTOtIlAmUlTpwQ==", + "dev": true, "license": "BSD-2-Clause", + "bin": { + "dotenv": "dist/index.cjs" + }, "engines": { "node": ">=12" }, @@ -3012,6 +3636,18 @@ "url": "https://dotenvx.com" } }, + "node_modules/dotenv-expand/node_modules/dotenv": { + "version": "17.4.2", + "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.4.2.tgz", + "integrity": "sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://dotenvx.com" + } + }, "node_modules/dunder-proto": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", @@ -3120,6 +3756,48 @@ "tests/browser-compat" ] }, + "node_modules/esbuild": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz", + "integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.28.2", + "@esbuild/android-arm": "0.28.2", + "@esbuild/android-arm64": "0.28.2", + "@esbuild/android-x64": "0.28.2", + "@esbuild/darwin-arm64": "0.28.2", + "@esbuild/darwin-x64": "0.28.2", + "@esbuild/freebsd-arm64": "0.28.2", + "@esbuild/freebsd-x64": "0.28.2", + "@esbuild/linux-arm": "0.28.2", + "@esbuild/linux-arm64": "0.28.2", + "@esbuild/linux-ia32": "0.28.2", + "@esbuild/linux-loong64": "0.28.2", + "@esbuild/linux-mips64el": "0.28.2", + "@esbuild/linux-ppc64": "0.28.2", + "@esbuild/linux-riscv64": "0.28.2", + "@esbuild/linux-s390x": "0.28.2", + "@esbuild/linux-x64": "0.28.2", + "@esbuild/netbsd-arm64": "0.28.2", + "@esbuild/netbsd-x64": "0.28.2", + "@esbuild/openbsd-arm64": "0.28.2", + "@esbuild/openbsd-x64": "0.28.2", + "@esbuild/openharmony-arm64": "0.28.2", + "@esbuild/sunos-x64": "0.28.2", + "@esbuild/win32-arm64": "0.28.2", + "@esbuild/win32-ia32": "0.28.2", + "@esbuild/win32-x64": "0.28.2" + } + }, "node_modules/escape-html": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", @@ -3972,6 +4650,12 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "license": "ISC" + }, "node_modules/istanbul-lib-coverage": { "version": "3.2.2", "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz", @@ -4726,6 +5410,29 @@ "url": "https://opencollective.com/express" } }, + "node_modules/nestjs-spelunker": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/nestjs-spelunker/-/nestjs-spelunker-1.3.2.tgz", + "integrity": "sha512-tVQZvPvlYNRW9PFkl2dj/hCEzUjC/NbJdayhnr/0dBuebFu4fqJNICPQF1BWJgK8GxJARe1kvDAw/GoyvINvOA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@ogma/styler": "^1.0.0" + }, + "peerDependencies": { + "@nestjs/common": ">6.11.0", + "@nestjs/core": ">6.11.0" + } + }, + "node_modules/node-addon-api": { + "version": "8.9.2", + "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-8.9.2.tgz", + "integrity": "sha512-VijLXbi3UACN69I0JVXJsX4tjACjNoQDgv2gTF6sx2wWEi8tkSg2eX8p5gSIFi8z2+DL3oHmY6OyKce38SDolg==", + "license": "MIT", + "engines": { + "node": "^18 || ^20 || >= 21" + } + }, "node_modules/node-emoji": { "version": "2.2.0", "resolved": "https://registry.npmjs.org/node-emoji/-/node-emoji-2.2.0.tgz", @@ -4742,6 +5449,17 @@ "node": ">=18" } }, + "node_modules/node-gyp-build": { + "version": "4.8.4", + "resolved": "https://registry.npmjs.org/node-gyp-build/-/node-gyp-build-4.8.4.tgz", + "integrity": "sha512-LA4ZjwlnUblHVgq0oBF3Jl/6h/Nvs5fzBLwdEF4nuxnFdsfajde4WfxtJr3CaiH+F6ewcIB/q4jQ4UzPyid+CQ==", + "license": "MIT", + "bin": { + "node-gyp-build": "bin.js", + "node-gyp-build-optional": "optional.js", + "node-gyp-build-test": "build-test.js" + } + }, "node_modules/object-assign": { "version": "4.1.1", "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", @@ -5022,6 +5740,15 @@ "node": ">= 0.8" } }, + "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==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, "node_modules/path-to-regexp": { "version": "8.4.2", "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.2.tgz", @@ -5039,6 +5766,95 @@ "dev": true, "license": "MIT" }, + "node_modules/pg": { + "version": "8.23.1", + "resolved": "https://registry.npmjs.org/pg/-/pg-8.23.1.tgz", + "integrity": "sha512-aL96AHANtWjPLDOLqnhx+ngp9+UK7ETEU8VJrDCGvsSSi/mGLcWYsS6Herg7lmaBJe4uwrfqsa7gTEFaSizDoQ==", + "license": "MIT", + "dependencies": { + "pg-connection-string": "^2.14.1", + "pg-pool": "^3.14.0", + "pg-protocol": "^1.16.1", + "pg-types": "2.2.0", + "pgpass": "1.0.5" + }, + "engines": { + "node": ">= 16.0.0" + }, + "optionalDependencies": { + "pg-cloudflare": "^1.4.1" + }, + "peerDependencies": { + "pg-native": ">=3.0.1" + }, + "peerDependenciesMeta": { + "pg-native": { + "optional": true + } + } + }, + "node_modules/pg-cloudflare": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.4.1.tgz", + "integrity": "sha512-6PQbsFWZcp9EmJEwy5cGQ2La+AMWpP46lgbb8X+U/XsHIUweYDNCpeuKck5RxL2MdVFi7krbbEi5nX4Zh7JhrQ==", + "license": "MIT", + "optional": true + }, + "node_modules/pg-connection-string": { + "version": "2.14.1", + "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.14.1.tgz", + "integrity": "sha512-qR3kGNPBLpCNtz0evbKA0Y/MRFXwSSdT+pTJvYp/bXTcReZbvX1kzF0IyTc1QnxqF7AZbOeBhNL8R5mYQZV/MA==", + "license": "MIT" + }, + "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==", + "license": "ISC", + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/pg-pool": { + "version": "3.14.0", + "resolved": "https://registry.npmjs.org/pg-pool/-/pg-pool-3.14.0.tgz", + "integrity": "sha512-gKtPkFdQPU3DksooVLi9LsjZxrsBUZIpa+7aVx+LV5pNh0KzP4Zleud2po+ConrxbuXGBJ6Hfer6hdgpIBpBaw==", + "license": "MIT", + "peerDependencies": { + "pg": ">=8.0" + } + }, + "node_modules/pg-protocol": { + "version": "1.16.1", + "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.16.1.tgz", + "integrity": "sha512-p9VOFMiHB/ZbJATetbg+99PxssTVSQRnyuPSQ67mN1+1KBOjZaZ83ZQzltnxPhJwSsC3nwVjJ10DVJlerbFzLg==", + "license": "MIT" + }, + "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==", + "license": "MIT", + "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/pgpass": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/pgpass/-/pgpass-1.0.5.tgz", + "integrity": "sha512-FdW9r/jQZhSeohs1Z3sI1yxFQNFvMcnmfuj4WBMUTxOrAyLMaTcE1aAMBiTlbMNaXvBCQuVi0R7hd8udDSP7ug==", + "license": "MIT", + "dependencies": { + "split2": "^4.1.0" + } + }, "node_modules/picocolors": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", @@ -5135,6 +5951,45 @@ "node": "^10 || ^12 || >=14" } }, + "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==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/postgres-bytea": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/postgres-bytea/-/postgres-bytea-1.0.1.tgz", + "integrity": "sha512-5+5HqXnsZPE65IJZSMkZtURARZelel2oXUEO8rH83VS/hxH5vv1uHquPg5wZs8yMAfdv971IU+kcPUczi7NVBQ==", + "license": "MIT", + "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==", + "license": "MIT", + "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==", + "license": "MIT", + "dependencies": { + "xtend": "^4.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/prettier": { "version": "3.9.8", "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.9.8.tgz", @@ -5272,6 +6127,22 @@ "node": ">= 12.13.0" } }, + "node_modules/redis": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/redis/-/redis-6.3.0.tgz", + "integrity": "sha512-XFQbPie1lGpKeUZ8ySYY43yLnQy/iIQtHNvIr/1XdaABpb96rUSdm3Mfl+98FEVbv9ZJIzINMno5s0Nh8E5LEw==", + "license": "MIT", + "dependencies": { + "@redis/bloom": "6.3.0", + "@redis/client": "6.3.0", + "@redis/json": "6.3.0", + "@redis/search": "6.3.0", + "@redis/time-series": "6.3.0" + }, + "engines": { + "node": ">= 20.0.0" + } + }, "node_modules/reflect-metadata": { "version": "0.2.2", "resolved": "https://registry.npmjs.org/reflect-metadata/-/reflect-metadata-0.2.2.tgz", @@ -5545,6 +6416,27 @@ "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", "license": "ISC" }, + "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==", + "license": "MIT", + "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==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, "node_modules/side-channel": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.1.tgz", @@ -6005,6 +6897,25 @@ "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", "license": "0BSD" }, + "node_modules/tsx": { + "version": "4.23.15", + "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.23.15.tgz", + "integrity": "sha512-Yiex1Ovn8z2xPpOWckIiysV1SSyRMY9BkLF++q0yKiDxCqRhosKfMg3janKkiLBwZ5c/YryloKwGZcrEmtwxKw==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "~0.28.0" + }, + "bin": { + "tsx": "dist/cli.mjs" + }, + "engines": { + "node": ">=18.0.0" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + } + }, "node_modules/type-fest": { "version": "0.21.3", "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.21.3.tgz", @@ -6391,6 +7302,21 @@ "defaults": "^1.0.3" } }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, "node_modules/why-is-node-running": { "version": "2.3.0", "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz", @@ -6429,6 +7355,15 @@ "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", "license": "ISC" }, + "node_modules/xtend": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz", + "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==", + "license": "MIT", + "engines": { + "node": ">=0.4" + } + }, "node_modules/yoctocolors": { "version": "2.2.0", "resolved": "https://registry.npmjs.org/yoctocolors/-/yoctocolors-2.2.0.tgz", @@ -6441,6 +7376,15 @@ "funding": { "url": "https://github.com/sponsors/sindresorhus" } + }, + "node_modules/zod": { + "version": "4.6.5", + "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.5.tgz", + "integrity": "sha512-v5l/aFXZQeai4awLbOpSoHecE9UiMrnfx75tEXLjNonXVARxQ5mOeipTjROUchszUNCqnE+hqAMujRsRHsut2Q==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/colinhacks" + } } } } diff --git a/app/package.json b/app/package.json index 756fa414..00de6a9f 100644 --- a/app/package.json +++ b/app/package.json @@ -20,6 +20,7 @@ "test:watch": "vitest", "test:cov": "vitest run --coverage", "test:debug": "vitest --inspect-brk --no-file-parallelism", + "graph": "npm run build && DATABASE_URL=postgresql://graph-only.invalid/messenger REDIS_URL=redis://graph-only.invalid:6379 tsx scripts/graph-modules.ts", "test:e2e": "vitest run --config ./vitest.config.e2e.ts" }, "dependencies": { @@ -28,11 +29,15 @@ "@nestjs/core": "^12.0.1", "@nestjs/platform-express": "^12.0.1", "@nestjs/platform-fastify": "^12.0.3", + "argon2": "^0.45.1", "class-transformer": "^0.5.1", "class-validator": "^0.15.1", "fastify": "^5.12.5", + "pg": "^8.23.1", + "redis": "^6.3.0", "reflect-metadata": "^0.2.2", - "rxjs": "^7.8.1" + "rxjs": "^7.8.1", + "zod": "^4.6.5" }, "devDependencies": { "@nestjs/cli": "^12.0.0", @@ -41,12 +46,16 @@ "@nestjs/testing": "^12.0.1", "@types/express": "^5.0.0", "@types/node": "^24.0.0", + "@types/pg": "^8.23.1", "@types/supertest": "^7.0.0", "@vitest/coverage-v8": "^4.1.2", + "dotenv": "^18.0.5", + "nestjs-spelunker": "^1.3.2", "oxlint": "^1.58.0", "prettier": "^3.4.2", "source-map-support": "^0.5.21", "supertest": "^7.2.2", + "tsx": "^4.23.15", "typescript": "^6.0.3", "vite-tsconfig-paths": "^5.1.4", "vitest": "^4.1.2" diff --git a/app/scripts/graph-modules.ts b/app/scripts/graph-modules.ts new file mode 100644 index 00000000..5e8e6d86 --- /dev/null +++ b/app/scripts/graph-modules.ts @@ -0,0 +1,123 @@ +import { mkdir, writeFile } from 'node:fs/promises'; +import 'reflect-metadata'; +import { SpelunkerModule, type DebuggedTree } from 'nestjs-spelunker'; +import { AppModule } from '../dist/app.module.js'; + +function mermaidId(name: string): string { + return name.replace(/[^a-zA-Z0-9_]/gu, '_'); +} + +function findDependencyModule( + tree: DebuggedTree[], + dependency: string, +): DebuggedTree | undefined { + return tree.find( + (candidate) => + candidate.providers.some((item) => item.name === dependency) || + candidate.controllers.some((item) => item.name === dependency), + ); +} + +function renderMermaid(tree: DebuggedTree[]): string { + const lines = [ + 'flowchart LR', + ' %% Generated by scripts/graph-modules.ts', + ' %% Solid arrows: module imports; dotted arrows: constructor dependencies', + ]; + const moduleNames = tree.map((module) => module.name); + + for (const module of tree) { + const moduleId = mermaidId(module.name); + lines.push(` subgraph ${moduleId}["${module.name}"]`); + for (const provider of module.providers) { + lines.push( + ` ${moduleId}_${mermaidId(provider.name)}["provider: ${provider.name}"]`, + ); + } + for (const controller of module.controllers) { + lines.push( + ` ${moduleId}_${mermaidId(controller.name)}["controller: ${controller.name}"]`, + ); + } + lines.push(' end'); + } + + for (const module of tree) { + for (const imported of module.imports) { + if (moduleNames.includes(imported)) { + lines.push( + ` ${mermaidId(module.name)} -->|imports| ${mermaidId(imported)}`, + ); + } + } + for (const item of [...module.providers, ...module.controllers]) { + for (const dependency of item.dependencies) { + const targetModule = findDependencyModule(tree, dependency); + if (targetModule) { + const source = `${mermaidId(module.name)}_${mermaidId(item.name)}`; + const target = `${mermaidId(targetModule.name)}_${mermaidId(dependency)}`; + lines.push(` ${source} -.->|injects| ${target}`); + } + } + } + } + + return `${lines.join('\n')}\n`; +} + +function renderMarkdown(tree: DebuggedTree[], mermaid: string): string { + const lines = [ + '# NestJS dependency graph', + '', + 'Generated from `AppModule` with `nestjs-spelunker` static module debugging.', + '', + '- Solid arrows: module imports.', + '- Dotted arrows: constructor dependencies.', + '- The generator does not boot PostgreSQL or Redis.', + '', + '```mermaid', + mermaid.trim(), + '```', + '', + '## Module details', + '', + ]; + + for (const module of tree) { + lines.push( + `### ${module.name}`, + '', + `- Imports: ${module.imports.join(', ') || 'none'}`, + ); + lines.push( + `- Exports: ${module.exports.map((item) => `${item.name} (${item.type})`).join(', ') || 'none'}`, + ); + lines.push('', '| Kind | Name | Dependencies |', '| --- | --- | --- |'); + for (const provider of module.providers) { + lines.push( + `| provider | ${provider.name} | ${provider.dependencies.join(', ') || 'none'} |`, + ); + } + for (const controller of module.controllers) { + lines.push( + `| controller | ${controller.name} | ${controller.dependencies.join(', ') || 'none'} |`, + ); + } + lines.push(''); + } + + return lines.join('\n'); +} + +const tree = await SpelunkerModule.debug(AppModule); +const mermaid = renderMermaid(tree); +await mkdir('../docs/architecture', { recursive: true }); +await writeFile( + '../docs/architecture/nest-module-details.json', + JSON.stringify(tree, null, 2), +); +await writeFile('../docs/architecture/nest-module-graph.mmd', mermaid); +await writeFile( + '../docs/architecture/nest-dependency-graph.md', + renderMarkdown(tree, mermaid), +); diff --git a/app/src/app.module.ts b/app/src/app.module.ts index 39368296..c731b7a4 100644 --- a/app/src/app.module.ts +++ b/app/src/app.module.ts @@ -1,10 +1,33 @@ import { Module } from '@nestjs/common'; +import { AppConfigModule } from './config/app-config.module.js'; +import { DatabaseModule } from './database/database.module.js'; +import { RedisModule } from './redis/redis.module.js'; +import { AuthModule } from './auth/auth.module.js'; import { ChatsModule } from './chats/chats.module.js'; import { HealthModule } from './health/health.module.js'; import { MessagesModule } from './messages/messages.module.js'; +import { MetricsModule } from './metrics/metrics.module.js'; import { UsersModule } from './users/users.module.js'; +import { APP_FILTER } from '@nestjs/core'; +import { ApiExceptionFilter } from './common/errors/api-exception.filter.js'; @Module({ - imports: [HealthModule, UsersModule, ChatsModule, MessagesModule], + imports: [ + AppConfigModule, + DatabaseModule, + RedisModule, + UsersModule, + AuthModule, + HealthModule, + ChatsModule, + MessagesModule, + MetricsModule, + ], + providers: [ + { + provide: APP_FILTER, + useClass: ApiExceptionFilter, + }, + ], }) export class AppModule {} diff --git a/app/src/auth/auth.controller.ts b/app/src/auth/auth.controller.ts new file mode 100644 index 00000000..265696d9 --- /dev/null +++ b/app/src/auth/auth.controller.ts @@ -0,0 +1,79 @@ +import { + BadRequestException, + Body, + Controller, + Delete, + Headers, + HttpCode, + HttpStatus, + Post, + UnauthorizedException, + UseGuards, +} from '@nestjs/common'; +import { TextDecoder } from 'node:util'; +import { AuthService } from './auth.service.js'; +import { CurrentUserGuard } from '../common/auth/current-user.guard.js'; + +const BASE64 = + /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/u; +const BASIC_CHALLENGE = 'Basic realm="messenger", charset="UTF-8"'; + +function basicUnauthorized(): UnauthorizedException { + return new UnauthorizedException({ + message: 'Unauthorized', + challenge: BASIC_CHALLENGE, + }); +} + +function bearerUnauthorized(): UnauthorizedException { + return new UnauthorizedException({ + message: 'Unauthorized', + challenge: 'Bearer realm="messenger"', + }); +} + +function parseBasic(value: string | undefined): [string, string] { + if (typeof value !== 'string') throw basicUnauthorized(); + const match = /^Basic[ \t]+([^ \t]+)$/iu.exec(value); + if (!match || !BASE64.test(match[1])) throw basicUnauthorized(); + const bytes = Buffer.from(match[1], 'base64'); + if (bytes.toString('base64') !== match[1]) throw basicUnauthorized(); + let decoded: string; + try { + decoded = new TextDecoder('utf-8', { fatal: true }).decode(bytes); + } catch { + throw basicUnauthorized(); + } + const separator = decoded.indexOf(':'); + if (separator < 1) throw basicUnauthorized(); + return [decoded.slice(0, separator), decoded.slice(separator + 1)]; +} + +@Controller('api/v1/auth/sessions') +export class AuthController { + constructor(private readonly auth: AuthService) {} + + @Post() + create( + @Headers('authorization') authorization: string | undefined, + @Body() body: unknown, + ) { + const [username, password] = parseBasic(authorization); + if (body !== undefined) + throw new BadRequestException( + 'Session creation does not accept a body', + ); + return this.auth.createSession(username, password); + } + + @Delete('current') + @UseGuards(CurrentUserGuard) + @HttpCode(HttpStatus.NO_CONTENT) + async delete( + @Headers('authorization') authorization: string | undefined, + ): Promise { + if (!authorization || !/^Bearer\s+[^\s]+$/iu.test(authorization)) + throw bearerUnauthorized(); + await this.auth.deleteSession(authorization.slice(7).trim()); + } +} diff --git a/app/src/auth/auth.module.ts b/app/src/auth/auth.module.ts new file mode 100644 index 00000000..c29483bd --- /dev/null +++ b/app/src/auth/auth.module.ts @@ -0,0 +1,16 @@ +import { Module } from '@nestjs/common'; +import { DatabaseModule } from '../database/database.module.js'; +import { RedisModule } from '../redis/redis.module.js'; +import { UsersModule } from '../users/users.module.js'; +import { AuthController } from './auth.controller.js'; +import { AuthService } from './auth.service.js'; +import { SessionRepository } from './session.repository.js'; +import { MetricsModule } from '../metrics/metrics.module.js'; + +@Module({ + imports: [UsersModule, DatabaseModule, RedisModule, MetricsModule], + controllers: [AuthController], + providers: [AuthService, SessionRepository], + exports: [AuthService, SessionRepository], +}) +export class AuthModule {} diff --git a/app/src/auth/auth.service.ts b/app/src/auth/auth.service.ts new file mode 100644 index 00000000..f9833586 --- /dev/null +++ b/app/src/auth/auth.service.ts @@ -0,0 +1,63 @@ +import { + Injectable, + ServiceUnavailableException, + UnauthorizedException, +} from '@nestjs/common'; +import argon2 from 'argon2'; +import type { User } from '../users/user.js'; +import { UsersService } from '../users/users.service.js'; +import { SessionRepository } from './session.repository.js'; + +export type SessionResponse = { + token: string; + token_type: 'Bearer'; + expires_at: string; + user: User; +}; + +@Injectable() +export class AuthService { + constructor( + private readonly users: UsersService, + private readonly sessions: SessionRepository, + ) {} + + async createSession( + username: string, + password: string, + ): Promise { + const storedUser = await this.users.findByUsername(username); + if ( + !storedUser || + !(await argon2.verify(storedUser.password_hash, password)) + ) { + throw new UnauthorizedException(); + } + const user: User = { + id: storedUser.id, + username: storedUser.username, + display_name: storedUser.display_name, + created_at: storedUser.created_at, + }; + let session: { token: string; expiresAt: string }; + try { + session = await this.sessions.create(user.id); + } catch { + throw new ServiceUnavailableException('Session store unavailable'); + } + return { + token: session.token, + token_type: 'Bearer', + expires_at: session.expiresAt, + user, + }; + } + + async deleteSession(token: string): Promise { + try { + await this.sessions.delete(token); + } catch { + throw new ServiceUnavailableException('Session store unavailable'); + } + } +} diff --git a/app/src/auth/session.repository.ts b/app/src/auth/session.repository.ts new file mode 100644 index 00000000..57eb2827 --- /dev/null +++ b/app/src/auth/session.repository.ts @@ -0,0 +1,35 @@ +import { Injectable } from '@nestjs/common'; +import { ConfigService } from '@nestjs/config'; +import { randomBytes } from 'node:crypto'; +import type { AppConfig } from '../config/app-config.schema.js'; +import { RedisClient } from '../redis/redis.client.js'; +import { MetricsService } from '../metrics/metrics.service.js'; + +@Injectable() +export class SessionRepository { + constructor( + private readonly redis: RedisClient, + private readonly config: ConfigService, + private readonly metrics: MetricsService, + ) {} + + async create( + userId: string, + ): Promise<{ token: string; expiresAt: string }> { + const token = randomBytes(32).toString('base64url'); + const ttl = this.config.getOrThrow('SESSION_TTL_SECONDS'); + const expiresAt = new Date(Date.now() + ttl * 1000).toISOString(); + this.metrics.increment('session_set'); + await this.redis.set( + `session:${token}`, + JSON.stringify({ user_id: userId, expires_at: expiresAt }), + { EX: ttl }, + ); + return { token, expiresAt }; + } + + delete(token: string): Promise { + this.metrics.increment('session_del'); + return this.redis.del(`session:${token}`); + } +} diff --git a/app/src/chats/chats.controller.ts b/app/src/chats/chats.controller.ts index 114e1385..53dcd865 100644 --- a/app/src/chats/chats.controller.ts +++ b/app/src/chats/chats.controller.ts @@ -1,54 +1,49 @@ import { - BadRequestException, - Body, - Controller, - DefaultValuePipe, - Get, - Param, - ParseIntPipe, - ParseUUIDPipe, - Post, - Query, - Req, - UseGuards, + BadRequestException, + Body, + Controller, + DefaultValuePipe, + Get, + Param, + ParseIntPipe, + ParseUUIDPipe, + Post, + Query, + UseGuards, } from '@nestjs/common'; +import { CurrentUser } from '../common/auth/current-user.decorator.js'; import { CurrentUserGuard } from '../common/auth/current-user.guard.js'; -import type { FastifyRequest } from 'fastify'; import { ChatsService } from './chats.service.js'; import { CreateChatDto } from './dto/create-chat.dto.js'; +import type { User } from '../users/user.js'; @Controller('api/v1/chats') @UseGuards(CurrentUserGuard) export class ChatsController { - constructor(private readonly chatsService: ChatsService) {} + constructor(private readonly chatsService: ChatsService) {} - @Post() - create(@Body() body: CreateChatDto, @Req() request: FastifyRequest) { - return this.chatsService.create(body, request.currentUser!); - } + @Post() + create(@Body() body: CreateChatDto, @CurrentUser() currentUser: User) { + return this.chatsService.create(body, currentUser); + } - @Get() - list( - @Req() request: FastifyRequest, - @Query('limit', new DefaultValuePipe(50), new ParseIntPipe()) limit: number, - @Query('cursor') cursor?: string, - ) { - if (limit < 1 || limit > 100) { - throw new BadRequestException('limit must be between 1 and 100'); - } + @Get() + list( + @CurrentUser() currentUser: User, + @Query('limit', new DefaultValuePipe(50), new ParseIntPipe()) + limit: number, + @Query('cursor') cursor?: string, + ) { + if (limit < 1 || limit > 100) + throw new BadRequestException('limit must be between 1 and 100'); + return this.chatsService.listForUser(currentUser, limit, cursor); + } - return this.chatsService.listForUser( - request.currentUser!, - limit, - cursor, - ); - } - - @Get(':chatId') - get( - @Param('chatId', new ParseUUIDPipe()) chatId: string, - @Req() request: FastifyRequest, - ) { - return this.chatsService.getForUser(chatId, request.currentUser!); - } + @Get(':chatId') + get( + @Param('chatId', new ParseUUIDPipe()) chatId: string, + @CurrentUser() currentUser: User, + ) { + return this.chatsService.getForUser(chatId, currentUser); + } } diff --git a/app/src/chats/chats.module.ts b/app/src/chats/chats.module.ts index 5163d386..5bc65a34 100644 --- a/app/src/chats/chats.module.ts +++ b/app/src/chats/chats.module.ts @@ -1,13 +1,16 @@ import { Module } from '@nestjs/common'; -import { ChatsController } from './chats.controller.js'; +import { DatabaseModule } from '../database/database.module.js'; +import { RedisModule } from '../redis/redis.module.js'; +import { MetricsModule } from '../metrics/metrics.module.js'; import { UsersModule } from '../users/users.module.js'; +import { ChatsController } from './chats.controller.js'; import { ChatsRepository } from './chats.repository.js'; import { ChatsService } from './chats.service.js'; @Module({ - imports: [UsersModule], - controllers: [ChatsController], - providers: [ChatsRepository, ChatsService], - exports: [ChatsService], + imports: [UsersModule, DatabaseModule, RedisModule, MetricsModule], + controllers: [ChatsController], + providers: [ChatsRepository, ChatsService], + exports: [ChatsService], }) export class ChatsModule {} diff --git a/app/src/chats/chats.repository.ts b/app/src/chats/chats.repository.ts index 53d8cac1..7090e15a 100644 --- a/app/src/chats/chats.repository.ts +++ b/app/src/chats/chats.repository.ts @@ -1,19 +1,113 @@ -import { Injectable } from '@nestjs/common'; -import { Chat } from './chat.js'; +import { + BadRequestException, + Injectable, + NotFoundException, +} from '@nestjs/common'; +import { randomUUID } from 'node:crypto'; +import { DatabaseClient } from '../database/database.client.js'; +import type { Cursor } from '../common/http/cursor.js'; +import type { User } from '../users/user.js'; +import type { Chat } from './chat.js'; + +type ChatRow = { + id: string; + title: string; + created_at: Date | string; + member_ids: string[]; +}; + +function toChat(row: ChatRow): Chat { + return { + id: row.id, + title: row.title, + created_at: new Date(row.created_at).toISOString(), + member_ids: row.member_ids, + }; +} @Injectable() export class ChatsRepository { - private readonly chatsById = new Map(); + constructor(private readonly database: DatabaseClient) {} - save(chat: Chat): void { - this.chatsById.set(chat.id, chat); + async create(title: string, memberIds: string[]): Promise { + const id = randomUUID(); + return this.database.withTransaction(async (client) => { + const users = await client.query<{ id: string }>({ + name: 'chats.validateMembers', + text: 'SELECT id FROM users WHERE id = ANY($1::uuid[])', + values: [memberIds], + }); + if (users.rowCount !== memberIds.length) + throw new BadRequestException('Chat member does not exist'); + const inserted = await client.query({ + name: 'chats.insert', + text: 'INSERT INTO chats (id, title) VALUES ($1, $2) RETURNING id, title, created_at', + values: [id, title], + }); + for (const memberId of memberIds) { + await client.query({ + name: 'chats.insertMember', + text: 'INSERT INTO chat_members (chat_id, user_id) VALUES ($1, $2)', + values: [id, memberId], + }); + } + return { + ...toChat({ ...inserted.rows[0], member_ids: memberIds }), + member_ids: memberIds, + }; + }); } - findById(id: string): Chat | undefined { - return this.chatsById.get(id); + async findForUser(id: string, user: User): Promise { + const result = await this.database.query( + 'chats.findForUser', + `SELECT c.id, c.title, c.created_at, + COALESCE(array_agg(cm.user_id ORDER BY cm.user_id) + FILTER (WHERE cm.user_id IS NOT NULL), '{}') AS member_ids + FROM chats c + LEFT JOIN chat_members cm ON cm.chat_id = c.id + WHERE c.id = $1 + AND EXISTS ( + SELECT 1 FROM chat_members own + WHERE own.chat_id = c.id AND own.user_id = $2 + ) + GROUP BY c.id`, + [id, user.id], + ); + return result.rows[0] ? toChat(result.rows[0]) : undefined; } - findAll(): Chat[] { - return Array.from(this.chatsById.values()); + async findPageForUser( + user: User, + limit: number, + cursor?: Cursor, + ): Promise<{ items: Chat[]; hasMore: boolean }> { + const values: unknown[] = [user.id]; + let predicate = ''; + if (cursor) { + values.push(cursor.created_at, cursor.id); + predicate = + 'AND (c.created_at, c.id) > ($2::timestamptz, $3::uuid)'; + } + values.push(limit + 1); + const result = await this.database.query( + 'chats.listForUser', + `SELECT c.id, c.title, c.created_at, + COALESCE(array_agg(cm.user_id ORDER BY cm.user_id) + FILTER (WHERE cm.user_id IS NOT NULL), '{}') AS member_ids + FROM chats c + LEFT JOIN chat_members cm ON cm.chat_id = c.id + WHERE EXISTS ( + SELECT 1 FROM chat_members own + WHERE own.chat_id = c.id AND own.user_id = $1 + ) + ${predicate} + GROUP BY c.id ORDER BY c.created_at, c.id LIMIT $${values.length}`, + values, + ); + return { + items: result.rows.slice(0, limit).map(toChat), + hasMore: result.rows.length > limit, + }; } } diff --git a/app/src/chats/chats.service.ts b/app/src/chats/chats.service.ts index 63f22d64..354c8973 100644 --- a/app/src/chats/chats.service.ts +++ b/app/src/chats/chats.service.ts @@ -1,95 +1,60 @@ import { - BadRequestException, - Injectable, - NotFoundException, + BadRequestException, + Injectable, + NotFoundException, } from '@nestjs/common'; -import { randomUUID } from 'node:crypto'; -import { - decodeCursor, - encodeCursor, - isAfter, -} from '../common/http/cursor.js'; +import { encodeCursor, decodeCursor } from '../common/http/cursor.js'; import type { User } from '../users/user.js'; -import { UsersService } from '../users/users.service.js'; -import type { Chat } from './chat.js'; import type { CreateChatDto } from './dto/create-chat.dto.js'; +import type { Chat } from './chat.js'; import { ChatsRepository } from './chats.repository.js'; @Injectable() export class ChatsService { - constructor( - private readonly chatsRepository: ChatsRepository, - private readonly usersService: UsersService, - ) {} + constructor(private readonly chatsRepository: ChatsRepository) {} - create(input: CreateChatDto, currentUser: User): Chat { - if (!input.member_ids.includes(currentUser.id)) { - throw new BadRequestException('Current user must be a chat member'); - } + create(input: CreateChatDto, currentUser: User): Promise { + if (!input.member_ids.includes(currentUser.id)) + throw new BadRequestException('Current user must be a chat member'); + if (new Set(input.member_ids).size !== input.member_ids.length) + throw new BadRequestException('Duplicate chat member'); + return this.chatsRepository.create(input.title, input.member_ids); + } - for (const memberId of input.member_ids) { - if (!this.usersService.findById(memberId)) { - throw new BadRequestException('Chat member does not exist'); - } - } + async getForUser(chatId: string, currentUser: User): Promise { + const chat = await this.chatsRepository.findForUser( + chatId, + currentUser, + ); + if (!chat) throw new NotFoundException(); + return chat; + } - const chat: Chat = { - id: randomUUID(), - title: input.title, - member_ids: [...input.member_ids], - created_at: new Date().toISOString(), - }; - - this.chatsRepository.save(chat); - return chat; - } - - getForUser(chatId: string, currentUser: User): Chat { - const chat = this.chatsRepository.findById(chatId); - - if (!chat || !chat.member_ids.includes(currentUser.id)) { - throw new NotFoundException(); - } - - return chat; - } - - listForUser( - currentUser: User, - limit: number, - cursorValue?: string, - ): { items: Chat[]; next_cursor: string | null } { - const scope = `chats:${currentUser.id}`; - const cursor = cursorValue - ? decodeCursor(cursorValue, scope) - : undefined; - - const chats = this.chatsRepository - .findAll() - .filter((chat) => chat.member_ids.includes(currentUser.id)) - .sort((left, right) => { - const byDate = left.created_at.localeCompare(right.created_at); - return byDate !== 0 ? byDate : left.id.localeCompare(right.id); - }); - - const start = cursor - ? chats.findIndex((chat) => isAfter(chat.created_at, chat.id, cursor)) - : 0; - const visible = chats.slice(start < 0 ? chats.length : start); - const items = visible.slice(0, limit); - const hasMore = visible.length > limit; - const last = items.at(-1); - - return { - items, - next_cursor: - hasMore && last - ? encodeCursor({ - scope, - created_at: last.created_at, - id: last.id, - }) - : null, - }; - } + async listForUser( + currentUser: User, + limit: number, + cursorValue?: string, + ): Promise<{ items: Chat[]; next_cursor: string | null }> { + const scope = `chats:${currentUser.id}`; + const cursor = cursorValue + ? decodeCursor(cursorValue, scope) + : undefined; + const page = await this.chatsRepository.findPageForUser( + currentUser, + limit, + cursor, + ); + const last = page.items.at(-1); + return { + items: page.items, + next_cursor: + page.hasMore && last + ? encodeCursor({ + scope, + created_at: last.created_at, + id: last.id, + }) + : null, + }; + } } diff --git a/app/src/common/auth/current-user.decorator.ts b/app/src/common/auth/current-user.decorator.ts new file mode 100644 index 00000000..dc054212 --- /dev/null +++ b/app/src/common/auth/current-user.decorator.ts @@ -0,0 +1,10 @@ +import { createParamDecorator, ExecutionContext } from '@nestjs/common'; +import type { User } from '../../users/user.js'; +import { FastifyRequest } from 'fastify'; + +export const CurrentUser = createParamDecorator( + (_data: unknown, context: ExecutionContext): User => { + const request = context.switchToHttp().getRequest(); + return request.currentUser!; + }, +); diff --git a/app/src/common/auth/current-user.guard.ts b/app/src/common/auth/current-user.guard.ts index ea04f9a8..ae400b1f 100644 --- a/app/src/common/auth/current-user.guard.ts +++ b/app/src/common/auth/current-user.guard.ts @@ -2,42 +2,84 @@ import { CanActivate, ExecutionContext, Injectable, + ServiceUnavailableException, UnauthorizedException, } from '@nestjs/common'; -import { isUUID } from 'class-validator'; +import type { FastifyRequest } from 'fastify'; import type { User } from '../../users/user.js'; +import { RedisClient } from '../../redis/redis.client.js'; import { UsersService } from '../../users/users.service.js'; - -export type RequestWithCurrentUser = { - headers: { - 'x-user-id'?: string | string[]; - }; - currentUser?: User; -}; +import { MetricsService } from '../../metrics/metrics.service.js'; @Injectable() export class CurrentUserGuard implements CanActivate { - constructor(private readonly usersService: UsersService) {} + constructor( + private readonly redis: RedisClient, + private readonly users: UsersService, + private readonly metrics: MetricsService, + ) {} - canActivate(context: ExecutionContext): boolean { - const request = context - .switchToHttp() - .getRequest(); - - const header = request.headers['x-user-id']; - - if (typeof header !== 'string' || !isUUID(header)) { - throw new UnauthorizedException(); + async canActivate(context: ExecutionContext): Promise { + const request = context.switchToHttp().getRequest(); + const authorization = request.headers.authorization; + if ( + typeof authorization !== 'string' || + !/^Bearer\s+[^\s]+$/u.test(authorization) + ) { + throw new UnauthorizedException({ + message: 'Unauthorized', + challenge: 'Bearer realm="messenger"', + }); } - - const user = this.usersService.findById(header); - - if (!user) { - throw new UnauthorizedException(); + let session: string | null; + try { + this.metrics.increment('session_get'); + session = await this.redis.get( + `session:${authorization.slice(7).trim()}`, + ); + } catch { + throw new ServiceUnavailableException('Session store unavailable'); } - + if (!session) + throw new UnauthorizedException({ + message: 'Unauthorized', + challenge: 'Bearer realm="messenger"', + }); + let userId: string; + try { + const parsed: unknown = JSON.parse(session); + if ( + typeof parsed !== 'object' || + parsed === null || + !('user_id' in parsed) || + typeof parsed.user_id !== 'string' || + !('expires_at' in parsed) || + typeof parsed.expires_at !== 'string' || + !/^(?:\d{4})-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/u.test( + parsed.expires_at, + ) + ) + throw new Error('invalid session'); + const expiresAt = Date.parse(parsed.expires_at); + if (!Number.isFinite(expiresAt) || Date.now() >= expiresAt) + throw new Error('expired session'); + userId = parsed.user_id; + } catch { + throw new UnauthorizedException({ + message: 'Unauthorized', + challenge: 'Bearer realm="messenger"', + }); + } + let user: User | undefined; + try { + user = await this.users.findById(userId); + } catch { + throw new ServiceUnavailableException( + 'Authentication service unavailable', + ); + } + if (!user) throw new UnauthorizedException(); request.currentUser = user; - return true; } } diff --git a/app/src/common/errors/api-exception.filter.ts b/app/src/common/errors/api-exception.filter.ts index d49a0003..ce3298b9 100644 --- a/app/src/common/errors/api-exception.filter.ts +++ b/app/src/common/errors/api-exception.filter.ts @@ -5,85 +5,114 @@ import { HttpException, HttpStatus, } from '@nestjs/common'; +import { HttpAdapterHost } from '@nestjs/core'; import { randomUUID } from 'node:crypto'; -type RequestWithId = { - requestId?: string; -}; +type RequestWithId = { requestId?: string; method?: string; url?: string }; +type ExceptionBody = { message?: unknown; challenge?: unknown }; -type HttpResponse = { - header(name: string, value: string): void; - status(code: number): HttpResponse; - send(body: unknown): void; -}; +// Connection/session loss codes reported by node-postgres and the network layer. +const UNAVAILABLE_ERROR_CODES = new Set([ + 'ECONNREFUSED', + 'ECONNRESET', + 'ENOTFOUND', + 'ETIMEDOUT', + 'EPIPE', + '08000', + '08001', + '08003', + '08004', + '08006', + '57P01', + '57P02', + '57P03', + '53300', +]); + +function isDependencyOutage(exception: unknown): boolean { + if (typeof exception !== 'object' || exception === null) return false; + const code = (exception as { code?: unknown }).code; + return typeof code === 'string' && UNAVAILABLE_ERROR_CODES.has(code); +} function errorCodeForStatus(status: number): string { - switch (status) { - case HttpStatus.BAD_REQUEST: - return 'invalid_request'; - case HttpStatus.UNAUTHORIZED: - return 'unauthorized'; - case HttpStatus.NOT_FOUND: - return 'not_found'; - case HttpStatus.CONFLICT: - return 'conflict'; - case HttpStatus.PAYLOAD_TOO_LARGE: - return 'payload_too_large'; - case HttpStatus.UNSUPPORTED_MEDIA_TYPE: - return 'unsupported_media_type'; - case HttpStatus.TOO_MANY_REQUESTS: - return 'rate_limited'; - case HttpStatus.SERVICE_UNAVAILABLE: - return 'unavailable'; - default: - return 'internal_error'; - } + const codes: Record = { + [HttpStatus.BAD_REQUEST]: 'invalid_request', + [HttpStatus.UNAUTHORIZED]: 'unauthorized', + [HttpStatus.NOT_FOUND]: 'not_found', + [HttpStatus.CONFLICT]: 'conflict', + [HttpStatus.PAYLOAD_TOO_LARGE]: 'payload_too_large', + [HttpStatus.UNSUPPORTED_MEDIA_TYPE]: 'unsupported_media_type', + [HttpStatus.TOO_MANY_REQUESTS]: 'rate_limited', + [HttpStatus.SERVICE_UNAVAILABLE]: 'unavailable', + }; + return codes[status] ?? 'internal_error'; } @Catch() export class ApiExceptionFilter implements ExceptionFilter { - catch(exception: any, host: ArgumentsHost) { - const context = host.switchToHttp(); - - const request = context.getRequest(); - - const response = context.getResponse(); + constructor(private readonly adapterHost: HttpAdapterHost) {} + catch(exception: unknown, host: ArgumentsHost): void { + const http = host.switchToHttp(); + const request = http.getRequest(); + const response = http.getResponse(); + const adapter = this.adapterHost.httpAdapter; const requestId = request.requestId ?? randomUUID(); - request.requestId = requestId; - response.header('X-Request-Id', requestId); let status = HttpStatus.INTERNAL_SERVER_ERROR; let message = 'Internal server error'; - + let challenge: string | undefined; if (exception instanceof HttpException) { status = exception.getStatus(); - const exceptionResponse = exception.getResponse(); + const body = exception.getResponse(); + const details: ExceptionBody = + typeof body === 'object' && body !== null + ? (body as ExceptionBody) + : {}; const rawMessage = - typeof exceptionResponse === 'object' && - exceptionResponse !== null && - 'message' in exceptionResponse - ? exceptionResponse.message + 'message' in details ? details.message : undefined; + challenge = + typeof details.challenge === 'string' + ? details.challenge : undefined; - message = Array.isArray(rawMessage) ? rawMessage.join('; ') : typeof rawMessage === 'string' ? rawMessage : 'Request failed'; - - if (status === HttpStatus.NOT_FOUND) { - message = 'Resource not found'; - } + if (status === HttpStatus.NOT_FOUND) message = 'Resource not found'; + if (status >= HttpStatus.INTERNAL_SERVER_ERROR) + message = + status === HttpStatus.SERVICE_UNAVAILABLE + ? 'Service unavailable' + : 'Internal server error'; + } else if (isDependencyOutage(exception)) { + // A dropped dependency is a bounded outage, not an internal fault. + status = HttpStatus.SERVICE_UNAVAILABLE; + message = 'Service unavailable'; } - - response.status(status).send({ - error: { - code: errorCodeForStatus(status), - message: message, - request_id: requestId, + if (status === HttpStatus.UNAUTHORIZED) { + const authChallenge = + challenge ?? + (request.method === 'POST' && + request.url?.startsWith('/api/v1/auth/sessions') + ? 'Basic realm="messenger", charset="UTF-8"' + : 'Bearer realm="messenger"'); + adapter.setHeader(response, 'WWW-Authenticate', authChallenge); + } + adapter.setHeader(response, 'X-Request-Id', requestId); + adapter.reply( + response, + { + error: { + code: errorCodeForStatus(status), + message, + request_id: requestId, + }, }, - }); + status, + ); } } diff --git a/app/src/common/http/cursor.ts b/app/src/common/http/cursor.ts index 2d95d77a..bdc53a1e 100644 --- a/app/src/common/http/cursor.ts +++ b/app/src/common/http/cursor.ts @@ -1,54 +1,57 @@ import { BadRequestException } from '@nestjs/common'; export type Cursor = { - scope: string; - created_at: string; - id: string; + scope: string; + created_at: string; + id: string; }; export function encodeCursor(cursor: Cursor): string { - return Buffer.from(JSON.stringify(cursor), 'utf8').toString('base64url'); + return Buffer.from(JSON.stringify(cursor), 'utf8').toString('base64url'); } export function decodeCursor(value: string, expectedScope: string): Cursor { - try { - const parsed: unknown = JSON.parse( - Buffer.from(value, 'base64url').toString('utf8'), - ); - - if ( - typeof parsed !== 'object' || - parsed === null || - !('scope' in parsed) || - !('created_at' in parsed) || - !('id' in parsed) || - typeof parsed.scope !== 'string' || - typeof parsed.created_at !== 'string' || - typeof parsed.id !== 'string' || - parsed.scope !== expectedScope || - parsed.created_at.length === 0 || - parsed.id.length === 0 - ) { - throw new Error('invalid cursor'); - } - - return { - scope: parsed.scope, - created_at: parsed.created_at, - id: parsed.id, - }; - } catch { - throw new BadRequestException('Invalid cursor'); - } + try { + const parsed: unknown = JSON.parse( + Buffer.from(value, 'base64url').toString('utf8'), + ); + if ( + typeof parsed !== 'object' || + parsed === null || + !('scope' in parsed) || + !('created_at' in parsed) || + !('id' in parsed) || + typeof parsed.scope !== 'string' || + typeof parsed.created_at !== 'string' || + typeof parsed.id !== 'string' || + parsed.scope !== expectedScope || + !/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu.test( + parsed.id, + ) || + !/^(?:\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z)$/u.test( + parsed.created_at, + ) + ) + throw new Error('invalid cursor'); + const timestamp = Date.parse(parsed.created_at); + if (!Number.isFinite(timestamp)) throw new Error('invalid cursor'); + return { + scope: parsed.scope, + created_at: parsed.created_at, + id: parsed.id, + }; + } catch { + throw new BadRequestException('Invalid cursor'); + } } export function isAfter( - createdAt: string, - id: string, - cursor: Cursor, + createdAt: string, + id: string, + cursor: Cursor, ): boolean { - return ( - createdAt > cursor.created_at || - (createdAt === cursor.created_at && id > cursor.id) - ); + return ( + createdAt > cursor.created_at || + (createdAt === cursor.created_at && id > cursor.id) + ); } diff --git a/app/src/common/http/request-id.interceptor.ts b/app/src/common/http/request-id.interceptor.ts index 4351566b..389d6a48 100644 --- a/app/src/common/http/request-id.interceptor.ts +++ b/app/src/common/http/request-id.interceptor.ts @@ -4,32 +4,47 @@ import { Injectable, NestInterceptor, } from '@nestjs/common'; +import { HttpAdapterHost } from '@nestjs/core'; import { randomUUID } from 'node:crypto'; -import { Observable } from 'rxjs'; +import { finalize, Observable } from 'rxjs'; +import { MetricsService } from '../../metrics/metrics.service.js'; +const INSTANCE_ID = randomUUID(); -type RequestWithId = { - requestId?: string; -}; - -type ResponseWithHeader = { - header(name: string, value: string): void; -}; +type RequestWithId = { requestId?: string }; @Injectable() export class RequestIdInterceptor implements NestInterceptor { + constructor( + private readonly adapterHost: HttpAdapterHost, + private readonly metrics: MetricsService, + ) {} + intercept( context: ExecutionContext, - next: CallHandler, - ): Observable | Promise> { + next: CallHandler, + ): Observable { const request = context.switchToHttp().getRequest(); - - const response = context.switchToHttp().getResponse(); - + const response = context.switchToHttp().getResponse(); const requestId = randomUUID(); - + const startedAt = performance.now(); request.requestId = requestId; - response.header('X-Request-Id', requestId); - - return next.handle(); + this.adapterHost.httpAdapter.setHeader( + response, + 'X-Request-Id', + requestId, + ); + this.adapterHost.httpAdapter.setHeader( + response, + 'X-Instance-Id', + INSTANCE_ID, + ); + this.metrics.increment('request_count'); + return next + .handle() + .pipe( + finalize(() => + this.metrics.observeLatency(performance.now() - startedAt), + ), + ); } } diff --git a/app/src/config/app-config.module.ts b/app/src/config/app-config.module.ts new file mode 100644 index 00000000..567ea6a7 --- /dev/null +++ b/app/src/config/app-config.module.ts @@ -0,0 +1,16 @@ +import { Global, Module } from '@nestjs/common'; +import { ConfigModule } from '@nestjs/config'; +import { parseAppConfig } from './app-config.schema.js'; + +@Global() +@Module({ + imports: [ + ConfigModule.forRoot({ + isGlobal: true, + cache: true, + validate: parseAppConfig, + }), + ], + exports: [ConfigModule], +}) +export class AppConfigModule {} diff --git a/app/src/config/app-config.schema.ts b/app/src/config/app-config.schema.ts new file mode 100644 index 00000000..916b879d --- /dev/null +++ b/app/src/config/app-config.schema.ts @@ -0,0 +1,91 @@ +import { readFileSync } from 'node:fs'; +import { z } from 'zod'; + +function numeric( + name: string, + minimum: number, + maximum: number | undefined, + fallback: number, +) { + let schema = z + .number({ message: `${name} must be a number` }) + .int() + .min(minimum); + if (maximum !== undefined) schema = schema.max(maximum); + return z.preprocess( + (value) => + typeof value === 'string' && value.trim() !== '' + ? Number(value) + : value, + schema.default(fallback), + ); +} + +function requiredString(name: string) { + return z + .string({ message: `${name} is required` }) + .min(1, `${name} is required`); +} + +export const appConfigSchema = z + .object({ + APP_HOST: z.string().min(1).default('0.0.0.0'), + APP_PORT: numeric('APP_PORT', 1, 65535, 8080), + APP_ENV: z.string().min(1).default('lab'), + SESSION_TTL_SECONDS: numeric('SESSION_TTL_SECONDS', 2, undefined, 3600), + DATABASE_URL: requiredString('DATABASE_URL'), + REDIS_URL: requiredString('REDIS_URL'), + DATABASE_POOL_MAX: numeric('DATABASE_POOL_MAX', 1, 100, 10), + DATABASE_CONNECTION_TIMEOUT_MS: numeric( + 'DATABASE_CONNECTION_TIMEOUT_MS', + 1, + undefined, + 5000, + ), + DATABASE_STATEMENT_TIMEOUT_MS: numeric( + 'DATABASE_STATEMENT_TIMEOUT_MS', + 1, + undefined, + 5000, + ), + CACHE_TTL_SECONDS: numeric('CACHE_TTL_SECONDS', 1, undefined, 30), + CACHE_MODE: z.enum(['protected', 'naive']).default('protected'), + CACHE_LOCK_TTL_MS: numeric('CACHE_LOCK_TTL_MS', 1, undefined, 1000), + CACHE_MISS_DELAY_MS: numeric('CACHE_MISS_DELAY_MS', 0, undefined, 0), + METRICS_TOKEN: z.string().min(1).optional(), + DRAIN_DELAY_MS: numeric('DRAIN_DELAY_MS', 0, undefined, 5000), + }) + .strip(); + +export type AppConfig = z.infer; +export type AppConfigKey = keyof AppConfig; + +function resolveSecret( + raw: Record, + key: 'DATABASE_URL' | 'REDIS_URL', +): unknown { + const fileKey = `${key}_FILE`; + const path = raw[fileKey]; + if (typeof path !== 'string' || path.length === 0) return raw[key]; + try { + const value = readFileSync(path, 'utf8').trim(); + if (value.length === 0) + throw new Error(`${fileKey} contains an empty value`); + return value; + } catch (error) { + if ( + error instanceof Error && + error.message.includes('contains an empty value') + ) + throw error; + throw new Error(`${fileKey} could not be read`); + } +} + +export function parseAppConfig(raw: Record): AppConfig { + return appConfigSchema.parse({ + ...raw, + DATABASE_URL: resolveSecret(raw, 'DATABASE_URL'), + REDIS_URL: resolveSecret(raw, 'REDIS_URL'), + }); +} diff --git a/app/src/database/database.client.ts b/app/src/database/database.client.ts new file mode 100644 index 00000000..98a1c88f --- /dev/null +++ b/app/src/database/database.client.ts @@ -0,0 +1,75 @@ +import { Injectable, Logger, OnModuleDestroy } from '@nestjs/common'; +import { ConfigService } from '@nestjs/config'; +import pg from 'pg'; +import { MetricsService } from '../metrics/metrics.service.js'; +import type { AppConfig } from '../config/app-config.schema.js'; + +@Injectable() +export class DatabaseClient implements OnModuleDestroy { + readonly pool: pg.Pool; + private readonly logger = new Logger(DatabaseClient.name); + + constructor( + private readonly config: ConfigService, + private readonly metrics: MetricsService, + ) { + this.pool = new pg.Pool({ + connectionString: this.config.getOrThrow('DATABASE_URL'), + max: this.config.getOrThrow('DATABASE_POOL_MAX'), + connectionTimeoutMillis: this.config.getOrThrow( + 'DATABASE_CONNECTION_TIMEOUT_MS', + ), + statement_timeout: this.config.getOrThrow( + 'DATABASE_STATEMENT_TIMEOUT_MS', + ), + }); + // Idle clients emit 'error' on the pool when the database drops; without a + // listener Node treats it as uncaught and terminates the process. + this.pool.on('error', (error: Error) => { + this.metrics.increment('database.pool_error'); + this.logger.warn(`PostgreSQL pool error: ${error.message}`); + }); + } + + query( + label: string, + text: string, + values: readonly unknown[] = [], + ): Promise> { + this.metrics.increment(label); + return this.pool.query({ text, values: [...values] }); + } + + async health(): Promise { + await this.query('health.database', 'SELECT 1'); + } + + async withTransaction( + work: (client: pg.PoolClient) => Promise, + ): Promise { + const client = await this.pool.connect(); + try { + await client.query('BEGIN'); + const result = await work(client); + await client.query('COMMIT'); + return result; + } catch (error) { + try { + await client.query('ROLLBACK'); + } catch (rollbackError) { + this.metrics.increment('database.rollback_error'); + this.logger.warn( + `Rollback failed: ${rollbackError instanceof Error ? rollbackError.message : 'unknown error'}`, + ); + } + // Callers must see the operation error, not the rollback error. + throw error; + } finally { + client.release(); + } + } + + async onModuleDestroy(): Promise { + await this.pool.end(); + } +} diff --git a/app/src/database/database.module.ts b/app/src/database/database.module.ts new file mode 100644 index 00000000..fe9f0b76 --- /dev/null +++ b/app/src/database/database.module.ts @@ -0,0 +1,10 @@ +import { Module } from '@nestjs/common'; +import { MetricsModule } from '../metrics/metrics.module.js'; +import { DatabaseClient } from './database.client.js'; + +@Module({ + imports: [MetricsModule], + providers: [DatabaseClient], + exports: [DatabaseClient], +}) +export class DatabaseModule {} diff --git a/app/src/database/migration.runner.ts b/app/src/database/migration.runner.ts new file mode 100644 index 00000000..dfcd5070 --- /dev/null +++ b/app/src/database/migration.runner.ts @@ -0,0 +1,63 @@ +import { readdir, readFile } from 'node:fs/promises'; +import { dirname, join } from 'node:path'; +import { fileURLToPath } from 'node:url'; +import { DatabaseClient } from './database.client.js'; +import { MetricsService } from '../metrics/metrics.service.js'; +import { parseAppConfig } from '../config/app-config.schema.js'; + +const migrationsDirectory = join( + dirname(fileURLToPath(import.meta.url)), + 'migrations', +); + +async function migrationFiles(): Promise { + const files = await readdir(migrationsDirectory); + return files.filter((file) => /^\d+_.+\.sql$/u.test(file)).sort(); +} + +export async function runMigrations(database: DatabaseClient): Promise { + await database.query( + 'migrations.ensure_table', + `CREATE TABLE IF NOT EXISTS schema_migrations ( + version text PRIMARY KEY, + applied_at timestamptz NOT NULL DEFAULT now() + )`, + ); + + for (const version of await migrationFiles()) { + await database.withTransaction(async (client) => { + const applied = await client.query({ + text: 'SELECT version FROM schema_migrations WHERE version = $1', + values: [version], + }); + if (applied.rowCount) return; + + const sql = await readFile( + join(migrationsDirectory, version), + 'utf8', + ); + await client.query(sql); + await client.query({ + text: 'INSERT INTO schema_migrations (version) VALUES ($1)', + values: [version], + }); + }); + } +} + +async function main(): Promise { + const config = parseAppConfig(process.env as Record); + const database = new DatabaseClient( + { + getOrThrow: (key: keyof typeof config) => config[key], + } as never, + new MetricsService(), + ); + try { + await runMigrations(database); + } finally { + await database.onModuleDestroy(); + } +} + +if (process.argv[1] === fileURLToPath(import.meta.url)) await main(); diff --git a/app/src/database/migrations/001_initial.sql b/app/src/database/migrations/001_initial.sql new file mode 100644 index 00000000..19225298 --- /dev/null +++ b/app/src/database/migrations/001_initial.sql @@ -0,0 +1,41 @@ +CREATE TABLE IF NOT EXISTS schema_migrations ( + version text PRIMARY KEY, + applied_at timestamptz NOT NULL DEFAULT now() +); + +CREATE TABLE IF NOT EXISTS users ( + id uuid PRIMARY KEY, + username text NOT NULL UNIQUE, + display_name text NOT NULL, + password_hash text NOT NULL, + created_at timestamptz NOT NULL DEFAULT now() +); + +CREATE TABLE IF NOT EXISTS chats ( + id uuid PRIMARY KEY, + title text NOT NULL, + created_at timestamptz NOT NULL DEFAULT now(), + message_version bigint NOT NULL DEFAULT 0 +); + +CREATE TABLE IF NOT EXISTS chat_members ( + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + PRIMARY KEY (chat_id, user_id) +); + +CREATE TABLE IF NOT EXISTS messages ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + sender_id uuid NOT NULL REFERENCES users(id) ON DELETE RESTRICT, + text text NOT NULL, + created_at timestamptz NOT NULL DEFAULT now(), + CONSTRAINT messages_sender_member_fk + FOREIGN KEY (chat_id, sender_id) REFERENCES chat_members(chat_id, user_id) + ON DELETE RESTRICT +); + +CREATE INDEX IF NOT EXISTS messages_chat_created_id_idx + ON messages (chat_id, created_at, id); +CREATE INDEX IF NOT EXISTS chat_members_user_chat_idx + ON chat_members (user_id, chat_id); diff --git a/app/src/database/migrations/002_timestamp_precision.sql b/app/src/database/migrations/002_timestamp_precision.sql new file mode 100644 index 00000000..e084dc68 --- /dev/null +++ b/app/src/database/migrations/002_timestamp_precision.sql @@ -0,0 +1,5 @@ +-- HTTP timestamps and keyset cursors use JavaScript millisecond precision. +-- Store the same precision so a returned cursor cannot point before its own row. +ALTER TABLE users ALTER COLUMN created_at TYPE timestamptz(3); +ALTER TABLE chats ALTER COLUMN created_at TYPE timestamptz(3); +ALTER TABLE messages ALTER COLUMN created_at TYPE timestamptz(3); diff --git a/app/src/health/health.controller.ts b/app/src/health/health.controller.ts index 68a59280..f297b64c 100644 --- a/app/src/health/health.controller.ts +++ b/app/src/health/health.controller.ts @@ -3,15 +3,15 @@ import { HealthService } from './health.service.js'; @Controller('health') export class HealthController { - constructor(private readonly healthService: HealthService) {} + constructor(private readonly healthService: HealthService) {} - @Get('live') - getLive() { - return this.healthService.getLiveness(); - } + @Get('live') + getLive() { + return this.healthService.getLiveness(); + } - @Get('ready') - getReady() { - return this.healthService.getReadiness(); - } + @Get('ready') + async getReady() { + return this.healthService.getReadiness(); + } } diff --git a/app/src/health/health.module.ts b/app/src/health/health.module.ts index 90aadd3e..f5bbe7a6 100644 --- a/app/src/health/health.module.ts +++ b/app/src/health/health.module.ts @@ -1,10 +1,12 @@ import { Module } from '@nestjs/common'; import { HealthController } from './health.controller.js'; import { HealthService } from './health.service.js'; +import { DatabaseModule } from '../database/database.module.js'; +import { RedisModule } from '../redis/redis.module.js'; @Module({ - imports: [], - controllers: [HealthController], - providers: [HealthService], + imports: [DatabaseModule, RedisModule], + controllers: [HealthController], + providers: [HealthService], }) export class HealthModule {} diff --git a/app/src/health/health.service.spec.ts b/app/src/health/health.service.spec.ts index c772d50c..399a9275 100644 --- a/app/src/health/health.service.spec.ts +++ b/app/src/health/health.service.spec.ts @@ -1,57 +1,46 @@ +import { describe, expect, it, vi } from 'vitest'; import { ServiceUnavailableException } from '@nestjs/common'; -import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; import { HealthService } from './health.service.js'; describe('HealthService', () => { - const originalDrainDelay = process.env.DRAIN_DELAY_MS; + it('reports liveness and readiness when dependencies are healthy', async () => { + const database = { health: vi.fn().mockResolvedValue(undefined) }; + const redis = { health: vi.fn().mockResolvedValue(undefined) }; + const config = { get: vi.fn().mockReturnValue(0) }; + const service = new HealthService( + database as never, + redis as never, + config as never, + ); + expect(service.getLiveness()).toEqual({ status: 'ok' }); + await expect(service.getReadiness()).resolves.toEqual({ status: 'ok' }); + }); - beforeEach(() => { - vi.useFakeTimers(); - }); + it('rejects readiness when a dependency is unavailable', async () => { + const database = { + health: vi.fn().mockRejectedValue(new Error('down')), + }; + const redis = { health: vi.fn().mockResolvedValue(undefined) }; + const service = new HealthService( + database as never, + redis as never, + { get: vi.fn() } as never, + ); + await expect(service.getReadiness()).rejects.toBeInstanceOf( + ServiceUnavailableException, + ); + }); - afterEach(() => { - vi.useRealTimers(); - if (originalDrainDelay === undefined) { - delete process.env.DRAIN_DELAY_MS; - } else { - process.env.DRAIN_DELAY_MS = originalDrainDelay; - } - }); - - it('reports live and ready before shutdown starts', () => { - const service = new HealthService(); - - expect(service.getLiveness()).toEqual({ status: 'ok' }); - expect(service.getReadiness()).toEqual({ status: 'ok' }); - }); - - it('keeps liveness healthy but rejects readiness while draining', () => { - const service = new HealthService(); - service.setDraining(); - - expect(service.getLiveness()).toEqual({ status: 'ok' }); - expect(() => service.getReadiness()).toThrow(ServiceUnavailableException); - expect(() => service.getReadiness()).toThrow('Service is shutting down'); - }); - - it('waits for the configured drain window after a termination signal', async () => { - process.env.DRAIN_DELAY_MS = '5000'; - const service = new HealthService(); - - const shutdown = service.beforeApplicationShutdown('SIGTERM'); - await vi.advanceTimersByTimeAsync(4999); - expect(() => service.getReadiness()).toThrow('Service is shutting down'); - - await vi.advanceTimersByTimeAsync(1); - await expect(shutdown).resolves.toBeUndefined(); - }); - - it('does not delay explicit application close without a signal', async () => { - process.env.DRAIN_DELAY_MS = '5000'; - const service = new HealthService(); - - await expect(service.beforeApplicationShutdown()).resolves.toBeUndefined(); - expect(() => service.getReadiness()).toThrow('Service is shutting down'); - expect(vi.getTimerCount()).toBe(0); - }); + it('keeps liveness healthy while draining', async () => { + const service = new HealthService( + { health: vi.fn() } as never, + { health: vi.fn() } as never, + { get: vi.fn() } as never, + ); + service.setDraining(); + expect(service.getLiveness()).toEqual({ status: 'ok' }); + await expect(service.getReadiness()).rejects.toThrow( + 'Service is shutting down', + ); + }); }); diff --git a/app/src/health/health.service.ts b/app/src/health/health.service.ts index 4cae394f..263a5ab7 100644 --- a/app/src/health/health.service.ts +++ b/app/src/health/health.service.ts @@ -1,45 +1,47 @@ import { - Injectable, - ServiceUnavailableException, + Global, + Injectable, + Module, + ServiceUnavailableException, } from '@nestjs/common'; -import type { BeforeApplicationShutdown } from '@nestjs/common'; +import { ConfigService } from '@nestjs/config'; +import { DatabaseClient } from '../database/database.client.js'; +import { RedisClient } from '../redis/redis.client.js'; +import type { AppConfig } from '../config/app-config.schema.js'; @Injectable() -export class HealthService implements BeforeApplicationShutdown { - private ready = true; - private readonly drainDelayMs = this.readDrainDelay(); - - getLiveness() { - return { status: 'ok' as const }; - } - - getReadiness() { - if (!this.ready) { - throw new ServiceUnavailableException('Service is shutting down'); - } - - return { status: 'ok' as const }; - } - - setDraining(): void { - this.ready = false; - } - - async beforeApplicationShutdown(signal?: string): Promise { - this.setDraining(); - - // Explicit app.close() in tests should remain immediate. Signals get a - // drain window so orchestrators can observe readiness=503 before Nest - // closes the HTTP server. - if (signal && this.drainDelayMs > 0) { - await new Promise((resolve) => { - setTimeout(resolve, this.drainDelayMs); - }); - } - } - - private readDrainDelay(): number { - const value = Number.parseInt(process.env.DRAIN_DELAY_MS ?? '5000', 10); - return Number.isFinite(value) && value >= 0 ? value : 5000; - } +export class HealthService { + private ready = true; + constructor( + private readonly database: DatabaseClient, + private readonly redis: RedisClient, + private readonly config: ConfigService, + ) {} + getLiveness() { + return { status: 'ok' as const }; + } + async getReadiness() { + if (!this.ready) + throw new ServiceUnavailableException('Service is shutting down'); + try { + await Promise.all([this.database.health(), this.redis.health()]); + } catch { + throw new ServiceUnavailableException('Dependencies unavailable'); + } + return { status: 'ok' as const }; + } + setDraining() { + this.ready = false; + } + async beforeApplicationShutdown(signal?: string): Promise { + this.setDraining(); + const delay = this.config.get('DRAIN_DELAY_MS') ?? 5000; + if (signal && delay > 0) { + await new Promise((resolve) => setTimeout(resolve, delay)); + } + } } + +@Global() +@Module({ providers: [HealthService], exports: [HealthService] }) +export class HealthServiceModule {} diff --git a/app/src/main.ts b/app/src/main.ts index 475cc389..73b7d74c 100644 --- a/app/src/main.ts +++ b/app/src/main.ts @@ -1,23 +1,26 @@ import { NestFactory } from '@nestjs/core'; +import { HttpAdapterHost } from '@nestjs/core'; +import { ConfigService } from '@nestjs/config'; import { ValidationPipe } from '@nestjs/common'; import { FastifyAdapter, NestFastifyApplication, } from '@nestjs/platform-fastify'; import { AppModule } from './app.module.js'; -import { ApiExceptionFilter } from './common/errors/api-exception.filter.js'; +import { MetricsService } from './metrics/metrics.service.js'; import { RequestIdInterceptor } from './common/http/request-id.interceptor.js'; -async function bootstrap() { +async function bootstrap(): Promise { const app = await NestFactory.create( AppModule, - new FastifyAdapter({ - logger: true, - }), + new FastifyAdapter({ logger: true }), + ); + app.useGlobalInterceptors( + new RequestIdInterceptor( + app.get(HttpAdapterHost), + app.get(MetricsService), + ), ); - - app.useGlobalInterceptors(new RequestIdInterceptor()); - app.useGlobalFilters(new ApiExceptionFilter()); app.useGlobalPipes( new ValidationPipe({ whitelist: true, @@ -27,12 +30,10 @@ async function bootstrap() { ); app.enableShutdownHooks(); - const port = Number(process.env.APP_PORT ?? '8080'); - const host = process.env.APP_HOST ?? '0.0.0.0'; - if (!Number.isInteger(port) || port < 1 || port > 65535) { - throw new Error('APP_PORT must be an integer between 1 and 65535'); - } - + const config = app.get(ConfigService); + const port = config.getOrThrow('APP_PORT'); + const host = config.getOrThrow('APP_HOST'); await app.listen(port, host); } + await bootstrap(); diff --git a/app/src/messages/cache/messages-cache.metrics.spec.ts b/app/src/messages/cache/messages-cache.metrics.spec.ts new file mode 100644 index 00000000..13da19e1 --- /dev/null +++ b/app/src/messages/cache/messages-cache.metrics.spec.ts @@ -0,0 +1,37 @@ +import { ConfigService } from '@nestjs/config'; +import { describe, expect, it, vi } from 'vitest'; +import { MetricsService } from '../../metrics/metrics.service.js'; +import { MessagesCacheService } from './messages-cache.service.js'; + +describe('MessagesCacheService metrics', () => { + it('records a miss and a hit for a protected page fill', async () => { + const metrics = new MetricsService(); + const page = { items: [], next_cursor: null }; + const redis = { + get: vi + .fn() + .mockResolvedValueOnce(null) + .mockResolvedValueOnce(null) + .mockResolvedValue(JSON.stringify(page)), + setNxPx: vi.fn().mockResolvedValue(true), + set: vi.fn().mockResolvedValue('OK'), + unlock: vi.fn().mockResolvedValue(1), + }; + const config = new ConfigService({ + CACHE_MODE: 'protected', + CACHE_LOCK_TTL_MS: 1000, + CACHE_TTL_SECONDS: 30, + }); + const service = new MessagesCacheService( + redis as never, + config, + metrics, + ); + await service.getOrLoad('chat', 1n, undefined, 50, async () => page); + await service.getOrLoad('chat', 1n, undefined, 50, async () => page); + expect(metrics.snapshot().counters).toMatchObject({ + cache_miss: 1, + cache_hit: 1, + }); + }); +}); diff --git a/app/src/messages/cache/messages-cache.module.ts b/app/src/messages/cache/messages-cache.module.ts new file mode 100644 index 00000000..f1cfddfe --- /dev/null +++ b/app/src/messages/cache/messages-cache.module.ts @@ -0,0 +1,11 @@ +import { Module } from '@nestjs/common'; +import { MessagesCacheService } from './messages-cache.service.js'; +import { MetricsModule } from '../../metrics/metrics.module.js'; +import { RedisModule } from '../../redis/redis.module.js'; + +@Module({ + imports: [RedisModule, MetricsModule], + providers: [MessagesCacheService], + exports: [MessagesCacheService], +}) +export class MessagesCacheModule {} diff --git a/app/src/messages/cache/messages-cache.service.spec.ts b/app/src/messages/cache/messages-cache.service.spec.ts new file mode 100644 index 00000000..c4053491 --- /dev/null +++ b/app/src/messages/cache/messages-cache.service.spec.ts @@ -0,0 +1,72 @@ +import { ConfigService } from '@nestjs/config'; +import { describe, expect, it, vi } from 'vitest'; +import type { AppConfig } from '../../config/app-config.schema.js'; +import type { RedisClient } from '../../redis/redis.client.js'; +import { MessagesCacheService } from './messages-cache.service.js'; +import { MetricsService } from '../../metrics/metrics.service.js'; + +function serviceWithRedis(redis: Partial): MessagesCacheService { + const config = new ConfigService({ + CACHE_MODE: 'protected', + CACHE_LOCK_TTL_MS: 1000, + CACHE_TTL_SECONDS: 30, + CACHE_MISS_DELAY_MS: 0, + }); + return new MessagesCacheService( + redis as RedisClient, + config, + new MetricsService(), + ); +} + +describe('MessagesCacheService fallback', () => { + it('loads from the authoritative source when Redis read fails', async () => { + const load = vi + .fn() + .mockResolvedValue({ items: [{ id: 'db' }], next_cursor: null }); + const service = serviceWithRedis({ + get: vi.fn().mockRejectedValue(new Error('redis down')), + }); + + await expect( + service.getOrLoad('chat', 1n, undefined, 50, load), + ).resolves.toEqual({ + items: [{ id: 'db' }], + next_cursor: null, + }); + expect(load).toHaveBeenCalledOnce(); + }); + + it('falls back after bounded lock contention', async () => { + const load = vi + .fn() + .mockResolvedValue({ items: [{ id: 'db' }], next_cursor: null }); + const service = serviceWithRedis({ + get: vi.fn().mockResolvedValue(null), + setNxPx: vi.fn().mockResolvedValue(false), + }); + + await expect( + service.getOrLoad('chat', 1n, undefined, 50, load), + ).resolves.toEqual({ + items: [{ id: 'db' }], + next_cursor: null, + }); + expect(load).toHaveBeenCalledOnce(); + }); + + it('returns the authoritative page when cache write fails', async () => { + const page = { items: [{ id: 'db' }], next_cursor: null }; + const load = vi.fn().mockResolvedValue(page); + const service = serviceWithRedis({ + get: vi.fn().mockResolvedValue(null), + setNxPx: vi.fn().mockResolvedValue(true), + set: vi.fn().mockRejectedValue(new Error('redis down')), + unlock: vi.fn().mockResolvedValue(1), + }); + + await expect( + service.getOrLoad('chat', 1n, undefined, 50, load), + ).resolves.toEqual(page); + }); +}); diff --git a/app/src/messages/cache/messages-cache.service.ts b/app/src/messages/cache/messages-cache.service.ts new file mode 100644 index 00000000..c41f5e49 --- /dev/null +++ b/app/src/messages/cache/messages-cache.service.ts @@ -0,0 +1,207 @@ +import { Injectable, Logger } from '@nestjs/common'; +import { ConfigService } from '@nestjs/config'; +import { setTimeout as delay } from 'node:timers/promises'; +import type { AppConfig } from '../../config/app-config.schema.js'; +import { RedisClient } from '../../redis/redis.client.js'; +import { MetricsService } from '../../metrics/metrics.service.js'; + +const LOCK_RETRY_COUNT = 4; +const LOCK_RETRY_DELAY_MS = 25; + +export type CachePage = { + items: unknown[]; + next_cursor: string | null; +}; + +@Injectable() +export class MessagesCacheService { + private readonly logger = new Logger(MessagesCacheService.name); + + constructor( + private readonly redis: RedisClient, + private readonly config: ConfigService, + private readonly metrics: MetricsService, + ) {} + + async getOrLoad( + chatId: string, + version: bigint, + cursor: string | undefined, + limit: number, + loader: () => Promise, + ): Promise { + const key = this.cacheKey(chatId, version, cursor, limit); + if (this.config.getOrThrow('CACHE_MODE') === 'naive') { + return this.loadNaively(key, loader); + } + + let cached: string | null; + try { + cached = await this.redis.get(key); + } catch (error) { + return this.fallbackToDatabase('read', error, loader); + } + const cachedPage = this.parsePage(cached); + if (cachedPage) { + this.metrics.increment('cache_hit'); + return cachedPage; + } + this.metrics.increment('cache_miss'); + + const lockKey = `lock:${key}`; + const owner = `${process.pid}:${Math.random().toString(36).slice(2)}`; + for (let attempt = 0; attempt < LOCK_RETRY_COUNT; attempt += 1) { + let locked: boolean; + try { + locked = await this.redis.setNxPx( + lockKey, + owner, + this.config.getOrThrow('CACHE_LOCK_TTL_MS'), + ); + } catch (error) { + return this.fallbackToDatabase('lock', error, loader); + } + if (locked) return this.fillLocked(key, lockKey, owner, loader); + + if (attempt === 0) this.metrics.increment('cache_lock_wait'); + try { + const waitedPage = this.parsePage(await this.redis.get(key)); + if (waitedPage) { + this.metrics.increment('cache_hit'); + return waitedPage; + } + } catch (error) { + return this.fallbackToDatabase('waiting read', error, loader); + } + await delay(LOCK_RETRY_DELAY_MS); + } + + // The owner did not publish the page within the bounded wait: serve the + // authoritative result instead of blocking the request further. + this.metrics.increment('cache_lock_timeout'); + return loader(); + } + + private async fillLocked( + key: string, + lockKey: string, + owner: string, + loader: () => Promise, + ): Promise { + try { + let secondCheck: string | null; + try { + secondCheck = await this.redis.get(key); + } catch (error) { + return this.fallbackToDatabase('double-check', error, loader); + } + const secondPage = this.parsePage(secondCheck); + if (secondPage) { + this.metrics.increment('cache_hit'); + return secondPage; + } + + const page = await loader(); + try { + await this.redis.set(key, JSON.stringify(page), { + EX: this.config.getOrThrow('CACHE_TTL_SECONDS'), + }); + } catch (error) { + // Redis is derived state: the page is still valid for this response, + // but the failure must stay visible in metrics and logs. + this.metrics.increment('cache_write_error'); + this.logger.warn( + `Cache fill failed: ${error instanceof Error ? error.message : 'unknown error'}`, + ); + } + return page; + } finally { + try { + await this.redis.unlock(lockKey, owner); + } catch (error) { + // The lock has a TTL, so a stale lock expires on its own; a successful + // response must not be replaced by an unlock failure. + this.metrics.increment('cache_unlock_error'); + this.logger.warn( + `Cache unlock failed: ${error instanceof Error ? error.message : 'unknown error'}`, + ); + } + } + } + + private cacheKey( + chatId: string, + version: bigint, + cursor: string | undefined, + limit: number, + ): string { + return `messages:${chatId}:v${version.toString()}:c${cursor ?? 'start'}:l${limit}`; + } + + private async loadNaively( + key: string, + loader: () => Promise, + ): Promise { + let cached: string | null; + try { + cached = await this.redis.get(key); + } catch (error) { + return this.fallbackToDatabase('naive read', error, loader); + } + const cachedPage = this.parsePage(cached); + if (cachedPage) { + this.metrics.increment('cache_hit'); + return cachedPage; + } + this.metrics.increment('cache_miss'); + + const cacheMissDelay = this.config.getOrThrow('CACHE_MISS_DELAY_MS'); + if (cacheMissDelay > 0) await delay(cacheMissDelay); + const page = await loader(); + try { + await this.redis.set(key, JSON.stringify(page), { + EX: this.config.getOrThrow('CACHE_TTL_SECONDS'), + }); + } catch (error) { + this.metrics.increment('cache_write_error'); + this.logger.warn( + `Cache fill failed: ${error instanceof Error ? error.message : 'unknown error'}`, + ); + } + return page; + } + + private async fallbackToDatabase( + stage: string, + error: unknown, + loader: () => Promise, + ): Promise { + this.metrics.increment('cache_fallback'); + this.logger.warn( + `Cache ${stage} failed, serving PostgreSQL: ${error instanceof Error ? error.message : 'unknown error'}`, + ); + return loader(); + } + + private parsePage(value: string | null): CachePage | undefined { + if (!value) return undefined; + try { + const parsed: unknown = JSON.parse(value); + if ( + typeof parsed !== 'object' || + parsed === null || + !('items' in parsed) || + !('next_cursor' in parsed) || + !Array.isArray(parsed.items) || + (parsed.next_cursor !== null && + typeof parsed.next_cursor !== 'string') + ) + return undefined; + return { items: parsed.items, next_cursor: parsed.next_cursor }; + } catch { + // A malformed entry is treated as a miss and overwritten by the owner fill. + this.metrics.increment('cache_corrupt_entry'); + return undefined; + } + } +} diff --git a/app/src/messages/dto/create-message.dto.ts b/app/src/messages/dto/create-message.dto.ts index a6cf1d1f..875a3c22 100644 --- a/app/src/messages/dto/create-message.dto.ts +++ b/app/src/messages/dto/create-message.dto.ts @@ -1,7 +1,7 @@ import { IsString, Length } from 'class-validator'; export class CreateMessageDto { - @IsString() - @Length(1, 4000) - text!: string; + @IsString() + @Length(1, 4000) + text!: string; } diff --git a/app/src/messages/message.ts b/app/src/messages/message.ts index e032cf34..1fd5bfe8 100644 --- a/app/src/messages/message.ts +++ b/app/src/messages/message.ts @@ -1,7 +1,7 @@ export type Message = { - id: string; - chat_id: string; - sender_id: string; - text: string; - created_at: string; + id: string; + chat_id: string; + sender_id: string; + text: string; + created_at: string; }; diff --git a/app/src/messages/messages.controller.ts b/app/src/messages/messages.controller.ts index a6eb956b..7f0425b5 100644 --- a/app/src/messages/messages.controller.ts +++ b/app/src/messages/messages.controller.ts @@ -1,55 +1,46 @@ import { - BadRequestException, - Body, - Controller, - DefaultValuePipe, - Get, - Param, - ParseIntPipe, - ParseUUIDPipe, - Post, - Query, - Req, - UseGuards, + BadRequestException, + Body, + Controller, + DefaultValuePipe, + Get, + Param, + ParseIntPipe, + ParseUUIDPipe, + Post, + Query, + UseGuards, } from '@nestjs/common'; -import type { FastifyRequest } from 'fastify'; +import { CurrentUser } from '../common/auth/current-user.decorator.js'; import { CurrentUserGuard } from '../common/auth/current-user.guard.js'; -import type { RequestWithCurrentUser } from '../common/auth/current-user.guard.js'; +import type { User } from '../users/user.js'; import { CreateMessageDto } from './dto/create-message.dto.js'; import { MessagesService } from './messages.service.js'; -type MessageRequest = FastifyRequest & RequestWithCurrentUser; - @Controller('api/v1/chats/:chatId/messages') @UseGuards(CurrentUserGuard) export class MessagesController { - constructor(private readonly messagesService: MessagesService) {} + constructor(private readonly messagesService: MessagesService) {} - @Post() - create( - @Param('chatId', new ParseUUIDPipe()) chatId: string, - @Body() body: CreateMessageDto, - @Req() request: MessageRequest, - ) { - return this.messagesService.create(chatId, body, request.currentUser!); - } + @Post() + create( + @Param('chatId', new ParseUUIDPipe()) chatId: string, + @Body() body: CreateMessageDto, + @CurrentUser() currentUser: User, + ) { + return this.messagesService.create(chatId, body, currentUser); + } - @Get() - list( - @Param('chatId', new ParseUUIDPipe()) chatId: string, - @Req() request: MessageRequest, - @Query('limit', new DefaultValuePipe(50), new ParseIntPipe()) limit: number, - @Query('cursor') cursor?: string, - ) { - if (limit < 1 || limit > 100) { - throw new BadRequestException('limit must be between 1 and 100'); - } - - return this.messagesService.list( - chatId, - request.currentUser!, - limit, - cursor, - ); - } + @Get() + list( + @Param('chatId', new ParseUUIDPipe()) chatId: string, + @CurrentUser() currentUser: User, + @Query('limit', new DefaultValuePipe(50), new ParseIntPipe()) + limit: number, + @Query('cursor') cursor?: string, + ) { + if (limit < 1 || limit > 100) + throw new BadRequestException('limit must be between 1 and 100'); + return this.messagesService.list(chatId, currentUser, limit, cursor); + } } diff --git a/app/src/messages/messages.module.ts b/app/src/messages/messages.module.ts index 96518e61..f4035dfa 100644 --- a/app/src/messages/messages.module.ts +++ b/app/src/messages/messages.module.ts @@ -1,13 +1,24 @@ import { Module } from '@nestjs/common'; +import { DatabaseModule } from '../database/database.module.js'; import { ChatsModule } from '../chats/chats.module.js'; -import { UsersModule } from '../users/users.module.js'; import { MessagesController } from './messages.controller.js'; import { MessagesRepository } from './messages.repository.js'; import { MessagesService } from './messages.service.js'; +import { MessagesCacheModule } from './cache/messages-cache.module.js'; +import { UsersModule } from '../users/users.module.js'; +import { RedisModule } from '../redis/redis.module.js'; +import { MetricsModule } from '../metrics/metrics.module.js'; @Module({ - imports: [UsersModule, ChatsModule], - controllers: [MessagesController], - providers: [MessagesRepository, MessagesService], + imports: [ + ChatsModule, + MessagesCacheModule, + DatabaseModule, + UsersModule, + RedisModule, + MetricsModule, + ], + controllers: [MessagesController], + providers: [MessagesRepository, MessagesService], }) export class MessagesModule {} diff --git a/app/src/messages/messages.repository.spec.ts b/app/src/messages/messages.repository.spec.ts index 834dd873..ff217026 100644 --- a/app/src/messages/messages.repository.spec.ts +++ b/app/src/messages/messages.repository.spec.ts @@ -1,42 +1,47 @@ -import { describe, expect, it } from 'vitest'; +import { describe, expect, it, vi } from 'vitest'; import type { Cursor } from '../common/http/cursor.js'; import type { Message } from './message.js'; import { MessagesRepository } from './messages.repository.js'; const message = (id: string, created_at: string): Message => ({ - id, - chat_id: 'chat', - sender_id: 'sender', - text: id, - created_at, + id, + chat_id: 'chat', + sender_id: 'sender', + text: id, + created_at, }); describe('MessagesRepository', () => { - it('appends messages whose key is after the current tail', () => { - const repository = new MessagesRepository(); - repository.save(message('1', '2026-01-01T00:00:00.000Z')); - repository.save(message('2', '2026-01-01T00:00:01.000Z')); + it('uses named SQL history and a keyset cursor', async () => { + const query = vi.fn().mockResolvedValue({ rows: [], rowCount: 0 }); + const repository = new MessagesRepository({ + query, + withTransaction: vi.fn(), + } as never); + const cursor: Cursor = { + scope: 'messages:chat', + created_at: '2026-01-01T00:00:01.000Z', + id: '1', + }; + await repository.findPage('chat', 10, cursor); + expect(query).toHaveBeenCalledWith( + 'messages.history', + expect.stringContaining('(created_at, id) >'), + expect.arrayContaining(['chat', cursor.created_at, cursor.id, 11]), + ); + }); - expect(repository.findByChatId('chat').map((item) => item.id)).toEqual([ - '1', - '2', - ]); - }); - - it('keeps key order for delayed out-of-order messages', () => { - const repository = new MessagesRepository(); - repository.save(message('2', '2026-01-01T00:00:02.000Z')); - repository.save(message('1', '2026-01-01T00:00:01.000Z')); - repository.save(message('3', '2026-01-01T00:00:03.000Z')); - - const messages = repository.findByChatId('chat'); - expect(messages.map((item) => item.id)).toEqual(['1', '2', '3']); - - const cursor: Cursor = { - scope: 'messages:chat', - created_at: '2026-01-01T00:00:01.000Z', - id: '1', - }; - expect(repository.findFirstAfter('chat', cursor)).toBe(1); - }); + it('returns rows in response shape', async () => { + const query = vi + .fn() + .mockResolvedValue({ + rows: [message('1', '2026-01-01T00:00:00.000Z')], + rowCount: 1, + }); + const repository = new MessagesRepository({ query } as never); + await expect(repository.findPage('chat', 1)).resolves.toEqual({ + items: [message('1', '2026-01-01T00:00:00.000Z')], + hasMore: false, + }); + }); }); diff --git a/app/src/messages/messages.repository.ts b/app/src/messages/messages.repository.ts index fe6a4956..7427b28f 100644 --- a/app/src/messages/messages.repository.ts +++ b/app/src/messages/messages.repository.ts @@ -1,68 +1,93 @@ -import { Injectable } from '@nestjs/common'; +import { + BadRequestException, + Injectable, + NotFoundException, +} from '@nestjs/common'; +import { randomUUID } from 'node:crypto'; +import { DatabaseClient } from '../database/database.client.js'; import type { Cursor } from '../common/http/cursor.js'; -import { isAfter } from '../common/http/cursor.js'; +import type { User } from '../users/user.js'; import type { Message } from './message.js'; +type MessageRow = { + id: string; + chat_id: string; + sender_id: string; + text: string; + created_at: Date | string; +}; + +function toMessage(row: MessageRow): Message { + return { + id: row.id, + chat_id: row.chat_id, + sender_id: row.sender_id, + text: row.text, + created_at: new Date(row.created_at).toISOString(), + }; +} + @Injectable() export class MessagesRepository { - private readonly messagesByChatId = new Map(); + constructor(private readonly database: DatabaseClient) {} - save(message: Message): void { - const messages = this.messagesByChatId.get(message.chat_id) ?? []; - const last = messages.at(-1); + async create( + chatId: string, + senderId: string, + text: string, + ): Promise { + const id = randomUUID(); + return this.database.withTransaction(async (client) => { + const membership = await client.query({ + name: 'messages.checkMembership', + text: 'SELECT 1 FROM chat_members WHERE chat_id = $1 AND user_id = $2', + values: [chatId, senderId], + }); + if (!membership.rowCount) throw new NotFoundException(); + const result = await client.query({ + name: 'messages.insert', + text: 'INSERT INTO messages (id, chat_id, sender_id, text) VALUES ($1, $2, $3, $4) RETURNING id, chat_id, sender_id, text, created_at', + values: [id, chatId, senderId, text], + }); + await client.query({ + name: 'messages.incrementVersion', + text: 'UPDATE chats SET message_version = message_version + 1 WHERE id = $1', + values: [chatId], + }); + return toMessage(result.rows[0]); + }); + } - if ( - !last || - last.created_at < message.created_at || - (last.created_at === message.created_at && last.id < message.id) - ) { - messages.push(message); - this.messagesByChatId.set(message.chat_id, messages); - return; - } + async getVersion(chatId: string, userId: string): Promise { + const result = await this.database.query<{ message_version: string }>( + 'messages.version', + 'SELECT c.message_version FROM chats c WHERE c.id = $1 AND EXISTS (SELECT 1 FROM chat_members WHERE chat_id = c.id AND user_id = $2)', + [chatId, userId], + ); + if (!result.rows[0]) throw new NotFoundException(); + return BigInt(result.rows[0].message_version); + } - // Preserve keyset order if a delayed request carries an older key. - let low = 0; - let high = messages.length; - - while (low < high) { - const middle = Math.floor((low + high) / 2); - const current = messages[middle]; - const comesAfter = - current.created_at > message.created_at || - (current.created_at === message.created_at && current.id > message.id); - - if (comesAfter) high = middle; - else low = middle + 1; - } - - messages.splice(low, 0, message); - this.messagesByChatId.set(message.chat_id, messages); - } - - findByChatId(chatId: string): Message[] { - return this.messagesByChatId.get(chatId) ?? []; - } - - findFirstAfter(chatId: string, cursor: Cursor): number { - const messages = this.messagesByChatId.get(chatId) ?? []; - if (process.env.BENCHMARK_CURSOR_SEARCH === 'linear') { - return messages.findIndex((message) => - isAfter(message.created_at, message.id, cursor), - ); - } - - let low = 0; - let high = messages.length; - while (low < high) { - const middle = Math.floor((low + high) / 2); - if (isAfter(messages[middle].created_at, messages[middle].id, cursor)) { - high = middle; - } else { - low = middle + 1; - } - } - - return low; - } + async findPage( + chatId: string, + limit: number, + cursor?: Cursor, + ): Promise<{ items: Message[]; hasMore: boolean }> { + const values: unknown[] = [chatId]; + let predicate = ''; + if (cursor) { + values.push(cursor.created_at, cursor.id); + predicate = 'AND (created_at, id) > ($2::timestamptz, $3::uuid)'; + } + values.push(limit + 1); + const result = await this.database.query( + 'messages.history', + `SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = $1 ${predicate} ORDER BY created_at, id LIMIT $${values.length}`, + values, + ); + return { + items: result.rows.slice(0, limit).map(toMessage), + hasMore: result.rows.length > limit, + }; + } } diff --git a/app/src/messages/messages.service.ts b/app/src/messages/messages.service.ts index b2523a85..3db1128b 100644 --- a/app/src/messages/messages.service.ts +++ b/app/src/messages/messages.service.ts @@ -1,75 +1,75 @@ -import { - BadRequestException, - Injectable, -} from '@nestjs/common'; -import { randomUUID } from 'node:crypto'; +import { BadRequestException, Injectable } from '@nestjs/common'; import { decodeCursor, encodeCursor } from '../common/http/cursor.js'; import type { User } from '../users/user.js'; import { ChatsService } from '../chats/chats.service.js'; import type { CreateMessageDto } from './dto/create-message.dto.js'; import type { Message } from './message.js'; import { MessagesRepository } from './messages.repository.js'; +import { MessagesCacheService } from './cache/messages-cache.service.js'; @Injectable() export class MessagesService { - constructor( - private readonly messagesRepository: MessagesRepository, - private readonly chatsService: ChatsService, - ) {} + constructor( + private readonly messagesRepository: MessagesRepository, + private readonly chatsService: ChatsService, + private readonly cache: MessagesCacheService, + ) {} - create( - chatId: string, - input: CreateMessageDto, - currentUser: User, - ): Message { - const chat = this.chatsService.getForUser(chatId, currentUser); + async create( + chatId: string, + input: CreateMessageDto, + currentUser: User, + ): Promise { + await this.chatsService.getForUser(chatId, currentUser); + if ([...input.text].every((character) => /\s/u.test(character))) + throw new BadRequestException('Message text cannot be blank'); + return this.messagesRepository.create( + chatId, + currentUser.id, + input.text, + ); + } - if ([...input.text].every((character) => /\s/u.test(character))) { - throw new BadRequestException('Message text cannot be blank'); - } - - const message: Message = { - id: randomUUID(), - chat_id: chat.id, - sender_id: currentUser.id, - text: input.text, - created_at: new Date().toISOString(), - }; - - this.messagesRepository.save(message); - return message; - } - - list( - chatId: string, - currentUser: User, - limit: number, - cursorValue?: string, - ): { items: Message[]; next_cursor: string | null } { - this.chatsService.getForUser(chatId, currentUser); - - const scope = `messages:${chatId}`; - const cursor = cursorValue - ? decodeCursor(cursorValue, scope) - : undefined; - const messages = this.messagesRepository.findByChatId(chatId); - const start = cursor - ? this.messagesRepository.findFirstAfter(chatId, cursor) - : 0; - const items = messages.slice(start, start + limit); - const hasMore = messages.length > start + limit; - const last = items.at(-1); - - return { - items, - next_cursor: - hasMore && last - ? encodeCursor({ - scope, - created_at: last.created_at, - id: last.id, - }) - : null, - }; - } + async list( + chatId: string, + currentUser: User, + limit: number, + cursorValue?: string, + ): Promise<{ items: Message[]; next_cursor: string | null }> { + await this.chatsService.getForUser(chatId, currentUser); + const scope = `messages:${chatId}`; + const cursor = cursorValue + ? decodeCursor(cursorValue, scope) + : undefined; + const version = await this.messagesRepository.getVersion( + chatId, + currentUser.id, + ); + const page = await this.cache.getOrLoad( + chatId, + version, + cursorValue, + limit, + async () => { + const loaded = await this.messagesRepository.findPage( + chatId, + limit, + cursor, + ); + const lastLoaded = loaded.items.at(-1); + return { + items: loaded.items, + next_cursor: + loaded.hasMore && lastLoaded + ? encodeCursor({ + scope, + created_at: lastLoaded.created_at, + id: lastLoaded.id, + }) + : null, + }; + }, + ); + return page as { items: Message[]; next_cursor: string | null }; + } } diff --git a/app/src/metrics/metrics.controller.ts b/app/src/metrics/metrics.controller.ts new file mode 100644 index 00000000..a5474786 --- /dev/null +++ b/app/src/metrics/metrics.controller.ts @@ -0,0 +1,43 @@ +import { + Controller, + Get, + Headers, + HttpCode, + HttpStatus, + Post, + UnauthorizedException, +} from '@nestjs/common'; +import { ConfigService } from '@nestjs/config'; +import type { AppConfig } from '../config/app-config.schema.js'; +import { MetricsService } from './metrics.service.js'; + +@Controller('internal') +export class MetricsController { + constructor( + private readonly config: ConfigService, + private readonly metrics: MetricsService, + ) {} + + @Get('metrics') + get(@Headers('authorization') authorization?: string) { + this.requireToken(authorization); + return this.metrics.snapshot(); + } + + @Post('metrics/reset') + @HttpCode(HttpStatus.OK) + reset(@Headers('authorization') authorization?: string): { status: 'ok' } { + this.requireToken(authorization); + this.metrics.reset(); + return { status: 'ok' }; + } + + private requireToken(authorization?: string): void { + const token = this.config.get('METRICS_TOKEN'); + if (!token || authorization !== `Bearer ${token}`) + throw new UnauthorizedException({ + message: 'Unauthorized', + challenge: 'Bearer realm="metrics"', + }); + } +} diff --git a/app/src/metrics/metrics.module.ts b/app/src/metrics/metrics.module.ts new file mode 100644 index 00000000..3e945a56 --- /dev/null +++ b/app/src/metrics/metrics.module.ts @@ -0,0 +1,10 @@ +import { Module } from '@nestjs/common'; +import { MetricsController } from './metrics.controller.js'; +import { MetricsService } from './metrics.service.js'; + +@Module({ + controllers: [MetricsController], + providers: [MetricsService], + exports: [MetricsService], +}) +export class MetricsModule {} diff --git a/app/src/metrics/metrics.service.spec.ts b/app/src/metrics/metrics.service.spec.ts new file mode 100644 index 00000000..2b5e5017 --- /dev/null +++ b/app/src/metrics/metrics.service.spec.ts @@ -0,0 +1,62 @@ +import { describe, expect, it } from 'vitest'; +import { MetricsService } from './metrics.service.js'; + +describe('MetricsService', () => { + it('computes nearest-rank percentiles from observed latencies', () => { + const metrics = new MetricsService(); + metrics.increment('cache_hit'); + metrics.increment('cache_hit'); + metrics.observeLatency(30); + metrics.observeLatency(10); + metrics.observeLatency(20); + expect(metrics.snapshot()).toEqual({ + counters: { cache_hit: 2 }, + latency_ms: { + count: 3, + sample_count: 3, + p50: 20, + p95: 30, + p99: 30, + max: 30, + }, + }); + }); + + it('keeps snapshots isolated from callers and later observations', () => { + const metrics = new MetricsService(); + metrics.increment('cache_hit'); + const snapshot = metrics.snapshot(); + snapshot.counters.cache_hit = 99; + metrics.increment('cache_hit'); + expect(metrics.snapshot().counters.cache_hit).toBe(2); + expect(snapshot.latency_ms.count).toBe(0); + }); + + it('bounds retained samples but keeps cumulative count and maximum', () => { + const metrics = new MetricsService(); + metrics.observeLatency(9000); + for (let index = 0; index < 4096; index += 1) + metrics.observeLatency(10); + expect(metrics.snapshot().latency_ms).toEqual({ + count: 4097, + sample_count: 4096, + p50: 10, + p95: 10, + p99: 10, + max: 9000, + }); + }); + + it('ignores invalid latency observations', () => { + const metrics = new MetricsService(); + for (const value of [-1, NaN, Infinity]) metrics.observeLatency(value); + expect(metrics.snapshot().latency_ms).toEqual({ + count: 0, + sample_count: 0, + p50: 0, + p95: 0, + p99: 0, + max: 0, + }); + }); +}); diff --git a/app/src/metrics/metrics.service.ts b/app/src/metrics/metrics.service.ts new file mode 100644 index 00000000..bf54a994 --- /dev/null +++ b/app/src/metrics/metrics.service.ts @@ -0,0 +1,69 @@ +import { Injectable } from '@nestjs/common'; + +const LATENCY_SAMPLE_CAPACITY = 4096; + +type LatencySnapshot = { + count: number; + sample_count: number; + p50: number; + p95: number; + p99: number; + max: number; +}; + +@Injectable() +export class MetricsService { + private readonly counters: Record = {}; + private readonly latencies: number[] = []; + private latencyCount = 0; + private maximumLatency = 0; + private nextSample = 0; + + increment(name: string): void { + this.counters[name] = (this.counters[name] ?? 0) + 1; + } + + observeLatency(milliseconds: number): void { + if (!Number.isFinite(milliseconds) || milliseconds < 0) return; + this.latencyCount += 1; + this.maximumLatency = Math.max(this.maximumLatency, milliseconds); + this.latencies[this.nextSample] = milliseconds; + this.nextSample = (this.nextSample + 1) % LATENCY_SAMPLE_CAPACITY; + } + + snapshot(): { + counters: Record; + latency_ms: LatencySnapshot; + } { + const sorted = [...this.latencies].sort((left, right) => left - right); + return { + counters: { ...this.counters }, + latency_ms: { + count: this.latencyCount, + sample_count: sorted.length, + p50: this.percentile(sorted, 0.5), + p95: this.percentile(sorted, 0.95), + p99: this.percentile(sorted, 0.99), + max: this.maximumLatency, + }, + }; + } + + reset(): void { + for (const name of Object.keys(this.counters)) + delete this.counters[name]; + this.latencies.length = 0; + this.latencyCount = 0; + this.maximumLatency = 0; + this.nextSample = 0; + } + + private percentile(sorted: number[], percentile: number): number { + if (sorted.length === 0) return 0; + const index = Math.min( + sorted.length - 1, + Math.ceil(sorted.length * percentile) - 1, + ); + return sorted[index]; + } +} diff --git a/app/src/redis/redis.client.ts b/app/src/redis/redis.client.ts new file mode 100644 index 00000000..911d3d32 --- /dev/null +++ b/app/src/redis/redis.client.ts @@ -0,0 +1,134 @@ +import { Injectable, Logger, OnModuleDestroy, OnModuleInit } from '@nestjs/common'; +import { ConfigService } from '@nestjs/config'; +import { createClient, type RedisClientType } from 'redis'; +import type { AppConfig } from '../config/app-config.schema.js'; +import { MetricsService } from '../metrics/metrics.service.js'; + +const UNLOCK_SCRIPT = + 'if redis.call("get", KEYS[1]) == ARGV[1] then return redis.call("del", KEYS[1]) else return 0 end'; +type Client = RedisClientType; + +@Injectable() +export class RedisClient implements OnModuleInit, OnModuleDestroy { + readonly client: Client; + private readonly logger = new Logger(RedisClient.name); + + constructor( + private readonly config: ConfigService, + private readonly metrics: MetricsService, + ) { + this.client = createClient({ + url: this.config.getOrThrow('REDIS_URL'), + disableOfflineQueue: true, + socket: { + reconnectStrategy: (attempt) => + Math.min(1000 + attempt * 250, 5000), + connectTimeout: 5000, + }, + }) as Client; + // Reconnect failures must be visible; the readiness probe pings Redis. + this.client.on('error', (error: Error) => { + this.metrics.increment('redis.error'); + this.logger.warn(`Redis error: ${error.message}`); + }); + } + + async onModuleInit(): Promise { + await this.client.connect(); + } + + async onModuleDestroy(): Promise { + if (this.client.isOpen) await this.client.quit(); + } + + async health(): Promise { + this.metrics.increment('redis.ping'); + await this.client.ping(); + } + + async get(key: string): Promise { + this.metrics.increment('redis.get'); + return this.client.get(key); + } + + async set( + key: string, + value: string, + options?: { EX?: number; PX?: number; NX?: boolean }, + ): Promise { + this.metrics.increment('redis.set'); + return this.client.set(key, value, options); + } + + async setNxEx( + key: string, + value: string, + seconds: number, + ): Promise { + this.metrics.increment('redis.set'); + return ( + (await this.client.set(key, value, { NX: true, EX: seconds })) === + 'OK' + ); + } + + async setNxPx( + key: string, + value: string, + milliseconds: number, + ): Promise { + this.metrics.increment('redis.set'); + return ( + (await this.client.set(key, value, { + NX: true, + PX: milliseconds, + })) === 'OK' + ); + } + + async del(key: string): Promise { + this.metrics.increment('redis.del'); + return this.client.del(key); + } + + async incr(key: string): Promise { + this.metrics.increment('redis.incr'); + return this.client.incr(key); + } + + async expire(key: string, seconds: number): Promise { + this.metrics.increment('redis.expire'); + return (await this.client.expire(key, seconds)) === 1; + } + + async scan( + cursor: number, + pattern?: string, + count = 100, + ): Promise<{ cursor: number; keys: string[] }> { + this.metrics.increment('redis.scan'); + const result = await this.client.scan(String(cursor), { + MATCH: pattern, + COUNT: count, + }); + return { cursor: Number(result.cursor), keys: result.keys }; + } + + async unlock(key: string, owner: string): Promise { + this.metrics.increment('redis.unlock'); + return Number( + await this.client.eval(UNLOCK_SCRIPT, { + keys: [key], + arguments: [owner], + }), + ); + } + + pipeline(commands: Array<[string, ...string[]]>): Promise { + this.metrics.increment('redis.pipeline'); + const multi = this.client.multi(); + for (const [command, ...args] of commands) + multi.addCommand([command, ...args]); + return multi.exec(); + } +} diff --git a/app/src/redis/redis.module.ts b/app/src/redis/redis.module.ts new file mode 100644 index 00000000..74464f56 --- /dev/null +++ b/app/src/redis/redis.module.ts @@ -0,0 +1,10 @@ +import { Module } from '@nestjs/common'; +import { MetricsModule } from '../metrics/metrics.module.js'; +import { RedisClient } from './redis.client.js'; + +@Module({ + imports: [MetricsModule], + providers: [RedisClient], + exports: [RedisClient], +}) +export class RedisModule {} diff --git a/app/src/users/dto/create-user.dto.ts b/app/src/users/dto/create-user.dto.ts index 428760fb..fbbe6da3 100644 --- a/app/src/users/dto/create-user.dto.ts +++ b/app/src/users/dto/create-user.dto.ts @@ -1,11 +1,18 @@ -import { IsNotEmpty, IsString, Matches } from 'class-validator'; +import { IsString, Length, Matches } from 'class-validator'; export class CreateUserDTO { @IsString() @Matches(/^[a-z0-9_]{3,32}$/) - username: string; + username!: string; @IsString() - @IsNotEmpty() - display_name: string; + @Length(1, 100) + @Matches(/\S/u, { + message: 'display_name must contain a non-whitespace character', + }) + display_name!: string; + + @IsString() + @Length(12, 128) + password!: string; } diff --git a/app/src/users/users.controller.ts b/app/src/users/users.controller.ts index 59e30d2b..1ab8c777 100644 --- a/app/src/users/users.controller.ts +++ b/app/src/users/users.controller.ts @@ -1,8 +1,9 @@ -import { Body, Controller, Get, Post, Req, UseGuards } from '@nestjs/common'; -import { UsersService } from './users.service.js'; -import { CreateUserDTO } from './dto/create-user.dto.js'; -import type { FastifyRequest } from 'fastify'; +import { Body, Controller, Get, Post, UseGuards } from '@nestjs/common'; +import { CurrentUser } from '../common/auth/current-user.decorator.js'; import { CurrentUserGuard } from '../common/auth/current-user.guard.js'; +import type { User } from './user.js'; +import { CreateUserDTO } from './dto/create-user.dto.js'; +import { UsersService } from './users.service.js'; @Controller('api/v1/users') export class UsersController { @@ -15,7 +16,7 @@ export class UsersController { @Get('/me') @UseGuards(CurrentUserGuard) - getMe(@Req() request: FastifyRequest) { - return request.currentUser; + getMe(@CurrentUser() currentUser: User) { + return currentUser; } } diff --git a/app/src/users/users.module.ts b/app/src/users/users.module.ts index 13738a4e..55a73289 100644 --- a/app/src/users/users.module.ts +++ b/app/src/users/users.module.ts @@ -3,10 +3,14 @@ import { UsersController } from './users.controller.js'; import { UsersRepository } from './users.repository.js'; import { UsersService } from './users.service.js'; import { CurrentUserGuard } from '../common/auth/current-user.guard.js'; +import { RedisModule } from '../redis/redis.module.js'; +import { MetricsModule } from '../metrics/metrics.module.js'; +import { DatabaseModule } from '../database/database.module.js'; @Module({ + imports: [DatabaseModule, RedisModule, MetricsModule], controllers: [UsersController], providers: [UsersRepository, UsersService, CurrentUserGuard], - exports: [UsersService, CurrentUserGuard], + exports: [UsersService, CurrentUserGuard, RedisModule, MetricsModule], }) export class UsersModule {} diff --git a/app/src/users/users.repository.ts b/app/src/users/users.repository.ts index f5a98400..4fbbe865 100644 --- a/app/src/users/users.repository.ts +++ b/app/src/users/users.repository.ts @@ -1,25 +1,71 @@ -import { Injectable } from '@nestjs/common'; -import { User } from './user.js'; +import { ConflictException, Injectable } from '@nestjs/common'; +import { DatabaseClient } from '../database/database.client.js'; +import type { User } from './user.js'; + +type UserRow = { + id: string; + username: string; + display_name: string; + password_hash: string; + created_at: Date | string; +}; + +function toUser(row: UserRow): User { + return { + id: row.id, + username: row.username, + display_name: row.display_name, + created_at: new Date(row.created_at).toISOString(), + }; +} @Injectable() export class UsersRepository { - private readonly usersById = new Map(); - private readonly userIdByUsername = new Map(); + constructor(private readonly database: DatabaseClient) {} - findById(id: string): User | undefined { - return this.usersById.get(id); - } + async findById(id: string): Promise { + const result = await this.database.query( + 'users.findById', + 'SELECT id, username, display_name, password_hash, created_at FROM users WHERE id = $1', + [id], + ); + const row = result.rows[0]; + return row ? toUser(row) : undefined; + } - findByUsername(username: string): User | undefined { - const userId = this.userIdByUsername.get(username); - if (!userId) { - return undefined; - } - return this.usersById.get(userId); - } + async findByUsername( + username: string, + ): Promise<(User & { password_hash: string }) | undefined> { + const result = await this.database.query( + 'users.findByUsername', + 'SELECT id, username, display_name, password_hash, created_at FROM users WHERE username = $1', + [username], + ); + const row = result.rows[0]; + return row + ? { ...toUser(row), password_hash: row.password_hash } + : undefined; + } - save(user: User): void { - this.usersById.set(user.id, user); - this.userIdByUsername.set(user.username, user.id); - } + async create(user: { + id: string; + username: string; + display_name: string; + password_hash: string; + }): Promise { + try { + const result = await this.database.query( + 'users.insert', + `INSERT INTO users (id, username, display_name, password_hash) + VALUES ($1, $2, $3, $4) + RETURNING id, username, display_name, password_hash, created_at`, + [user.id, user.username, user.display_name, user.password_hash], + ); + return toUser(result.rows[0]); + } catch (error) { + if ((error as { code?: string }).code === '23505') + throw new ConflictException('Username already exists'); + throw error; + } + } } diff --git a/app/src/users/users.service.ts b/app/src/users/users.service.ts index 8f2a21fb..341cebe0 100644 --- a/app/src/users/users.service.ts +++ b/app/src/users/users.service.ts @@ -1,45 +1,38 @@ -import { - BadRequestException, - ConflictException, - Injectable, -} from '@nestjs/common'; -import { UsersRepository } from './users.repository.js'; +import { BadRequestException, Injectable } from '@nestjs/common'; +import argon2 from 'argon2'; +import { randomUUID } from 'node:crypto'; import { CreateUserDTO } from './dto/create-user.dto.js'; import { User } from './user.js'; -import { randomUUID } from 'node:crypto'; +import { UsersRepository } from './users.repository.js'; @Injectable() export class UsersService { constructor(private readonly usersRepository: UsersRepository) {} - create(input: CreateUserDTO): User { - const displayNameLength = [...input.display_name].length; - + async create(input: CreateUserDTO): Promise { if ( - displayNameLength < 1 || - displayNameLength > 100 || + [...input.display_name].length < 1 || + [...input.display_name].length > 100 || input.display_name.trim().length === 0 ) { throw new BadRequestException('Invalid display name'); } - - if (this.usersRepository.findByUsername(input.username)) { - throw new ConflictException('Username already exists'); - } - - const user: User = { + const passwordHash = await argon2.hash(input.password, { + type: argon2.argon2id, + }); + return this.usersRepository.create({ id: randomUUID(), username: input.username, display_name: input.display_name, - created_at: new Date().toISOString(), - }; - - this.usersRepository.save(user); - - return user; + password_hash: passwordHash, + }); } - findById(id: string): User | undefined { + findById(id: string): Promise { return this.usersRepository.findById(id); } + + findByUsername(username: string) { + return this.usersRepository.findByUsername(username); + } } diff --git a/app/test/app.e2e-spec.ts b/app/test/app.e2e-spec.ts index dfd1a73f..00270906 100644 --- a/app/test/app.e2e-spec.ts +++ b/app/test/app.e2e-spec.ts @@ -1,313 +1,427 @@ -import { HealthService } from './../src/health/health.service.js'; +import { afterAll, beforeAll, describe, expect, it } from 'vitest'; +import { randomUUID } from 'node:crypto'; +import { setTimeout as sleep } from 'node:timers/promises'; +import { Pool } from 'pg'; +import { createClient } from 'redis'; -import { Test, TestingModule } from '@nestjs/testing'; -import { INestApplication, ValidationPipe } from '@nestjs/common'; -import request from 'supertest'; -import { App } from 'supertest/types'; -import { AppModule } from './../src/app.module.js'; -import { RequestIdInterceptor } from './../src/common/http/request-id.interceptor.js'; -import { ApiExceptionFilter } from './../src/common/errors/api-exception.filter.js'; +// The suite is black-box: run it against the compiled application process. +// Vitest sets process.env.BASE_URL itself (Vite base), so the API URL uses its own name. +const baseUrl = (process.env.API_BASE_URL ?? 'http://localhost:8080').replace( + /\/+$/u, + '', +); +const basicChallenge = 'Basic realm="messenger", charset="UTF-8"'; +const bearerChallenge = 'Bearer realm="messenger"'; +const password = 'integration:пароль🔐'; +const runId = randomUUID().replaceAll('-', '').slice(0, 12); +const usernames: string[] = []; +const tokens: string[] = []; +let sequence = 0; +let database: Pool; +let redis: ReturnType; -describe('Foundation HTTP contract', () => { - let app: INestApplication; +type User = { + id: string; + username: string; + display_name: string; + created_at: string; +}; +type Session = { + token: string; + token_type: string; + expires_at: string; + user: User; +}; +type Chat = { + id: string; + title: string; + member_ids: string[]; + created_at: string; +}; +type Message = { + id: string; + chat_id: string; + sender_id: string; + text: string; + created_at: string; +}; +type Page = { items: T[]; next_cursor: string | null }; +type ApiError = { + error: { code: string; message: string; request_id: string }; +}; +type Actor = { user: User; password: string; token: string }; +type HttpResult = { body: T; response: Response }; - beforeEach(async () => { - const moduleFixture: TestingModule = await Test.createTestingModule({ - imports: [AppModule], - }).compile(); +async function http( + path: string, + init: RequestInit = {}, +): Promise> { + const response = await fetch(`${baseUrl}${path}`, init); + const text = await response.text(); + let body: unknown = undefined; + if (text) { + try { + body = JSON.parse(text); + } catch { + body = text; + } + } + return { body: body as T, response }; +} - app = moduleFixture.createNestApplication(); +function json( + body: unknown, + headers: Record = {}, +): RequestInit { + return { + method: 'POST', + headers: { 'content-type': 'application/json', ...headers }, + body: JSON.stringify(body), + }; +} - app.useGlobalInterceptors(new RequestIdInterceptor()); - app.useGlobalFilters(new ApiExceptionFilter()); - app.useGlobalPipes( - new ValidationPipe({ - whitelist: true, - forbidNonWhitelisted: true, - transform: true, - }), - ); +function basic(username: string, secret: string): string { + return `Basic ${Buffer.from(`${username}:${secret}`, 'utf8').toString('base64')}`; +} - await app.init(); +function bearer(token: string): Record { + return { authorization: `Bearer ${token}` }; +} + +async function register( + displayName = 'Интеграционный пользователь', + secret = password, +): Promise { + const username = `e2e_${runId}_${sequence++}`.slice(0, 32); + usernames.push(username); + const result = await http( + '/api/v1/users', + json({ username, display_name: displayName, password: secret }), + ); + expect(result.response.status).toBe(201); + return result.body; +} + +async function login(user: User, secret = password): Promise { + const result = await http('/api/v1/auth/sessions', { + method: 'POST', + headers: { authorization: basic(user.username, secret) }, }); + expect(result.response.status).toBe(201); + tokens.push(result.body.token); + return result.body; +} - afterEach(async () => { - await app.close(); - }); +async function actor(displayName?: string): Promise { + const user = await register(displayName); + const session = await login(user); + return { user, password, token: session.token }; +} - it('returns liveness status with request id', async () => { - const response = await request(app.getHttpServer()) - .get('/health/live') - .expect(200); +function expectError( + result: HttpResult, + status: number, + code: string, +): void { + expect(result.response.status).toBe(status); + expect(result.body.error.code).toBe(code); + expect(result.body.error.request_id).toBe( + result.response.headers.get('x-request-id'), + ); +} - expect(response.body).toEqual({ status: 'ok' }); - expect(response.headers['x-request-id']).toEqual(expect.any(String)); - expect(response.headers['x-request-id']).not.toHaveLength(0); - }); - - it('returns readiness status with request id', async () => { - const response = await request(app.getHttpServer()) - .get('/health/ready') - .expect(200); - - expect(response.body).toEqual({ status: 'ok' }); - expect(response.headers['x-request-id']).toEqual(expect.any(String)); - }); - - it('keeps liveness alive while readiness is draining', async () => { - app.get(HealthService).setDraining(); - - const liveResponse = await request(app.getHttpServer()) - .get('/health/live') - .expect(200); - expect(liveResponse.body).toEqual({ status: 'ok' }); - - const readyResponse = await request(app.getHttpServer()) - .get('/health/ready') - .expect(503); - const requestId = readyResponse.headers['x-request-id']; - expect(requestId).toEqual(expect.any(String)); - expect(readyResponse.body).toEqual({ - error: { - code: 'unavailable', - message: 'Service is shutting down', - request_id: requestId, - }, - }); - }); - - it('returns contract error with matching request id for unknown route', async () => { - const response = await request(app.getHttpServer()) - .get('/health/unknown') - .expect(404); - - const requestId = response.headers['x-request-id']; - - expect(requestId).toEqual(expect.any(String)); - expect(response.body).toEqual({ - error: { - code: 'not_found', - message: 'Resource not found', - request_id: requestId, - }, +describe('HTTP integration contract', () => { + beforeAll(async () => { + database = new Pool({ + connectionString: process.env.DATABASE_URL, + connectionTimeoutMillis: 5000, }); + redis = createClient({ + url: process.env.REDIS_URL, + socket: { reconnectStrategy: false }, + }); + redis.on('error', () => {}); + await redis.connect(); }); - it('registers a user and returns it from /me', async () => { - const created = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ - username: 'alice', - display_name: 'Алиса', - }) - .expect(201); - - const user = created.body; - - const current = await request(app.getHttpServer()) - .get('/api/v1/users/me') - .set('X-User-Id', user.id) - .expect(200); - - expect(current.body).toEqual(user); + afterAll(async () => { + if (usernames.length) { + await database.query('BEGIN'); + try { + await database.query( + `DELETE FROM messages WHERE sender_id IN (SELECT id FROM users WHERE username = ANY($1::text[]))`, + [usernames], + ); + await database.query( + `DELETE FROM chats WHERE id IN (SELECT chat_id FROM chat_members WHERE user_id IN (SELECT id FROM users WHERE username = ANY($1::text[])))`, + [usernames], + ); + await database.query( + 'DELETE FROM users WHERE username = ANY($1::text[])', + [usernames], + ); + await database.query('COMMIT'); + } catch (error) { + await database.query('ROLLBACK'); + throw error; + } + } + if (redis.isOpen) redis.destroy(); + await database.end(); }); - it('rejects /me without X-User-Id', async () => { - const response = await request(app.getHttpServer()) - .get('/api/v1/users/me') - .expect(401); - - expect(response.body.error.code).toBe('unauthorized'); - expect(response.headers['x-request-id']).toBe( - response.body.error.request_id, + it('serves liveness and requires real session authentication', async () => { + const live = await http<{ status: string }>('/health/live'); + expect(live.response.status).toBe(200); + expect(live.body).toEqual({ status: 'ok' }); + const denied = await http('/api/v1/users/me'); + expectError(denied, 401, 'unauthorized'); + expect(denied.response.headers.get('www-authenticate')).toBe( + bearerChallenge, ); }); - it('rejects duplicate usernames', async () => { - await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ - username: 'duplicate_user', - display_name: 'Первый', - }) - .expect(201); - - const response = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ - username: 'duplicate_user', - display_name: 'Второй', - }) - .expect(409); - - expect(response.body.error.code).toBe('conflict'); + it('registers, logs in with Unicode/colon password, and challenges malformed Basic', async () => { + const user = await register(); + const session = await login(user); + expect(session.user.id).toBe(user.id); + expect(session.token_type).toBe('Bearer'); + const me = await http('/api/v1/users/me', { + headers: bearer(session.token), + }); + expect(me.response.status).toBe(200); + expect(me.body.id).toBe(user.id); + for (const authorization of [ + 'Basic !!!', + 'Basic YWJj', + 'Bearer nope', + ]) { + const result = await http('/api/v1/auth/sessions', { + method: 'POST', + headers: { authorization }, + }); + expectError(result, 401, 'unauthorized'); + expect(result.response.headers.get('www-authenticate')).toBe( + basicChallenge, + ); + } + const bodyResult = await http('/api/v1/auth/sessions', { + ...json({ unexpected: true }), + headers: { authorization: basic(user.username, password) }, + }); + expectError(bodyResult, 400, 'invalid_request'); }); - it('creates a chat and hides it from a non-member', async () => { - const aliceResponse = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ - username: 'alice_chat', - display_name: 'Алиса', - }) - .expect(201); - - const bobResponse = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ - username: 'bob_chat', - display_name: 'Боб', - }) - .expect(201); - - const aliceId = aliceResponse.body.id; - const bobId = bobResponse.body.id; - - const chatResponse = await request(app.getHttpServer()) - .post('/api/v1/chats') - .set('X-User-Id', aliceId) - .send({ - title: 'Учебный чат', - member_ids: [aliceId, bobId], - }) - .expect(201); - - expect(chatResponse.body.member_ids).toEqual([aliceId, bobId]); - - await request(app.getHttpServer()) - .get(`/api/v1/chats/${chatResponse.body.id}`) - .set('X-User-Id', bobId) - .expect(200); - - const outsiderResponse = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ - username: 'charlie_chat', - display_name: 'Чарли', - }) - .expect(201); - - await request(app.getHttpServer()) - .get(`/api/v1/chats/${chatResponse.body.id}`) - .set('X-User-Id', outsiderResponse.body.id) - .expect(404); + it('returns conflict for concurrent duplicate registration', async () => { + const username = `e2e_${runId}_race`.slice(0, 32); + usernames.push(username); + const results = await Promise.all([ + http( + '/api/v1/users', + json({ username, display_name: 'Race A', password }), + ), + http( + '/api/v1/users', + json({ username, display_name: 'Race B', password }), + ), + ]); + expect( + results.filter((item) => item.response.status === 201), + 'duplicate registration must create exactly one user', + ).toHaveLength(1); + expect( + results.filter((item) => item.response.status === 409), + 'loser of the race must receive 409, not 500', + ).toHaveLength(1); + // The database unique index is the race-proof guard, so verify its effect. + const persisted = await database.query<{ count: string }>( + 'SELECT count(*)::text AS count FROM users WHERE username = $1', + [username], + ); + expect(persisted.rows[0]?.count).toBe('1'); }); - it('rejects chat when current user is not in member_ids', async () => { - const aliceResponse = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ - username: 'alice_member', - display_name: 'Алиса', - }) - .expect(201); - - const bobResponse = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ - username: 'bob_member', - display_name: 'Боб', - }) - .expect(201); - - const response = await request(app.getHttpServer()) - .post('/api/v1/chats') - .set('X-User-Id', aliceResponse.body.id) - .send({ - title: 'Неверный чат', - member_ids: [bobResponse.body.id], - }) - .expect(400); - - expect(response.body.error.code).toBe('invalid_request'); + it('uses Bearer only, ignores X-User-Id spoofing, and prevents logout replay', async () => { + const alice = await actor('Алиса'); + const bob = await actor('Боб'); + const spoof = await http('/api/v1/users/me', { + headers: { ...bearer(alice.token), 'x-user-id': bob.user.id }, + }); + expect(spoof.response.status).toBe(200); + expect((spoof.body as unknown as User).id).toBe(alice.user.id); + const basicBusiness = await http('/api/v1/users/me', { + headers: { authorization: basic(alice.user.username, password) }, + }); + expectError(basicBusiness, 401, 'unauthorized'); + expect(basicBusiness.response.headers.get('www-authenticate')).toBe( + bearerChallenge, + ); + const logout = await http('/api/v1/auth/sessions/current', { + method: 'DELETE', + headers: bearer(alice.token), + }); + expect(logout.response.status).toBe(204); + const replay = await http('/api/v1/users/me', { + headers: bearer(alice.token), + }); + expectError(replay, 401, 'unauthorized'); }); - it('paginates chat history without repeating messages', async () => { - const alice = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ username: 'page_alice', display_name: 'Алиса' }) - .expect(201); - const bob = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ username: 'page_bob', display_name: 'Боб' }) - .expect(201); + it('rejects unknown and duplicate chat members and hides chats from outsiders', async () => { + const alice = await actor(); + const bob = await actor(); + const outsider = await actor(); + const unknown = await http( + '/api/v1/chats', + json( + { title: 'unknown', member_ids: [alice.user.id, randomUUID()] }, + bearer(alice.token), + ), + ); + expectError(unknown, 400, 'invalid_request'); + const leaked = await http(`/api/v1/chats?limit=100`, { + headers: bearer(alice.token), + }); + expect(leaked.response.status).toBe(200); + expect( + (leaked.body as unknown as Page).items.some( + (item) => item.title === 'unknown', + ), + ).toBe(false); + const duplicate = await http( + '/api/v1/chats', + json( + { + title: 'duplicate', + member_ids: [alice.user.id, alice.user.id], + }, + bearer(alice.token), + ), + ); + expectError(duplicate, 400, 'invalid_request'); + const created = await http( + '/api/v1/chats', + json( + { + title: `chat-${runId}`, + member_ids: [alice.user.id, bob.user.id], + }, + bearer(alice.token), + ), + ); + expect(created.response.status).toBe(201); + const hidden = await http( + `/api/v1/chats/${created.body.id}`, + { headers: bearer(outsider.token) }, + ); + expectError(hidden, 404, 'not_found'); + }); - const aliceId = alice.body.id; - const bobId = bob.body.id; - const chat = await request(app.getHttpServer()) - .post('/api/v1/chats') - .set('X-User-Id', aliceId) - .send({ title: 'История', member_ids: [aliceId, bobId] }) - .expect(201); + it('keeps sender server-owned and makes writes visible to a second session', async () => { + const alice = await actor(); + const secondSession = (await login(alice.user)).token; + const chat = await http( + '/api/v1/chats', + json( + { title: `messages-${runId}`, member_ids: [alice.user.id] }, + bearer(alice.token), + ), + ); + expect(chat.response.status).toBe(201); + const blank = await http( + `/api/v1/chats/${chat.body.id}/messages`, + json( + { text: ' \n\t', sender_id: randomUUID() }, + bearer(alice.token), + ), + ); + expectError(blank, 400, 'invalid_request'); + const spoof = await http( + `/api/v1/chats/${chat.body.id}/messages`, + json( + { text: 'hello', sender_id: randomUUID() }, + bearer(alice.token), + ), + ); + expectError(spoof, 400, 'invalid_request'); + await http(`/api/v1/chats/${chat.body.id}/messages?limit=50`, { + headers: bearer(secondSession), + }); + const sent = await http( + `/api/v1/chats/${chat.body.id}/messages`, + json({ text: 'hello' }, bearer(alice.token)), + ); + expect(sent.response.status).toBe(201); + expect(sent.body.sender_id).toBe(alice.user.id); + const page = await http>( + `/api/v1/chats/${chat.body.id}/messages?limit=50`, + { headers: bearer(secondSession) }, + ); + expect(page.response.status).toBe(200); + expect(page.body.items.map((item) => item.id)).toContain(sent.body.id); + }); - const createdMessages: Array<{ id: string }> = []; - for (const text of ['one', 'two', 'three']) { - const response = await request(app.getHttpServer()) - .post(`/api/v1/chats/${chat.body.id}/messages`) - .set('X-User-Id', aliceId) - .send({ text }) - .expect(201); - - createdMessages.push(response.body); - } - - const firstPage = await request(app.getHttpServer()) - .get(`/api/v1/chats/${chat.body.id}/messages`) - .query({ limit: 2 }) - .set('X-User-Id', bobId) - .expect(200); - - expect(firstPage.body.items.map((item: { id: string }) => item.id)).toEqual( - createdMessages.slice(0, 2).map((item) => item.id), - ); - expect(firstPage.body.next_cursor).toEqual(expect.any(String)); - - const secondPage = await request(app.getHttpServer()) - .get(`/api/v1/chats/${chat.body.id}/messages`) - .query({ limit: 2, cursor: firstPage.body.next_cursor }) - .set('X-User-Id', bobId) - .expect(200); - - expect(secondPage.body.items.map((item: { id: string }) => item.id)).toEqual( - [createdMessages[2].id], - ); - expect(secondPage.body.next_cursor).toBeNull(); - }); - - it('rejects blank messages and sender spoofing fields', async () => { - const alice = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ username: 'blank_alice', display_name: 'Алиса' }) - .expect(201); - - const chat = await request(app.getHttpServer()) - .post('/api/v1/chats') - .set('X-User-Id', alice.body.id) - .send({ title: 'Проверка', member_ids: [alice.body.id] }) - .expect(201); - - const response = await request(app.getHttpServer()) - .post(`/api/v1/chats/${chat.body.id}/messages`) - .set('X-User-Id', alice.body.id) - .send({ text: ' ', sender_id: 'spoofed' }) - .expect(400); - - expect(response.body.error.code).toBe('invalid_request'); - }); - - it('rejects an invalid cursor and an invalid limit', async () => { - const alice = await request(app.getHttpServer()) - .post('/api/v1/users') - .send({ username: 'cursor_alice', display_name: 'Алиса' }) - .expect(201); - - const response = await request(app.getHttpServer()) - .get('/api/v1/chats') - .query({ limit: 101, cursor: 'not-a-cursor' }) - .set('X-User-Id', alice.body.id) - .expect(400); - - expect(response.body.error.code).toBe('invalid_request'); - }); + it('validates cursor, limits, malformed JSON, and paginates without repeats', async () => { + const alice = await actor(); + const chat = await http( + '/api/v1/chats', + json( + { title: `pages-${runId}`, member_ids: [alice.user.id] }, + bearer(alice.token), + ), + ); + for (const text of ['one', 'two', 'three']) { + const sent = await http( + `/api/v1/chats/${chat.body.id}/messages`, + json({ text }, bearer(alice.token)), + ); + expect(sent.response.status).toBe(201); + } + const invalidLimit = await http( + `/api/v1/chats/${chat.body.id}/messages?limit=101`, + { headers: bearer(alice.token) }, + ); + expectError(invalidLimit, 400, 'invalid_request'); + const invalidCursor = await http( + `/api/v1/chats/${chat.body.id}/messages?cursor=not-a-cursor`, + { headers: bearer(alice.token) }, + ); + expectError(invalidCursor, 400, 'invalid_request'); + const malformed = await http('/api/v1/users', { + method: 'POST', + headers: { 'content-type': 'application/json' }, + body: '{', + }); + expectError(malformed, 400, 'invalid_request'); + const first = await http>( + `/api/v1/chats/${chat.body.id}/messages?limit=2`, + { headers: bearer(alice.token) }, + ); + expect(first.body.items).toHaveLength(2); + const second = await http>( + `/api/v1/chats/${chat.body.id}/messages?limit=2&cursor=${encodeURIComponent(first.body.next_cursor!)}`, + { headers: bearer(alice.token) }, + ); + expect(second.body.items).toHaveLength(1); + expect( + new Set( + [...first.body.items, ...second.body.items].map( + (item) => item.id, + ), + ).size, + ).toBe(3); + }); + it.skipIf(process.env.SESSION_TTL_SECONDS !== '2')( + 'expires sessions with TTL=2', + async () => { + const user = await register(); + const session = await login(user); + await sleep(2300); + const expired = await http('/api/v1/users/me', { + headers: bearer(session.token), + }); + expectError(expired, 401, 'unauthorized'); + }, + ); }); diff --git a/app/vitest.config.e2e.ts b/app/vitest.config.e2e.ts index b5b532cf..e7a3addd 100644 --- a/app/vitest.config.e2e.ts +++ b/app/vitest.config.e2e.ts @@ -2,10 +2,13 @@ import { defineConfig } from 'vitest/config'; import tsconfigPaths from 'vite-tsconfig-paths'; export default defineConfig({ - plugins: [tsconfigPaths()], - test: { - globals: true, - root: './', - include: ['**/*.e2e-spec.ts'], - }, + plugins: [tsconfigPaths()], + test: { + globals: true, + root: './', + include: ['test/app.e2e-spec.ts'], + testTimeout: 30_000, + hookTimeout: 30_000, + sequence: { concurrent: false }, + }, }); diff --git a/bruno/README.md b/bruno/README.md new file mode 100644 index 00000000..69a9d467 --- /dev/null +++ b/bruno/README.md @@ -0,0 +1,98 @@ +# Коллекция Bruno: ручки messenger (lab 2) + +Ручной клиент для API: регистрация, Basic-вход, Bearer-доступ, чаты, сообщения +с пагинацией, метрики и негативные проверки. Формат — стандартный Bruno (`.bru`). + +Связанные документы: [`../REPORT.md`](../REPORT.md) (архитектура и решения), +[`../evidence/README.md`](../evidence/README.md) (индекс доказательств), +[`../.github/pull_request_template.md`](../.github/pull_request_template.md) (сдача). + +## Как открыть и запустить + +```sh +# GUI: Collection -> Open -> выбрать папку bruno/ этого репозитория. +# baseUrl уже подставлен на уровне коллекции (collection.bru), вводить его +# в каждой ручке не нужно. Для реального METRICS_TOKEN выберите окружение +# `local` в правом верхнем углу и поправьте metricsToken. + +# CLI (требуется @usebruno/cli; запускать из корня коллекции): +npm install -g @usebruno/cli +cd bruno +bru run -r --env-var metricsToken=$(grep '^METRICS_TOKEN=' ../.env | cut -d= -f2) +``` + +Проверено на `bru` 4.2.1 против локального стенда: 28 запросов, 56 проверок, +все зелёные (см. `../evidence/level3-4-verification.md` §12). + +Стенд должен быть поднят: `docker compose --env-file .env up -d --build`, +готовность — `curl -fsS http://localhost:8080/health/ready`. + +## Переменные и приоритет + +| Источник | Что задаёт | Приоритет | +|---|---|---| +| `collection.bru` → `script:pre-request` | `baseUrl=http://localhost:8080`, `password=demo-password-123`, `metricsToken=change-me-metrics-token` | самый низкий: подставляется только если переменная нигде не задана | +| `environments/local.bru` (`--env local`) | те же три переменные для конкретного стенда | выше дефолтов | +| `--env-var name=value` (CLI) / runtime-переменные (GUI) | разовое значение | самый высокий | + +Поэтому адрес API больше не нужно вводить в каждой ручке: он берётся из +настроек коллекции. Если `metricsToken` оставить заглушкой, два запроса к +`/internal/*` вернут 401 — это ожидаемо и описано в их `docs`; остальные 26 +запросов проходят. + +## Окружение + +`environments/local.bru`: + +| Переменная | Значение по умолчанию | Комментарий | +|---|---|---| +| `baseUrl` | `http://localhost:8080` | адрес API | +| `password` | `demo-password-123` | пароль демо-пользователей (12–128 code points) | +| `metricsToken` | `change-me-metrics-token` | возьмите `METRICS_TOKEN` из `.env`, иначе запросы к `/internal/*` вернут 401 | + +## Порядок выполнения + +Папки обходятся по алфавиту, внутри папки — по `seq`: + +```text +auth/ регистрация трёх пользователей и три Basic-сессии, /users/me +chats/ создание чата (два участника), список чатов, чат по id +health/ /health/live и /health/ready +internal/ /internal/metrics и /internal/metrics/reset +messages/ два сообщения, первая страница истории, страница по курсору +negative/ неверный пароль, Basic на бизнес-endpoint, X-User-Id, 404 чужого чата, 400 на limit/cursor и пробельный текст, 409 дубликата +zz-cleanup/ logout и проверка, что отозванный токен даёт 401 (выполняется последним) +``` + +Коллекция сохраняет переменные между запросами: `suffix`, `username`, +`secondUsername`, `thirdUsername`, `userId`, `secondUserId`, `thirdUserId`, +`token`, `secondToken`, `thirdToken`, `chatId`, `messageId`, `nextCursor`. +Повторный запуск не конфликтует с прошлым прогоном: username генерируется +из случайного суффикса, а дубликат проверяется отдельной негативной ручкой. + +## Что проверяет каждая ручка + +- `auth/register-user.bru` — 201, ответ без `password`/`password_hash`; +- `auth/create-session*.bru` — 201, `token_type: Bearer`, `expires_at` в UTC, `user` совпадает с зарегистрированным; +- `auth/me.bru` — Bearer-доступ и совпадение владельца; +- `chats/create-chat.bru` — атомарное создание чата с двумя участниками; +- `messages/send-message*.bru` — `sender_id` выведен из сессии, `chat_id` верный; +- `messages/history-*.bru` — `limit` соблюдён, курсор ведёт на следующую страницу и не повторяет элемент; +- `internal/metrics.bru` — счётчики и агрегаты латентности без секретов; +- `negative/*` — коды и challenge-заголовки, отсутствие подмены владельца через `X-User-Id`, 404 вместо 403 для чужого чата, 409 при дубликате username, 400 на невалидные limit/cursor и пробельный текст. + +## Проверка истечения сессии + +```sh +SESSION_TTL_SECONDS=2 docker compose --env-file .env up -d api +# в Bruno: auth/create-session.bru -> создать сессию, подождать ~2.5 с +# затем auth/me.bru -> ожидается 401 с Bearer-challenge +docker compose --env-file .env up -d api # вернуть штатный TTL из .env +``` + +## Границы + +Коллекция — удобный ручной клиент, а не замена автоматике: контракт и приёмку +проверяют `make test`, набор из `app/test/app.e2e-spec.ts` и бенчмарк трека 1 +(`scripts/track1_cache_benchmark.py`). Секретов в файлах нет: пароль и токен +метрик задаются переменными окружения. diff --git a/bruno/auth/create-session-second.bru b/bruno/auth/create-session-second.bru new file mode 100644 index 00000000..61fc6a66 --- /dev/null +++ b/bruno/auth/create-session-second.bru @@ -0,0 +1,31 @@ +meta { + name: Create second session (Basic) + type: http + seq: 5 +} + +post { + url: {{baseUrl}}/api/v1/auth/sessions + body: none + auth: basic +} + +auth:basic { + username: {{secondUsername}} + password: {{password}} +} + +docs { + Сессия второго участника чата: нужна, чтобы читать историю другой + действующей сессией (read-after-write). Сохраняет secondToken. +} + +tests { + test("201 created", function() { + expect(res.status).to.equal(201); + }); +} + +script:post-response { + bru.setVar("secondToken", res.body.token); +} diff --git a/bruno/auth/create-session-third.bru b/bruno/auth/create-session-third.bru new file mode 100644 index 00000000..a1763321 --- /dev/null +++ b/bruno/auth/create-session-third.bru @@ -0,0 +1,31 @@ +meta { + name: Create third session (Basic) + type: http + seq: 6 +} + +post { + url: {{baseUrl}}/api/v1/auth/sessions + body: none + auth: basic +} + +auth:basic { + username: {{thirdUsername}} + password: {{password}} +} + +docs { + Сессия постороннего пользователя: используется только в негативных + проверках доступа к чужому чату. Сохраняет thirdToken. +} + +tests { + test("201 created", function() { + expect(res.status).to.equal(201); + }); +} + +script:post-response { + bru.setVar("thirdToken", res.body.token); +} diff --git a/bruno/auth/create-session.bru b/bruno/auth/create-session.bru new file mode 100644 index 00000000..11ed83a2 --- /dev/null +++ b/bruno/auth/create-session.bru @@ -0,0 +1,46 @@ +meta { + name: Create session (Basic) + type: http + seq: 4 +} + +post { + url: {{baseUrl}}/api/v1/auth/sessions + body: none + auth: basic +} + +auth:basic { + username: {{username}} + password: {{password}} +} + +docs { + Вход: Authorization: Basic base64(username:password), тело запроса не передаётся. + Пароль кодируется как UTF-8, разделитель — первый символ ":". + Сохраняет token и expiresAt. Неверные credentials дают 401 с + WWW-Authenticate: Basic realm="messenger", charset="UTF-8". +} + +tests { + test("201 created", function() { + expect(res.status).to.equal(201); + }); + + test("token_type bearer", function() { + expect(res.body.token_type).to.equal("Bearer"); + }); + + test("expires_at в UTC", function() { + expect(res.body.expires_at).to.match(/Z$/); + }); + + test("user совпадает с зарегистрированным", function() { + expect(res.body.user.id).to.equal(bru.getVar("userId")); + }); +} + +script:post-response { + bru.setVar("token", res.body.token); + bru.setVar("expiresAt", res.body.expires_at); +} diff --git a/bruno/auth/me.bru b/bruno/auth/me.bru new file mode 100644 index 00000000..e9231aa8 --- /dev/null +++ b/bruno/auth/me.bru @@ -0,0 +1,30 @@ +meta { + name: Current user + type: http + seq: 7 +} + +get { + url: {{baseUrl}}/api/v1/users/me + body: none + auth: none +} + +headers { + Authorization: Bearer {{token}} +} + +docs { + Бизнес-endpoint требует только Bearer. Basic здесь даёт 401, + а заголовок X-User-Id сам по себе доступа не даёт и не подменяет владельца. +} + +tests { + test("status 200", function() { + expect(res.status).to.equal(200); + }); + + test("это тот же пользователь", function() { + expect(res.body.id).to.equal(bru.getVar("userId")); + }); +} diff --git a/bruno/auth/register-second-user.bru b/bruno/auth/register-second-user.bru new file mode 100644 index 00000000..def78f47 --- /dev/null +++ b/bruno/auth/register-second-user.bru @@ -0,0 +1,42 @@ +meta { + name: Register second user + type: http + seq: 2 +} + +post { + url: {{baseUrl}}/api/v1/users + body: json + auth: none +} + +docs { + Второй пользователь: нужен для чата с двумя участниками и проверки, + что чужой чат отдаёт 404. Сохраняет secondUserId и secondUsername, + используя тот же пароль. +} + +script:pre-request { + if (!bru.getVar("suffix")) { + bru.setVar("suffix", Math.random().toString(36).slice(2, 10)); + } + bru.setVar("secondUsername", `demo2_${bru.getVar("suffix")}`); +} + +body:json { + { + "username": "{{secondUsername}}", + "display_name": "Второй участник", + "password": "{{password}}" + } +} + +tests { + test("201 created", function() { + expect(res.status).to.equal(201); + }); +} + +script:post-response { + bru.setVar("secondUserId", res.body.id); +} diff --git a/bruno/auth/register-third-user.bru b/bruno/auth/register-third-user.bru new file mode 100644 index 00000000..e33ff685 --- /dev/null +++ b/bruno/auth/register-third-user.bru @@ -0,0 +1,41 @@ +meta { + name: Register third user + type: http + seq: 3 +} + +post { + url: {{baseUrl}}/api/v1/users + body: json + auth: none +} + +docs { + Третий пользователь не входит в демо-чат: нужен, чтобы показать, + что чужой чат отдаёт 404, а не раскрывает факт существования. +} + +script:pre-request { + if (!bru.getVar("suffix")) { + bru.setVar("suffix", Math.random().toString(36).slice(2, 10)); + } + bru.setVar("thirdUsername", `demo3_${bru.getVar("suffix")}`); +} + +body:json { + { + "username": "{{thirdUsername}}", + "display_name": "Посторонний", + "password": "{{password}}" + } +} + +tests { + test("201 created", function() { + expect(res.status).to.equal(201); + }); +} + +script:post-response { + bru.setVar("thirdUserId", res.body.id); +} diff --git a/bruno/auth/register-user.bru b/bruno/auth/register-user.bru new file mode 100644 index 00000000..f05a0abe --- /dev/null +++ b/bruno/auth/register-user.bru @@ -0,0 +1,53 @@ +meta { + name: Register first user + type: http + seq: 1 +} + +post { + url: {{baseUrl}}/api/v1/users + body: json + auth: none +} + +body:json { + { + "username": "{{username}}", + "display_name": "Демо-пользователь", + "password": "{{password}}" + } +} + +vars:pre-request { + baseUrl: http://localhost:8080 +} + +script:pre-request { + if (!bru.getVar("suffix")) { + bru.setVar("suffix", Math.random().toString(36).slice(2, 10)); + } + bru.setVar("username", `demo_${bru.getVar("suffix")}`); +} + +script:post-response { + bru.setVar("userId", res.body.id); + bru.setVar("displayName", res.body.display_name); +} + +tests { + test("201 created", function() { + expect(res.status).to.equal(201); + }); + + test("пароль и хеш не утекли", function() { + expect(res.body).to.not.have.property("password"); + expect(res.body).to.not.have.property("password_hash"); + }); +} + +docs { + Регистрация с паролем (12–128 code points). + Username генерируется из случайного суффикса, чтобы повторный запуск коллекции + не упирался в 409. Сохраняет переменные: username, userId, displayName. + Ответ никогда не содержит password или password_hash. +} diff --git a/bruno/bruno.json b/bruno/bruno.json new file mode 100644 index 00000000..e178ed31 --- /dev/null +++ b/bruno/bruno.json @@ -0,0 +1,6 @@ +{ + "version": "1", + "name": "mtusi-messenger-lab2", + "type": "collection", + "ignore": ["node_modules", ".git"] +} diff --git a/bruno/chats/create-chat.bru b/bruno/chats/create-chat.bru new file mode 100644 index 00000000..2a27de61 --- /dev/null +++ b/bruno/chats/create-chat.bru @@ -0,0 +1,46 @@ +meta { + name: Create chat + type: http + seq: 1 +} + +post { + url: {{baseUrl}}/api/v1/chats + body: json + auth: none +} + +headers { + Authorization: Bearer {{token}} +} + +docs { + Составная операция в одной транзакции: проверка участников, вставка чата + и всех chat_members. Текущий пользователь обязан входить в member_ids, + неизвестные и дублирующиеся ID дают 400 без частичных данных. + Сохраняет chatId. +} + +body:json { + { + "title": "Демо-чат {{suffix}}", + "member_ids": ["{{userId}}", "{{secondUserId}}"] + } +} + +tests { + test("201 created", function() { + expect(res.status).to.equal(201); + }); + + test("оба участника в чате", function() { + expect(res.body.member_ids).to.have.members([ + bru.getVar("userId"), + bru.getVar("secondUserId") + ]); + }); +} + +script:post-response { + bru.setVar("chatId", res.body.id); +} diff --git a/bruno/chats/get-chat.bru b/bruno/chats/get-chat.bru new file mode 100644 index 00000000..19f87f7d --- /dev/null +++ b/bruno/chats/get-chat.bru @@ -0,0 +1,30 @@ +meta { + name: Get chat by id + type: http + seq: 3 +} + +get { + url: {{baseUrl}}/api/v1/chats/{{chatId}} + body: none + auth: none +} + +headers { + Authorization: Bearer {{token}} +} + +docs { + Участник получает чат, посторонний — 404 (не 403: существование чужого + объекта не раскрывается). +} + +tests { + test("200 ok", function() { + expect(res.status).to.equal(200); + }); + + test("id совпадает", function() { + expect(res.body.id).to.equal(bru.getVar("chatId")); + }); +} diff --git a/bruno/chats/list-chats.bru b/bruno/chats/list-chats.bru new file mode 100644 index 00000000..366573f1 --- /dev/null +++ b/bruno/chats/list-chats.bru @@ -0,0 +1,30 @@ +meta { + name: List my chats + type: http + seq: 2 +} + +get { + url: {{baseUrl}}/api/v1/chats?limit=100 + body: none + auth: none +} + +headers { + Authorization: Bearer {{token}} +} + +docs { + Список только доступных чатов, сортировка по (created_at, id), keyset-cursor. +} + +tests { + test("200 ok", function() { + expect(res.status).to.equal(200); + }); + + test("созданный чат виден", function() { + const ids = res.body.items.map(function(item) { return item.id; }); + expect(ids).to.include(bru.getVar("chatId")); + }); +} diff --git a/bruno/collection.bru b/bruno/collection.bru new file mode 100644 index 00000000..e689dc5b --- /dev/null +++ b/bruno/collection.bru @@ -0,0 +1,29 @@ +script:pre-request { + // Дефолты уровня коллекции: baseUrl не нужно вводить в каждой ручке. + // ВАЖНО: bru.getVar читает только runtime-переменные, значения environment + // приходят через bru.getEnvVar — поэтому проверяем оба источника и не + // перекрываем то, что задано окружением. + const defaults = { + baseUrl: "http://localhost:8080", + password: "demo-password-123", + metricsToken: "GsdgewgDSFkoseGSJGpodsgsdppDS" + }; + for (const name of Object.keys(defaults)) { + if (!bru.getEnvVar(name) && !bru.getVar(name)) { + bru.setVar(name, defaults[name]); + } + } +} + +docs { + # Настройки уровня коллекции. + + Скрипт выше подставляет `baseUrl`, `password` и `metricsToken`, только если + они не заданы environment-ом или runtime-переменной. Поэтому в GUI достаточно + открыть коллекцию — вводить адрес в каждой ручке не требуется, а выбранный + environment `local` (environments/local.bru) остаётся приоритетным. + + Для реального токена метрик возьмите `METRICS_TOKEN` из `.env` (в GUI — через + environment, в CLI — `--env-var metricsToken=...`). Без него `/internal/*` + вернут 401: дефолт-заглушка намеренно не совпадает с рабочим токеном. +} diff --git a/bruno/environments/local.bru b/bruno/environments/local.bru new file mode 100644 index 00000000..d56931b6 --- /dev/null +++ b/bruno/environments/local.bru @@ -0,0 +1,5 @@ +vars { + baseUrl: http://localhost:8080 + password: demo-password-123 + metricsToken: change-me-metrics-token +} diff --git a/bruno/health/health-live.bru b/bruno/health/health-live.bru new file mode 100644 index 00000000..7bfc4675 --- /dev/null +++ b/bruno/health/health-live.bru @@ -0,0 +1,26 @@ +meta { + name: Health live + type: http + seq: 1 +} + +get { + url: {{baseUrl}}/health/live + body: none + auth: none +} + +docs { + Liveness процесса. Зависимости не проверяются: если API жив, ответ 200. +} + +tests { + test("status 200", function() { + expect(res.status).to.equal(200); + }); + + test("X-Request-Id присутствует", function() { + expect(res.headers["x-request-id"]).to.be.a("string"); + expect(res.headers["x-request-id"].length).to.be.greaterThan(0); + }); +} diff --git a/bruno/health/health-ready.bru b/bruno/health/health-ready.bru new file mode 100644 index 00000000..7c2d588c --- /dev/null +++ b/bruno/health/health-ready.bru @@ -0,0 +1,26 @@ +meta { + name: Health ready + type: http + seq: 2 +} + +get { + url: {{baseUrl}}/health/ready + body: none + auth: none +} + +docs { + Readiness: 200 только если доступны PostgreSQL и Redis. + При остановленном Redis или PostgreSQL вернётся 503 в общем формате ошибки. +} + +tests { + test("status 200", function() { + expect(res.status).to.equal(200); + }); + + test("status ok", function() { + expect(res.body.status).to.equal("ok"); + }); +} diff --git a/bruno/internal/metrics-reset.bru b/bruno/internal/metrics-reset.bru new file mode 100644 index 00000000..59b60516 --- /dev/null +++ b/bruno/internal/metrics-reset.bru @@ -0,0 +1,30 @@ +meta { + name: Metrics reset + type: http + seq: 2 +} + +post { + url: {{baseUrl}}/internal/metrics/reset + body: none + auth: none +} + +headers { + Authorization: Bearer {{metricsToken}} +} + +docs { + Обнуляет счётчики процесса API (используется бенчмарком трека 1, чтобы + считать дельту по повторности). На PostgreSQL и Redis не влияет. +} + +tests { + test("200 ok", function() { + expect(res.status).to.equal(200); + }); + + test("status ok", function() { + expect(res.body.status).to.equal("ok"); + }); +} diff --git a/bruno/internal/metrics.bru b/bruno/internal/metrics.bru new file mode 100644 index 00000000..8d729071 --- /dev/null +++ b/bruno/internal/metrics.bru @@ -0,0 +1,33 @@ +meta { + name: Metrics snapshot + type: http + seq: 1 +} + +get { + url: {{baseUrl}}/internal/metrics + body: none + auth: none +} + +headers { + Authorization: Bearer {{metricsToken}} +} + +docs { + Внутренний диагностический endpoint (не часть публичного контракта). + Требует Authorization: Bearer ; без него — 401. + Возвращает счётчики SQL/Redis/cache/session и агрегаты латентности, + без токенов, паролей и SQL-текста. Токен возьмите из .env (METRICS_TOKEN). +} + +tests { + test("200 ok", function() { + expect(res.status).to.equal(200); + }); + + test("есть счётчики и латентность", function() { + expect(res.body.counters).to.be.an("object"); + expect(res.body.latency_ms).to.have.property("p50"); + }); +} diff --git a/bruno/messages/history-first-page.bru b/bruno/messages/history-first-page.bru new file mode 100644 index 00000000..16463146 --- /dev/null +++ b/bruno/messages/history-first-page.bru @@ -0,0 +1,40 @@ +meta { + name: History first page + type: http + seq: 3 +} + +get { + url: {{baseUrl}}/api/v1/chats/{{chatId}}/messages?limit=1 + body: none + auth: none +} + +headers { + Authorization: Bearer {{secondToken}} +} + +docs { + Keyset-пагинация по (created_at, id) по возрастанию. История читается + любой действующей сессией участника — здесь второй сессией, что заодно + показывает read-after-write для ранее отправленного сообщения. + Сохраняет nextCursor. +} + +tests { + test("200 ok", function() { + expect(res.status).to.equal(200); + }); + + test("страница ограничена limit", function() { + expect(res.body.items.length).to.equal(1); + }); + + test("есть курсор на следующую страницу", function() { + expect(res.body.next_cursor).to.be.a("string"); + }); +} + +script:post-response { + bru.setVar("nextCursor", res.body.next_cursor); +} diff --git a/bruno/messages/history-next-page.bru b/bruno/messages/history-next-page.bru new file mode 100644 index 00000000..db84aacf --- /dev/null +++ b/bruno/messages/history-next-page.bru @@ -0,0 +1,31 @@ +meta { + name: History next page by cursor + type: http + seq: 4 +} + +get { + url: {{baseUrl}}/api/v1/chats/{{chatId}}/messages?limit=1&cursor={{nextCursor}} + body: none + auth: none +} + +headers { + Authorization: Bearer {{secondToken}} +} + +docs { + Продолжение по курсору. Курсор привязан к чату: значение от другого + чата вернёт 400. Последний элемент предыдущей страницы не повторяется. +} + +tests { + test("200 ok", function() { + expect(res.status).to.equal(200); + }); + + test("второй элемент не дублирует первый", function() { + expect(res.body.items.length).to.equal(1); + expect(res.body.items[0].id).to.not.equal(bru.getVar("messageId")); + }); +} diff --git a/bruno/messages/send-message-second-user.bru b/bruno/messages/send-message-second-user.bru new file mode 100644 index 00000000..aae5b168 --- /dev/null +++ b/bruno/messages/send-message-second-user.bru @@ -0,0 +1,40 @@ +meta { + name: Send message as second user + type: http + seq: 2 +} + +post { + url: {{baseUrl}}/api/v1/chats/{{chatId}}/messages + body: json + auth: none +} + +headers { + Authorization: Bearer {{secondToken}} +} + +docs { + Любой участник чата может писать. Второе сообщение нужно, чтобы + страница с limit=1 вернула next_cursor и пагинацию можно было проверить. +} + +body:json { + { + "text": "Ответ второго участника" + } +} + +tests { + test("201 created", function() { + expect(res.status).to.equal(201); + }); + + test("sender — второй пользователь", function() { + expect(res.body.sender_id).to.equal(bru.getVar("secondUserId")); + }); +} + +script:post-response { + bru.setVar("secondMessageId", res.body.id); +} diff --git a/bruno/messages/send-message.bru b/bruno/messages/send-message.bru new file mode 100644 index 00000000..761b3bc2 --- /dev/null +++ b/bruno/messages/send-message.bru @@ -0,0 +1,46 @@ +meta { + name: Send message + type: http + seq: 1 +} + +post { + url: {{baseUrl}}/api/v1/chats/{{chatId}}/messages + body: json + auth: none +} + +headers { + Authorization: Bearer {{token}} +} + +docs { + Отправитель берётся из Bearer-идентичности; поле sender_id в теле + не принимается (лишние поля — 400). Пустой или пробельный текст — 400. + Запись коммитит сообщение и увеличивает chats.message_version в одной + транзакции. Сохраняет messageId. +} + +body:json { + { + "text": "Привет из Bruno 👋" + } +} + +tests { + test("201 created", function() { + expect(res.status).to.equal(201); + }); + + test("sender выведен из сессии", function() { + expect(res.body.sender_id).to.equal(bru.getVar("userId")); + }); + + test("сообщение в нужном чате", function() { + expect(res.body.chat_id).to.equal(bru.getVar("chatId")); + }); +} + +script:post-response { + bru.setVar("messageId", res.body.id); +} diff --git a/bruno/negative/basic-on-business-endpoint.bru b/bruno/negative/basic-on-business-endpoint.bru new file mode 100644 index 00000000..ae7ac9ac --- /dev/null +++ b/bruno/negative/basic-on-business-endpoint.bru @@ -0,0 +1,31 @@ +meta { + name: Basic on business endpoint + type: http + seq: 2 +} + +get { + url: {{baseUrl}}/api/v1/users/me + body: none + auth: basic +} + +auth:basic { + username: {{username}} + password: {{password}} +} + +docs { + Basic принимается только на POST /auth/sessions. На бизнес-endpoint + он даёт 401 с Bearer-challenge, даже если credentials верные. +} + +tests { + test("401 unauthorized", function() { + expect(res.status).to.equal(401); + }); + + test("Bearer challenge", function() { + expect(res.headers["www-authenticate"]).to.equal('Bearer realm="messenger"'); + }); +} diff --git a/bruno/negative/blank-message.bru b/bruno/negative/blank-message.bru new file mode 100644 index 00000000..0de55785 --- /dev/null +++ b/bruno/negative/blank-message.bru @@ -0,0 +1,33 @@ +meta { + name: Blank message and extra field + type: http + seq: 7 +} + +post { + url: {{baseUrl}}/api/v1/chats/{{chatId}}/messages + body: json + auth: none +} + +headers { + Authorization: Bearer {{token}} +} + +docs { + Пробельный текст запрещён, а поле sender_id не принимается: + strict validation отвечает 400 (лишние поля отклоняются, а не игнорируются). +} + +body:json { + { + "text": " ", + "sender_id": "{{secondUserId}}" + } +} + +tests { + test("400 invalid_request", function() { + expect(res.status).to.equal(400); + }); +} diff --git a/bruno/negative/duplicate-username-409.bru b/bruno/negative/duplicate-username-409.bru new file mode 100644 index 00000000..36d48f3c --- /dev/null +++ b/bruno/negative/duplicate-username-409.bru @@ -0,0 +1,34 @@ +meta { + name: Duplicate username returns 409 + type: http + seq: 8 +} + +post { + url: {{baseUrl}}/api/v1/users + body: json + auth: none +} + +docs { + Повторная регистрация того же username. Уникальность обеспечивает + unique-индекс PostgreSQL, ошибка 23505 маппится в 409 (не 500). +} + +body:json { + { + "username": "{{username}}", + "display_name": "Дубликат", + "password": "{{password}}" + } +} + +tests { + test("409 conflict", function() { + expect(res.status).to.equal(409); + }); + + test("код ошибки conflict", function() { + expect(res.body.error.code).to.equal("conflict"); + }); +} diff --git a/bruno/negative/invalid-limit-and-cursor.bru b/bruno/negative/invalid-limit-and-cursor.bru new file mode 100644 index 00000000..be46b15c --- /dev/null +++ b/bruno/negative/invalid-limit-and-cursor.bru @@ -0,0 +1,31 @@ +meta { + name: Invalid limit and cursor + type: http + seq: 6 +} + +get { + url: {{baseUrl}}/api/v1/chats/{{chatId}}/messages?limit=101&cursor=not-a-cursor + body: none + auth: none +} + +headers { + Authorization: Bearer {{token}} +} + +docs { + limit вне 1..100 и неизвестный cursor — 400 invalid_request, + в одном формате ошибки с request_id, совпадающим с заголовком. +} + +tests { + test("400 invalid_request", function() { + expect(res.status).to.equal(400); + }); + + test("формат ошибки по контракту", function() { + expect(res.body.error.code).to.equal("invalid_request"); + expect(res.body.error.request_id).to.equal(res.headers["x-request-id"]); + }); +} diff --git a/bruno/negative/non-member-chat-404.bru b/bruno/negative/non-member-chat-404.bru new file mode 100644 index 00000000..3de7f133 --- /dev/null +++ b/bruno/negative/non-member-chat-404.bru @@ -0,0 +1,30 @@ +meta { + name: Non-member receives 404 + type: http + seq: 5 +} + +get { + url: {{baseUrl}}/api/v1/chats/{{chatId}} + body: none + auth: none +} + +headers { + Authorization: Bearer {{thirdToken}} +} + +docs { + Аутентификация прошла, но доступа к ресурсу нет. Контракт требует 404, + а не 403: существование чужого чата не раскрывается. +} + +tests { + test("404 not_found", function() { + expect(res.status).to.equal(404); + }); + + test("код ошибки not_found", function() { + expect(res.body.error.code).to.equal("not_found"); + }); +} diff --git a/bruno/negative/wrong-password.bru b/bruno/negative/wrong-password.bru new file mode 100644 index 00000000..a779e2f9 --- /dev/null +++ b/bruno/negative/wrong-password.bru @@ -0,0 +1,35 @@ +meta { + name: Wrong password + type: http + seq: 1 +} + +post { + url: {{baseUrl}}/api/v1/auth/sessions + body: none + auth: basic +} + +auth:basic { + username: {{username}} + password: definitely-wrong-password +} + +docs { + Неверный пароль: 401 без раскрытия, существует ли пользователь, + и с тем же Basic-challenge, что и при неизвестном пользователе. +} + +tests { + test("401 unauthorized", function() { + expect(res.status).to.equal(401); + }); + + test("Basic challenge", function() { + expect(res.headers["www-authenticate"]).to.equal('Basic realm="messenger", charset="UTF-8"'); + }); + + test("request_id совпадает с заголовком", function() { + expect(res.body.error.request_id).to.equal(res.headers["x-request-id"]); + }); +} diff --git a/bruno/negative/x-user-id-alone.bru b/bruno/negative/x-user-id-alone.bru new file mode 100644 index 00000000..cc0193c5 --- /dev/null +++ b/bruno/negative/x-user-id-alone.bru @@ -0,0 +1,30 @@ +meta { + name: X-User-Id alone does not authenticate + type: http + seq: 3 +} + +get { + url: {{baseUrl}}/api/v1/users/me + body: none + auth: none +} + +headers { + X-User-Id: {{userId}} +} + +docs { + Заголовок X-User-Id остался от lab1 и с lab2 не даёт доступа: + без действующей Bearer-сессии ответ 401. +} + +tests { + test("401 unauthorized", function() { + expect(res.status).to.equal(401); + }); + + test("Bearer challenge", function() { + expect(res.headers["www-authenticate"]).to.equal('Bearer realm="messenger"'); + }); +} diff --git a/bruno/negative/x-user-id-cannot-spoof.bru b/bruno/negative/x-user-id-cannot-spoof.bru new file mode 100644 index 00000000..8f3a2c01 --- /dev/null +++ b/bruno/negative/x-user-id-cannot-spoof.bru @@ -0,0 +1,32 @@ +meta { + name: X-User-Id cannot spoof the session owner + type: http + seq: 4 +} + +get { + url: {{baseUrl}}/api/v1/users/me + body: none + auth: none +} + +headers { + Authorization: Bearer {{token}} + X-User-Id: {{secondUserId}} +} + +docs { + Владелец запроса определяется только токеном: X-User-Id с ID другого + пользователя игнорируется, ответ содержит владельца сессии. +} + +tests { + test("200 ok", function() { + expect(res.status).to.equal(200); + }); + + test("вернулся владелец сессии, а не подставленный ID", function() { + expect(res.body.id).to.equal(bru.getVar("userId")); + expect(res.body.id).to.not.equal(bru.getVar("secondUserId")); + }); +} diff --git a/bruno/zz-cleanup/logout-current-session.bru b/bruno/zz-cleanup/logout-current-session.bru new file mode 100644 index 00000000..046c1bc4 --- /dev/null +++ b/bruno/zz-cleanup/logout-current-session.bru @@ -0,0 +1,30 @@ +meta { + name: Logout current session (run last) + type: http + seq: 1 +} + +delete { + url: {{baseUrl}}/api/v1/auth/sessions/current + body: none + auth: none +} + +headers { + Authorization: Bearer {{token}} +} + +docs { + Папка zz-cleanup выполняется последней: отзываем основную сессию и + проверяем, что тот же токен больше не принимается. Ответ 204 без тела. +} + +tests { + test("204 no content", function() { + expect(res.status).to.equal(204); + }); + + test("тела нет", function() { + expect(res.body === "" || res.body === undefined).to.be.true; + }); +} diff --git a/bruno/zz-cleanup/revoked-token-rejected.bru b/bruno/zz-cleanup/revoked-token-rejected.bru new file mode 100644 index 00000000..bcfadf6f --- /dev/null +++ b/bruno/zz-cleanup/revoked-token-rejected.bru @@ -0,0 +1,30 @@ +meta { + name: Revoked token is rejected + type: http + seq: 2 +} + +get { + url: {{baseUrl}}/api/v1/users/me + body: none + auth: none +} + +headers { + Authorization: Bearer {{token}} +} + +docs { + Повторное использование отозванного токена: 401 с Bearer-challenge. + Ожидаемый результат после logout-current-session. +} + +tests { + test("401 unauthorized", function() { + expect(res.status).to.equal(401); + }); + + test("Bearer challenge", function() { + expect(res.headers["www-authenticate"]).to.equal('Bearer realm="messenger"'); + }); +} diff --git a/docker-compose.yml b/docker-compose.yml index aa409656..d52c1926 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -1,13 +1,67 @@ services: - nest-app: - build: - context: . - dockerfile: Dockerfile - image: mtusi-messenger:lab2 - ports: - - ${APP_PUBLIC_PORT:-8080}:${APP_PORT:-8080} - env_file: - - .env - environment: - BENCHMARK_CURSOR_SEARCH: ${BENCHMARK_CURSOR_SEARCH:-binary} - stop_grace_period: 30s + postgres: + image: postgres:16.4-alpine + environment: + POSTGRES_DB: ${POSTGRES_DB:-messenger} + POSTGRES_USER: ${POSTGRES_USER:-messenger} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env} + volumes: + - postgres-data:/var/lib/postgresql/data + healthcheck: + test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"] + interval: 5s + timeout: 3s + retries: 20 + + redis: + image: redis:7.4.2-alpine + command: ["redis-server", "--appendonly", "yes", "--appendfsync", "everysec"] + volumes: + - redis-data:/data + healthcheck: + test: ["CMD", "redis-cli", "ping"] + interval: 5s + timeout: 3s + retries: 20 + + migrate: + build: + context: . + dockerfile: Dockerfile + image: mtusi-messenger:lab2 + command: ["node", "dist/database/migration.runner.js"] + env_file: [.env] + depends_on: + postgres: { condition: service_healthy } + redis: { condition: service_healthy } + restart: "no" + + api: + build: + context: . + dockerfile: Dockerfile + image: mtusi-messenger:lab2 + ports: + - "${APP_PUBLIC_PORT:-8080}:${APP_PORT:-8080}" + env_file: [.env] + # Declared here so a one-off experiment can override them from the shell + # (shell env wins over env_file), e.g.: + # CACHE_MODE=naive CACHE_MISS_DELAY_MS=75 docker compose up -d api + # SESSION_TTL_SECONDS=2 docker compose up -d api + environment: + CACHE_MODE: ${CACHE_MODE:-protected} + CACHE_MISS_DELAY_MS: ${CACHE_MISS_DELAY_MS:-0} + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + depends_on: + migrate: { condition: service_completed_successfully } + postgres: { condition: service_healthy } + redis: { condition: service_healthy } + healthcheck: + test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:'+ (process.env.APP_PORT||8080) + '/health/ready').then(r=>{if(!r.ok)process.exit(1)}).catch(()=>process.exit(1))"] + interval: 5s + timeout: 3s + retries: 20 + +volumes: + postgres-data: + redis-data: diff --git a/docs/architecture/README.md b/docs/architecture/README.md new file mode 100644 index 00000000..7d175c34 --- /dev/null +++ b/docs/architecture/README.md @@ -0,0 +1,26 @@ +# Граф модулей NestJS + +Артефакты в этой папке генерируются командой `npm run graph` из `app/` +и описывают реальный граф зависимостей приложения: + +| Файл | Содержимое | +|---|---| +| `nest-module-details.json` | Модули, imports, providers, controllers, exports и constructor-зависимости (из compiled metadata). | +| `nest-module-graph.mmd` | Mermaid-граф: сплошные стрелки — imports модулей, пунктирные — внедрения провайдеров. | +| `nest-dependency-graph.md` | Тот же граф плюс таблицы по каждому модулю (удобно смотреть в Markdown-preview). | + +Генератор: `app/scripts/graph-modules.ts` (использует `nestjs-spelunker`). +Команда не подключается к PostgreSQL или Redis: для неё подставляются фиктивные +`DATABASE_URL`/`REDIS_URL`, поэтому стенд поднимать не нужно. + +Перегенерация: + +```sh +cd app && npm run graph +``` + +Зачем это в отчёте: граф показал, где зависимости держались на глобальном scope +и где объявления модулей не отражали реальное устройство DI — именно это привело +к падению API с `UnknownDependenciesException` (см. `evidence/level3-4-verification.md` +§13). Ссылки на разбор: [`../../REPORT.md`](../../REPORT.md), +[`../../evidence/README.md`](../../evidence/README.md). diff --git a/docs/architecture/nest-dependency-graph.md b/docs/architecture/nest-dependency-graph.md new file mode 100644 index 00000000..f1d29da5 --- /dev/null +++ b/docs/architecture/nest-dependency-graph.md @@ -0,0 +1,247 @@ +# NestJS dependency graph + +Generated from `AppModule` with `nestjs-spelunker` static module debugging. + +- Solid arrows: module imports. +- Dotted arrows: constructor dependencies. +- The generator does not boot PostgreSQL or Redis. + +```mermaid +flowchart LR + %% Generated by scripts/graph-modules.ts + %% Solid arrows: module imports; dotted arrows: constructor dependencies + subgraph AppModule["AppModule"] + AppModule_APP_FILTER["provider: APP_FILTER"] + end + subgraph AppConfigModule["AppConfigModule"] + end + subgraph ConfigModule["ConfigModule"] + ConfigModule_ConfigService["provider: ConfigService"] + ConfigModule_VALIDATED_ENV_LOADER["provider: VALIDATED_ENV_LOADER"] + end + subgraph DatabaseModule["DatabaseModule"] + DatabaseModule_DatabaseClient["provider: DatabaseClient"] + end + subgraph MetricsModule["MetricsModule"] + MetricsModule_MetricsService["provider: MetricsService"] + MetricsModule_MetricsController["controller: MetricsController"] + end + subgraph RedisModule["RedisModule"] + RedisModule_RedisClient["provider: RedisClient"] + end + subgraph UsersModule["UsersModule"] + UsersModule_UsersRepository["provider: UsersRepository"] + UsersModule_UsersService["provider: UsersService"] + UsersModule_CurrentUserGuard["provider: CurrentUserGuard"] + UsersModule_UsersController["controller: UsersController"] + end + subgraph AuthModule["AuthModule"] + AuthModule_AuthService["provider: AuthService"] + AuthModule_SessionRepository["provider: SessionRepository"] + AuthModule_AuthController["controller: AuthController"] + end + subgraph HealthModule["HealthModule"] + HealthModule_HealthService["provider: HealthService"] + HealthModule_HealthController["controller: HealthController"] + end + subgraph ChatsModule["ChatsModule"] + ChatsModule_ChatsRepository["provider: ChatsRepository"] + ChatsModule_ChatsService["provider: ChatsService"] + ChatsModule_ChatsController["controller: ChatsController"] + end + subgraph MessagesModule["MessagesModule"] + MessagesModule_MessagesRepository["provider: MessagesRepository"] + MessagesModule_MessagesService["provider: MessagesService"] + MessagesModule_MessagesController["controller: MessagesController"] + end + subgraph MessagesCacheModule["MessagesCacheModule"] + MessagesCacheModule_MessagesCacheService["provider: MessagesCacheService"] + end + AppModule -->|imports| AppConfigModule + AppModule -->|imports| DatabaseModule + AppModule -->|imports| RedisModule + AppModule -->|imports| UsersModule + AppModule -->|imports| AuthModule + AppModule -->|imports| HealthModule + AppModule -->|imports| ChatsModule + AppModule -->|imports| MessagesModule + AppModule -->|imports| MetricsModule + AppConfigModule -->|imports| ConfigModule + DatabaseModule -->|imports| MetricsModule + DatabaseModule_DatabaseClient -.->|injects| ConfigModule_ConfigService + DatabaseModule_DatabaseClient -.->|injects| MetricsModule_MetricsService + MetricsModule_MetricsController -.->|injects| ConfigModule_ConfigService + MetricsModule_MetricsController -.->|injects| MetricsModule_MetricsService + RedisModule -->|imports| MetricsModule + RedisModule_RedisClient -.->|injects| ConfigModule_ConfigService + RedisModule_RedisClient -.->|injects| MetricsModule_MetricsService + UsersModule -->|imports| DatabaseModule + UsersModule -->|imports| RedisModule + UsersModule -->|imports| MetricsModule + UsersModule_UsersRepository -.->|injects| DatabaseModule_DatabaseClient + UsersModule_UsersService -.->|injects| UsersModule_UsersRepository + UsersModule_CurrentUserGuard -.->|injects| RedisModule_RedisClient + UsersModule_CurrentUserGuard -.->|injects| UsersModule_UsersService + UsersModule_CurrentUserGuard -.->|injects| MetricsModule_MetricsService + UsersModule_UsersController -.->|injects| UsersModule_UsersService + AuthModule -->|imports| UsersModule + AuthModule -->|imports| DatabaseModule + AuthModule -->|imports| RedisModule + AuthModule -->|imports| MetricsModule + AuthModule_AuthService -.->|injects| UsersModule_UsersService + AuthModule_AuthService -.->|injects| AuthModule_SessionRepository + AuthModule_SessionRepository -.->|injects| RedisModule_RedisClient + AuthModule_SessionRepository -.->|injects| ConfigModule_ConfigService + AuthModule_SessionRepository -.->|injects| MetricsModule_MetricsService + AuthModule_AuthController -.->|injects| AuthModule_AuthService + HealthModule -->|imports| DatabaseModule + HealthModule -->|imports| RedisModule + HealthModule_HealthService -.->|injects| DatabaseModule_DatabaseClient + HealthModule_HealthService -.->|injects| RedisModule_RedisClient + HealthModule_HealthService -.->|injects| ConfigModule_ConfigService + HealthModule_HealthController -.->|injects| HealthModule_HealthService + ChatsModule -->|imports| UsersModule + ChatsModule -->|imports| DatabaseModule + ChatsModule -->|imports| RedisModule + ChatsModule -->|imports| MetricsModule + ChatsModule_ChatsRepository -.->|injects| DatabaseModule_DatabaseClient + ChatsModule_ChatsService -.->|injects| ChatsModule_ChatsRepository + ChatsModule_ChatsController -.->|injects| ChatsModule_ChatsService + MessagesModule -->|imports| ChatsModule + MessagesModule -->|imports| MessagesCacheModule + MessagesModule -->|imports| DatabaseModule + MessagesModule -->|imports| UsersModule + MessagesModule -->|imports| RedisModule + MessagesModule -->|imports| MetricsModule + MessagesModule_MessagesRepository -.->|injects| DatabaseModule_DatabaseClient + MessagesModule_MessagesService -.->|injects| MessagesModule_MessagesRepository + MessagesModule_MessagesService -.->|injects| ChatsModule_ChatsService + MessagesModule_MessagesService -.->|injects| MessagesCacheModule_MessagesCacheService + MessagesModule_MessagesController -.->|injects| MessagesModule_MessagesService + MessagesCacheModule -->|imports| RedisModule + MessagesCacheModule -->|imports| MetricsModule + MessagesCacheModule_MessagesCacheService -.->|injects| RedisModule_RedisClient + MessagesCacheModule_MessagesCacheService -.->|injects| ConfigModule_ConfigService + MessagesCacheModule_MessagesCacheService -.->|injects| MetricsModule_MetricsService +``` + +## Module details + +### AppModule + +- Imports: AppConfigModule, DatabaseModule, RedisModule, UsersModule, AuthModule, HealthModule, ChatsModule, MessagesModule, MetricsModule +- Exports: none + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | APP_FILTER | HttpAdapterHost | + +### AppConfigModule + +- Imports: ConfigModule +- Exports: ConfigModule (module) + +| Kind | Name | Dependencies | +| --- | --- | --- | + +### ConfigModule + +- Imports: none +- Exports: ConfigService (provider) + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | ConfigService | Symbol(CONFIG_SERVICE) | +| provider | VALIDATED_ENV_LOADER | CONFIGURATION_TOKEN | + +### DatabaseModule + +- Imports: MetricsModule +- Exports: DatabaseClient (provider) + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | DatabaseClient | ConfigService, MetricsService | + +### MetricsModule + +- Imports: none +- Exports: MetricsService (provider) + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | MetricsService | none | +| controller | MetricsController | ConfigService, MetricsService | + +### RedisModule + +- Imports: MetricsModule +- Exports: RedisClient (provider) + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | RedisClient | ConfigService, MetricsService | + +### UsersModule + +- Imports: DatabaseModule, RedisModule, MetricsModule +- Exports: UsersService (provider), CurrentUserGuard (provider), RedisModule (module), MetricsModule (module) + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | UsersRepository | DatabaseClient | +| provider | UsersService | UsersRepository | +| provider | CurrentUserGuard | RedisClient, UsersService, MetricsService | +| controller | UsersController | UsersService | + +### AuthModule + +- Imports: UsersModule, DatabaseModule, RedisModule, MetricsModule +- Exports: AuthService (provider), SessionRepository (provider) + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | AuthService | UsersService, SessionRepository | +| provider | SessionRepository | RedisClient, ConfigService, MetricsService | +| controller | AuthController | AuthService | + +### HealthModule + +- Imports: DatabaseModule, RedisModule +- Exports: none + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | HealthService | DatabaseClient, RedisClient, ConfigService | +| controller | HealthController | HealthService | + +### ChatsModule + +- Imports: UsersModule, DatabaseModule, RedisModule, MetricsModule +- Exports: ChatsService (provider) + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | ChatsRepository | DatabaseClient | +| provider | ChatsService | ChatsRepository | +| controller | ChatsController | ChatsService | + +### MessagesModule + +- Imports: ChatsModule, MessagesCacheModule, DatabaseModule, UsersModule, RedisModule, MetricsModule +- Exports: none + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | MessagesRepository | DatabaseClient | +| provider | MessagesService | MessagesRepository, ChatsService, MessagesCacheService | +| controller | MessagesController | MessagesService | + +### MessagesCacheModule + +- Imports: RedisModule, MetricsModule +- Exports: MessagesCacheService (provider) + +| Kind | Name | Dependencies | +| --- | --- | --- | +| provider | MessagesCacheService | RedisClient, ConfigService, MetricsService | diff --git a/docs/architecture/nest-module-details.json b/docs/architecture/nest-module-details.json new file mode 100644 index 00000000..d3f10130 --- /dev/null +++ b/docs/architecture/nest-module-details.json @@ -0,0 +1,374 @@ +[ + { + "name": "AppModule", + "imports": [ + "AppConfigModule", + "DatabaseModule", + "RedisModule", + "UsersModule", + "AuthModule", + "HealthModule", + "ChatsModule", + "MessagesModule", + "MetricsModule" + ], + "providers": [ + { + "name": "APP_FILTER", + "dependencies": [ + "HttpAdapterHost" + ], + "type": "class" + } + ], + "controllers": [], + "exports": [] + }, + { + "name": "AppConfigModule", + "imports": [ + "ConfigModule" + ], + "providers": [], + "controllers": [], + "exports": [ + { + "name": "ConfigModule", + "type": "module" + } + ] + }, + { + "name": "ConfigModule", + "imports": [], + "providers": [ + { + "name": "ConfigService", + "dependencies": [ + "Symbol(CONFIG_SERVICE)" + ], + "type": "factory" + }, + { + "name": "VALIDATED_ENV_LOADER", + "dependencies": [ + "CONFIGURATION_TOKEN" + ], + "type": "factory" + } + ], + "controllers": [], + "exports": [ + { + "name": "ConfigService", + "type": "provider" + } + ] + }, + { + "name": "DatabaseModule", + "imports": [ + "MetricsModule" + ], + "providers": [ + { + "name": "DatabaseClient", + "dependencies": [ + "ConfigService", + "MetricsService" + ], + "type": "class" + } + ], + "controllers": [], + "exports": [ + { + "name": "DatabaseClient", + "type": "provider" + } + ] + }, + { + "name": "MetricsModule", + "imports": [], + "providers": [ + { + "name": "MetricsService", + "dependencies": [], + "type": "class" + } + ], + "controllers": [ + { + "name": "MetricsController", + "dependencies": [ + "ConfigService", + "MetricsService" + ] + } + ], + "exports": [ + { + "name": "MetricsService", + "type": "provider" + } + ] + }, + { + "name": "RedisModule", + "imports": [ + "MetricsModule" + ], + "providers": [ + { + "name": "RedisClient", + "dependencies": [ + "ConfigService", + "MetricsService" + ], + "type": "class" + } + ], + "controllers": [], + "exports": [ + { + "name": "RedisClient", + "type": "provider" + } + ] + }, + { + "name": "UsersModule", + "imports": [ + "DatabaseModule", + "RedisModule", + "MetricsModule" + ], + "providers": [ + { + "name": "UsersRepository", + "dependencies": [ + "DatabaseClient" + ], + "type": "class" + }, + { + "name": "UsersService", + "dependencies": [ + "UsersRepository" + ], + "type": "class" + }, + { + "name": "CurrentUserGuard", + "dependencies": [ + "RedisClient", + "UsersService", + "MetricsService" + ], + "type": "class" + } + ], + "controllers": [ + { + "name": "UsersController", + "dependencies": [ + "UsersService" + ] + } + ], + "exports": [ + { + "name": "UsersService", + "type": "provider" + }, + { + "name": "CurrentUserGuard", + "type": "provider" + }, + { + "name": "RedisModule", + "type": "module" + }, + { + "name": "MetricsModule", + "type": "module" + } + ] + }, + { + "name": "AuthModule", + "imports": [ + "UsersModule", + "DatabaseModule", + "RedisModule", + "MetricsModule" + ], + "providers": [ + { + "name": "AuthService", + "dependencies": [ + "UsersService", + "SessionRepository" + ], + "type": "class" + }, + { + "name": "SessionRepository", + "dependencies": [ + "RedisClient", + "ConfigService", + "MetricsService" + ], + "type": "class" + } + ], + "controllers": [ + { + "name": "AuthController", + "dependencies": [ + "AuthService" + ] + } + ], + "exports": [ + { + "name": "AuthService", + "type": "provider" + }, + { + "name": "SessionRepository", + "type": "provider" + } + ] + }, + { + "name": "HealthModule", + "imports": [ + "DatabaseModule", + "RedisModule" + ], + "providers": [ + { + "name": "HealthService", + "dependencies": [ + "DatabaseClient", + "RedisClient", + "ConfigService" + ], + "type": "class" + } + ], + "controllers": [ + { + "name": "HealthController", + "dependencies": [ + "HealthService" + ] + } + ], + "exports": [] + }, + { + "name": "ChatsModule", + "imports": [ + "UsersModule", + "DatabaseModule", + "RedisModule", + "MetricsModule" + ], + "providers": [ + { + "name": "ChatsRepository", + "dependencies": [ + "DatabaseClient" + ], + "type": "class" + }, + { + "name": "ChatsService", + "dependencies": [ + "ChatsRepository" + ], + "type": "class" + } + ], + "controllers": [ + { + "name": "ChatsController", + "dependencies": [ + "ChatsService" + ] + } + ], + "exports": [ + { + "name": "ChatsService", + "type": "provider" + } + ] + }, + { + "name": "MessagesModule", + "imports": [ + "ChatsModule", + "MessagesCacheModule", + "DatabaseModule", + "UsersModule", + "RedisModule", + "MetricsModule" + ], + "providers": [ + { + "name": "MessagesRepository", + "dependencies": [ + "DatabaseClient" + ], + "type": "class" + }, + { + "name": "MessagesService", + "dependencies": [ + "MessagesRepository", + "ChatsService", + "MessagesCacheService" + ], + "type": "class" + } + ], + "controllers": [ + { + "name": "MessagesController", + "dependencies": [ + "MessagesService" + ] + } + ], + "exports": [] + }, + { + "name": "MessagesCacheModule", + "imports": [ + "RedisModule", + "MetricsModule" + ], + "providers": [ + { + "name": "MessagesCacheService", + "dependencies": [ + "RedisClient", + "ConfigService", + "MetricsService" + ], + "type": "class" + } + ], + "controllers": [], + "exports": [ + { + "name": "MessagesCacheService", + "type": "provider" + } + ] + } +] \ No newline at end of file diff --git a/docs/architecture/nest-module-graph.mmd b/docs/architecture/nest-module-graph.mmd new file mode 100644 index 00000000..bb62020a --- /dev/null +++ b/docs/architecture/nest-module-graph.mmd @@ -0,0 +1,116 @@ +flowchart LR + %% Generated by scripts/graph-modules.ts + %% Solid arrows: module imports; dotted arrows: constructor dependencies + subgraph AppModule["AppModule"] + AppModule_APP_FILTER["provider: APP_FILTER"] + end + subgraph AppConfigModule["AppConfigModule"] + end + subgraph ConfigModule["ConfigModule"] + ConfigModule_ConfigService["provider: ConfigService"] + ConfigModule_VALIDATED_ENV_LOADER["provider: VALIDATED_ENV_LOADER"] + end + subgraph DatabaseModule["DatabaseModule"] + DatabaseModule_DatabaseClient["provider: DatabaseClient"] + end + subgraph MetricsModule["MetricsModule"] + MetricsModule_MetricsService["provider: MetricsService"] + MetricsModule_MetricsController["controller: MetricsController"] + end + subgraph RedisModule["RedisModule"] + RedisModule_RedisClient["provider: RedisClient"] + end + subgraph UsersModule["UsersModule"] + UsersModule_UsersRepository["provider: UsersRepository"] + UsersModule_UsersService["provider: UsersService"] + UsersModule_CurrentUserGuard["provider: CurrentUserGuard"] + UsersModule_UsersController["controller: UsersController"] + end + subgraph AuthModule["AuthModule"] + AuthModule_AuthService["provider: AuthService"] + AuthModule_SessionRepository["provider: SessionRepository"] + AuthModule_AuthController["controller: AuthController"] + end + subgraph HealthModule["HealthModule"] + HealthModule_HealthService["provider: HealthService"] + HealthModule_HealthController["controller: HealthController"] + end + subgraph ChatsModule["ChatsModule"] + ChatsModule_ChatsRepository["provider: ChatsRepository"] + ChatsModule_ChatsService["provider: ChatsService"] + ChatsModule_ChatsController["controller: ChatsController"] + end + subgraph MessagesModule["MessagesModule"] + MessagesModule_MessagesRepository["provider: MessagesRepository"] + MessagesModule_MessagesService["provider: MessagesService"] + MessagesModule_MessagesController["controller: MessagesController"] + end + subgraph MessagesCacheModule["MessagesCacheModule"] + MessagesCacheModule_MessagesCacheService["provider: MessagesCacheService"] + end + AppModule -->|imports| AppConfigModule + AppModule -->|imports| DatabaseModule + AppModule -->|imports| RedisModule + AppModule -->|imports| UsersModule + AppModule -->|imports| AuthModule + AppModule -->|imports| HealthModule + AppModule -->|imports| ChatsModule + AppModule -->|imports| MessagesModule + AppModule -->|imports| MetricsModule + AppConfigModule -->|imports| ConfigModule + DatabaseModule -->|imports| MetricsModule + DatabaseModule_DatabaseClient -.->|injects| ConfigModule_ConfigService + DatabaseModule_DatabaseClient -.->|injects| MetricsModule_MetricsService + MetricsModule_MetricsController -.->|injects| ConfigModule_ConfigService + MetricsModule_MetricsController -.->|injects| MetricsModule_MetricsService + RedisModule -->|imports| MetricsModule + RedisModule_RedisClient -.->|injects| ConfigModule_ConfigService + RedisModule_RedisClient -.->|injects| MetricsModule_MetricsService + UsersModule -->|imports| DatabaseModule + UsersModule -->|imports| RedisModule + UsersModule -->|imports| MetricsModule + UsersModule_UsersRepository -.->|injects| DatabaseModule_DatabaseClient + UsersModule_UsersService -.->|injects| UsersModule_UsersRepository + UsersModule_CurrentUserGuard -.->|injects| RedisModule_RedisClient + UsersModule_CurrentUserGuard -.->|injects| UsersModule_UsersService + UsersModule_CurrentUserGuard -.->|injects| MetricsModule_MetricsService + UsersModule_UsersController -.->|injects| UsersModule_UsersService + AuthModule -->|imports| UsersModule + AuthModule -->|imports| DatabaseModule + AuthModule -->|imports| RedisModule + AuthModule -->|imports| MetricsModule + AuthModule_AuthService -.->|injects| UsersModule_UsersService + AuthModule_AuthService -.->|injects| AuthModule_SessionRepository + AuthModule_SessionRepository -.->|injects| RedisModule_RedisClient + AuthModule_SessionRepository -.->|injects| ConfigModule_ConfigService + AuthModule_SessionRepository -.->|injects| MetricsModule_MetricsService + AuthModule_AuthController -.->|injects| AuthModule_AuthService + HealthModule -->|imports| DatabaseModule + HealthModule -->|imports| RedisModule + HealthModule_HealthService -.->|injects| DatabaseModule_DatabaseClient + HealthModule_HealthService -.->|injects| RedisModule_RedisClient + HealthModule_HealthService -.->|injects| ConfigModule_ConfigService + HealthModule_HealthController -.->|injects| HealthModule_HealthService + ChatsModule -->|imports| UsersModule + ChatsModule -->|imports| DatabaseModule + ChatsModule -->|imports| RedisModule + ChatsModule -->|imports| MetricsModule + ChatsModule_ChatsRepository -.->|injects| DatabaseModule_DatabaseClient + ChatsModule_ChatsService -.->|injects| ChatsModule_ChatsRepository + ChatsModule_ChatsController -.->|injects| ChatsModule_ChatsService + MessagesModule -->|imports| ChatsModule + MessagesModule -->|imports| MessagesCacheModule + MessagesModule -->|imports| DatabaseModule + MessagesModule -->|imports| UsersModule + MessagesModule -->|imports| RedisModule + MessagesModule -->|imports| MetricsModule + MessagesModule_MessagesRepository -.->|injects| DatabaseModule_DatabaseClient + MessagesModule_MessagesService -.->|injects| MessagesModule_MessagesRepository + MessagesModule_MessagesService -.->|injects| ChatsModule_ChatsService + MessagesModule_MessagesService -.->|injects| MessagesCacheModule_MessagesCacheService + MessagesModule_MessagesController -.->|injects| MessagesModule_MessagesService + MessagesCacheModule -->|imports| RedisModule + MessagesCacheModule -->|imports| MetricsModule + MessagesCacheModule_MessagesCacheService -.->|injects| RedisModule_RedisClient + MessagesCacheModule_MessagesCacheService -.->|injects| ConfigModule_ConfigService + MessagesCacheModule_MessagesCacheService -.->|injects| MetricsModule_MetricsService diff --git a/evidence/README.md b/evidence/README.md index 8df70015..c375bb5a 100644 --- a/evidence/README.md +++ b/evidence/README.md @@ -1,5 +1,56 @@ -# Доказательства +# Индекс доказательств -Храните небольшие обезличенные результаты: команды и stdout проверок, JSON/CSV агрегатов нагрузки, EXPLAIN, dashboard JSON, текст разбора отказа. Укажите дату, commit, аппаратные лимиты и профиль нагрузки. +Санитизированные доказательства по лабораторной 2 (трек 1, оценка 5). -Не добавляйте .env, session tokens, cookies, приватные ключи, credentials, реальные сообщения, raw dumps и signed URLs. Для скриншотов скрывайте секреты. Большие логи/бинарные traces сохраняйте отдельно по правилам преподавателя; одного скриншота без методики недостаточно. +| Файл | Что доказывает | +| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`track1-cache-consistency.md`](track1-cache-consistency.md) | Трек 1: окружение, методика, счётчики и латентность по каждой повторности для naive и protected, сравнение, read-after-write, восстановление после рестарта Redis, план запроса, хеши артефактов, ограничения. | +| [`level3-4-verification.md`](level3-4-verification.md) | Проверки уровня 3/4 с наблюдаемым выводом команд: контракт, сборка и тесты, миграции, публичный smoke, persistence-перезапуск, чёрно-белый интеграционный набор, истечение TTL, гонка username, rollback, отказы зависимостей, `EXPLAIN`, endpoint метрик, а также дефекты, найденные этим аудитом. | +| [`track1-explain.md`](track1-explain.md) | Тексты анализируемых SQL-запросов, подготовка 10 000 синтетических строк и сырой `EXPLAIN (ANALYZE, BUFFERS)`: `Index Scan using messages_chat_created_id_idx` для первой страницы и для продолжения по keyset-cursor. | +| [`../bruno/README.md`](../bruno/README.md) | Коллекция ручных запросов Bruno ко всем эндпоинтам (28 запросов / 56 проверок, все зелёные) — удобно для разбора API вручную. | +| `track1-raw/naive.json` (в Git не попадает) | Сырой вывод бенчмарка для `CACHE_MODE=naive`. | +| `track1-raw/protected.json` (в Git не попадает) | Сырой вывод бенчмарка для `CACHE_MODE=protected`. | +| `track1-raw/redis-restart.json` (в Git не попадает) | Сырой вывод проверки рестарта Redis. | + +## Полная регенерация + +```sh +# 1. Стенд +cp .env.example .env +password=$(openssl rand -hex 32) +sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$password/" .env +sed -i "s|^DATABASE_URL=.*|DATABASE_URL=postgresql://messenger:$password@postgres:5432/messenger|" .env +sed -i "s/^METRICS_TOKEN=.*/METRICS_TOKEN=$(openssl rand -hex 16)/" .env +docker compose --env-file .env up -d --build +curl -fsS http://localhost:8080/health/ready + +# 2. Приёмка и сохранность +make check && make validate +make test BASE_URL=http://localhost:8080 +chmod +x scripts/restart.sh +make test-persistence ACTION_SCRIPT=scripts/restart.sh + +# 3. Тесты приложения +(cd app && npm run build && npm test && npx tsc --noEmit) + +# 4. Интеграционный набор (реальные PostgreSQL/Redis; порты наружу не публикуются) +docker inspect --format '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' mtusi2026lab2-postgres-1 mtusi2026lab2-redis-1 +(cd app && API_BASE_URL=http://localhost:8080 \ + DATABASE_URL=postgresql://messenger:$password@:5432/messenger \ + REDIS_URL=redis://:6379 npx vitest run --config ./vitest.config.e2e.ts) + +# 5. Трек 1 +printf '%s' "$METRICS_TOKEN" > /tmp/track1-metrics-token # METRICS_TOKEN из .env +CACHE_MODE=naive CACHE_MISS_DELAY_MS=75 docker compose --env-file .env up -d api +python3 scripts/track1_cache_benchmark.py --base-url http://localhost:8080 --mode naive \ + --concurrency 32 --repetitions 5 --metrics-token-file /tmp/track1-metrics-token \ + --output evidence/track1-raw/naive.json +CACHE_MODE=protected docker compose --env-file .env up -d api +python3 scripts/track1_cache_benchmark.py --base-url http://localhost:8080 --mode protected \ + --concurrency 32 --repetitions 5 --metrics-token-file /tmp/track1-metrics-token \ + --output evidence/track1-raw/protected.json +python3 scripts/track1_verify.py --restart-redis --evict-cache \ + --output evidence/track1-raw/redis-restart.json +``` + +Точки входа для ревьюера: `README.md` (задание), `REPORT.md` (решение), этот индекс. Публичные `contracts/` и `tests/` не изменялись. diff --git a/evidence/level3-4-verification.md b/evidence/level3-4-verification.md new file mode 100644 index 00000000..1656b8d1 --- /dev/null +++ b/evidence/level3-4-verification.md @@ -0,0 +1,211 @@ +# Журнал проверок уровня 3/4 + +Индекс всех доказательств — [`README.md`](README.md); сводка решения — [`../REPORT.md`](../REPORT.md); методика и числа трека 1 — [`track1-cache-consistency.md`](track1-cache-consistency.md). + +Запись по командам, на которых основано заявление об оценке 5 (уровень 4 плюс трек 1). Все пункты выполнены на локальном Compose-стенде; значения ниже скопированы из наблюдавшегося вывода, а не выведены из кода. + +Окружение: Node 25.7.0 (`node:25.7.0-slim`), `postgres:16.4-alpine`, `redis:7.4.2-alpine`, Python 3.14.7, Linux x86_64. Тома `postgres-data` и `redis-data` между проверками сохраняются. + +## 1. Структура репозитория и контракт + +```text +$ make check +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. + +$ make validate +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. +``` + +## 2. Сборка приложения и unit-тесты + +```text +$ (cd app && npm run build) +nest build -> PASS + +$ (cd app && npm test) +Test Files 5 passed (5) +Tests 13 passed (13) + +$ (cd app && npx tsc --noEmit) +PASS (диагностик нет) +``` + +Что покрыто unit-тестами: снапшот метрик/процентили/ограничение буфера, изоляция страниц кэша, cursor-scope lock, деградация кэша при недоступности Redis, дельты счётчиков. + +## 3. Compose-стенд и миграции + +```text +$ docker compose --env-file .env config --quiet +PASS + +$ docker compose --env-file .env up -d --build +postgres Up (healthy) +redis Up (healthy) +migrate Exited (0) +api Up (healthy) + +$ curl -fsS http://localhost:8080/health/ready +{"status":"ok"} + +$ docker compose exec -T postgres psql -U messenger -d messenger -c 'SELECT version FROM schema_migrations ORDER BY version;' +001_initial.sql +002_timestamp_precision.sql +``` + +Повторные `up`/`restart` снова запускают сервис миграций, но без дублирования данных и без сидов: применённые версии записаны в `schema_migrations` и пропускаются, а сам SQL миграций идемпотентен (`CREATE TABLE IF NOT EXISTS`, `ALTER COLUMN TYPE`). + +## 4. Публичный приёмочный сценарий + +```text +$ make test BASE_URL=http://localhost:8080 +PASS: lab2 public API scenario; infrastructure and grading evidence remain separate. +``` + +Сценарий покрывает health, регистрацию с паролем, Basic-вход, Bearer-идентичность, видимость чатов, пагинацию сообщений, 401 без сессии, 401 для Basic на бизнес-endpoint, отсутствие подмены владельца через `X-User-Id`, а также logout и повторное использование токена. + +## 5. Сохранность после полного перезапуска + +```text +$ chmod +x scripts/restart.sh +$ make test-persistence ACTION_SCRIPT=scripts/restart.sh +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. +``` + +Хук — это `docker compose --env-file .env restart postgres redis api` и затем `up -d --no-recreate --no-deps --wait`; он не удаляет тома, не выполняет сиды и не вызывает `FLUSHALL`. Тест держит токен только в памяти и после перезапуска читает им то же сообщение. + +## 6. Чёрно-белый интеграционный набор против реальных PostgreSQL и Redis + +```text +$ (cd app && API_BASE_URL=http://localhost:8080 \ + DATABASE_URL=postgresql://messenger:@:5432/messenger \ + REDIS_URL=redis://:6379 \ + npx vitest run --config ./vitest.config.e2e.ts) +Test Files 1 passed (1) +Tests 7 passed | 1 skipped (8) +``` + +Покрыто: challenge для Basic/Bearer с точными значениями `WWW-Authenticate`, некорректный Basic, запрет тела при создании сессии, пароль с Unicode и двоеточием, гонка дублирующейся регистрации, подмена `X-User-Id`, повторное использование токена после logout, чужой чат скрыт (404), неизвестные и дублирующиеся участники, пробельный текст и подмена отправителя, read-after-write через вторую сессию, сломанный JSON, некорректные cursor/limit, keyset-пагинация без повторов. + +Набор читает `API_BASE_URL`, потому что Vitest сам устанавливает `process.env.BASE_URL` в значение Vite base (`/`). Порты PostgreSQL и Redis наружу не публикуются, поэтому оператор передаёт адреса контейнеров. + +## 7. Истечение сессии при коротком TTL + +```text +$ sed -i 's/^SESSION_TTL_SECONDS=.*/SESSION_TTL_SECONDS=2/' .env +$ docker compose up -d api +$ (cd app && API_BASE_URL=http://localhost:8080 ... SESSION_TTL_SECONDS=2 npx vitest run --config ./vitest.config.e2e.ts) +Test Files 1 passed (1) +Tests 8 passed (8) +``` + +Кейс истечения: регистрация, вход, ожидание 2,3 с, ожидание `401 unauthorized` с Bearer-challenge. Работают и TTL Redis, и сериализованный `expires_at`. После проверки TTL возвращён в 3600. + +## 8. Гонка одинакового username + +```text +statuses: [201, 409] +rows in users for that username: 1 +constraint: CREATE UNIQUE INDEX users_username_key ON public.users USING btree (username) +``` + +Два одновременных `POST /api/v1/users` с одинаковым username: ровно один `201`, проигравший получает `409` (ошибка PostgreSQL `23505` маппится в `ConflictException`), а не `500`. Уникальность обеспечивает unique-индекс базы, а не предварительный `SELECT`, который был бы подвержен гонке. Интеграционный тест дополнительно проверяет, что в таблице ровно одна строка. + +## 9. Атомарность создания чата (rollback) + +```text +chat with unknown member -> 400 +rows left after rollback -> 0 +``` + +`POST /api/v1/chats` с неизвестным участником падает на валидации внутри транзакции: ни строки в `chats`, ни строк в `chat_members` не остаётся. + +## 10. Отказы зависимостей + +Остановлен Redis (`docker compose stop redis`): + +```text +/health/ready -> 503 +GET /users/me (валидный токен) -> 503 # анонимный доступ не выдаётся +после `docker compose start redis` -> /health/ready 200 +``` + +Остановлен PostgreSQL (`docker compose stop postgres`): + +```text +/health/ready -> 503 +GET /users/me (валидный токен) -> 503 +состояние процесса -> контейнер api остался Up (падения нет) +после `docker compose start postgres` -> /health/ready 200, тот же токен -> 200 +``` + +Здесь найден и исправлен реальный дефект: idle-клиент пула эмитил `error` на пул, Node считал это необработанным исключением, и процесс API завершался. Теперь `DatabaseClient` регистрирует `pool.on('error')` (счётчик `database.pool_error` + `warn` в лог), а ошибки доступности БД маппятся в ограниченную `503` в `ApiExceptionFilter` вместо `500`. + +Путь деградации кэша (Redis недоступен → ответ из PostgreSQL, счётчик `cache_fallback`) подтверждён unit-тестами, а не этим экспериментом: при остановленном Redis бизнес-запрос останавливается раньше, на session guard, и по дизайну получает `503`, поэтому до слоя кэша не доходит. + +## 11. План запроса истории + +```text +$ docker compose exec -T postgres psql -U messenger -d messenger -f - < /tmp/track1-explain.sql +=== Запрос A: первая страница истории === + Limit (cost=0.28..112.30 rows=51 width=77) (actual time=0.020..0.028 rows=51 loops=1) + -> Index Scan using messages_chat_created_id_idx on messages (actual rows=51) + Execution Time: 0.040 ms +=== Запрос B: продолжение по keyset-cursor === + Limit (cost=0.28..8.30 rows=1 width=77) (actual time=0.008..0.014 rows=51 loops=1) + -> Index Scan using messages_chat_created_id_idx on messages (actual rows=51) + Index Cond: ((chat_id = ...) AND (ROW(created_at, id) > ROW(...))) + Execution Time: 0.048 ms +``` + +Для снятия планов в один чат вставлено 10 000 синтетических сообщений, после захвата они удалены (`DELETE 10000`). Полный файл с текстом анализируемых запросов и подготовкой данных: `evidence/track1-explain.md`. + +## 12. Endpoint метрик + +```text +$ curl -H "Authorization: Bearer $METRICS_TOKEN" http://localhost:8080/internal/metrics +observed counters: cache_miss, chats.findForUser, chats.listForUser, health.database, + messages.history, messages.version, redis.del, redis.get, redis.ping, redis.set, + redis.unlock, request_count, session_del, session_get, session_set, + users.findById, users.findByUsername, users.insert +latency: {count: 25, sample_count: 25, p50: 2.82, p95: 50.71, p99: 52.74, max: 52.74} +``` + +Без корректного `METRICS_TOKEN` endpoint отдаёт `401`; в ответе нет токенов, кредов, тел запросов и SQL-текста. + +Тот же путь проверен ручным клиентом Bruno (`bruno/README.md`): из корня коллекции +`bru run -r --env-var metricsToken=` дал 28 запросов и +56 проверок без падений (регистрация трёх пользователей, три Basic-сессии, чат, +сообщения с пагинацией, метрики и негативные сценарии). `baseUrl` и пароль +подставляются на уровне коллекции (`bruno/collection.bru`), поэтому вводить адрес +в каждой ручке не требуется; без реального токена метрик два запроса к +`/internal/*` возвращают 401 — это ожидаемо. Прогон вскрыл расхождение: +`POST /internal/metrics/reset` отвечал `201` (дефолт Nest для POST), хотя это действие, +а не создание ресурса; добавлен `@HttpCode(HttpStatus.OK)`, теперь `200`. + +## 13. Дефекты, найденные этим аудитом и исправленные + +| Дефект | Симптом | Исправление | +|---|---|---| +| Отсутствовали DI-импорты зависимостей `CurrentUserGuard` | контейнер API `Exited (1)` с `UnknownDependenciesException` | `ChatsModule`/`MessagesModule` импортируют `RedisModule`, `MetricsModule`; `UsersModule` их реэкспортирует | +| Микросекунды PostgreSQL против миллисекунд JavaScript | вторая страница истории повторяла последнее сообщение (`make test` падал) | миграция `002_timestamp_precision.sql` → `timestamptz(3)` | +| Regex курсора требовал строго version 4 | валидные курсоры отклонялись как `400 invalid_request` | regex принимает любую корректную форму UUID плюс строгий RFC 3339 UTC timestamp | +| Необработанное событие `error` пула | процесс API умирал при недоступности PostgreSQL | обработчик `pool.on('error')` (счётчик `database.pool_error` + `warn`), отказ маппится в `503` | +| «Тихие» блоки `catch` | деградация кэша и зависимостей была невидима | счётчики (`cache_fallback`, `cache_write_error`, `cache_unlock_error`, `cache_lock_timeout`, `cache_corrupt_entry`, `database.pool_error`, `database.rollback_error`, `redis.error`) + `warn`-логи | +| Мёртвое состояние `lastError`, `getLastError()`, `isReady()` | заполнялось и нигде не читалось | удалено; листенеры пишут лог и счётчик | +| `POST /internal/metrics/reset` отвечал `201` | действие возвращало статус создания ресурса (нашлось прогоном коллекции Bruno) | добавлен `@HttpCode(HttpStatus.OK)`, теперь `200` | +| `nest build` не копировал `.sql`-миграции в `dist/` | локальный запуск `node dist/database/migration.runner.js` упал бы: каталога миграций в `dist/` нет, работал только Docker за счёт отдельного `COPY` | в `nest-cli.json` добавлен `assets: database/migrations/*.sql → dist`, лишний `COPY` из `Dockerfile` убран; проверено `docker run --rm --entrypoint ls mtusi-messenger:lab2 dist/database/migrations` и повторным запуском runner (exit 0) | + +## 14. Инвентарь артефактов + +| Артефакт | Назначение | +| ---------------------------------------- | --------------------------------------------------------- | +| `evidence/track1-cache-consistency.md` | подробный отчёт по треку 1 с таблицами по повторностям | +| `evidence/track1-raw/naive.json` | сырой прогон naive (в Git не попадает) | +| `evidence/track1-raw/protected.json` | сырой прогон protected (в Git не попадает) | +| `evidence/track1-raw/redis-restart.json` | сырая проверка рестарта Redis (в Git не попадает) | +| `evidence/track1-explain.md` | запросы и `EXPLAIN (ANALYZE, BUFFERS)` | +| `bruno/README.md` | коллекция ручных запросов (Bruno) ко всем эндпоинтам | +| `REPORT.md` | основной отчёт: архитектура, решения, команды, результаты | + +Хеши сырых артефактов перечислены в `evidence/track1-cache-consistency.md` §8. diff --git a/evidence/track1-cache-consistency.md b/evidence/track1-cache-consistency.md new file mode 100644 index 00000000..6b3cf943 --- /dev/null +++ b/evidence/track1-cache-consistency.md @@ -0,0 +1,181 @@ +# Трек 1: согласованность кэша (подробные доказательства) + +Индекс всех доказательств — [`README.md`](README.md); сводка решения и критериев — [`../REPORT.md`](../REPORT.md); чек-лист сдачи — [`../.github/pull_request_template.md`](../.github/pull_request_template.md). + +Санитизированные результаты локального Compose-стенда. + +## 1. Окружение + +| Параметр | Значение | +| ----------------------------- | ------------------------------------------------------------------------------------ | +| Хост | Linux x86_64, ядро 7.2.7-100.fc43 | +| Python (клиент бенчмарка) | 3.14.7 | +| Runtime API | Node.js 25.7.0 (`node:25.7.0-slim`), NestJS 12 + Fastify | +| PostgreSQL | `postgres:16.4-alpine`, именованный том `postgres-data` | +| Redis | `redis:7.4.2-alpine`, AOF `appendonly yes`, `appendfsync everysec`, том `redis-data` | +| Задержка промаха | `CACHE_MISS_DELAY_MS=75` — действует **только в naive-пути** (пауза между промахом и запросом в PostgreSQL); protected-путь её не использует | +| TTL кэша | `CACHE_TTL_SECONDS=30` | +| TTL lock | `CACHE_LOCK_TTL_MS=1000` | +| TTL сессии | `SESSION_TTL_SECONDS=3600` | + +Оба режима измерялись на одном стенде и одной базе; переключался только `CACHE_MODE` (переменная окружения при пересоздании контейнера `api`), отдельного compose-профиля нет. + +## 2. Методика + +1. Два пользователя регистрируются со случайным паролем и логинятся через Basic (`track1_cache_benchmark.py`). +2. Создаётся чат, содержащий оба ID; до измерений прогревается отдельная страница истории. +3. Повторности: 5. Каждая повторность создаёт **новый чат** с 1 сообщением, поэтому измеряемый ключ холодный без `FLUSHALL` и без ручной эвикции кэша. +4. `POST /internal/metrics/reset` обнуляет счётчики; `GET /internal/metrics` читается до и после всплеска. +5. 32 конкурентных `GET /api/v1/chats/{id}/messages?limit=50` освобождаются `threading.Barrier`, то есть все читатели бьют в один холодный ключ одновременно. +6. По каждой повторности фиксируются латентности успешных запросов и ошибки. +7. В том же прогоне проверяется read-after-write: греется старая страница, публикуется новое сообщение, затем страница сразу перечитывается **второй действующей сессией**. + +Примечание о воспроизводимости: записанные ниже прогоны запускались с overlay-файлом, который выставлял ровно две переменные контейнера `api` — `CACHE_MODE` и `CACHE_MISS_DELAY_MS=75`. Сейчас тот же результат даёт переопределение из shell без отдельного файла (команды в §9); поведение контейнера идентично. + +Счётчики локальны процессу и сбрасываются перед каждой повторностью; дельты ниже не включают сам вызов сброса. + +## 3. Результаты по повторностям + +### naive (без блокировки, чистый cache-aside) + +| Повтор | Успешных | Ошибок | `messages.history` | `cache_miss` | `cache_hit` | `cache_lock_wait` | p50, мс | p95, мс | p99, мс | +| -----: | -------: | -----: | -----------------: | -----------: | ----------: | ----------------: | ------: | ------: | ------: | +| 1 | 32 | 0 | 32 | 32 | 0 | 0 | 116.862 | 120.132 | 120.575 | +| 2 | 32 | 0 | 32 | 32 | 0 | 0 | 89.730 | 98.924 | 99.283 | +| 3 | 32 | 0 | 32 | 32 | 0 | 0 | 88.007 | 96.125 | 96.450 | +| 4 | 32 | 0 | 32 | 32 | 0 | 0 | 89.418 | 96.318 | 96.781 | +| 5 | 32 | 0 | 32 | 32 | 0 | 0 | 87.892 | 94.654 | 95.192 | +| **Σ** | **160** | **0** | **160** | **160** | **0** | **0** | — | — | — | + +Каждый холодный читатель промахивался и выполнял свой SQL-запрос истории: число запросов равно числу конкурентных читателей. + +### protected (версионированный ключ + lock на конкретную страницу, NX/PX) + +| Повтор | Успешных | Ошибок | `messages.history` | `cache_miss` | `cache_hit` | `cache_lock_wait` | p50, мс | p95, мс | p99, мс | +| -----: | -------: | -----: | -----------------: | -----------: | ----------: | ----------------: | ------: | ------: | ------: | +| 1 | 32 | 0 | 1 | 2 | 31 | 1 | 35.607 | 38.285 | 52.027 | +| 2 | 32 | 0 | 1 | 11 | 31 | 10 | 20.404 | 37.166 | 37.178 | +| 3 | 32 | 0 | 1 | 10 | 31 | 9 | 18.170 | 35.897 | 36.559 | +| 4 | 32 | 0 | 1 | 12 | 31 | 11 | 20.513 | 37.058 | 37.455 | +| 5 | 32 | 0 | 1 | 11 | 31 | 10 | 19.435 | 35.451 | 36.281 | +| **Σ** | **160** | **0** | **5** | **46** | **155** | **41** | — | — | — | + +Как читать счётчики: + +- `messages.history = 1` на повторность: страницу из PostgreSQL заполнил ровно один владелец lock. +- `cache_hit = 31` на повторность: остальные 31 читателя получили страницу владельца (повторное чтение под lock или ожидание). +- `cache_miss` (10–12) и `cache_lock_wait` (9–11) больше единицы потому, что ожидающий считает промах на своём первом `GET` и ожидание на первой неудачной попытке `SET NX`; ни то, ни другое не означает дополнительный SQL-запрос. +- `cache_lock_timeout` и `cache_fallback` остались нулевыми: никто не ушёл в PostgreSQL напрямую, владелец успел опубликовать страницу за отведённые повторы. + +## 4. Сравнение + +| Метрика | naive | protected | Изменение | +| ------------------------------- | --------: | --------: | ----------- | +| SQL-запросов `messages.history` | 160 | 5 | **−96,9 %** | +| Попаданий в кэш | 0 | 155 | — | +| Промахов | 160 | 46 | −71,3 % | +| Ожиданий lock | 0 | 41 | — | +| Успешных запросов | 160 | 160 | — | +| Ошибок | 0 | 0 | — | +| p50 (медиана по повторностям) | ≈ 89,4 мс | ≈ 20,4 мс | −77 % | +| p95 (медиана по повторностям) | ≈ 96,3 мс | ≈ 37,1 мс | −61 % | + +Гипотеза для этой нагрузки подтверждена: без защиты каждый конкурентный холодный читатель выполняет собственный SQL-запрос истории; с lock на конкретную страницу запрос к PostgreSQL делает только владелец, остальные обслуживаются из Redis. + +Про латентность: разница p50/p95 между режимами **включает** искусственную паузу `CACHE_MISS_DELAY_MS=75`, которая применяется только в naive-пути (protected её не использует). Поэтому латентность здесь — иллюстрация эффекта stampede, а не сравнение скорости реализации; независимое от этой настройки наблюдение — число SQL-запросов истории (160 против 5). + +## 5. Read-after-write + +```json +{ "asserted": true, "stale_observed": false } +``` + +Наблюдалось в обоих прогонах (naive и protected). Путь записи коммитит сообщение и увеличивает `chats.message_version` в одной транзакции; путь чтения строит ключ кэша из текущей версии, поэтому страница, закэшированная до записи, становится недостижимой. Конкурентный GET, начавшийся до коммита, может вернуть прежний снимок — это допустимо контрактом. + +## 6. Рестарт Redis и восстановление кэша + +`python3 scripts/track1_verify.py --restart-redis --evict-cache --output evidence/track1-raw/redis-restart.json`: + +```json +{ + "restart_redis": true, + "cache_eviction": { "requested": true, "message_keys_deleted": 9 }, + "same_token_users_me": true, + "history_equal": true, + "history_item_count": 1 +} +``` + +Последовательность: вход → отправка сообщения → чтение истории → `docker compose restart redis` → ожидание готовности → удаление только ключей `messages:*` через `redis-cli --scan` → повторное чтение `/api/v1/users/me` и истории **тем же bearer-токеном**. Сессия выжила благодаря AOF и сохранённому тому; производный кэш истории перезагрузился из PostgreSQL, вернувшаяся страница идентична. `FLUSHALL` и удаление томов не используются. + +## 7. План запроса истории + +`EXPLAIN (ANALYZE, BUFFERS)` на чате с 10 002 сообщениями (полностью — `evidence/track1-explain.md`, текст анализируемых запросов и подготовка данных там же): + +```text +=== Запрос A: первая страница истории === + Limit (cost=0.28..112.30 rows=51 width=77) (actual time=0.020..0.028 rows=51 loops=1) + Buffers: shared hit=5 + -> Index Scan using messages_chat_created_id_idx on messages (actual time=0.020..0.025 rows=51) + Index Cond: (chat_id = '...'::uuid) + Buffers: shared hit=5 + Execution Time: 0.040 ms + +=== Запрос B: продолжение по keyset-cursor === + Limit (cost=0.28..8.30 rows=1 width=77) (actual time=0.008..0.014 rows=51 loops=1) + Buffers: shared hit=4 + -> Index Scan using messages_chat_created_id_idx on messages (actual time=0.008..0.012 rows=51) + Index Cond: ((chat_id = '...'::uuid) AND (ROW(created_at, id) > ROW('...'::timestamptz, '...'::uuid))) + Buffers: shared hit=4 + Execution Time: 0.048 ms +``` + +Оба запроса идут по композитному индексу `(chat_id, created_at, id)`; keyset-предикат продолжения попадает в `Index Cond`, поэтому следующая страница не пересканирует уже прочитанное. Страница ограничена 51 строкой (limit + 1), полной материализации истории нет. Синтетические строки удалены после снятия планов (`DELETE 10000`). + +## 8. Артефакты и происхождение данных + +| Артефакт | sha256 | Примечание | +| ---------------------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------- | +| `evidence/track1-raw/naive.json` | `afc08f21d877952fd527675a08d4192b5143841e7833a56f1b922d836b74ba64` | сырой прогон naive, в Git не попадает | +| `evidence/track1-raw/protected.json` | `d5cdb39802414cb3f04289d04167c6177081a79011a919ab40349c5b280ab303` | сырой прогон protected, в Git не попадает | +| `evidence/track1-raw/redis-restart.json` | `09e8e8539d148cc6175131dea80c21a7d38d8fed370507a01eeff6a01c93c56f` | сырая проверка рестарта Redis, в Git не попадает | +| `evidence/track1-explain.md` | `7e7f9f4ba45de05bf356696f538a346ca1c59c8913bf81bff4204bbd84c33b60` | запросы + `EXPLAIN (ANALYZE, BUFFERS)` + подготовка 10 000 строк | + +Сырые JSON не коммитятся, потому что содержат локальные идентификаторы (строка платформы, тайминговые отпечатки, пути контейнеров). Хеши выше позволяют убедиться, что сводка соответствует именно тому прогону, который её породил. + +## 9. Воспроизведение + +```sh +mkdir -p evidence/track1-raw +printf '%s' "$METRICS_TOKEN" > /tmp/track1-metrics-token # METRICS_TOKEN из .env + +CACHE_MODE=naive CACHE_MISS_DELAY_MS=75 docker compose --env-file .env up -d api +python3 scripts/track1_cache_benchmark.py --base-url http://localhost:8080 --mode naive \ + --concurrency 32 --repetitions 5 --metrics-token-file /tmp/track1-metrics-token \ + --runtime-version node=25.7.0 --runtime-version postgres=16.4 --runtime-version redis=7.4.2 \ + --output evidence/track1-raw/naive.json + +CACHE_MODE=protected docker compose --env-file .env up -d api +python3 scripts/track1_cache_benchmark.py --base-url http://localhost:8080 --mode protected \ + --concurrency 32 --repetitions 5 --metrics-token-file /tmp/track1-metrics-token \ + --runtime-version node=25.7.0 --runtime-version postgres=16.4 --runtime-version redis=7.4.2 \ + --output evidence/track1-raw/protected.json + +python3 scripts/track1_verify.py --summary \ + --naive-raw evidence/track1-raw/naive.json --protected-raw evidence/track1-raw/protected.json \ + --output evidence/track1-cache-consistency.md + +python3 scripts/track1_verify.py --restart-redis --evict-cache \ + --output evidence/track1-raw/redis-restart.json +``` + +После измерений достаточно вернуть штатные значения: `docker compose --env-file .env up -d api` (в `.env` лежат `CACHE_MODE=protected`, `CACHE_MISS_DELAY_MS=0`). + +## 10. Ограничения + +- Замеры на одном хосте (closed-loop, конкуренция 32, 5 повторностей): это не production-пропускная способность и не поведение часов между хостами. +- Латентность naive включает искусственную паузу `CACHE_MISS_DELAY_MS=75`; сравнение режимов по числу SQL-запросов от этой настройки не зависит. +- В процентили латентности попадают только успешные запросы; ошибки считаются отдельно (в этих прогонах их 0). +- Латентность включает накладные расходы Python-клиента и сети контейнеров. +- Бенчмарк доказывает эффект stampede для одной холодной страницы на повторность; независимость разных cursor/limit/version проверена unit-тестами, а не этой нагрузкой. +- Метрики принадлежат конкретному процессу API: при нескольких репликах нельзя суммировать счётчики как распределённый снимок. diff --git a/evidence/track1-explain.md b/evidence/track1-explain.md new file mode 100644 index 00000000..6e067b28 --- /dev/null +++ b/evidence/track1-explain.md @@ -0,0 +1,120 @@ +# EXPLAIN (ANALYZE, BUFFERS) для запроса истории сообщений + +Назначение: доказать, что история читается по композитному индексу +`messages_chat_created_id_idx (chat_id, created_at, id)`, а не полным сканом всех +сообщений чата, и что keyset-условие продолжения тоже попадает в индекс. + +Стенд: `postgres:16.4-alpine`, том `postgres-data`, 10 000 синтетических сообщений +в одном чате (плюс реальные данные стенда). Снимок снят на текущей схеме, включая +миграцию `002_timestamp_precision.sql` (`timestamptz(3)`), поэтому в плане B видно +`ROW(created_at, id) > ROW(...)`. + +## Анализируемые запросы + +Это ровно те SQL-формы, которые выполняет `MessagesRepository.findPage` +(`app/src/messages/messages.repository.ts`); параметры передаются через `$1..$4`, +конкатенации пользовательского ввода нет. + +```sql +-- Запрос A: первая страница истории (cursor отсутствует) +SELECT id, chat_id, sender_id, text, created_at +FROM messages +WHERE chat_id = $1 +ORDER BY created_at, id +LIMIT $2; + +-- Запрос B: продолжение по keyset-cursor (следующая страница) +SELECT id, chat_id, sender_id, text, created_at +FROM messages +WHERE chat_id = $1 + AND (created_at, id) > ($2::timestamptz, $3::uuid) +ORDER BY created_at, id +LIMIT $4; +``` + +В захвате параметры подставлены через `PREPARE`/`EXECUTE`: +`$2 = 51` (limit + 1 — приложение запрашивает на одну строку больше, чтобы понять, +есть ли следующая страница), для запроса B `$2/$3` — реальная пара +`(created_at, id)` из середины синтетического диапазона. + +## Подготовка синтетических данных + +```sql +WITH target AS (SELECT cm.chat_id, cm.user_id FROM chat_members cm LIMIT 1), +seeded AS ( + INSERT INTO messages (id, chat_id, sender_id, text, created_at) + SELECT ('00000000-0000-4000-8000-' || lpad(to_hex(g), 12, '0'))::uuid, + target.chat_id, target.user_id, 'track1-explain', + now() + (g || ' milliseconds')::interval + FROM generate_series(1, 10000) g CROSS JOIN target + RETURNING id +) +SELECT count(*) AS inserted FROM seeded; + +CREATE INDEX messages_chat_created_id_idx ON messages (chat_id, created_at, id); -- из миграции 001_initial.sql +``` + +## Результат + +```text + inserted +---------- + 10000 +(1 row) + +PREPARE +PREPARE +=== Запрос A: первая страница истории === + QUERY PLAN +--------------------------------------------------------------------------------------------------------------------------------------------------- + Limit (cost=0.28..112.30 rows=51 width=77) (actual time=0.020..0.028 rows=51 loops=1) + Buffers: shared hit=5 + -> Index Scan using messages_chat_created_id_idx on messages (cost=0.28..549.37 rows=250 width=77) (actual time=0.020..0.025 rows=51 loops=1) + Index Cond: (chat_id = 'd134df82-e5ba-4cba-9507-7a9756dfe43f'::uuid) + Buffers: shared hit=5 + Planning: + Buffers: shared hit=6 + Planning Time: 0.071 ms + Execution Time: 0.040 ms +(9 rows) + +=== Запрос B: продолжение по keyset-cursor === + QUERY PLAN +-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- + Limit (cost=0.28..8.30 rows=1 width=77) (actual time=0.008..0.014 rows=51 loops=1) + Buffers: shared hit=4 + -> Index Scan using messages_chat_created_id_idx on messages (cost=0.28..8.30 rows=1 width=77) (actual time=0.008..0.012 rows=51 loops=1) + Index Cond: ((chat_id = 'd134df82-e5ba-4cba-9507-7a9756dfe43f'::uuid) AND (ROW(created_at, id) > ROW('2026-10-08 20:59:52.579+00'::timestamp with time zone, '00000000-0000-4000-8000-000000001389'::uuid))) + Buffers: shared hit=4 + Planning Time: 0.058 ms + Execution Time: 0.048 ms +(7 rows) + +=== Очистка синтетических данных === +DEALLOCATE ALL +DELETE 10000 +``` + +## Выводы + +- Оба запроса используют `Index Scan using messages_chat_created_id_idx`; `Bitmap` + и `Seq Scan` по `messages` в плане отсутствуют. +- Keyset-условие `(created_at, id) > ($2, $3)` попадает в `Index Cond`, поэтому + продолжение истории не пересканирует уже прочитанные строки: `shared hit=4`. +- Читается ровно страница (51 строк), полной материализации истории чата нет: + `actual rows=51` при `Limit 51`. +- Узла `Sort` в плане нет: порядок индекса совпадает с `ORDER BY created_at, id`, + поэтому PostgreSQL читает страницу уже в нужном порядке. (В более раннем снимке + с `Bitmap Heap Scan` сортировка появлялась как `top-N heapsort` — это следствие + bitmap-плана, а не свойства запроса.) +- Синтетические строки удалены после снятия планов (`DELETE 10000`); данные стенда + не изменились. + +## Воспроизведение + +```sh +docker compose exec -T postgres psql -U messenger -d messenger -v ON_ERROR_STOP=1 -f - < /tmp/track1-explain.sql +``` + +Файл `/tmp/track1-explain.sql` — тот же скрипт, что приведён выше (insert → +`PREPARE` → два `EXPLAIN (ANALYZE, BUFFERS)` → `DEALLOCATE ALL` → `DELETE`). diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100755 index 00000000..4d00912e --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,8 @@ +#!/usr/bin/env bash +# Restart hook for `make test-persistence ACTION_SCRIPT=scripts/restart.sh`. +# Semantic and evidence notes: tests/README.md ("Проверка сохранности") and REPORT.md. +set -euo pipefail + +compose=(docker compose --env-file .env) +"${compose[@]}" restart postgres redis api +"${compose[@]}" up -d --no-recreate --no-deps --wait postgres redis api diff --git a/scripts/track1_cache_benchmark.py b/scripts/track1_cache_benchmark.py new file mode 100755 index 00000000..0a3c45fb --- /dev/null +++ b/scripts/track1_cache_benchmark.py @@ -0,0 +1,283 @@ +#!/usr/bin/env python3 +"""Reproducible Track 1 cache benchmark (Python standard library only). + +See evidence/README.md for the evidence index, evidence/track1-cache-consistency.md +for the recorded methodology and per-repetition results, and REPORT.md (section +"Track 1") for the surrounding context. Usage: --help. +""" + +import argparse +import base64 +import concurrent.futures +import json +import os +import platform +import sys +import threading +import time +import urllib.error +import urllib.request +import uuid +from pathlib import Path + + +SEED_MESSAGE_COUNT = 1 +SAFE_ENVIRONMENT = ( + "APP_ENV", + "CACHE_MISS_DELAY_MS", + "CACHE_MODE", + "IMAGE_VERSION", + "API_IMAGE_VERSION", + "POSTGRES_IMAGE_VERSION", + "REDIS_IMAGE_VERSION", +) + + +class HttpFailure(RuntimeError): + """An HTTP failure whose representation cannot contain request secrets.""" + + def __init__(self, status: int | None, kind: str = "http_error") -> None: + super().__init__(kind) + self.status = status + self.kind = kind + + +def request_json(base_url: str, method: str, path: str, *, token: str | None = None, + basic: tuple[str, str] | None = None, body: object | None = None, + timeout: float) -> object: + data = None if body is None else json.dumps(body).encode("utf-8") + headers = {"Accept": "application/json"} + if data is not None: + headers["Content-Type"] = "application/json" + if token is not None: + headers["Authorization"] = f"Bearer {token}" + if basic is not None: + encoded = base64.b64encode(f"{basic[0]}:{basic[1]}".encode("utf-8")).decode("ascii") + headers["Authorization"] = f"Basic {encoded}" + request = urllib.request.Request(f"{base_url.rstrip('/')}{path}", method=method, + headers=headers, data=data) + try: + with urllib.request.urlopen(request, timeout=timeout) as response: + raw = response.read() + return None if not raw else json.loads(raw.decode("utf-8")) + except urllib.error.HTTPError as error: + raise HttpFailure(error.code) from None + except (urllib.error.URLError, TimeoutError, OSError, ValueError) as error: + raise HttpFailure(None, type(error).__name__) from None + + +def percentile(values: list[float], fraction: float) -> float: + if not values: + return 0.0 + ordered = sorted(values) + index = max(0, min(len(ordered) - 1, int(len(ordered) * fraction + 0.999999) - 1)) + return round(ordered[index], 3) + + +def require_object(value: object, name: str) -> dict[str, object]: + if not isinstance(value, dict): + raise RuntimeError(f"{name} response was not an object") + return value + + +def require_string(value: object, name: str) -> str: + if not isinstance(value, str) or not value: + raise RuntimeError(f"{name} response did not contain a string") + return value + + +def create_user(base_url: str, suffix: str, role: str, password: str, timeout: float) -> tuple[str, str]: + username = f"track1_{role}_{suffix}" + response = require_object(request_json(base_url, "POST", "/api/v1/users", + body={"username": username, "display_name": role, "password": password}, timeout=timeout), "user") + return username, require_string(response.get("id"), "user id") + + +def login(base_url: str, username: str, password: str, timeout: float) -> str: + response = require_object(request_json(base_url, "POST", "/api/v1/auth/sessions", + basic=(username, password), timeout=timeout), "session") + return require_string(response.get("token"), "session token") + + +def create_chat(base_url: str, token: str, member_ids: list[str], title: str, timeout: float) -> str: + response = require_object(request_json(base_url, "POST", "/api/v1/chats", token=token, + body={"title": title, "member_ids": member_ids}, timeout=timeout), "chat") + return require_string(response.get("id"), "chat id") + + +def post_message(base_url: str, token: str, chat_id: str, text: str, timeout: float) -> dict[str, object]: + return require_object(request_json(base_url, "POST", f"/api/v1/chats/{chat_id}/messages", + token=token, body={"text": text}, timeout=timeout), "message") + + +def history(base_url: str, token: str, chat_id: str, timeout: float) -> dict[str, object]: + return require_object(request_json(base_url, "GET", f"/api/v1/chats/{chat_id}/messages?limit=50", + token=token, timeout=timeout), "history") + + +def counter(snapshot: dict[str, object], *names: str) -> int: + counters = snapshot.get("counters", {}) + if not isinstance(counters, dict): + return 0 + return sum(int(counters.get(name, 0)) for name in names) + + +def metrics_delta(before: dict[str, object], after: dict[str, object]) -> dict[str, int]: + return {"history_sql": counter(after, "messages.history", "history_sql") - counter(before, "messages.history", "history_sql"), + "cache_hit": counter(after, "cache_hit") - counter(before, "cache_hit"), + "cache_miss": counter(after, "cache_miss") - counter(before, "cache_miss"), + "cache_lock_wait": counter(after, "cache_lock_wait") - counter(before, "cache_lock_wait")} + + +def run_barrier_gets(base_url: str, token: str, chat_id: str, concurrency: int, + timeout: float) -> tuple[list[float], dict[str, int]]: + barrier = threading.Barrier(concurrency) + + def one() -> tuple[float | None, int | None, str | None]: + try: + barrier.wait(timeout=timeout + 5) + started = time.perf_counter() + history(base_url, token, chat_id, timeout) + return time.perf_counter() - started, None, None + except HttpFailure as error: + return None, error.status, error.kind + except (threading.BrokenBarrierError, TimeoutError): + return None, None, "barrier_timeout" + except Exception: + return None, None, "request_error" + + with concurrent.futures.ThreadPoolExecutor(max_workers=concurrency) as pool: + outcomes = list(pool.map(lambda _: one(), range(concurrency))) + latencies = [seconds * 1000 for seconds, _, _ in outcomes if seconds is not None] + errors: dict[str, int] = {} + for _, status, kind in outcomes: + if kind is not None: + key = f"http_{status}" if status is not None else kind + errors[key] = errors.get(key, 0) + 1 + return latencies, errors + + +def safe_metadata(args: argparse.Namespace) -> dict[str, object]: + supplied: dict[str, str] = {} + for item in args.runtime_version: + if "=" not in item: + continue + key, value = item.split("=", 1) + lowered = key.lower() + if (key and value and len(key) <= 64 and len(value) <= 128 + and all(character.isalnum() or character in "_.-" for character in key) + and not any(term in lowered for term in ("token", "pass", "secret", "url"))): + supplied[key] = value + environment = {key: os.environ[key] for key in SAFE_ENVIRONMENT if os.environ.get(key)} + return {"python": platform.python_version(), "platform": platform.platform(aliased=True), + "supplied": supplied, "environment": environment} + + +def run(args: argparse.Namespace) -> dict[str, object]: + metrics_token = Path(args.metrics_token_file).read_text(encoding="utf-8").strip() + if not metrics_token: + raise RuntimeError("metrics token file is empty") + if args.concurrency < 1 or args.repetitions < 1: + raise RuntimeError("concurrency and repetitions must be positive") + suffix = uuid.uuid4().hex[:12] + password = f"Track1-only-{uuid.uuid4().hex[:20]}" + owner_name, owner_id = create_user(args.base_url, suffix, "owner", password, args.timeout) + reader_name, reader_id = create_user(args.base_url, suffix, "reader", password, args.timeout) + owner_token = login(args.base_url, owner_name, password, args.timeout) + reader_token = login(args.base_url, reader_name, password, args.timeout) + member_ids = [owner_id, reader_id] + + warm_chat = create_chat(args.base_url, owner_token, member_ids, "track1-warm", args.timeout) + for index in range(SEED_MESSAGE_COUNT): + post_message(args.base_url, owner_token, warm_chat, f"track1 warm seed {index}", args.timeout) + history(args.base_url, reader_token, warm_chat, args.timeout) + + consistency_chat = create_chat(args.base_url, owner_token, member_ids, "track1-consistency", args.timeout) + post_message(args.base_url, owner_token, consistency_chat, "track1 old page", args.timeout) + history(args.base_url, reader_token, consistency_chat, args.timeout) + new_message = post_message(args.base_url, owner_token, consistency_chat, + "track1 read-after-write", args.timeout) + new_id = new_message.get("id") + consistency_result: dict[str, object] = {"asserted": False, "stale_observed": False} + try: + after_write = history(args.base_url, reader_token, consistency_chat, args.timeout) + items = after_write.get("items", []) + present = isinstance(items, list) and any(isinstance(item, dict) and item.get("id") == new_id for item in items) + consistency_result["asserted"] = bool(present) + consistency_result["stale_observed"] = not present + if args.mode == "protected" and not present: + raise RuntimeError("protected read-after-write assertion failed") + except HttpFailure: + if args.mode == "protected": + raise + consistency_result["stale_observed"] = True + + repetitions: list[dict[str, object]] = [] + for repetition in range(1, args.repetitions + 1): + cold_chat = create_chat(args.base_url, owner_token, member_ids, + f"track1-cold-{repetition}", args.timeout) + for index in range(SEED_MESSAGE_COUNT): + post_message(args.base_url, owner_token, cold_chat, + f"track1 cold {repetition} seed {index}", args.timeout) + request_json(args.base_url, "POST", "/internal/metrics/reset", token=metrics_token, timeout=args.timeout) + before = require_object(request_json(args.base_url, "GET", "/internal/metrics", + token=metrics_token, timeout=args.timeout), "metrics") + latencies, errors = run_barrier_gets(args.base_url, reader_token, cold_chat, + args.concurrency, args.timeout) + after = require_object(request_json(args.base_url, "GET", "/internal/metrics", + token=metrics_token, timeout=args.timeout), "metrics") + repetitions.append({"repetition": repetition, "successful_requests": len(latencies), + "error_counts": errors, "metrics_delta": metrics_delta(before, after), + "latency_ms": {"p50": percentile(latencies, .50), "p95": percentile(latencies, .95), + "p99": percentile(latencies, .99)}}) + + totals = {"history_sql": 0, "cache_hit": 0, "cache_miss": 0, "cache_lock_wait": 0} + errors_total: dict[str, int] = {} + for repetition in repetitions: + metrics = repetition["metrics_delta"] + if isinstance(metrics, dict): + for key in totals: + totals[key] += int(metrics.get(key, 0)) + errors = repetition["error_counts"] + if isinstance(errors, dict): + for key, value in errors.items(): + errors_total[key] = errors_total.get(key, 0) + int(value) + return {"schema_version": 1, "mode": args.mode, + "workload": {"concurrency": args.concurrency, "repetitions": args.repetitions, + "seed_messages": SEED_MESSAGE_COUNT, + "barrier": "threading.Barrier before each GET", + "warmup": "one separate chat page before measurements", + "read_after_write": consistency_result}, + "totals": {"metrics_delta": totals, "error_counts": errors_total}, + "repetitions": repetitions, "runtime": safe_metadata(args)} + + +def parse_args() -> argparse.Namespace: + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--base-url", default="http://localhost:8080") + parser.add_argument("--mode", choices=("naive", "protected"), required=True) + parser.add_argument("--concurrency", type=int, default=32) + parser.add_argument("--repetitions", type=int, default=5) + parser.add_argument("--metrics-token-file", required=True) + parser.add_argument("--output", required=True) + parser.add_argument("--timeout", type=float, default=30.0) + parser.add_argument("--runtime-version", action="append", default=[], metavar="NAME=VALUE", + help="safe image/runtime metadata (repeatable; no secrets)") + return parser.parse_args() + + +def main() -> None: + args = parse_args() + result = run(args) + output = Path(args.output) + output.parent.mkdir(parents=True, exist_ok=True) + output.write_text(json.dumps(result, indent=2, sort_keys=True) + "\n", encoding="utf-8") + print(f"wrote {output}") + + +if __name__ == "__main__": + try: + main() + except (HttpFailure, OSError, RuntimeError) as error: + print(f"benchmark failed: {error}", file=sys.stderr) + raise SystemExit(2) diff --git a/scripts/track1_verify.py b/scripts/track1_verify.py new file mode 100755 index 00000000..43cefffb --- /dev/null +++ b/scripts/track1_verify.py @@ -0,0 +1,207 @@ +#!/usr/bin/env python3 +"""Verify Redis-only restart and generate sanitized Track 1 summaries. + +The verifier creates short-lived users and chat, retains bearer tokens only in +memory, and writes sanitized output. Redis eviction is narrowly scoped to +``messages:*`` keys; it never invokes FLUSHALL or removes volumes. + +Recorded results and the evidence index live in evidence/README.md and +evidence/track1-cache-consistency.md; the main report is REPORT.md. +""" + +import argparse +import json +import subprocess +import sys +import time +from pathlib import Path + +from track1_cache_benchmark import ( + create_chat, + create_user, + history, + login, + post_message, + request_json, + require_object, +) + + +def compose_command(args: argparse.Namespace, *parts: str) -> list[str]: + command = ["docker", "compose"] + if args.compose_file: + command.extend(["-f", args.compose_file]) + if args.env_file: + command.extend(["--env-file", args.env_file]) + command.extend(parts) + return command + + +def run_compose(args: argparse.Namespace, *parts: str) -> subprocess.CompletedProcess[str]: + # Compose diagnostics may include environment-derived URLs; do not emit them. + return subprocess.run(compose_command(args, *parts), check=True, capture_output=True, text=True) + + +def evict_message_cache(args: argparse.Namespace) -> int: + scan = run_compose(args, "exec", "-T", "redis", "redis-cli", "--scan", "--pattern", "messages:*") + keys = [line.strip() for line in scan.stdout.splitlines() if line.strip()] + for offset in range(0, len(keys), 100): + run_compose(args, "exec", "-T", "redis", "redis-cli", "DEL", *keys[offset : offset + 100]) + return len(keys) + + +def wait_ready(base_url: str, timeout: float, attempts: int = 30) -> None: + for _ in range(attempts): + try: + if isinstance(request_json(base_url, "GET", "/health/ready", timeout=timeout), dict): + return + except Exception: + pass + time.sleep(1) + raise RuntimeError("API did not become ready after Redis operation") + + +def verify(args: argparse.Namespace) -> dict[str, object]: + suffix = f"verify_{int(time.time())}" + password = "Track1-verify-password" + owner_name, owner_id = create_user(args.base_url, suffix, "owner", password, args.timeout) + reader_name, reader_id = create_user(args.base_url, suffix, "reader", password, args.timeout) + owner_token = login(args.base_url, owner_name, password, args.timeout) + reader_token = login(args.base_url, reader_name, password, args.timeout) + chat_id = create_chat(args.base_url, owner_token, [owner_id, reader_id], "track1-restart", args.timeout) + post_message(args.base_url, owner_token, chat_id, "track1 restart evidence", args.timeout) + before_me = require_object(request_json(args.base_url, "GET", "/api/v1/users/me", + token=reader_token, timeout=args.timeout), "users/me") + before_history = history(args.base_url, reader_token, chat_id, args.timeout) + cache_keys_deleted = 0 + restarted = False + redis_stopped = False + after_me: dict[str, object] | None = None + after_history: dict[str, object] | None = None + try: + if args.stop_start: + run_compose(args, "stop", "redis") + redis_stopped = True + run_compose(args, "start", "redis") + redis_stopped = False + restarted = True + wait_ready(args.base_url, args.timeout) + elif args.restart_redis: + run_compose(args, "restart", "redis") + restarted = True + wait_ready(args.base_url, args.timeout) + if args.evict_cache: + cache_keys_deleted = evict_message_cache(args) + after_me = require_object(request_json(args.base_url, "GET", "/api/v1/users/me", + token=reader_token, timeout=args.timeout), "users/me after restart") + after_history = history(args.base_url, reader_token, chat_id, args.timeout) + finally: + if redis_stopped: + try: + run_compose(args, "start", "redis") + except subprocess.CalledProcessError: + pass + if after_me is None or after_history is None: + raise RuntimeError("verification did not obtain post-operation responses") + users_equal = before_me == after_me + before_items = before_history.get("items") + after_items = after_history.get("items") + history_equal = before_items == after_items + if not users_equal or not history_equal: + raise RuntimeError("same-token users/me or history changed after Redis operation") + return {"schema_version": 1, "restart_redis": restarted, + "cache_eviction": {"requested": args.evict_cache, "message_keys_deleted": cache_keys_deleted}, + "same_token_users_me": users_equal, "history_equal": history_equal, + "history_item_count": len(after_items) if isinstance(after_items, list) else 0} + + +def read_raw(path: str) -> dict[str, object]: + value = json.loads(Path(path).read_text(encoding="utf-8")) + if not isinstance(value, dict): + raise RuntimeError(f"raw benchmark is not an object: {path}") + return value + + +def sanitize_runtime(runtime: object) -> dict[str, object]: + if not isinstance(runtime, dict): + return {} + result: dict[str, object] = {} + for key in ("python", "platform", "supplied", "environment"): + value = runtime.get(key) + if key == "supplied" and isinstance(value, dict): + result[key] = {str(k): str(v) for k, v in value.items() if "token" not in str(k).lower() and "pass" not in str(k).lower()} + elif key == "environment" and isinstance(value, dict): + result[key] = {str(k): str(v) for k, v in value.items() if "token" not in str(k).lower() and "pass" not in str(k).lower() and "url" not in str(k).lower()} + elif isinstance(value, (str, int, float, bool)): + result[key] = value + return result + + +def summarize(args: argparse.Namespace) -> dict[str, object]: + naive = read_raw(args.naive_raw) + protected = read_raw(args.protected_raw) + def view(raw: dict[str, object]) -> dict[str, object]: + workload = raw.get("workload", {}) + totals = raw.get("totals", {}) + return {"mode": raw.get("mode"), "workload": workload, "totals": totals, + "repetitions": raw.get("repetitions", []), "runtime": sanitize_runtime(raw.get("runtime"))} + return {"schema_version": 1, "source": "sanitized from two raw benchmark JSON files", + "naive": view(naive), "protected": view(protected), + "comparison": {"hypothesis": "naive cold misses issue more history SQL queries than protected lock-fill", + "result_fields": ["totals.metrics_delta.history_sql", "totals.metrics_delta.cache_miss", + "totals.metrics_delta.cache_lock_wait", "repetitions[].latency_ms"], + "interpretation": "Use observed fields above; this generator does not claim results before execution."}} + +def render_summary(summary: dict[str, object]) -> str: + lines = ["# Track 1 cache consistency evidence", "", str(summary["source"]), "", + "## Observed benchmark data", "", "| Mode | History SQL | Cache misses | Lock waits |", + "|---|---:|---:|---:|"] + for mode in ("naive", "protected"): + value = summary.get(mode, {}) + totals = value.get("totals", {}) if isinstance(value, dict) else {} + metrics = totals.get("metrics_delta", {}) if isinstance(totals, dict) else {} + lines.append(f"| {mode} | {metrics.get('history_sql', 'n/a')} | {metrics.get('cache_miss', 'n/a')} | {metrics.get('cache_lock_wait', 'n/a')} |") + lines.extend(["", "Per-repetition p50/p95/p99 successful latency and error counts remain in raw JSON.", + "Interpret the hypothesis only after both runs complete; this generator makes no inference.", ""]) + return "\n".join(lines) + + +def parse_args() -> argparse.Namespace: + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--base-url", default="http://localhost:8080") + parser.add_argument("--output", required=True) + parser.add_argument("--compose-file", default=None) + parser.add_argument("--env-file", default=None) + parser.add_argument("--restart-redis", action="store_true", help="restart only the Redis Compose service") + parser.add_argument("--stop-start", action="store_true", help="start Redis in finally after an explicit stop") + parser.add_argument("--evict-cache", action="store_true", help="DEL only messages:* Redis keys") + parser.add_argument("--timeout", type=float, default=30.0) + parser.add_argument("--summary", action="store_true", help="generate summary from two raw benchmark files") + parser.add_argument("--naive-raw", help="naive raw JSON for --summary") + parser.add_argument("--protected-raw", help="protected raw JSON for --summary") + return parser.parse_args() + + +def main() -> None: + args = parse_args() + if args.summary: + if not args.naive_raw or not args.protected_raw: + raise RuntimeError("--summary requires --naive-raw and --protected-raw") + result = summarize(args) + else: + result = verify(args) + output = Path(args.output) + output.parent.mkdir(parents=True, exist_ok=True) + if args.summary and output.suffix.lower() == ".md": + output.write_text(render_summary(result), encoding="utf-8") + else: + output.write_text(json.dumps(result, indent=2, sort_keys=True) + "\n", encoding="utf-8") + print(f"wrote {output}") + + +if __name__ == "__main__": + try: + main() + except (OSError, RuntimeError, subprocess.CalledProcessError) as error: + print(f"verification failed: {error.__class__.__name__}", file=sys.stderr) + raise SystemExit(2) -- 2.54.0 From 1bef3845bc132b8ee2164e07d3dcada951c9f746 Mon Sep 17 00:00:00 2001 From: Ilya Date: Fri, 9 Oct 2026 15:59:49 +0300 Subject: [PATCH 3/4] docs: add pr link for report.md --- REPORT.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/REPORT.md b/REPORT.md index e4be4393..6abffde6 100644 --- a/REPORT.md +++ b/REPORT.md @@ -2,7 +2,7 @@ - Автор, группа: Тюнин Илья БВТ2303 - Целевая оценка: 5, трек 1 («Согласованность кэша») -- Commit/PR: [вставьте после публикации] +- Commit/PR: https://gitea.privcloud.tech/mtusi2026/mtusi2026lab2/pulls/33 ## Карта документации -- 2.54.0 From ff472909196a16ffb51340db4eeea4438da2da86 Mon Sep 17 00:00:00 2001 From: Ilya Date: Sat, 10 Oct 2026 02:13:35 +0300 Subject: [PATCH 4/4] =?UTF-8?q?fix:=20=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/pull_request_template.md | 11 +- Makefile | 8 +- REPORT.md | 35 ++- app/README.md | 31 +- app/package-lock.json | 11 + app/package.json | 4 +- app/src/chats/chats.repository.ts | 6 +- app/src/chats/chats.service.ts | 3 +- app/src/chats/dto/create-chat.dto.ts | 4 +- app/src/common/errors/api-error.ts | 7 + app/src/common/errors/api-exception.filter.ts | 84 +++-- app/src/common/http/cursor.spec.ts | 85 +++++ app/src/common/http/cursor.ts | 31 +- app/src/common/http/page.ts | 4 + .../validation/code-point-length.spec.ts | 43 +++ .../common/validation/code-point-length.ts | 38 +++ .../messages/cache/messages-cache.service.ts | 6 +- app/src/messages/dto/create-message.dto.ts | 5 +- app/src/messages/messages.repository.ts | 2 - app/src/messages/messages.service.ts | 5 +- app/src/users/dto/create-user.dto.ts | 10 +- app/src/users/users.service.ts | 9 +- app/test/app.e2e-spec.ts | 194 +++++++++--- app/test/dependency-failures.e2e-spec.ts | 290 ++++++++++++++++++ app/vitest.config.e2e.ts | 2 +- bruno/README.md | 7 +- bruno/chats/create-chat.bru | 20 +- bruno/negative/invalid-calendar-cursor.bru | 46 +++ evidence/README.md | 2 +- evidence/level3-4-verification.md | 82 +++-- 30 files changed, 902 insertions(+), 183 deletions(-) create mode 100644 app/src/common/errors/api-error.ts create mode 100644 app/src/common/http/cursor.spec.ts create mode 100644 app/src/common/http/page.ts create mode 100644 app/src/common/validation/code-point-length.spec.ts create mode 100644 app/src/common/validation/code-point-length.ts create mode 100644 app/test/dependency-failures.e2e-spec.ts create mode 100644 bruno/negative/invalid-calendar-cursor.bru diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 3fe887f6..ab66d7f5 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -44,12 +44,13 @@ make check PASS make validate PASS make test BASE_URL=http://localhost:8080 PASS: lab2 public API scenario make test-persistence ACTION_SCRIPT=scripts/restart.sh PASS: preserved confirmed data and existing session +make test-dependencies PASS: 2 passed (отказы Redis и PostgreSQL) (cd app && npm run build) PASS -(cd app && npm test) 5 files, 13 tests passed +(cd app && npm test) 7 files, 20 tests passed (cd app && npx tsc --noEmit) PASS -integration suite (реальные PostgreSQL/Redis) 7 passed | 1 skipped -то же с SESSION_TTL_SECONDS=2 8 passed (expiry → 401) -коллекция Bruno (bru run -r --env local) 28 запросов, 56 проверок — все зелёные +integration suite (реальные PostgreSQL/Redis) 9 passed | 1 skipped +то же с SESSION_TTL_SECONDS=2 10 passed (expiry → 401) +коллекция Bruno (bru run -r --env local) 29 запросов, 58 проверок — все зелёные ``` Трек 1 (32 конкурентных GET × 5 повторностей, `CACHE_MISS_DELAY_MS=75`): @@ -59,7 +60,7 @@ integration suite (реальные PostgreSQL/Redis) 7 passed | 1 | naive | 160 | 0 | 0 | ≈ 89 | | protected | 5 | 155 | 0 | ≈ 20 | -Отдельно проверены: гонка одинакового username (201 + 409, в таблице ровно 1 строка, unique-индекс), rollback при неизвестном участнике чата (`400`, строк не осталось), отказы Redis и PostgreSQL (`/health/ready` 503, анонимный доступ не выдаётся, процесс API жив, после старта — 200 с тем же токеном), `EXPLAIN (ANALYZE, BUFFERS)` на 10 002 сообщениях (Index Scan по `messages_chat_created_id_idx`, keyset-предикат в `Index Cond`). +Отдельно проверены границы длин в code points (11 эмодзи-пароль → 400, 12 → 201 и вход работает, 101 эмодзи в `display_name` → 400, 4001 эмодзи в тексте → 400, 4000 → 201). Также проверены: гонка одинакового username (201 + 409, в таблице ровно 1 строка, unique-индекс), rollback при неизвестном участнике чата (`400`, строк не осталось), отказы Redis и PostgreSQL автоматическим набором (`make test-dependencies`: `/health/live` 200, `/health/ready` и бизнес-запросы — ограниченная `503` без деталей драйвера, анонимный запрос 401, процесс API жив, после старта — 200 с тем же токеном и подтверждённым сообщением), `EXPLAIN (ANALYZE, BUFFERS)` на 10 002 сообщениях (Index Scan по `messages_chat_created_id_idx`, keyset-предикат в `Index Cond`). - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены (`contracts/` и `tests/` не изменялись). diff --git a/Makefile b/Makefile index 9ecb223e..9bea7436 100644 --- a/Makefile +++ b/Makefile @@ -3,11 +3,12 @@ BASE_URL ?= http://localhost:8080 CA_FILE ?= ACTION_SCRIPT ?= TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) +COMPOSE_ENV_FILE ?= .env -.PHONY: help check validate test load test-persistence +.PHONY: help check validate test load test-persistence test-dependencies help: - @echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes" + @echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes; test-persistence: restart hook; test-dependencies: stops/restarts Redis and PostgreSQL" check: $(PYTHON) scripts/check_contract.py @@ -24,3 +25,6 @@ load: test-persistence: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable restart hook"; exit 2) $(PYTHON) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) + +test-dependencies: + cd app && E2E_COMPOSE_DIR="$(CURDIR)" E2E_COMPOSE_ENV_FILE="$(COMPOSE_ENV_FILE)" npm run test:dependencies diff --git a/REPORT.md b/REPORT.md index 6abffde6..c715ca6a 100644 --- a/REPORT.md +++ b/REPORT.md @@ -43,6 +43,7 @@ Client - Удаление Redis cache не теряет подтверждённые данные: они восстанавливаются из PostgreSQL. - Отказ Redis не даёт анонимного доступа: сессионный путь возвращает ограниченную 503. - Отказ PostgreSQL не убивает процесс API и даёт ограниченную 503. +- Оба отказа проверяются автоматически (`make test-dependencies`): остановка и старт контейнеров, ограниченные ошибки без деталей драйвера, восстановление сессии и подтверждённых данных. ### Схема данных и миграции @@ -73,6 +74,13 @@ Migration runner сам находит `NNN_*.sql`, сортирует по им - `DELETE /api/v1/auth/sessions/current` → 204 без тела; повтор с тем же токеном → 401. - Ответы 401 содержат корректный challenge: Basic для создания сессии, Bearer для остальных. +## Валидация входа + +- Обязательные строки не состоят только из пробельных символов (`contracts/README.md`): у `display_name` и `password` есть проверка `\S`, поэтому пароль из 12 пробелов — `400`, а не созданная учётная запись. +- Курсор истории — непрозрачная строка, но сервер проверяет формат (`YYYY-MM-DDTHH:MM:SS(.f)Z`, диапазоны часов/минут/секунд) и календарь через `date-fns` `parseISO` + `isValid`. Несуществующие даты (`2026-02-31`, `2025-02-29`) и `24:00:00` отклоняются как `400 invalid_request`, потому что `Date.parse` молча переносит их на другой день и такое значение падало бы уже в PostgreSQL (`500`). Разобранный инстант нормализуется к каноническим миллисекундам. +- Длины строк считаются в Unicode code points, как в JSON Schema и контракте: собственный декоратор `@CodePointLength` (`app/src/common/validation/`) заменяет `@Length`, который мерил UTF-16-единицы. Поэтому `display_name` и `title` — 1–100, пароль — 12–128, текст сообщения — 1–4000 code points независимо от наличия эмодзи вне BMP; подсчёт идёт по code points, а не по графемным кластерам (комбинирующие символы считаются отдельно, как в JSON Schema). +- Неизвестные поля и неверные типы — `400`; лимит истории — целое 1–100. + ## Политика кэша и трек 1 Ключ страницы: `messages:{chat_id}:v{message_version}:c{cursor|start}:l{limit}`. @@ -167,19 +175,19 @@ Read-after-write (protected, вторая действующая сессия): ## Уровень 3/4: наблюдаемые проверки -| Проверка | Команда/сценарий | Наблюдаемый результат | -| ---------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | -| Публичный smoke | `make test` | `PASS: lab2 public API scenario` | -| Сохранность через полный рестарт | `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | `PASS: persistence preserved confirmed data and existing session` | -| Интеграционный набор (реальные PG/Redis) | `npx vitest run --config vitest.config.e2e.ts` | 7 passed, 1 gated | -| То же с `SESSION_TTL_SECONDS=2` | тот же набор с TTL=2 | 8 passed (включая expiry → 401) | -| Гонка одинакового username | набор: два одновременных POST + `select count(*)` | 201 и 409; в `users` ровно 1 строка (гарантия — unique index `users_username_key`, ошибка `23505` → 409) | -| Rollback чата с неизвестным участником | HTTP 400 + `select count(*)` | 400; строк в `chats` — 0 | -| Индекс истории | `EXPLAIN (ANALYZE, BUFFERS)` на 10 002 строках | `Index Scan using messages_chat_created_id_idx` для первой страницы (0.040 мс) и для keyset-продолжения (0.048 мс) | -| Отказ Redis | stop redis | `/health/ready` 503, `/users/me` 503 (анонимного доступа нет), после старта — 200 | -| Отказ PostgreSQL | stop postgres | `/health/ready` 503, `/users/me` 503; процесс API жив; после старта — 200 с тем же токеном | -| Логин/логаут/подмена | набор + `X-User-Id` | Basic на бизнес-endpoint 401, `X-User-Id` не меняет владельца, replay после logout 401 | -| Ручной клиент (Bruno) | `bru run -r --env local ...` из `bruno/` | 28 запросов, 56 проверок — все зелёные (включая негативные и метрики) | +| Проверка | Команда/сценарий | Наблюдаемый результат | +| ---------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | +| Публичный smoke | `make test` | `PASS: lab2 public API scenario` | +| Сохранность через полный рестарт | `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | `PASS: persistence preserved confirmed data and existing session` | +| Интеграционный набор (реальные PG/Redis) | `npx vitest run --config vitest.config.e2e.ts` | 9 passed, 1 gated | +| То же с `SESSION_TTL_SECONDS=2` | тот же набор с TTL=2 | 10 passed (включая expiry → 401) | +| Гонка одинакового username | набор: два одновременных POST + `select count(*)` | 201 и 409; в `users` ровно 1 строка (гарантия — unique index `users_username_key`, ошибка `23505` → 409) | +| Rollback чата с неизвестным участником | HTTP 400 + `select count(*)` | 400; строк в `chats` — 0 | +| Индекс истории | `EXPLAIN (ANALYZE, BUFFERS)` на 10 002 строках | `Index Scan using messages_chat_created_id_idx` для первой страницы (0.040 мс) и для keyset-продолжения (0.048 мс) | +| Отказ Redis (автоматически) | `make test-dependencies` | `/health/live` 200; `/health/ready` и бизнес-запросы — ограниченная 503; анонимный запрос 401; после старта сессия и данные живы | +| Отказ PostgreSQL (автоматически) | `make test-dependencies` | `/health/live` 200; все бизнес-запросы и регистрация — 503 без утечки деталей; процесс жив; после старта запись работает | +| Логин/логаут/подмена | набор + `X-User-Id` | Basic на бизнес-endpoint 401, `X-User-Id` не меняет владельца, replay после logout 401 | +| Ручной клиент (Bruno) | `bru run -r --env local ...` из `bruno/` | 29 запросов, 58 проверок — все зелёные (включая негативные и метрики) | Отдельно исправлен реальный дефект: при падении PostgreSQL процесс API завершался из-за необработанного события `error` у idle-клиента пула. Добавлен обработчик `pool.on('error')`, а ошибки доступности БД в фильтре отображаются в ограниченную 503 вместо 500. @@ -195,6 +203,7 @@ make validate (cd app && npm run build && npm test && npx tsc --noEmit) make test BASE_URL=http://localhost:8080 make test-persistence ACTION_SCRIPT=scripts/restart.sh +make test-dependencies (cd app && API_BASE_URL=http://localhost:8080 \ DATABASE_URL=postgresql://messenger:@:5432/messenger \ REDIS_URL=redis://:6379 npx vitest run --config ./vitest.config.e2e.ts) diff --git a/app/README.md b/app/README.md index d73b4dfc..f8651900 100644 --- a/app/README.md +++ b/app/README.md @@ -30,7 +30,11 @@ src/ cache/ версионированный кэш истории + lock на страницу metrics/ /internal/metrics и /internal/metrics/reset health/ liveness/readiness с проверкой зависимостей - common/ guard, exception filter, request-id, cursor, errors + common/ + http/ cursor (формат+календарь), page (конверт {items,next_cursor}), request-id + errors/ exception filter и тип тела ошибки ApiErrorBody + validation/ декоратор CodePointLength (длины в Unicode code points) + auth/ guard и декоратор текущего пользователя test/ app.e2e-spec.ts black-box набор против запущенного API (PG + Redis) scripts/ @@ -40,7 +44,9 @@ scripts/ Принципы: raw `pg.Pool` без ORM, параметризованные запросы, никаких in-memory хранилищ в боевых путях; кэш — производное состояние и всегда допускает восстановление из PostgreSQL; отказ зависимости даёт ограниченную ошибку -(`503`), а не аварийное завершение процесса. +(`503`), а не аварийное завершение процесса; длины строк проверяются в Unicode +code points (свой декоратор `@CodePointLength`), как в JSON Schema, а не в +UTF-16-единицах. ## Быстрый старт @@ -132,6 +138,7 @@ npm run start:dev # или npm run start:prod после | `npm run start:prod` | запуск собранного приложения (`node dist/main`) | | `npm test` / `npm run test:unit` | unit-тесты (vitest) | | `npm run test:e2e` | black-box набор против запущенного API (см. ниже) | +| `npm run test:dependencies` | автоматическая проверка отказов Redis/PostgreSQL: останавливает и поднимает контейнеры Compose-стенда | | `npm run lint` | oxlint по `src/` и `test/` | | `npm run format` | prettier | | `npm run graph` | граф модулей и провайдеров через nestjs-spelunker (пишет `../docs/architecture/`) | @@ -158,6 +165,26 @@ npm run test:e2e устанавливает `process.env.BASE_URL` в значение Vite base. Кейс истечения сессии включается переменной `SESSION_TTL_SECONDS=2` и у запущенного API, и у набора. +## Отказы зависимостей + +Отдельный набор останавливает и поднимает контейнеры Compose-стенда и проверяет +ограниченные ошибки вместо 500: + +```sh +cd .. # из корня репозитория, стенд поднят через docker compose +make test-dependencies +``` + +Он включён по флагу `E2E_DEPENDENCY_FAULTS=1` (им же управляет цель Makefile), +потому что требует прав на управление Docker Compose-проектом; остальные +переменные — `E2E_COMPOSE_DIR`, `E2E_COMPOSE_ENV_FILE`, `E2E_REDIS_SERVICE`, +`E2E_POSTGRES_SERVICE`. Проверяется для Redis и PostgreSQL: `/health/live` +остаётся `200`, `/health/ready` и бизнес-запросы возвращают `503 unavailable` +с `request_id` из `X-Request-Id` и без деталей драйвера, запрос без сессии — +по-прежнему `401`, а после старта зависимости живы прежняя сессия, +подтверждённое сообщение и новая запись. Каждый запрос к остановленной БД ждёт +`DATABASE_CONNECTION_TIMEOUT_MS`, поэтому набор идёт около 40 секунд. + ## Метрики `GET /internal/metrics` возвращает `{counters, latency_ms}`: именованные SQL-метки, diff --git a/app/package-lock.json b/app/package-lock.json index 0ef2c3ab..b98212b8 100644 --- a/app/package-lock.json +++ b/app/package-lock.json @@ -17,6 +17,7 @@ "argon2": "^0.45.1", "class-transformer": "^0.5.1", "class-validator": "^0.15.1", + "date-fns": "^4.4.0", "fastify": "^5.12.5", "pg": "^8.23.1", "redis": "^6.3.0", @@ -3526,6 +3527,16 @@ "node": ">= 8" } }, + "node_modules/date-fns": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/date-fns/-/date-fns-4.4.0.tgz", + "integrity": "sha512-+1UMbeh68lH1SegH83CGWwpb6OHHbpSgr3+s5Eww5M4CAgswBpoWS0AjTOfEJ33HiYKz1hdj/KTFprzXHmq/6w==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/kossnocorp" + } + }, "node_modules/debug": { "version": "4.4.3", "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", diff --git a/app/package.json b/app/package.json index 00de6a9f..0bf3832b 100644 --- a/app/package.json +++ b/app/package.json @@ -21,7 +21,8 @@ "test:cov": "vitest run --coverage", "test:debug": "vitest --inspect-brk --no-file-parallelism", "graph": "npm run build && DATABASE_URL=postgresql://graph-only.invalid/messenger REDIS_URL=redis://graph-only.invalid:6379 tsx scripts/graph-modules.ts", - "test:e2e": "vitest run --config ./vitest.config.e2e.ts" + "test:e2e": "vitest run --config ./vitest.config.e2e.ts", + "test:dependencies": "E2E_DEPENDENCY_FAULTS=1 vitest run --config ./vitest.config.e2e.ts dependency-failures" }, "dependencies": { "@nestjs/common": "^12.0.1", @@ -32,6 +33,7 @@ "argon2": "^0.45.1", "class-transformer": "^0.5.1", "class-validator": "^0.15.1", + "date-fns": "^4.4.0", "fastify": "^5.12.5", "pg": "^8.23.1", "redis": "^6.3.0", diff --git a/app/src/chats/chats.repository.ts b/app/src/chats/chats.repository.ts index 7090e15a..7f724bcb 100644 --- a/app/src/chats/chats.repository.ts +++ b/app/src/chats/chats.repository.ts @@ -1,8 +1,4 @@ -import { - BadRequestException, - Injectable, - NotFoundException, -} from '@nestjs/common'; +import { BadRequestException, Injectable } from '@nestjs/common'; import { randomUUID } from 'node:crypto'; import { DatabaseClient } from '../database/database.client.js'; import type { Cursor } from '../common/http/cursor.js'; diff --git a/app/src/chats/chats.service.ts b/app/src/chats/chats.service.ts index 354c8973..2a78c65e 100644 --- a/app/src/chats/chats.service.ts +++ b/app/src/chats/chats.service.ts @@ -4,6 +4,7 @@ import { NotFoundException, } from '@nestjs/common'; import { encodeCursor, decodeCursor } from '../common/http/cursor.js'; +import type { Page } from '../common/http/page.js'; import type { User } from '../users/user.js'; import type { CreateChatDto } from './dto/create-chat.dto.js'; import type { Chat } from './chat.js'; @@ -34,7 +35,7 @@ export class ChatsService { currentUser: User, limit: number, cursorValue?: string, - ): Promise<{ items: Chat[]; next_cursor: string | null }> { + ): Promise> { const scope = `chats:${currentUser.id}`; const cursor = cursorValue ? decodeCursor(cursorValue, scope) diff --git a/app/src/chats/dto/create-chat.dto.ts b/app/src/chats/dto/create-chat.dto.ts index baeb07cc..37ff853d 100644 --- a/app/src/chats/dto/create-chat.dto.ts +++ b/app/src/chats/dto/create-chat.dto.ts @@ -5,13 +5,13 @@ import { IsArray, IsString, IsUUID, - Length, Matches, } from 'class-validator'; +import { CodePointLength } from '../../common/validation/code-point-length.js'; export class CreateChatDto { @IsString() - @Length(1, 100) + @CodePointLength(1, 100) @Matches(/\S/, { message: 'title must contain a non-whitespace character', }) diff --git a/app/src/common/errors/api-error.ts b/app/src/common/errors/api-error.ts new file mode 100644 index 00000000..b26ece9b --- /dev/null +++ b/app/src/common/errors/api-error.ts @@ -0,0 +1,7 @@ +export type ApiErrorBody = { + error: { + code: string; + message: string; + request_id: string; + }; +}; diff --git a/app/src/common/errors/api-exception.filter.ts b/app/src/common/errors/api-exception.filter.ts index ce3298b9..dd7e5871 100644 --- a/app/src/common/errors/api-exception.filter.ts +++ b/app/src/common/errors/api-exception.filter.ts @@ -4,35 +4,56 @@ import { ExceptionFilter, HttpException, HttpStatus, + Logger, } from '@nestjs/common'; import { HttpAdapterHost } from '@nestjs/core'; import { randomUUID } from 'node:crypto'; +import type { ApiErrorBody } from './api-error.js'; type RequestWithId = { requestId?: string; method?: string; url?: string }; type ExceptionBody = { message?: unknown; challenge?: unknown }; // Connection/session loss codes reported by node-postgres and the network layer. -const UNAVAILABLE_ERROR_CODES = new Set([ - 'ECONNREFUSED', - 'ECONNRESET', - 'ENOTFOUND', - 'ETIMEDOUT', - 'EPIPE', - '08000', - '08001', - '08003', - '08004', - '08006', - '57P01', - '57P02', - '57P03', - '53300', -]); +const UNAVAILABLE_ERROR_CODES: Record = { + ECONNREFUSED: true, + ECONNRESET: true, + ENOTFOUND: true, + ETIMEDOUT: true, + EPIPE: true, + '08000': true, + '08001': true, + '08003': true, + '08004': true, + '08006': true, + '57P01': true, + '57P02': true, + '57P03': true, + '53300': true, +}; + +// Some driver failures carry no `code` at all: node-postgres raises plain errors +// when a connection dies or its pool attempt times out, and node-redis reports a +// closed socket the same way. Without these patterns a stopped database would +// surface as an internal fault instead of a bounded outage. +const UNAVAILABLE_ERROR_MESSAGES = [ + 'Connection terminated unexpectedly', + 'Connection terminated due to connection timeout', + 'timeout exceeded when trying to connect', + 'Client has encountered a connection error and is not queryable', + 'Socket closed unexpectedly', + 'Connection is closed', +]; function isDependencyOutage(exception: unknown): boolean { if (typeof exception !== 'object' || exception === null) return false; const code = (exception as { code?: unknown }).code; - return typeof code === 'string' && UNAVAILABLE_ERROR_CODES.has(code); + if (typeof code === 'string' && UNAVAILABLE_ERROR_CODES[code] === true) + return true; + const message = (exception as { message?: unknown }).message; + return ( + typeof message === 'string' && + UNAVAILABLE_ERROR_MESSAGES.some((pattern) => message.includes(pattern)) + ); } function errorCodeForStatus(status: number): string { @@ -51,6 +72,8 @@ function errorCodeForStatus(status: number): string { @Catch() export class ApiExceptionFilter implements ExceptionFilter { + private readonly logger = new Logger(ApiExceptionFilter.name); + constructor(private readonly adapterHost: HttpAdapterHost) {} catch(exception: unknown, host: ArgumentsHost): void { @@ -92,6 +115,16 @@ export class ApiExceptionFilter implements ExceptionFilter { // A dropped dependency is a bounded outage, not an internal fault. status = HttpStatus.SERVICE_UNAVAILABLE; message = 'Service unavailable'; + this.logger.warn( + `Dependency outage on ${request.method ?? ''} ${request.url ?? ''}: ${exception instanceof Error ? exception.message : 'unknown error'}`, + ); + } else { + this.logger.error( + `Unhandled exception on ${request.method ?? ''} ${request.url ?? ''}`, + exception instanceof Error + ? exception.stack + : String(exception), + ); } if (status === HttpStatus.UNAUTHORIZED) { const authChallenge = @@ -103,16 +136,13 @@ export class ApiExceptionFilter implements ExceptionFilter { adapter.setHeader(response, 'WWW-Authenticate', authChallenge); } adapter.setHeader(response, 'X-Request-Id', requestId); - adapter.reply( - response, - { - error: { - code: errorCodeForStatus(status), - message, - request_id: requestId, - }, + const payload: ApiErrorBody = { + error: { + code: errorCodeForStatus(status), + message, + request_id: requestId, }, - status, - ); + }; + adapter.reply(response, payload, status); } } diff --git a/app/src/common/http/cursor.spec.ts b/app/src/common/http/cursor.spec.ts new file mode 100644 index 00000000..f4e7823b --- /dev/null +++ b/app/src/common/http/cursor.spec.ts @@ -0,0 +1,85 @@ +import { BadRequestException } from '@nestjs/common'; +import { randomUUID } from 'node:crypto'; +import { describe, expect, it } from 'vitest'; +import { decodeCursor, encodeCursor } from './cursor.js'; + +const scope = 'messages:6f1c2a3e-1111-4222-8333-444455556666'; + +function encode(createdAt: string, cursorScope = scope): string { + return encodeCursor({ + scope: cursorScope, + created_at: createdAt, + id: randomUUID(), + }); +} + +describe('decodeCursor', () => { + it('accepts valid instants and normalizes them to canonical milliseconds', () => { + const accepted: Array<[string, string]> = [ + ['2026-01-01T00:00:00.000Z', '2026-01-01T00:00:00.000Z'], + ['2026-01-01T00:00:00Z', '2026-01-01T00:00:00.000Z'], + ['2026-01-01T00:00:00.999999Z', '2026-01-01T00:00:00.999Z'], + ['2024-02-29T23:59:59.000Z', '2024-02-29T23:59:59.000Z'], + ['2026-12-31T23:59:59.999Z', '2026-12-31T23:59:59.999Z'], + ]; + for (const [createdAt, expected] of accepted) { + const decoded = decodeCursor(encode(createdAt), scope); + expect(decoded.created_at).toBe(expected); + expect(decoded.scope).toBe(scope); + } + }); + + it('rejects calendar dates that the platform parser rolls over', () => { + // 2026-02-31 would silently become 2026-03-03 and then fail inside SQL. + for (const createdAt of [ + '2026-02-31T00:00:00.000Z', + '2025-02-29T00:00:00.000Z', + '2026-04-31T00:00:00.000Z', + '2026-06-31T12:00:00.000Z', + ]) { + expect(() => decodeCursor(encode(createdAt), scope)).toThrow( + BadRequestException, + ); + } + }); + + it('rejects out-of-range and malformed timestamps', () => { + for (const createdAt of [ + '2026-01-01T24:00:00.000Z', + '2026-01-01T00:00:60.000Z', + '2026-13-01T00:00:00.000Z', + '2026-00-01T00:00:00.000Z', + '2026-01-01T00:00:00', + '2026-01-01T00:00:00+02:00', + '2026-1-1T00:00:00.000Z', + '2026-01-01', + 'not-a-timestamp', + ]) { + expect(() => decodeCursor(encode(createdAt), scope)).toThrow( + BadRequestException, + ); + } + }); + + it('rejects a cursor from another scope, a malformed id, and non-cursor input', () => { + expect(() => + decodeCursor( + encode('2026-01-01T00:00:00.000Z', 'messages:other'), + scope, + ), + ).toThrow(BadRequestException); + expect(() => + decodeCursor( + encodeCursor({ + scope, + created_at: '2026-01-01T00:00:00.000Z', + id: 'not-a-uuid', + }), + scope, + ), + ).toThrow(BadRequestException); + expect(() => decodeCursor('not-a-cursor', scope)).toThrow( + BadRequestException, + ); + }); +}); diff --git a/app/src/common/http/cursor.ts b/app/src/common/http/cursor.ts index bdc53a1e..037d4a4d 100644 --- a/app/src/common/http/cursor.ts +++ b/app/src/common/http/cursor.ts @@ -1,4 +1,5 @@ import { BadRequestException } from '@nestjs/common'; +import { isValid, parseISO } from 'date-fns'; export type Cursor = { scope: string; @@ -6,6 +7,14 @@ export type Cursor = { id: string; }; +// Format check for the canonical API shape: `Date.prototype.toISOString()` with +// optional fractional seconds. Explicit ranges reject values such as 24:00:00. +// Calendar validity (2026-02-31, 2025-02-29, 2026-04-31) is checked by +// date-fns `parseISO`, which refuses impossible dates that the platform parser +// would silently roll over into another day. +const CURSOR_TIMESTAMP = + /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?Z$/u; + export function encodeCursor(cursor: Cursor): string { return Buffer.from(JSON.stringify(cursor), 'utf8').toString('base64url'); } @@ -28,30 +37,18 @@ export function decodeCursor(value: string, expectedScope: string): Cursor { !/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu.test( parsed.id, ) || - !/^(?:\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z)$/u.test( - parsed.created_at, - ) + !CURSOR_TIMESTAMP.test(parsed.created_at) ) throw new Error('invalid cursor'); - const timestamp = Date.parse(parsed.created_at); - if (!Number.isFinite(timestamp)) throw new Error('invalid cursor'); + const instant = parseISO(parsed.created_at); + if (!isValid(instant)) throw new Error('invalid cursor'); + return { scope: parsed.scope, - created_at: parsed.created_at, + created_at: instant.toISOString(), id: parsed.id, }; } catch { throw new BadRequestException('Invalid cursor'); } } - -export function isAfter( - createdAt: string, - id: string, - cursor: Cursor, -): boolean { - return ( - createdAt > cursor.created_at || - (createdAt === cursor.created_at && id > cursor.id) - ); -} diff --git a/app/src/common/http/page.ts b/app/src/common/http/page.ts new file mode 100644 index 00000000..55c9ff8a --- /dev/null +++ b/app/src/common/http/page.ts @@ -0,0 +1,4 @@ +export type Page = { + items: T[]; + next_cursor: string | null; +}; diff --git a/app/src/common/validation/code-point-length.spec.ts b/app/src/common/validation/code-point-length.spec.ts new file mode 100644 index 00000000..2daa8306 --- /dev/null +++ b/app/src/common/validation/code-point-length.spec.ts @@ -0,0 +1,43 @@ +import { validate } from 'class-validator'; +import { describe, expect, it } from 'vitest'; +import { CodePointLength } from './code-point-length.js'; + +class Sample { + @CodePointLength(3, 5) + value!: string; +} + +async function fails(value: unknown): Promise { + const sample = new Sample(); + (sample as { value: unknown }).value = value; + const errors = await validate(sample); + return errors.length > 0; +} + +describe('CodePointLength', () => { + it('counts Unicode code points instead of UTF-16 units', async () => { + // '🔐' is one code point but two UTF-16 units. + expect(await fails('🔐🔐')).toBe(true); + expect(await fails('🔐🔐🔐')).toBe(false); + expect(await fails('🔐🔐🔐🔐🔐')).toBe(false); + expect(await fails('🔐🔐🔐🔐🔐🔐')).toBe(true); + // Combining marks are separate code points, not grapheme clusters: + // three 'é' sequences are six code points and exceed the maximum. + expect(await fails('e\u0301e\u0301')).toBe(false); + expect(await fails('e\u0301e\u0301e\u0301')).toBe(true); + }); + + it('applies to BMP text boundaries', async () => { + expect(await fails('ab')).toBe(true); + expect(await fails('abc')).toBe(false); + expect(await fails('abcde')).toBe(false); + expect(await fails('abcdef')).toBe(true); + }); + + it('rejects empty and non-string values', async () => { + expect(await fails('')).toBe(true); + expect(await fails(undefined)).toBe(true); + expect(await fails(12345)).toBe(true); + expect(await fails(['a', 'b', 'c'])).toBe(true); + }); +}); diff --git a/app/src/common/validation/code-point-length.ts b/app/src/common/validation/code-point-length.ts new file mode 100644 index 00000000..5b3fa3ae --- /dev/null +++ b/app/src/common/validation/code-point-length.ts @@ -0,0 +1,38 @@ +import { + registerDecorator, + ValidatorConstraint, + type ValidationArguments, + type ValidatorConstraintInterface, +} from 'class-validator'; + +// JSON Schema (and the course contract) measure string lengths in Unicode code +// points, while String.prototype.length counts UTF-16 units: one emoji outside +// the BMP is two units. `@Length` therefore accepted an 11-emoji password +// (22 units) and rejected 4000 emoji (8000 units), so these fields use an +// explicit code-point validator instead. +@ValidatorConstraint({ name: 'codePointLength', async: false }) +class CodePointLengthConstraint implements ValidatorConstraintInterface { + validate(value: unknown, args: ValidationArguments): boolean { + const [min, max] = args.constraints as [number, number]; + if (typeof value !== 'string') return false; + const length = [...value].length; + return length >= min && length <= max; + } + + defaultMessage(args: ValidationArguments): string { + const [min, max] = args.constraints as [number, number]; + return `${args.property} must be between ${min} and ${max} code points`; + } +} + +export function CodePointLength(min: number, max: number): PropertyDecorator { + return (target, propertyKey) => { + registerDecorator({ + name: 'codePointLength', + target: target.constructor, + propertyName: String(propertyKey), + constraints: [min, max], + validator: CodePointLengthConstraint, + }); + }; +} diff --git a/app/src/messages/cache/messages-cache.service.ts b/app/src/messages/cache/messages-cache.service.ts index c41f5e49..565c17c4 100644 --- a/app/src/messages/cache/messages-cache.service.ts +++ b/app/src/messages/cache/messages-cache.service.ts @@ -3,15 +3,13 @@ import { ConfigService } from '@nestjs/config'; import { setTimeout as delay } from 'node:timers/promises'; import type { AppConfig } from '../../config/app-config.schema.js'; import { RedisClient } from '../../redis/redis.client.js'; +import type { Page } from '../../common/http/page.js'; import { MetricsService } from '../../metrics/metrics.service.js'; const LOCK_RETRY_COUNT = 4; const LOCK_RETRY_DELAY_MS = 25; -export type CachePage = { - items: unknown[]; - next_cursor: string | null; -}; +export type CachePage = Page; @Injectable() export class MessagesCacheService { diff --git a/app/src/messages/dto/create-message.dto.ts b/app/src/messages/dto/create-message.dto.ts index 875a3c22..57e5be26 100644 --- a/app/src/messages/dto/create-message.dto.ts +++ b/app/src/messages/dto/create-message.dto.ts @@ -1,7 +1,8 @@ -import { IsString, Length } from 'class-validator'; +import { IsString } from 'class-validator'; +import { CodePointLength } from '../../common/validation/code-point-length.js'; export class CreateMessageDto { @IsString() - @Length(1, 4000) + @CodePointLength(1, 4000) text!: string; } diff --git a/app/src/messages/messages.repository.ts b/app/src/messages/messages.repository.ts index 7427b28f..6f0e8a1d 100644 --- a/app/src/messages/messages.repository.ts +++ b/app/src/messages/messages.repository.ts @@ -1,12 +1,10 @@ import { - BadRequestException, Injectable, NotFoundException, } from '@nestjs/common'; import { randomUUID } from 'node:crypto'; import { DatabaseClient } from '../database/database.client.js'; import type { Cursor } from '../common/http/cursor.js'; -import type { User } from '../users/user.js'; import type { Message } from './message.js'; type MessageRow = { diff --git a/app/src/messages/messages.service.ts b/app/src/messages/messages.service.ts index 3db1128b..e95644a5 100644 --- a/app/src/messages/messages.service.ts +++ b/app/src/messages/messages.service.ts @@ -1,5 +1,6 @@ import { BadRequestException, Injectable } from '@nestjs/common'; import { decodeCursor, encodeCursor } from '../common/http/cursor.js'; +import type { Page } from '../common/http/page.js'; import type { User } from '../users/user.js'; import { ChatsService } from '../chats/chats.service.js'; import type { CreateMessageDto } from './dto/create-message.dto.js'; @@ -35,7 +36,7 @@ export class MessagesService { currentUser: User, limit: number, cursorValue?: string, - ): Promise<{ items: Message[]; next_cursor: string | null }> { + ): Promise> { await this.chatsService.getForUser(chatId, currentUser); const scope = `messages:${chatId}`; const cursor = cursorValue @@ -70,6 +71,6 @@ export class MessagesService { }; }, ); - return page as { items: Message[]; next_cursor: string | null }; + return page as Page; } } diff --git a/app/src/users/dto/create-user.dto.ts b/app/src/users/dto/create-user.dto.ts index fbbe6da3..8e82f58e 100644 --- a/app/src/users/dto/create-user.dto.ts +++ b/app/src/users/dto/create-user.dto.ts @@ -1,4 +1,5 @@ -import { IsString, Length, Matches } from 'class-validator'; +import { IsString, Matches } from 'class-validator'; +import { CodePointLength } from '../../common/validation/code-point-length.js'; export class CreateUserDTO { @IsString() @@ -6,13 +7,16 @@ export class CreateUserDTO { username!: string; @IsString() - @Length(1, 100) + @CodePointLength(1, 100) @Matches(/\S/u, { message: 'display_name must contain a non-whitespace character', }) display_name!: string; @IsString() - @Length(12, 128) + @CodePointLength(12, 128) + @Matches(/\S/u, { + message: 'password must contain a non-whitespace character', + }) password!: string; } diff --git a/app/src/users/users.service.ts b/app/src/users/users.service.ts index 341cebe0..e4ac35df 100644 --- a/app/src/users/users.service.ts +++ b/app/src/users/users.service.ts @@ -1,4 +1,4 @@ -import { BadRequestException, Injectable } from '@nestjs/common'; +import { Injectable } from '@nestjs/common'; import argon2 from 'argon2'; import { randomUUID } from 'node:crypto'; import { CreateUserDTO } from './dto/create-user.dto.js'; @@ -10,13 +10,6 @@ export class UsersService { constructor(private readonly usersRepository: UsersRepository) {} async create(input: CreateUserDTO): Promise { - if ( - [...input.display_name].length < 1 || - [...input.display_name].length > 100 || - input.display_name.trim().length === 0 - ) { - throw new BadRequestException('Invalid display name'); - } const passwordHash = await argon2.hash(input.password, { type: argon2.argon2id, }); diff --git a/app/test/app.e2e-spec.ts b/app/test/app.e2e-spec.ts index 00270906..ff45dc3e 100644 --- a/app/test/app.e2e-spec.ts +++ b/app/test/app.e2e-spec.ts @@ -3,6 +3,12 @@ import { randomUUID } from 'node:crypto'; import { setTimeout as sleep } from 'node:timers/promises'; import { Pool } from 'pg'; import { createClient } from 'redis'; +import type { SessionResponse } from '../src/auth/auth.service.js'; +import type { Chat } from '../src/chats/chat.js'; +import type { ApiErrorBody } from '../src/common/errors/api-error.js'; +import type { Page } from '../src/common/http/page.js'; +import type { Message } from '../src/messages/message.js'; +import type { User } from '../src/users/user.js'; // The suite is black-box: run it against the compiled application process. // Vitest sets process.env.BASE_URL itself (Vite base), so the API URL uses its own name. @@ -20,35 +26,6 @@ let sequence = 0; let database: Pool; let redis: ReturnType; -type User = { - id: string; - username: string; - display_name: string; - created_at: string; -}; -type Session = { - token: string; - token_type: string; - expires_at: string; - user: User; -}; -type Chat = { - id: string; - title: string; - member_ids: string[]; - created_at: string; -}; -type Message = { - id: string; - chat_id: string; - sender_id: string; - text: string; - created_at: string; -}; -type Page = { items: T[]; next_cursor: string | null }; -type ApiError = { - error: { code: string; message: string; request_id: string }; -}; type Actor = { user: User; password: string; token: string }; type HttpResult = { body: T; response: Response }; @@ -102,8 +79,8 @@ async function register( return result.body; } -async function login(user: User, secret = password): Promise { - const result = await http('/api/v1/auth/sessions', { +async function login(user: User, secret = password): Promise { + const result = await http('/api/v1/auth/sessions', { method: 'POST', headers: { authorization: basic(user.username, secret) }, }); @@ -119,7 +96,7 @@ async function actor(displayName?: string): Promise { } function expectError( - result: HttpResult, + result: HttpResult, status: number, code: string, ): void { @@ -174,13 +151,120 @@ describe('HTTP integration contract', () => { const live = await http<{ status: string }>('/health/live'); expect(live.response.status).toBe(200); expect(live.body).toEqual({ status: 'ok' }); - const denied = await http('/api/v1/users/me'); + const denied = await http('/api/v1/users/me'); expectError(denied, 401, 'unauthorized'); expect(denied.response.headers.get('www-authenticate')).toBe( bearerChallenge, ); }); + it('measures string lengths in Unicode code points', async () => { + const emoji = '🔐'; + const username = (suffix: string) => + `e2e_${runId}_${suffix}`.slice(0, 32); + const rejected = await http( + '/api/v1/users', + json({ + username: username('cp_short'), + display_name: 'Code points', + password: emoji.repeat(11), + }), + ); + expectError(rejected, 400, 'invalid_request'); + const tooLongPassword = await http( + '/api/v1/users', + json({ + username: username('cp_long'), + display_name: 'Code points', + password: emoji.repeat(129), + }), + ); + expectError(tooLongPassword, 400, 'invalid_request'); + const tooLongName = await http( + '/api/v1/users', + json({ + username: username('cp_name'), + display_name: emoji.repeat(101), + password, + }), + ); + expectError(tooLongName, 400, 'invalid_request'); + + const shortUsername = username('cp_ok'); + usernames.push(shortUsername); + const boundaryPassword = emoji.repeat(12); + const created = await http( + '/api/v1/users', + json({ + username: shortUsername, + display_name: emoji.repeat(100), + password: boundaryPassword, + }), + ); + expect(created.response.status).toBe(201); + expect([...created.body.display_name].length).toBe(100); + // The stored password keeps all 12 code points: authentication works. + const session = await http('/api/v1/auth/sessions', { + method: 'POST', + headers: { + authorization: basic(shortUsername, boundaryPassword), + }, + }); + expect(session.response.status).toBe(201); + tokens.push(session.body.token); + + const longTitleRejected = await http( + '/api/v1/chats', + json( + { title: emoji.repeat(101), member_ids: [created.body.id] }, + bearer(session.body.token), + ), + ); + expectError(longTitleRejected, 400, 'invalid_request'); + const longTitle = await http( + '/api/v1/chats', + json( + { title: emoji.repeat(100), member_ids: [created.body.id] }, + bearer(session.body.token), + ), + ); + expect(longTitle.response.status).toBe(201); + const tooLongText = await http( + `/api/v1/chats/${longTitle.body.id}/messages`, + json({ text: emoji.repeat(4001) }, bearer(session.body.token)), + ); + expectError(tooLongText, 400, 'invalid_request'); + const boundaryText = await http( + `/api/v1/chats/${longTitle.body.id}/messages`, + json({ text: emoji.repeat(4000) }, bearer(session.body.token)), + ); + expect(boundaryText.response.status).toBe(201); + expect([...boundaryText.body.text].length).toBe(4000); + }); + + it('rejects whitespace-only and too-short credentials', async () => { + const username = `e2e_${runId}_${sequence++}`.slice(0, 32); + usernames.push(username); + const cases = [ + { password: ' '.repeat(12), display_name: 'Пользователь' }, + { password: '\t'.repeat(16), display_name: 'Пользователь' }, + { password: 'short-pass', display_name: 'Пользователь' }, + { password, display_name: ' ' }, + ]; + for (const body of cases) { + const result = await http( + '/api/v1/users', + json({ username, ...body }), + ); + expectError(result, 400, 'invalid_request'); + } + const accepted = await http( + '/api/v1/users', + json({ username, display_name: 'Пользователь', password }), + ); + expect(accepted.response.status).toBe(201); + }); + it('registers, logs in with Unicode/colon password, and challenges malformed Basic', async () => { const user = await register(); const session = await login(user); @@ -196,7 +280,7 @@ describe('HTTP integration contract', () => { 'Basic YWJj', 'Bearer nope', ]) { - const result = await http('/api/v1/auth/sessions', { + const result = await http('/api/v1/auth/sessions', { method: 'POST', headers: { authorization }, }); @@ -205,7 +289,7 @@ describe('HTTP integration contract', () => { basicChallenge, ); } - const bodyResult = await http('/api/v1/auth/sessions', { + const bodyResult = await http('/api/v1/auth/sessions', { ...json({ unexpected: true }), headers: { authorization: basic(user.username, password) }, }); @@ -244,12 +328,12 @@ describe('HTTP integration contract', () => { it('uses Bearer only, ignores X-User-Id spoofing, and prevents logout replay', async () => { const alice = await actor('Алиса'); const bob = await actor('Боб'); - const spoof = await http('/api/v1/users/me', { + const spoof = await http('/api/v1/users/me', { headers: { ...bearer(alice.token), 'x-user-id': bob.user.id }, }); expect(spoof.response.status).toBe(200); expect((spoof.body as unknown as User).id).toBe(alice.user.id); - const basicBusiness = await http('/api/v1/users/me', { + const basicBusiness = await http('/api/v1/users/me', { headers: { authorization: basic(alice.user.username, password) }, }); expectError(basicBusiness, 401, 'unauthorized'); @@ -261,7 +345,7 @@ describe('HTTP integration contract', () => { headers: bearer(alice.token), }); expect(logout.response.status).toBe(204); - const replay = await http('/api/v1/users/me', { + const replay = await http('/api/v1/users/me', { headers: bearer(alice.token), }); expectError(replay, 401, 'unauthorized'); @@ -271,7 +355,7 @@ describe('HTTP integration contract', () => { const alice = await actor(); const bob = await actor(); const outsider = await actor(); - const unknown = await http( + const unknown = await http( '/api/v1/chats', json( { title: 'unknown', member_ids: [alice.user.id, randomUUID()] }, @@ -279,7 +363,7 @@ describe('HTTP integration contract', () => { ), ); expectError(unknown, 400, 'invalid_request'); - const leaked = await http(`/api/v1/chats?limit=100`, { + const leaked = await http(`/api/v1/chats?limit=100`, { headers: bearer(alice.token), }); expect(leaked.response.status).toBe(200); @@ -288,7 +372,7 @@ describe('HTTP integration contract', () => { (item) => item.title === 'unknown', ), ).toBe(false); - const duplicate = await http( + const duplicate = await http( '/api/v1/chats', json( { @@ -310,7 +394,7 @@ describe('HTTP integration contract', () => { ), ); expect(created.response.status).toBe(201); - const hidden = await http( + const hidden = await http( `/api/v1/chats/${created.body.id}`, { headers: bearer(outsider.token) }, ); @@ -328,7 +412,7 @@ describe('HTTP integration contract', () => { ), ); expect(chat.response.status).toBe(201); - const blank = await http( + const blank = await http( `/api/v1/chats/${chat.body.id}/messages`, json( { text: ' \n\t', sender_id: randomUUID() }, @@ -336,7 +420,7 @@ describe('HTTP integration contract', () => { ), ); expectError(blank, 400, 'invalid_request'); - const spoof = await http( + const spoof = await http( `/api/v1/chats/${chat.body.id}/messages`, json( { text: 'hello', sender_id: randomUUID() }, @@ -377,17 +461,31 @@ describe('HTTP integration contract', () => { ); expect(sent.response.status).toBe(201); } - const invalidLimit = await http( + const invalidLimit = await http( `/api/v1/chats/${chat.body.id}/messages?limit=101`, { headers: bearer(alice.token) }, ); expectError(invalidLimit, 400, 'invalid_request'); - const invalidCursor = await http( + const invalidCursor = await http( `/api/v1/chats/${chat.body.id}/messages?cursor=not-a-cursor`, { headers: bearer(alice.token) }, ); expectError(invalidCursor, 400, 'invalid_request'); - const malformed = await http('/api/v1/users', { + const rolledOver = http( + `/api/v1/chats/${chat.body.id}/messages?cursor=${encodeURIComponent( + Buffer.from( + JSON.stringify({ + scope: `messages:${chat.body.id}`, + created_at: '2026-02-31T00:00:00.000Z', + id: randomUUID(), + }), + 'utf8', + ).toString('base64url'), + )}`, + { headers: bearer(alice.token) }, + ); + expectError(await rolledOver, 400, 'invalid_request'); + const malformed = await http('/api/v1/users', { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{', @@ -418,7 +516,7 @@ describe('HTTP integration contract', () => { const user = await register(); const session = await login(user); await sleep(2300); - const expired = await http('/api/v1/users/me', { + const expired = await http('/api/v1/users/me', { headers: bearer(session.token), }); expectError(expired, 401, 'unauthorized'); diff --git a/app/test/dependency-failures.e2e-spec.ts b/app/test/dependency-failures.e2e-spec.ts new file mode 100644 index 00000000..ecd0cdbd --- /dev/null +++ b/app/test/dependency-failures.e2e-spec.ts @@ -0,0 +1,290 @@ +import { execFile } from 'node:child_process'; +import { randomUUID } from 'node:crypto'; +import { setTimeout as sleep } from 'node:timers/promises'; +import { fileURLToPath } from 'node:url'; +import { promisify } from 'node:util'; +import { afterAll, beforeAll, describe, expect, it } from 'vitest'; +import type { SessionResponse } from '../src/auth/auth.service.js'; +import type { Chat } from '../src/chats/chat.js'; +import type { ApiErrorBody } from '../src/common/errors/api-error.js'; +import type { Page } from '../src/common/http/page.js'; +import type { Message } from '../src/messages/message.js'; +import type { User } from '../src/users/user.js'; + +// Automated counterpart of the manual Redis/PostgreSQL outage checks: the suite +// stops a dependency of the Compose stand, asserts a bounded 503 (never a 500, +// never a trusted anonymous request, never a leaked driver error) and then +// restarts it to prove recovery without data loss. +// +// It is opt-in because it needs control over the Docker Compose project: +// make test-dependencies +// cd app && E2E_DEPENDENCY_FAULTS=1 npm run test:dependencies +const enabled = process.env.E2E_DEPENDENCY_FAULTS === '1'; +const baseUrl = (process.env.API_BASE_URL ?? 'http://localhost:8080').replace( + /\/+$/u, + '', +); +const composeDir = + process.env.E2E_COMPOSE_DIR ?? + fileURLToPath(new URL('../..', import.meta.url)); +const composeEnvFile = process.env.E2E_COMPOSE_ENV_FILE ?? '.env'; +const redisService = process.env.E2E_REDIS_SERVICE ?? 'redis'; +const postgresService = process.env.E2E_POSTGRES_SERVICE ?? 'postgres'; +const password = 'outage-check:пароль🔐'; +const runId = randomUUID().replaceAll('-', '').slice(0, 12); +// A request that reaches a stopped database waits for the pool connection +// timeout, so every outage step costs up to DATABASE_CONNECTION_TIMEOUT_MS. +const outagedRequestBudgetMs = 180_000; + +const execFileAsync = promisify(execFile); + +type Result = { body: T; text: string; response: Response }; + +async function compose(...args: string[]): Promise { + await execFileAsync( + 'docker', + ['compose', '--env-file', composeEnvFile, ...args], + { cwd: composeDir, timeout: 120_000 }, + ); +} + +async function request( + path: string, + init: RequestInit = {}, +): Promise> { + const response = await fetch(`${baseUrl}${path}`, init); + const text = await response.text(); + return { body: (text ? JSON.parse(text) : undefined) as T, text, response }; +} + +function json( + body: unknown, + headers: Record = {}, +): RequestInit { + return { + method: 'POST', + headers: { 'content-type': 'application/json', ...headers }, + body: JSON.stringify(body), + }; +} + +function bearer(token: string): Record { + return { authorization: `Bearer ${token}` }; +} + +function basic(username: string, secret: string): string { + return `Basic ${Buffer.from(`${username}:${secret}`, 'utf8').toString('base64')}`; +} + +// The dependencies recover asynchronously, so readiness is polled instead of +// asserted right after docker compose returns. +async function waitForReadiness( + expected: number, + timeoutMs = 90_000, +): Promise { + const deadline = Date.now() + timeoutMs; + let last: number | string = 'no response'; + for (;;) { + try { + const probe = await request('/health/ready'); + last = probe.response.status; + if (probe.response.status === expected) return; + } catch (error) { + last = error instanceof Error ? error.message : 'request failed'; + } + if (Date.now() > deadline) + throw new Error( + `readiness never became ${expected} within ${timeoutMs}ms (last: ${String(last)})`, + ); + await sleep(250); + } +} + +function expectBoundedOutage(result: Result): void { + expect(result.response.status).toBe(503); + expect(result.body.error.code).toBe('unavailable'); + expect(result.body.error.message).toBe('Service unavailable'); + expect(result.body.error.request_id).toBe( + result.response.headers.get('x-request-id'), + ); + // A bounded error must not leak driver details, SQL text or a stack trace. + expect(result.text).not.toMatch( + /ECONNREFUSED|ECONNRESET|Connection terminated|pg\.|node_modules|at .*\(.+:\d+:\d+\)/u, + ); +} + +async function historyOf( + chatId: string, + token: string, +): Promise>> { + return request>(`/api/v1/chats/${chatId}/messages?limit=100`, { + headers: bearer(token), + }); +} + +describe.skipIf(!enabled)('dependency outages', () => { + let user: User; + let token: string; + let chat: Chat; + let message: Message; + + beforeAll(async () => { + await compose('up', '-d'); + await waitForReadiness(200); + const username = `outage_${runId}`; + const registered = await request( + '/api/v1/users', + json({ username, display_name: 'Отказ зависимости', password }), + ); + expect(registered.response.status).toBe(201); + user = registered.body; + const session = await request( + '/api/v1/auth/sessions', + { + method: 'POST', + headers: { authorization: basic(username, password) }, + }, + ); + expect(session.response.status).toBe(201); + token = session.body.token; + const created = await request( + '/api/v1/chats', + json( + { title: `outage-${runId}`, member_ids: [user.id] }, + bearer(token), + ), + ); + expect(created.response.status).toBe(201); + chat = created.body; + const sent = await request( + `/api/v1/chats/${chat.id}/messages`, + json({ text: 'Сообщение до отказа' }, bearer(token)), + ); + expect(sent.response.status).toBe(201); + message = sent.body; + }, outagedRequestBudgetMs); + + afterAll(async () => { + // Always restore the stand, even when an assertion failed mid-outage. + await compose('start', redisService); + await compose('start', postgresService); + await waitForReadiness(200); + }, outagedRequestBudgetMs); + + it( + 'serves bounded 503 for the Redis outage and recovers the session', + async () => { + await compose('stop', redisService); + + const live = await request('/health/live'); + expect(live.response.status).toBe(200); + await waitForReadiness(503); + + expectBoundedOutage(await request('/health/ready')); + + expectBoundedOutage( + await request('/api/v1/users/me', { + headers: bearer(token), + }), + ); + + expectBoundedOutage( + await request('/api/v1/auth/sessions', { + method: 'POST', + headers: { authorization: basic(user.username, password) }, + }), + ); + + // A request without a session must stay unauthorized during an outage: + // the outage may not turn an anonymous caller into a trusted one. + const anonymous = await request('/api/v1/chats', { + headers: { 'x-user-id': user.id }, + }); + expect(anonymous.response.status).toBe(401); + expect(anonymous.body.error.code).toBe('unauthorized'); + + await compose('start', redisService); + await waitForReadiness(200); + + // Sessions live in Redis with persistence, so the old token still works. + const recovered = await request('/api/v1/users/me', { + headers: bearer(token), + }); + expect(recovered.response.status).toBe(200); + expect(recovered.body.id).toBe(user.id); + + const history = await historyOf(chat.id, token); + expect(history.response.status).toBe(200); + expect(history.body.items.map((item) => item.id)).toContain( + message.id, + ); + }, + outagedRequestBudgetMs, + ); + + it( + 'serves bounded 503 for the PostgreSQL outage and keeps confirmed data', + async () => { + await compose('stop', postgresService); + + const live = await request('/health/live'); + expect(live.response.status).toBe(200); + await waitForReadiness(503); + + expectBoundedOutage(await request('/health/ready')); + + // Redis still answers, so these requests reach the database layer. + expectBoundedOutage( + await request('/api/v1/users/me', { + headers: bearer(token), + }), + ); + + expectBoundedOutage( + await request('/api/v1/chats', { + headers: bearer(token), + }), + ); + + expectBoundedOutage( + await request( + `/api/v1/chats/${chat.id}/messages?limit=100`, + { headers: bearer(token) }, + ), + ); + + expectBoundedOutage( + await request( + '/api/v1/users', + json({ + username: `outage_${runId}_late`, + display_name: 'Отказ зависимости', + password, + }), + ), + ); + + await compose('start', postgresService); + await waitForReadiness(200); + + const recovered = await request('/api/v1/users/me', { + headers: bearer(token), + }); + expect(recovered.response.status).toBe(200); + expect(recovered.body.id).toBe(user.id); + + const history = await historyOf(chat.id, token); + expect(history.response.status).toBe(200); + expect(history.body.items.map((item) => item.id)).toContain( + message.id, + ); + + const sent = await request( + `/api/v1/chats/${chat.id}/messages`, + json({ text: 'Сообщение после отказа' }, bearer(token)), + ); + expect(sent.response.status).toBe(201); + }, + outagedRequestBudgetMs, + ); +}); diff --git a/app/vitest.config.e2e.ts b/app/vitest.config.e2e.ts index e7a3addd..a7d63173 100644 --- a/app/vitest.config.e2e.ts +++ b/app/vitest.config.e2e.ts @@ -6,7 +6,7 @@ export default defineConfig({ test: { globals: true, root: './', - include: ['test/app.e2e-spec.ts'], + include: ['test/*.e2e-spec.ts'], testTimeout: 30_000, hookTimeout: 30_000, sequence: { concurrent: false }, diff --git a/bruno/README.md b/bruno/README.md index 69a9d467..347c3873 100644 --- a/bruno/README.md +++ b/bruno/README.md @@ -21,7 +21,7 @@ cd bruno bru run -r --env-var metricsToken=$(grep '^METRICS_TOKEN=' ../.env | cut -d= -f2) ``` -Проверено на `bru` 4.2.1 против локального стенда: 28 запросов, 56 проверок, +Проверено на `bru` 4.2.1 против локального стенда: 29 запросов, 58 проверок, все зелёные (см. `../evidence/level3-4-verification.md` §12). Стенд должен быть поднят: `docker compose --env-file .env up -d --build`, @@ -60,7 +60,8 @@ chats/ создание чата (два участника), список health/ /health/live и /health/ready internal/ /internal/metrics и /internal/metrics/reset messages/ два сообщения, первая страница истории, страница по курсору -negative/ неверный пароль, Basic на бизнес-endpoint, X-User-Id, 404 чужого чата, 400 на limit/cursor и пробельный текст, 409 дубликата +negative/ неверный пароль, Basic на бизнес-endpoint, X-User-Id, 404 чужого чата, 400 на limit/cursor, + несуществующую календарную дату курсора и пробельный текст, 409 дубликата zz-cleanup/ logout и проверка, что отозванный токен даёт 401 (выполняется последним) ``` @@ -79,7 +80,7 @@ zz-cleanup/ logout и проверка, что отозванный токен - `messages/send-message*.bru` — `sender_id` выведен из сессии, `chat_id` верный; - `messages/history-*.bru` — `limit` соблюдён, курсор ведёт на следующую страницу и не повторяет элемент; - `internal/metrics.bru` — счётчики и агрегаты латентности без секретов; -- `negative/*` — коды и challenge-заголовки, отсутствие подмены владельца через `X-User-Id`, 404 вместо 403 для чужого чата, 409 при дубликате username, 400 на невалидные limit/cursor и пробельный текст. +- `negative/*` — коды и challenge-заголовки, отсутствие подмены владельца через `X-User-Id`, 404 вместо 403 для чужого чата, 409 при дубликате username, 400 на невалидные limit/cursor (включая несуществующую дату `2026-02-31`, которая раньше доходила до SQL и давала 500) и пробельный текст. ## Проверка истечения сессии diff --git a/bruno/chats/create-chat.bru b/bruno/chats/create-chat.bru index 2a27de61..8f4b3c99 100644 --- a/bruno/chats/create-chat.bru +++ b/bruno/chats/create-chat.bru @@ -14,13 +14,6 @@ headers { Authorization: Bearer {{token}} } -docs { - Составная операция в одной транзакции: проверка участников, вставка чата - и всех chat_members. Текущий пользователь обязан входить в member_ids, - неизвестные и дублирующиеся ID дают 400 без частичных данных. - Сохраняет chatId. -} - body:json { { "title": "Демо-чат {{suffix}}", @@ -28,11 +21,15 @@ body:json { } } +script:post-response { + bru.setVar("chatId", res.body.id); +} + tests { test("201 created", function() { expect(res.status).to.equal(201); }); - + test("оба участника в чате", function() { expect(res.body.member_ids).to.have.members([ bru.getVar("userId"), @@ -41,6 +38,9 @@ tests { }); } -script:post-response { - bru.setVar("chatId", res.body.id); +docs { + Составная операция в одной транзакции: проверка участников, вставка чата + и всех chat_members. Текущий пользователь обязан входить в member_ids, + неизвестные и дублирующиеся ID дают 400 без частичных данных. + Сохраняет chatId. } diff --git a/bruno/negative/invalid-calendar-cursor.bru b/bruno/negative/invalid-calendar-cursor.bru new file mode 100644 index 00000000..1f95ba1a --- /dev/null +++ b/bruno/negative/invalid-calendar-cursor.bru @@ -0,0 +1,46 @@ +meta { + name: Invalid calendar cursor + type: http + seq: 7 +} + +get { + url: {{baseUrl}}/api/v1/chats/{{chatId}}/messages?cursor={{calendarCursor}} + body: none + auth: none +} + +headers { + Authorization: Bearer {{token}} +} + +script:pre-request { + // Курсор собирается с реальным scope текущего чата, но с датой 31 февраля: + // платформенный Date.parse молча переносит её на 3 марта, поэтому проверка + // календаря (date-fns parseISO) должна отклонить запрос до SQL. + // В песочнице Bruno доступен btoa, но не Buffer. + const json = JSON.stringify({ + scope: `messages:${bru.getVar("chatId")}`, + created_at: "2026-02-31T00:00:00.000Z", + id: "00000000-0000-4000-8000-000000000000" + }); + const cursor = btoa(json).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, ""); + bru.setVar("calendarCursor", cursor); +} + +tests { + test("400 invalid_request", function() { + expect(res.status).to.equal(400); + }); + + test("формат ошибки по контракту", function() { + expect(res.body.error.code).to.equal("invalid_request"); + expect(res.body.error.request_id).to.equal(res.headers["x-request-id"]); + }); +} + +docs { + Несуществующая календарная дата (31 февраля, 29 февраля невисокосного года) + — 400 invalid_request, а не 500 из PostgreSQL. Регрессия: 2026-02-31 проходила + проверку формы и доходила до SQL. +} diff --git a/evidence/README.md b/evidence/README.md index c375bb5a..6d4c240d 100644 --- a/evidence/README.md +++ b/evidence/README.md @@ -7,7 +7,7 @@ | [`track1-cache-consistency.md`](track1-cache-consistency.md) | Трек 1: окружение, методика, счётчики и латентность по каждой повторности для naive и protected, сравнение, read-after-write, восстановление после рестарта Redis, план запроса, хеши артефактов, ограничения. | | [`level3-4-verification.md`](level3-4-verification.md) | Проверки уровня 3/4 с наблюдаемым выводом команд: контракт, сборка и тесты, миграции, публичный smoke, persistence-перезапуск, чёрно-белый интеграционный набор, истечение TTL, гонка username, rollback, отказы зависимостей, `EXPLAIN`, endpoint метрик, а также дефекты, найденные этим аудитом. | | [`track1-explain.md`](track1-explain.md) | Тексты анализируемых SQL-запросов, подготовка 10 000 синтетических строк и сырой `EXPLAIN (ANALYZE, BUFFERS)`: `Index Scan using messages_chat_created_id_idx` для первой страницы и для продолжения по keyset-cursor. | -| [`../bruno/README.md`](../bruno/README.md) | Коллекция ручных запросов Bruno ко всем эндпоинтам (28 запросов / 56 проверок, все зелёные) — удобно для разбора API вручную. | +| [`../bruno/README.md`](../bruno/README.md) | Коллекция ручных запросов Bruno ко всем эндпоинтам (29 запросов / 58 проверок, все зелёные) — удобно для разбора API вручную. | | `track1-raw/naive.json` (в Git не попадает) | Сырой вывод бенчмарка для `CACHE_MODE=naive`. | | `track1-raw/protected.json` (в Git не попадает) | Сырой вывод бенчмарка для `CACHE_MODE=protected`. | | `track1-raw/redis-restart.json` (в Git не попадает) | Сырой вывод проверки рестарта Redis. | diff --git a/evidence/level3-4-verification.md b/evidence/level3-4-verification.md index 1656b8d1..712170b8 100644 --- a/evidence/level3-4-verification.md +++ b/evidence/level3-4-verification.md @@ -82,10 +82,12 @@ $ (cd app && API_BASE_URL=http://localhost:8080 \ REDIS_URL=redis://:6379 \ npx vitest run --config ./vitest.config.e2e.ts) Test Files 1 passed (1) -Tests 7 passed | 1 skipped (8) +Tests 9 passed | 1 skipped (10) ``` -Покрыто: challenge для Basic/Bearer с точными значениями `WWW-Authenticate`, некорректный Basic, запрет тела при создании сессии, пароль с Unicode и двоеточием, гонка дублирующейся регистрации, подмена `X-User-Id`, повторное использование токена после logout, чужой чат скрыт (404), неизвестные и дублирующиеся участники, пробельный текст и подмена отправителя, read-after-write через вторую сессию, сломанный JSON, некорректные cursor/limit, keyset-пагинация без повторов. +Покрыто: challenge для Basic/Bearer с точными значениями `WWW-Authenticate`, некорректный Basic, запрет тела при создании сессии, пароль с Unicode и двоеточием, гонка дублирующейся регистрации, подмена `X-User-Id`, повторное использование токена после logout, чужой чат скрыт (404), неизвестные и дублирующиеся участники, пробельный текст и подмена отправителя, read-after-write через вторую сессию, сломанный JSON, некорректные cursor/limit (включая несуществующую календарную дату), +границы длин в Unicode code points для пароля, `display_name`, `title` и текста сообщения, +keyset-пагинация без повторов. Набор читает `API_BASE_URL`, потому что Vitest сам устанавливает `process.env.BASE_URL` в значение Vite base (`/`). Порты PostgreSQL и Redis наружу не публикуются, поэтому оператор передаёт адреса контейнеров. @@ -96,7 +98,7 @@ $ sed -i 's/^SESSION_TTL_SECONDS=.*/SESSION_TTL_SECONDS=2/' .env $ docker compose up -d api $ (cd app && API_BASE_URL=http://localhost:8080 ... SESSION_TTL_SECONDS=2 npx vitest run --config ./vitest.config.e2e.ts) Test Files 1 passed (1) -Tests 8 passed (8) +Tests 10 passed (10) ``` Кейс истечения: регистрация, вход, ожидание 2,3 с, ожидание `401 unauthorized` с Bearer-challenge. Работают и TTL Redis, и сериализованный `expires_at`. После проверки TTL возвращён в 3600. @@ -141,6 +143,29 @@ GET /users/me (валидный токен) -> 503 Здесь найден и исправлен реальный дефект: idle-клиент пула эмитил `error` на пул, Node считал это необработанным исключением, и процесс API завершался. Теперь `DatabaseClient` регистрирует `pool.on('error')` (счётчик `database.pool_error` + `warn` в лог), а ошибки доступности БД маппятся в ограниченную `503` в `ApiExceptionFilter` вместо `500`. +Тот же сценарий автоматизирован: `make test-dependencies` (или +`E2E_DEPENDENCY_FAULTS=1 npm run test:dependencies` из `app/`) сам останавливает +и поднимает контейнеры Compose-стенда и проверяет для обоих хранилищ, что +`/health/live` остаётся `200`, `/health/ready` и бизнес-запросы дают ограниченную +`503 unavailable` с `request_id`, равным `X-Request-Id`, в теле ошибки нет утечки +деталей драйвера/SQL/стека, запрос без сессии остаётся `401` (отказ не делает +анонимного вызывающего доверенным), а после старта зависимости работают прежняя +сессия, подтверждённое сообщение и новая запись. + +```text +$ make test-dependencies + Test Files 1 passed (1) + Tests 2 passed (2) + Duration 40.09s +``` + +Первая версия этого теста сразу нашла дефект: `POST /api/v1/users` при +остановленном PostgreSQL отвечал `500`, потому что часть ошибок node-postgres +не несёт поля `code` («Connection terminated unexpectedly», «timeout exceeded +when trying to connect»). Фильтр теперь распознаёт и такие сообщения, а +неожиданные исключения логируются на сервере (в ответе остаётся только +`internal_error`). + Путь деградации кэша (Redis недоступен → ответ из PostgreSQL, счётчик `cache_fallback`) подтверждён unit-тестами, а не этим экспериментом: при остановленном Redis бизнес-запрос останавливается раньше, на session guard, и по дизайну получает `503`, поэтому до слоя кэша не доходит. ## 11. План запроса истории @@ -174,8 +199,8 @@ latency: {count: 25, sample_count: 25, p50: 2.82, p95: 50.71, p99: 52.74, max: 5 Без корректного `METRICS_TOKEN` endpoint отдаёт `401`; в ответе нет токенов, кредов, тел запросов и SQL-текста. Тот же путь проверен ручным клиентом Bruno (`bruno/README.md`): из корня коллекции -`bru run -r --env-var metricsToken=` дал 28 запросов и -56 проверок без падений (регистрация трёх пользователей, три Basic-сессии, чат, +`bru run -r --env-var metricsToken=` дал 29 запросов и +58 проверок без падений (регистрация трёх пользователей, три Basic-сессии, чат, сообщения с пагинацией, метрики и негативные сценарии). `baseUrl` и пароль подставляются на уровне коллекции (`bruno/collection.bru`), поэтому вводить адрес в каждой ручке не требуется; без реального токена метрик два запроса к @@ -185,27 +210,36 @@ latency: {count: 25, sample_count: 25, p50: 2.82, p95: 50.71, p99: 52.74, max: 5 ## 13. Дефекты, найденные этим аудитом и исправленные -| Дефект | Симптом | Исправление | -|---|---|---| -| Отсутствовали DI-импорты зависимостей `CurrentUserGuard` | контейнер API `Exited (1)` с `UnknownDependenciesException` | `ChatsModule`/`MessagesModule` импортируют `RedisModule`, `MetricsModule`; `UsersModule` их реэкспортирует | -| Микросекунды PostgreSQL против миллисекунд JavaScript | вторая страница истории повторяла последнее сообщение (`make test` падал) | миграция `002_timestamp_precision.sql` → `timestamptz(3)` | -| Regex курсора требовал строго version 4 | валидные курсоры отклонялись как `400 invalid_request` | regex принимает любую корректную форму UUID плюс строгий RFC 3339 UTC timestamp | -| Необработанное событие `error` пула | процесс API умирал при недоступности PostgreSQL | обработчик `pool.on('error')` (счётчик `database.pool_error` + `warn`), отказ маппится в `503` | -| «Тихие» блоки `catch` | деградация кэша и зависимостей была невидима | счётчики (`cache_fallback`, `cache_write_error`, `cache_unlock_error`, `cache_lock_timeout`, `cache_corrupt_entry`, `database.pool_error`, `database.rollback_error`, `redis.error`) + `warn`-логи | -| Мёртвое состояние `lastError`, `getLastError()`, `isReady()` | заполнялось и нигде не читалось | удалено; листенеры пишут лог и счётчик | -| `POST /internal/metrics/reset` отвечал `201` | действие возвращало статус создания ресурса (нашлось прогоном коллекции Bruno) | добавлен `@HttpCode(HttpStatus.OK)`, теперь `200` | -| `nest build` не копировал `.sql`-миграции в `dist/` | локальный запуск `node dist/database/migration.runner.js` упал бы: каталога миграций в `dist/` нет, работал только Docker за счёт отдельного `COPY` | в `nest-cli.json` добавлен `assets: database/migrations/*.sql → dist`, лишний `COPY` из `Dockerfile` убран; проверено `docker run --rm --entrypoint ls mtusi-messenger:lab2 dist/database/migrations` и повторным запуском runner (exit 0) | +| Дефект | Симптом | Исправление | +| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Отсутствовали DI-импорты зависимостей `CurrentUserGuard` | контейнер API `Exited (1)` с `UnknownDependenciesException` | `ChatsModule`/`MessagesModule` импортируют `RedisModule`, `MetricsModule`; `UsersModule` их реэкспортирует | +| Микросекунды PostgreSQL против миллисекунд JavaScript | вторая страница истории повторяла последнее сообщение (`make test` падал) | миграция `002_timestamp_precision.sql` → `timestamptz(3)` | +| Regex курсора требовал строго version 4 | валидные курсоры отклонялись как `400 invalid_request` | regex принимает любую корректную форму UUID плюс строгий RFC 3339 UTC timestamp | +| Необработанное событие `error` пула | процесс API умирал при недоступности PostgreSQL | обработчик `pool.on('error')` (счётчик `database.pool_error` + `warn`), отказ маппится в `503` | +| «Тихие» блоки `catch` | деградация кэша и зависимостей была невидима | счётчики (`cache_fallback`, `cache_write_error`, `cache_unlock_error`, `cache_lock_timeout`, `cache_corrupt_entry`, `database.pool_error`, `database.rollback_error`, `redis.error`) + `warn`-логи | +| Мёртвое состояние `lastError`, `getLastError()`, `isReady()` | заполнялось и нигде не читалось | удалено; листенеры пишут лог и счётчик | +| `POST /internal/metrics/reset` отвечал `201` | действие возвращало статус создания ресурса (нашлось прогоном коллекции Bruno) | добавлен `@HttpCode(HttpStatus.OK)`, теперь `200` | +| Курсор с несуществующей датой (`2026-02-31`) отвечал `500` | `Date.parse` молча переносил дату на 3 марта, значение доходило до SQL и Postgres отклонял его | формат проверяется регулярным выражением, календарь — `date-fns` `parseISO` + `isValid`; невозможные даты и `24:00:00` дают `400 invalid_request` (unit-тесты `cursor.spec.ts`, e2e-кейс, `bruno/negative/invalid-calendar-cursor.bru`) | +| Длины строк мерились в UTF-16-единицах | `@Length` считает UTF-16: пароль из 11 эмодзи (22 единицы) проходил проверку «12+», а текст из 4000 эмодзи (8000 единиц) отклонялся как слишком длинный | собственный декоратор `@CodePointLength` (`app/src/common/validation/code-point-length.ts`) считает code points; применён к `display_name`, `password`, `title`, тексту сообщения; дублирующая проверка в `UsersService` удалена; unit-тесты границ + HTTP-кейс в `app/test/app.e2e-spec.ts` | +| Пароль из 12 пробелов принимался (`201`) | проверялась только длина, хотя контракт требует непустые по непробельным символам обязательные строки | в `CreateUserDTO` добавлен `@Matches(/\S/u)`; e2e-кейс отклоняет пробельный пароль, короткий пароль и пробельное `display_name`, при этом Unicode-пароль с двоеточием по-прежнему принимается | +| `POST /api/v1/users` при отказе PostgreSQL отвечал `500` | часть ошибок node-postgres приходит без `code`, поэтому фильтр не относил их к отказу зависимости (нашёл автоматический тест `make test-dependencies`) | фильтр распознаёт тексты «Connection terminated unexpectedly»/«timeout exceeded when trying to connect» и логирует неожиданные исключения серверно | +| `nest build` не копировал `.sql`-миграции в `dist/` | локальный запуск `node dist/database/migration.runner.js` упал бы: каталога миграций в `dist/` нет, работал только Docker за счёт отдельного `COPY` | в `nest-cli.json` добавлен `assets: database/migrations/*.sql → dist`, лишний `COPY` из `Dockerfile` убран; проверено `docker run --rm --entrypoint ls mtusi-messenger:lab2 dist/database/migrations` и повторным запуском runner (exit 0) | ## 14. Инвентарь артефактов -| Артефакт | Назначение | -| ---------------------------------------- | --------------------------------------------------------- | -| `evidence/track1-cache-consistency.md` | подробный отчёт по треку 1 с таблицами по повторностям | -| `evidence/track1-raw/naive.json` | сырой прогон naive (в Git не попадает) | -| `evidence/track1-raw/protected.json` | сырой прогон protected (в Git не попадает) | -| `evidence/track1-raw/redis-restart.json` | сырая проверка рестарта Redis (в Git не попадает) | -| `evidence/track1-explain.md` | запросы и `EXPLAIN (ANALYZE, BUFFERS)` | -| `bruno/README.md` | коллекция ручных запросов (Bruno) ко всем эндпоинтам | -| `REPORT.md` | основной отчёт: архитектура, решения, команды, результаты | +| Артефакт | Назначение | +| ----------------------------------------------------- | --------------------------------------------------------------------------- | +| `evidence/track1-cache-consistency.md` | подробный отчёт по треку 1 с таблицами по повторностям | +| `evidence/track1-raw/naive.json` | сырой прогон naive (в Git не попадает) | +| `evidence/track1-raw/protected.json` | сырой прогон protected (в Git не попадает) | +| `evidence/track1-raw/redis-restart.json` | сырая проверка рестарта Redis (в Git не попадает) | +| `evidence/track1-explain.md` | запросы и `EXPLAIN (ANALYZE, BUFFERS)` | +| `bruno/README.md` | коллекция ручных запросов (Bruno) ко всем эндпоинтам | +| `app/test/app.e2e-spec.ts` | black-box набор против запущенного API (реальные PG/Redis) | +| `app/test/dependency-failures.e2e-spec.ts` | автоматическая проверка отказов Redis/PostgreSQL (`make test-dependencies`) | +| `app/src/common/http/cursor.spec.ts` | unit-тесты разбора курсора (формат, календарь, scope) | +| `app/src/common/validation/code-point-length.ts` | декоратор проверки длины в Unicode code points | +| `app/src/common/validation/code-point-length.spec.ts` | unit-тесты границ декоратора по code points | +| `REPORT.md` | основной отчёт: архитектура, решения, команды, результаты | Хеши сырых артефактов перечислены в `evidence/track1-cache-consistency.md` §8. -- 2.54.0