From d55fa665238ac07b163d7a36609f4a761994a5e3 Mon Sep 17 00:00:00 2001 From: rckrdmrd Date: Sun, 4 Jan 2026 06:12:11 -0600 Subject: [PATCH] Initial commit - erp-suite --- DEPLOYMENT.md | 330 + INVENTARIO.yml | 36 + PURGE-LOG.yml | 17 + README.md | 276 + apps/products/erp-basico/README.md | 191 + .../00-guidelines/CONTEXTO-PROYECTO.md | 238 + .../00-guidelines/HERENCIA-SIMCO.md | 116 + apps/products/pos-micro/README.md | 139 + apps/products/pos-micro/backend/.env.example | 38 + apps/products/pos-micro/backend/Dockerfile | 70 + apps/products/pos-micro/backend/nest-cli.json | 8 + .../pos-micro/backend/package-lock.json | 10752 ++++++++++++++++ apps/products/pos-micro/backend/package.json | 83 + .../pos-micro/backend/src/app.module.ts | 45 + apps/products/pos-micro/backend/src/main.ts | 81 + .../src/modules/auth/auth.controller.ts | 110 + .../backend/src/modules/auth/auth.module.ts | 32 + .../backend/src/modules/auth/auth.service.ts | 218 + .../src/modules/auth/dto/register.dto.ts | 134 + .../modules/auth/entities/tenant.entity.ts | 94 + .../src/modules/auth/entities/user.entity.ts | 48 + .../src/modules/auth/guards/jwt-auth.guard.ts | 16 + .../modules/auth/strategies/jwt.strategy.ts | 39 + .../categories/categories.controller.ts | 94 + .../modules/categories/categories.module.ts | 17 + .../modules/categories/categories.service.ts | 115 + .../categories/entities/category.entity.ts | 43 + .../entities/payment-method.entity.ts | 36 + .../modules/payments/payments.controller.ts | 77 + .../src/modules/payments/payments.module.ts | 17 + .../src/modules/payments/payments.service.ts | 84 + .../src/modules/products/dto/product.dto.ts | 179 + .../products/entities/product.entity.ts | 75 + .../modules/products/products.controller.ts | 147 + .../src/modules/products/products.module.ts | 17 + .../src/modules/products/products.service.ts | 215 + .../backend/src/modules/sales/dto/sale.dto.ts | 161 + .../sales/entities/sale-item.entity.ts | 52 + .../src/modules/sales/entities/sale.entity.ts | 86 + .../src/modules/sales/sales.controller.ts | 101 + .../backend/src/modules/sales/sales.module.ts | 20 + .../src/modules/sales/sales.service.ts | 270 + apps/products/pos-micro/backend/tsconfig.json | 27 + .../pos-micro/database/ddl/00-schema.sql | 596 + apps/products/pos-micro/docker-compose.yml | 73 + apps/products/pos-micro/docs/ANALISIS-GAPS.md | 192 + apps/products/pos-micro/frontend/.env.example | 6 + apps/products/pos-micro/frontend/Dockerfile | 58 + apps/products/pos-micro/frontend/index.html | 19 + apps/products/pos-micro/frontend/nginx.conf | 35 + .../pos-micro/frontend/package-lock.json | 8820 +++++++++++++ apps/products/pos-micro/frontend/package.json | 40 + .../pos-micro/frontend/postcss.config.js | 6 + apps/products/pos-micro/frontend/src/App.tsx | 62 + .../frontend/src/components/CartPanel.tsx | 103 + .../frontend/src/components/CategoryTabs.tsx | 58 + .../frontend/src/components/CheckoutModal.tsx | 306 + .../frontend/src/components/Header.tsx | 102 + .../frontend/src/components/ProductCard.tsx | 77 + .../frontend/src/components/SuccessModal.tsx | 114 + .../frontend/src/hooks/usePayments.ts | 14 + .../frontend/src/hooks/useProducts.ts | 70 + .../pos-micro/frontend/src/hooks/useSales.ts | 84 + apps/products/pos-micro/frontend/src/main.tsx | 25 + .../frontend/src/pages/LoginPage.tsx | 183 + .../pos-micro/frontend/src/pages/POSPage.tsx | 154 + .../frontend/src/pages/ReportsPage.tsx | 115 + .../pos-micro/frontend/src/services/api.ts | 61 + .../pos-micro/frontend/src/store/auth.ts | 61 + .../pos-micro/frontend/src/store/cart.ts | 149 + .../pos-micro/frontend/src/styles/index.css | 82 + .../pos-micro/frontend/src/types/index.ts | 144 + .../pos-micro/frontend/src/vite-env.d.ts | 1 + .../pos-micro/frontend/tailwind.config.js | 26 + .../products/pos-micro/frontend/tsconfig.json | 25 + .../pos-micro/frontend/tsconfig.node.json | 10 + .../pos-micro/frontend/vite.config.ts | 70 + .../00-guidelines/CONTEXTO-PROYECTO.md | 164 + .../00-guidelines/HERENCIA-SIMCO.md | 130 + apps/products/pos-micro/scripts/dev.sh | 75 + apps/saas/README.md | 198 + apps/saas/billing/database/ddl/00-schema.sql | 676 + apps/saas/orchestration/CONTEXTO-SAAS.md | 122 + apps/shared-libs/core/MIGRATION_GUIDE.md | 615 + .../core/constants/database.constants.ts | 163 + .../policies/CENTRALIZATION-SUMMARY.md | 390 + .../core/database/policies/README.md | 324 + .../core/database/policies/apply-rls.ts | 564 + .../database/policies/migration-example.ts | 152 + .../core/database/policies/rls-policies.sql | 514 + .../core/database/policies/usage-example.ts | 405 + apps/shared-libs/core/entities/base.entity.ts | 57 + .../core/entities/tenant.entity.ts | 43 + apps/shared-libs/core/entities/user.entity.ts | 54 + .../core/errors/IMPLEMENTATION_SUMMARY.md | 277 + .../core/errors/INTEGRATION_GUIDE.md | 421 + .../core/errors/QUICK_REFERENCE.md | 243 + apps/shared-libs/core/errors/README.md | 574 + apps/shared-libs/core/errors/STRUCTURE.md | 241 + apps/shared-libs/core/errors/base-error.ts | 71 + apps/shared-libs/core/errors/error-filter.ts | 230 + .../core/errors/error-middleware.ts | 262 + .../errors/express-integration.example.ts | 464 + apps/shared-libs/core/errors/http-errors.ts | 148 + apps/shared-libs/core/errors/index.ts | 44 + .../core/errors/nestjs-integration.example.ts | 272 + .../core/examples/user.repository.example.ts | 371 + .../core/factories/repository.factory.ts | 343 + apps/shared-libs/core/index.ts | 153 + .../core/interfaces/base-service.interface.ts | 83 + .../core/interfaces/repository.interface.ts | 483 + .../core/middleware/auth.middleware.ts | 131 + .../core/middleware/tenant.middleware.ts | 114 + .../shared-libs/core/services/auth.service.ts | 419 + .../core/services/base-typeorm.service.ts | 229 + .../core/types/pagination.types.ts | 54 + docker/docker-compose.prod.yml | 143 + ...LISIS-REQUERIMIENTOS-SAAS-TRANSVERSALES.md | 983 ++ .../ARQUITECTURA-INFRAESTRUCTURA-SAAS.md | 875 ++ .../roadmap/ROADMAP-EPICAS-SAAS.md | 318 + .../stripe/SPEC-STRIPE-INTEGRATION.md | 1799 +++ docs/ANALISIS-ARQUITECTURA-ERP-SUITE.md | 572 + docs/ANALISIS-ESTRUCTURA-DOCUMENTACION.md | 395 + docs/ARCHITECTURE.md | 565 + docs/ESTANDAR-NOMENCLATURA-SCHEMAS.md | 345 + docs/ESTRUCTURA-DOCUMENTACION-ERP.md | 346 + docs/MULTI-TENANCY.md | 674 + docs/PLAN-MIGRACION-SCHEMAS.md | 250 + docs/REPORTE-ALINEACION-VERTICALES.md | 281 + ...ORTE-CUMPLIMIENTO-DIRECTIVAS-VERTICALES.md | 273 + docs/REPORTE-VALIDACION-DDL-VERTICALES.md | 288 + docs/VERTICAL-GUIDE.md | 763 ++ docs/_MAP.md | 40 + jenkins/Jenkinsfile | 449 + nginx/erp-suite.conf | 402 + nginx/erp.conf | 130 + .../00-guidelines/CONTEXTO-PROYECTO.md | 167 + .../00-guidelines/HERENCIA-DIRECTIVAS.md | 128 + .../00-guidelines/HERENCIA-ERP-CORE.md | 105 + orchestration/00-guidelines/HERENCIA-SIMCO.md | 312 + orchestration/00-guidelines/PROJECT-STATUS.md | 33 + orchestration/PROXIMA-ACCION.md | 112 + .../environment/PROJECT-ENV-CONFIG.yml | 186 + .../estados/REGISTRO-SUBAGENTES.json | 92 + .../inventarios/MASTER_INVENTORY.yml | 177 + orchestration/inventarios/REFERENCIAS.yml | 370 + orchestration/inventarios/STATUS.yml | 315 + .../inventarios/SUITE_MASTER_INVENTORY.yml | 506 + orchestration/prompts/PROMPT-BACKEND-AGENT.md | 133 + .../prompts/PROMPT-DATABASE-AGENT.md | 123 + .../prompts/PROMPT-FRONTEND-AGENT.md | 134 + orchestration/trazas/TRAZA-SUITE.md | 322 + package.json | 19 + scripts/deploy.sh | 220 + scripts/deploy/Jenkinsfile.backend.example | 136 + scripts/deploy/Jenkinsfile.frontend.example | 142 + scripts/deploy/README.md | 193 + scripts/deploy/sync-to-deploy-repos.sh | 306 + 158 files changed, 51280 insertions(+) create mode 100644 DEPLOYMENT.md create mode 100644 INVENTARIO.yml create mode 100644 PURGE-LOG.yml create mode 100644 README.md create mode 100644 apps/products/erp-basico/README.md create mode 100644 apps/products/erp-basico/orchestration/00-guidelines/CONTEXTO-PROYECTO.md create mode 100644 apps/products/erp-basico/orchestration/00-guidelines/HERENCIA-SIMCO.md create mode 100644 apps/products/pos-micro/README.md create mode 100644 apps/products/pos-micro/backend/.env.example create mode 100644 apps/products/pos-micro/backend/Dockerfile create mode 100644 apps/products/pos-micro/backend/nest-cli.json create mode 100644 apps/products/pos-micro/backend/package-lock.json create mode 100644 apps/products/pos-micro/backend/package.json create mode 100644 apps/products/pos-micro/backend/src/app.module.ts create mode 100644 apps/products/pos-micro/backend/src/main.ts create mode 100644 apps/products/pos-micro/backend/src/modules/auth/auth.controller.ts create mode 100644 apps/products/pos-micro/backend/src/modules/auth/auth.module.ts create mode 100644 apps/products/pos-micro/backend/src/modules/auth/auth.service.ts create mode 100644 apps/products/pos-micro/backend/src/modules/auth/dto/register.dto.ts create mode 100644 apps/products/pos-micro/backend/src/modules/auth/entities/tenant.entity.ts create mode 100644 apps/products/pos-micro/backend/src/modules/auth/entities/user.entity.ts create mode 100644 apps/products/pos-micro/backend/src/modules/auth/guards/jwt-auth.guard.ts create mode 100644 apps/products/pos-micro/backend/src/modules/auth/strategies/jwt.strategy.ts create mode 100644 apps/products/pos-micro/backend/src/modules/categories/categories.controller.ts create mode 100644 apps/products/pos-micro/backend/src/modules/categories/categories.module.ts create mode 100644 apps/products/pos-micro/backend/src/modules/categories/categories.service.ts create mode 100644 apps/products/pos-micro/backend/src/modules/categories/entities/category.entity.ts create mode 100644 apps/products/pos-micro/backend/src/modules/payments/entities/payment-method.entity.ts create mode 100644 apps/products/pos-micro/backend/src/modules/payments/payments.controller.ts create mode 100644 apps/products/pos-micro/backend/src/modules/payments/payments.module.ts create mode 100644 apps/products/pos-micro/backend/src/modules/payments/payments.service.ts create mode 100644 apps/products/pos-micro/backend/src/modules/products/dto/product.dto.ts create mode 100644 apps/products/pos-micro/backend/src/modules/products/entities/product.entity.ts create mode 100644 apps/products/pos-micro/backend/src/modules/products/products.controller.ts create mode 100644 apps/products/pos-micro/backend/src/modules/products/products.module.ts create mode 100644 apps/products/pos-micro/backend/src/modules/products/products.service.ts create mode 100644 apps/products/pos-micro/backend/src/modules/sales/dto/sale.dto.ts create mode 100644 apps/products/pos-micro/backend/src/modules/sales/entities/sale-item.entity.ts create mode 100644 apps/products/pos-micro/backend/src/modules/sales/entities/sale.entity.ts create mode 100644 apps/products/pos-micro/backend/src/modules/sales/sales.controller.ts create mode 100644 apps/products/pos-micro/backend/src/modules/sales/sales.module.ts create mode 100644 apps/products/pos-micro/backend/src/modules/sales/sales.service.ts create mode 100644 apps/products/pos-micro/backend/tsconfig.json create mode 100644 apps/products/pos-micro/database/ddl/00-schema.sql create mode 100644 apps/products/pos-micro/docker-compose.yml create mode 100644 apps/products/pos-micro/docs/ANALISIS-GAPS.md create mode 100644 apps/products/pos-micro/frontend/.env.example create mode 100644 apps/products/pos-micro/frontend/Dockerfile create mode 100644 apps/products/pos-micro/frontend/index.html create mode 100644 apps/products/pos-micro/frontend/nginx.conf create mode 100644 apps/products/pos-micro/frontend/package-lock.json create mode 100644 apps/products/pos-micro/frontend/package.json create mode 100644 apps/products/pos-micro/frontend/postcss.config.js create mode 100644 apps/products/pos-micro/frontend/src/App.tsx create mode 100644 apps/products/pos-micro/frontend/src/components/CartPanel.tsx create mode 100644 apps/products/pos-micro/frontend/src/components/CategoryTabs.tsx create mode 100644 apps/products/pos-micro/frontend/src/components/CheckoutModal.tsx create mode 100644 apps/products/pos-micro/frontend/src/components/Header.tsx create mode 100644 apps/products/pos-micro/frontend/src/components/ProductCard.tsx create mode 100644 apps/products/pos-micro/frontend/src/components/SuccessModal.tsx create mode 100644 apps/products/pos-micro/frontend/src/hooks/usePayments.ts create mode 100644 apps/products/pos-micro/frontend/src/hooks/useProducts.ts create mode 100644 apps/products/pos-micro/frontend/src/hooks/useSales.ts create mode 100644 apps/products/pos-micro/frontend/src/main.tsx create mode 100644 apps/products/pos-micro/frontend/src/pages/LoginPage.tsx create mode 100644 apps/products/pos-micro/frontend/src/pages/POSPage.tsx create mode 100644 apps/products/pos-micro/frontend/src/pages/ReportsPage.tsx create mode 100644 apps/products/pos-micro/frontend/src/services/api.ts create mode 100644 apps/products/pos-micro/frontend/src/store/auth.ts create mode 100644 apps/products/pos-micro/frontend/src/store/cart.ts create mode 100644 apps/products/pos-micro/frontend/src/styles/index.css create mode 100644 apps/products/pos-micro/frontend/src/types/index.ts create mode 100644 apps/products/pos-micro/frontend/src/vite-env.d.ts create mode 100644 apps/products/pos-micro/frontend/tailwind.config.js create mode 100644 apps/products/pos-micro/frontend/tsconfig.json create mode 100644 apps/products/pos-micro/frontend/tsconfig.node.json create mode 100644 apps/products/pos-micro/frontend/vite.config.ts create mode 100644 apps/products/pos-micro/orchestration/00-guidelines/CONTEXTO-PROYECTO.md create mode 100644 apps/products/pos-micro/orchestration/00-guidelines/HERENCIA-SIMCO.md create mode 100755 apps/products/pos-micro/scripts/dev.sh create mode 100644 apps/saas/README.md create mode 100644 apps/saas/billing/database/ddl/00-schema.sql create mode 100644 apps/saas/orchestration/CONTEXTO-SAAS.md create mode 100644 apps/shared-libs/core/MIGRATION_GUIDE.md create mode 100644 apps/shared-libs/core/constants/database.constants.ts create mode 100644 apps/shared-libs/core/database/policies/CENTRALIZATION-SUMMARY.md create mode 100644 apps/shared-libs/core/database/policies/README.md create mode 100644 apps/shared-libs/core/database/policies/apply-rls.ts create mode 100644 apps/shared-libs/core/database/policies/migration-example.ts create mode 100644 apps/shared-libs/core/database/policies/rls-policies.sql create mode 100644 apps/shared-libs/core/database/policies/usage-example.ts create mode 100644 apps/shared-libs/core/entities/base.entity.ts create mode 100644 apps/shared-libs/core/entities/tenant.entity.ts create mode 100644 apps/shared-libs/core/entities/user.entity.ts create mode 100644 apps/shared-libs/core/errors/IMPLEMENTATION_SUMMARY.md create mode 100644 apps/shared-libs/core/errors/INTEGRATION_GUIDE.md create mode 100644 apps/shared-libs/core/errors/QUICK_REFERENCE.md create mode 100644 apps/shared-libs/core/errors/README.md create mode 100644 apps/shared-libs/core/errors/STRUCTURE.md create mode 100644 apps/shared-libs/core/errors/base-error.ts create mode 100644 apps/shared-libs/core/errors/error-filter.ts create mode 100644 apps/shared-libs/core/errors/error-middleware.ts create mode 100644 apps/shared-libs/core/errors/express-integration.example.ts create mode 100644 apps/shared-libs/core/errors/http-errors.ts create mode 100644 apps/shared-libs/core/errors/index.ts create mode 100644 apps/shared-libs/core/errors/nestjs-integration.example.ts create mode 100644 apps/shared-libs/core/examples/user.repository.example.ts create mode 100644 apps/shared-libs/core/factories/repository.factory.ts create mode 100644 apps/shared-libs/core/index.ts create mode 100644 apps/shared-libs/core/interfaces/base-service.interface.ts create mode 100644 apps/shared-libs/core/interfaces/repository.interface.ts create mode 100644 apps/shared-libs/core/middleware/auth.middleware.ts create mode 100644 apps/shared-libs/core/middleware/tenant.middleware.ts create mode 100644 apps/shared-libs/core/services/auth.service.ts create mode 100644 apps/shared-libs/core/services/base-typeorm.service.ts create mode 100644 apps/shared-libs/core/types/pagination.types.ts create mode 100644 docker/docker-compose.prod.yml create mode 100644 docs/02-especificaciones-tecnicas/saas-platform/ANALISIS-REQUERIMIENTOS-SAAS-TRANSVERSALES.md create mode 100644 docs/02-especificaciones-tecnicas/saas-platform/arquitectura/ARQUITECTURA-INFRAESTRUCTURA-SAAS.md create mode 100644 docs/02-especificaciones-tecnicas/saas-platform/roadmap/ROADMAP-EPICAS-SAAS.md create mode 100644 docs/02-especificaciones-tecnicas/saas-platform/stripe/SPEC-STRIPE-INTEGRATION.md create mode 100644 docs/ANALISIS-ARQUITECTURA-ERP-SUITE.md create mode 100644 docs/ANALISIS-ESTRUCTURA-DOCUMENTACION.md create mode 100644 docs/ARCHITECTURE.md create mode 100644 docs/ESTANDAR-NOMENCLATURA-SCHEMAS.md create mode 100644 docs/ESTRUCTURA-DOCUMENTACION-ERP.md create mode 100644 docs/MULTI-TENANCY.md create mode 100644 docs/PLAN-MIGRACION-SCHEMAS.md create mode 100644 docs/REPORTE-ALINEACION-VERTICALES.md create mode 100644 docs/REPORTE-CUMPLIMIENTO-DIRECTIVAS-VERTICALES.md create mode 100644 docs/REPORTE-VALIDACION-DDL-VERTICALES.md create mode 100644 docs/VERTICAL-GUIDE.md create mode 100644 docs/_MAP.md create mode 100644 jenkins/Jenkinsfile create mode 100644 nginx/erp-suite.conf create mode 100644 nginx/erp.conf create mode 100644 orchestration/00-guidelines/CONTEXTO-PROYECTO.md create mode 100644 orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md create mode 100644 orchestration/00-guidelines/HERENCIA-ERP-CORE.md create mode 100644 orchestration/00-guidelines/HERENCIA-SIMCO.md create mode 100644 orchestration/00-guidelines/PROJECT-STATUS.md create mode 100644 orchestration/PROXIMA-ACCION.md create mode 100644 orchestration/environment/PROJECT-ENV-CONFIG.yml create mode 100644 orchestration/estados/REGISTRO-SUBAGENTES.json create mode 100644 orchestration/inventarios/MASTER_INVENTORY.yml create mode 100644 orchestration/inventarios/REFERENCIAS.yml create mode 100644 orchestration/inventarios/STATUS.yml create mode 100644 orchestration/inventarios/SUITE_MASTER_INVENTORY.yml create mode 100644 orchestration/prompts/PROMPT-BACKEND-AGENT.md create mode 100644 orchestration/prompts/PROMPT-DATABASE-AGENT.md create mode 100644 orchestration/prompts/PROMPT-FRONTEND-AGENT.md create mode 100644 orchestration/trazas/TRAZA-SUITE.md create mode 100644 package.json create mode 100755 scripts/deploy.sh create mode 100644 scripts/deploy/Jenkinsfile.backend.example create mode 100644 scripts/deploy/Jenkinsfile.frontend.example create mode 100644 scripts/deploy/README.md create mode 100755 scripts/deploy/sync-to-deploy-repos.sh diff --git a/DEPLOYMENT.md b/DEPLOYMENT.md new file mode 100644 index 0000000..13a5a54 --- /dev/null +++ b/DEPLOYMENT.md @@ -0,0 +1,330 @@ +# ERP-Suite - Arquitectura de Despliegue + +## Resumen Ejecutivo + +ERP-Suite es un **monorepo de microservicios con base de datos compartida**. Cada vertical es un proyecto independiente que: +- Se compila y despliega por separado +- Tiene su propia configuración de puertos +- Comparte la misma instancia de PostgreSQL pero con **schemas separados** +- Hereda patrones arquitectónicos de erp-core (no código directo) + +--- + +## 1. Arquitectura General + +``` +┌─────────────────────────────────────────────────────────────────────────────┐ +│ ERP-SUITE ARCHITECTURE │ +├─────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐│ +│ │ NGINX (80/443) ││ +│ │ erp.isem.dev | construccion.erp.isem.dev | mecanicas.erp.isem.dev ││ +│ └─────────────────────────────────────────────────────────────────────────┘│ +│ │ │ +│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ +│ │ ERP-CORE │ │CONSTRUCCION│ │ VIDRIO │ │ MECANICAS │ │ RETAIL │ │ +│ │ FE: 3010 │ │ FE: 3020 │ │ FE: 3030 │ │ FE: 3040 │ │ FE: 3050 │ │ +│ │ BE: 3011 │ │ BE: 3021 │ │ BE: 3031 │ │ BE: 3041 │ │ BE: 3051 │ │ +│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │ +│ │ +│ ┌───────────┐ ┌───────────┐ │ +│ │ CLINICAS │ │ POS-MICRO │ │ +│ │ FE: 3060 │ │ FE: 3070 │ │ +│ │ BE: 3061 │ │ BE: 3071 │ │ +│ └───────────┘ └───────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐│ +│ │ PostgreSQL (5432) - BD COMPARTIDA ││ +│ │ ┌─────────┐ ┌─────────┐ ┌─────────────┐ ┌─────────────┐ ┌───────────┐ ││ +│ │ │ auth │ │ core │ │ construccion│ │ mecanicas │ │ retail │ ││ +│ │ │ schema │ │ schema │ │ schema │ │ schema │ │ schema │ ││ +│ │ └─────────┘ └─────────┘ └─────────────┘ └─────────────┘ └───────────┘ ││ +│ └─────────────────────────────────────────────────────────────────────────┘│ +│ │ +└─────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 2. Matriz de Componentes + +### 2.1 Proyectos y Puertos + +| Componente | Frontend | Backend | DB Schema | Redis | Estado | +|------------|----------|---------|-----------|-------|--------| +| **erp-core** | 3010 | 3011 | auth, core, inventory | 6379 | ✅ 60% | +| **construccion** | 3020 | 3021 | construccion (7 sub-schemas) | 6380 | ✅ 35% | +| **vidrio-templado** | 3030 | 3031 | vidrio | 6381 | ⏳ 0% | +| **mecanicas-diesel** | 3040 | 3041 | service_mgmt, parts_mgmt, vehicle_mgmt | 6379 | ⏳ 0% | +| **retail** | 3050 | 3051 | retail | 6383 | ⏳ 25% | +| **clinicas** | 3060 | 3061 | clinicas | 6384 | ⏳ 0% | +| **pos-micro** | 3070 | 3071 | pos | 6379 | ⏳ Planificado | + +### 2.2 Subdominios + +| Vertical | Frontend | API | +|----------|----------|-----| +| erp-core | erp.isem.dev | api.erp.isem.dev | +| construccion | construccion.erp.isem.dev | api.construccion.erp.isem.dev | +| vidrio-templado | vidrio.erp.isem.dev | api.vidrio.erp.isem.dev | +| mecanicas-diesel | mecanicas.erp.isem.dev | api.mecanicas.erp.isem.dev | +| retail | retail.erp.isem.dev | api.retail.erp.isem.dev | +| clinicas | clinicas.erp.isem.dev | api.clinicas.erp.isem.dev | +| pos-micro | pos.erp.isem.dev | api.pos.erp.isem.dev | + +--- + +## 3. Estructura de Base de Datos + +### 3.1 Modelo de Schemas + +```sql +-- ORDEN DE CARGA DDL +-- 1. ERP-CORE (base requerida) +CREATE SCHEMA auth; -- users, tenants, roles, permissions +CREATE SCHEMA core; -- partners, products, categories +CREATE SCHEMA inventory; -- stock, locations, movements + +-- 2. VERTICALES (dependen de auth.*, core.*) +CREATE SCHEMA construccion; -- projects, budgets, hr, hse, estimates +CREATE SCHEMA mecanicas; -- service_management, parts, vehicles +CREATE SCHEMA retail; -- pos, sales, ecommerce +CREATE SCHEMA clinicas; -- patients, appointments, medical +CREATE SCHEMA vidrio; -- quotes, production, installation +``` + +### 3.2 Dependencias de Schemas por Vertical + +| Vertical | Schemas Propios | Depende de | +|----------|----------------|------------| +| **erp-core** | auth, core, inventory | - (base) | +| **construccion** | construccion.* | auth.tenants, auth.users, core.partners | +| **mecanicas-diesel** | service_mgmt, parts_mgmt, vehicle_mgmt | auth.tenants, auth.users | +| **retail** | retail.* | auth.*, core.products, inventory.* | +| **clinicas** | clinicas.* | auth.*, core.partners | +| **vidrio** | vidrio.* | auth.*, core.*, inventory.* | + +### 3.3 Row-Level Security (RLS) + +Todas las tablas implementan multi-tenancy via RLS: + +```sql +-- Política estándar por tenant +ALTER TABLE construccion.projects ENABLE ROW LEVEL SECURITY; +CREATE POLICY tenant_isolation ON construccion.projects + USING (tenant_id = current_setting('app.current_tenant')::uuid); +``` + +--- + +## 4. Estrategia de Despliegue + +### 4.1 Opción Recomendada: Despliegue Independiente por Vertical + +Cada vertical se despliega como un servicio independiente: + +```bash +# Estructura de despliegue +/opt/apps/erp-suite/ +├── erp-core/ +│ ├── docker-compose.yml +│ └── .env.production +├── construccion/ +│ ├── docker-compose.yml +│ └── .env.production +├── mecanicas-diesel/ +│ ├── docker-compose.yml +│ └── .env.production +└── shared/ + └── nginx/ +``` + +### 4.2 Pipeline de Despliegue + +``` +[Git Push] → [Jenkins] → [Build Images] → [Push Registry] → [Deploy] + │ + ├── erp-core → erp-core-backend:latest, erp-core-frontend:latest + ├── construccion → construccion-backend:latest, construccion-frontend:latest + ├── mecanicas → mecanicas-backend:latest, mecanicas-frontend:latest + └── ... +``` + +### 4.3 Orden de Despliegue + +**IMPORTANTE:** Respetar el orden de despliegue: + +1. **PostgreSQL** (si no existe) +2. **Redis** (si no existe) +3. **ERP-Core** (siempre primero - carga schemas base) +4. **Verticales** (en cualquier orden después de core) + +--- + +## 5. Variables de Entorno por Vertical + +### 5.1 Variables Comunes + +```bash +# Todas las verticales comparten: +NODE_ENV=production +DB_HOST=localhost +DB_PORT=5432 +DB_SSL=true +REDIS_HOST=localhost +JWT_SECRET=${JWT_SECRET} # Compartido para SSO +``` + +### 5.2 Variables Específicas por Vertical + +| Variable | erp-core | construccion | mecanicas | retail | +|----------|----------|--------------|-----------|--------| +| PORT | 3011 | 3021 | 3041 | 3051 | +| DB_NAME | erp_generic | erp_generic | erp_generic | erp_generic | +| DB_SCHEMA | auth,core | construccion | mecanicas | retail | +| FRONTEND_URL | erp.isem.dev | construccion.erp.isem.dev | mecanicas.erp.isem.dev | retail.erp.isem.dev | +| REDIS_DB | 0 | 1 | 2 | 3 | + +--- + +## 6. Docker Images + +### 6.1 Naming Convention + +``` +${REGISTRY}/${PROJECT}-${COMPONENT}:${VERSION} + +Ejemplos: +- 72.60.226.4:5000/erp-core-backend:1.0.0 +- 72.60.226.4:5000/erp-core-frontend:1.0.0 +- 72.60.226.4:5000/construccion-backend:1.0.0 +- 72.60.226.4:5000/construccion-frontend:1.0.0 +``` + +### 6.2 Base Images + +| Componente | Base Image | Tamaño Aprox | +|------------|------------|--------------| +| Backend | node:20-alpine | ~150MB | +| Frontend | nginx:alpine | ~25MB | + +--- + +## 7. Health Checks + +### 7.1 Endpoints por Vertical + +| Vertical | Health Endpoint | Expected Response | +|----------|-----------------|-------------------| +| erp-core | /health | `{"status":"ok","db":true,"redis":true}` | +| construccion | /health | `{"status":"ok","db":true}` | +| mecanicas | /health | `{"status":"ok","db":true}` | + +### 7.2 Script de Verificación + +```bash +#!/bin/bash +VERTICALS=("erp-core:3011" "construccion:3021" "mecanicas:3041") + +for v in "${VERTICALS[@]}"; do + name="${v%%:*}" + port="${v##*:}" + status=$(curl -s "http://localhost:${port}/health" | jq -r '.status') + echo "${name}: ${status}" +done +``` + +--- + +## 8. Comandos de Despliegue + +### 8.1 Despliegue Individual + +```bash +# ERP-Core +cd /opt/apps/erp-suite/erp-core +docker-compose pull && docker-compose up -d + +# Construcción +cd /opt/apps/erp-suite/construccion +docker-compose pull && docker-compose up -d +``` + +### 8.2 Despliegue Completo + +```bash +# Desde Jenkins o script +./scripts/deploy-all.sh production + +# O manualmente +cd /opt/apps/erp-suite +docker-compose -f docker-compose.full.yml up -d +``` + +### 8.3 Rollback + +```bash +# Rollback específico +cd /opt/apps/erp-suite/construccion +docker-compose down +docker-compose pull --tag previous +docker-compose up -d +``` + +--- + +## 9. Monitoreo + +### 9.1 Logs + +```bash +# Ver logs de un vertical +docker logs -f construccion-backend + +# Logs centralizados (si configurado) +tail -f /var/log/erp-suite/construccion/app.log +``` + +### 9.2 Métricas Clave + +| Métrica | Descripción | Alerta | +|---------|-------------|--------| +| Response Time | Tiempo de respuesta API | > 2s | +| Error Rate | % de requests con error | > 5% | +| DB Connections | Conexiones activas | > 80% pool | +| Memory Usage | Uso de memoria | > 80% | + +--- + +## 10. Troubleshooting + +### 10.1 Problemas Comunes + +| Problema | Causa | Solución | +|----------|-------|----------| +| Connection refused | Servicio no iniciado | `docker-compose up -d` | +| Schema not found | DDL no cargado | Ejecutar migrations de erp-core primero | +| Auth failed | JWT secret diferente | Verificar JWT_SECRET compartido | +| Tenant not found | RLS mal configurado | Verificar `SET app.current_tenant` | + +### 10.2 Verificar Estado + +```bash +# Estado de contenedores +docker ps --filter "name=erp" + +# Verificar conectividad BD +docker exec erp-core-backend npm run db:check + +# Verificar schemas +psql -h localhost -U erp_admin -d erp_generic -c "\dn" +``` + +--- + +## Referencias + +- **Inventario de Puertos:** `core/orchestration/inventarios/DEVENV-PORTS-INVENTORY.yml` +- **Herencia ERP-Core:** `apps/verticales/*/database/HERENCIA-ERP-CORE.md` +- **Arquitectura General:** `core/orchestration/deployment/DEPLOYMENT-ARCHITECTURE.md` diff --git a/INVENTARIO.yml b/INVENTARIO.yml new file mode 100644 index 0000000..afeb28a --- /dev/null +++ b/INVENTARIO.yml @@ -0,0 +1,36 @@ +# Inventario generado por EPIC-008 +proyecto: erp-suite +fecha: "2026-01-04" +generado_por: "inventory-project.sh v1.0.0" + +inventario: + docs: + total: 18 + por_tipo: + markdown: 18 + yaml: 0 + json: 0 + orchestration: + total: 15 + por_tipo: + markdown: 9 + yaml: 5 + json: 1 + +problemas: + archivos_obsoletos: 3 + referencias_antiguas: 0 + simco_faltantes: + - _MAP.md en docs/ + - PROJECT-STATUS.md + +estado_simco: + herencia_simco: true + contexto_proyecto: true + map_docs: false + project_status: false + +archivos_obsoletos_lista: + - "/home/isem/workspace-v1/projects/erp-suite/docs/00-overview/WORKSPACE-OVERVIEW-LEGACY.md" + - "/home/isem/workspace-v1/projects/erp-suite/docs/00-overview/README-LEGACY.md" + - "/home/isem/workspace-v1/projects/erp-suite/docs/00-overview/PROPUESTA-REESTRUCTURACION-MULTI-PROYECTO-LEGACY.md" diff --git a/PURGE-LOG.yml b/PURGE-LOG.yml new file mode 100644 index 0000000..b3a56a8 --- /dev/null +++ b/PURGE-LOG.yml @@ -0,0 +1,17 @@ +# Log de purga generado por EPIC-008 +proyecto: erp-suite +fecha: "2026-01-04" +modo: "execute" +archivos_eliminados: + - archivo: "docs/00-overview/WORKSPACE-OVERVIEW-LEGACY.md" + tamano: "20K" + eliminado: true + - archivo: "docs/00-overview/README-LEGACY.md" + tamano: "16K" + eliminado: true + - archivo: "docs/00-overview/PROPUESTA-REESTRUCTURACION-MULTI-PROYECTO-LEGACY.md" + tamano: "32K" + eliminado: true + +total_eliminados: 3 +estado: "completado" diff --git a/README.md b/README.md new file mode 100644 index 0000000..51e679a --- /dev/null +++ b/README.md @@ -0,0 +1,276 @@ +# ERP Suite - Sistema ERP Multi-Vertical + +## Descripción + +Suite ERP/CRM/POS con soporte para múltiples verticales de negocio, diseñado para SaaS simple autocontratado y proyectos integrales personalizados. + +**Estado General:** En desarrollo activo +**Migrado desde:** workspace-erp-inmobiliaria (Diciembre 2025) + +## Verticales Soportados + +| Vertical | Estado | Descripción | +|----------|--------|-------------| +| **ERP Core** | 60% | Base genérica reutilizable (autenticación, usuarios, catálogos) | +| **Construcción** | 35% | Gestión de proyectos de construcción, INFONAVIT, presupuestos | +| **Vidrio Templado** | 0% | Producción, calidad, trazabilidad de lotes | +| **Mecánicas Diesel** | 0% | Talleres, diagnósticos, reparaciones, refacciones | +| **Retail** | 0% | Punto de venta, inventario | +| **Clínicas** | 0% | Gestión de pacientes, citas | + +## Stack Tecnológico + +| Capa | Tecnología | +|------|------------| +| **Backend** | Node.js 20+, Express.js, TypeScript 5.3+, TypeORM | +| **Frontend Web** | React 18, Vite, TypeScript, Tailwind CSS | +| **Frontend Mobile** | React Native | +| **Base de Datos** | PostgreSQL 15+ con RLS (Row-Level Security) | +| **Autenticación** | JWT, bcryptjs | +| **Validación** | Zod, class-validator | + +## Estructura del Proyecto (Autocontenida por Proyecto) + +**Cada proyecto (erp-core y cada vertical) es autocontenido** con su propia documentación y sistema de orquestación para trazabilidad completa. + +``` +erp-suite/ +├── apps/ +│ ├── erp-core/ # ERP Base (60-70% compartido) +│ │ ├── backend/ # Node.js + Express + TypeScript +│ │ ├── frontend/ # React + Vite + Tailwind +│ │ ├── database/ # PostgreSQL DDL, migrations, seeds +│ │ ├── docs/ # Documentación PROPIA del core +│ │ └── orchestration/ # Sistema de agentes PROPIO +│ │ ├── 00-guidelines/CONTEXTO-PROYECTO.md +│ │ ├── trazas/ # Historial de tareas por agente +│ │ ├── estados/ # Estado de agentes +│ │ └── PROXIMA-ACCION.md +│ │ +│ ├── verticales/ +│ │ ├── construccion/ # Vertical INFONAVIT (35%) +│ │ │ ├── backend/ +│ │ │ ├── frontend/ +│ │ │ ├── database/ +│ │ │ ├── docs/ # 403+ docs migrados (5.9 MB) +│ │ │ │ ├── 01-fase-alcance-inicial/ # 15 módulos MAI-* +│ │ │ │ ├── 02-fase-enterprise/ # 3 épicas MAE-* +│ │ │ │ └── 02-modelado/ # Schemas SQL +│ │ │ └── orchestration/ # Sistema de agentes PROPIO +│ │ │ ├── 00-guidelines/CONTEXTO-PROYECTO.md +│ │ │ ├── trazas/ +│ │ │ ├── estados/ +│ │ │ └── PROXIMA-ACCION.md +│ │ │ +│ │ ├── vidrio-templado/ # Vertical (0%) +│ │ │ ├── docs/ +│ │ │ └── orchestration/ +│ │ │ +│ │ ├── mecanicas-diesel/ # Vertical (0%) +│ │ │ ├── docs/ +│ │ │ └── orchestration/ +│ │ │ +│ │ ├── retail/ # Vertical Punto de Venta +│ │ └── clinicas/ # Vertical Clínicas +│ │ +│ ├── saas/ # Capa SaaS (billing) +│ └── shared-libs/ # Librerías compartidas +│ +├── docs/ # Documentación GENERAL del suite +│ ├── 00-overview/ # Visión general, arquitectura +│ ├── 01-requerimientos/ # Requerimientos transversales +│ └── ... +│ +└── orchestration/ # Orquestación GENERAL del suite + ├── 00-guidelines/ + └── legacy-reference/ # Sistema migrado (referencia) +``` + +### Estructura de Cada Proyecto (Patrón Autocontenido) + +Cada proyecto sigue esta estructura estándar: + +``` +{proyecto}/ +├── backend/ # Código backend +├── frontend/ # Código frontend +├── database/ # DDL, migrations, seeds +├── docs/ # Documentación PROPIA +│ ├── 00-vision-general/ +│ ├── 01-fase-mvp/ +│ ├── 02-modelado/ +│ └── 90-transversal/ +└── orchestration/ # Sistema de agentes PROPIO + ├── 00-guidelines/ + │ └── CONTEXTO-PROYECTO.md # Contexto específico + ├── trazas/ # Historial por agente + │ ├── TRAZA-TAREAS-BACKEND.md + │ ├── TRAZA-TAREAS-FRONTEND.md + │ └── TRAZA-TAREAS-DATABASE.md + ├── estados/ + │ └── ESTADO-AGENTES.json + └── PROXIMA-ACCION.md # Siguiente tarea +``` + +## Módulos ERP Construcción (Migrados) + +### Fase 1: Alcance Inicial (15 módulos) +| Código | Módulo | Descripción | +|--------|--------|-------------| +| MAI-001 | Fundamentos | Autenticación, usuarios, roles, permisos | +| MAI-002 | Proyectos | Gestión de proyectos y estructura | +| MAI-003 | Presupuestos | Presupuestos y control de costos | +| MAI-004 | Compras | Compras e inventarios | +| MAI-005 | Control de Obra | Avances y recursos | +| MAI-006 | Reportes | Analytics y reportería | +| MAI-007 | RRHH | Recursos humanos y asistencias | +| MAI-008 | Estimaciones | Estimaciones y facturación | +| MAI-009 | Calidad | Calidad y postventa | +| MAI-010 | CRM | CRM Derechohabientes | +| MAI-011 | INFONAVIT | Integración INFONAVIT | +| MAI-012 | Contratos | Contratos y subcontratos | +| MAI-013 | Administración | Seguridad y administración | +| MAI-018 | Preconstrucción | Licitaciones | + +### Fase 2: Enterprise (3 épicas - 210 SP) +| Código | Épica | Story Points | +|--------|-------|--------------| +| MAE-014 | Finanzas y Controlling de Obra | 80 SP | +| MAE-015 | Activos, Maquinaria y Mantenimiento | 70 SP | +| MAE-016 | Gestión Documental (DMS) | 60 SP | + +### Fase 3: Avanzada +| Código | Épica | +|--------|-------| +| MAA-017 | Seguridad HSE (Health, Safety & Environment) | + +## Arquitectura + +### Modelo de Reutilización +- **erp-core:** 60-70% del código base compartido +- **verticales:** Extensiones específicas por giro de negocio +- **saas:** Capa de autocontratación y billing multi-tenant + +### Schemas de Base de Datos (PostgreSQL) +| Schema | Descripción | +|--------|-------------| +| `auth_management` | Autenticación, usuarios, roles, permisos | +| `project_management` | Proyectos, desarrollos, fases, viviendas | +| `financial_management` | Presupuestos, estimaciones, costos | +| `purchasing_management` | Compras, proveedores, inventarios | +| `construction_management` | Avances, recursos, materiales | +| `quality_management` | Inspecciones, pruebas, no conformidades | +| `infonavit_management` | Integración INFONAVIT | + +### Orden de Desarrollo Recomendado +1. **Fase 1:** ERP Genérico (erp-core) - Base compartida +2. **Fase 2:** ERP Construcción (vertical) - Más avanzado +3. **Fase 3:** ERP Vidrio Templado (vertical) +4. **Fase 4:** Demás verticales según demanda + +## Patrones de Referencia + +Los patrones de diseno estan basados en Odoo: +- `knowledge-base/patterns/PATRON-CORE-ODOO.md` +- `knowledge-base/patterns/PATRON-INVENTARIO-ODOO.md` +- `knowledge-base/patterns/PATRON-CONTABILIDAD-ODOO.md` + +## Directivas y Documentacion + +### Principio Fundamental +> **"Primero documentar, despues desarrollar"** + +Toda la documentacion debe existir ANTES de iniciar cualquier desarrollo. + +### Directivas ERP Core + +| Directiva | Proposito | +|-----------|-----------| +| `DIRECTIVA-DOCUMENTACION-PRE-DESARROLLO.md` | Documentar antes de desarrollar | +| `DIRECTIVA-PATRONES-ODOO.md` | Patrones de diseno basados en Odoo | +| `DIRECTIVA-HERENCIA-MODULOS.md` | Como las verticales extienden el core | +| `DIRECTIVA-MULTI-TENANT.md` | Aislamiento por tenant_id | +| `DIRECTIVA-EXTENSION-VERTICALES.md` | Arquitectura de extensiones | +| `ESTANDARES-API-REST-GENERICO.md` | APIs REST consistentes | + +Ubicacion: `apps/erp-core/orchestration/directivas/` + +### Herencia de Directivas + +``` +CORE (Global) → /home/isem/workspace/core/orchestration/directivas/ + ↓ hereda +ERP-CORE → apps/erp-core/orchestration/directivas/ + ↓ hereda +VERTICALES → apps/verticales/{vertical}/orchestration/directivas/ +``` + +### Estructura de Documentacion + +Ver: `docs/ESTRUCTURA-DOCUMENTACION-ERP.md` + +``` +docs/ +├── 00-vision-general/ # Vision y arquitectura +├── 01-requerimientos/ # RF y RNF por modulo +├── 02-modelado/ # ERD, DDL, especificaciones +├── 03-user-stories/ # Historias por modulo +├── 04-test-plans/ # Planes de prueba +└── 90-transversal/ # Seguridad, multi-tenancy +``` + +## Inicio Rápido + +```bash +# === ERP CORE === +# Ver contexto del proyecto +cat apps/erp-core/orchestration/00-guidelines/CONTEXTO-PROYECTO.md + +# Ver siguiente tarea +cat apps/erp-core/orchestration/PROXIMA-ACCION.md + +# Instalar dependencias +cd apps/erp-core/backend && npm install +cd apps/erp-core/frontend && npm install + +# === VERTICAL CONSTRUCCIÓN === +# Ver contexto del proyecto +cat apps/verticales/construccion/orchestration/00-guidelines/CONTEXTO-PROYECTO.md + +# Ver siguiente tarea +cat apps/verticales/construccion/orchestration/PROXIMA-ACCION.md + +# Ver documentación (403+ archivos) +ls apps/verticales/construccion/docs/ + +# Ver módulos de Fase 1 +ls apps/verticales/construccion/docs/01-fase-alcance-inicial/ + +# === TRAZAS DE AGENTES === +# Ver historial de tareas por agente +cat apps/erp-core/orchestration/trazas/TRAZA-TAREAS-BACKEND.md +cat apps/verticales/construccion/orchestration/trazas/TRAZA-TAREAS-BACKEND.md + +# Ver estado de agentes +cat apps/erp-core/orchestration/estados/ESTADO-AGENTES.json +``` + +## Migración Completada + +Este proyecto incluye código y documentación migrada desde: +- `[RUTA-LEGACY-ELIMINADA]/` + +### Contenido Migrado +- **403 archivos Markdown** de documentación técnica +- **11 archivos SQL** (DDL, RLS policies) +- **Código fuente** de backend, frontend y database +- **Sistema de orquestación** legacy (referencia) + +### Verticales Migradas +- `erp-construccion` → `apps/verticales/construccion/` +- `erp-generic` → `apps/erp-core/` +- `erp-vidrio-templado` → `apps/verticales/vidrio-templado/` +- `erp-mecanicas-diesel` → `apps/verticales/mecanicas-diesel/` + +--- +*Proyecto parte del workspace de Fábrica de Software con Agentes IA - Sistema NEXUS* diff --git a/apps/products/erp-basico/README.md b/apps/products/erp-basico/README.md new file mode 100644 index 0000000..c235527 --- /dev/null +++ b/apps/products/erp-basico/README.md @@ -0,0 +1,191 @@ +# ERP Básico SaaS - Solución Integral Austera + +## Descripción + +Sistema ERP completo pero austero, diseñado para PyMEs que necesitan funcionalidad integral sin la complejidad ni el costo de soluciones enterprise. + +## Target de Mercado + +- PyMEs con 5-50 empleados +- Negocios que necesitan más que un POS +- Empresas que buscan digitalización económica +- Comercios con operaciones de compra-venta +- Pequeñas manufacturas + +## Precio + +**~300-500 MXN/mes** (según módulos activos) + +## Plan Base (300 MXN/mes) + +| Módulo | Incluido | Descripción | +|--------|----------|-------------| +| Autenticación | Obligatorio | Login, 2FA, roles básicos | +| Usuarios | Obligatorio | Hasta 5 usuarios | +| Multi-tenant | Obligatorio | Aislamiento por empresa | +| Catálogos | Incluido | Productos, categorías, unidades | +| Inventario | Incluido | Stock, movimientos, alertas | +| Ventas | Incluido | Cotizaciones, pedidos, facturas | +| Compras | Incluido | Órdenes de compra, proveedores | +| Clientes | Incluido | CRM básico, contactos | +| Reportes | Incluido | Dashboard, reportes esenciales | + +## Módulos Opcionales + +| Módulo | Precio | Descripción | +|--------|--------|-------------| +| Contabilidad | +150 MXN/mes | Pólizas, balances, estados financieros | +| RRHH | +100 MXN/mes | Empleados, nómina básica, asistencia | +| Facturación CFDI | +100 MXN/mes | Timbrado SAT México | +| Usuarios extra | +50 MXN/usuario | Más de 5 usuarios | +| WhatsApp Bot | Por consumo | Consultas y notificaciones | +| Soporte Premium | +200 MXN/mes | Atención prioritaria | + +## Stack Tecnológico + +- **Backend:** Node.js + Express/NestJS + TypeScript +- **Frontend:** React 18 + Vite + Tailwind CSS +- **Database:** PostgreSQL 15+ con RLS +- **Cache:** Redis (compartido) +- **Auth:** JWT + bcrypt + +## Arquitectura + +``` +erp-basico/ +├── backend/ +│ ├── src/ +│ │ ├── modules/ +│ │ │ ├── auth/ # Autenticación +│ │ │ ├── users/ # Gestión usuarios +│ │ │ ├── companies/ # Multi-tenant +│ │ │ ├── catalogs/ # Catálogos maestros +│ │ │ ├── inventory/ # Inventario +│ │ │ ├── sales/ # Ventas +│ │ │ ├── purchases/ # Compras +│ │ │ ├── partners/ # Clientes/Proveedores +│ │ │ └── reports/ # Reportes +│ │ └── shared/ +│ │ ├── guards/ +│ │ ├── decorators/ +│ │ └── utils/ +├── frontend/ +│ ├── src/ +│ │ ├── features/ # Por módulo +│ │ ├── shared/ # Componentes base +│ │ └── app/ # Layout, routing +├── database/ +│ └── ddl/ +│ ├── 00-extensions.sql +│ ├── 01-schemas.sql +│ ├── 02-core-tables.sql +│ └── 03-business-tables.sql +└── orchestration/ +``` + +## Base de Datos (~40 tablas) + +### Schema: `auth` +- users, roles, permissions, sessions, tokens + +### Schema: `core` +- companies, settings, sequences, audit_logs + +### Schema: `catalog` +- products, categories, units, taxes, payment_methods + +### Schema: `inventory` +- warehouses, stock_moves, stock_quants, adjustments + +### Schema: `sales` +- quotations, sale_orders, invoices, payments + +### Schema: `purchases` +- purchase_orders, supplier_invoices, receipts + +### Schema: `partners` +- partners, contacts, addresses + +### Schema: `reports` +- report_configs, saved_reports + +## Diferenciación vs POS Micro + +| Aspecto | POS Micro | ERP Básico | +|---------|-----------|------------| +| Precio | 100 MXN | 300-500 MXN | +| Tablas BD | ~10 | ~40 | +| Módulos | 4 | 10+ | +| Usuarios | 1 | 5+ | +| Compras | No | Sí | +| Inventario | Básico | Completo | +| Reportes | Mínimos | Dashboard | +| Facturación | No | Opcional | +| Contabilidad | No | Opcional | + +## Herencia del Core + +Este producto hereda **directamente** de `erp-core`: + +| Componente | % Herencia | Adaptación | +|------------|------------|------------| +| Auth | 100% | Ninguna | +| Users | 100% | Ninguna | +| Multi-tenant | 100% | Ninguna | +| Catálogos | 80% | Simplificado | +| Inventario | 70% | Sin lotes/series | +| Ventas | 70% | Sin workflows complejos | +| Compras | 70% | Sin aprobaciones | +| Partners | 90% | Ninguna | +| Reportes | 50% | Subset de reportes | + +## Feature Flags + +```yaml +# Configuración por tenant +features: + accounting: false # +150 MXN + hr: false # +100 MXN + cfdi: false # +100 MXN + whatsapp_bot: false # Por consumo + advanced_reports: false + multi_warehouse: false + serial_numbers: false + lot_tracking: false +``` + +## Limitaciones (Por diseño) + +- Máximo 10,000 productos +- Máximo 5 usuarios en plan base +- Sin multi-sucursal en plan base +- Sin contabilidad avanzada (solo opcional) +- Sin manufactura +- Sin proyectos +- Sin e-commerce integrado + +## Roadmap + +### MVP (v1.0) +- [x] Auth completo (heredado de core) +- [ ] Catálogos básicos +- [ ] Inventario simple +- [ ] Ventas (cotización → pedido → factura) +- [ ] Compras básicas +- [ ] Dashboard inicial + +### v1.1 +- [ ] Módulo contabilidad (opcional) +- [ ] CFDI México (opcional) +- [ ] Reportes adicionales + +### v1.2 +- [ ] RRHH básico (opcional) +- [ ] Multi-almacén +- [ ] Integraciones bancarias + +--- + +*Producto: ERP Básico SaaS v1.0* +*Precio Target: 300-500 MXN/mes* +*Mercado: PyMEs México* diff --git a/apps/products/erp-basico/orchestration/00-guidelines/CONTEXTO-PROYECTO.md b/apps/products/erp-basico/orchestration/00-guidelines/CONTEXTO-PROYECTO.md new file mode 100644 index 0000000..1f30589 --- /dev/null +++ b/apps/products/erp-basico/orchestration/00-guidelines/CONTEXTO-PROYECTO.md @@ -0,0 +1,238 @@ +# Contexto del Proyecto: ERP Básico SaaS + +## Identificación + +| Campo | Valor | +|-------|-------| +| **Nombre** | ERP Básico SaaS | +| **Tipo** | Producto SaaS | +| **Nivel** | 2B.2 (Producto dentro de Suite) | +| **Suite Padre** | erp-suite | +| **Ruta Base** | `projects/erp-suite/apps/products/erp-basico/` | +| **Estado** | En Planificación | + +## Descripción + +ERP completo pero austero para PyMEs. Hereda directamente de erp-core con configuración simplificada y precios accesibles. + +## Target de Mercado + +- PyMEs con 5-50 empleados +- Comercios con operaciones compra-venta +- Pequeñas manufacturas +- Distribuidores +- Empresas en proceso de digitalización + +## Propuesta de Valor + +1. **ERP completo** - No solo POS, gestión integral +2. **Precio accesible** - 300-500 MXN/mes vs 2,000+ de SAP/Odoo +3. **Sin complejidad** - Configuración mínima +4. **Modular** - Paga solo lo que usas +5. **Mexicanizado** - CFDI, bancos mexicanos + +## Stack Tecnológico + +```yaml +backend: + runtime: Node.js 20+ + framework: NestJS (heredado de core) + language: TypeScript 5.3+ + orm: TypeORM + validation: class-validator + +frontend: + framework: React 18 + bundler: Vite + styling: Tailwind CSS + state: Zustand + forms: React Hook Form + +database: + engine: PostgreSQL 15+ + multi_tenant: true (RLS) + schemas: 8 + tables: ~40 + +cache: + engine: Redis + usage: Sessions, rate-limiting +``` + +## Variables del Proyecto + +```yaml +# Identificadores +PROJECT_NAME: erp-basico +PROJECT_CODE: ERPB +SUITE: erp-suite + +# Database +DB_NAME: erp_suite_db # Compartida +SCHEMAS: + - auth + - core + - catalog + - inventory + - sales + - purchases + - partners + - reports + +# Paths +BACKEND_ROOT: apps/products/erp-basico/backend +FRONTEND_ROOT: apps/products/erp-basico/frontend +DATABASE_ROOT: apps/products/erp-basico/database + +# Business +BASE_PRICE_MXN: 300 +MAX_USERS_BASE: 5 +MAX_PRODUCTS: 10000 +``` + +## Herencia del Core + +### Módulos Heredados (100%) + +| Módulo Core | Uso en ERP Básico | +|-------------|-------------------| +| MGN-001 Auth | Completo | +| MGN-002 Users | Completo | +| MGN-003 Roles | Simplificado (3 roles) | +| MGN-004 Tenants | Completo | +| MGN-005 Catalogs | 80% (sin variantes) | +| MGN-008 Notifications | Simplificado | + +### Módulos Adaptados + +| Módulo Core | Adaptación | +|-------------|------------| +| MGN-007 Audit | Solo logs críticos | +| MGN-009 Reports | Subset de reportes | +| Inventory | Sin lotes/series | +| Sales | Sin workflows aprobación | +| Purchases | Sin aprobaciones multi-nivel | + +### Módulos NO Incluidos + +| Módulo Core | Razón | +|-------------|-------| +| MGN-010 Financial | Opcional (+150 MXN) | +| Projects | Complejidad innecesaria | +| Manufacturing | Fuera de scope | +| Advanced HR | Opcional (+100 MXN) | + +## Módulos del Producto + +### Obligatorios (Plan Base) + +| Módulo | Tablas | Endpoints | Componentes | +|--------|--------|-----------|-------------| +| auth | 5 | 8 | 4 | +| users | 2 | 6 | 3 | +| companies | 3 | 5 | 2 | +| catalogs | 5 | 12 | 6 | +| inventory | 4 | 10 | 5 | +| sales | 4 | 12 | 6 | +| purchases | 3 | 8 | 4 | +| partners | 3 | 8 | 4 | +| reports | 2 | 6 | 3 | + +### Opcionales (Feature Flags) + +| Módulo | Precio | Tablas Extra | +|--------|--------|--------------| +| accounting | +150 MXN | 8 | +| hr | +100 MXN | 6 | +| cfdi | +100 MXN | 3 | + +## Feature Flags + +```typescript +interface TenantFeatures { + // Plan base + base_erp: true; + max_users: 5; + max_products: 10000; + + // Opcionales + accounting: boolean; // +150 MXN + hr: boolean; // +100 MXN + cfdi: boolean; // +100 MXN + extra_users: number; // +50 MXN c/u + multi_warehouse: boolean; // +100 MXN + whatsapp_bot: boolean; // Por consumo + advanced_reports: boolean;// +50 MXN +} +``` + +## Diferenciación + +### vs POS Micro + +| Aspecto | POS Micro | ERP Básico | +|---------|-----------|------------| +| Complejidad | Mínima | Media | +| Módulos | 4 | 10+ | +| Usuarios | 1 | 5+ | +| Compras | No | Sí | +| Multi-almacén | No | Opcional | +| Contabilidad | No | Opcional | +| Precio | 100 MXN | 300+ MXN | + +### vs ERP Enterprise (Verticales) + +| Aspecto | ERP Básico | Verticales | +|---------|------------|------------| +| Industria | General | Especializado | +| Complejidad | Media | Alta | +| Customización | Baja | Alta | +| Workflows | Simples | Complejos | +| Precio | 300-500 MXN | 1,000+ MXN | + +## Métricas de Éxito + +| Métrica | Target | +|---------|--------| +| Tiempo de onboarding | < 30 minutos | +| Usuarios activos diarios | > 60% | +| NPS | > 40 | +| Churn mensual | < 3% | +| Tickets soporte/usuario | < 0.5/mes | + +## Roadmap + +### MVP (v1.0) +- [ ] Herencia completa de auth/users/tenants +- [ ] Catálogos (productos, categorías, unidades) +- [ ] Inventario básico (stock, movimientos) +- [ ] Ventas (cotización → pedido → factura) +- [ ] Compras básicas +- [ ] Dashboard inicial +- [ ] Billing/suscripciones + +### v1.1 +- [ ] Módulo contabilidad (opcional) +- [ ] CFDI México (opcional) +- [ ] Reportes financieros + +### v1.2 +- [ ] RRHH básico (opcional) +- [ ] Multi-almacén (opcional) +- [ ] Integraciones bancarias México + +### v2.0 +- [ ] App móvil +- [ ] Integraciones marketplace +- [ ] IA para predicciones + +## Documentos Relacionados + +- `../README.md` - Descripción general +- `../../erp-core/` - Core heredado +- `../../erp-core/docs/` - Documentación detallada de módulos +- `../../../orchestration/` - Orquestación suite level + +--- + +*Última actualización: 2025-12-08* diff --git a/apps/products/erp-basico/orchestration/00-guidelines/HERENCIA-SIMCO.md b/apps/products/erp-basico/orchestration/00-guidelines/HERENCIA-SIMCO.md new file mode 100644 index 0000000..4710ae8 --- /dev/null +++ b/apps/products/erp-basico/orchestration/00-guidelines/HERENCIA-SIMCO.md @@ -0,0 +1,116 @@ +# Herencia SIMCO - ERP Básico + +**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol +**Fecha:** 2025-12-08 + +--- + +## Configuración del Proyecto + +| Propiedad | Valor | +|-----------|-------| +| **Proyecto** | ERP Básico - Producto Simplificado | +| **Nivel** | PRODUCT (Nivel 2) | +| **Padre** | erp-suite | +| **SIMCO Version** | 2.2.0 | +| **CAPVED** | Habilitado | +| **CCA Protocol** | Habilitado | +| **Estado** | Por iniciar | + +## Jerarquía de Herencia + +``` +Nivel 0: core/orchestration/ ← FUENTE PRINCIPAL + │ + └── Nivel 1: erp-suite/orchestration/ ← PADRE + │ + └── Nivel 2: erp-basico/orchestration/ ← ESTE PROYECTO +``` + +**Nota:** ERP Básico es un PRODUCTO standalone dentro de la suite, NO hereda de erp-core. +Es una versión simplificada para pequeños negocios. + +--- + +## Directivas Heredadas de CORE (OBLIGATORIAS) + +### Ciclo de Vida +| Alias | Propósito | +|-------|-----------| +| `@TAREA` | Punto de entrada para toda HU | +| `@CAPVED` | Ciclo de 6 fases | +| `@INICIALIZACION` | Bootstrap de agentes | + +### Operaciones Universales +| Alias | Propósito | +|-------|-----------| +| `@CREAR` | Crear archivos nuevos | +| `@MODIFICAR` | Modificar existentes | +| `@VALIDAR` | Validar código | +| `@DOCUMENTAR` | Documentar trabajo | +| `@BUSCAR` | Buscar información | +| `@DELEGAR` | Delegar a subagentes | + +### Principios Fundamentales +| Alias | Resumen | +|-------|---------| +| `@CAPVED` | Toda tarea pasa por 6 fases | +| `@DOC_PRIMERO` | Consultar docs/ antes de implementar | +| `@ANTI_DUP` | Verificar que no existe | +| `@VALIDACION` | Build y lint DEBEN pasar | +| `@TOKENS` | Desglosar tareas grandes | + +--- + +## Directivas por Dominio Técnico + +| Alias | Aplica | Notas | +|-------|--------|-------| +| `@OP_DDL` | **SÍ** | Schema simplificado | +| `@OP_BACKEND` | **SÍ** | API mínima | +| `@OP_FRONTEND` | **SÍ** | UI simple | +| `@OP_MOBILE` | **SÍ** | App básica | +| `@OP_ML` | NO | - | + +--- + +## Patrones Heredados (OBLIGATORIOS) + +Todos los patrones de `core/orchestration/patrones/` aplican. + +--- + +## Variables de Contexto CCA + +```yaml +PROJECT_NAME: "erp-basico" +PROJECT_LEVEL: "PRODUCT" +PROJECT_ROOT: "./" +PARENT_PROJECT: "erp-suite" + +DB_DDL_PATH: "database/ddl" +BACKEND_ROOT: "backend/src" +FRONTEND_ROOT: "frontend/src" + +# Este producto NO usa multi-tenant complejo +TENANT_COLUMN: "empresa_id" +SIMPLIFIED: true +``` + +--- + +## Diferencias con ERP Core + +| Aspecto | ERP Core | ERP Básico | +|---------|----------|------------| +| Complejidad | Alta | Baja | +| Verticales | Múltiples | Ninguna | +| Multi-tenant | RLS completo | Simplificado | +| Módulos | 20+ | 5-7 | +| Target | Empresas medianas | Pequeños negocios | + +--- + +**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol +**Nivel:** PRODUCT (2) +**Última actualización:** 2025-12-08 diff --git a/apps/products/pos-micro/README.md b/apps/products/pos-micro/README.md new file mode 100644 index 0000000..8dfcf7b --- /dev/null +++ b/apps/products/pos-micro/README.md @@ -0,0 +1,139 @@ +# POS Micro - Punto de Venta Ultra Básico + +## Descripción + +Sistema de punto de venta minimalista diseñado para el mercado informal mexicano. Enfocado en simplicidad extrema, bajo costo y funcionalidad offline. + +## Target de Mercado + +- Puestos de calle y ambulantes +- Tiendas de abarrotes y misceláneas +- Puestos de comida (tacos, tortas, etc.) +- Pequeños locales comerciales +- Vendedores independientes + +## Precio + +**~100 MXN/mes** + consumo de IA (opcional) + +## Características + +### Incluidas en Plan Base (100 MXN/mes) + +| Característica | Descripción | +|----------------|-------------| +| Punto de Venta | Registrar ventas, calcular cambio | +| Catálogo | Lista de productos con precios | +| Inventario Básico | Control de stock simple | +| Corte de Caja | Resumen diario | +| Reportes | Ventas día/semana/mes | +| PWA Offline | Funciona sin internet | +| 1 Usuario | Operador principal | + +### Opcionales (Por Consumo) + +| Característica | Costo | +|----------------|-------| +| WhatsApp Bot | ~0.02 USD por consulta | +| Usuario adicional | +30 MXN/mes | +| Soporte prioritario | +50 MXN/mes | + +## Stack Tecnológico + +- **Backend:** Node.js + Express + TypeScript +- **Frontend:** React + PWA + Tailwind CSS +- **Database:** PostgreSQL (compartida multi-tenant) +- **WhatsApp:** WhatsApp Business API +- **IA:** Claude API (para bot) + +## Arquitectura + +``` +pos-micro/ +├── backend/ # API mínima +├── frontend/ # SPA React +├── pwa/ # Service Worker + Offline +├── database/ # ~10 tablas +├── whatsapp/ # Integración WA Business +├── docs/ # Documentación +└── orchestration/ # Sistema NEXUS +``` + +## Base de Datos (~10 tablas) + +1. `tenants` - Empresas/negocios +2. `users` - Usuarios del sistema +3. `products` - Catálogo de productos +4. `sales` - Ventas registradas +5. `sale_items` - Detalle de ventas +6. `inventory_movements` - Movimientos de inventario +7. `daily_closures` - Cortes de caja +8. `whatsapp_sessions` - Sesiones WA +9. `ai_usage` - Consumo de tokens IA +10. `subscriptions` - Suscripciones y pagos + +## Flujo de Usuario + +### Registro +1. Usuario accede a landing page +2. Ingresa número de WhatsApp +3. Recibe código de verificación +4. Configura nombre del negocio +5. Agrega primeros productos +6. Listo para vender + +### Venta Típica +1. Abrir PWA (funciona offline) +2. Seleccionar productos +3. Ver total automático +4. Registrar pago (efectivo/tarjeta) +5. Calcular cambio +6. Venta registrada + +### Consulta por WhatsApp +``` +Usuario: "ventas de hoy" +Bot: "Ventas hoy: $1,250 MXN (15 tickets) + Producto más vendido: Coca Cola 600ml (23 unidades)" + +Usuario: "stock de sabritas" +Bot: "Sabritas Original: 12 unidades + Sabritas Adobadas: 8 unidades + Sabritas Limón: 15 unidades" +``` + +## Principios de Diseño + +1. **Simplicidad extrema** - Máximo 3 clicks para cualquier acción +2. **Mobile-first** - Diseñado para celulares +3. **Offline-first** - Funciona sin internet +4. **Bajo costo** - Infraestructura mínima +5. **Sin fricción** - Onboarding en 5 minutos + +## Limitaciones (Por diseño) + +- Máximo 500 productos +- Máximo 1,000 ventas/mes en plan base +- Sin facturación electrónica (CFDI) +- Sin contabilidad +- Sin multi-sucursal +- Sin CRM avanzado + +## Herencia del Core + +Este producto hereda de `erp-core`: +- Sistema de autenticación básico +- Multi-tenancy (RLS) +- Estructura de proyectos + +NO hereda (por simplicidad): +- Módulos financieros +- RRHH +- CRM completo +- Reportes avanzados + +--- + +*Producto: POS Micro v1.0* +*Precio Target: 100 MXN/mes* +*Mercado: Informal mexicano* diff --git a/apps/products/pos-micro/backend/.env.example b/apps/products/pos-micro/backend/.env.example new file mode 100644 index 0000000..9a874b6 --- /dev/null +++ b/apps/products/pos-micro/backend/.env.example @@ -0,0 +1,38 @@ +# ============================================================================= +# POS MICRO - ENVIRONMENT CONFIGURATION +# ============================================================================= + +# Application +NODE_ENV=development +PORT=3071 +API_PREFIX=api/v1 + +# Database +DB_HOST=localhost +DB_PORT=5432 +DB_USERNAME=pos_micro +DB_PASSWORD=pos_micro_secret +DB_DATABASE=pos_micro_db +DB_SCHEMA=pos_micro +DB_SSL=false + +# JWT +JWT_SECRET=your-super-secret-jwt-key-change-in-production +JWT_EXPIRES_IN=24h +JWT_REFRESH_EXPIRES_IN=7d + +# Rate Limiting +THROTTLE_TTL=60 +THROTTLE_LIMIT=100 + +# WhatsApp Business API (optional) +WHATSAPP_API_URL=https://graph.facebook.com/v18.0 +WHATSAPP_TOKEN=your-whatsapp-token +WHATSAPP_PHONE_NUMBER_ID=your-phone-number-id +WHATSAPP_VERIFY_TOKEN=your-verify-token + +# Logging +LOG_LEVEL=debug + +# CORS +CORS_ORIGIN=http://localhost:5173 diff --git a/apps/products/pos-micro/backend/Dockerfile b/apps/products/pos-micro/backend/Dockerfile new file mode 100644 index 0000000..a5043ad --- /dev/null +++ b/apps/products/pos-micro/backend/Dockerfile @@ -0,0 +1,70 @@ +# ============================================================================= +# POS MICRO - Backend Dockerfile +# ============================================================================= + +# Build stage +FROM node:20-alpine AS builder + +WORKDIR /app + +# Copy package files +COPY package*.json ./ + +# Install dependencies +RUN npm ci + +# Copy source code +COPY . . + +# Build application +RUN npm run build + +# Production stage +FROM node:20-alpine AS production + +WORKDIR /app + +# Copy package files +COPY package*.json ./ + +# Install only production dependencies +RUN npm ci --only=production && npm cache clean --force + +# Copy built application +COPY --from=builder /app/dist ./dist + +# Create non-root user +RUN addgroup -g 1001 -S nodejs && \ + adduser -S nestjs -u 1001 -G nodejs + +USER nestjs + +# Expose port +EXPOSE 3000 + +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \ + CMD wget --no-verbose --tries=1 --spider http://localhost:3000/api/v1/health || exit 1 + +# Start application +CMD ["node", "dist/main"] + +# Development stage +FROM node:20-alpine AS development + +WORKDIR /app + +# Copy package files +COPY package*.json ./ + +# Install all dependencies +RUN npm ci + +# Copy source code +COPY . . + +# Expose port +EXPOSE 3000 + +# Start in development mode +CMD ["npm", "run", "start:dev"] diff --git a/apps/products/pos-micro/backend/nest-cli.json b/apps/products/pos-micro/backend/nest-cli.json new file mode 100644 index 0000000..f9aa683 --- /dev/null +++ b/apps/products/pos-micro/backend/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/apps/products/pos-micro/backend/package-lock.json b/apps/products/pos-micro/backend/package-lock.json new file mode 100644 index 0000000..b5cd397 --- /dev/null +++ b/apps/products/pos-micro/backend/package-lock.json @@ -0,0 +1,10752 @@ +{ + "name": "pos-micro-backend", + "version": "1.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "pos-micro-backend", + "version": "1.0.0", + "license": "MIT", + "dependencies": { + "@nestjs/common": "^10.3.0", + "@nestjs/config": "^3.1.1", + "@nestjs/core": "^10.3.0", + "@nestjs/jwt": "^10.2.0", + "@nestjs/passport": "^10.0.3", + "@nestjs/platform-express": "^10.3.0", + "@nestjs/swagger": "^7.2.0", + "@nestjs/typeorm": "^10.0.1", + "bcrypt": "^5.1.1", + "class-transformer": "^0.5.1", + "class-validator": "^0.14.1", + "helmet": "^7.1.0", + "passport": "^0.7.0", + "passport-jwt": "^4.0.1", + "pg": "^8.11.3", + "reflect-metadata": "^0.2.1", + "rxjs": "^7.8.1", + "typeorm": "^0.3.19", + "uuid": "^9.0.1" + }, + "devDependencies": { + "@nestjs/cli": "^10.3.0", + "@nestjs/schematics": "^10.1.0", + "@nestjs/testing": "^10.3.0", + "@types/bcrypt": "^5.0.2", + "@types/express": "^4.17.21", + "@types/jest": "^29.5.11", + "@types/node": "^20.10.8", + "@types/passport-jwt": "^4.0.0", + "@types/uuid": "^9.0.7", + "@typescript-eslint/eslint-plugin": "^6.19.0", + "@typescript-eslint/parser": "^6.19.0", + "eslint": "^8.56.0", + "eslint-config-prettier": "^9.1.0", + "eslint-plugin-prettier": "^5.1.3", + "jest": "^29.7.0", + "prettier": "^3.2.4", + "source-map-support": "^0.5.21", + "supertest": "^6.3.4", + "ts-jest": "^29.1.1", + "ts-loader": "^9.5.1", + "ts-node": "^10.9.2", + "tsconfig-paths": "^4.2.0", + "typescript": "^5.3.3" + } + }, + "node_modules/@angular-devkit/core": { + "version": "17.3.11", + "resolved": "https://registry.npmjs.org/@angular-devkit/core/-/core-17.3.11.tgz", + "integrity": "sha512-vTNDYNsLIWpYk2I969LMQFH29GTsLzxNk/0cLw5q56ARF0v5sIWfHYwGTS88jdDqIpuuettcSczbxeA7EuAmqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "8.12.0", + "ajv-formats": "2.1.1", + "jsonc-parser": "3.2.1", + "picomatch": "4.0.1", + "rxjs": "7.8.1", + "source-map": "0.7.4" + }, + "engines": { + "node": "^18.13.0 || >=20.9.0", + "npm": "^6.11.0 || ^7.5.6 || >=8.0.0", + "yarn": ">= 1.13.0" + }, + "peerDependencies": { + "chokidar": "^3.5.2" + }, + "peerDependenciesMeta": { + "chokidar": { + "optional": true + } + } + }, + "node_modules/@angular-devkit/core/node_modules/rxjs": { + "version": "7.8.1", + "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-7.8.1.tgz", + "integrity": "sha512-AA3TVj+0A2iuIoQkWEK/tqFjBq2j+6PO6Y0zJcvzLAFhEFIO3HL0vls9hWLncZbAAbK0mar7oZ4V079I/qPMxg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "tslib": "^2.1.0" + } + }, + "node_modules/@angular-devkit/schematics": { + "version": "17.3.11", + "resolved": "https://registry.npmjs.org/@angular-devkit/schematics/-/schematics-17.3.11.tgz", + "integrity": "sha512-I5wviiIqiFwar9Pdk30Lujk8FczEEc18i22A5c6Z9lbmhPQdTroDnEQdsfXjy404wPe8H62s0I15o4pmMGfTYQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@angular-devkit/core": "17.3.11", + "jsonc-parser": "3.2.1", + "magic-string": "0.30.8", + "ora": "5.4.1", + "rxjs": "7.8.1" + }, + "engines": { + "node": "^18.13.0 || >=20.9.0", + "npm": "^6.11.0 || ^7.5.6 || >=8.0.0", + "yarn": ">= 1.13.0" + } + }, + "node_modules/@angular-devkit/schematics-cli": { + "version": "17.3.11", + "resolved": "https://registry.npmjs.org/@angular-devkit/schematics-cli/-/schematics-cli-17.3.11.tgz", + "integrity": "sha512-kcOMqp+PHAKkqRad7Zd7PbpqJ0LqLaNZdY1+k66lLWmkEBozgq8v4ASn/puPWf9Bo0HpCiK+EzLf0VHE8Z/y6Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@angular-devkit/core": "17.3.11", + "@angular-devkit/schematics": "17.3.11", + "ansi-colors": "4.1.3", + "inquirer": "9.2.15", + "symbol-observable": "4.0.0", + "yargs-parser": "21.1.1" + }, + "bin": { + "schematics": "bin/schematics.js" + }, + "engines": { + "node": "^18.13.0 || >=20.9.0", + "npm": "^6.11.0 || ^7.5.6 || >=8.0.0", + "yarn": ">= 1.13.0" + } + }, + "node_modules/@angular-devkit/schematics-cli/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/@angular-devkit/schematics-cli/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/@angular-devkit/schematics-cli/node_modules/inquirer": { + "version": "9.2.15", + "resolved": "https://registry.npmjs.org/inquirer/-/inquirer-9.2.15.tgz", + "integrity": "sha512-vI2w4zl/mDluHt9YEQ/543VTCwPKWiHzKtm9dM2V0NdFcqEexDAjUHzO1oA60HRNaVifGXXM1tRRNluLVHa0Kg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@ljharb/through": "^2.3.12", + "ansi-escapes": "^4.3.2", + "chalk": "^5.3.0", + "cli-cursor": "^3.1.0", + "cli-width": "^4.1.0", + "external-editor": "^3.1.0", + "figures": "^3.2.0", + "lodash": "^4.17.21", + "mute-stream": "1.0.0", + "ora": "^5.4.1", + "run-async": "^3.0.0", + "rxjs": "^7.8.1", + "string-width": "^4.2.3", + "strip-ansi": "^6.0.1", + "wrap-ansi": "^6.2.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/@angular-devkit/schematics-cli/node_modules/mute-stream": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/mute-stream/-/mute-stream-1.0.0.tgz", + "integrity": "sha512-avsJQhyd+680gKXyG/sQc0nXaC6rBkPOfyHYcFb9+hdkqQkR9bdnkJ0AMZhke0oesPqIO+mFFJ+IdBc7mst4IA==", + "dev": true, + "license": "ISC", + "engines": { + "node": "^14.17.0 || ^16.13.0 || >=18.0.0" + } + }, + "node_modules/@angular-devkit/schematics-cli/node_modules/run-async": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/run-async/-/run-async-3.0.0.tgz", + "integrity": "sha512-540WwVDOMxA6dN6We19EcT9sc3hkXPw5mzRNGM3FkdN/vtE9NFvj5lFAPNwUDmJjXidm3v7TC1cTE7t17Ulm1Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/@angular-devkit/schematics/node_modules/rxjs": { + "version": "7.8.1", + "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-7.8.1.tgz", + "integrity": "sha512-AA3TVj+0A2iuIoQkWEK/tqFjBq2j+6PO6Y0zJcvzLAFhEFIO3HL0vls9hWLncZbAAbK0mar7oZ4V079I/qPMxg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "tslib": "^2.1.0" + } + }, + "node_modules/@babel/code-frame": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz", + "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.27.1", + "js-tokens": "^4.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/compat-data": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.5.tgz", + "integrity": "sha512-6uFXyCayocRbqhZOB+6XcuZbkMNimwfVGFji8CTZnCzOHVGvDqzvitu1re2AU5LROliz7eQPhB8CpAMvnx9EjA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/core": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.5.tgz", + "integrity": "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.27.1", + "@babel/generator": "^7.28.5", + "@babel/helper-compilation-targets": "^7.27.2", + "@babel/helper-module-transforms": "^7.28.3", + "@babel/helpers": "^7.28.4", + "@babel/parser": "^7.28.5", + "@babel/template": "^7.27.2", + "@babel/traverse": "^7.28.5", + "@babel/types": "^7.28.5", + "@jridgewell/remapping": "^2.3.5", + "convert-source-map": "^2.0.0", + "debug": "^4.1.0", + "gensync": "^1.0.0-beta.2", + "json5": "^2.2.3", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/babel" + } + }, + "node_modules/@babel/core/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/@babel/generator": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.5.tgz", + "integrity": "sha512-3EwLFhZ38J4VyIP6WNtt2kUdW9dokXA9Cr4IVIFHuCpZ3H8/YFOl5JjZHisrn1fATPBmKKqXzDFvh9fUwHz6CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.28.5", + "@babel/types": "^7.28.5", + "@jridgewell/gen-mapping": "^0.3.12", + "@jridgewell/trace-mapping": "^0.3.28", + "jsesc": "^3.0.2" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-compilation-targets": { + "version": "7.27.2", + "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz", + "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.27.2", + "@babel/helper-validator-option": "^7.27.1", + "browserslist": "^4.24.0", + "lru-cache": "^5.1.1", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-compilation-targets/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/@babel/helper-globals": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz", + "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-imports": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz", + "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/traverse": "^7.27.1", + "@babel/types": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-transforms": { + "version": "7.28.3", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz", + "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.27.1", + "@babel/helper-validator-identifier": "^7.27.1", + "@babel/traverse": "^7.28.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-plugin-utils": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.27.1.tgz", + "integrity": "sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz", + "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", + "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-option": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz", + "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helpers": { + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.4.tgz", + "integrity": "sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/template": "^7.27.2", + "@babel/types": "^7.28.4" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.5.tgz", + "integrity": "sha512-KKBU1VGYR7ORr3At5HAtUQ+TV3SzRCXmA/8OdDZiLDBIZxVyzXuztPjfLd3BV1PRAQGCMWWSHYhL0F8d5uHBDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.28.5" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/plugin-syntax-async-generators": { + "version": "7.8.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz", + "integrity": "sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-bigint": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-bigint/-/plugin-syntax-bigint-7.8.3.tgz", + "integrity": "sha512-wnTnFlG+YxQm3vDxpGE57Pj0srRU4sHE/mDkt1qv2YJJSeUAec2ma4WLUnUPeKjyrfntVwe/N6dCXpU+zL3Npg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-class-properties": { + "version": "7.12.13", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz", + "integrity": "sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.12.13" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-class-static-block": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-static-block/-/plugin-syntax-class-static-block-7.14.5.tgz", + "integrity": "sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-import-attributes": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.27.1.tgz", + "integrity": "sha512-oFT0FrKHgF53f4vOsZGi2Hh3I35PfSmVs4IBFLFj4dnafP+hIWDLg3VyKmUHfLoLHlyxY4C7DGtmHuJgn+IGww==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-import-meta": { + "version": "7.10.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz", + "integrity": "sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.10.4" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-json-strings": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz", + "integrity": "sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-jsx": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.27.1.tgz", + "integrity": "sha512-y8YTNIeKoyhGd9O0Jiyzyyqk8gdjnumGTQPsz0xOZOQ2RmkVJeZ1vmmfIvFEKqucBG6axJGBZDE/7iI5suUI/w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-logical-assignment-operators": { + "version": "7.10.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz", + "integrity": "sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.10.4" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-nullish-coalescing-operator": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-nullish-coalescing-operator/-/plugin-syntax-nullish-coalescing-operator-7.8.3.tgz", + "integrity": "sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-numeric-separator": { + "version": "7.10.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-numeric-separator/-/plugin-syntax-numeric-separator-7.10.4.tgz", + "integrity": "sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.10.4" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-object-rest-spread": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz", + "integrity": "sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-optional-catch-binding": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-catch-binding/-/plugin-syntax-optional-catch-binding-7.8.3.tgz", + "integrity": "sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-optional-chaining": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-chaining/-/plugin-syntax-optional-chaining-7.8.3.tgz", + "integrity": "sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-private-property-in-object": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-private-property-in-object/-/plugin-syntax-private-property-in-object-7.14.5.tgz", + "integrity": "sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-top-level-await": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-top-level-await/-/plugin-syntax-top-level-await-7.14.5.tgz", + "integrity": "sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-typescript": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.27.1.tgz", + "integrity": "sha512-xfYCBMxveHrRMnAWl1ZlPXOZjzkN82THFvLhQhFXFt81Z5HnN+EtUkZhv/zcKpmT3fzmWZB0ywiBrbC3vogbwQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/template": { + "version": "7.27.2", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz", + "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.27.1", + "@babel/parser": "^7.27.2", + "@babel/types": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/traverse": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.5.tgz", + "integrity": "sha512-TCCj4t55U90khlYkVV/0TfkJkAkUg3jZFA3Neb7unZT8CPok7iiRfaX0F+WnqWqt7OxhOn0uBKXCw4lbL8W0aQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.27.1", + "@babel/generator": "^7.28.5", + "@babel/helper-globals": "^7.28.0", + "@babel/parser": "^7.28.5", + "@babel/template": "^7.27.2", + "@babel/types": "^7.28.5", + "debug": "^4.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/types": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.5.tgz", + "integrity": "sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@bcoe/v8-coverage": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz", + "integrity": "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@borewit/text-codec": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/@borewit/text-codec/-/text-codec-0.1.1.tgz", + "integrity": "sha512-5L/uBxmjaCIX5h8Z+uu+kA9BQLkc/Wl06UGR5ajNRxu+/XjonB5i8JpgFMrPj3LXTCPA0pv8yxUvbUi+QthGGA==", + "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/@cspotcode/source-map-support": { + "version": "0.8.1", + "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz", + "integrity": "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "@jridgewell/trace-mapping": "0.3.9" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/@cspotcode/source-map-support/node_modules/@jridgewell/trace-mapping": { + "version": "0.3.9", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz", + "integrity": "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.0.3", + "@jridgewell/sourcemap-codec": "^1.4.10" + } + }, + "node_modules/@eslint-community/eslint-utils": { + "version": "4.9.0", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", + "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "eslint-visitor-keys": "^3.4.3" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" + } + }, + "node_modules/@eslint-community/regexpp": { + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", + "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.0.0 || ^14.0.0 || >=16.0.0" + } + }, + "node_modules/@eslint/eslintrc": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-2.1.4.tgz", + "integrity": "sha512-269Z39MS6wVJtsoUl10L60WdkhJVdPG24Q4eZTH3nnF6lpvSShEK3wQjDX9JRWAUPvPh7COouPpU9IrqaZFvtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^6.12.4", + "debug": "^4.3.2", + "espree": "^9.6.0", + "globals": "^13.19.0", + "ignore": "^5.2.0", + "import-fresh": "^3.2.1", + "js-yaml": "^4.1.0", + "minimatch": "^3.1.2", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint/eslintrc/node_modules/ajv": { + "version": "6.12.6", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", + "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/@eslint/eslintrc/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/@eslint/eslintrc/node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@eslint/eslintrc/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/@eslint/js": { + "version": "8.57.1", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.57.1.tgz", + "integrity": "sha512-d9zaMRSTIKDLhctzH12MtXvJKSSUhaHcjV+2Z+GK+EEY7XKpP5yR4x+N3TAcHTcu963nIr+TMcCb4DBCYX1z6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + } + }, + "node_modules/@humanwhocodes/config-array": { + "version": "0.13.0", + "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.13.0.tgz", + "integrity": "sha512-DZLEEqFWQFiyK6h5YIeynKx7JlvCYWL0cImfSRXZ9l4Sg2efkFGTuFf6vzXjK1cq6IYkU+Eg/JizXw+TD2vRNw==", + "deprecated": "Use @eslint/config-array instead", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanwhocodes/object-schema": "^2.0.3", + "debug": "^4.3.1", + "minimatch": "^3.0.5" + }, + "engines": { + "node": ">=10.10.0" + } + }, + "node_modules/@humanwhocodes/config-array/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/@humanwhocodes/config-array/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/@humanwhocodes/module-importer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", + "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.22" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@humanwhocodes/object-schema": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-2.0.3.tgz", + "integrity": "sha512-93zYdMES/c1D69yZiKDBj0V24vqNzB/koF26KPaagAfd3P/4gUlh3Dys5ogAK+Exi9QyzlD8x/08Zt7wIKcDcA==", + "deprecated": "Use @eslint/object-schema instead", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@isaacs/cliui": { + "version": "8.0.2", + "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz", + "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==", + "license": "ISC", + "dependencies": { + "string-width": "^5.1.2", + "string-width-cjs": "npm:string-width@^4.2.0", + "strip-ansi": "^7.0.1", + "strip-ansi-cjs": "npm:strip-ansi@^6.0.1", + "wrap-ansi": "^8.1.0", + "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/@isaacs/cliui/node_modules/ansi-regex": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz", + "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/@isaacs/cliui/node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/@isaacs/cliui/node_modules/emoji-regex": { + "version": "9.2.2", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", + "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==", + "license": "MIT" + }, + "node_modules/@isaacs/cliui/node_modules/string-width": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", + "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==", + "license": "MIT", + "dependencies": { + "eastasianwidth": "^0.2.0", + "emoji-regex": "^9.2.2", + "strip-ansi": "^7.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@isaacs/cliui/node_modules/strip-ansi": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.2.tgz", + "integrity": "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/@isaacs/cliui/node_modules/wrap-ansi": { + "version": "8.1.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz", + "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.1.0", + "string-width": "^5.0.1", + "strip-ansi": "^7.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/@istanbuljs/load-nyc-config": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@istanbuljs/load-nyc-config/-/load-nyc-config-1.1.0.tgz", + "integrity": "sha512-VjeHSlIzpv/NyD3N0YuHfXOPDIixcA1q2ZV98wsMqcYlPmv2n3Yb2lYP9XMElnaFVXg5A7YLTeLu6V84uQDjmQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "camelcase": "^5.3.1", + "find-up": "^4.1.0", + "get-package-type": "^0.1.0", + "js-yaml": "^3.13.1", + "resolve-from": "^5.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/argparse": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz", + "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", + "dev": true, + "license": "MIT", + "dependencies": { + "sprintf-js": "~1.0.2" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/find-up": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", + "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^5.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/js-yaml": { + "version": "3.14.2", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz", + "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==", + "dev": true, + "license": "MIT", + "dependencies": { + "argparse": "^1.0.7", + "esprima": "^4.0.0" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/locate-path": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", + "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^4.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/p-locate": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", + "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^2.2.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/resolve-from": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", + "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/schema": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.3.tgz", + "integrity": "sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/console": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/console/-/console-29.7.0.tgz", + "integrity": "sha512-5Ni4CU7XHQi32IJ398EEP4RrB8eV09sXP2ROqD4bksHrnTree52PsxvX8tpL8LvTZ3pFzXyPbNQReSN41CAhOg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/types": "^29.6.3", + "@types/node": "*", + "chalk": "^4.0.0", + "jest-message-util": "^29.7.0", + "jest-util": "^29.7.0", + "slash": "^3.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/core": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/core/-/core-29.7.0.tgz", + "integrity": "sha512-n7aeXWKMnGtDA48y8TLWJPJmLmmZ642Ceo78cYWEpiD7FzDgmNDV/GCVRorPABdXLJZ/9wzzgZAlHjXjxDHGsg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/console": "^29.7.0", + "@jest/reporters": "^29.7.0", + "@jest/test-result": "^29.7.0", + "@jest/transform": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "ansi-escapes": "^4.2.1", + "chalk": "^4.0.0", + "ci-info": "^3.2.0", + "exit": "^0.1.2", + "graceful-fs": "^4.2.9", + "jest-changed-files": "^29.7.0", + "jest-config": "^29.7.0", + "jest-haste-map": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-regex-util": "^29.6.3", + "jest-resolve": "^29.7.0", + "jest-resolve-dependencies": "^29.7.0", + "jest-runner": "^29.7.0", + "jest-runtime": "^29.7.0", + "jest-snapshot": "^29.7.0", + "jest-util": "^29.7.0", + "jest-validate": "^29.7.0", + "jest-watcher": "^29.7.0", + "micromatch": "^4.0.4", + "pretty-format": "^29.7.0", + "slash": "^3.0.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/@jest/environment": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/environment/-/environment-29.7.0.tgz", + "integrity": "sha512-aQIfHDq33ExsN4jP1NWGXhxgQ/wixs60gDiKO+XVMd8Mn0NWPWgc34ZQDTb2jKaUWQ7MuwoitXAsN2XVXNMpAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/fake-timers": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "jest-mock": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/expect": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/expect/-/expect-29.7.0.tgz", + "integrity": "sha512-8uMeAMycttpva3P1lBHB8VciS9V0XAr3GymPpipdyQXbBcuhkLQOSe8E/p92RyAdToS6ZD1tFkX+CkhoECE0dQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "expect": "^29.7.0", + "jest-snapshot": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/expect-utils": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/expect-utils/-/expect-utils-29.7.0.tgz", + "integrity": "sha512-GlsNBWiFQFCVi9QVSx7f5AgMeLxe9YCCs5PuP2O2LdjDAA8Jh9eX7lA1Jq/xdXw3Wb3hyvlFNfZIfcRetSzYcA==", + "dev": true, + "license": "MIT", + "dependencies": { + "jest-get-type": "^29.6.3" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/fake-timers": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/fake-timers/-/fake-timers-29.7.0.tgz", + "integrity": "sha512-q4DH1Ha4TTFPdxLsqDXK1d3+ioSL7yL5oCMJZgDYm6i+6CygW5E5xVr/D1HdsGxjt1ZWSfUAs9OxSB/BNelWrQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/types": "^29.6.3", + "@sinonjs/fake-timers": "^10.0.2", + "@types/node": "*", + "jest-message-util": "^29.7.0", + "jest-mock": "^29.7.0", + "jest-util": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/globals": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/globals/-/globals-29.7.0.tgz", + "integrity": "sha512-mpiz3dutLbkW2MNFubUGUEVLkTGiqW6yLVTA+JbP6fI6J5iL9Y0Nlg8k95pcF8ctKwCS7WVxteBs29hhfAotzQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/environment": "^29.7.0", + "@jest/expect": "^29.7.0", + "@jest/types": "^29.6.3", + "jest-mock": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/reporters": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/reporters/-/reporters-29.7.0.tgz", + "integrity": "sha512-DApq0KJbJOEzAFYjHADNNxAE3KbhxQB1y5Kplb5Waqw6zVbuWatSnMjE5gs8FUgEPmNsnZA3NCWl9NG0ia04Pg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@bcoe/v8-coverage": "^0.2.3", + "@jest/console": "^29.7.0", + "@jest/test-result": "^29.7.0", + "@jest/transform": "^29.7.0", + "@jest/types": "^29.6.3", + "@jridgewell/trace-mapping": "^0.3.18", + "@types/node": "*", + "chalk": "^4.0.0", + "collect-v8-coverage": "^1.0.0", + "exit": "^0.1.2", + "glob": "^7.1.3", + "graceful-fs": "^4.2.9", + "istanbul-lib-coverage": "^3.0.0", + "istanbul-lib-instrument": "^6.0.0", + "istanbul-lib-report": "^3.0.0", + "istanbul-lib-source-maps": "^4.0.0", + "istanbul-reports": "^3.1.3", + "jest-message-util": "^29.7.0", + "jest-util": "^29.7.0", + "jest-worker": "^29.7.0", + "slash": "^3.0.0", + "string-length": "^4.0.1", + "strip-ansi": "^6.0.0", + "v8-to-istanbul": "^9.0.1" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/@jest/reporters/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/@jest/reporters/node_modules/glob": { + "version": "7.2.3", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", + "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "deprecated": "Glob versions prior to v9 are no longer supported", + "dev": true, + "license": "ISC", + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/@jest/reporters/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/@jest/schemas": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz", + "integrity": "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@sinclair/typebox": "^0.27.8" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/source-map": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/@jest/source-map/-/source-map-29.6.3.tgz", + "integrity": "sha512-MHjT95QuipcPrpLM+8JMSzFx6eHp5Bm+4XeFDJlwsvVBjmKNiIAvasGK2fxz2WbGRlnvqehFbh07MMa7n3YJnw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/trace-mapping": "^0.3.18", + "callsites": "^3.0.0", + "graceful-fs": "^4.2.9" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/test-result": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/test-result/-/test-result-29.7.0.tgz", + "integrity": "sha512-Fdx+tv6x1zlkJPcWXmMDAG2HBnaR9XPSd5aDWQVsfrZmLVT3lU1cwyxLgRmXR9yrq4NBoEm9BMsfgFzTQAbJYA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/console": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/istanbul-lib-coverage": "^2.0.0", + "collect-v8-coverage": "^1.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/test-sequencer": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/test-sequencer/-/test-sequencer-29.7.0.tgz", + "integrity": "sha512-GQwJ5WZVrKnOJuiYiAF52UNUJXgTZx1NHjFSEB0qEMmSZKAkdMoIzw/Cj6x6NF4AvV23AUqDpFzQkN/eYCYTxw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/test-result": "^29.7.0", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^29.7.0", + "slash": "^3.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/transform": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/transform/-/transform-29.7.0.tgz", + "integrity": "sha512-ok/BTPFzFKVMwO5eOHRrvnBVHdRy9IrsrW1GpMaQ9MCnilNLXQKmAX8s1YXDFaai9xJpac2ySzV0YeRRECr2Vw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/core": "^7.11.6", + "@jest/types": "^29.6.3", + "@jridgewell/trace-mapping": "^0.3.18", + "babel-plugin-istanbul": "^6.1.1", + "chalk": "^4.0.0", + "convert-source-map": "^2.0.0", + "fast-json-stable-stringify": "^2.1.0", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^29.7.0", + "jest-regex-util": "^29.6.3", + "jest-util": "^29.7.0", + "micromatch": "^4.0.4", + "pirates": "^4.0.4", + "slash": "^3.0.0", + "write-file-atomic": "^4.0.2" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/types": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/@jest/types/-/types-29.6.3.tgz", + "integrity": "sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/schemas": "^29.6.3", + "@types/istanbul-lib-coverage": "^2.0.0", + "@types/istanbul-reports": "^3.0.0", + "@types/node": "*", + "@types/yargs": "^17.0.8", + "chalk": "^4.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jridgewell/gen-mapping": { + "version": "0.3.13", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", + "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.0", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/remapping": { + "version": "2.3.5", + "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz", + "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "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==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/source-map": { + "version": "0.3.11", + "resolved": "https://registry.npmjs.org/@jridgewell/source-map/-/source-map-0.3.11.tgz", + "integrity": "sha512-ZMp1V8ZFcPG5dIWnQLr3NSI1MiCU7UETdS/A0G8V/XWHvJv3ZsFqutJn1Y5RPmAPX6F3BiE397OqveU/9NCuIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.25" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "devOptional": 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/@ljharb/through": { + "version": "2.3.14", + "resolved": "https://registry.npmjs.org/@ljharb/through/-/through-2.3.14.tgz", + "integrity": "sha512-ajBvlKpWucBB17FuQYUShqpqy8GRgYEpJW0vWJbUu1CV9lWyrDCapy0lScU8T8Z6qn49sSwJB3+M+evYIdGg+A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8" + }, + "engines": { + "node": ">= 0.4" + } + }, + "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/@mapbox/node-pre-gyp": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/@mapbox/node-pre-gyp/-/node-pre-gyp-1.0.11.tgz", + "integrity": "sha512-Yhlar6v9WQgUp/He7BdgzOz8lqMQ8sU+jkCq7Wx8Myc5YFJLbEe7lgui/V7G1qB1DJykHSGwreceSaD60Y0PUQ==", + "license": "BSD-3-Clause", + "dependencies": { + "detect-libc": "^2.0.0", + "https-proxy-agent": "^5.0.0", + "make-dir": "^3.1.0", + "node-fetch": "^2.6.7", + "nopt": "^5.0.0", + "npmlog": "^5.0.1", + "rimraf": "^3.0.2", + "semver": "^7.3.5", + "tar": "^6.1.11" + }, + "bin": { + "node-pre-gyp": "bin/node-pre-gyp" + } + }, + "node_modules/@microsoft/tsdoc": { + "version": "0.15.1", + "resolved": "https://registry.npmjs.org/@microsoft/tsdoc/-/tsdoc-0.15.1.tgz", + "integrity": "sha512-4aErSrCR/On/e5G2hDP0wjooqDdauzEbIq8hIkIe5pXV0rtWJZvdCEKL0ykZxex+IxIwBp0eGeV48hQN07dXtw==", + "license": "MIT" + }, + "node_modules/@nestjs/cli": { + "version": "10.4.9", + "resolved": "https://registry.npmjs.org/@nestjs/cli/-/cli-10.4.9.tgz", + "integrity": "sha512-s8qYd97bggqeK7Op3iD49X2MpFtW4LVNLAwXFkfbRxKME6IYT7X0muNTJ2+QfI8hpbNx9isWkrLWIp+g5FOhiA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@angular-devkit/core": "17.3.11", + "@angular-devkit/schematics": "17.3.11", + "@angular-devkit/schematics-cli": "17.3.11", + "@nestjs/schematics": "^10.0.1", + "chalk": "4.1.2", + "chokidar": "3.6.0", + "cli-table3": "0.6.5", + "commander": "4.1.1", + "fork-ts-checker-webpack-plugin": "9.0.2", + "glob": "10.4.5", + "inquirer": "8.2.6", + "node-emoji": "1.11.0", + "ora": "5.4.1", + "tree-kill": "1.2.2", + "tsconfig-paths": "4.2.0", + "tsconfig-paths-webpack-plugin": "4.2.0", + "typescript": "5.7.2", + "webpack": "5.97.1", + "webpack-node-externals": "3.0.0" + }, + "bin": { + "nest": "bin/nest.js" + }, + "engines": { + "node": ">= 16.14" + }, + "peerDependencies": { + "@swc/cli": "^0.1.62 || ^0.3.0 || ^0.4.0 || ^0.5.0", + "@swc/core": "^1.3.62" + }, + "peerDependenciesMeta": { + "@swc/cli": { + "optional": true + }, + "@swc/core": { + "optional": true + } + } + }, + "node_modules/@nestjs/cli/node_modules/eslint-scope": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-5.1.1.tgz", + "integrity": "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^4.1.1" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/@nestjs/cli/node_modules/estraverse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.3.0.tgz", + "integrity": "sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/@nestjs/cli/node_modules/typescript": { + "version": "5.7.2", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.7.2.tgz", + "integrity": "sha512-i5t66RHxDvVN40HfDd1PsEThGNnlMCMT3jMUuoh9/0TaqWevNontacunWyN02LA9/fIbEWlcHZcgTKb9QoaLfg==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/@nestjs/cli/node_modules/webpack": { + "version": "5.97.1", + "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.97.1.tgz", + "integrity": "sha512-EksG6gFY3L1eFMROS/7Wzgrii5mBAFe4rIr3r2BTfo7bcc+DWwFZ4OJ/miOuHJO/A85HwyI4eQ0F6IKXesO7Fg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/eslint-scope": "^3.7.7", + "@types/estree": "^1.0.6", + "@webassemblyjs/ast": "^1.14.1", + "@webassemblyjs/wasm-edit": "^1.14.1", + "@webassemblyjs/wasm-parser": "^1.14.1", + "acorn": "^8.14.0", + "browserslist": "^4.24.0", + "chrome-trace-event": "^1.0.2", + "enhanced-resolve": "^5.17.1", + "es-module-lexer": "^1.2.1", + "eslint-scope": "5.1.1", + "events": "^3.2.0", + "glob-to-regexp": "^0.4.1", + "graceful-fs": "^4.2.11", + "json-parse-even-better-errors": "^2.3.1", + "loader-runner": "^4.2.0", + "mime-types": "^2.1.27", + "neo-async": "^2.6.2", + "schema-utils": "^3.2.0", + "tapable": "^2.1.1", + "terser-webpack-plugin": "^5.3.10", + "watchpack": "^2.4.1", + "webpack-sources": "^3.2.3" + }, + "bin": { + "webpack": "bin/webpack.js" + }, + "engines": { + "node": ">=10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependenciesMeta": { + "webpack-cli": { + "optional": true + } + } + }, + "node_modules/@nestjs/common": { + "version": "10.4.20", + "resolved": "https://registry.npmjs.org/@nestjs/common/-/common-10.4.20.tgz", + "integrity": "sha512-hxJxZF7jcKGuUzM9EYbuES80Z/36piJbiqmPy86mk8qOn5gglFebBTvcx7PWVbRNSb4gngASYnefBj/Y2HAzpQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "file-type": "20.4.1", + "iterare": "1.2.1", + "tslib": "2.8.1", + "uid": "2.0.2" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/nest" + }, + "peerDependencies": { + "class-transformer": "*", + "class-validator": "*", + "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": "3.3.0", + "resolved": "https://registry.npmjs.org/@nestjs/config/-/config-3.3.0.tgz", + "integrity": "sha512-pdGTp8m9d0ZCrjTpjkUbZx6gyf2IKf+7zlkrPNMsJzYZ4bFRRTpXrnj+556/5uiI6AfL5mMrJc2u7dB6bvM+VA==", + "license": "MIT", + "dependencies": { + "dotenv": "16.4.5", + "dotenv-expand": "10.0.0", + "lodash": "4.17.21" + }, + "peerDependencies": { + "@nestjs/common": "^8.0.0 || ^9.0.0 || ^10.0.0", + "rxjs": "^7.1.0" + } + }, + "node_modules/@nestjs/core": { + "version": "10.4.20", + "resolved": "https://registry.npmjs.org/@nestjs/core/-/core-10.4.20.tgz", + "integrity": "sha512-kRdtyKA3+Tu70N3RQ4JgmO1E3LzAMs/eppj7SfjabC7TgqNWoS4RLhWl4BqmsNVmjj6D5jgfPVtHtgYkU3AfpQ==", + "hasInstallScript": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@nuxtjs/opencollective": "0.3.2", + "fast-safe-stringify": "2.1.1", + "iterare": "1.2.1", + "path-to-regexp": "3.3.0", + "tslib": "2.8.1", + "uid": "2.0.2" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/nest" + }, + "peerDependencies": { + "@nestjs/common": "^10.0.0", + "@nestjs/microservices": "^10.0.0", + "@nestjs/platform-express": "^10.0.0", + "@nestjs/websockets": "^10.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/jwt": { + "version": "10.2.0", + "resolved": "https://registry.npmjs.org/@nestjs/jwt/-/jwt-10.2.0.tgz", + "integrity": "sha512-x8cG90SURkEiLOehNaN2aRlotxT0KZESUliOPKKnjWiyJOcWurkF3w345WOX0P4MgFzUjGoZ1Sy0aZnxeihT0g==", + "license": "MIT", + "dependencies": { + "@types/jsonwebtoken": "9.0.5", + "jsonwebtoken": "9.0.2" + }, + "peerDependencies": { + "@nestjs/common": "^8.0.0 || ^9.0.0 || ^10.0.0" + } + }, + "node_modules/@nestjs/mapped-types": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@nestjs/mapped-types/-/mapped-types-2.0.5.tgz", + "integrity": "sha512-bSJv4pd6EY99NX9CjBIyn4TVDoSit82DUZlL4I3bqNfy5Gt+gXTa86i3I/i0iIV9P4hntcGM5GyO+FhZAhxtyg==", + "license": "MIT", + "peerDependencies": { + "@nestjs/common": "^8.0.0 || ^9.0.0 || ^10.0.0", + "class-transformer": "^0.4.0 || ^0.5.0", + "class-validator": "^0.13.0 || ^0.14.0", + "reflect-metadata": "^0.1.12 || ^0.2.0" + }, + "peerDependenciesMeta": { + "class-transformer": { + "optional": true + }, + "class-validator": { + "optional": true + } + } + }, + "node_modules/@nestjs/passport": { + "version": "10.0.3", + "resolved": "https://registry.npmjs.org/@nestjs/passport/-/passport-10.0.3.tgz", + "integrity": "sha512-znJ9Y4S8ZDVY+j4doWAJ8EuuVO7SkQN3yOBmzxbGaXbvcSwFDAdGJ+OMCg52NdzIO4tQoN4pYKx8W6M0ArfFRQ==", + "license": "MIT", + "peerDependencies": { + "@nestjs/common": "^8.0.0 || ^9.0.0 || ^10.0.0", + "passport": "^0.4.0 || ^0.5.0 || ^0.6.0 || ^0.7.0" + } + }, + "node_modules/@nestjs/platform-express": { + "version": "10.4.20", + "resolved": "https://registry.npmjs.org/@nestjs/platform-express/-/platform-express-10.4.20.tgz", + "integrity": "sha512-rh97mX3rimyf4xLMLHuTOBKe6UD8LOJ14VlJ1F/PTd6C6ZK9Ak6EHuJvdaGcSFQhd3ZMBh3I6CuujKGW9pNdIg==", + "license": "MIT", + "peer": true, + "dependencies": { + "body-parser": "1.20.3", + "cors": "2.8.5", + "express": "4.21.2", + "multer": "2.0.2", + "tslib": "2.8.1" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/nest" + }, + "peerDependencies": { + "@nestjs/common": "^10.0.0", + "@nestjs/core": "^10.0.0" + } + }, + "node_modules/@nestjs/schematics": { + "version": "10.2.3", + "resolved": "https://registry.npmjs.org/@nestjs/schematics/-/schematics-10.2.3.tgz", + "integrity": "sha512-4e8gxaCk7DhBxVUly2PjYL4xC2ifDFexCqq1/u4TtivLGXotVk0wHdYuPYe1tHTHuR1lsOkRbfOCpkdTnigLVg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@angular-devkit/core": "17.3.11", + "@angular-devkit/schematics": "17.3.11", + "comment-json": "4.2.5", + "jsonc-parser": "3.3.1", + "pluralize": "8.0.0" + }, + "peerDependencies": { + "typescript": ">=4.8.2" + } + }, + "node_modules/@nestjs/schematics/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/@nestjs/swagger": { + "version": "7.4.2", + "resolved": "https://registry.npmjs.org/@nestjs/swagger/-/swagger-7.4.2.tgz", + "integrity": "sha512-Mu6TEn1M/owIvAx2B4DUQObQXqo2028R2s9rSZ/hJEgBK95+doTwS0DjmVA2wTeZTyVtXOoN7CsoM5pONBzvKQ==", + "license": "MIT", + "dependencies": { + "@microsoft/tsdoc": "^0.15.0", + "@nestjs/mapped-types": "2.0.5", + "js-yaml": "4.1.0", + "lodash": "4.17.21", + "path-to-regexp": "3.3.0", + "swagger-ui-dist": "5.17.14" + }, + "peerDependencies": { + "@fastify/static": "^6.0.0 || ^7.0.0", + "@nestjs/common": "^9.0.0 || ^10.0.0", + "@nestjs/core": "^9.0.0 || ^10.0.0", + "class-transformer": "*", + "class-validator": "*", + "reflect-metadata": "^0.1.12 || ^0.2.0" + }, + "peerDependenciesMeta": { + "@fastify/static": { + "optional": true + }, + "class-transformer": { + "optional": true + }, + "class-validator": { + "optional": true + } + } + }, + "node_modules/@nestjs/testing": { + "version": "10.4.20", + "resolved": "https://registry.npmjs.org/@nestjs/testing/-/testing-10.4.20.tgz", + "integrity": "sha512-nMkRDukDKskdPruM6EsgMq7yJua+CPZM6I6FrLP8yXw8BiVSPv9Nm0CtcGGwt3kgZF9hfxKjGqLjsvVBsv6Vfw==", + "dev": true, + "license": "MIT", + "dependencies": { + "tslib": "2.8.1" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/nest" + }, + "peerDependencies": { + "@nestjs/common": "^10.0.0", + "@nestjs/core": "^10.0.0", + "@nestjs/microservices": "^10.0.0", + "@nestjs/platform-express": "^10.0.0" + }, + "peerDependenciesMeta": { + "@nestjs/microservices": { + "optional": true + }, + "@nestjs/platform-express": { + "optional": true + } + } + }, + "node_modules/@nestjs/typeorm": { + "version": "10.0.2", + "resolved": "https://registry.npmjs.org/@nestjs/typeorm/-/typeorm-10.0.2.tgz", + "integrity": "sha512-H738bJyydK4SQkRCTeh1aFBxoO1E9xdL/HaLGThwrqN95os5mEyAtK7BLADOS+vldP4jDZ2VQPLj4epWwRqCeQ==", + "license": "MIT", + "dependencies": { + "uuid": "9.0.1" + }, + "peerDependencies": { + "@nestjs/common": "^8.0.0 || ^9.0.0 || ^10.0.0", + "@nestjs/core": "^8.0.0 || ^9.0.0 || ^10.0.0", + "reflect-metadata": "^0.1.13 || ^0.2.0", + "rxjs": "^7.2.0", + "typeorm": "^0.3.0" + } + }, + "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/@nodelib/fs.scandir": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", + "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "2.0.5", + "run-parallel": "^1.1.9" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.stat": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", + "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.walk": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", + "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.scandir": "2.1.5", + "fastq": "^1.6.0" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nuxtjs/opencollective": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@nuxtjs/opencollective/-/opencollective-0.3.2.tgz", + "integrity": "sha512-um0xL3fO7Mf4fDxcqx9KryrB7zgRM5JSlvGN5AGkP6JLM5XEKyjeAiPbNxdXVXQ16isuAhYpvP88NgL2BGd6aA==", + "license": "MIT", + "dependencies": { + "chalk": "^4.1.0", + "consola": "^2.15.0", + "node-fetch": "^2.6.1" + }, + "bin": { + "opencollective": "bin/opencollective.js" + }, + "engines": { + "node": ">=8.0.0", + "npm": ">=5.0.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/@pkgjs/parseargs": { + "version": "0.11.0", + "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz", + "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=14" + } + }, + "node_modules/@pkgr/core": { + "version": "0.2.9", + "resolved": "https://registry.npmjs.org/@pkgr/core/-/core-0.2.9.tgz", + "integrity": "sha512-QNqXyfVS2wm9hweSYD2O7F0G06uurj9kZ96TRQE5Y9hU7+tgdZwIkbAKc5Ocy1HxEY2kuDQa6cQ1WRs/O5LFKA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.20.0 || ^14.18.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/pkgr" + } + }, + "node_modules/@sinclair/typebox": { + "version": "0.27.8", + "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.8.tgz", + "integrity": "sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@sinonjs/commons": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-3.0.1.tgz", + "integrity": "sha512-K3mCHKQ9sVh8o1C9cxkwxaOmXoAMlDxC1mYyHrjqOWEcBjYr76t96zL2zlj5dUGZ3HSw240X1qgH3Mjf1yJWpQ==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "type-detect": "4.0.8" + } + }, + "node_modules/@sinonjs/fake-timers": { + "version": "10.3.0", + "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-10.3.0.tgz", + "integrity": "sha512-V4BG07kuYSUkTCSBHG8G8TNhM+F19jXFWnQtzj+we8DrkpSBCee9Z3Ms8yiGer/dlmhe35/Xdgyo3/0rQKg7YA==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@sinonjs/commons": "^3.0.0" + } + }, + "node_modules/@sqltools/formatter": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/@sqltools/formatter/-/formatter-1.2.5.tgz", + "integrity": "sha512-Uy0+khmZqUrUGm5dmMqVlnvufZRSK0FbYzVgp0UMstm+F5+W2/jnEEQyc9vo1ZR/E5ZI/B1WjjoTqBqwJL6Krw==", + "license": "MIT" + }, + "node_modules/@tokenizer/inflate": { + "version": "0.2.7", + "resolved": "https://registry.npmjs.org/@tokenizer/inflate/-/inflate-0.2.7.tgz", + "integrity": "sha512-MADQgmZT1eKjp06jpI2yozxaU9uVs4GzzgSL+uEq7bVcJ9V1ZXQkeGNql1fsSI0gMy1vhvNTNbUqrx+pZfJVmg==", + "license": "MIT", + "dependencies": { + "debug": "^4.4.0", + "fflate": "^0.8.2", + "token-types": "^6.0.0" + }, + "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/@tsconfig/node10": { + "version": "1.0.12", + "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.12.tgz", + "integrity": "sha512-UCYBaeFvM11aU2y3YPZ//O5Rhj+xKyzy7mvcIoAjASbigy8mHMryP5cK7dgjlz2hWxh1g5pLw084E0a/wlUSFQ==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/@tsconfig/node12": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/@tsconfig/node12/-/node12-1.0.11.tgz", + "integrity": "sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/@tsconfig/node14": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/@tsconfig/node14/-/node14-1.0.3.tgz", + "integrity": "sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/@tsconfig/node16": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/@tsconfig/node16/-/node16-1.0.4.tgz", + "integrity": "sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/@types/babel__core": { + "version": "7.20.5", + "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz", + "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.20.7", + "@babel/types": "^7.20.7", + "@types/babel__generator": "*", + "@types/babel__template": "*", + "@types/babel__traverse": "*" + } + }, + "node_modules/@types/babel__generator": { + "version": "7.27.0", + "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz", + "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__template": { + "version": "7.4.4", + "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz", + "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.1.0", + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__traverse": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz", + "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.28.2" + } + }, + "node_modules/@types/bcrypt": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/@types/bcrypt/-/bcrypt-5.0.2.tgz", + "integrity": "sha512-6atioO8Y75fNcbmj0G7UjI9lXN2pQ/IGJ2FWT4a/btd0Lk9lQalHLKhkgKVZ3r+spnmWUKfbMi1GEe9wyHQfNQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "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/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/eslint": { + "version": "9.6.1", + "resolved": "https://registry.npmjs.org/@types/eslint/-/eslint-9.6.1.tgz", + "integrity": "sha512-FXx2pKgId/WyYo2jXw63kk7/+TY7u7AziEJxJAnSFzHlqTAS3Ync6SvgYAN/k4/PQpnnVuzoMuVnByKK2qp0ag==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@types/estree": "*", + "@types/json-schema": "*" + } + }, + "node_modules/@types/eslint-scope": { + "version": "3.7.7", + "resolved": "https://registry.npmjs.org/@types/eslint-scope/-/eslint-scope-3.7.7.tgz", + "integrity": "sha512-MzMFlSLBqNF2gcHWO0G1vP/YQyfvrxZ0bF+u7mzUdZ1/xK4A4sru+nraZz5i3iEIk1l1uyicaDVTB4QbbEkAYg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/eslint": "*", + "@types/estree": "*" + } + }, + "node_modules/@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/express": { + "version": "4.17.25", + "resolved": "https://registry.npmjs.org/@types/express/-/express-4.17.25.tgz", + "integrity": "sha512-dVd04UKsfpINUnK0yBoYHDF3xu7xVH4BuDotC/xGuycx4CgbP48X/KF/586bcObxT0HENHXEU8Nqtu6NR+eKhw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/body-parser": "*", + "@types/express-serve-static-core": "^4.17.33", + "@types/qs": "*", + "@types/serve-static": "^1" + } + }, + "node_modules/@types/express-serve-static-core": { + "version": "4.19.7", + "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.19.7.tgz", + "integrity": "sha512-FvPtiIf1LfhzsaIXhv/PHan/2FeQBbtBDtfX2QfvPxdUelMDEckK08SM6nqo1MIZY3RUlfA+HV8+hFUSio78qg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*", + "@types/qs": "*", + "@types/range-parser": "*", + "@types/send": "*" + } + }, + "node_modules/@types/graceful-fs": { + "version": "4.1.9", + "resolved": "https://registry.npmjs.org/@types/graceful-fs/-/graceful-fs-4.1.9.tgz", + "integrity": "sha512-olP3sd1qOEe5dXTSaFvQG+02VdRXcdytWLAZsAq1PecU8uqQAhkrnbli7DagjtXKW/Bl7YJbUsa8MPcuc8LHEQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "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/istanbul-lib-coverage": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz", + "integrity": "sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/istanbul-lib-report": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.3.tgz", + "integrity": "sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/istanbul-lib-coverage": "*" + } + }, + "node_modules/@types/istanbul-reports": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/istanbul-reports/-/istanbul-reports-3.0.4.tgz", + "integrity": "sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/istanbul-lib-report": "*" + } + }, + "node_modules/@types/jest": { + "version": "29.5.14", + "resolved": "https://registry.npmjs.org/@types/jest/-/jest-29.5.14.tgz", + "integrity": "sha512-ZN+4sdnLUbo8EVvVc2ao0GFW6oVrQRPn4K2lglySj7APvSrgzxHiNNK99us4WDMi57xxA2yggblIAMNhXOotLQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "expect": "^29.0.0", + "pretty-format": "^29.0.0" + } + }, + "node_modules/@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/jsonwebtoken": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/@types/jsonwebtoken/-/jsonwebtoken-9.0.5.tgz", + "integrity": "sha512-VRLSGzik+Unrup6BsouBeHsf4d1hOEgYWTm/7Nmw1sXoN1+tRly/Gy/po3yeahnP4jfnQWWAhQAqcNfH7ngOkA==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/mime": { + "version": "1.3.5", + "resolved": "https://registry.npmjs.org/@types/mime/-/mime-1.3.5.tgz", + "integrity": "sha512-/pyBZWSLD2n0dcHE3hq8s8ZvcETHtEuF+3E7XVt0Ig2nvsVQXdghHVcEkIWjy9A0wKfTn97a/PSDYohKIlnP/w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/node": { + "version": "20.19.26", + "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.26.tgz", + "integrity": "sha512-0l6cjgF0XnihUpndDhk+nyD3exio3iKaYROSgvh/qSevPXax3L8p5DBRFjbvalnwatGgHEQn2R88y2fA3g4irg==", + "license": "MIT", + "peer": true, + "dependencies": { + "undici-types": "~6.21.0" + } + }, + "node_modules/@types/passport": { + "version": "1.0.17", + "resolved": "https://registry.npmjs.org/@types/passport/-/passport-1.0.17.tgz", + "integrity": "sha512-aciLyx+wDwT2t2/kJGJR2AEeBz0nJU4WuRX04Wu9Dqc5lSUtwu0WERPHYsLhF9PtseiAMPBGNUOtFjxZ56prsg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/express": "*" + } + }, + "node_modules/@types/passport-jwt": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/@types/passport-jwt/-/passport-jwt-4.0.1.tgz", + "integrity": "sha512-Y0Ykz6nWP4jpxgEUYq8NoVZeCQPo1ZndJLfapI249g1jHChvRfZRO/LS3tqu26YgAS/laI1qx98sYGz0IalRXQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/jsonwebtoken": "*", + "@types/passport-strategy": "*" + } + }, + "node_modules/@types/passport-strategy": { + "version": "0.2.38", + "resolved": "https://registry.npmjs.org/@types/passport-strategy/-/passport-strategy-0.2.38.tgz", + "integrity": "sha512-GC6eMqqojOooq993Tmnmp7AUTbbQSgilyvpCYQjT+H6JfG/g6RGc7nXEniZlp0zyKJ0WUdOiZWLBZft9Yug1uA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/express": "*", + "@types/passport": "*" + } + }, + "node_modules/@types/qs": { + "version": "6.14.0", + "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.14.0.tgz", + "integrity": "sha512-eOunJqu0K1923aExK6y8p6fsihYEn/BYuQ4g0CxAAgFc4b/ZLN4CrsRZ55srTdqoiLzU2B2evC+apEIxprEzkQ==", + "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/semver": { + "version": "7.7.1", + "resolved": "https://registry.npmjs.org/@types/semver/-/semver-7.7.1.tgz", + "integrity": "sha512-FmgJfu+MOcQ370SD0ev7EI8TlCAfKYU+B4m5T3yXc1CiRN94g/SZPtsCkk506aUDtlMnFZvasDwHHUcZUEaYuA==", + "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": "1.15.10", + "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-1.15.10.tgz", + "integrity": "sha512-tRs1dB+g8Itk72rlSI2ZrW6vZg0YrLI81iQSTkMmOqnqCaNr/8Ek4VwWcN5vZgCYWbg/JJSGBlUaYGAOP73qBw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/http-errors": "*", + "@types/node": "*", + "@types/send": "<1" + } + }, + "node_modules/@types/serve-static/node_modules/@types/send": { + "version": "0.17.6", + "resolved": "https://registry.npmjs.org/@types/send/-/send-0.17.6.tgz", + "integrity": "sha512-Uqt8rPBE8SY0RK8JB1EzVOIZ32uqy8HwdxCnoCOsYrvnswqmFZ/k+9Ikidlk/ImhsdvBsloHbAlewb2IEBV/Og==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/mime": "^1", + "@types/node": "*" + } + }, + "node_modules/@types/stack-utils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/@types/stack-utils/-/stack-utils-2.0.3.tgz", + "integrity": "sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/uuid": { + "version": "9.0.8", + "resolved": "https://registry.npmjs.org/@types/uuid/-/uuid-9.0.8.tgz", + "integrity": "sha512-jg+97EGIcY9AGHJJRaaPVgetKDsrTgbRjQ5Msgjh/DQKEFl0DtyRr/VCOyD1T2R1MNeWPK/u7JoGhlDZnKBAfA==", + "dev": true, + "license": "MIT" + }, + "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/@types/yargs": { + "version": "17.0.35", + "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.35.tgz", + "integrity": "sha512-qUHkeCyQFxMXg79wQfTtfndEC+N9ZZg76HJftDJp+qH2tV7Gj4OJi7l+PiWwJ+pWtW8GwSmqsDj/oymhrTWXjg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/yargs-parser": "*" + } + }, + "node_modules/@types/yargs-parser": { + "version": "21.0.3", + "resolved": "https://registry.npmjs.org/@types/yargs-parser/-/yargs-parser-21.0.3.tgz", + "integrity": "sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@typescript-eslint/eslint-plugin": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-6.21.0.tgz", + "integrity": "sha512-oy9+hTPCUFpngkEZUSzbf9MxI65wbKFoQYsgPdILTfbUldp5ovUuphZVe4i30emU9M/kP+T64Di0mxl7dSw3MA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/regexpp": "^4.5.1", + "@typescript-eslint/scope-manager": "6.21.0", + "@typescript-eslint/type-utils": "6.21.0", + "@typescript-eslint/utils": "6.21.0", + "@typescript-eslint/visitor-keys": "6.21.0", + "debug": "^4.3.4", + "graphemer": "^1.4.0", + "ignore": "^5.2.4", + "natural-compare": "^1.4.0", + "semver": "^7.5.4", + "ts-api-utils": "^1.0.1" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "@typescript-eslint/parser": "^6.0.0 || ^6.0.0-alpha", + "eslint": "^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/parser": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-6.21.0.tgz", + "integrity": "sha512-tbsV1jPne5CkFQCgPBcDOt30ItF7aJoZL997JSF7MhGQqOeT3svWRYxiqlfA5RUdlHN6Fi+EI9bxqbdyAUZjYQ==", + "dev": true, + "license": "BSD-2-Clause", + "peer": true, + "dependencies": { + "@typescript-eslint/scope-manager": "6.21.0", + "@typescript-eslint/types": "6.21.0", + "@typescript-eslint/typescript-estree": "6.21.0", + "@typescript-eslint/visitor-keys": "6.21.0", + "debug": "^4.3.4" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/scope-manager": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-6.21.0.tgz", + "integrity": "sha512-OwLUIWZJry80O99zvqXVEioyniJMa+d2GrqpUTqi5/v5D5rOrppJVBPa0yKCblcigC0/aYAzxxqQ1B+DS2RYsg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "6.21.0", + "@typescript-eslint/visitor-keys": "6.21.0" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/type-utils": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-6.21.0.tgz", + "integrity": "sha512-rZQI7wHfao8qMX3Rd3xqeYSMCL3SoiSQLBATSiVKARdFGCYSRvmViieZjqc58jKgs8Y8i9YvVVhRbHSTA4VBag==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/typescript-estree": "6.21.0", + "@typescript-eslint/utils": "6.21.0", + "debug": "^4.3.4", + "ts-api-utils": "^1.0.1" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/types": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-6.21.0.tgz", + "integrity": "sha512-1kFmZ1rOm5epu9NZEZm1kckCDGj5UJEf7P1kliH4LKu/RkwpsfqqGmY2OOcUs18lSlQBKLDYBOGxRVtrMN5lpg==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/typescript-estree": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-6.21.0.tgz", + "integrity": "sha512-6npJTkZcO+y2/kr+z0hc4HwNfrrP4kNYh57ek7yCNlrBjWQ1Y0OS7jiZTkgumrvkX5HkEKXFZkkdFNkaW2wmUQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "@typescript-eslint/types": "6.21.0", + "@typescript-eslint/visitor-keys": "6.21.0", + "debug": "^4.3.4", + "globby": "^11.1.0", + "is-glob": "^4.0.3", + "minimatch": "9.0.3", + "semver": "^7.5.4", + "ts-api-utils": "^1.0.1" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/utils": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-6.21.0.tgz", + "integrity": "sha512-NfWVaC8HP9T8cbKQxHcsJBY5YE1O33+jpMwN45qzWWaPDZgLIbo12toGMWnmhvCpd3sIxkpDw3Wv1B3dYrbDQQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.4.0", + "@types/json-schema": "^7.0.12", + "@types/semver": "^7.5.0", + "@typescript-eslint/scope-manager": "6.21.0", + "@typescript-eslint/types": "6.21.0", + "@typescript-eslint/typescript-estree": "6.21.0", + "semver": "^7.5.4" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^7.0.0 || ^8.0.0" + } + }, + "node_modules/@typescript-eslint/visitor-keys": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-6.21.0.tgz", + "integrity": "sha512-JJtkDduxLi9bivAB+cYOVMtbkqdPOhZ+ZI5LC47MIRrDV4Yn2o+ZnW10Nkmr28xRpSpdJ6Sm42Hjf2+REYXm0A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "6.21.0", + "eslint-visitor-keys": "^3.4.1" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@ungap/structured-clone": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.0.tgz", + "integrity": "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==", + "dev": true, + "license": "ISC" + }, + "node_modules/@webassemblyjs/ast": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.14.1.tgz", + "integrity": "sha512-nuBEDgQfm1ccRp/8bCQrx1frohyufl4JlbMMZ4P1wpeOfDhF6FQkxZJ1b/e+PLwr6X1Nhw6OLme5usuBWYBvuQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@webassemblyjs/helper-numbers": "1.13.2", + "@webassemblyjs/helper-wasm-bytecode": "1.13.2" + } + }, + "node_modules/@webassemblyjs/floating-point-hex-parser": { + "version": "1.13.2", + "resolved": "https://registry.npmjs.org/@webassemblyjs/floating-point-hex-parser/-/floating-point-hex-parser-1.13.2.tgz", + "integrity": "sha512-6oXyTOzbKxGH4steLbLNOu71Oj+C8Lg34n6CqRvqfS2O71BxY6ByfMDRhBytzknj9yGUPVJ1qIKhRlAwO1AovA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@webassemblyjs/helper-api-error": { + "version": "1.13.2", + "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-api-error/-/helper-api-error-1.13.2.tgz", + "integrity": "sha512-U56GMYxy4ZQCbDZd6JuvvNV/WFildOjsaWD3Tzzvmw/mas3cXzRJPMjP83JqEsgSbyrmaGjBfDtV7KDXV9UzFQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@webassemblyjs/helper-buffer": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-buffer/-/helper-buffer-1.14.1.tgz", + "integrity": "sha512-jyH7wtcHiKssDtFPRB+iQdxlDf96m0E39yb0k5uJVhFGleZFoNw1c4aeIcVUPPbXUVJ94wwnMOAqUHyzoEPVMA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@webassemblyjs/helper-numbers": { + "version": "1.13.2", + "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-numbers/-/helper-numbers-1.13.2.tgz", + "integrity": "sha512-FE8aCmS5Q6eQYcV3gI35O4J789wlQA+7JrqTTpJqn5emA4U2hvwJmvFRC0HODS+3Ye6WioDklgd6scJ3+PLnEA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@webassemblyjs/floating-point-hex-parser": "1.13.2", + "@webassemblyjs/helper-api-error": "1.13.2", + "@xtuc/long": "4.2.2" + } + }, + "node_modules/@webassemblyjs/helper-wasm-bytecode": { + "version": "1.13.2", + "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-bytecode/-/helper-wasm-bytecode-1.13.2.tgz", + "integrity": "sha512-3QbLKy93F0EAIXLh0ogEVR6rOubA9AoZ+WRYhNbFyuB70j3dRdwH9g+qXhLAO0kiYGlg3TxDV+I4rQTr/YNXkA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@webassemblyjs/helper-wasm-section": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-section/-/helper-wasm-section-1.14.1.tgz", + "integrity": "sha512-ds5mXEqTJ6oxRoqjhWDU83OgzAYjwsCV8Lo/N+oRsNDmx/ZDpqalmrtgOMkHwxsG0iI//3BwWAErYRHtgn0dZw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.14.1", + "@webassemblyjs/helper-buffer": "1.14.1", + "@webassemblyjs/helper-wasm-bytecode": "1.13.2", + "@webassemblyjs/wasm-gen": "1.14.1" + } + }, + "node_modules/@webassemblyjs/ieee754": { + "version": "1.13.2", + "resolved": "https://registry.npmjs.org/@webassemblyjs/ieee754/-/ieee754-1.13.2.tgz", + "integrity": "sha512-4LtOzh58S/5lX4ITKxnAK2USuNEvpdVV9AlgGQb8rJDHaLeHciwG4zlGr0j/SNWlr7x3vO1lDEsuePvtcDNCkw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@xtuc/ieee754": "^1.2.0" + } + }, + "node_modules/@webassemblyjs/leb128": { + "version": "1.13.2", + "resolved": "https://registry.npmjs.org/@webassemblyjs/leb128/-/leb128-1.13.2.tgz", + "integrity": "sha512-Lde1oNoIdzVzdkNEAWZ1dZ5orIbff80YPdHx20mrHwHrVNNTjNr8E3xz9BdpcGqRQbAEa+fkrCb+fRFTl/6sQw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@xtuc/long": "4.2.2" + } + }, + "node_modules/@webassemblyjs/utf8": { + "version": "1.13.2", + "resolved": "https://registry.npmjs.org/@webassemblyjs/utf8/-/utf8-1.13.2.tgz", + "integrity": "sha512-3NQWGjKTASY1xV5m7Hr0iPeXD9+RDobLll3T9d2AO+g3my8xy5peVyjSag4I50mR1bBSN/Ct12lo+R9tJk0NZQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@webassemblyjs/wasm-edit": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-edit/-/wasm-edit-1.14.1.tgz", + "integrity": "sha512-RNJUIQH/J8iA/1NzlE4N7KtyZNHi3w7at7hDjvRNm5rcUXa00z1vRz3glZoULfJ5mpvYhLybmVcwcjGrC1pRrQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.14.1", + "@webassemblyjs/helper-buffer": "1.14.1", + "@webassemblyjs/helper-wasm-bytecode": "1.13.2", + "@webassemblyjs/helper-wasm-section": "1.14.1", + "@webassemblyjs/wasm-gen": "1.14.1", + "@webassemblyjs/wasm-opt": "1.14.1", + "@webassemblyjs/wasm-parser": "1.14.1", + "@webassemblyjs/wast-printer": "1.14.1" + } + }, + "node_modules/@webassemblyjs/wasm-gen": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-gen/-/wasm-gen-1.14.1.tgz", + "integrity": "sha512-AmomSIjP8ZbfGQhumkNvgC33AY7qtMCXnN6bL2u2Js4gVCg8fp735aEiMSBbDR7UQIj90n4wKAFUSEd0QN2Ukg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.14.1", + "@webassemblyjs/helper-wasm-bytecode": "1.13.2", + "@webassemblyjs/ieee754": "1.13.2", + "@webassemblyjs/leb128": "1.13.2", + "@webassemblyjs/utf8": "1.13.2" + } + }, + "node_modules/@webassemblyjs/wasm-opt": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-opt/-/wasm-opt-1.14.1.tgz", + "integrity": "sha512-PTcKLUNvBqnY2U6E5bdOQcSM+oVP/PmrDY9NzowJjislEjwP/C4an2303MCVS2Mg9d3AJpIGdUFIQQWbPds0Sw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.14.1", + "@webassemblyjs/helper-buffer": "1.14.1", + "@webassemblyjs/wasm-gen": "1.14.1", + "@webassemblyjs/wasm-parser": "1.14.1" + } + }, + "node_modules/@webassemblyjs/wasm-parser": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-parser/-/wasm-parser-1.14.1.tgz", + "integrity": "sha512-JLBl+KZ0R5qB7mCnud/yyX08jWFw5MsoalJ1pQ4EdFlgj9VdXKGuENGsiCIjegI1W7p91rUlcB/LB5yRJKNTcQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.14.1", + "@webassemblyjs/helper-api-error": "1.13.2", + "@webassemblyjs/helper-wasm-bytecode": "1.13.2", + "@webassemblyjs/ieee754": "1.13.2", + "@webassemblyjs/leb128": "1.13.2", + "@webassemblyjs/utf8": "1.13.2" + } + }, + "node_modules/@webassemblyjs/wast-printer": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/wast-printer/-/wast-printer-1.14.1.tgz", + "integrity": "sha512-kPSSXE6De1XOR820C90RIo2ogvZG+c3KiHzqUoO/F34Y2shGzesfqv7o57xrxovZJH/MetF5UjroJ/R/3isoiw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.14.1", + "@xtuc/long": "4.2.2" + } + }, + "node_modules/@xtuc/ieee754": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/@xtuc/ieee754/-/ieee754-1.2.0.tgz", + "integrity": "sha512-DX8nKgqcGwsc0eJSqYt5lwP4DH5FlHnmuWWBRy7X0NcaGR0ZtuyeESgMwTYVEtxmsNGY+qit4QYT/MIYTOTPeA==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@xtuc/long": { + "version": "4.2.2", + "resolved": "https://registry.npmjs.org/@xtuc/long/-/long-4.2.2.tgz", + "integrity": "sha512-NuHqBY1PB/D8xU6s/thBgOAiAP7HOYDQ32+BFZILJ8ivkUkAHQnWfn6WhL79Owj1qmUnoN/YPhktdIoucipkAQ==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/abbrev": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.1.1.tgz", + "integrity": "sha512-nne9/IiQ/hzIhY6pdDnbBtz7DjPTKrY00P/zvPSm5pOFkl6xuGrGnXn/VtTNNfNtAfZ9/1RtehkszU9qcTii0Q==", + "license": "ISC" + }, + "node_modules/accepts": { + "version": "1.3.8", + "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz", + "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==", + "license": "MIT", + "dependencies": { + "mime-types": "~2.1.34", + "negotiator": "0.6.3" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/acorn": { + "version": "8.15.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", + "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", + "devOptional": true, + "license": "MIT", + "peer": true, + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-import-phases": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/acorn-import-phases/-/acorn-import-phases-1.0.4.tgz", + "integrity": "sha512-wKmbr/DDiIXzEOiWrTTUcDm24kQ2vGfZQvM2fwg2vXqR5uW6aapr7ObPtj1th32b9u90/Pf4AItvdTh42fBmVQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10.13.0" + }, + "peerDependencies": { + "acorn": "^8.14.0" + } + }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/acorn-walk": { + "version": "8.3.4", + "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz", + "integrity": "sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "acorn": "^8.11.0" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/agent-base": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz", + "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==", + "license": "MIT", + "dependencies": { + "debug": "4" + }, + "engines": { + "node": ">= 6.0.0" + } + }, + "node_modules/ajv": { + "version": "8.12.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.12.0.tgz", + "integrity": "sha512-sRu1kpcO9yLtYxBKvqfTeh9KzZEwO3STyX1HT+4CaDzC6HpTGYhIhPIzj9XuKU7KYDwnaeh5hcOwjy1QuJzBPA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ajv-formats": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-2.1.1.tgz", + "integrity": "sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^8.0.0" + }, + "peerDependencies": { + "ajv": "^8.0.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, + "node_modules/ajv-keywords": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz", + "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3" + }, + "peerDependencies": { + "ajv": "^8.8.2" + } + }, + "node_modules/ansi-colors": { + "version": "4.1.3", + "resolved": "https://registry.npmjs.org/ansi-colors/-/ansi-colors-4.1.3.tgz", + "integrity": "sha512-/6w/C21Pm1A7aZitlI5Ni/2J6FFQN8i1Cvz3kHABAAbw93v/NlvKdVOqz7CCWz/3iv/JplRSEEZ83XION15ovw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "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-escapes/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/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "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==", + "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.2.0", + "resolved": "https://registry.npmjs.org/ansis/-/ansis-4.2.0.tgz", + "integrity": "sha512-HqZ5rWlFjGiV0tDm3UxxgNRqsOTniqoKZu0pIAfh7TZQMGuZK+hH0drySty0si0QXj1ieop4+SkSfPZBPPkHig==", + "license": "ISC", + "engines": { + "node": ">=14" + } + }, + "node_modules/anymatch": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", + "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", + "dev": true, + "license": "ISC", + "dependencies": { + "normalize-path": "^3.0.0", + "picomatch": "^2.0.4" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/anymatch/node_modules/picomatch": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/app-root-path": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/app-root-path/-/app-root-path-3.1.0.tgz", + "integrity": "sha512-biN3PwB2gUtjaYy/isrU3aNWI5w+fAfvHkSvCKeQGxhmYpwKFUxudR3Yya+KqVRHBmEDYh+/lTozYCFbmzX4nA==", + "license": "MIT", + "engines": { + "node": ">= 6.0.0" + } + }, + "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/aproba": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/aproba/-/aproba-2.1.0.tgz", + "integrity": "sha512-tLIEcj5GuR2RSTnxNKdkK0dJ/GrC7P38sUkiDmDuHfsHmbagTFAxDVIBltoklXEVIQ/f14IL8IMJ5pn9Hez1Ew==", + "license": "ISC" + }, + "node_modules/are-we-there-yet": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/are-we-there-yet/-/are-we-there-yet-2.0.0.tgz", + "integrity": "sha512-Ci/qENmwHnsYo9xKIcUJN5LeDKdJ6R1Z1j9V/J5wyq8nh/mYPEpIKJbBZXtZjG04HiK7zV/p6Vs9952MrMeUIw==", + "deprecated": "This package is no longer supported.", + "license": "ISC", + "dependencies": { + "delegates": "^1.0.0", + "readable-stream": "^3.6.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/arg": { + "version": "4.1.3", + "resolved": "https://registry.npmjs.org/arg/-/arg-4.1.3.tgz", + "integrity": "sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "license": "Python-2.0" + }, + "node_modules/array-flatten": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz", + "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==", + "license": "MIT" + }, + "node_modules/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/array-union": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz", + "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "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/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/available-typed-arrays": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/available-typed-arrays/-/available-typed-arrays-1.0.7.tgz", + "integrity": "sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==", + "license": "MIT", + "dependencies": { + "possible-typed-array-names": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/babel-jest": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/babel-jest/-/babel-jest-29.7.0.tgz", + "integrity": "sha512-BrvGY3xZSwEcCzKvKsCi2GgHqDqsYkOP4/by5xCgIwGXQxIEh+8ew3gmrE1y7XRR6LHZIj6yLYnUi/mm2KXKBg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/transform": "^29.7.0", + "@types/babel__core": "^7.1.14", + "babel-plugin-istanbul": "^6.1.1", + "babel-preset-jest": "^29.6.3", + "chalk": "^4.0.0", + "graceful-fs": "^4.2.9", + "slash": "^3.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "@babel/core": "^7.8.0" + } + }, + "node_modules/babel-plugin-istanbul": { + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/babel-plugin-istanbul/-/babel-plugin-istanbul-6.1.1.tgz", + "integrity": "sha512-Y1IQok9821cC9onCx5otgFfRm7Lm+I+wwxOx738M/WLPZ9Q42m4IG5W0FNX8WLL2gYMZo3JkuXIH2DOpWM+qwA==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@babel/helper-plugin-utils": "^7.0.0", + "@istanbuljs/load-nyc-config": "^1.0.0", + "@istanbuljs/schema": "^0.1.2", + "istanbul-lib-instrument": "^5.0.4", + "test-exclude": "^6.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-plugin-istanbul/node_modules/istanbul-lib-instrument": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-5.2.1.tgz", + "integrity": "sha512-pzqtp31nLv/XFOzXGuvhCb8qhjmTVo5vjVk19XE4CRlSWz0KoeJ3bw9XsA7nOp9YBf4qHjwBxkDzKcME/J29Yg==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@babel/core": "^7.12.3", + "@babel/parser": "^7.14.7", + "@istanbuljs/schema": "^0.1.2", + "istanbul-lib-coverage": "^3.2.0", + "semver": "^6.3.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-plugin-istanbul/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/babel-plugin-jest-hoist": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-29.6.3.tgz", + "integrity": "sha512-ESAc/RJvGTFEzRwOTT4+lNDk/GNHMkKbNzsvT0qKRfDyyYTskxB5rnU2njIDYVxXCBHHEI1c0YwHob3WaYujOg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/template": "^7.3.3", + "@babel/types": "^7.3.3", + "@types/babel__core": "^7.1.14", + "@types/babel__traverse": "^7.0.6" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/babel-preset-current-node-syntax": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.2.0.tgz", + "integrity": "sha512-E/VlAEzRrsLEb2+dv8yp3bo4scof3l9nR4lrld+Iy5NyVqgVYUJnDAmunkhPMisRI32Qc4iRiz425d8vM++2fg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/plugin-syntax-async-generators": "^7.8.4", + "@babel/plugin-syntax-bigint": "^7.8.3", + "@babel/plugin-syntax-class-properties": "^7.12.13", + "@babel/plugin-syntax-class-static-block": "^7.14.5", + "@babel/plugin-syntax-import-attributes": "^7.24.7", + "@babel/plugin-syntax-import-meta": "^7.10.4", + "@babel/plugin-syntax-json-strings": "^7.8.3", + "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4", + "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3", + "@babel/plugin-syntax-numeric-separator": "^7.10.4", + "@babel/plugin-syntax-object-rest-spread": "^7.8.3", + "@babel/plugin-syntax-optional-catch-binding": "^7.8.3", + "@babel/plugin-syntax-optional-chaining": "^7.8.3", + "@babel/plugin-syntax-private-property-in-object": "^7.14.5", + "@babel/plugin-syntax-top-level-await": "^7.14.5" + }, + "peerDependencies": { + "@babel/core": "^7.0.0 || ^8.0.0-0" + } + }, + "node_modules/babel-preset-jest": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/babel-preset-jest/-/babel-preset-jest-29.6.3.tgz", + "integrity": "sha512-0B3bhxR6snWXJZtR/RliHTDPRgn1sNHOR0yVtq/IiQFyuOVjFS+wuio/R4gSNkyYmKmJB4wGZv2NZanmKmTnNA==", + "dev": true, + "license": "MIT", + "dependencies": { + "babel-plugin-jest-hoist": "^29.6.3", + "babel-preset-current-node-syntax": "^1.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "license": "MIT" + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/baseline-browser-mapping": { + "version": "2.9.5", + "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.9.5.tgz", + "integrity": "sha512-D5vIoztZOq1XM54LUdttJVc96ggEsIfju2JBvht06pSzpckp3C7HReun67Bghzrtdsq9XdMGbSSB3v3GhMNmAA==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "baseline-browser-mapping": "dist/cli.js" + } + }, + "node_modules/bcrypt": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/bcrypt/-/bcrypt-5.1.1.tgz", + "integrity": "sha512-AGBHOG5hPYZ5Xl9KXzU5iKq9516yEmvCKDg3ecP5kX2aB6UqTeXZxk2ELnDgDm6BQSMlLt9rDB4LoSMx0rYwww==", + "hasInstallScript": true, + "license": "MIT", + "dependencies": { + "@mapbox/node-pre-gyp": "^1.0.11", + "node-addon-api": "^5.0.0" + }, + "engines": { + "node": ">= 10.0.0" + } + }, + "node_modules/binary-extensions": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz", + "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/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": "1.20.3", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.3.tgz", + "integrity": "sha512-7rAxByjUMqQ3/bHJy7D6OGXvx/MMc4IqBn/X0fcM1QUcAItpZrBEYhWGem+tzXH90c+G01ypMcYJBO9Y30203g==", + "license": "MIT", + "dependencies": { + "bytes": "3.1.2", + "content-type": "~1.0.5", + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "http-errors": "2.0.0", + "iconv-lite": "0.4.24", + "on-finished": "2.4.1", + "qs": "6.13.0", + "raw-body": "2.5.2", + "type-is": "~1.6.18", + "unpipe": "1.0.0" + }, + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/body-parser/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/body-parser/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/brace-expansion": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz", + "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==", + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0" + } + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/browserslist": { + "version": "4.28.1", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.1.tgz", + "integrity": "sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "peer": true, + "dependencies": { + "baseline-browser-mapping": "^2.9.0", + "caniuse-lite": "^1.0.30001759", + "electron-to-chromium": "^1.5.263", + "node-releases": "^2.0.27", + "update-browserslist-db": "^1.2.0" + }, + "bin": { + "browserslist": "cli.js" + }, + "engines": { + "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" + } + }, + "node_modules/bs-logger": { + "version": "0.2.6", + "resolved": "https://registry.npmjs.org/bs-logger/-/bs-logger-0.2.6.tgz", + "integrity": "sha512-pd8DCoxmbgc7hyPKOvxtqNcjYoOsABPQdcCUjGp3d42VR2CX1ORhk2A87oqqu5R1kk+76nsxZupkmyd+MVtCog==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-json-stable-stringify": "2.x" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/bser": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/bser/-/bser-2.1.1.tgz", + "integrity": "sha512-gQxTNE/GAfIIrmHLUE3oJyp5FO6HRBfhjnw4/wMmA63ZGDJnWBmgY/lyQBpnDUkGmAhbSe39tx2d/iTOAfglwQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "node-int64": "^0.4.0" + } + }, + "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-equal-constant-time": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz", + "integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==", + "license": "BSD-3-Clause" + }, + "node_modules/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==", + "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": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.8.tgz", + "integrity": "sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.0", + "es-define-property": "^1.0.0", + "get-intrinsic": "^1.2.4", + "set-function-length": "^1.2.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "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/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/camelcase": { + "version": "5.3.1", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz", + "integrity": "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/caniuse-lite": { + "version": "1.0.30001759", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001759.tgz", + "integrity": "sha512-Pzfx9fOKoKvevQf8oCXoyNRQ5QyxJj+3O0Rqx2V5oxT61KGx8+n6hV/IUyJeifUci2clnmmKVpvtiqRzgiWjSw==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/caniuse-lite" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "CC-BY-4.0" + }, + "node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "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": "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/chokidar": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz", + "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "anymatch": "~3.1.2", + "braces": "~3.0.2", + "glob-parent": "~5.1.2", + "is-binary-path": "~2.1.0", + "is-glob": "~4.0.1", + "normalize-path": "~3.0.0", + "readdirp": "~3.6.0" + }, + "engines": { + "node": ">= 8.10.0" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + }, + "optionalDependencies": { + "fsevents": "~2.3.2" + } + }, + "node_modules/chownr": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/chownr/-/chownr-2.0.0.tgz", + "integrity": "sha512-bIomtDF5KGpdogkLd9VspvFzk9KfpyyGlS8YFVZl7TGPBHL5snIOnxeshwVgPteQ9b4Eydl+pVbIyE1DcvCWgQ==", + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/chrome-trace-event": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/chrome-trace-event/-/chrome-trace-event-1.0.4.tgz", + "integrity": "sha512-rNjApaLzuwaOTjCiT8lSDdGN1APCiqkChLMJxJPWLunPAt5fy8xgU9/jNOchV84wfIxrA0lRQB7oCT8jrn/wrQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0" + } + }, + "node_modules/ci-info": { + "version": "3.9.0", + "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-3.9.0.tgz", + "integrity": "sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/sibiraj-s" + } + ], + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/cjs-module-lexer": { + "version": "1.4.3", + "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-1.4.3.tgz", + "integrity": "sha512-9z8TZaGM1pfswYeXrUpzPrkx8UnWYdhJclsiYMm6x/w5+nN+8Tf/LnAgfLGQCm59qAOxU8WwHEq2vNwF6i4j+Q==", + "dev": true, + "license": "MIT" + }, + "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", + "peer": true + }, + "node_modules/class-validator": { + "version": "0.14.3", + "resolved": "https://registry.npmjs.org/class-validator/-/class-validator-0.14.3.tgz", + "integrity": "sha512-rXXekcjofVN1LTOSw+u4u9WXVEUvNBVjORW154q/IdmYWy1nMbOU9aNtZB0t8m+FJQ9q91jlr2f9CwwUFdFMRA==", + "license": "MIT", + "peer": true, + "dependencies": { + "@types/validator": "^13.15.3", + "libphonenumber-js": "^1.11.1", + "validator": "^13.15.20" + } + }, + "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-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/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": "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/cliui": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz", + "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==", + "license": "ISC", + "dependencies": { + "string-width": "^4.2.0", + "strip-ansi": "^6.0.1", + "wrap-ansi": "^7.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/cliui/node_modules/wrap-ansi": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "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/co": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/co/-/co-4.6.0.tgz", + "integrity": "sha512-QVb0dM5HvG+uaxitm8wONl7jltx8dqhfU33DcqtOZcLSVIKSDDLDi7+0LbAKiyI8hD9u42m2YxXSkMGWThaecQ==", + "dev": true, + "license": "MIT", + "engines": { + "iojs": ">= 1.0.0", + "node": ">= 0.12.0" + } + }, + "node_modules/collect-v8-coverage": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/collect-v8-coverage/-/collect-v8-coverage-1.0.3.tgz", + "integrity": "sha512-1L5aqIkwPfiodaMgQunkF1zRhNqifHBmtbbbxcr6yVxxBnliw4TDOW6NxpO8DJLgJ16OT+Y4ztZqP6p/FtXnAw==", + "dev": true, + "license": "MIT" + }, + "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==", + "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==", + "license": "MIT" + }, + "node_modules/color-support": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/color-support/-/color-support-1.1.3.tgz", + "integrity": "sha512-qiBjkpbMLO/HL68y+lh4q0/O1MZFj2RX6X/KmMa3+gJD3z+WwI1ZzDHysvqHGS3mP6mznPckpXmw1nI9cJjyRg==", + "license": "ISC", + "bin": { + "color-support": "bin.js" + } + }, + "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": "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/comment-json": { + "version": "4.2.5", + "resolved": "https://registry.npmjs.org/comment-json/-/comment-json-4.2.5.tgz", + "integrity": "sha512-bKw/r35jR3HGt5PEPm1ljsQQGyCrR8sFGNiN5L+ykDHdpO8Smxkrkla9Yi6NkQyUrb8V54PGhfMs6NrIwtxtdw==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-timsort": "^1.0.3", + "core-util-is": "^1.0.3", + "esprima": "^4.0.1", + "has-own-prop": "^2.0.0", + "repeat-string": "^1.6.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/concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", + "license": "MIT" + }, + "node_modules/concat-stream": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-2.0.0.tgz", + "integrity": "sha512-MWufYdFw53ccGjCA+Ol7XJYpAlW6/prSMzuPOTRnJGcGzuhLn4Scrz7qf6o8bROZ514ltazcIFJZevcfbo0x7A==", + "engines": [ + "node >= 6.0" + ], + "license": "MIT", + "dependencies": { + "buffer-from": "^1.0.0", + "inherits": "^2.0.3", + "readable-stream": "^3.0.2", + "typedarray": "^0.0.6" + } + }, + "node_modules/consola": { + "version": "2.15.3", + "resolved": "https://registry.npmjs.org/consola/-/consola-2.15.3.tgz", + "integrity": "sha512-9vAdYbHj6x2fLKC4+oPH0kFzY/orMZyG2Aj+kNylHxKGJ/Ed4dpNyAQYwJOdqO4zdM7XpVHmyejQDcQHrnuXbw==", + "license": "MIT" + }, + "node_modules/console-control-strings": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/console-control-strings/-/console-control-strings-1.1.0.tgz", + "integrity": "sha512-ty/fTekppD2fIwRvnZAVdeOiGd1c7YXEixbgJTNzqcxJWKQnjJ/V1bNEEE6hygpM3WjwHFUVK6HTjWSzV4a8sQ==", + "license": "ISC" + }, + "node_modules/content-disposition": { + "version": "0.5.4", + "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz", + "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==", + "license": "MIT", + "dependencies": { + "safe-buffer": "5.2.1" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/content-type": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz", + "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/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.1", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.1.tgz", + "integrity": "sha512-6DnInpx7SJ2AK3+CTUE/ZM0vWTUboZCegxhC2xiIydHR9jNuTAASBrfEpHhiGOZw/nX51bHt6YQl8jsGo4y/0w==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/cookie-signature": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz", + "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==", + "license": "MIT" + }, + "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/core-util-is": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz", + "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/cors": { + "version": "2.8.5", + "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.5.tgz", + "integrity": "sha512-KIHbLJqu73RGr/hnbrO9uBeixNGuvSQjul/jdFvS/KFSIH1hWVd1ng7zOHx+YrEfInLG7q4n6GHQ9cDtxv/P6g==", + "license": "MIT", + "dependencies": { + "object-assign": "^4", + "vary": "^1" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/cosmiconfig": { + "version": "8.3.6", + "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-8.3.6.tgz", + "integrity": "sha512-kcZ6+W5QzcJ3P1Mt+83OUv/oHFqZHIx8DuxG6eZ5RGMERoLqp4BuGjhHLYGK+Kf5XVkQvqBSmAy/nGWN3qDgEA==", + "dev": true, + "license": "MIT", + "dependencies": { + "import-fresh": "^3.3.0", + "js-yaml": "^4.1.0", + "parse-json": "^5.2.0", + "path-type": "^4.0.0" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/d-fischer" + }, + "peerDependencies": { + "typescript": ">=4.9.5" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/create-jest": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/create-jest/-/create-jest-29.7.0.tgz", + "integrity": "sha512-Adz2bdH0Vq3F53KEMJOoftQFutWCukm6J24wbPWRO4k1kMY7gS7ds/uoJkNuV8wDCtWWnuwGcJwpWcih+zEW1Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/types": "^29.6.3", + "chalk": "^4.0.0", + "exit": "^0.1.2", + "graceful-fs": "^4.2.9", + "jest-config": "^29.7.0", + "jest-util": "^29.7.0", + "prompts": "^2.0.1" + }, + "bin": { + "create-jest": "bin/create-jest.js" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/create-require": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz", + "integrity": "sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==", + "devOptional": true, + "license": "MIT" + }, + "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/dayjs": { + "version": "1.11.19", + "resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.19.tgz", + "integrity": "sha512-t5EcLVS6QPBNqM2z8fakk/NKel+Xzshgt8FFKAn+qwlD1pzZWxh0nVCrvFK7ZDb6XucZeF9z8C7CBWTRIVApAw==", + "license": "MIT" + }, + "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/dedent": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.7.0.tgz", + "integrity": "sha512-HGFtf8yhuhGhqO07SV79tRp+br4MnbdjeVxotpn1QBl30pcLLCQjX5b2295ll0fv8RKDKsmWYrl05usHM9CewQ==", + "license": "MIT", + "peerDependencies": { + "babel-plugin-macros": "^3.1.0" + }, + "peerDependenciesMeta": { + "babel-plugin-macros": { + "optional": true + } + } + }, + "node_modules/deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/deepmerge": { + "version": "4.3.1", + "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz", + "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "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/define-data-property": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz", + "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==", + "license": "MIT", + "dependencies": { + "es-define-property": "^1.0.0", + "es-errors": "^1.3.0", + "gopd": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/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/delegates": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/delegates/-/delegates-1.0.0.tgz", + "integrity": "sha512-bd2L678uiWATM6m5Z1VzNCErI3jiGzt6HGY8OVICs40JQq/HALfbyNJmp0UDakEY4pMMaN0Ly5om/B1VI/+xfQ==", + "license": "MIT" + }, + "node_modules/depd": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz", + "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/destroy": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz", + "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==", + "license": "MIT", + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/detect-libc": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "license": "Apache-2.0", + "engines": { + "node": ">=8" + } + }, + "node_modules/detect-newline": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/detect-newline/-/detect-newline-3.1.0.tgz", + "integrity": "sha512-TLz+x/vEXm/Y7P7wn1EJFNLxYpUD4TgMosxY6fAVJUnJMbupHBOncxyWUG9OpTaH9EBD7uFI5LfEgmMOc54DsA==", + "dev": true, + "license": "MIT", + "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/diff": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz", + "integrity": "sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==", + "devOptional": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.3.1" + } + }, + "node_modules/diff-sequences": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-29.6.3.tgz", + "integrity": "sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/dir-glob": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz", + "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-type": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/doctrine": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-3.0.0.tgz", + "integrity": "sha512-yS+Q5i3hBf7GBkd4KG8a7eBNNWNGLTaEwwYWUijIYM7zrlYDM0BFXHjjPWlWZ1Rg7UaddZeIDmi9jF3HmqiQ2w==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "esutils": "^2.0.2" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/dotenv": { + "version": "16.4.5", + "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.4.5.tgz", + "integrity": "sha512-ZmdL2rui+eB2YwhsWzjInR8LldtZHGDoQ1ugH85ppHKwpUHL7j7rN0Ti9NCnGiQbhaZ11FpR+7ao1dNsmduNUg==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://dotenvx.com" + } + }, + "node_modules/dotenv-expand": { + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/dotenv-expand/-/dotenv-expand-10.0.0.tgz", + "integrity": "sha512-GopVGCpVS1UKH75VKHGuQFqS1Gusej0z4FyQkPdwjil2gNIv+LNsqBlboOzpJFZKVT95GkCyWJbBSdFEFUWI2A==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=12" + } + }, + "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/eastasianwidth": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz", + "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==", + "license": "MIT" + }, + "node_modules/ecdsa-sig-formatter": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/ecdsa-sig-formatter/-/ecdsa-sig-formatter-1.0.11.tgz", + "integrity": "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ==", + "license": "Apache-2.0", + "dependencies": { + "safe-buffer": "^5.0.1" + } + }, + "node_modules/ee-first": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", + "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==", + "license": "MIT" + }, + "node_modules/electron-to-chromium": { + "version": "1.5.267", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.267.tgz", + "integrity": "sha512-0Drusm6MVRXSOJpGbaSVgcQsuB4hEkMpHXaVstcPmhu5LIedxs1xNK/nIxmQIU/RPC0+1/o0AVZfBTkTNJOdUw==", + "dev": true, + "license": "ISC" + }, + "node_modules/emittery": { + "version": "0.13.1", + "resolved": "https://registry.npmjs.org/emittery/-/emittery-0.13.1.tgz", + "integrity": "sha512-DeWwawk6r5yR9jFgnDKYt4sLS0LmHJJi3ZOnb5/JdbYwj3nW+FxQnHIjhBKz8YLC7oRNPVM9NQ47I3CVx34eqQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sindresorhus/emittery?sponsor=1" + } + }, + "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==", + "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/enhanced-resolve": { + "version": "5.18.3", + "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.18.3.tgz", + "integrity": "sha512-d4lC8xfavMeBjzGr2vECC3fsGXziXZQyJxD868h2M/mBI3PwAuODxAkLkq5HYuvrPYcUtiLzsTo8U3PgX3Ocww==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.4", + "tapable": "^2.2.0" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/error-ex": { + "version": "1.3.4", + "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.4.tgz", + "integrity": "sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-arrayish": "^0.2.1" + } + }, + "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": "1.7.0", + "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.7.0.tgz", + "integrity": "sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==", + "dev": true, + "license": "MIT" + }, + "node_modules/es-object-atoms": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", + "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/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/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/escape-html": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", + "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==", + "license": "MIT" + }, + "node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint": { + "version": "8.57.1", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.57.1.tgz", + "integrity": "sha512-ypowyDxpVSYpkXr9WPv2PAZCtNip1Mv5KTW0SCurXv/9iOpcrH9PaqUElksqEB6pChqHGDRCFTyrZlGhnLNGiA==", + "deprecated": "This version is no longer supported. Please see https://eslint.org/version-support for other options.", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@eslint-community/eslint-utils": "^4.2.0", + "@eslint-community/regexpp": "^4.6.1", + "@eslint/eslintrc": "^2.1.4", + "@eslint/js": "8.57.1", + "@humanwhocodes/config-array": "^0.13.0", + "@humanwhocodes/module-importer": "^1.0.1", + "@nodelib/fs.walk": "^1.2.8", + "@ungap/structured-clone": "^1.2.0", + "ajv": "^6.12.4", + "chalk": "^4.0.0", + "cross-spawn": "^7.0.2", + "debug": "^4.3.2", + "doctrine": "^3.0.0", + "escape-string-regexp": "^4.0.0", + "eslint-scope": "^7.2.2", + "eslint-visitor-keys": "^3.4.3", + "espree": "^9.6.1", + "esquery": "^1.4.2", + "esutils": "^2.0.2", + "fast-deep-equal": "^3.1.3", + "file-entry-cache": "^6.0.1", + "find-up": "^5.0.0", + "glob-parent": "^6.0.2", + "globals": "^13.19.0", + "graphemer": "^1.4.0", + "ignore": "^5.2.0", + "imurmurhash": "^0.1.4", + "is-glob": "^4.0.0", + "is-path-inside": "^3.0.3", + "js-yaml": "^4.1.0", + "json-stable-stringify-without-jsonify": "^1.0.1", + "levn": "^0.4.1", + "lodash.merge": "^4.6.2", + "minimatch": "^3.1.2", + "natural-compare": "^1.4.0", + "optionator": "^0.9.3", + "strip-ansi": "^6.0.1", + "text-table": "^0.2.0" + }, + "bin": { + "eslint": "bin/eslint.js" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-config-prettier": { + "version": "9.1.2", + "resolved": "https://registry.npmjs.org/eslint-config-prettier/-/eslint-config-prettier-9.1.2.tgz", + "integrity": "sha512-iI1f+D2ViGn+uvv5HuHVUamg8ll4tN+JRHGc6IJi4TP9Kl976C57fzPXgseXNs8v0iA8aSJpHsTWjDb9QJamGQ==", + "dev": true, + "license": "MIT", + "peer": true, + "bin": { + "eslint-config-prettier": "bin/cli.js" + }, + "peerDependencies": { + "eslint": ">=7.0.0" + } + }, + "node_modules/eslint-plugin-prettier": { + "version": "5.5.4", + "resolved": "https://registry.npmjs.org/eslint-plugin-prettier/-/eslint-plugin-prettier-5.5.4.tgz", + "integrity": "sha512-swNtI95SToIz05YINMA6Ox5R057IMAmWZ26GqPxusAp1TZzj+IdY9tXNWWD3vkF/wEqydCONcwjTFpxybBqZsg==", + "dev": true, + "license": "MIT", + "dependencies": { + "prettier-linter-helpers": "^1.0.0", + "synckit": "^0.11.7" + }, + "engines": { + "node": "^14.18.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint-plugin-prettier" + }, + "peerDependencies": { + "@types/eslint": ">=8.0.0", + "eslint": ">=8.0.0", + "eslint-config-prettier": ">= 7.0.0 <10.0.0 || >=10.1.0", + "prettier": ">=3.0.0" + }, + "peerDependenciesMeta": { + "@types/eslint": { + "optional": true + }, + "eslint-config-prettier": { + "optional": true + } + } + }, + "node_modules/eslint-scope": { + "version": "7.2.2", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-7.2.2.tgz", + "integrity": "sha512-dOt21O7lTMhDM+X9mB4GX+DZrZtCUJPL/wlcTqxyrx5IvO0IYtILdtrQGQp+8n5S0gwSVmOf9NQrjMOgfQZlIg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^5.2.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint/node_modules/ajv": { + "version": "6.12.6", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", + "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/eslint/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/eslint/node_modules/glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/eslint/node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/eslint/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/espree": { + "version": "9.6.1", + "resolved": "https://registry.npmjs.org/espree/-/espree-9.6.1.tgz", + "integrity": "sha512-oruZaFkjorTpF32kDSI5/75ViwGeZginGGy2NoOSg3Q9bnwlnmDm4HLnkl0RE3n+njDXR037aY1+x58Z/zFdwQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.9.0", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^3.4.1" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "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/esquery": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", + "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "estraverse": "^5.1.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "estraverse": "^5.2.0" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/etag": { + "version": "1.8.1", + "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", + "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/events": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz", + "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.x" + } + }, + "node_modules/execa": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz", + "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==", + "dev": true, + "license": "MIT", + "dependencies": { + "cross-spawn": "^7.0.3", + "get-stream": "^6.0.0", + "human-signals": "^2.1.0", + "is-stream": "^2.0.0", + "merge-stream": "^2.0.0", + "npm-run-path": "^4.0.1", + "onetime": "^5.1.2", + "signal-exit": "^3.0.3", + "strip-final-newline": "^2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/execa/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/exit": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz", + "integrity": "sha512-Zk/eNKV2zbjpKzrsQ+n1G6poVbErQxJ0LBOJXaKZ1EViLzH+hrLu9cdXI4zw9dBQJslwBEpbQ2P1oS7nDxs6jQ==", + "dev": true, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/expect": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/expect/-/expect-29.7.0.tgz", + "integrity": "sha512-2Zks0hf1VLFYI1kbh0I5jP3KHHyCHpkfyHBzsSXRFgl/Bg9mWYfMW8oD+PdMPlEwy5HNsR9JutYy6pMeOh61nw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/expect-utils": "^29.7.0", + "jest-get-type": "^29.6.3", + "jest-matcher-utils": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-util": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/express": { + "version": "4.21.2", + "resolved": "https://registry.npmjs.org/express/-/express-4.21.2.tgz", + "integrity": "sha512-28HqgMZAmih1Czt9ny7qr6ek2qddF4FclbMzwhCREB6OFfH+rXAnuNCwo1/wFvrtbgsQDb4kSbX9de9lFbrXnA==", + "license": "MIT", + "dependencies": { + "accepts": "~1.3.8", + "array-flatten": "1.1.1", + "body-parser": "1.20.3", + "content-disposition": "0.5.4", + "content-type": "~1.0.4", + "cookie": "0.7.1", + "cookie-signature": "1.0.6", + "debug": "2.6.9", + "depd": "2.0.0", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "finalhandler": "1.3.1", + "fresh": "0.5.2", + "http-errors": "2.0.0", + "merge-descriptors": "1.0.3", + "methods": "~1.1.2", + "on-finished": "2.4.1", + "parseurl": "~1.3.3", + "path-to-regexp": "0.1.12", + "proxy-addr": "~2.0.7", + "qs": "6.13.0", + "range-parser": "~1.2.1", + "safe-buffer": "5.2.1", + "send": "0.19.0", + "serve-static": "1.16.2", + "setprototypeof": "1.2.0", + "statuses": "2.0.1", + "type-is": "~1.6.18", + "utils-merge": "1.0.1", + "vary": "~1.1.2" + }, + "engines": { + "node": ">= 0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/express/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/express/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/express/node_modules/path-to-regexp": { + "version": "0.1.12", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.12.tgz", + "integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==", + "license": "MIT" + }, + "node_modules/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/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-diff": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/fast-diff/-/fast-diff-1.3.0.tgz", + "integrity": "sha512-VxPP4NqbUjj6MaAOafWeUn2cXWLcCtljklUtZf0Ind4XQ+QPtmA0b18zZy0jIQx+ExRVCR/ZQpBmik5lXshNsw==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/fast-glob": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz", + "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "^2.0.2", + "@nodelib/fs.walk": "^1.2.3", + "glob-parent": "^5.1.2", + "merge2": "^1.3.0", + "micromatch": "^4.0.8" + }, + "engines": { + "node": ">=8.6.0" + } + }, + "node_modules/fast-json-stable-stringify": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", + "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", + "dev": true, + "license": "MIT" + }, + "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/fastq": { + "version": "1.19.1", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz", + "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "reusify": "^1.0.4" + } + }, + "node_modules/fb-watchman": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/fb-watchman/-/fb-watchman-2.0.2.tgz", + "integrity": "sha512-p5161BqbuCaSnB8jIbzQHOlpgsPmK5rJVDfDKO91Axs5NC1uu3HRQm6wt9cd9/+GtQQIO53JdGXXoyDpTAsgYA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "bser": "2.1.1" + } + }, + "node_modules/fflate": { + "version": "0.8.2", + "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.2.tgz", + "integrity": "sha512-cPJU47OaAoCbg0pBvzsgpTPhmhqI5eJjh/JIu8tPj5q+T7iLvW/JAYUqmE7KOB4R1ZyEhzBaIQpQpardBF5z8A==", + "license": "MIT" + }, + "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/figures/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/file-entry-cache": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-6.0.1.tgz", + "integrity": "sha512-7Gps/XWymbLk2QLYK4NzpMOrYjMhdIxXuIvy2QBsLE6ljuodKvdkWs/cpyJJ3CVIVpH0Oi1Hvg1ovbMzLdFBBg==", + "dev": true, + "license": "MIT", + "dependencies": { + "flat-cache": "^3.0.4" + }, + "engines": { + "node": "^10.12.0 || >=12.0.0" + } + }, + "node_modules/file-type": { + "version": "20.4.1", + "resolved": "https://registry.npmjs.org/file-type/-/file-type-20.4.1.tgz", + "integrity": "sha512-hw9gNZXUfZ02Jo0uafWLaFVPter5/k2rfcrjFJJHX/77xtSDOfJuEFb6oKlFV86FLP1SuyHMW1PSk0U9M5tKkQ==", + "license": "MIT", + "dependencies": { + "@tokenizer/inflate": "^0.2.6", + "strtok3": "^10.2.0", + "token-types": "^6.0.0", + "uint8array-extras": "^1.4.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sindresorhus/file-type?sponsor=1" + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/finalhandler": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.1.tgz", + "integrity": "sha512-6BN9trH7bp3qvnrRyzsBz+g3lZxTNZTbVO2EV1CS0WIcDbawYVdYvGflME/9QP0h0pYlCDBCTjYa9nZzMDpyxQ==", + "license": "MIT", + "dependencies": { + "debug": "2.6.9", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "on-finished": "2.4.1", + "parseurl": "~1.3.3", + "statuses": "2.0.1", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/finalhandler/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/finalhandler/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^6.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/flat-cache": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-3.2.0.tgz", + "integrity": "sha512-CYcENa+FtcUKLmhhqyctpclsq7QF38pKjZHsGNiSQF5r4FtoKDWabFDl3hzaEQMvT1LHEysw5twgLvpYYb4vbw==", + "dev": true, + "license": "MIT", + "dependencies": { + "flatted": "^3.2.9", + "keyv": "^4.5.3", + "rimraf": "^3.0.2" + }, + "engines": { + "node": "^10.12.0 || >=12.0.0" + } + }, + "node_modules/flatted": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz", + "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==", + "dev": true, + "license": "ISC" + }, + "node_modules/for-each": { + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/for-each/-/for-each-0.3.5.tgz", + "integrity": "sha512-dKx12eRCVIzqCxFGplyFKJMPvLEWgmNtUrpTiJIR5u97zEhRG8ySrtboPHZXx7daLxQVrl643cTzbab2tkQjxg==", + "license": "MIT", + "dependencies": { + "is-callable": "^1.2.7" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/foreground-child": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz", + "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==", + "license": "ISC", + "dependencies": { + "cross-spawn": "^7.0.6", + "signal-exit": "^4.0.1" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/fork-ts-checker-webpack-plugin": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/fork-ts-checker-webpack-plugin/-/fork-ts-checker-webpack-plugin-9.0.2.tgz", + "integrity": "sha512-Uochze2R8peoN1XqlSi/rGUkDQpRogtLFocP9+PGu68zk1BDAKXfdeCdyVZpgTk8V8WFVQXdEz426VKjXLO1Gg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.16.7", + "chalk": "^4.1.2", + "chokidar": "^3.5.3", + "cosmiconfig": "^8.2.0", + "deepmerge": "^4.2.2", + "fs-extra": "^10.0.0", + "memfs": "^3.4.1", + "minimatch": "^3.0.4", + "node-abort-controller": "^3.0.1", + "schema-utils": "^3.1.1", + "semver": "^7.3.5", + "tapable": "^2.2.1" + }, + "engines": { + "node": ">=12.13.0", + "yarn": ">=1.0.0" + }, + "peerDependencies": { + "typescript": ">3.6.0", + "webpack": "^5.11.0" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/form-data": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz", + "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==", + "dev": true, + "license": "MIT", + "dependencies": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.8", + "es-set-tostringtag": "^2.1.0", + "hasown": "^2.0.2", + "mime-types": "^2.1.12" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/formidable": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/formidable/-/formidable-2.1.5.tgz", + "integrity": "sha512-Oz5Hwvwak/DCaXVVUtPn4oLMLLy1CdclLKO1LFgU7XzDpVMUU5UjlSLpGMocyQNNk8F6IJW9M/YdooSn2MRI+Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@paralleldrive/cuid2": "^2.2.2", + "dezalgo": "^1.0.4", + "once": "^1.4.0", + "qs": "^6.11.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": "0.5.2", + "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz", + "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/fs-extra": { + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz", + "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.0", + "jsonfile": "^6.0.1", + "universalify": "^2.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/fs-minipass": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fs-minipass/-/fs-minipass-2.1.0.tgz", + "integrity": "sha512-V/JgOLFCS+R6Vcq0slCuaeWEdNC3ouDlJMNIsacH2VtALiu9mV4LPrHc5cDl8k5aw6J8jwgWWpiTo5RYhmIzvg==", + "license": "ISC", + "dependencies": { + "minipass": "^3.0.0" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/fs-minipass/node_modules/minipass": { + "version": "3.3.6", + "resolved": "https://registry.npmjs.org/minipass/-/minipass-3.3.6.tgz", + "integrity": "sha512-DxiNidxSEK+tHG6zOIklvNOwm3hvCrbUrdtzY74U6HKTJxvIDfOUL5W5P2Ghd3DTkhhKPYGqeNUIh5qcM4YBfw==", + "license": "ISC", + "dependencies": { + "yallist": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/fs-minipass/node_modules/yallist": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", + "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==", + "license": "ISC" + }, + "node_modules/fs-monkey": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/fs-monkey/-/fs-monkey-1.1.0.tgz", + "integrity": "sha512-QMUezzXWII9EV5aTFXW1UBVUO77wYPpjqIF8/AviUCThNeSYZykpoTixUeaNNBwmCev0AMDWMAni+f8Hxb1IFw==", + "dev": true, + "license": "Unlicense" + }, + "node_modules/fs.realpath": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", + "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", + "license": "ISC" + }, + "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/gauge": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/gauge/-/gauge-3.0.2.tgz", + "integrity": "sha512-+5J6MS/5XksCuXq++uFRsnUd7Ovu1XenbeuIuNRJxYWjgQbPuFhT14lAvsWfqfAmnwluf1OwMjz39HjfLPci0Q==", + "deprecated": "This package is no longer supported.", + "license": "ISC", + "dependencies": { + "aproba": "^1.0.3 || ^2.0.0", + "color-support": "^1.1.2", + "console-control-strings": "^1.0.0", + "has-unicode": "^2.0.1", + "object-assign": "^4.1.1", + "signal-exit": "^3.0.0", + "string-width": "^4.2.3", + "strip-ansi": "^6.0.1", + "wide-align": "^1.1.2" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/gauge/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==", + "license": "ISC" + }, + "node_modules/gensync": { + "version": "1.0.0-beta.2", + "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz", + "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, + "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-package-type": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/get-package-type/-/get-package-type-0.1.0.tgz", + "integrity": "sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.0.0" + } + }, + "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/get-stream": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz", + "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/glob": { + "version": "10.4.5", + "resolved": "https://registry.npmjs.org/glob/-/glob-10.4.5.tgz", + "integrity": "sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg==", + "dev": true, + "license": "ISC", + "dependencies": { + "foreground-child": "^3.1.0", + "jackspeak": "^3.1.2", + "minimatch": "^9.0.4", + "minipass": "^7.1.2", + "package-json-from-dist": "^1.0.0", + "path-scurry": "^1.11.1" + }, + "bin": { + "glob": "dist/esm/bin.mjs" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/glob-to-regexp": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/glob-to-regexp/-/glob-to-regexp-0.4.1.tgz", + "integrity": "sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==", + "dev": true, + "license": "BSD-2-Clause" + }, + "node_modules/glob/node_modules/minimatch": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz", + "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.1" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/globals": { + "version": "13.24.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-13.24.0.tgz", + "integrity": "sha512-AhO5QUcj8llrbG09iWhPU2B204J1xnPeL8kQmVorSsy+Sjj1sk8gIyh6cUocGmH4L0UuhAJy+hJMRA4mgA4mFQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "type-fest": "^0.20.2" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/globby": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/globby/-/globby-11.1.0.tgz", + "integrity": "sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-union": "^2.1.0", + "dir-glob": "^3.0.1", + "fast-glob": "^3.2.9", + "ignore": "^5.2.0", + "merge2": "^1.4.1", + "slash": "^3.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "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/graceful-fs": { + "version": "4.2.11", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", + "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/graphemer": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz", + "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==", + "dev": true, + "license": "MIT" + }, + "node_modules/handlebars": { + "version": "4.7.8", + "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz", + "integrity": "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "minimist": "^1.2.5", + "neo-async": "^2.6.2", + "source-map": "^0.6.1", + "wordwrap": "^1.0.0" + }, + "bin": { + "handlebars": "bin/handlebars" + }, + "engines": { + "node": ">=0.4.7" + }, + "optionalDependencies": { + "uglify-js": "^3.1.4" + } + }, + "node_modules/handlebars/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/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/has-own-prop": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/has-own-prop/-/has-own-prop-2.0.0.tgz", + "integrity": "sha512-Pq0h+hvsVm6dDEa8x82GnLSYHOzNDt7f0ddFa3FqcQlgzEiptPqL+XrOJNavjOzSYiYWIrgeVYYgGlLmnxwilQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/has-property-descriptors": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz", + "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==", + "license": "MIT", + "dependencies": { + "es-define-property": "^1.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "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==", + "license": "MIT", + "dependencies": { + "has-symbols": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-unicode": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/has-unicode/-/has-unicode-2.0.1.tgz", + "integrity": "sha512-8Rf9Y83NBReMnx0gFzA8JImQACstCYWUplepDa9xprwwtmgEZUF0h/i5xSA625zB/I37EtrswSST6OXxwaaIJQ==", + "license": "ISC" + }, + "node_modules/hasown": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", + "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/helmet": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/helmet/-/helmet-7.2.0.tgz", + "integrity": "sha512-ZRiwvN089JfMXokizgqEPXsl2Guk094yExfoDXR0cBYWxtBbaSww/w+vT4WEJsBW2iTUi1GgZ6swmoug3Oy4Xw==", + "license": "MIT", + "engines": { + "node": ">=16.0.0" + } + }, + "node_modules/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.0", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz", + "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==", + "license": "MIT", + "dependencies": { + "depd": "2.0.0", + "inherits": "2.0.4", + "setprototypeof": "1.2.0", + "statuses": "2.0.1", + "toidentifier": "1.0.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/https-proxy-agent": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz", + "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==", + "license": "MIT", + "dependencies": { + "agent-base": "6", + "debug": "4" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/human-signals": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz", + "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=10.17.0" + } + }, + "node_modules/iconv-lite": { + "version": "0.4.24", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz", + "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==", + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/ieee754": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", + "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/import-local": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.2.0.tgz", + "integrity": "sha512-2SPlun1JUPWoM6t3F0dw0FkCF/jWY8kttcY4f599GLTSjh2OCuuhdTkJQsEcZzBqbXZGKMK2OqW1oZsjtf/gQA==", + "dev": true, + "license": "MIT", + "dependencies": { + "pkg-dir": "^4.2.0", + "resolve-cwd": "^3.0.0" + }, + "bin": { + "import-local-fixture": "fixtures/cli.js" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.19" + } + }, + "node_modules/inflight": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", + "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", + "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.", + "license": "ISC", + "dependencies": { + "once": "^1.3.0", + "wrappy": "1" + } + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "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/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-arrayish": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz", + "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==", + "dev": true, + "license": "MIT" + }, + "node_modules/is-binary-path": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz", + "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==", + "dev": true, + "license": "MIT", + "dependencies": { + "binary-extensions": "^2.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/is-callable": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/is-callable/-/is-callable-1.2.7.tgz", + "integrity": "sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-core-module": { + "version": "2.16.1", + "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz", + "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==", + "dev": true, + "license": "MIT", + "dependencies": { + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-generator-fn": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-generator-fn/-/is-generator-fn-2.1.0.tgz", + "integrity": "sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-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/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/is-path-inside": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/is-path-inside/-/is-path-inside-3.0.3.tgz", + "integrity": "sha512-Fd4gABb+ycGAmKou8eMftCupSir5lRxqf4aD/vd0cD2qc4HL07OjCeuHMr8Ro4CoMaeCKDB0/ECBOVWjTwUvPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-stream": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz", + "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-typed-array": { + "version": "1.1.15", + "resolved": "https://registry.npmjs.org/is-typed-array/-/is-typed-array-1.1.15.tgz", + "integrity": "sha512-p3EcsicXjit7SaskXHs1hA91QxgTw46Fv6EFKKGS5DRFLD8yKnohjF3hxoju94b/OcMZoQukzpPpBE9uLVKzgQ==", + "license": "MIT", + "dependencies": { + "which-typed-array": "^1.1.16" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "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/isarray": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz", + "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==", + "license": "MIT" + }, + "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", + "integrity": "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=8" + } + }, + "node_modules/istanbul-lib-instrument": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-6.0.3.tgz", + "integrity": "sha512-Vtgk7L/R2JHyyGW07spoFlB8/lpjiOLTjMdms6AFMraYt3BaJauod/NGrfnVG/y4Ix1JEuMRPDPEj2ua+zz1/Q==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@babel/core": "^7.23.9", + "@babel/parser": "^7.23.9", + "@istanbuljs/schema": "^0.1.3", + "istanbul-lib-coverage": "^3.2.0", + "semver": "^7.5.4" + }, + "engines": { + "node": ">=10" + } + }, + "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-lib-report/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/istanbul-lib-source-maps": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/istanbul-lib-source-maps/-/istanbul-lib-source-maps-4.0.1.tgz", + "integrity": "sha512-n3s8EwkdFIJCG3BPKBYvskgXGoy88ARzvegkitk60NxRdwltLOTaH7CUiMRXvwYorl0Q712iEjcWB+fK/MrWVw==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "debug": "^4.1.1", + "istanbul-lib-coverage": "^3.0.0", + "source-map": "^0.6.1" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/istanbul-lib-source-maps/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/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/jackspeak": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz", + "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==", + "license": "BlueOak-1.0.0", + "dependencies": { + "@isaacs/cliui": "^8.0.2" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + }, + "optionalDependencies": { + "@pkgjs/parseargs": "^0.11.0" + } + }, + "node_modules/jest": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest/-/jest-29.7.0.tgz", + "integrity": "sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/core": "^29.7.0", + "@jest/types": "^29.6.3", + "import-local": "^3.0.2", + "jest-cli": "^29.7.0" + }, + "bin": { + "jest": "bin/jest.js" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/jest-changed-files": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-changed-files/-/jest-changed-files-29.7.0.tgz", + "integrity": "sha512-fEArFiwf1BpQ+4bXSprcDc3/x4HSzL4al2tozwVpDFpsxALjLYdyiIK4e5Vz66GQJIbXJ82+35PtysofptNX2w==", + "dev": true, + "license": "MIT", + "dependencies": { + "execa": "^5.0.0", + "jest-util": "^29.7.0", + "p-limit": "^3.1.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-circus": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-circus/-/jest-circus-29.7.0.tgz", + "integrity": "sha512-3E1nCMgipcTkCocFwM90XXQab9bS+GMsjdpmPrlelaxwD93Ad8iVEjX/vvHPdLPnFf+L40u+5+iutRdA1N9myw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/environment": "^29.7.0", + "@jest/expect": "^29.7.0", + "@jest/test-result": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "chalk": "^4.0.0", + "co": "^4.6.0", + "dedent": "^1.0.0", + "is-generator-fn": "^2.0.0", + "jest-each": "^29.7.0", + "jest-matcher-utils": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-runtime": "^29.7.0", + "jest-snapshot": "^29.7.0", + "jest-util": "^29.7.0", + "p-limit": "^3.1.0", + "pretty-format": "^29.7.0", + "pure-rand": "^6.0.0", + "slash": "^3.0.0", + "stack-utils": "^2.0.3" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-cli": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-cli/-/jest-cli-29.7.0.tgz", + "integrity": "sha512-OVVobw2IubN/GSYsxETi+gOe7Ka59EFMR/twOU3Jb2GnKKeMGJB5SGUUrEz3SFVmJASUdZUzy83sLNNQ2gZslg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/core": "^29.7.0", + "@jest/test-result": "^29.7.0", + "@jest/types": "^29.6.3", + "chalk": "^4.0.0", + "create-jest": "^29.7.0", + "exit": "^0.1.2", + "import-local": "^3.0.2", + "jest-config": "^29.7.0", + "jest-util": "^29.7.0", + "jest-validate": "^29.7.0", + "yargs": "^17.3.1" + }, + "bin": { + "jest": "bin/jest.js" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/jest-config": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-config/-/jest-config-29.7.0.tgz", + "integrity": "sha512-uXbpfeQ7R6TZBqI3/TxCU4q4ttk3u0PJeC+E0zbfSoSjq6bJ7buBPxzQPL0ifrkY4DNu4JUdk0ImlBUYi840eQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/core": "^7.11.6", + "@jest/test-sequencer": "^29.7.0", + "@jest/types": "^29.6.3", + "babel-jest": "^29.7.0", + "chalk": "^4.0.0", + "ci-info": "^3.2.0", + "deepmerge": "^4.2.2", + "glob": "^7.1.3", + "graceful-fs": "^4.2.9", + "jest-circus": "^29.7.0", + "jest-environment-node": "^29.7.0", + "jest-get-type": "^29.6.3", + "jest-regex-util": "^29.6.3", + "jest-resolve": "^29.7.0", + "jest-runner": "^29.7.0", + "jest-util": "^29.7.0", + "jest-validate": "^29.7.0", + "micromatch": "^4.0.4", + "parse-json": "^5.2.0", + "pretty-format": "^29.7.0", + "slash": "^3.0.0", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "@types/node": "*", + "ts-node": ">=9.0.0" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "ts-node": { + "optional": true + } + } + }, + "node_modules/jest-config/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/jest-config/node_modules/glob": { + "version": "7.2.3", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", + "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "deprecated": "Glob versions prior to v9 are no longer supported", + "dev": true, + "license": "ISC", + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/jest-config/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/jest-diff": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-diff/-/jest-diff-29.7.0.tgz", + "integrity": "sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^4.0.0", + "diff-sequences": "^29.6.3", + "jest-get-type": "^29.6.3", + "pretty-format": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-docblock": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-docblock/-/jest-docblock-29.7.0.tgz", + "integrity": "sha512-q617Auw3A612guyaFgsbFeYpNP5t2aoUNLwBUbc/0kD1R4t9ixDbyFTHd1nok4epoVFpr7PmeWHrhvuV3XaJ4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "detect-newline": "^3.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-each": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-each/-/jest-each-29.7.0.tgz", + "integrity": "sha512-gns+Er14+ZrEoC5fhOfYCY1LOHHr0TI+rQUHZS8Ttw2l7gl+80eHc/gFf2Ktkw0+SIACDTeWvpFcv3B04VembQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/types": "^29.6.3", + "chalk": "^4.0.0", + "jest-get-type": "^29.6.3", + "jest-util": "^29.7.0", + "pretty-format": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-environment-node": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-environment-node/-/jest-environment-node-29.7.0.tgz", + "integrity": "sha512-DOSwCRqXirTOyheM+4d5YZOrWcdu0LNZ87ewUoywbcb2XR4wKgqiG8vNeYwhjFMbEkfju7wx2GYH0P2gevGvFw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/environment": "^29.7.0", + "@jest/fake-timers": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "jest-mock": "^29.7.0", + "jest-util": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-get-type": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/jest-get-type/-/jest-get-type-29.6.3.tgz", + "integrity": "sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-haste-map": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-haste-map/-/jest-haste-map-29.7.0.tgz", + "integrity": "sha512-fP8u2pyfqx0K1rGn1R9pyE0/KTn+G7PxktWidOBTqFPLYX0b9ksaMFkhK5vrS3DVun09pckLdlx90QthlW7AmA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/types": "^29.6.3", + "@types/graceful-fs": "^4.1.3", + "@types/node": "*", + "anymatch": "^3.0.3", + "fb-watchman": "^2.0.0", + "graceful-fs": "^4.2.9", + "jest-regex-util": "^29.6.3", + "jest-util": "^29.7.0", + "jest-worker": "^29.7.0", + "micromatch": "^4.0.4", + "walker": "^1.0.8" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "optionalDependencies": { + "fsevents": "^2.3.2" + } + }, + "node_modules/jest-leak-detector": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-leak-detector/-/jest-leak-detector-29.7.0.tgz", + "integrity": "sha512-kYA8IJcSYtST2BY9I+SMC32nDpBT3J2NvWJx8+JCuCdl/CR1I4EKUJROiP8XtCcxqgTTBGJNdbB1A8XRKbTetw==", + "dev": true, + "license": "MIT", + "dependencies": { + "jest-get-type": "^29.6.3", + "pretty-format": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-matcher-utils": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-matcher-utils/-/jest-matcher-utils-29.7.0.tgz", + "integrity": "sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^4.0.0", + "jest-diff": "^29.7.0", + "jest-get-type": "^29.6.3", + "pretty-format": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-message-util": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-message-util/-/jest-message-util-29.7.0.tgz", + "integrity": "sha512-GBEV4GRADeP+qtB2+6u61stea8mGcOT4mCtrYISZwfu9/ISHFJ/5zOMXYbpBE9RsS5+Gb63DW4FgmnKJ79Kf6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.12.13", + "@jest/types": "^29.6.3", + "@types/stack-utils": "^2.0.0", + "chalk": "^4.0.0", + "graceful-fs": "^4.2.9", + "micromatch": "^4.0.4", + "pretty-format": "^29.7.0", + "slash": "^3.0.0", + "stack-utils": "^2.0.3" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-mock": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-mock/-/jest-mock-29.7.0.tgz", + "integrity": "sha512-ITOMZn+UkYS4ZFh83xYAOzWStloNzJFO2s8DWrE4lhtGD+AorgnbkiKERe4wQVBydIGPx059g6riW5Btp6Llnw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/types": "^29.6.3", + "@types/node": "*", + "jest-util": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-pnp-resolver": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/jest-pnp-resolver/-/jest-pnp-resolver-1.2.3.tgz", + "integrity": "sha512-+3NpwQEnRoIBtx4fyhblQDPgJI0H1IEIkX7ShLUjPGA7TtUTvI1oiKi3SR4oBR0hQhQR80l4WAe5RrXBwWMA8w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + }, + "peerDependencies": { + "jest-resolve": "*" + }, + "peerDependenciesMeta": { + "jest-resolve": { + "optional": true + } + } + }, + "node_modules/jest-regex-util": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/jest-regex-util/-/jest-regex-util-29.6.3.tgz", + "integrity": "sha512-KJJBsRCyyLNWCNBOvZyRDnAIfUiRJ8v+hOBQYGn8gDyF3UegwiP4gwRR3/SDa42g1YbVycTidUF3rKjyLFDWbg==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-resolve": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-resolve/-/jest-resolve-29.7.0.tgz", + "integrity": "sha512-IOVhZSrg+UvVAshDSDtHyFCCBUl/Q3AAJv8iZ6ZjnZ74xzvwuzLXid9IIIPgTnY62SJjfuupMKZsZQRsCvxEgA==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^4.0.0", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^29.7.0", + "jest-pnp-resolver": "^1.2.2", + "jest-util": "^29.7.0", + "jest-validate": "^29.7.0", + "resolve": "^1.20.0", + "resolve.exports": "^2.0.0", + "slash": "^3.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-resolve-dependencies": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-resolve-dependencies/-/jest-resolve-dependencies-29.7.0.tgz", + "integrity": "sha512-un0zD/6qxJ+S0et7WxeI3H5XSe9lTBBR7bOHCHXkKR6luG5mwDDlIzVQ0V5cZCuoTgEdcdwzTghYkTWfubi+nA==", + "dev": true, + "license": "MIT", + "dependencies": { + "jest-regex-util": "^29.6.3", + "jest-snapshot": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-runner": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-runner/-/jest-runner-29.7.0.tgz", + "integrity": "sha512-fsc4N6cPCAahybGBfTRcq5wFR6fpLznMg47sY5aDpsoejOcVYFb07AHuSnR0liMcPTgBsA3ZJL6kFOjPdoNipQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/console": "^29.7.0", + "@jest/environment": "^29.7.0", + "@jest/test-result": "^29.7.0", + "@jest/transform": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "chalk": "^4.0.0", + "emittery": "^0.13.1", + "graceful-fs": "^4.2.9", + "jest-docblock": "^29.7.0", + "jest-environment-node": "^29.7.0", + "jest-haste-map": "^29.7.0", + "jest-leak-detector": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-resolve": "^29.7.0", + "jest-runtime": "^29.7.0", + "jest-util": "^29.7.0", + "jest-watcher": "^29.7.0", + "jest-worker": "^29.7.0", + "p-limit": "^3.1.0", + "source-map-support": "0.5.13" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-runner/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/jest-runner/node_modules/source-map-support": { + "version": "0.5.13", + "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.13.tgz", + "integrity": "sha512-SHSKFHadjVA5oR4PPqhtAVdcBWwRYVd6g6cAXnIbRiIwc2EhPrTuKUBdSLvlEKyIP3GCf89fltvcZiP9MMFA1w==", + "dev": true, + "license": "MIT", + "dependencies": { + "buffer-from": "^1.0.0", + "source-map": "^0.6.0" + } + }, + "node_modules/jest-runtime": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-runtime/-/jest-runtime-29.7.0.tgz", + "integrity": "sha512-gUnLjgwdGqW7B4LvOIkbKs9WGbn+QLqRQQ9juC6HndeDiezIwhDP+mhMwHWCEcfQ5RUXa6OPnFF8BJh5xegwwQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/environment": "^29.7.0", + "@jest/fake-timers": "^29.7.0", + "@jest/globals": "^29.7.0", + "@jest/source-map": "^29.6.3", + "@jest/test-result": "^29.7.0", + "@jest/transform": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "chalk": "^4.0.0", + "cjs-module-lexer": "^1.0.0", + "collect-v8-coverage": "^1.0.0", + "glob": "^7.1.3", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-mock": "^29.7.0", + "jest-regex-util": "^29.6.3", + "jest-resolve": "^29.7.0", + "jest-snapshot": "^29.7.0", + "jest-util": "^29.7.0", + "slash": "^3.0.0", + "strip-bom": "^4.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-runtime/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/jest-runtime/node_modules/glob": { + "version": "7.2.3", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", + "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "deprecated": "Glob versions prior to v9 are no longer supported", + "dev": true, + "license": "ISC", + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/jest-runtime/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/jest-snapshot": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-snapshot/-/jest-snapshot-29.7.0.tgz", + "integrity": "sha512-Rm0BMWtxBcioHr1/OX5YCP8Uov4riHvKPknOGs804Zg9JGZgmIBkbtlxJC/7Z4msKYVbIJtfU+tKb8xlYNfdkw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/core": "^7.11.6", + "@babel/generator": "^7.7.2", + "@babel/plugin-syntax-jsx": "^7.7.2", + "@babel/plugin-syntax-typescript": "^7.7.2", + "@babel/types": "^7.3.3", + "@jest/expect-utils": "^29.7.0", + "@jest/transform": "^29.7.0", + "@jest/types": "^29.6.3", + "babel-preset-current-node-syntax": "^1.0.0", + "chalk": "^4.0.0", + "expect": "^29.7.0", + "graceful-fs": "^4.2.9", + "jest-diff": "^29.7.0", + "jest-get-type": "^29.6.3", + "jest-matcher-utils": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-util": "^29.7.0", + "natural-compare": "^1.4.0", + "pretty-format": "^29.7.0", + "semver": "^7.5.3" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-util": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-util/-/jest-util-29.7.0.tgz", + "integrity": "sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/types": "^29.6.3", + "@types/node": "*", + "chalk": "^4.0.0", + "ci-info": "^3.2.0", + "graceful-fs": "^4.2.9", + "picomatch": "^2.2.3" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-util/node_modules/picomatch": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/jest-validate": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-validate/-/jest-validate-29.7.0.tgz", + "integrity": "sha512-ZB7wHqaRGVw/9hST/OuFUReG7M8vKeq0/J2egIGLdvjHCmYqGARhzXmtgi+gVeZ5uXFF219aOc3Ls2yLg27tkw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/types": "^29.6.3", + "camelcase": "^6.2.0", + "chalk": "^4.0.0", + "jest-get-type": "^29.6.3", + "leven": "^3.1.0", + "pretty-format": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-validate/node_modules/camelcase": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz", + "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/jest-watcher": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-watcher/-/jest-watcher-29.7.0.tgz", + "integrity": "sha512-49Fg7WXkU3Vl2h6LbLtMQ/HyB6rXSIX7SqvBLQmssRBGN9I0PNvPmAmCWSOY6SOvrjhI/F7/bGAv9RtnsPA03g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/test-result": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "ansi-escapes": "^4.2.1", + "chalk": "^4.0.0", + "emittery": "^0.13.1", + "jest-util": "^29.7.0", + "string-length": "^4.0.1" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-worker": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-29.7.0.tgz", + "integrity": "sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*", + "jest-util": "^29.7.0", + "merge-stream": "^2.0.0", + "supports-color": "^8.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-worker/node_modules/supports-color": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz", + "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/js-yaml": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", + "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/jsesc": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz", + "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==", + "dev": true, + "license": "MIT", + "bin": { + "jsesc": "bin/jsesc" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/json-buffer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", + "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-parse-even-better-errors": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", + "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", + "dev": true, + "license": "MIT" + }, + "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==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "dev": true, + "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.2.1", + "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-3.2.1.tgz", + "integrity": "sha512-AilxAyFOAcK5wA1+LeaySVBrHsGQvUFCDWXKpZjzaL0PqW+xfBOttn8GNtWKFWqneyMZj41MWF9Kl6iPWLwgOA==", + "dev": true, + "license": "MIT" + }, + "node_modules/jsonfile": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.0.tgz", + "integrity": "sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg==", + "dev": true, + "license": "MIT", + "dependencies": { + "universalify": "^2.0.0" + }, + "optionalDependencies": { + "graceful-fs": "^4.1.6" + } + }, + "node_modules/jsonwebtoken": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/jsonwebtoken/-/jsonwebtoken-9.0.2.tgz", + "integrity": "sha512-PRp66vJ865SSqOlgqS8hujT5U4AOgMfhrwYIuIhfKaoSCZcirrmASQr8CX7cUg+RMih+hgznrjp99o+W4pJLHQ==", + "license": "MIT", + "dependencies": { + "jws": "^3.2.2", + "lodash.includes": "^4.3.0", + "lodash.isboolean": "^3.0.3", + "lodash.isinteger": "^4.0.4", + "lodash.isnumber": "^3.0.3", + "lodash.isplainobject": "^4.0.6", + "lodash.isstring": "^4.0.1", + "lodash.once": "^4.0.0", + "ms": "^2.1.1", + "semver": "^7.5.4" + }, + "engines": { + "node": ">=12", + "npm": ">=6" + } + }, + "node_modules/jwa": { + "version": "1.4.2", + "resolved": "https://registry.npmjs.org/jwa/-/jwa-1.4.2.tgz", + "integrity": "sha512-eeH5JO+21J78qMvTIDdBXidBd6nG2kZjg5Ohz/1fpa28Z4CcsWUzJ1ZZyFq/3z3N17aZy+ZuBoHljASbL1WfOw==", + "license": "MIT", + "dependencies": { + "buffer-equal-constant-time": "^1.0.1", + "ecdsa-sig-formatter": "1.0.11", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/jws": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/jws/-/jws-3.2.3.tgz", + "integrity": "sha512-byiJ0FLRdLdSVSReO/U4E7RoEyOCKnEnEPMjq3HxWtvzLsV08/i5RQKsFVNkCldrCaPr2vDNAOMsfs8T/Hze7g==", + "license": "MIT", + "dependencies": { + "jwa": "^1.4.2", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/keyv": { + "version": "4.5.4", + "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", + "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "json-buffer": "3.0.1" + } + }, + "node_modules/kleur": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz", + "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/leven": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz", + "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1", + "type-check": "~0.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/libphonenumber-js": { + "version": "1.12.31", + "resolved": "https://registry.npmjs.org/libphonenumber-js/-/libphonenumber-js-1.12.31.tgz", + "integrity": "sha512-Z3IhgVgrqO1S5xPYM3K5XwbkDasU67/Vys4heW+lfSBALcUZjeIIzI8zCLifY+OCzSq+fpDdywMDa7z+4srJPQ==", + "license": "MIT" + }, + "node_modules/lines-and-columns": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz", + "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==", + "dev": true, + "license": "MIT" + }, + "node_modules/loader-runner": { + "version": "4.3.1", + "resolved": "https://registry.npmjs.org/loader-runner/-/loader-runner-4.3.1.tgz", + "integrity": "sha512-IWqP2SCPhyVFTBtRcgMHdzlf9ul25NwaFx4wCEH/KjAXuuHY4yNjvPXsBokp8jCB936PyWRaPKUNh8NvylLp2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.11.5" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^5.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/lodash": { + "version": "4.17.21", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", + "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==", + "license": "MIT" + }, + "node_modules/lodash.includes": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/lodash.includes/-/lodash.includes-4.3.0.tgz", + "integrity": "sha512-W3Bx6mdkRTGtlJISOvVD/lbqjTlPPUDTMnlXZFnVwi9NKJ6tiAk6LVdlhZMm17VZisqhKcgzpO5Wz91PCt5b0w==", + "license": "MIT" + }, + "node_modules/lodash.isboolean": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/lodash.isboolean/-/lodash.isboolean-3.0.3.tgz", + "integrity": "sha512-Bz5mupy2SVbPHURB98VAcw+aHh4vRV5IPNhILUCsOzRmsTmSQ17jIuqopAentWoehktxGd9e/hbIXq980/1QJg==", + "license": "MIT" + }, + "node_modules/lodash.isinteger": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/lodash.isinteger/-/lodash.isinteger-4.0.4.tgz", + "integrity": "sha512-DBwtEWN2caHQ9/imiNeEA5ys1JoRtRfY3d7V9wkqtbycnAmTvRRmbHKDV4a0EYc678/dia0jrte4tjYwVBaZUA==", + "license": "MIT" + }, + "node_modules/lodash.isnumber": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/lodash.isnumber/-/lodash.isnumber-3.0.3.tgz", + "integrity": "sha512-QYqzpfwO3/CWf3XP+Z+tkQsfaLL/EnUlXWVkIk5FUPc4sBdTehEqZONuyRt2P67PXAk+NXmTBcc97zw9t1FQrw==", + "license": "MIT" + }, + "node_modules/lodash.isplainobject": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz", + "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==", + "license": "MIT" + }, + "node_modules/lodash.isstring": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz", + "integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==", + "license": "MIT" + }, + "node_modules/lodash.memoize": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz", + "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.merge": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", + "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.once": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz", + "integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg==", + "license": "MIT" + }, + "node_modules/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/lru-cache": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz", + "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==", + "dev": true, + "license": "ISC", + "dependencies": { + "yallist": "^3.0.2" + } + }, + "node_modules/magic-string": { + "version": "0.30.8", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.8.tgz", + "integrity": "sha512-ISQTe55T2ao7XtlAStud6qwYPZjE4GK1S/BeVPus4jrq6JuOnQ00YKQC581RWhR122W7msZV263KzVeLoqidyQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.4.15" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/make-dir": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-3.1.0.tgz", + "integrity": "sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw==", + "license": "MIT", + "dependencies": { + "semver": "^6.0.0" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/make-dir/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/make-error": { + "version": "1.3.6", + "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz", + "integrity": "sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==", + "devOptional": true, + "license": "ISC" + }, + "node_modules/makeerror": { + "version": "1.0.12", + "resolved": "https://registry.npmjs.org/makeerror/-/makeerror-1.0.12.tgz", + "integrity": "sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "tmpl": "1.0.5" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/media-typer": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz", + "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/memfs": { + "version": "3.5.3", + "resolved": "https://registry.npmjs.org/memfs/-/memfs-3.5.3.tgz", + "integrity": "sha512-UERzLsxzllchadvbPs5aolHh65ISpKpM+ccLbOJ8/vvpBKmAWf+la7dXFy7Mr0ySHbdHrFv5kGFCUHHe6GFEmw==", + "dev": true, + "license": "Unlicense", + "dependencies": { + "fs-monkey": "^1.0.4" + }, + "engines": { + "node": ">= 4.0.0" + } + }, + "node_modules/merge-descriptors": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz", + "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/merge-stream": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz", + "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==", + "dev": true, + "license": "MIT" + }, + "node_modules/merge2": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", + "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/methods": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", + "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/micromatch/node_modules/picomatch": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/mime": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", + "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", + "license": "MIT", + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/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/minimatch": { + "version": "9.0.3", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.3.tgz", + "integrity": "sha512-RHiac9mvaRw0x3AYRgDC1CxAP7HTcNrrECeA8YYJeWnpo+2Q5CegtZjaotWTWxDG3UeGA1coE05iH1mPjT/2mg==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.1" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + }, + "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==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/minipass": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.2.tgz", + "integrity": "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==", + "license": "ISC", + "engines": { + "node": ">=16 || 14 >=14.17" + } + }, + "node_modules/minizlib": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/minizlib/-/minizlib-2.1.2.tgz", + "integrity": "sha512-bAxsR8BVfj60DWXHE3u30oHzfl4G7khkSuPW+qvpd7jFRHm7dLxOjUk1EHACJ/hxLY8phGJ0YhYHZo7jil7Qdg==", + "license": "MIT", + "dependencies": { + "minipass": "^3.0.0", + "yallist": "^4.0.0" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/minizlib/node_modules/minipass": { + "version": "3.3.6", + "resolved": "https://registry.npmjs.org/minipass/-/minipass-3.3.6.tgz", + "integrity": "sha512-DxiNidxSEK+tHG6zOIklvNOwm3hvCrbUrdtzY74U6HKTJxvIDfOUL5W5P2Ghd3DTkhhKPYGqeNUIh5qcM4YBfw==", + "license": "ISC", + "dependencies": { + "yallist": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/minizlib/node_modules/yallist": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", + "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==", + "license": "ISC" + }, + "node_modules/mkdirp": { + "version": "0.5.6", + "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz", + "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==", + "license": "MIT", + "dependencies": { + "minimist": "^1.2.6" + }, + "bin": { + "mkdirp": "bin/cmd.js" + } + }, + "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.0.2", + "resolved": "https://registry.npmjs.org/multer/-/multer-2.0.2.tgz", + "integrity": "sha512-u7f2xaZ/UG8oLXHvtF/oWTRvT44p9ecwBBqTwgJVq0+4BW1g8OW01TyMEGWBHbyMOYVHXslaut7qEQ1meATXgw==", + "license": "MIT", + "dependencies": { + "append-field": "^1.0.0", + "busboy": "^1.6.0", + "concat-stream": "^2.0.0", + "mkdirp": "^0.5.6", + "object-assign": "^4.1.1", + "type-is": "^1.6.18", + "xtend": "^4.0.2" + }, + "engines": { + "node": ">= 10.16.0" + } + }, + "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/natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "dev": true, + "license": "MIT" + }, + "node_modules/negotiator": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz", + "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/neo-async": { + "version": "2.6.2", + "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz", + "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==", + "dev": true, + "license": "MIT" + }, + "node_modules/node-abort-controller": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/node-abort-controller/-/node-abort-controller-3.1.1.tgz", + "integrity": "sha512-AGK2yQKIjRuqnc6VkX2Xj5d+QW8xZ87pa1UK6yA6ouUyuxfHuMP6umE5QK7UmTeOAymo+Zx1Fxiuw9rVx8taHQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/node-addon-api": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-5.1.0.tgz", + "integrity": "sha512-eh0GgfEkpnoWDq+VY8OyvYhFEzBk6jIYbRKdIlyTiAXIVJ8PyBaKb0rp7oDtoddbdoHWhq8wwr+XZ81F1rpNdA==", + "license": "MIT" + }, + "node_modules/node-emoji": { + "version": "1.11.0", + "resolved": "https://registry.npmjs.org/node-emoji/-/node-emoji-1.11.0.tgz", + "integrity": "sha512-wo2DpQkQp7Sjm2A0cq+sN7EHKO6Sl0ctXeBdFZrL9T9+UywORbufTcTZxom8YqpLQt/FqNMUkOpkZrJVYSKD3A==", + "dev": true, + "license": "MIT", + "dependencies": { + "lodash": "^4.17.21" + } + }, + "node_modules/node-fetch": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz", + "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==", + "license": "MIT", + "dependencies": { + "whatwg-url": "^5.0.0" + }, + "engines": { + "node": "4.x || >=6.0.0" + }, + "peerDependencies": { + "encoding": "^0.1.0" + }, + "peerDependenciesMeta": { + "encoding": { + "optional": true + } + } + }, + "node_modules/node-int64": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/node-int64/-/node-int64-0.4.0.tgz", + "integrity": "sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==", + "dev": true, + "license": "MIT" + }, + "node_modules/node-releases": { + "version": "2.0.27", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.27.tgz", + "integrity": "sha512-nmh3lCkYZ3grZvqcCH+fjmQ7X+H0OeZgP40OierEaAptX4XofMh5kwNbWh7lBduUzCcV/8kZ+NDLCwm2iorIlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/nopt": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/nopt/-/nopt-5.0.0.tgz", + "integrity": "sha512-Tbj67rffqceeLpcRXrT7vKAN8CwfPeIBgM7E6iBkmKLV7bEMwpGgYLGv0jACUsECaa/vuxP0IjEont6umdMgtQ==", + "license": "ISC", + "dependencies": { + "abbrev": "1" + }, + "bin": { + "nopt": "bin/nopt.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/normalize-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", + "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/npm-run-path": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz", + "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/npmlog": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/npmlog/-/npmlog-5.0.1.tgz", + "integrity": "sha512-AqZtDUWOMKs1G/8lwylVjrdYgqA4d9nu8hc+0gzRxlDb1I10+FHBGMXs6aiQHFdCUUlqH99MUMuLfzWDNDtfxw==", + "deprecated": "This package is no longer supported.", + "license": "ISC", + "dependencies": { + "are-we-there-yet": "^2.0.0", + "console-control-strings": "^1.1.0", + "gauge": "^3.0.0", + "set-blocking": "^2.0.0" + } + }, + "node_modules/object-assign": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", + "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-inspect": { + "version": "1.13.4", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz", + "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/on-finished": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz", + "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", + "license": "MIT", + "dependencies": { + "ee-first": "1.1.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/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/optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "deep-is": "^0.1.3", + "fast-levenshtein": "^2.0.6", + "levn": "^0.4.1", + "prelude-ls": "^1.2.1", + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "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/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/p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "yocto-queue": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-try": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz", + "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/package-json-from-dist": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz", + "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==", + "license": "BlueOak-1.0.0" + }, + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "dev": true, + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/parse-json": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz", + "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.0.0", + "error-ex": "^1.3.1", + "json-parse-even-better-errors": "^2.3.0", + "lines-and-columns": "^1.1.6" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "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/passport": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/passport/-/passport-0.7.0.tgz", + "integrity": "sha512-cPLl+qZpSc+ireUvt+IzqbED1cHHkDoVYMo30jbJIdOOjQ1MQYZBPiNvmi8UM6lJuOpTPXJGZQk0DtC4y61MYQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "passport-strategy": "1.x.x", + "pause": "0.0.1", + "utils-merge": "^1.0.1" + }, + "engines": { + "node": ">= 0.4.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/jaredhanson" + } + }, + "node_modules/passport-jwt": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/passport-jwt/-/passport-jwt-4.0.1.tgz", + "integrity": "sha512-UCKMDYhNuGOBE9/9Ycuoyh7vP6jpeTp/+sfMJl7nLff/t6dps+iaeE0hhNkKN8/HZHcJ7lCdOyDxHdDoxoSvdQ==", + "license": "MIT", + "dependencies": { + "jsonwebtoken": "^9.0.0", + "passport-strategy": "^1.0.0" + } + }, + "node_modules/passport-strategy": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/passport-strategy/-/passport-strategy-1.0.0.tgz", + "integrity": "sha512-CB97UUvDKJde2V0KDWWB3lyf6PC3FaZP7YxZ2G8OAtn9p4HI9j9JLP9qjOGZFvyl8uwNT8qM+hGnz/n16NI7oA==", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-is-absolute": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", + "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-parse": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz", + "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", + "dev": true, + "license": "MIT" + }, + "node_modules/path-scurry": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz", + "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==", + "license": "BlueOak-1.0.0", + "dependencies": { + "lru-cache": "^10.2.0", + "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0" + }, + "engines": { + "node": ">=16 || 14 >=14.18" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/path-scurry/node_modules/lru-cache": { + "version": "10.4.3", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz", + "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==", + "license": "ISC" + }, + "node_modules/path-to-regexp": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-3.3.0.tgz", + "integrity": "sha512-qyCH421YQPS2WFDxDjftfc1ZR5WKQzVzqsp4n9M2kQhVOo/ByahFoUNJfl58kOcEGfQ//7weFTDhm+ss8Ecxgw==", + "license": "MIT" + }, + "node_modules/path-type": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz", + "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/pause": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/pause/-/pause-0.0.1.tgz", + "integrity": "sha512-KG8UEiEVkR3wGEb4m5yZkVCzigAD+cVEJck2CzYZO37ZGJfctvVptVO192MwrtPhzONn6go8ylnOdMhKqi4nfg==" + }, + "node_modules/pg": { + "version": "8.16.3", + "resolved": "https://registry.npmjs.org/pg/-/pg-8.16.3.tgz", + "integrity": "sha512-enxc1h0jA/aq5oSDMvqyW3q89ra6XIIDZgCX9vkMrnz5DFTw/Ny3Li2lFQ+pt3L6MCgm/5o2o8HW9hiJji+xvw==", + "license": "MIT", + "peer": true, + "dependencies": { + "pg-connection-string": "^2.9.1", + "pg-pool": "^3.10.1", + "pg-protocol": "^1.10.3", + "pg-types": "2.2.0", + "pgpass": "1.0.5" + }, + "engines": { + "node": ">= 16.0.0" + }, + "optionalDependencies": { + "pg-cloudflare": "^1.2.7" + }, + "peerDependencies": { + "pg-native": ">=3.0.1" + }, + "peerDependenciesMeta": { + "pg-native": { + "optional": true + } + } + }, + "node_modules/pg-cloudflare": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.2.7.tgz", + "integrity": "sha512-YgCtzMH0ptvZJslLM1ffsY4EuGaU0cx4XSdXLRFae8bPP4dS5xL1tNB3k2o/N64cHJpwU7dxKli/nZ2lUa5fLg==", + "license": "MIT", + "optional": true + }, + "node_modules/pg-connection-string": { + "version": "2.9.1", + "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.9.1.tgz", + "integrity": "sha512-nkc6NpDcvPVpZXxrreI/FOtX3XemeLl8E0qFr6F2Lrm/I8WOnaWNhIPK2Z7OHpw7gh5XJThi6j6ppgNoaT1w4w==", + "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.10.1", + "resolved": "https://registry.npmjs.org/pg-pool/-/pg-pool-3.10.1.tgz", + "integrity": "sha512-Tu8jMlcX+9d8+QVzKIvM/uJtp07PKr82IUOYEphaWcoBhIYkoHpLXN3qO59nAI11ripznDsEzEv8nUxBVWajGg==", + "license": "MIT", + "peerDependencies": { + "pg": ">=8.0" + } + }, + "node_modules/pg-protocol": { + "version": "1.10.3", + "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.10.3.tgz", + "integrity": "sha512-6DIBgBQaTKDJyxnXaLiLR8wBpQQcGWuAESkRBX/t6OwA8YsqP+iVSiond2EDy6Y/dsGk8rh/jtax3js5NeV7JQ==", + "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", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.1.tgz", + "integrity": "sha512-xUXwsxNjwTQ8K3GnT4pCJm+xq3RUPQbmkYJTP5aFIfNIvbcc/4MUxgBaaRSZJ6yGJZiGSyYlM6MzwTsRk8SYCg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pirates": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.7.tgz", + "integrity": "sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, + "node_modules/pkg-dir": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz", + "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "find-up": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/pkg-dir/node_modules/find-up": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", + "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^5.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/pkg-dir/node_modules/locate-path": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", + "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^4.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/pkg-dir/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/pkg-dir/node_modules/p-locate": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", + "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^2.2.0" + }, + "engines": { + "node": ">=8" + } + }, + "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/possible-typed-array-names": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/possible-typed-array-names/-/possible-typed-array-names-1.1.0.tgz", + "integrity": "sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "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.0", + "resolved": "https://registry.npmjs.org/postgres-bytea/-/postgres-bytea-1.0.0.tgz", + "integrity": "sha512-xy3pmLuQqRBZBXDULy7KbaitYqLcmxigw14Q5sj8QBVLqEwXfeybIKVWiqAXTlcvdvb0+xkOtDbfQMOf4lST1w==", + "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/prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/prettier": { + "version": "3.7.4", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.7.4.tgz", + "integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==", + "dev": true, + "license": "MIT", + "peer": true, + "bin": { + "prettier": "bin/prettier.cjs" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/prettier/prettier?sponsor=1" + } + }, + "node_modules/prettier-linter-helpers": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/prettier-linter-helpers/-/prettier-linter-helpers-1.0.0.tgz", + "integrity": "sha512-GbK2cP9nraSSUF9N2XwUwqfzlAFlMNYYl+ShE/V+H8a9uNl/oUqB1w2EL54Jh0OlyRSd8RfWYJ3coVS4TROP2w==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-diff": "^1.1.2" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/pretty-format": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-29.7.0.tgz", + "integrity": "sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jest/schemas": "^29.6.3", + "ansi-styles": "^5.0.0", + "react-is": "^18.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/pretty-format/node_modules/ansi-styles": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz", + "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/prompts": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz", + "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "kleur": "^3.0.3", + "sisteransi": "^1.0.5" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/proxy-addr": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", + "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==", + "license": "MIT", + "dependencies": { + "forwarded": "0.2.0", + "ipaddr.js": "1.9.1" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/pure-rand": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/pure-rand/-/pure-rand-6.1.0.tgz", + "integrity": "sha512-bVWawvoZoBYpp6yIoQtQXHZjmz35RSVHnUOTefl8Vcjr8snTPY1wnpSPMWekcFwbxI6gtmT7rSYPFvz71ldiOA==", + "dev": true, + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/dubzzz" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fast-check" + } + ], + "license": "MIT" + }, + "node_modules/qs": { + "version": "6.13.0", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.13.0.tgz", + "integrity": "sha512-+38qI9SOr8tfZ4QmJNplMUxqjbe7LKvvZgWdExBOmd+egZTtjLB67Gu0HRX3u/XOq7UU2Nx6nsjvS16Z9uwfpg==", + "license": "BSD-3-Clause", + "dependencies": { + "side-channel": "^1.0.6" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/queue-microtask": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", + "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/randombytes": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz", + "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "safe-buffer": "^5.1.0" + } + }, + "node_modules/range-parser": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz", + "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/raw-body": { + "version": "2.5.2", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz", + "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==", + "license": "MIT", + "dependencies": { + "bytes": "3.1.2", + "http-errors": "2.0.0", + "iconv-lite": "0.4.24", + "unpipe": "1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/react-is": { + "version": "18.3.1", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.3.1.tgz", + "integrity": "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==", + "dev": true, + "license": "MIT" + }, + "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==", + "license": "MIT", + "dependencies": { + "inherits": "^2.0.3", + "string_decoder": "^1.1.1", + "util-deprecate": "^1.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/readdirp": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz", + "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==", + "dev": true, + "license": "MIT", + "dependencies": { + "picomatch": "^2.2.1" + }, + "engines": { + "node": ">=8.10.0" + } + }, + "node_modules/readdirp/node_modules/picomatch": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/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", + "peer": true + }, + "node_modules/repeat-string": { + "version": "1.6.1", + "resolved": "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz", + "integrity": "sha512-PV0dzCYDNfRi1jCDbJzpW7jNNDRuCOG/jI5ctQcGKt/clZD+YcPS3yIlWuTJMmESC8aevCFmWJy5wjAFgNqN6w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10" + } + }, + "node_modules/require-directory": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", + "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", + "license": "MIT", + "engines": { + "node": ">=0.10.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==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/resolve": { + "version": "1.22.11", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz", + "integrity": "sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-core-module": "^2.16.1", + "path-parse": "^1.0.7", + "supports-preserve-symlinks-flag": "^1.0.0" + }, + "bin": { + "resolve": "bin/resolve" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/resolve-cwd": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-3.0.0.tgz", + "integrity": "sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "resolve-from": "^5.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/resolve-cwd/node_modules/resolve-from": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", + "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/resolve.exports": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/resolve.exports/-/resolve.exports-2.0.3.tgz", + "integrity": "sha512-OcXjMsGdhL4XnbShKpAcSqPMzQoYkYyhbEaeSko47MjRP9NfEQMhZkXL1DoFlt9LWQn4YttrdnV6X2OiyzBi+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "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/reusify": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz", + "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==", + "dev": true, + "license": "MIT", + "engines": { + "iojs": ">=1.0.0", + "node": ">=0.10.0" + } + }, + "node_modules/rimraf": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz", + "integrity": "sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==", + "deprecated": "Rimraf versions prior to v4 are no longer supported", + "license": "ISC", + "dependencies": { + "glob": "^7.1.3" + }, + "bin": { + "rimraf": "bin.js" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/rimraf/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/rimraf/node_modules/glob": { + "version": "7.2.3", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", + "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "deprecated": "Glob versions prior to v9 are no longer supported", + "license": "ISC", + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/rimraf/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "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/run-parallel": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", + "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "queue-microtask": "^1.2.2" + } + }, + "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", + "peer": true, + "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==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "license": "MIT" + }, + "node_modules/schema-utils": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.3.0.tgz", + "integrity": "sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.8", + "ajv": "^6.12.5", + "ajv-keywords": "^3.5.2" + }, + "engines": { + "node": ">= 10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/schema-utils/node_modules/ajv": { + "version": "6.12.6", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", + "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/schema-utils/node_modules/ajv-keywords": { + "version": "3.5.2", + "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-3.5.2.tgz", + "integrity": "sha512-5p6WTN0DdTGVQk6VjcEju19IgaHudalcfabD7yhDGeA6bcQnmL+CpveLJq/3hvfwd1aof6L386Ougkx6RfyMIQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "ajv": "^6.9.1" + } + }, + "node_modules/schema-utils/node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/semver": { + "version": "7.7.3", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz", + "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/send": { + "version": "0.19.0", + "resolved": "https://registry.npmjs.org/send/-/send-0.19.0.tgz", + "integrity": "sha512-dW41u5VfLXu8SJh5bwRmyYUbAoSB3c9uQh6L8h/KtsFREPWpbX1lrljJo186Jc4nmci/sGUZ9a0a0J2zgfq2hw==", + "license": "MIT", + "dependencies": { + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "encodeurl": "~1.0.2", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "fresh": "0.5.2", + "http-errors": "2.0.0", + "mime": "1.6.0", + "ms": "2.1.3", + "on-finished": "2.4.1", + "range-parser": "~1.2.1", + "statuses": "2.0.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/send/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/send/node_modules/debug/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/send/node_modules/encodeurl": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz", + "integrity": "sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/serialize-javascript": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-6.0.2.tgz", + "integrity": "sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "randombytes": "^2.1.0" + } + }, + "node_modules/serve-static": { + "version": "1.16.2", + "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.2.tgz", + "integrity": "sha512-VqpjJZKadQB/PEbEwvFdO43Ax5dFBZ2UECszz8bQ7pi7wt//PWe1P6MN7eCnjsatYtBT6EuiClbjSWP2WrIoTw==", + "license": "MIT", + "dependencies": { + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "parseurl": "~1.3.3", + "send": "0.19.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/set-blocking": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/set-blocking/-/set-blocking-2.0.0.tgz", + "integrity": "sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw==", + "license": "ISC" + }, + "node_modules/set-function-length": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz", + "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==", + "license": "MIT", + "dependencies": { + "define-data-property": "^1.1.4", + "es-errors": "^1.3.0", + "function-bind": "^1.1.2", + "get-intrinsic": "^1.2.4", + "gopd": "^1.0.1", + "has-property-descriptors": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/setprototypeof": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", + "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", + "license": "ISC" + }, + "node_modules/sha.js": { + "version": "2.4.12", + "resolved": "https://registry.npmjs.org/sha.js/-/sha.js-2.4.12.tgz", + "integrity": "sha512-8LzC5+bvI45BjpfXU8V5fdU2mfeKiQe1D1gIMn7XUlF3OTUrpdJpPPH4EMAnF0DsHHdSZqCdSss5qCmJKuiO3w==", + "license": "(MIT AND BSD-3-Clause)", + "dependencies": { + "inherits": "^2.0.4", + "safe-buffer": "^5.2.1", + "to-buffer": "^1.2.0" + }, + "bin": { + "sha.js": "bin.js" + }, + "engines": { + "node": ">= 0.10" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "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.0", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz", + "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3", + "side-channel-list": "^1.0.0", + "side-channel-map": "^1.0.1", + "side-channel-weakmap": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-list": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz", + "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-map": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz", + "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-weakmap": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz", + "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==", + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3", + "side-channel-map": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/signal-exit": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", + "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", + "license": "ISC", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/sisteransi": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", + "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==", + "dev": true, + "license": "MIT" + }, + "node_modules/slash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz", + "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/source-map": { + "version": "0.7.4", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.4.tgz", + "integrity": "sha512-l3BikUxvPOcn5E74dZiq5BGsTb5yEwhaTSzccU6t4sDOH8NWJCstKO5QT2CvtFoK6F0saL7p9xHAqHOlCPJygA==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">= 8" + } + }, + "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/sprintf-js": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz", + "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/sql-highlight": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/sql-highlight/-/sql-highlight-6.1.0.tgz", + "integrity": "sha512-ed7OK4e9ywpE7pgRMkMQmZDPKSVdm0oX5IEtZiKnFucSF0zu6c80GZBe38UqHuVhTWJ9xsKgSMjCG2bml86KvA==", + "funding": [ + "https://github.com/scriptcoded/sql-highlight?sponsor=1", + { + "type": "github", + "url": "https://github.com/sponsors/scriptcoded" + } + ], + "license": "MIT", + "engines": { + "node": ">=14" + } + }, + "node_modules/stack-utils": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.6.tgz", + "integrity": "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "escape-string-regexp": "^2.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/stack-utils/node_modules/escape-string-regexp": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz", + "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/statuses": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz", + "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "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==", + "license": "MIT", + "dependencies": { + "safe-buffer": "~5.2.0" + } + }, + "node_modules/string-length": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/string-length/-/string-length-4.0.2.tgz", + "integrity": "sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "char-regex": "^1.0.2", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "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==", + "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/string-width-cjs": { + "name": "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==", + "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==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-ansi-cjs": { + "name": "strip-ansi", + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-bom": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-4.0.0.tgz", + "integrity": "sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-final-newline": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz", + "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/strip-json-comments": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", + "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/strtok3": { + "version": "10.3.4", + "resolved": "https://registry.npmjs.org/strtok3/-/strtok3-10.3.4.tgz", + "integrity": "sha512-KIy5nylvC5le1OdaaoCJ07L+8iQzJHGH6pWDuzS+d07Cu7n1MZ2x26P8ZKIWfbK02+XIL8Mp4RkWeqdUCrDMfg==", + "license": "MIT", + "dependencies": { + "@tokenizer/token": "^0.3.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/Borewit" + } + }, + "node_modules/superagent": { + "version": "8.1.2", + "resolved": "https://registry.npmjs.org/superagent/-/superagent-8.1.2.tgz", + "integrity": "sha512-6WTxW1EB6yCxV5VFOIPQruWGHqc3yI7hEmZK6h+pyk69Lk/Ut7rLUY6W/ONF2MjBuGjvmMiIpsrVJ2vjrHlslA==", + "deprecated": "Please upgrade to superagent v10.2.2+, see release notes at https://github.com/forwardemail/superagent/releases/tag/v10.2.2 - maintenance is supported by Forward Email @ https://forwardemail.net", + "dev": true, + "license": "MIT", + "dependencies": { + "component-emitter": "^1.3.0", + "cookiejar": "^2.1.4", + "debug": "^4.3.4", + "fast-safe-stringify": "^2.1.1", + "form-data": "^4.0.0", + "formidable": "^2.1.2", + "methods": "^1.1.2", + "mime": "2.6.0", + "qs": "^6.11.0", + "semver": "^7.3.8" + }, + "engines": { + "node": ">=6.4.0 <13 || >=14" + } + }, + "node_modules/superagent/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/supertest": { + "version": "6.3.4", + "resolved": "https://registry.npmjs.org/supertest/-/supertest-6.3.4.tgz", + "integrity": "sha512-erY3HFDG0dPnhw4U+udPfrzXa4xhSG+n4rxfRuZWCUvjFWwKl+OxWf/7zk50s84/fAAs7vf5QAb9uRa0cCykxw==", + "deprecated": "Please upgrade to supertest v7.1.3+, see release notes at https://github.com/forwardemail/supertest/releases/tag/v7.1.3 - maintenance is supported by Forward Email @ https://forwardemail.net", + "dev": true, + "license": "MIT", + "dependencies": { + "methods": "^1.1.2", + "superagent": "^8.1.2" + }, + "engines": { + "node": ">=6.4.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==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/supports-preserve-symlinks-flag": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz", + "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/swagger-ui-dist": { + "version": "5.17.14", + "resolved": "https://registry.npmjs.org/swagger-ui-dist/-/swagger-ui-dist-5.17.14.tgz", + "integrity": "sha512-CVbSfaLpstV65OnSjbXfVd6Sta3q3F7Cj/yYuvHMp1P90LztOLs6PfUnKEVAeiIVQt9u2SaPwv0LiH/OyMjHRw==", + "license": "Apache-2.0" + }, + "node_modules/symbol-observable": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/symbol-observable/-/symbol-observable-4.0.0.tgz", + "integrity": "sha512-b19dMThMV4HVFynSAM1++gBHAbk2Tc/osgLIBZMKsyqh34jb2e8Os7T6ZW/Bt3pJFdBTd2JwAnAAEQV7rSNvcQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10" + } + }, + "node_modules/synckit": { + "version": "0.11.11", + "resolved": "https://registry.npmjs.org/synckit/-/synckit-0.11.11.tgz", + "integrity": "sha512-MeQTA1r0litLUf0Rp/iisCaL8761lKAZHaimlbGK4j0HysC4PLfqygQj9srcs0m2RdtDYnF8UuYyKpbjHYp7Jw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@pkgr/core": "^0.2.9" + }, + "engines": { + "node": "^14.18.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/synckit" + } + }, + "node_modules/tapable": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.3.0.tgz", + "integrity": "sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/tar": { + "version": "6.2.1", + "resolved": "https://registry.npmjs.org/tar/-/tar-6.2.1.tgz", + "integrity": "sha512-DZ4yORTwrbTj/7MZYq2w+/ZFdI6OZ/f9SFHR+71gIVUZhOQPHzVCLpvRnPgyaMpfWxxk/4ONva3GQSyNIKRv6A==", + "license": "ISC", + "dependencies": { + "chownr": "^2.0.0", + "fs-minipass": "^2.0.0", + "minipass": "^5.0.0", + "minizlib": "^2.1.1", + "mkdirp": "^1.0.3", + "yallist": "^4.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/tar/node_modules/minipass": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/minipass/-/minipass-5.0.0.tgz", + "integrity": "sha512-3FnjYuehv9k6ovOEbyOswadCDPX1piCfhV8ncmYtHOjuPwylVWsghTLo7rabjC3Rx5xD4HDx8Wm1xnMF7S5qFQ==", + "license": "ISC", + "engines": { + "node": ">=8" + } + }, + "node_modules/tar/node_modules/mkdirp": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-1.0.4.tgz", + "integrity": "sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw==", + "license": "MIT", + "bin": { + "mkdirp": "bin/cmd.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/tar/node_modules/yallist": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", + "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==", + "license": "ISC" + }, + "node_modules/terser": { + "version": "5.44.1", + "resolved": "https://registry.npmjs.org/terser/-/terser-5.44.1.tgz", + "integrity": "sha512-t/R3R/n0MSwnnazuPpPNVO60LX0SKL45pyl9YlvxIdkH0Of7D5qM2EVe+yASRIlY5pZ73nclYJfNANGWPwFDZw==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "@jridgewell/source-map": "^0.3.3", + "acorn": "^8.15.0", + "commander": "^2.20.0", + "source-map-support": "~0.5.20" + }, + "bin": { + "terser": "bin/terser" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/terser-webpack-plugin": { + "version": "5.3.15", + "resolved": "https://registry.npmjs.org/terser-webpack-plugin/-/terser-webpack-plugin-5.3.15.tgz", + "integrity": "sha512-PGkOdpRFK+rb1TzVz+msVhw4YMRT9txLF4kRqvJhGhCM324xuR3REBSHALN+l+sAhKUmz0aotnjp5D+P83mLhQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/trace-mapping": "^0.3.25", + "jest-worker": "^27.4.5", + "schema-utils": "^4.3.0", + "serialize-javascript": "^6.0.2", + "terser": "^5.31.1" + }, + "engines": { + "node": ">= 10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "webpack": "^5.1.0" + }, + "peerDependenciesMeta": { + "@swc/core": { + "optional": true + }, + "esbuild": { + "optional": true + }, + "uglify-js": { + "optional": true + } + } + }, + "node_modules/terser-webpack-plugin/node_modules/jest-worker": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-27.5.1.tgz", + "integrity": "sha512-7vuh85V5cdDofPyxn58nrPjBktZo0u9x1g8WtjQol+jZDaE+fhN+cIvTj11GndBnMnyfrUOG1sZQxCdjKh+DKg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*", + "merge-stream": "^2.0.0", + "supports-color": "^8.0.0" + }, + "engines": { + "node": ">= 10.13.0" + } + }, + "node_modules/terser-webpack-plugin/node_modules/schema-utils": { + "version": "4.3.3", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.3.3.tgz", + "integrity": "sha512-eflK8wEtyOE6+hsaRVPxvUKYCpRgzLqDTb8krvAsRIwOGlHoSgYLgBXoubGgLd2fT41/OUYdb48v4k4WWHQurA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.9", + "ajv": "^8.9.0", + "ajv-formats": "^2.1.1", + "ajv-keywords": "^5.1.0" + }, + "engines": { + "node": ">= 10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/terser-webpack-plugin/node_modules/supports-color": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz", + "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/terser/node_modules/commander": { + "version": "2.20.3", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz", + "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/test-exclude": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/test-exclude/-/test-exclude-6.0.0.tgz", + "integrity": "sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==", + "dev": true, + "license": "ISC", + "dependencies": { + "@istanbuljs/schema": "^0.1.2", + "glob": "^7.1.4", + "minimatch": "^3.0.4" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/test-exclude/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/test-exclude/node_modules/glob": { + "version": "7.2.3", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", + "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "deprecated": "Glob versions prior to v9 are no longer supported", + "dev": true, + "license": "ISC", + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/test-exclude/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/text-table": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/text-table/-/text-table-0.2.0.tgz", + "integrity": "sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw==", + "dev": true, + "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/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/tmpl": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/tmpl/-/tmpl-1.0.5.tgz", + "integrity": "sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/to-buffer": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/to-buffer/-/to-buffer-1.2.2.tgz", + "integrity": "sha512-db0E3UJjcFhpDhAF4tLo03oli3pwl3dbnzXOUIlRKrp+ldk/VUxzpWYZENsw2SZiuBjHAk7DfB0VU7NKdpb6sw==", + "license": "MIT", + "dependencies": { + "isarray": "^2.0.5", + "safe-buffer": "^5.2.1", + "typed-array-buffer": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/toidentifier": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", + "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", + "license": "MIT", + "engines": { + "node": ">=0.6" + } + }, + "node_modules/token-types": { + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/token-types/-/token-types-6.1.1.tgz", + "integrity": "sha512-kh9LVIWH5CnL63Ipf0jhlBIy0UsrMj/NJDfpsy1SqOXlLKEVyXXYrnFxFT1yOOYVGBSApeVnjPw/sBz5BfEjAQ==", + "license": "MIT", + "dependencies": { + "@borewit/text-codec": "^0.1.0", + "@tokenizer/token": "^0.3.0", + "ieee754": "^1.2.1" + }, + "engines": { + "node": ">=14.16" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/Borewit" + } + }, + "node_modules/tr46": { + "version": "0.0.3", + "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz", + "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==", + "license": "MIT" + }, + "node_modules/tree-kill": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/tree-kill/-/tree-kill-1.2.2.tgz", + "integrity": "sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==", + "dev": true, + "license": "MIT", + "bin": { + "tree-kill": "cli.js" + } + }, + "node_modules/ts-api-utils": { + "version": "1.4.3", + "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-1.4.3.tgz", + "integrity": "sha512-i3eMG77UTMD0hZhgRS562pv83RC6ukSAC2GMNWc+9dieh/+jDM5u5YG+NHX6VNDRHQcHwmsTHctP9LhbC3WxVw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=16" + }, + "peerDependencies": { + "typescript": ">=4.2.0" + } + }, + "node_modules/ts-jest": { + "version": "29.4.6", + "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.4.6.tgz", + "integrity": "sha512-fSpWtOO/1AjSNQguk43hb/JCo16oJDnMJf3CdEGNkqsEX3t0KX96xvyX1D7PfLCpVoKu4MfVrqUkFyblYoY4lA==", + "dev": true, + "license": "MIT", + "dependencies": { + "bs-logger": "^0.2.6", + "fast-json-stable-stringify": "^2.1.0", + "handlebars": "^4.7.8", + "json5": "^2.2.3", + "lodash.memoize": "^4.1.2", + "make-error": "^1.3.6", + "semver": "^7.7.3", + "type-fest": "^4.41.0", + "yargs-parser": "^21.1.1" + }, + "bin": { + "ts-jest": "cli.js" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || ^18.0.0 || >=20.0.0" + }, + "peerDependencies": { + "@babel/core": ">=7.0.0-beta.0 <8", + "@jest/transform": "^29.0.0 || ^30.0.0", + "@jest/types": "^29.0.0 || ^30.0.0", + "babel-jest": "^29.0.0 || ^30.0.0", + "jest": "^29.0.0 || ^30.0.0", + "jest-util": "^29.0.0 || ^30.0.0", + "typescript": ">=4.3 <6" + }, + "peerDependenciesMeta": { + "@babel/core": { + "optional": true + }, + "@jest/transform": { + "optional": true + }, + "@jest/types": { + "optional": true + }, + "babel-jest": { + "optional": true + }, + "esbuild": { + "optional": true + }, + "jest-util": { + "optional": true + } + } + }, + "node_modules/ts-jest/node_modules/type-fest": { + "version": "4.41.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz", + "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ts-loader": { + "version": "9.5.4", + "resolved": "https://registry.npmjs.org/ts-loader/-/ts-loader-9.5.4.tgz", + "integrity": "sha512-nCz0rEwunlTZiy6rXFByQU1kVVpCIgUpc/psFiKVrUwrizdnIbRFu8w7bxhUF0X613DYwT4XzrZHpVyMe758hQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^4.1.0", + "enhanced-resolve": "^5.0.0", + "micromatch": "^4.0.0", + "semver": "^7.3.4", + "source-map": "^0.7.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "typescript": "*", + "webpack": "^5.0.0" + } + }, + "node_modules/ts-node": { + "version": "10.9.2", + "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-10.9.2.tgz", + "integrity": "sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==", + "devOptional": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@cspotcode/source-map-support": "^0.8.0", + "@tsconfig/node10": "^1.0.7", + "@tsconfig/node12": "^1.0.7", + "@tsconfig/node14": "^1.0.0", + "@tsconfig/node16": "^1.0.2", + "acorn": "^8.4.1", + "acorn-walk": "^8.1.1", + "arg": "^4.1.0", + "create-require": "^1.1.0", + "diff": "^4.0.1", + "make-error": "^1.1.1", + "v8-compile-cache-lib": "^3.0.1", + "yn": "3.1.1" + }, + "bin": { + "ts-node": "dist/bin.js", + "ts-node-cwd": "dist/bin-cwd.js", + "ts-node-esm": "dist/bin-esm.js", + "ts-node-script": "dist/bin-script.js", + "ts-node-transpile-only": "dist/bin-transpile.js", + "ts-script": "dist/bin-script-deprecated.js" + }, + "peerDependencies": { + "@swc/core": ">=1.2.50", + "@swc/wasm": ">=1.2.50", + "@types/node": "*", + "typescript": ">=2.7" + }, + "peerDependenciesMeta": { + "@swc/core": { + "optional": true + }, + "@swc/wasm": { + "optional": true + } + } + }, + "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/tsconfig-paths-webpack-plugin": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/tsconfig-paths-webpack-plugin/-/tsconfig-paths-webpack-plugin-4.2.0.tgz", + "integrity": "sha512-zbem3rfRS8BgeNK50Zz5SIQgXzLafiHjOwUAvk/38/o1jHn/V5QAgVUcz884or7WYcPaH3N2CIfUc2u0ul7UcA==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^4.1.0", + "enhanced-resolve": "^5.7.0", + "tapable": "^2.2.1", + "tsconfig-paths": "^4.1.2" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/tsconfig-paths/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/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-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/type-detect": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz", + "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/type-fest": { + "version": "0.20.2", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.20.2.tgz", + "integrity": "sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "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/typed-array-buffer": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/typed-array-buffer/-/typed-array-buffer-1.0.3.tgz", + "integrity": "sha512-nAYYwfY3qnzX30IkA6AQZjVbtK6duGontcQm1WSG1MD94YLqK0515GNApXkoxKOWMusVssAHWLh9SeaoefYFGw==", + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "es-errors": "^1.3.0", + "is-typed-array": "^1.1.14" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/typedarray": { + "version": "0.0.6", + "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz", + "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==", + "license": "MIT" + }, + "node_modules/typeorm": { + "version": "0.3.28", + "resolved": "https://registry.npmjs.org/typeorm/-/typeorm-0.3.28.tgz", + "integrity": "sha512-6GH7wXhtfq2D33ZuRXYwIsl/qM5685WZcODZb7noOOcRMteM9KF2x2ap3H0EBjnSV0VO4gNAfJT5Ukp0PkOlvg==", + "license": "MIT", + "peer": true, + "dependencies": { + "@sqltools/formatter": "^1.2.5", + "ansis": "^4.2.0", + "app-root-path": "^3.1.0", + "buffer": "^6.0.3", + "dayjs": "^1.11.19", + "debug": "^4.4.3", + "dedent": "^1.7.0", + "dotenv": "^16.6.1", + "glob": "^10.5.0", + "reflect-metadata": "^0.2.2", + "sha.js": "^2.4.12", + "sql-highlight": "^6.1.0", + "tslib": "^2.8.1", + "uuid": "^11.1.0", + "yargs": "^17.7.2" + }, + "bin": { + "typeorm": "cli.js", + "typeorm-ts-node-commonjs": "cli-ts-node-commonjs.js", + "typeorm-ts-node-esm": "cli-ts-node-esm.js" + }, + "engines": { + "node": ">=16.13.0" + }, + "funding": { + "url": "https://opencollective.com/typeorm" + }, + "peerDependencies": { + "@google-cloud/spanner": "^5.18.0 || ^6.0.0 || ^7.0.0 || ^8.0.0", + "@sap/hana-client": "^2.14.22", + "better-sqlite3": "^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0 || ^12.0.0", + "ioredis": "^5.0.4", + "mongodb": "^5.8.0 || ^6.0.0", + "mssql": "^9.1.1 || ^10.0.0 || ^11.0.0 || ^12.0.0", + "mysql2": "^2.2.5 || ^3.0.1", + "oracledb": "^6.3.0", + "pg": "^8.5.1", + "pg-native": "^3.0.0", + "pg-query-stream": "^4.0.0", + "redis": "^3.1.1 || ^4.0.0 || ^5.0.14", + "sql.js": "^1.4.0", + "sqlite3": "^5.0.3", + "ts-node": "^10.7.0", + "typeorm-aurora-data-api-driver": "^2.0.0 || ^3.0.0" + }, + "peerDependenciesMeta": { + "@google-cloud/spanner": { + "optional": true + }, + "@sap/hana-client": { + "optional": true + }, + "better-sqlite3": { + "optional": true + }, + "ioredis": { + "optional": true + }, + "mongodb": { + "optional": true + }, + "mssql": { + "optional": true + }, + "mysql2": { + "optional": true + }, + "oracledb": { + "optional": true + }, + "pg": { + "optional": true + }, + "pg-native": { + "optional": true + }, + "pg-query-stream": { + "optional": true + }, + "redis": { + "optional": true + }, + "sql.js": { + "optional": true + }, + "sqlite3": { + "optional": true + }, + "ts-node": { + "optional": true + }, + "typeorm-aurora-data-api-driver": { + "optional": true + } + } + }, + "node_modules/typeorm/node_modules/buffer": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz", + "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==", + "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.2.1" + } + }, + "node_modules/typeorm/node_modules/dotenv": { + "version": "16.6.1", + "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz", + "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://dotenvx.com" + } + }, + "node_modules/typeorm/node_modules/glob": { + "version": "10.5.0", + "resolved": "https://registry.npmjs.org/glob/-/glob-10.5.0.tgz", + "integrity": "sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==", + "license": "ISC", + "dependencies": { + "foreground-child": "^3.1.0", + "jackspeak": "^3.1.2", + "minimatch": "^9.0.4", + "minipass": "^7.1.2", + "package-json-from-dist": "^1.0.0", + "path-scurry": "^1.11.1" + }, + "bin": { + "glob": "dist/esm/bin.mjs" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/typeorm/node_modules/minimatch": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz", + "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==", + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.1" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/typeorm/node_modules/uuid": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.0.tgz", + "integrity": "sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A==", + "funding": [ + "https://github.com/sponsors/broofa", + "https://github.com/sponsors/ctavan" + ], + "license": "MIT", + "bin": { + "uuid": "dist/esm/bin/uuid" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "devOptional": true, + "license": "Apache-2.0", + "peer": true, + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/uglify-js": { + "version": "3.19.3", + "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz", + "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==", + "dev": true, + "license": "BSD-2-Clause", + "optional": true, + "bin": { + "uglifyjs": "bin/uglifyjs" + }, + "engines": { + "node": ">=0.8.0" + } + }, + "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-types": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", + "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", + "license": "MIT" + }, + "node_modules/universalify": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz", + "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 10.0.0" + } + }, + "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/update-browserslist-db": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.2.tgz", + "integrity": "sha512-E85pfNzMQ9jpKkA7+TJAi4TJN+tBCuWh5rUcS/sv6cFi+1q9LYDwDI5dpUL0u/73EElyQ8d3TEaeW4sPedBqYA==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "escalade": "^3.2.0", + "picocolors": "^1.1.1" + }, + "bin": { + "update-browserslist-db": "cli.js" + }, + "peerDependencies": { + "browserslist": ">= 4.21.0" + } + }, + "node_modules/uri-js": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", + "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "punycode": "^2.1.0" + } + }, + "node_modules/util-deprecate": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", + "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "license": "MIT" + }, + "node_modules/utils-merge": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz", + "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==", + "license": "MIT", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/uuid": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-9.0.1.tgz", + "integrity": "sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA==", + "funding": [ + "https://github.com/sponsors/broofa", + "https://github.com/sponsors/ctavan" + ], + "license": "MIT", + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/v8-compile-cache-lib": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz", + "integrity": "sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/v8-to-istanbul": { + "version": "9.3.0", + "resolved": "https://registry.npmjs.org/v8-to-istanbul/-/v8-to-istanbul-9.3.0.tgz", + "integrity": "sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA==", + "dev": true, + "license": "ISC", + "dependencies": { + "@jridgewell/trace-mapping": "^0.3.12", + "@types/istanbul-lib-coverage": "^2.0.1", + "convert-source-map": "^2.0.0" + }, + "engines": { + "node": ">=10.12.0" + } + }, + "node_modules/validator": { + "version": "13.15.23", + "resolved": "https://registry.npmjs.org/validator/-/validator-13.15.23.tgz", + "integrity": "sha512-4yoz1kEWqUjzi5zsPbAS/903QXSYp0UOtHsPpp7p9rHAw/W+dkInskAE386Fat3oKRROwO98d9ZB0G4cObgUyw==", + "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/walker": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/walker/-/walker-1.0.8.tgz", + "integrity": "sha512-ts/8E8l5b7kY0vlWLewOkDXMmPdLcVV4GmOQLyxuSswIJsweeFZtAsMF7k1Nszz+TYBQrlYRmzOnr398y1JemQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "makeerror": "1.0.12" + } + }, + "node_modules/watchpack": { + "version": "2.4.4", + "resolved": "https://registry.npmjs.org/watchpack/-/watchpack-2.4.4.tgz", + "integrity": "sha512-c5EGNOiyxxV5qmTtAB7rbiXxi1ooX1pQKMLX/MIabJjRA0SJBQOjKF+KSVfHkr9U1cADPon0mRiVe/riyaiDUA==", + "dev": true, + "license": "MIT", + "dependencies": { + "glob-to-regexp": "^0.4.1", + "graceful-fs": "^4.1.2" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "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/webidl-conversions": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz", + "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==", + "license": "BSD-2-Clause" + }, + "node_modules/webpack": { + "version": "5.103.0", + "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.103.0.tgz", + "integrity": "sha512-HU1JOuV1OavsZ+mfigY0j8d1TgQgbZ6M+J75zDkpEAwYeXjWSqrGJtgnPblJjd/mAyTNQ7ygw0MiKOn6etz8yw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@types/eslint-scope": "^3.7.7", + "@types/estree": "^1.0.8", + "@types/json-schema": "^7.0.15", + "@webassemblyjs/ast": "^1.14.1", + "@webassemblyjs/wasm-edit": "^1.14.1", + "@webassemblyjs/wasm-parser": "^1.14.1", + "acorn": "^8.15.0", + "acorn-import-phases": "^1.0.3", + "browserslist": "^4.26.3", + "chrome-trace-event": "^1.0.2", + "enhanced-resolve": "^5.17.3", + "es-module-lexer": "^1.2.1", + "eslint-scope": "5.1.1", + "events": "^3.2.0", + "glob-to-regexp": "^0.4.1", + "graceful-fs": "^4.2.11", + "json-parse-even-better-errors": "^2.3.1", + "loader-runner": "^4.3.1", + "mime-types": "^2.1.27", + "neo-async": "^2.6.2", + "schema-utils": "^4.3.3", + "tapable": "^2.3.0", + "terser-webpack-plugin": "^5.3.11", + "watchpack": "^2.4.4", + "webpack-sources": "^3.3.3" + }, + "bin": { + "webpack": "bin/webpack.js" + }, + "engines": { + "node": ">=10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependenciesMeta": { + "webpack-cli": { + "optional": true + } + } + }, + "node_modules/webpack-node-externals": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/webpack-node-externals/-/webpack-node-externals-3.0.0.tgz", + "integrity": "sha512-LnL6Z3GGDPht/AigwRh2dvL9PQPFQ8skEpVrWZXLWBYmqcaojHNN0onvHzie6rq7EWKrrBfPYqNEzTJgiwEQDQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/webpack-sources": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-3.3.3.tgz", + "integrity": "sha512-yd1RBzSGanHkitROoPFd6qsrxt+oFhg/129YzheDGqeustzX0vTZJZsSsQjVQC4yzBQ56K55XU8gaNCtIzOnTg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/webpack/node_modules/eslint-scope": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-5.1.1.tgz", + "integrity": "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^4.1.1" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/webpack/node_modules/estraverse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.3.0.tgz", + "integrity": "sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/webpack/node_modules/schema-utils": { + "version": "4.3.3", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.3.3.tgz", + "integrity": "sha512-eflK8wEtyOE6+hsaRVPxvUKYCpRgzLqDTb8krvAsRIwOGlHoSgYLgBXoubGgLd2fT41/OUYdb48v4k4WWHQurA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.9", + "ajv": "^8.9.0", + "ajv-formats": "^2.1.1", + "ajv-keywords": "^5.1.0" + }, + "engines": { + "node": ">= 10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/whatwg-url": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz", + "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==", + "license": "MIT", + "dependencies": { + "tr46": "~0.0.3", + "webidl-conversions": "^3.0.0" + } + }, + "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/which-typed-array": { + "version": "1.1.19", + "resolved": "https://registry.npmjs.org/which-typed-array/-/which-typed-array-1.1.19.tgz", + "integrity": "sha512-rEvr90Bck4WZt9HHFC4DJMsjvu7x+r6bImz0/BrbWb7A2djJ8hnZMrWnHo9F8ssv0OMErasDhftrfROTyqSDrw==", + "license": "MIT", + "dependencies": { + "available-typed-arrays": "^1.0.7", + "call-bind": "^1.0.8", + "call-bound": "^1.0.4", + "for-each": "^0.3.5", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/wide-align": { + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/wide-align/-/wide-align-1.1.5.tgz", + "integrity": "sha512-eDMORYaPNZ4sQIuuYPDHdQvf4gyCF9rEEV/yPxGfwPkRodwEgiMUUXTx/dex+Me0wxx53S+NgUHaP7y3MGlDmg==", + "license": "ISC", + "dependencies": { + "string-width": "^1.0.2 || 2 || 3 || 4" + } + }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/wordwrap": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", + "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==", + "dev": true, + "license": "MIT" + }, + "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/wrap-ansi-cjs": { + "name": "wrap-ansi", + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "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/write-file-atomic": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/write-file-atomic/-/write-file-atomic-4.0.2.tgz", + "integrity": "sha512-7KxauUdBmSdWnmpaGFg+ppNjKF8uNLry8LyzjauQDOVONfFLNKrKvQOxZ/VuTIcS/gge/YNahf5RIIQWTSarlg==", + "dev": true, + "license": "ISC", + "dependencies": { + "imurmurhash": "^0.1.4", + "signal-exit": "^3.0.7" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || >=16.0.0" + } + }, + "node_modules/write-file-atomic/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/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/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yallist": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz", + "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==", + "dev": true, + "license": "ISC" + }, + "node_modules/yargs": { + "version": "17.7.2", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz", + "integrity": "sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==", + "license": "MIT", + "dependencies": { + "cliui": "^8.0.1", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "require-directory": "^2.1.1", + "string-width": "^4.2.3", + "y18n": "^5.0.5", + "yargs-parser": "^21.1.1" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/yargs-parser": { + "version": "21.1.1", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", + "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/yn": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz", + "integrity": "sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + } + } +} diff --git a/apps/products/pos-micro/backend/package.json b/apps/products/pos-micro/backend/package.json new file mode 100644 index 0000000..369ad45 --- /dev/null +++ b/apps/products/pos-micro/backend/package.json @@ -0,0 +1,83 @@ +{ + "name": "pos-micro-backend", + "version": "1.0.0", + "description": "POS Micro - Ultra-minimal point of sale backend", + "author": "ERP Suite", + "private": true, + "license": "MIT", + "scripts": { + "build": "nest build", + "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": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix", + "test": "jest", + "test:watch": "jest --watch", + "test:cov": "jest --coverage", + "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand", + "test:e2e": "jest --config ./test/jest-e2e.json", + "typeorm": "typeorm-ts-node-commonjs", + "migration:generate": "npm run typeorm -- migration:generate -d src/database/data-source.ts", + "migration:run": "npm run typeorm -- migration:run -d src/database/data-source.ts", + "migration:revert": "npm run typeorm -- migration:revert -d src/database/data-source.ts" + }, + "dependencies": { + "@nestjs/common": "^10.3.0", + "@nestjs/config": "^3.1.1", + "@nestjs/core": "^10.3.0", + "@nestjs/jwt": "^10.2.0", + "@nestjs/passport": "^10.0.3", + "@nestjs/platform-express": "^10.3.0", + "@nestjs/swagger": "^7.2.0", + "@nestjs/typeorm": "^10.0.1", + "bcrypt": "^5.1.1", + "class-transformer": "^0.5.1", + "class-validator": "^0.14.1", + "helmet": "^7.1.0", + "passport": "^0.7.0", + "passport-jwt": "^4.0.1", + "pg": "^8.11.3", + "reflect-metadata": "^0.2.1", + "rxjs": "^7.8.1", + "typeorm": "^0.3.19", + "uuid": "^9.0.1" + }, + "devDependencies": { + "@nestjs/cli": "^10.3.0", + "@nestjs/schematics": "^10.1.0", + "@nestjs/testing": "^10.3.0", + "@types/bcrypt": "^5.0.2", + "@types/express": "^4.17.21", + "@types/jest": "^29.5.11", + "@types/node": "^20.10.8", + "@types/passport-jwt": "^4.0.0", + "@types/uuid": "^9.0.7", + "@typescript-eslint/eslint-plugin": "^6.19.0", + "@typescript-eslint/parser": "^6.19.0", + "eslint": "^8.56.0", + "eslint-config-prettier": "^9.1.0", + "eslint-plugin-prettier": "^5.1.3", + "jest": "^29.7.0", + "prettier": "^3.2.4", + "source-map-support": "^0.5.21", + "supertest": "^6.3.4", + "ts-jest": "^29.1.1", + "ts-loader": "^9.5.1", + "ts-node": "^10.9.2", + "tsconfig-paths": "^4.2.0", + "typescript": "^5.3.3" + }, + "jest": { + "moduleFileExtensions": ["js", "json", "ts"], + "rootDir": "src", + "testRegex": ".*\\.spec\\.ts$", + "transform": { + "^.+\\.(t|j)s$": "ts-jest" + }, + "collectCoverageFrom": ["**/*.(t|j)s"], + "coverageDirectory": "../coverage", + "testEnvironment": "node" + } +} diff --git a/apps/products/pos-micro/backend/src/app.module.ts b/apps/products/pos-micro/backend/src/app.module.ts new file mode 100644 index 0000000..460e441 --- /dev/null +++ b/apps/products/pos-micro/backend/src/app.module.ts @@ -0,0 +1,45 @@ +import { Module } from '@nestjs/common'; +import { ConfigModule, ConfigService } from '@nestjs/config'; +import { TypeOrmModule } from '@nestjs/typeorm'; +import { AuthModule } from './modules/auth/auth.module'; +import { ProductsModule } from './modules/products/products.module'; +import { CategoriesModule } from './modules/categories/categories.module'; +import { SalesModule } from './modules/sales/sales.module'; +import { PaymentsModule } from './modules/payments/payments.module'; + +@Module({ + imports: [ + // Configuration + ConfigModule.forRoot({ + isGlobal: true, + envFilePath: ['.env.local', '.env'], + }), + + // Database + TypeOrmModule.forRootAsync({ + imports: [ConfigModule], + inject: [ConfigService], + useFactory: (configService: ConfigService) => ({ + type: 'postgres', + host: configService.get('DB_HOST', 'localhost'), + port: configService.get('DB_PORT', 5432), + username: configService.get('DB_USERNAME', 'pos_micro'), + password: configService.get('DB_PASSWORD', 'pos_micro_secret'), + database: configService.get('DB_DATABASE', 'pos_micro_db'), + schema: configService.get('DB_SCHEMA', 'pos_micro'), + autoLoadEntities: true, + synchronize: configService.get('NODE_ENV') === 'development', + logging: configService.get('NODE_ENV') === 'development', + ssl: configService.get('DB_SSL') === 'true' ? { rejectUnauthorized: false } : false, + }), + }), + + // Feature Modules + AuthModule, + ProductsModule, + CategoriesModule, + SalesModule, + PaymentsModule, + ], +}) +export class AppModule {} diff --git a/apps/products/pos-micro/backend/src/main.ts b/apps/products/pos-micro/backend/src/main.ts new file mode 100644 index 0000000..a55d004 --- /dev/null +++ b/apps/products/pos-micro/backend/src/main.ts @@ -0,0 +1,81 @@ +import { NestFactory } from '@nestjs/core'; +import { ValidationPipe, VersioningType } from '@nestjs/common'; +import { ConfigService } from '@nestjs/config'; +import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger'; +import helmet from 'helmet'; +import { AppModule } from './app.module'; + +async function bootstrap() { + const app = await NestFactory.create(AppModule); + const configService = app.get(ConfigService); + + // Security + app.use(helmet()); + + // CORS + app.enableCors({ + origin: configService.get('CORS_ORIGIN', 'http://localhost:5173'), + credentials: true, + }); + + // Global prefix + app.setGlobalPrefix(configService.get('API_PREFIX', 'api/v1')); + + // Versioning + app.enableVersioning({ + type: VersioningType.URI, + defaultVersion: '1', + }); + + // Validation + app.useGlobalPipes( + new ValidationPipe({ + whitelist: true, + forbidNonWhitelisted: true, + transform: true, + transformOptions: { + enableImplicitConversion: true, + }, + }), + ); + + // Swagger Documentation + const config = new DocumentBuilder() + .setTitle('POS Micro API') + .setDescription( + 'API para punto de venta ultra-minimalista. Target: Puestos de calle, misceláneas, fondas.', + ) + .setVersion('1.0') + .addBearerAuth() + .addTag('auth', 'Autenticación y registro') + .addTag('products', 'Gestión de productos') + .addTag('categories', 'Categorías de productos') + .addTag('sales', 'Ventas y tickets') + .addTag('payments', 'Métodos de pago') + .addTag('reports', 'Reportes y resúmenes') + .addTag('whatsapp', 'Integración WhatsApp') + .build(); + + const document = SwaggerModule.createDocument(app, config); + SwaggerModule.setup('docs', app, document, { + swaggerOptions: { + persistAuthorization: true, + }, + }); + + const port = configService.get('PORT', 3000); + await app.listen(port); + + console.log(` +╔══════════════════════════════════════════════════════════════╗ +║ POS MICRO API ║ +╠══════════════════════════════════════════════════════════════╣ +║ Status: Running ║ +║ Port: ${port} ║ +║ Environment: ${configService.get('NODE_ENV', 'development')} ║ +║ Docs: http://localhost:${port}/docs ║ +╚══════════════════════════════════════════════════════════════╝ + `); +} + +bootstrap(); diff --git a/apps/products/pos-micro/backend/src/modules/auth/auth.controller.ts b/apps/products/pos-micro/backend/src/modules/auth/auth.controller.ts new file mode 100644 index 0000000..6d2f2e4 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/auth/auth.controller.ts @@ -0,0 +1,110 @@ +import { + Controller, + Post, + Body, + HttpCode, + HttpStatus, + UseGuards, + Request, +} from '@nestjs/common'; +import { + ApiTags, + ApiOperation, + ApiResponse, + ApiBearerAuth, +} from '@nestjs/swagger'; +import { AuthService } from './auth.service'; +import { RegisterDto, LoginDto, RefreshTokenDto } from './dto/register.dto'; +import { JwtAuthGuard } from './guards/jwt-auth.guard'; + +@ApiTags('auth') +@Controller('auth') +export class AuthController { + constructor(private readonly authService: AuthService) {} + + @Post('register') + @ApiOperation({ + summary: 'Registrar nuevo negocio', + description: 'Crea un nuevo tenant y usuario con periodo de prueba de 14 días', + }) + @ApiResponse({ + status: 201, + description: 'Registro exitoso', + schema: { + properties: { + accessToken: { type: 'string' }, + refreshToken: { type: 'string' }, + user: { + type: 'object', + properties: { + id: { type: 'string' }, + name: { type: 'string' }, + isOwner: { type: 'boolean' }, + }, + }, + tenant: { + type: 'object', + properties: { + id: { type: 'string' }, + businessName: { type: 'string' }, + plan: { type: 'string' }, + subscriptionStatus: { type: 'string' }, + trialEndsAt: { type: 'string', format: 'date-time' }, + }, + }, + }, + }, + }) + @ApiResponse({ status: 409, description: 'Teléfono ya registrado' }) + async register(@Body() dto: RegisterDto) { + return this.authService.register(dto); + } + + @Post('login') + @HttpCode(HttpStatus.OK) + @ApiOperation({ + summary: 'Iniciar sesión', + description: 'Autenticación con teléfono y PIN', + }) + @ApiResponse({ + status: 200, + description: 'Login exitoso', + }) + @ApiResponse({ status: 401, description: 'Credenciales inválidas' }) + async login(@Body() dto: LoginDto) { + return this.authService.login(dto); + } + + @Post('refresh') + @HttpCode(HttpStatus.OK) + @ApiOperation({ + summary: 'Refrescar token', + description: 'Obtiene un nuevo access token usando el refresh token', + }) + @ApiResponse({ + status: 200, + description: 'Token refrescado exitosamente', + }) + @ApiResponse({ status: 401, description: 'Token inválido o expirado' }) + async refreshToken(@Body() dto: RefreshTokenDto) { + return this.authService.refreshToken(dto.refreshToken); + } + + @Post('change-pin') + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @HttpCode(HttpStatus.OK) + @ApiOperation({ + summary: 'Cambiar PIN', + description: 'Cambiar el PIN de acceso', + }) + @ApiResponse({ status: 200, description: 'PIN cambiado exitosamente' }) + @ApiResponse({ status: 401, description: 'PIN actual incorrecto' }) + async changePin( + @Request() req: { user: { sub: string } }, + @Body() body: { currentPin: string; newPin: string }, + ) { + await this.authService.changePin(req.user.sub, body.currentPin, body.newPin); + return { message: 'PIN cambiado exitosamente' }; + } +} diff --git a/apps/products/pos-micro/backend/src/modules/auth/auth.module.ts b/apps/products/pos-micro/backend/src/modules/auth/auth.module.ts new file mode 100644 index 0000000..8dd49e6 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/auth/auth.module.ts @@ -0,0 +1,32 @@ +import { Module } from '@nestjs/common'; +import { TypeOrmModule } from '@nestjs/typeorm'; +import { JwtModule } from '@nestjs/jwt'; +import { PassportModule } from '@nestjs/passport'; +import { ConfigModule, ConfigService } from '@nestjs/config'; +import { AuthController } from './auth.controller'; +import { AuthService } from './auth.service'; +import { Tenant } from './entities/tenant.entity'; +import { User } from './entities/user.entity'; +import { JwtStrategy } from './strategies/jwt.strategy'; +import { JwtAuthGuard } from './guards/jwt-auth.guard'; + +@Module({ + imports: [ + TypeOrmModule.forFeature([Tenant, User]), + PassportModule.register({ defaultStrategy: 'jwt' }), + JwtModule.registerAsync({ + imports: [ConfigModule], + inject: [ConfigService], + useFactory: (configService: ConfigService) => ({ + secret: configService.get('JWT_SECRET'), + signOptions: { + expiresIn: configService.get('JWT_EXPIRES_IN', '24h'), + }, + }), + }), + ], + controllers: [AuthController], + providers: [AuthService, JwtStrategy, JwtAuthGuard], + exports: [AuthService, JwtAuthGuard, TypeOrmModule], +}) +export class AuthModule {} diff --git a/apps/products/pos-micro/backend/src/modules/auth/auth.service.ts b/apps/products/pos-micro/backend/src/modules/auth/auth.service.ts new file mode 100644 index 0000000..e9db989 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/auth/auth.service.ts @@ -0,0 +1,218 @@ +import { + Injectable, + ConflictException, + UnauthorizedException, + BadRequestException, +} from '@nestjs/common'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository } from 'typeorm'; +import { JwtService } from '@nestjs/jwt'; +import { ConfigService } from '@nestjs/config'; +import * as bcrypt from 'bcrypt'; +import { Tenant, SubscriptionStatus } from './entities/tenant.entity'; +import { User } from './entities/user.entity'; +import { RegisterDto, LoginDto } from './dto/register.dto'; + +export interface TokenPayload { + sub: string; + tenantId: string; + phone: string; +} + +export interface AuthResponse { + accessToken: string; + refreshToken: string; + user: { + id: string; + name: string; + isOwner: boolean; + }; + tenant: { + id: string; + businessName: string; + plan: string; + subscriptionStatus: SubscriptionStatus; + trialEndsAt: Date | null; + }; +} + +@Injectable() +export class AuthService { + constructor( + @InjectRepository(Tenant) + private readonly tenantRepository: Repository, + @InjectRepository(User) + private readonly userRepository: Repository, + private readonly jwtService: JwtService, + private readonly configService: ConfigService, + ) {} + + async register(dto: RegisterDto): Promise { + // Check if phone already registered + const existingTenant = await this.tenantRepository.findOne({ + where: { phone: dto.phone }, + }); + + if (existingTenant) { + throw new ConflictException('Este teléfono ya está registrado'); + } + + // Hash PIN + const pinHash = await bcrypt.hash(dto.pin, 10); + + // Calculate trial end date (14 days) + const trialEndsAt = new Date(); + trialEndsAt.setDate(trialEndsAt.getDate() + 14); + + // Create tenant + const tenant = this.tenantRepository.create({ + businessName: dto.businessName, + ownerName: dto.ownerName, + phone: dto.phone, + whatsapp: dto.whatsapp || dto.phone, + email: dto.email, + address: dto.address, + city: dto.city, + subscriptionStatus: SubscriptionStatus.TRIAL, + trialEndsAt, + }); + + const savedTenant = await this.tenantRepository.save(tenant); + + // Create user + const user = this.userRepository.create({ + tenantId: savedTenant.id, + name: dto.ownerName, + pinHash, + isOwner: true, + }); + + const savedUser = await this.userRepository.save(user); + + // Generate tokens + return this.generateTokens(savedUser, savedTenant); + } + + async login(dto: LoginDto): Promise { + // Find tenant by phone + const tenant = await this.tenantRepository.findOne({ + where: { phone: dto.phone }, + }); + + if (!tenant) { + throw new UnauthorizedException('Teléfono o PIN incorrectos'); + } + + // Check subscription status + if (tenant.subscriptionStatus === SubscriptionStatus.CANCELLED) { + throw new UnauthorizedException('Tu suscripción ha sido cancelada'); + } + + if (tenant.subscriptionStatus === SubscriptionStatus.SUSPENDED) { + throw new UnauthorizedException('Tu cuenta está suspendida. Contacta soporte.'); + } + + // Find user + const user = await this.userRepository.findOne({ + where: { tenantId: tenant.id }, + }); + + if (!user) { + throw new UnauthorizedException('Teléfono o PIN incorrectos'); + } + + // Verify PIN + const isValidPin = await bcrypt.compare(dto.pin, user.pinHash); + + if (!isValidPin) { + throw new UnauthorizedException('Teléfono o PIN incorrectos'); + } + + // Update last login + user.lastLoginAt = new Date(); + await this.userRepository.save(user); + + // Generate tokens + return this.generateTokens(user, tenant); + } + + async refreshToken(refreshToken: string): Promise { + try { + const payload = this.jwtService.verify(refreshToken, { + secret: this.configService.get('JWT_SECRET'), + }); + + const user = await this.userRepository.findOne({ + where: { id: payload.sub }, + }); + + if (!user) { + throw new UnauthorizedException('Token inválido'); + } + + const tenant = await this.tenantRepository.findOne({ + where: { id: user.tenantId }, + }); + + if (!tenant) { + throw new UnauthorizedException('Token inválido'); + } + + return this.generateTokens(user, tenant); + } catch { + throw new UnauthorizedException('Token inválido o expirado'); + } + } + + async changePin(userId: string, currentPin: string, newPin: string): Promise { + const user = await this.userRepository.findOne({ + where: { id: userId }, + }); + + if (!user) { + throw new BadRequestException('Usuario no encontrado'); + } + + const isValidPin = await bcrypt.compare(currentPin, user.pinHash); + + if (!isValidPin) { + throw new UnauthorizedException('PIN actual incorrecto'); + } + + user.pinHash = await bcrypt.hash(newPin, 10); + await this.userRepository.save(user); + } + + private generateTokens(user: User, tenant: Tenant): AuthResponse { + const payload: TokenPayload = { + sub: user.id, + tenantId: tenant.id, + phone: tenant.phone, + }; + + const accessToken = this.jwtService.sign(payload, { + expiresIn: this.configService.get('JWT_EXPIRES_IN', '24h'), + }); + + const refreshToken = this.jwtService.sign(payload, { + expiresIn: this.configService.get('JWT_REFRESH_EXPIRES_IN', '7d'), + }); + + return { + accessToken, + refreshToken, + user: { + id: user.id, + name: user.name, + isOwner: user.isOwner, + }, + tenant: { + id: tenant.id, + businessName: tenant.businessName, + plan: tenant.plan, + subscriptionStatus: tenant.subscriptionStatus, + trialEndsAt: tenant.trialEndsAt, + }, + }; + } +} diff --git a/apps/products/pos-micro/backend/src/modules/auth/dto/register.dto.ts b/apps/products/pos-micro/backend/src/modules/auth/dto/register.dto.ts new file mode 100644 index 0000000..1e2766e --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/auth/dto/register.dto.ts @@ -0,0 +1,134 @@ +import { ApiProperty } from '@nestjs/swagger'; +import { + IsString, + IsNotEmpty, + MinLength, + MaxLength, + IsOptional, + IsEmail, + Matches, +} from 'class-validator'; + +export class RegisterDto { + @ApiProperty({ + description: 'Nombre del negocio', + example: 'Tacos El Güero', + minLength: 2, + maxLength: 200, + }) + @IsString() + @IsNotEmpty() + @MinLength(2) + @MaxLength(200) + businessName: string; + + @ApiProperty({ + description: 'Nombre del propietario', + example: 'Juan Pérez', + minLength: 2, + maxLength: 200, + }) + @IsString() + @IsNotEmpty() + @MinLength(2) + @MaxLength(200) + ownerName: string; + + @ApiProperty({ + description: 'Teléfono (10 dígitos)', + example: '5512345678', + }) + @IsString() + @IsNotEmpty() + @Matches(/^[0-9]{10}$/, { + message: 'El teléfono debe tener exactamente 10 dígitos', + }) + phone: string; + + @ApiProperty({ + description: 'PIN de acceso rápido (4-6 dígitos)', + example: '1234', + minLength: 4, + maxLength: 6, + }) + @IsString() + @IsNotEmpty() + @Matches(/^[0-9]{4,6}$/, { + message: 'El PIN debe tener entre 4 y 6 dígitos', + }) + pin: string; + + @ApiProperty({ + description: 'Número de WhatsApp (opcional)', + example: '5512345678', + required: false, + }) + @IsOptional() + @IsString() + @Matches(/^[0-9]{10}$/, { + message: 'El WhatsApp debe tener exactamente 10 dígitos', + }) + whatsapp?: string; + + @ApiProperty({ + description: 'Email (opcional)', + example: 'juan@ejemplo.com', + required: false, + }) + @IsOptional() + @IsEmail({}, { message: 'Email inválido' }) + email?: string; + + @ApiProperty({ + description: 'Dirección del negocio (opcional)', + example: 'Calle Principal #123, Colonia Centro', + required: false, + }) + @IsOptional() + @IsString() + @MaxLength(500) + address?: string; + + @ApiProperty({ + description: 'Ciudad (opcional)', + example: 'Ciudad de México', + required: false, + }) + @IsOptional() + @IsString() + @MaxLength(100) + city?: string; +} + +export class LoginDto { + @ApiProperty({ + description: 'Teléfono registrado', + example: '5512345678', + }) + @IsString() + @IsNotEmpty() + @Matches(/^[0-9]{10}$/, { + message: 'El teléfono debe tener exactamente 10 dígitos', + }) + phone: string; + + @ApiProperty({ + description: 'PIN de acceso', + example: '1234', + }) + @IsString() + @IsNotEmpty() + @Matches(/^[0-9]{4,6}$/, { + message: 'El PIN debe tener entre 4 y 6 dígitos', + }) + pin: string; +} + +export class RefreshTokenDto { + @ApiProperty({ + description: 'Token de refresco', + }) + @IsString() + @IsNotEmpty() + refreshToken: string; +} diff --git a/apps/products/pos-micro/backend/src/modules/auth/entities/tenant.entity.ts b/apps/products/pos-micro/backend/src/modules/auth/entities/tenant.entity.ts new file mode 100644 index 0000000..bada07d --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/auth/entities/tenant.entity.ts @@ -0,0 +1,94 @@ +import { + Entity, + PrimaryGeneratedColumn, + Column, + CreateDateColumn, + UpdateDateColumn, + OneToMany, +} from 'typeorm'; +import { User } from './user.entity'; + +export enum SubscriptionStatus { + TRIAL = 'trial', + ACTIVE = 'active', + SUSPENDED = 'suspended', + CANCELLED = 'cancelled', +} + +@Entity({ schema: 'pos_micro', name: 'tenants' }) +export class Tenant { + @PrimaryGeneratedColumn('uuid') + id: string; + + @Column({ name: 'business_name', length: 200 }) + businessName: string; + + @Column({ name: 'owner_name', length: 200 }) + ownerName: string; + + @Column({ length: 20 }) + phone: string; + + @Column({ length: 20, nullable: true }) + whatsapp: string; + + @Column({ length: 255, nullable: true }) + email: string; + + @Column({ type: 'text', nullable: true }) + address: string; + + @Column({ length: 100, nullable: true }) + city: string; + + @Column({ length: 50, default: 'México' }) + state: string; + + @Column({ length: 20, default: 'micro' }) + plan: string; + + @Column({ + name: 'subscription_status', + type: 'enum', + enum: SubscriptionStatus, + default: SubscriptionStatus.TRIAL, + }) + subscriptionStatus: SubscriptionStatus; + + @Column({ name: 'trial_ends_at', type: 'timestamp', nullable: true }) + trialEndsAt: Date; + + @Column({ name: 'subscription_ends_at', type: 'timestamp', nullable: true }) + subscriptionEndsAt: Date; + + @Column({ length: 3, default: 'MXN' }) + currency: string; + + @Column({ name: 'tax_rate', type: 'decimal', precision: 5, scale: 2, default: 16.0 }) + taxRate: number; + + @Column({ length: 50, default: 'America/Mexico_City' }) + timezone: string; + + @Column({ type: 'jsonb', default: {} }) + settings: Record; + + @Column({ name: 'max_products', default: 500 }) + maxProducts: number; + + @Column({ name: 'max_sales_per_month', default: 1000 }) + maxSalesPerMonth: number; + + @Column({ name: 'current_month_sales', default: 0 }) + currentMonthSales: number; + + @CreateDateColumn({ name: 'created_at' }) + createdAt: Date; + + @UpdateDateColumn({ name: 'updated_at' }) + updatedAt: Date; + + // Relations + @OneToMany(() => User, (user) => user.tenant) + users: User[]; +} diff --git a/apps/products/pos-micro/backend/src/modules/auth/entities/user.entity.ts b/apps/products/pos-micro/backend/src/modules/auth/entities/user.entity.ts new file mode 100644 index 0000000..db7710f --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/auth/entities/user.entity.ts @@ -0,0 +1,48 @@ +import { + Entity, + PrimaryGeneratedColumn, + Column, + CreateDateColumn, + UpdateDateColumn, + ManyToOne, + JoinColumn, +} from 'typeorm'; +import { Tenant } from './tenant.entity'; + +@Entity({ schema: 'pos_micro', name: 'users' }) +export class User { + @PrimaryGeneratedColumn('uuid') + id: string; + + @Column({ name: 'tenant_id' }) + tenantId: string; + + @Column({ name: 'pin_hash', length: 255 }) + pinHash: string; + + @Column({ name: 'password_hash', length: 255, nullable: true }) + passwordHash: string; + + @Column({ length: 200 }) + name: string; + + @Column({ name: 'is_owner', default: true }) + isOwner: boolean; + + @Column({ name: 'last_login_at', type: 'timestamp', nullable: true }) + lastLoginAt: Date; + + @Column({ name: 'last_login_device', type: 'jsonb', nullable: true }) + lastLoginDevice: Record; + + @CreateDateColumn({ name: 'created_at' }) + createdAt: Date; + + @UpdateDateColumn({ name: 'updated_at' }) + updatedAt: Date; + + // Relations + @ManyToOne(() => Tenant, (tenant) => tenant.users) + @JoinColumn({ name: 'tenant_id' }) + tenant: Tenant; +} diff --git a/apps/products/pos-micro/backend/src/modules/auth/guards/jwt-auth.guard.ts b/apps/products/pos-micro/backend/src/modules/auth/guards/jwt-auth.guard.ts new file mode 100644 index 0000000..0f4e152 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/auth/guards/jwt-auth.guard.ts @@ -0,0 +1,16 @@ +import { Injectable, ExecutionContext, UnauthorizedException } from '@nestjs/common'; +import { AuthGuard } from '@nestjs/passport'; + +@Injectable() +export class JwtAuthGuard extends AuthGuard('jwt') { + canActivate(context: ExecutionContext) { + return super.canActivate(context); + } + + handleRequest(err: Error | null, user: TUser): TUser { + if (err || !user) { + throw err || new UnauthorizedException('Token inválido o expirado'); + } + return user; + } +} diff --git a/apps/products/pos-micro/backend/src/modules/auth/strategies/jwt.strategy.ts b/apps/products/pos-micro/backend/src/modules/auth/strategies/jwt.strategy.ts new file mode 100644 index 0000000..00411db --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/auth/strategies/jwt.strategy.ts @@ -0,0 +1,39 @@ +import { Injectable, UnauthorizedException } from '@nestjs/common'; +import { PassportStrategy } from '@nestjs/passport'; +import { ExtractJwt, Strategy } from 'passport-jwt'; +import { ConfigService } from '@nestjs/config'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository } from 'typeorm'; +import { User } from '../entities/user.entity'; +import { TokenPayload } from '../auth.service'; + +@Injectable() +export class JwtStrategy extends PassportStrategy(Strategy) { + constructor( + private readonly configService: ConfigService, + @InjectRepository(User) + private readonly userRepository: Repository, + ) { + super({ + jwtFromRequest: ExtractJwt.fromAuthHeaderAsBearerToken(), + ignoreExpiration: false, + secretOrKey: configService.get('JWT_SECRET'), + }); + } + + async validate(payload: TokenPayload) { + const user = await this.userRepository.findOne({ + where: { id: payload.sub }, + }); + + if (!user) { + throw new UnauthorizedException('Usuario no encontrado'); + } + + return { + sub: payload.sub, + tenantId: payload.tenantId, + phone: payload.phone, + }; + } +} diff --git a/apps/products/pos-micro/backend/src/modules/categories/categories.controller.ts b/apps/products/pos-micro/backend/src/modules/categories/categories.controller.ts new file mode 100644 index 0000000..b1f7195 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/categories/categories.controller.ts @@ -0,0 +1,94 @@ +import { + Controller, + Get, + Post, + Put, + Patch, + Delete, + Body, + Param, + Query, + UseGuards, + Request, + ParseUUIDPipe, + HttpCode, + HttpStatus, +} from '@nestjs/common'; +import { + ApiTags, + ApiOperation, + ApiResponse, + ApiBearerAuth, + ApiParam, +} from '@nestjs/swagger'; +import { CategoriesService, CreateCategoryDto, UpdateCategoryDto } from './categories.service'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; + +@ApiTags('categories') +@ApiBearerAuth() +@UseGuards(JwtAuthGuard) +@Controller('categories') +export class CategoriesController { + constructor(private readonly categoriesService: CategoriesService) {} + + @Get() + @ApiOperation({ summary: 'Listar categorías' }) + async findAll( + @Request() req: { user: { tenantId: string } }, + @Query('includeInactive') includeInactive?: boolean, + ) { + return this.categoriesService.findAll(req.user.tenantId, includeInactive); + } + + @Get(':id') + @ApiOperation({ summary: 'Obtener categoría por ID' }) + @ApiParam({ name: 'id', description: 'ID de la categoría' }) + async findOne( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + return this.categoriesService.findOne(req.user.tenantId, id); + } + + @Post() + @ApiOperation({ summary: 'Crear categoría' }) + @ApiResponse({ status: 201, description: 'Categoría creada' }) + async create( + @Request() req: { user: { tenantId: string } }, + @Body() dto: CreateCategoryDto, + ) { + return this.categoriesService.create(req.user.tenantId, dto); + } + + @Put(':id') + @ApiOperation({ summary: 'Actualizar categoría' }) + @ApiParam({ name: 'id', description: 'ID de la categoría' }) + async update( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + @Body() dto: UpdateCategoryDto, + ) { + return this.categoriesService.update(req.user.tenantId, id, dto); + } + + @Patch(':id/toggle-active') + @ApiOperation({ summary: 'Activar/desactivar categoría' }) + @ApiParam({ name: 'id', description: 'ID de la categoría' }) + async toggleActive( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + return this.categoriesService.toggleActive(req.user.tenantId, id); + } + + @Delete(':id') + @HttpCode(HttpStatus.NO_CONTENT) + @ApiOperation({ summary: 'Eliminar categoría' }) + @ApiParam({ name: 'id', description: 'ID de la categoría' }) + async delete( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + await this.categoriesService.delete(req.user.tenantId, id); + } +} diff --git a/apps/products/pos-micro/backend/src/modules/categories/categories.module.ts b/apps/products/pos-micro/backend/src/modules/categories/categories.module.ts new file mode 100644 index 0000000..67734cf --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/categories/categories.module.ts @@ -0,0 +1,17 @@ +import { Module } from '@nestjs/common'; +import { TypeOrmModule } from '@nestjs/typeorm'; +import { CategoriesController } from './categories.controller'; +import { CategoriesService } from './categories.service'; +import { Category } from './entities/category.entity'; +import { AuthModule } from '../auth/auth.module'; + +@Module({ + imports: [ + TypeOrmModule.forFeature([Category]), + AuthModule, + ], + controllers: [CategoriesController], + providers: [CategoriesService], + exports: [CategoriesService, TypeOrmModule], +}) +export class CategoriesModule {} diff --git a/apps/products/pos-micro/backend/src/modules/categories/categories.service.ts b/apps/products/pos-micro/backend/src/modules/categories/categories.service.ts new file mode 100644 index 0000000..ec851da --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/categories/categories.service.ts @@ -0,0 +1,115 @@ +import { + Injectable, + NotFoundException, + ConflictException, + BadRequestException, +} from '@nestjs/common'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository } from 'typeorm'; +import { Category } from './entities/category.entity'; + +const MAX_CATEGORIES = 20; + +export class CreateCategoryDto { + name: string; + color?: string; + icon?: string; + sortOrder?: number; +} + +export class UpdateCategoryDto { + name?: string; + color?: string; + icon?: string; + sortOrder?: number; + isActive?: boolean; +} + +@Injectable() +export class CategoriesService { + constructor( + @InjectRepository(Category) + private readonly categoryRepository: Repository, + ) {} + + async findAll(tenantId: string, includeInactive = false): Promise { + const where: Record = { tenantId }; + + if (!includeInactive) { + where.isActive = true; + } + + return this.categoryRepository.find({ + where, + order: { sortOrder: 'ASC', name: 'ASC' }, + }); + } + + async findOne(tenantId: string, id: string): Promise { + const category = await this.categoryRepository.findOne({ + where: { id, tenantId }, + }); + + if (!category) { + throw new NotFoundException('Categoría no encontrada'); + } + + return category; + } + + async create(tenantId: string, dto: CreateCategoryDto): Promise { + // Check limit + const count = await this.categoryRepository.count({ where: { tenantId } }); + + if (count >= MAX_CATEGORIES) { + throw new BadRequestException( + `Has alcanzado el límite de ${MAX_CATEGORIES} categorías`, + ); + } + + // Check name uniqueness + const existing = await this.categoryRepository.findOne({ + where: { tenantId, name: dto.name }, + }); + + if (existing) { + throw new ConflictException('Ya existe una categoría con ese nombre'); + } + + const category = this.categoryRepository.create({ + ...dto, + tenantId, + }); + + return this.categoryRepository.save(category); + } + + async update(tenantId: string, id: string, dto: UpdateCategoryDto): Promise { + const category = await this.findOne(tenantId, id); + + // Check name uniqueness if changed + if (dto.name && dto.name !== category.name) { + const existing = await this.categoryRepository.findOne({ + where: { tenantId, name: dto.name }, + }); + + if (existing) { + throw new ConflictException('Ya existe una categoría con ese nombre'); + } + } + + Object.assign(category, dto); + return this.categoryRepository.save(category); + } + + async delete(tenantId: string, id: string): Promise { + const category = await this.findOne(tenantId, id); + await this.categoryRepository.remove(category); + } + + async toggleActive(tenantId: string, id: string): Promise { + const category = await this.findOne(tenantId, id); + category.isActive = !category.isActive; + return this.categoryRepository.save(category); + } +} diff --git a/apps/products/pos-micro/backend/src/modules/categories/entities/category.entity.ts b/apps/products/pos-micro/backend/src/modules/categories/entities/category.entity.ts new file mode 100644 index 0000000..a3c1612 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/categories/entities/category.entity.ts @@ -0,0 +1,43 @@ +import { + Entity, + PrimaryGeneratedColumn, + Column, + CreateDateColumn, + UpdateDateColumn, + OneToMany, +} from 'typeorm'; +import { Product } from '../../products/entities/product.entity'; + +@Entity({ schema: 'pos_micro', name: 'categories' }) +export class Category { + @PrimaryGeneratedColumn('uuid') + id: string; + + @Column({ name: 'tenant_id' }) + tenantId: string; + + @Column({ length: 100 }) + name: string; + + @Column({ length: 7, default: '#3B82F6' }) + color: string; + + @Column({ length: 50, default: 'package' }) + icon: string; + + @Column({ name: 'sort_order', default: 0 }) + sortOrder: number; + + @Column({ name: 'is_active', default: true }) + isActive: boolean; + + @CreateDateColumn({ name: 'created_at' }) + createdAt: Date; + + @UpdateDateColumn({ name: 'updated_at' }) + updatedAt: Date; + + // Relations + @OneToMany(() => Product, (product) => product.category) + products: Product[]; +} diff --git a/apps/products/pos-micro/backend/src/modules/payments/entities/payment-method.entity.ts b/apps/products/pos-micro/backend/src/modules/payments/entities/payment-method.entity.ts new file mode 100644 index 0000000..72497db --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/payments/entities/payment-method.entity.ts @@ -0,0 +1,36 @@ +import { + Entity, + PrimaryGeneratedColumn, + Column, + CreateDateColumn, +} from 'typeorm'; + +@Entity({ schema: 'pos_micro', name: 'payment_methods' }) +export class PaymentMethod { + @PrimaryGeneratedColumn('uuid') + id: string; + + @Column({ name: 'tenant_id' }) + tenantId: string; + + @Column({ length: 20 }) + code: string; + + @Column({ length: 100 }) + name: string; + + @Column({ length: 50, default: 'banknote' }) + icon: string; + + @Column({ name: 'is_default', default: false }) + isDefault: boolean; + + @Column({ name: 'is_active', default: true }) + isActive: boolean; + + @Column({ name: 'sort_order', default: 0 }) + sortOrder: number; + + @CreateDateColumn({ name: 'created_at' }) + createdAt: Date; +} diff --git a/apps/products/pos-micro/backend/src/modules/payments/payments.controller.ts b/apps/products/pos-micro/backend/src/modules/payments/payments.controller.ts new file mode 100644 index 0000000..154bd4b --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/payments/payments.controller.ts @@ -0,0 +1,77 @@ +import { + Controller, + Get, + Post, + Patch, + Param, + UseGuards, + Request, + ParseUUIDPipe, +} from '@nestjs/common'; +import { + ApiTags, + ApiOperation, + ApiResponse, + ApiBearerAuth, + ApiParam, +} from '@nestjs/swagger'; +import { PaymentsService } from './payments.service'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; + +@ApiTags('payments') +@ApiBearerAuth() +@UseGuards(JwtAuthGuard) +@Controller('payment-methods') +export class PaymentsController { + constructor(private readonly paymentsService: PaymentsService) {} + + @Get() + @ApiOperation({ summary: 'Listar métodos de pago' }) + @ApiResponse({ status: 200, description: 'Lista de métodos de pago' }) + async findAll(@Request() req: { user: { tenantId: string } }) { + return this.paymentsService.findAll(req.user.tenantId); + } + + @Get('default') + @ApiOperation({ summary: 'Obtener método de pago por defecto' }) + async getDefault(@Request() req: { user: { tenantId: string } }) { + return this.paymentsService.getDefault(req.user.tenantId); + } + + @Get(':id') + @ApiOperation({ summary: 'Obtener método de pago por ID' }) + @ApiParam({ name: 'id', description: 'ID del método de pago' }) + async findOne( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + return this.paymentsService.findOne(req.user.tenantId, id); + } + + @Post('initialize') + @ApiOperation({ summary: 'Inicializar métodos de pago por defecto' }) + @ApiResponse({ status: 201, description: 'Métodos de pago inicializados' }) + async initialize(@Request() req: { user: { tenantId: string } }) { + return this.paymentsService.initializeForTenant(req.user.tenantId); + } + + @Patch(':id/toggle-active') + @ApiOperation({ summary: 'Activar/desactivar método de pago' }) + @ApiParam({ name: 'id', description: 'ID del método de pago' }) + async toggleActive( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + return this.paymentsService.toggleActive(req.user.tenantId, id); + } + + @Patch(':id/set-default') + @ApiOperation({ summary: 'Establecer como método de pago por defecto' }) + @ApiParam({ name: 'id', description: 'ID del método de pago' }) + async setDefault( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + return this.paymentsService.setDefault(req.user.tenantId, id); + } +} diff --git a/apps/products/pos-micro/backend/src/modules/payments/payments.module.ts b/apps/products/pos-micro/backend/src/modules/payments/payments.module.ts new file mode 100644 index 0000000..99b529a --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/payments/payments.module.ts @@ -0,0 +1,17 @@ +import { Module } from '@nestjs/common'; +import { TypeOrmModule } from '@nestjs/typeorm'; +import { PaymentsController } from './payments.controller'; +import { PaymentsService } from './payments.service'; +import { PaymentMethod } from './entities/payment-method.entity'; +import { AuthModule } from '../auth/auth.module'; + +@Module({ + imports: [ + TypeOrmModule.forFeature([PaymentMethod]), + AuthModule, + ], + controllers: [PaymentsController], + providers: [PaymentsService], + exports: [PaymentsService, TypeOrmModule], +}) +export class PaymentsModule {} diff --git a/apps/products/pos-micro/backend/src/modules/payments/payments.service.ts b/apps/products/pos-micro/backend/src/modules/payments/payments.service.ts new file mode 100644 index 0000000..ecdfc78 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/payments/payments.service.ts @@ -0,0 +1,84 @@ +import { Injectable, NotFoundException } from '@nestjs/common'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository } from 'typeorm'; +import { PaymentMethod } from './entities/payment-method.entity'; + +const DEFAULT_PAYMENT_METHODS = [ + { code: 'cash', name: 'Efectivo', icon: 'banknote', isDefault: true, sortOrder: 1 }, + { code: 'card', name: 'Tarjeta', icon: 'credit-card', isDefault: false, sortOrder: 2 }, + { code: 'transfer', name: 'Transferencia', icon: 'smartphone', isDefault: false, sortOrder: 3 }, +]; + +@Injectable() +export class PaymentsService { + constructor( + @InjectRepository(PaymentMethod) + private readonly paymentMethodRepository: Repository, + ) {} + + async findAll(tenantId: string): Promise { + return this.paymentMethodRepository.find({ + where: { tenantId, isActive: true }, + order: { sortOrder: 'ASC' }, + }); + } + + async findOne(tenantId: string, id: string): Promise { + const method = await this.paymentMethodRepository.findOne({ + where: { id, tenantId }, + }); + + if (!method) { + throw new NotFoundException('Método de pago no encontrado'); + } + + return method; + } + + async getDefault(tenantId: string): Promise { + return this.paymentMethodRepository.findOne({ + where: { tenantId, isDefault: true, isActive: true }, + }); + } + + async initializeForTenant(tenantId: string): Promise { + const existing = await this.paymentMethodRepository.count({ + where: { tenantId }, + }); + + if (existing > 0) { + return this.findAll(tenantId); + } + + const methods: PaymentMethod[] = []; + + for (const method of DEFAULT_PAYMENT_METHODS) { + const paymentMethod = this.paymentMethodRepository.create({ + ...method, + tenantId, + }); + methods.push(await this.paymentMethodRepository.save(paymentMethod)); + } + + return methods; + } + + async toggleActive(tenantId: string, id: string): Promise { + const method = await this.findOne(tenantId, id); + method.isActive = !method.isActive; + return this.paymentMethodRepository.save(method); + } + + async setDefault(tenantId: string, id: string): Promise { + // Remove default from all + await this.paymentMethodRepository.update( + { tenantId }, + { isDefault: false }, + ); + + // Set new default + const method = await this.findOne(tenantId, id); + method.isDefault = true; + return this.paymentMethodRepository.save(method); + } +} diff --git a/apps/products/pos-micro/backend/src/modules/products/dto/product.dto.ts b/apps/products/pos-micro/backend/src/modules/products/dto/product.dto.ts new file mode 100644 index 0000000..dfd7aef --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/products/dto/product.dto.ts @@ -0,0 +1,179 @@ +import { ApiProperty, PartialType } from '@nestjs/swagger'; +import { + IsString, + IsNotEmpty, + IsOptional, + IsNumber, + IsBoolean, + IsUUID, + Min, + MaxLength, + IsUrl, + Matches, +} from 'class-validator'; + +export class CreateProductDto { + @ApiProperty({ + description: 'Nombre del producto', + example: 'Taco de Pastor', + }) + @IsString() + @IsNotEmpty() + @MaxLength(200) + name: string; + + @ApiProperty({ + description: 'Precio de venta', + example: 25.0, + minimum: 0, + }) + @IsNumber() + @Min(0) + price: number; + + @ApiProperty({ + description: 'SKU único (opcional)', + example: 'TACO-001', + required: false, + }) + @IsOptional() + @IsString() + @MaxLength(50) + sku?: string; + + @ApiProperty({ + description: 'Código de barras (opcional)', + example: '7501234567890', + required: false, + }) + @IsOptional() + @IsString() + @MaxLength(50) + barcode?: string; + + @ApiProperty({ + description: 'ID de la categoría', + required: false, + }) + @IsOptional() + @IsUUID() + categoryId?: string; + + @ApiProperty({ + description: 'Costo de compra', + example: 15.0, + required: false, + }) + @IsOptional() + @IsNumber() + @Min(0) + cost?: number; + + @ApiProperty({ + description: 'El precio ya incluye IVA', + default: true, + }) + @IsOptional() + @IsBoolean() + taxIncluded?: boolean; + + @ApiProperty({ + description: 'Controlar inventario', + default: false, + }) + @IsOptional() + @IsBoolean() + trackStock?: boolean; + + @ApiProperty({ + description: 'Cantidad en stock inicial', + example: 100, + required: false, + }) + @IsOptional() + @IsNumber() + stockQuantity?: number; + + @ApiProperty({ + description: 'Alerta de stock bajo', + example: 10, + required: false, + }) + @IsOptional() + @IsNumber() + @Min(0) + lowStockAlert?: number; + + @ApiProperty({ + description: 'URL de imagen', + required: false, + }) + @IsOptional() + @IsUrl() + @MaxLength(500) + imageUrl?: string; + + @ApiProperty({ + description: 'Color identificador (hex)', + example: '#FF5733', + required: false, + }) + @IsOptional() + @IsString() + @Matches(/^#[0-9A-Fa-f]{6}$/, { + message: 'El color debe ser un código hex válido (#RRGGBB)', + }) + color?: string; + + @ApiProperty({ + description: 'Marcar como favorito', + default: false, + }) + @IsOptional() + @IsBoolean() + isFavorite?: boolean; +} + +export class UpdateProductDto extends PartialType(CreateProductDto) {} + +export class ProductFilterDto { + @ApiProperty({ + description: 'Filtrar por categoría', + required: false, + }) + @IsOptional() + @IsUUID() + categoryId?: string; + + @ApiProperty({ + description: 'Buscar por nombre o SKU', + required: false, + }) + @IsOptional() + @IsString() + search?: string; + + @ApiProperty({ + description: 'Solo favoritos', + required: false, + }) + @IsOptional() + @IsBoolean() + favorites?: boolean; + + @ApiProperty({ + description: 'Solo activos', + default: true, + }) + @IsOptional() + @IsBoolean() + active?: boolean; + + @ApiProperty({ + description: 'Solo con stock bajo', + required: false, + }) + @IsOptional() + @IsBoolean() + lowStock?: boolean; +} diff --git a/apps/products/pos-micro/backend/src/modules/products/entities/product.entity.ts b/apps/products/pos-micro/backend/src/modules/products/entities/product.entity.ts new file mode 100644 index 0000000..691c021 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/products/entities/product.entity.ts @@ -0,0 +1,75 @@ +import { + Entity, + PrimaryGeneratedColumn, + Column, + CreateDateColumn, + UpdateDateColumn, + ManyToOne, + JoinColumn, +} from 'typeorm'; +import { Category } from '../../categories/entities/category.entity'; + +@Entity({ schema: 'pos_micro', name: 'products' }) +export class Product { + @PrimaryGeneratedColumn('uuid') + id: string; + + @Column({ name: 'tenant_id' }) + tenantId: string; + + @Column({ name: 'category_id', nullable: true }) + categoryId: string; + + @Column({ length: 50, nullable: true }) + sku: string; + + @Column({ length: 50, nullable: true }) + barcode: string; + + @Column({ length: 200 }) + name: string; + + @Column({ type: 'decimal', precision: 12, scale: 2 }) + price: number; + + @Column({ type: 'decimal', precision: 12, scale: 2, default: 0 }) + cost: number; + + @Column({ name: 'tax_included', default: true }) + taxIncluded: boolean; + + @Column({ name: 'track_stock', default: false }) + trackStock: boolean; + + @Column({ name: 'stock_quantity', type: 'decimal', precision: 12, scale: 3, default: 0 }) + stockQuantity: number; + + @Column({ name: 'low_stock_alert', default: 5 }) + lowStockAlert: number; + + @Column({ name: 'image_url', length: 500, nullable: true }) + imageUrl: string; + + @Column({ length: 7, nullable: true }) + color: string; + + @Column({ name: 'is_favorite', default: false }) + isFavorite: boolean; + + @Column({ name: 'sort_order', default: 0 }) + sortOrder: number; + + @Column({ name: 'is_active', default: true }) + isActive: boolean; + + @CreateDateColumn({ name: 'created_at' }) + createdAt: Date; + + @UpdateDateColumn({ name: 'updated_at' }) + updatedAt: Date; + + // Relations + @ManyToOne(() => Category, (category) => category.products, { nullable: true }) + @JoinColumn({ name: 'category_id' }) + category: Category; +} diff --git a/apps/products/pos-micro/backend/src/modules/products/products.controller.ts b/apps/products/pos-micro/backend/src/modules/products/products.controller.ts new file mode 100644 index 0000000..43e5aba --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/products/products.controller.ts @@ -0,0 +1,147 @@ +import { + Controller, + Get, + Post, + Put, + Patch, + Delete, + Body, + Param, + Query, + UseGuards, + Request, + ParseUUIDPipe, + HttpCode, + HttpStatus, +} from '@nestjs/common'; +import { + ApiTags, + ApiOperation, + ApiResponse, + ApiBearerAuth, + ApiParam, + ApiQuery, +} from '@nestjs/swagger'; +import { ProductsService } from './products.service'; +import { CreateProductDto, UpdateProductDto, ProductFilterDto } from './dto/product.dto'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; + +@ApiTags('products') +@ApiBearerAuth() +@UseGuards(JwtAuthGuard) +@Controller('products') +export class ProductsController { + constructor(private readonly productsService: ProductsService) {} + + @Get() + @ApiOperation({ summary: 'Listar productos' }) + @ApiResponse({ status: 200, description: 'Lista de productos' }) + async findAll( + @Request() req: { user: { tenantId: string } }, + @Query() filters: ProductFilterDto, + ) { + return this.productsService.findAll(req.user.tenantId, filters); + } + + @Get('favorites') + @ApiOperation({ summary: 'Obtener productos favoritos' }) + async getFavorites(@Request() req: { user: { tenantId: string } }) { + return this.productsService.findAll(req.user.tenantId, { favorites: true }); + } + + @Get('low-stock') + @ApiOperation({ summary: 'Obtener productos con stock bajo' }) + async getLowStock(@Request() req: { user: { tenantId: string } }) { + return this.productsService.getLowStockProducts(req.user.tenantId); + } + + @Get('barcode/:barcode') + @ApiOperation({ summary: 'Buscar producto por código de barras' }) + @ApiParam({ name: 'barcode', description: 'Código de barras' }) + async findByBarcode( + @Request() req: { user: { tenantId: string } }, + @Param('barcode') barcode: string, + ) { + return this.productsService.findByBarcode(req.user.tenantId, barcode); + } + + @Get(':id') + @ApiOperation({ summary: 'Obtener producto por ID' }) + @ApiParam({ name: 'id', description: 'ID del producto' }) + async findOne( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + return this.productsService.findOne(req.user.tenantId, id); + } + + @Post() + @ApiOperation({ summary: 'Crear producto' }) + @ApiResponse({ status: 201, description: 'Producto creado' }) + @ApiResponse({ status: 409, description: 'SKU o código de barras duplicado' }) + @ApiResponse({ status: 400, description: 'Límite de productos alcanzado' }) + async create( + @Request() req: { user: { tenantId: string } }, + @Body() dto: CreateProductDto, + ) { + return this.productsService.create(req.user.tenantId, dto); + } + + @Put(':id') + @ApiOperation({ summary: 'Actualizar producto' }) + @ApiParam({ name: 'id', description: 'ID del producto' }) + async update( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + @Body() dto: UpdateProductDto, + ) { + return this.productsService.update(req.user.tenantId, id, dto); + } + + @Patch(':id/toggle-active') + @ApiOperation({ summary: 'Activar/desactivar producto' }) + @ApiParam({ name: 'id', description: 'ID del producto' }) + async toggleActive( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + return this.productsService.toggleActive(req.user.tenantId, id); + } + + @Patch(':id/toggle-favorite') + @ApiOperation({ summary: 'Marcar/desmarcar como favorito' }) + @ApiParam({ name: 'id', description: 'ID del producto' }) + async toggleFavorite( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + return this.productsService.toggleFavorite(req.user.tenantId, id); + } + + @Patch(':id/adjust-stock') + @ApiOperation({ summary: 'Ajustar stock manualmente' }) + @ApiParam({ name: 'id', description: 'ID del producto' }) + async adjustStock( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + @Body() body: { adjustment: number; reason?: string }, + ) { + return this.productsService.adjustStock( + req.user.tenantId, + id, + body.adjustment, + body.reason, + ); + } + + @Delete(':id') + @HttpCode(HttpStatus.NO_CONTENT) + @ApiOperation({ summary: 'Eliminar producto' }) + @ApiParam({ name: 'id', description: 'ID del producto' }) + async delete( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + await this.productsService.delete(req.user.tenantId, id); + } +} diff --git a/apps/products/pos-micro/backend/src/modules/products/products.module.ts b/apps/products/pos-micro/backend/src/modules/products/products.module.ts new file mode 100644 index 0000000..47fe117 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/products/products.module.ts @@ -0,0 +1,17 @@ +import { Module } from '@nestjs/common'; +import { TypeOrmModule } from '@nestjs/typeorm'; +import { ProductsController } from './products.controller'; +import { ProductsService } from './products.service'; +import { Product } from './entities/product.entity'; +import { AuthModule } from '../auth/auth.module'; + +@Module({ + imports: [ + TypeOrmModule.forFeature([Product]), + AuthModule, + ], + controllers: [ProductsController], + providers: [ProductsService], + exports: [ProductsService, TypeOrmModule], +}) +export class ProductsModule {} diff --git a/apps/products/pos-micro/backend/src/modules/products/products.service.ts b/apps/products/pos-micro/backend/src/modules/products/products.service.ts new file mode 100644 index 0000000..0f1adf6 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/products/products.service.ts @@ -0,0 +1,215 @@ +import { + Injectable, + NotFoundException, + ConflictException, + BadRequestException, +} from '@nestjs/common'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository, ILike } from 'typeorm'; +import { Product } from './entities/product.entity'; +import { Tenant } from '../auth/entities/tenant.entity'; +import { CreateProductDto, UpdateProductDto, ProductFilterDto } from './dto/product.dto'; + +@Injectable() +export class ProductsService { + constructor( + @InjectRepository(Product) + private readonly productRepository: Repository, + @InjectRepository(Tenant) + private readonly tenantRepository: Repository, + ) {} + + async findAll(tenantId: string, filters: ProductFilterDto): Promise { + const query = this.productRepository + .createQueryBuilder('product') + .leftJoinAndSelect('product.category', 'category') + .where('product.tenantId = :tenantId', { tenantId }); + + if (filters.categoryId) { + query.andWhere('product.categoryId = :categoryId', { + categoryId: filters.categoryId, + }); + } + + if (filters.search) { + query.andWhere( + '(product.name ILIKE :search OR product.sku ILIKE :search OR product.barcode ILIKE :search)', + { search: `%${filters.search}%` }, + ); + } + + if (filters.favorites) { + query.andWhere('product.isFavorite = true'); + } + + if (filters.active !== false) { + query.andWhere('product.isActive = true'); + } + + if (filters.lowStock) { + query.andWhere('product.trackStock = true'); + query.andWhere('product.stockQuantity <= product.lowStockAlert'); + } + + query.orderBy('product.sortOrder', 'ASC'); + query.addOrderBy('product.name', 'ASC'); + + return query.getMany(); + } + + async findOne(tenantId: string, id: string): Promise { + const product = await this.productRepository.findOne({ + where: { id, tenantId }, + relations: ['category'], + }); + + if (!product) { + throw new NotFoundException('Producto no encontrado'); + } + + return product; + } + + async findByBarcode(tenantId: string, barcode: string): Promise { + const product = await this.productRepository.findOne({ + where: { barcode, tenantId, isActive: true }, + relations: ['category'], + }); + + if (!product) { + throw new NotFoundException('Producto no encontrado'); + } + + return product; + } + + async create(tenantId: string, dto: CreateProductDto): Promise { + // Check product limit + const tenant = await this.tenantRepository.findOne({ + where: { id: tenantId }, + }); + + if (!tenant) { + throw new BadRequestException('Tenant no encontrado'); + } + + const productCount = await this.productRepository.count({ + where: { tenantId }, + }); + + if (productCount >= tenant.maxProducts) { + throw new BadRequestException( + `Has alcanzado el límite de ${tenant.maxProducts} productos. Actualiza tu plan.`, + ); + } + + // Check SKU uniqueness + if (dto.sku) { + const existingSku = await this.productRepository.findOne({ + where: { tenantId, sku: dto.sku }, + }); + + if (existingSku) { + throw new ConflictException('Ya existe un producto con ese SKU'); + } + } + + // Check barcode uniqueness + if (dto.barcode) { + const existingBarcode = await this.productRepository.findOne({ + where: { tenantId, barcode: dto.barcode }, + }); + + if (existingBarcode) { + throw new ConflictException('Ya existe un producto con ese código de barras'); + } + } + + const product = this.productRepository.create({ + ...dto, + tenantId, + }); + + return this.productRepository.save(product); + } + + async update(tenantId: string, id: string, dto: UpdateProductDto): Promise { + const product = await this.findOne(tenantId, id); + + // Check SKU uniqueness if changed + if (dto.sku && dto.sku !== product.sku) { + const existingSku = await this.productRepository.findOne({ + where: { tenantId, sku: dto.sku }, + }); + + if (existingSku) { + throw new ConflictException('Ya existe un producto con ese SKU'); + } + } + + // Check barcode uniqueness if changed + if (dto.barcode && dto.barcode !== product.barcode) { + const existingBarcode = await this.productRepository.findOne({ + where: { tenantId, barcode: dto.barcode }, + }); + + if (existingBarcode) { + throw new ConflictException('Ya existe un producto con ese código de barras'); + } + } + + Object.assign(product, dto); + return this.productRepository.save(product); + } + + async delete(tenantId: string, id: string): Promise { + const product = await this.findOne(tenantId, id); + await this.productRepository.remove(product); + } + + async toggleActive(tenantId: string, id: string): Promise { + const product = await this.findOne(tenantId, id); + product.isActive = !product.isActive; + return this.productRepository.save(product); + } + + async toggleFavorite(tenantId: string, id: string): Promise { + const product = await this.findOne(tenantId, id); + product.isFavorite = !product.isFavorite; + return this.productRepository.save(product); + } + + async adjustStock( + tenantId: string, + id: string, + adjustment: number, + reason?: string, + ): Promise { + const product = await this.findOne(tenantId, id); + + if (!product.trackStock) { + throw new BadRequestException('Este producto no tiene control de inventario'); + } + + const newQuantity = Number(product.stockQuantity) + adjustment; + + if (newQuantity < 0) { + throw new BadRequestException('No hay suficiente stock disponible'); + } + + product.stockQuantity = newQuantity; + return this.productRepository.save(product); + } + + async getLowStockProducts(tenantId: string): Promise { + return this.productRepository + .createQueryBuilder('product') + .leftJoinAndSelect('product.category', 'category') + .where('product.tenantId = :tenantId', { tenantId }) + .andWhere('product.trackStock = true') + .andWhere('product.stockQuantity <= product.lowStockAlert') + .andWhere('product.isActive = true') + .orderBy('product.stockQuantity', 'ASC') + .getMany(); + } +} diff --git a/apps/products/pos-micro/backend/src/modules/sales/dto/sale.dto.ts b/apps/products/pos-micro/backend/src/modules/sales/dto/sale.dto.ts new file mode 100644 index 0000000..15f5c61 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/sales/dto/sale.dto.ts @@ -0,0 +1,161 @@ +import { ApiProperty } from '@nestjs/swagger'; +import { + IsString, + IsNotEmpty, + IsOptional, + IsNumber, + IsUUID, + IsArray, + ValidateNested, + Min, + MaxLength, + Matches, + ArrayMinSize, +} from 'class-validator'; +import { Type } from 'class-transformer'; + +export class SaleItemDto { + @ApiProperty({ + description: 'ID del producto', + required: true, + }) + @IsUUID() + @IsNotEmpty() + productId: string; + + @ApiProperty({ + description: 'Cantidad vendida', + example: 2, + minimum: 0.001, + }) + @IsNumber() + @Min(0.001) + quantity: number; + + @ApiProperty({ + description: 'Descuento en porcentaje (opcional)', + example: 10, + required: false, + }) + @IsOptional() + @IsNumber() + @Min(0) + discountPercent?: number; +} + +export class CreateSaleDto { + @ApiProperty({ + description: 'Lista de productos vendidos', + type: [SaleItemDto], + }) + @IsArray() + @ArrayMinSize(1, { message: 'Debe incluir al menos un producto' }) + @ValidateNested({ each: true }) + @Type(() => SaleItemDto) + items: SaleItemDto[]; + + @ApiProperty({ + description: 'ID del método de pago', + required: false, + }) + @IsOptional() + @IsUUID() + paymentMethodId?: string; + + @ApiProperty({ + description: 'Monto recibido del cliente', + example: 100, + }) + @IsNumber() + @Min(0) + amountReceived: number; + + @ApiProperty({ + description: 'Nombre del cliente (opcional)', + required: false, + }) + @IsOptional() + @IsString() + @MaxLength(200) + customerName?: string; + + @ApiProperty({ + description: 'Teléfono del cliente (opcional)', + required: false, + }) + @IsOptional() + @IsString() + @Matches(/^[0-9]{10}$/, { + message: 'El teléfono debe tener exactamente 10 dígitos', + }) + customerPhone?: string; + + @ApiProperty({ + description: 'Notas adicionales', + required: false, + }) + @IsOptional() + @IsString() + @MaxLength(500) + notes?: string; + + @ApiProperty({ + description: 'Información del dispositivo (auto-llenado)', + required: false, + }) + @IsOptional() + deviceInfo?: Record; +} + +export class CancelSaleDto { + @ApiProperty({ + description: 'Razón de la cancelación', + example: 'Cliente cambió de opinión', + }) + @IsString() + @IsNotEmpty() + @MaxLength(255) + reason: string; +} + +export class SalesFilterDto { + @ApiProperty({ + description: 'Fecha de inicio (YYYY-MM-DD)', + required: false, + }) + @IsOptional() + @IsString() + startDate?: string; + + @ApiProperty({ + description: 'Fecha de fin (YYYY-MM-DD)', + required: false, + }) + @IsOptional() + @IsString() + endDate?: string; + + @ApiProperty({ + description: 'Estado de la venta', + required: false, + }) + @IsOptional() + @IsString() + status?: string; + + @ApiProperty({ + description: 'Número de ticket', + required: false, + }) + @IsOptional() + @IsString() + ticketNumber?: string; + + @ApiProperty({ + description: 'Límite de resultados', + required: false, + }) + @IsOptional() + @IsNumber() + limit?: number; +} diff --git a/apps/products/pos-micro/backend/src/modules/sales/entities/sale-item.entity.ts b/apps/products/pos-micro/backend/src/modules/sales/entities/sale-item.entity.ts new file mode 100644 index 0000000..3d08728 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/sales/entities/sale-item.entity.ts @@ -0,0 +1,52 @@ +import { + Entity, + PrimaryGeneratedColumn, + Column, + CreateDateColumn, + ManyToOne, + JoinColumn, +} from 'typeorm'; +import { Sale } from './sale.entity'; +import { Product } from '../../products/entities/product.entity'; + +@Entity({ schema: 'pos_micro', name: 'sale_items' }) +export class SaleItem { + @PrimaryGeneratedColumn('uuid') + id: string; + + @Column({ name: 'sale_id' }) + saleId: string; + + @Column({ name: 'product_id', nullable: true }) + productId: string; + + @Column({ name: 'product_name', length: 200 }) + productName: string; + + @Column({ name: 'product_sku', length: 50, nullable: true }) + productSku: string; + + @Column({ type: 'decimal', precision: 12, scale: 3 }) + quantity: number; + + @Column({ name: 'unit_price', type: 'decimal', precision: 12, scale: 2 }) + unitPrice: number; + + @Column({ name: 'discount_percent', type: 'decimal', precision: 5, scale: 2, default: 0 }) + discountPercent: number; + + @Column({ type: 'decimal', precision: 12, scale: 2 }) + subtotal: number; + + @CreateDateColumn({ name: 'created_at' }) + createdAt: Date; + + // Relations + @ManyToOne(() => Sale, (sale) => sale.items, { onDelete: 'CASCADE' }) + @JoinColumn({ name: 'sale_id' }) + sale: Sale; + + @ManyToOne(() => Product, { nullable: true }) + @JoinColumn({ name: 'product_id' }) + product: Product; +} diff --git a/apps/products/pos-micro/backend/src/modules/sales/entities/sale.entity.ts b/apps/products/pos-micro/backend/src/modules/sales/entities/sale.entity.ts new file mode 100644 index 0000000..195ad41 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/sales/entities/sale.entity.ts @@ -0,0 +1,86 @@ +import { + Entity, + PrimaryGeneratedColumn, + Column, + CreateDateColumn, + OneToMany, + ManyToOne, + JoinColumn, +} from 'typeorm'; +import { SaleItem } from './sale-item.entity'; +import { PaymentMethod } from '../../payments/entities/payment-method.entity'; + +export enum SaleStatus { + COMPLETED = 'completed', + CANCELLED = 'cancelled', + REFUNDED = 'refunded', +} + +@Entity({ schema: 'pos_micro', name: 'sales' }) +export class Sale { + @PrimaryGeneratedColumn('uuid') + id: string; + + @Column({ name: 'tenant_id' }) + tenantId: string; + + @Column({ name: 'ticket_number', length: 20 }) + ticketNumber: string; + + @Column({ type: 'decimal', precision: 12, scale: 2 }) + subtotal: number; + + @Column({ name: 'tax_amount', type: 'decimal', precision: 12, scale: 2, default: 0 }) + taxAmount: number; + + @Column({ name: 'discount_amount', type: 'decimal', precision: 12, scale: 2, default: 0 }) + discountAmount: number; + + @Column({ type: 'decimal', precision: 12, scale: 2 }) + total: number; + + @Column({ name: 'payment_method_id', nullable: true }) + paymentMethodId: string; + + @Column({ name: 'amount_received', type: 'decimal', precision: 12, scale: 2 }) + amountReceived: number; + + @Column({ name: 'change_amount', type: 'decimal', precision: 12, scale: 2, default: 0 }) + changeAmount: number; + + @Column({ + type: 'enum', + enum: SaleStatus, + default: SaleStatus.COMPLETED, + }) + status: SaleStatus; + + @Column({ name: 'cancelled_at', type: 'timestamp', nullable: true }) + cancelledAt: Date; + + @Column({ name: 'cancel_reason', length: 255, nullable: true }) + cancelReason: string; + + @Column({ name: 'customer_name', length: 200, nullable: true }) + customerName: string; + + @Column({ name: 'customer_phone', length: 20, nullable: true }) + customerPhone: string; + + @Column({ type: 'text', nullable: true }) + notes: string; + + @Column({ name: 'device_info', type: 'jsonb', nullable: true }) + deviceInfo: Record; + + @CreateDateColumn({ name: 'created_at' }) + createdAt: Date; + + // Relations + @OneToMany(() => SaleItem, (item) => item.sale, { cascade: true }) + items: SaleItem[]; + + @ManyToOne(() => PaymentMethod, { nullable: true }) + @JoinColumn({ name: 'payment_method_id' }) + paymentMethod: PaymentMethod; +} diff --git a/apps/products/pos-micro/backend/src/modules/sales/sales.controller.ts b/apps/products/pos-micro/backend/src/modules/sales/sales.controller.ts new file mode 100644 index 0000000..ea4203c --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/sales/sales.controller.ts @@ -0,0 +1,101 @@ +import { + Controller, + Get, + Post, + Body, + Param, + Query, + UseGuards, + Request, + ParseUUIDPipe, + HttpCode, + HttpStatus, +} from '@nestjs/common'; +import { + ApiTags, + ApiOperation, + ApiResponse, + ApiBearerAuth, + ApiParam, +} from '@nestjs/swagger'; +import { SalesService, TodaySummary } from './sales.service'; +import { CreateSaleDto, CancelSaleDto, SalesFilterDto } from './dto/sale.dto'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; + +@ApiTags('sales') +@ApiBearerAuth() +@UseGuards(JwtAuthGuard) +@Controller('sales') +export class SalesController { + constructor(private readonly salesService: SalesService) {} + + @Get() + @ApiOperation({ summary: 'Listar ventas' }) + @ApiResponse({ status: 200, description: 'Lista de ventas' }) + async findAll( + @Request() req: { user: { tenantId: string } }, + @Query() filters: SalesFilterDto, + ) { + return this.salesService.findAll(req.user.tenantId, filters); + } + + @Get('today') + @ApiOperation({ summary: 'Resumen de ventas del día' }) + async getTodaySummary(@Request() req: { user: { tenantId: string } }): Promise { + return this.salesService.getTodaySummary(req.user.tenantId); + } + + @Get('recent') + @ApiOperation({ summary: 'Obtener ventas recientes' }) + async getRecentSales( + @Request() req: { user: { tenantId: string } }, + @Query('limit') limit?: number, + ) { + return this.salesService.getRecentSales(req.user.tenantId, limit || 10); + } + + @Get('ticket/:ticketNumber') + @ApiOperation({ summary: 'Buscar venta por número de ticket' }) + @ApiParam({ name: 'ticketNumber', description: 'Número de ticket' }) + async findByTicketNumber( + @Request() req: { user: { tenantId: string } }, + @Param('ticketNumber') ticketNumber: string, + ) { + return this.salesService.findByTicketNumber(req.user.tenantId, ticketNumber); + } + + @Get(':id') + @ApiOperation({ summary: 'Obtener venta por ID' }) + @ApiParam({ name: 'id', description: 'ID de la venta' }) + async findOne( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + ) { + return this.salesService.findOne(req.user.tenantId, id); + } + + @Post() + @ApiOperation({ summary: 'Registrar nueva venta' }) + @ApiResponse({ status: 201, description: 'Venta creada exitosamente' }) + @ApiResponse({ status: 400, description: 'Stock insuficiente o límite alcanzado' }) + async create( + @Request() req: { user: { tenantId: string } }, + @Body() dto: CreateSaleDto, + ) { + return this.salesService.create(req.user.tenantId, dto); + } + + @Post(':id/cancel') + @HttpCode(HttpStatus.OK) + @ApiOperation({ summary: 'Cancelar venta' }) + @ApiParam({ name: 'id', description: 'ID de la venta' }) + @ApiResponse({ status: 200, description: 'Venta cancelada' }) + @ApiResponse({ status: 400, description: 'No se puede cancelar la venta' }) + async cancel( + @Request() req: { user: { tenantId: string } }, + @Param('id', ParseUUIDPipe) id: string, + @Body() dto: CancelSaleDto, + ) { + return this.salesService.cancel(req.user.tenantId, id, dto); + } +} diff --git a/apps/products/pos-micro/backend/src/modules/sales/sales.module.ts b/apps/products/pos-micro/backend/src/modules/sales/sales.module.ts new file mode 100644 index 0000000..1497688 --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/sales/sales.module.ts @@ -0,0 +1,20 @@ +import { Module } from '@nestjs/common'; +import { TypeOrmModule } from '@nestjs/typeorm'; +import { SalesController } from './sales.controller'; +import { SalesService } from './sales.service'; +import { Sale } from './entities/sale.entity'; +import { SaleItem } from './entities/sale-item.entity'; +import { AuthModule } from '../auth/auth.module'; +import { ProductsModule } from '../products/products.module'; + +@Module({ + imports: [ + TypeOrmModule.forFeature([Sale, SaleItem]), + AuthModule, + ProductsModule, + ], + controllers: [SalesController], + providers: [SalesService], + exports: [SalesService, TypeOrmModule], +}) +export class SalesModule {} diff --git a/apps/products/pos-micro/backend/src/modules/sales/sales.service.ts b/apps/products/pos-micro/backend/src/modules/sales/sales.service.ts new file mode 100644 index 0000000..a11269b --- /dev/null +++ b/apps/products/pos-micro/backend/src/modules/sales/sales.service.ts @@ -0,0 +1,270 @@ +import { + Injectable, + NotFoundException, + BadRequestException, +} from '@nestjs/common'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository, Between, LessThanOrEqual, MoreThanOrEqual } from 'typeorm'; +import { Sale, SaleStatus } from './entities/sale.entity'; +import { SaleItem } from './entities/sale-item.entity'; +import { Product } from '../products/entities/product.entity'; +import { Tenant } from '../auth/entities/tenant.entity'; +import { CreateSaleDto, CancelSaleDto, SalesFilterDto } from './dto/sale.dto'; + +export interface TodaySummary { + totalSales: number; + totalRevenue: number; + totalTax: number; + avgTicket: number; +} + +@Injectable() +export class SalesService { + constructor( + @InjectRepository(Sale) + private readonly saleRepository: Repository, + @InjectRepository(SaleItem) + private readonly saleItemRepository: Repository, + @InjectRepository(Product) + private readonly productRepository: Repository, + @InjectRepository(Tenant) + private readonly tenantRepository: Repository, + ) {} + + async findAll(tenantId: string, filters: SalesFilterDto): Promise { + const query = this.saleRepository + .createQueryBuilder('sale') + .leftJoinAndSelect('sale.items', 'items') + .leftJoinAndSelect('sale.paymentMethod', 'paymentMethod') + .where('sale.tenantId = :tenantId', { tenantId }); + + if (filters.startDate && filters.endDate) { + query.andWhere('DATE(sale.createdAt) BETWEEN :startDate AND :endDate', { + startDate: filters.startDate, + endDate: filters.endDate, + }); + } else if (filters.startDate) { + query.andWhere('DATE(sale.createdAt) >= :startDate', { + startDate: filters.startDate, + }); + } else if (filters.endDate) { + query.andWhere('DATE(sale.createdAt) <= :endDate', { + endDate: filters.endDate, + }); + } + + if (filters.status) { + query.andWhere('sale.status = :status', { status: filters.status }); + } + + if (filters.ticketNumber) { + query.andWhere('sale.ticketNumber ILIKE :ticketNumber', { + ticketNumber: `%${filters.ticketNumber}%`, + }); + } + + query.orderBy('sale.createdAt', 'DESC'); + + if (filters.limit) { + query.limit(filters.limit); + } + + return query.getMany(); + } + + async findOne(tenantId: string, id: string): Promise { + const sale = await this.saleRepository.findOne({ + where: { id, tenantId }, + relations: ['items', 'paymentMethod'], + }); + + if (!sale) { + throw new NotFoundException('Venta no encontrada'); + } + + return sale; + } + + async findByTicketNumber(tenantId: string, ticketNumber: string): Promise { + const sale = await this.saleRepository.findOne({ + where: { ticketNumber, tenantId }, + relations: ['items', 'paymentMethod'], + }); + + if (!sale) { + throw new NotFoundException('Venta no encontrada'); + } + + return sale; + } + + async create(tenantId: string, dto: CreateSaleDto): Promise { + // Check monthly sales limit + const tenant = await this.tenantRepository.findOne({ + where: { id: tenantId }, + }); + + if (!tenant) { + throw new BadRequestException('Tenant no encontrado'); + } + + if (tenant.currentMonthSales >= tenant.maxSalesPerMonth) { + throw new BadRequestException( + `Has alcanzado el límite de ${tenant.maxSalesPerMonth} ventas este mes. Actualiza tu plan.`, + ); + } + + // Calculate totals + let subtotal = 0; + const saleItems: Partial[] = []; + + for (const item of dto.items) { + const product = await this.productRepository.findOne({ + where: { id: item.productId, tenantId, isActive: true }, + }); + + if (!product) { + throw new BadRequestException(`Producto ${item.productId} no encontrado`); + } + + // Check stock if tracking + if (product.trackStock && Number(product.stockQuantity) < item.quantity) { + throw new BadRequestException( + `Stock insuficiente para ${product.name}. Disponible: ${product.stockQuantity}`, + ); + } + + const itemSubtotal = + Number(product.price) * item.quantity * (1 - (item.discountPercent || 0) / 100); + + saleItems.push({ + productId: product.id, + productName: product.name, + productSku: product.sku, + quantity: item.quantity, + unitPrice: Number(product.price), + discountPercent: item.discountPercent || 0, + subtotal: itemSubtotal, + }); + + subtotal += itemSubtotal; + } + + // Calculate tax (assume 16% IVA included in price) + const taxRate = Number(tenant.taxRate) / 100; + const taxAmount = subtotal - subtotal / (1 + taxRate); + const total = subtotal; + + // Validate payment + if (dto.amountReceived < total) { + throw new BadRequestException( + `Monto recibido ($${dto.amountReceived}) es menor al total ($${total.toFixed(2)})`, + ); + } + + const changeAmount = dto.amountReceived - total; + + // Create sale + const sale = this.saleRepository.create({ + tenantId, + subtotal, + taxAmount, + discountAmount: 0, + total, + paymentMethodId: dto.paymentMethodId, + amountReceived: dto.amountReceived, + changeAmount, + customerName: dto.customerName, + customerPhone: dto.customerPhone, + notes: dto.notes, + deviceInfo: dto.deviceInfo, + status: SaleStatus.COMPLETED, + }); + + const savedSale = await this.saleRepository.save(sale); + + // Create sale items + for (const item of saleItems) { + const saleItem = this.saleItemRepository.create({ + ...item, + saleId: savedSale.id, + }); + await this.saleItemRepository.save(saleItem); + } + + // Return complete sale with items + return this.findOne(tenantId, savedSale.id); + } + + async cancel(tenantId: string, id: string, dto: CancelSaleDto): Promise { + const sale = await this.findOne(tenantId, id); + + if (sale.status !== SaleStatus.COMPLETED) { + throw new BadRequestException('Solo se pueden cancelar ventas completadas'); + } + + // Check if sale is from today (can only cancel same-day sales) + const today = new Date(); + today.setHours(0, 0, 0, 0); + const saleDate = new Date(sale.createdAt); + saleDate.setHours(0, 0, 0, 0); + + if (saleDate.getTime() !== today.getTime()) { + throw new BadRequestException('Solo se pueden cancelar ventas del día actual'); + } + + sale.status = SaleStatus.CANCELLED; + sale.cancelledAt = new Date(); + sale.cancelReason = dto.reason; + + // Restore stock + for (const item of sale.items) { + if (item.productId) { + const product = await this.productRepository.findOne({ + where: { id: item.productId }, + }); + + if (product?.trackStock) { + product.stockQuantity = Number(product.stockQuantity) + Number(item.quantity); + await this.productRepository.save(product); + } + } + } + + return this.saleRepository.save(sale); + } + + async getTodaySummary(tenantId: string): Promise { + const today = new Date(); + today.setHours(0, 0, 0, 0); + + const result = await this.saleRepository + .createQueryBuilder('sale') + .select([ + 'COUNT(sale.id) as totalSales', + 'COALESCE(SUM(sale.total), 0) as totalRevenue', + 'COALESCE(SUM(sale.taxAmount), 0) as totalTax', + 'COALESCE(AVG(sale.total), 0) as avgTicket', + ]) + .where('sale.tenantId = :tenantId', { tenantId }) + .andWhere('DATE(sale.createdAt) = CURRENT_DATE') + .andWhere('sale.status = :status', { status: SaleStatus.COMPLETED }) + .getRawOne(); + + return { + totalSales: parseInt(result.totalsales, 10) || 0, + totalRevenue: parseFloat(result.totalrevenue) || 0, + totalTax: parseFloat(result.totaltax) || 0, + avgTicket: parseFloat(result.avgticket) || 0, + }; + } + + async getRecentSales(tenantId: string, limit = 10): Promise { + return this.saleRepository.find({ + where: { tenantId }, + relations: ['items', 'paymentMethod'], + order: { createdAt: 'DESC' }, + take: limit, + }); + } +} diff --git a/apps/products/pos-micro/backend/tsconfig.json b/apps/products/pos-micro/backend/tsconfig.json new file mode 100644 index 0000000..a1e26cd --- /dev/null +++ b/apps/products/pos-micro/backend/tsconfig.json @@ -0,0 +1,27 @@ +{ + "compilerOptions": { + "module": "commonjs", + "declaration": true, + "removeComments": true, + "emitDecoratorMetadata": true, + "experimentalDecorators": true, + "allowSyntheticDefaultImports": true, + "target": "ES2021", + "sourceMap": true, + "outDir": "./dist", + "baseUrl": "./", + "incremental": true, + "skipLibCheck": true, + "strictNullChecks": true, + "noImplicitAny": true, + "strictBindCallApply": true, + "forceConsistentCasingInFileNames": true, + "noFallthroughCasesInSwitch": true, + "paths": { + "@/*": ["src/*"], + "@modules/*": ["src/modules/*"], + "@common/*": ["src/common/*"], + "@config/*": ["src/config/*"] + } + } +} diff --git a/apps/products/pos-micro/database/ddl/00-schema.sql b/apps/products/pos-micro/database/ddl/00-schema.sql new file mode 100644 index 0000000..6c9a16e --- /dev/null +++ b/apps/products/pos-micro/database/ddl/00-schema.sql @@ -0,0 +1,596 @@ +-- ============================================================================ +-- POS MICRO - DATABASE SCHEMA +-- ============================================================================ +-- Version: 1.0.0 +-- Description: Ultra-minimal schema for street vendors and small shops +-- Target: ~10 tables, 100 MXN/month SaaS +-- Market: Mexican informal economy +-- Execute: Creates complete database for POS Micro +-- ============================================================================ + +-- Enable required extensions +CREATE EXTENSION IF NOT EXISTS "uuid-ossp"; +CREATE EXTENSION IF NOT EXISTS "pgcrypto"; + +-- ============================================================================ +-- SCHEMA CREATION +-- ============================================================================ + +CREATE SCHEMA IF NOT EXISTS pos_micro; + +-- Set search path +SET search_path TO pos_micro, public; + +-- ============================================================================ +-- UTILITY FUNCTIONS +-- ============================================================================ + +-- Function: Update updated_at timestamp +CREATE OR REPLACE FUNCTION pos_micro.update_updated_at() +RETURNS TRIGGER AS $$ +BEGIN + NEW.updated_at = CURRENT_TIMESTAMP; + RETURN NEW; +END; +$$ LANGUAGE plpgsql; + +-- Function: Generate sale ticket number +CREATE OR REPLACE FUNCTION pos_micro.generate_ticket_number(p_tenant_id UUID) +RETURNS VARCHAR AS $$ +DECLARE + v_prefix VARCHAR; + v_seq INTEGER; + v_date VARCHAR; +BEGIN + v_date := TO_CHAR(CURRENT_DATE, 'YYMMDD'); + + SELECT COALESCE(MAX( + CAST(SUBSTRING(ticket_number FROM 8) AS INTEGER) + ), 0) + 1 + INTO v_seq + FROM pos_micro.sales + WHERE tenant_id = p_tenant_id + AND DATE(created_at) = CURRENT_DATE; + + RETURN 'T' || v_date || LPAD(v_seq::TEXT, 4, '0'); +END; +$$ LANGUAGE plpgsql; + +-- ============================================================================ +-- TABLE 1: tenants (Multi-tenancy root) +-- ============================================================================ + +CREATE TABLE pos_micro.tenants ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + + -- Business info + business_name VARCHAR(200) NOT NULL, + owner_name VARCHAR(200) NOT NULL, + phone VARCHAR(20) NOT NULL, + whatsapp VARCHAR(20), + email VARCHAR(255), + + -- Location (optional) + address TEXT, + city VARCHAR(100), + state VARCHAR(50) DEFAULT 'México', + + -- Subscription + plan VARCHAR(20) NOT NULL DEFAULT 'micro', -- micro, micro_plus + subscription_status VARCHAR(20) NOT NULL DEFAULT 'trial', -- trial, active, suspended, cancelled + trial_ends_at TIMESTAMP, + subscription_ends_at TIMESTAMP, + + -- Settings + currency VARCHAR(3) NOT NULL DEFAULT 'MXN', + tax_rate DECIMAL(5,2) NOT NULL DEFAULT 16.00, -- IVA México + timezone VARCHAR(50) DEFAULT 'America/Mexico_City', + settings JSONB DEFAULT '{}', + + -- Limits + max_products INTEGER NOT NULL DEFAULT 500, + max_sales_per_month INTEGER NOT NULL DEFAULT 1000, + current_month_sales INTEGER DEFAULT 0, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT chk_tenants_phone CHECK (phone ~ '^[0-9]{10}$'), + CONSTRAINT chk_tenants_tax_rate CHECK (tax_rate >= 0 AND tax_rate <= 100) +); + +CREATE INDEX idx_tenants_phone ON pos_micro.tenants(phone); +CREATE INDEX idx_tenants_subscription_status ON pos_micro.tenants(subscription_status); + +-- ============================================================================ +-- TABLE 2: users (Single user per tenant, simple auth) +-- ============================================================================ + +CREATE TABLE pos_micro.users ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES pos_micro.tenants(id) ON DELETE CASCADE, + + -- Auth + pin_hash VARCHAR(255) NOT NULL, -- 4-6 digit PIN for quick access + password_hash VARCHAR(255), -- Optional full password + + -- Profile + name VARCHAR(200) NOT NULL, + is_owner BOOLEAN NOT NULL DEFAULT TRUE, + + -- Session + last_login_at TIMESTAMP, + last_login_device JSONB, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT uq_users_tenant UNIQUE (tenant_id) -- Only 1 user per tenant in micro plan +); + +CREATE INDEX idx_users_tenant_id ON pos_micro.users(tenant_id); + +-- ============================================================================ +-- TABLE 3: categories (Product categories, max 20) +-- ============================================================================ + +CREATE TABLE pos_micro.categories ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES pos_micro.tenants(id) ON DELETE CASCADE, + + name VARCHAR(100) NOT NULL, + color VARCHAR(7) DEFAULT '#3B82F6', -- Hex color for UI + icon VARCHAR(50) DEFAULT 'package', -- Icon name + sort_order INTEGER DEFAULT 0, + + is_active BOOLEAN NOT NULL DEFAULT TRUE, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT uq_categories_name_tenant UNIQUE (tenant_id, name) +); + +CREATE INDEX idx_categories_tenant_id ON pos_micro.categories(tenant_id); +CREATE INDEX idx_categories_active ON pos_micro.categories(tenant_id, is_active); + +-- ============================================================================ +-- TABLE 4: products (Max 500 per tenant) +-- ============================================================================ + +CREATE TABLE pos_micro.products ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES pos_micro.tenants(id) ON DELETE CASCADE, + category_id UUID REFERENCES pos_micro.categories(id) ON DELETE SET NULL, + + -- Identification + sku VARCHAR(50), + barcode VARCHAR(50), + name VARCHAR(200) NOT NULL, + + -- Pricing + price DECIMAL(12,2) NOT NULL, + cost DECIMAL(12,2) DEFAULT 0, -- Optional: purchase cost + tax_included BOOLEAN NOT NULL DEFAULT TRUE, -- Price includes IVA + + -- Stock (simple) + track_stock BOOLEAN NOT NULL DEFAULT FALSE, + stock_quantity DECIMAL(12,3) DEFAULT 0, + low_stock_alert INTEGER DEFAULT 5, + + -- UI + image_url VARCHAR(500), + color VARCHAR(7), -- Quick color identification + is_favorite BOOLEAN DEFAULT FALSE, -- Show in quick access + sort_order INTEGER DEFAULT 0, + + is_active BOOLEAN NOT NULL DEFAULT TRUE, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT uq_products_sku_tenant UNIQUE (tenant_id, sku), + CONSTRAINT uq_products_barcode_tenant UNIQUE (tenant_id, barcode), + CONSTRAINT chk_products_price CHECK (price >= 0), + CONSTRAINT chk_products_cost CHECK (cost >= 0) +); + +CREATE INDEX idx_products_tenant_id ON pos_micro.products(tenant_id); +CREATE INDEX idx_products_category_id ON pos_micro.products(category_id); +CREATE INDEX idx_products_barcode ON pos_micro.products(barcode); +CREATE INDEX idx_products_active ON pos_micro.products(tenant_id, is_active); +CREATE INDEX idx_products_favorite ON pos_micro.products(tenant_id, is_favorite) WHERE is_favorite = TRUE; + +-- ============================================================================ +-- TABLE 5: payment_methods (Cash, card, transfer) +-- ============================================================================ + +CREATE TABLE pos_micro.payment_methods ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES pos_micro.tenants(id) ON DELETE CASCADE, + + code VARCHAR(20) NOT NULL, -- cash, card, transfer, other + name VARCHAR(100) NOT NULL, + icon VARCHAR(50) DEFAULT 'banknote', + + is_default BOOLEAN DEFAULT FALSE, + is_active BOOLEAN NOT NULL DEFAULT TRUE, + sort_order INTEGER DEFAULT 0, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT uq_payment_methods_code_tenant UNIQUE (tenant_id, code) +); + +CREATE INDEX idx_payment_methods_tenant_id ON pos_micro.payment_methods(tenant_id); + +-- ============================================================================ +-- TABLE 6: sales (Tickets/receipts) +-- ============================================================================ + +CREATE TABLE pos_micro.sales ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES pos_micro.tenants(id) ON DELETE CASCADE, + + -- Identification + ticket_number VARCHAR(20) NOT NULL, + + -- Totals + subtotal DECIMAL(12,2) NOT NULL, + tax_amount DECIMAL(12,2) NOT NULL DEFAULT 0, + discount_amount DECIMAL(12,2) NOT NULL DEFAULT 0, + total DECIMAL(12,2) NOT NULL, + + -- Payment + payment_method_id UUID REFERENCES pos_micro.payment_methods(id), + amount_received DECIMAL(12,2) NOT NULL, + change_amount DECIMAL(12,2) NOT NULL DEFAULT 0, + + -- Status + status VARCHAR(20) NOT NULL DEFAULT 'completed', -- completed, cancelled, refunded + cancelled_at TIMESTAMP, + cancel_reason VARCHAR(255), + + -- Customer (optional, for WhatsApp integration) + customer_name VARCHAR(200), + customer_phone VARCHAR(20), + + -- Metadata + notes TEXT, + device_info JSONB, -- Device that made the sale + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT uq_sales_ticket_tenant UNIQUE (tenant_id, ticket_number), + CONSTRAINT chk_sales_total CHECK (total >= 0), + CONSTRAINT chk_sales_amounts CHECK (amount_received >= total - discount_amount) +); + +CREATE INDEX idx_sales_tenant_id ON pos_micro.sales(tenant_id); +CREATE INDEX idx_sales_ticket_number ON pos_micro.sales(ticket_number); +CREATE INDEX idx_sales_created_at ON pos_micro.sales(created_at); +CREATE INDEX idx_sales_status ON pos_micro.sales(status); +CREATE INDEX idx_sales_customer_phone ON pos_micro.sales(customer_phone) WHERE customer_phone IS NOT NULL; + +-- ============================================================================ +-- TABLE 7: sale_items (Line items in a sale) +-- ============================================================================ + +CREATE TABLE pos_micro.sale_items ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + sale_id UUID NOT NULL REFERENCES pos_micro.sales(id) ON DELETE CASCADE, + product_id UUID REFERENCES pos_micro.products(id) ON DELETE SET NULL, + + -- Product snapshot (in case product changes/deleted) + product_name VARCHAR(200) NOT NULL, + product_sku VARCHAR(50), + + -- Amounts + quantity DECIMAL(12,3) NOT NULL, + unit_price DECIMAL(12,2) NOT NULL, + discount_percent DECIMAL(5,2) DEFAULT 0, + subtotal DECIMAL(12,2) NOT NULL, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT chk_sale_items_quantity CHECK (quantity > 0), + CONSTRAINT chk_sale_items_price CHECK (unit_price >= 0) +); + +CREATE INDEX idx_sale_items_sale_id ON pos_micro.sale_items(sale_id); +CREATE INDEX idx_sale_items_product_id ON pos_micro.sale_items(product_id); + +-- ============================================================================ +-- TABLE 8: cash_movements (Cash register tracking) +-- ============================================================================ + +CREATE TABLE pos_micro.cash_movements ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES pos_micro.tenants(id) ON DELETE CASCADE, + + -- Type + type VARCHAR(20) NOT NULL, -- opening, sale, expense, withdrawal, closing + + -- Amount + amount DECIMAL(12,2) NOT NULL, + + -- Reference + sale_id UUID REFERENCES pos_micro.sales(id) ON DELETE SET NULL, + description VARCHAR(255), + + -- Balance (running) + balance_after DECIMAL(12,2) NOT NULL, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE INDEX idx_cash_movements_tenant_id ON pos_micro.cash_movements(tenant_id); +CREATE INDEX idx_cash_movements_type ON pos_micro.cash_movements(type); +CREATE INDEX idx_cash_movements_created_at ON pos_micro.cash_movements(created_at); + +-- ============================================================================ +-- TABLE 9: daily_summaries (Daily closing reports) +-- ============================================================================ + +CREATE TABLE pos_micro.daily_summaries ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES pos_micro.tenants(id) ON DELETE CASCADE, + + -- Period + summary_date DATE NOT NULL, + + -- Totals + total_sales INTEGER NOT NULL DEFAULT 0, + total_revenue DECIMAL(12,2) NOT NULL DEFAULT 0, + total_tax DECIMAL(12,2) NOT NULL DEFAULT 0, + total_discounts DECIMAL(12,2) NOT NULL DEFAULT 0, + + -- Payment breakdown + cash_total DECIMAL(12,2) DEFAULT 0, + card_total DECIMAL(12,2) DEFAULT 0, + other_total DECIMAL(12,2) DEFAULT 0, + + -- Cash register + opening_balance DECIMAL(12,2) DEFAULT 0, + closing_balance DECIMAL(12,2) DEFAULT 0, + total_expenses DECIMAL(12,2) DEFAULT 0, + expected_cash DECIMAL(12,2) DEFAULT 0, + actual_cash DECIMAL(12,2), + cash_difference DECIMAL(12,2), + + -- Status + is_closed BOOLEAN DEFAULT FALSE, + closed_at TIMESTAMP, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT uq_daily_summaries_tenant_date UNIQUE (tenant_id, summary_date) +); + +CREATE INDEX idx_daily_summaries_tenant_id ON pos_micro.daily_summaries(tenant_id); +CREATE INDEX idx_daily_summaries_date ON pos_micro.daily_summaries(summary_date); + +-- ============================================================================ +-- TABLE 10: whatsapp_sessions (WhatsApp bot integration) +-- ============================================================================ + +CREATE TABLE pos_micro.whatsapp_sessions ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES pos_micro.tenants(id) ON DELETE CASCADE, + + -- WhatsApp info + phone_number VARCHAR(20) NOT NULL, + wa_id VARCHAR(50), -- WhatsApp internal ID + + -- Session state + session_state JSONB DEFAULT '{}', -- Conversation state machine + last_interaction_at TIMESTAMP, + + -- Metrics + total_messages INTEGER DEFAULT 0, + total_orders INTEGER DEFAULT 0, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT uq_whatsapp_sessions_phone_tenant UNIQUE (tenant_id, phone_number) +); + +CREATE INDEX idx_whatsapp_sessions_tenant_id ON pos_micro.whatsapp_sessions(tenant_id); +CREATE INDEX idx_whatsapp_sessions_phone ON pos_micro.whatsapp_sessions(phone_number); + +-- ============================================================================ +-- TRIGGERS +-- ============================================================================ + +-- Auto-update updated_at +CREATE TRIGGER trg_tenants_updated_at + BEFORE UPDATE ON pos_micro.tenants + FOR EACH ROW EXECUTE FUNCTION pos_micro.update_updated_at(); + +CREATE TRIGGER trg_users_updated_at + BEFORE UPDATE ON pos_micro.users + FOR EACH ROW EXECUTE FUNCTION pos_micro.update_updated_at(); + +CREATE TRIGGER trg_categories_updated_at + BEFORE UPDATE ON pos_micro.categories + FOR EACH ROW EXECUTE FUNCTION pos_micro.update_updated_at(); + +CREATE TRIGGER trg_products_updated_at + BEFORE UPDATE ON pos_micro.products + FOR EACH ROW EXECUTE FUNCTION pos_micro.update_updated_at(); + +CREATE TRIGGER trg_daily_summaries_updated_at + BEFORE UPDATE ON pos_micro.daily_summaries + FOR EACH ROW EXECUTE FUNCTION pos_micro.update_updated_at(); + +CREATE TRIGGER trg_whatsapp_sessions_updated_at + BEFORE UPDATE ON pos_micro.whatsapp_sessions + FOR EACH ROW EXECUTE FUNCTION pos_micro.update_updated_at(); + +-- ============================================================================ +-- TRIGGER: Auto-generate ticket number +-- ============================================================================ + +CREATE OR REPLACE FUNCTION pos_micro.auto_ticket_number() +RETURNS TRIGGER AS $$ +BEGIN + IF NEW.ticket_number IS NULL THEN + NEW.ticket_number := pos_micro.generate_ticket_number(NEW.tenant_id); + END IF; + RETURN NEW; +END; +$$ LANGUAGE plpgsql; + +CREATE TRIGGER trg_sales_ticket_number + BEFORE INSERT ON pos_micro.sales + FOR EACH ROW EXECUTE FUNCTION pos_micro.auto_ticket_number(); + +-- ============================================================================ +-- TRIGGER: Update stock on sale +-- ============================================================================ + +CREATE OR REPLACE FUNCTION pos_micro.update_stock_on_sale() +RETURNS TRIGGER AS $$ +BEGIN + IF TG_OP = 'INSERT' THEN + UPDATE pos_micro.products + SET stock_quantity = stock_quantity - NEW.quantity + WHERE id = NEW.product_id + AND track_stock = TRUE; + ELSIF TG_OP = 'DELETE' THEN + UPDATE pos_micro.products + SET stock_quantity = stock_quantity + OLD.quantity + WHERE id = OLD.product_id + AND track_stock = TRUE; + END IF; + RETURN NEW; +END; +$$ LANGUAGE plpgsql; + +CREATE TRIGGER trg_sale_items_stock + AFTER INSERT OR DELETE ON pos_micro.sale_items + FOR EACH ROW EXECUTE FUNCTION pos_micro.update_stock_on_sale(); + +-- ============================================================================ +-- TRIGGER: Increment monthly sales counter +-- ============================================================================ + +CREATE OR REPLACE FUNCTION pos_micro.increment_monthly_sales() +RETURNS TRIGGER AS $$ +BEGIN + IF NEW.status = 'completed' THEN + UPDATE pos_micro.tenants + SET current_month_sales = current_month_sales + 1 + WHERE id = NEW.tenant_id; + END IF; + RETURN NEW; +END; +$$ LANGUAGE plpgsql; + +CREATE TRIGGER trg_sales_monthly_counter + AFTER INSERT ON pos_micro.sales + FOR EACH ROW EXECUTE FUNCTION pos_micro.increment_monthly_sales(); + +-- ============================================================================ +-- VIEWS +-- ============================================================================ + +-- View: Products with stock alerts +CREATE OR REPLACE VIEW pos_micro.products_low_stock AS +SELECT + p.id, + p.tenant_id, + p.name, + p.sku, + p.stock_quantity, + p.low_stock_alert, + c.name as category_name +FROM pos_micro.products p +LEFT JOIN pos_micro.categories c ON p.category_id = c.id +WHERE p.track_stock = TRUE + AND p.stock_quantity <= p.low_stock_alert + AND p.is_active = TRUE; + +-- View: Today's sales summary +CREATE OR REPLACE VIEW pos_micro.today_sales AS +SELECT + tenant_id, + COUNT(*) as total_sales, + SUM(total) as total_revenue, + SUM(tax_amount) as total_tax, + AVG(total) as avg_ticket +FROM pos_micro.sales +WHERE DATE(created_at) = CURRENT_DATE + AND status = 'completed' +GROUP BY tenant_id; + +-- View: Top products (last 30 days) +CREATE OR REPLACE VIEW pos_micro.top_products AS +SELECT + p.tenant_id, + p.id as product_id, + p.name as product_name, + SUM(si.quantity) as total_quantity, + SUM(si.subtotal) as total_revenue, + COUNT(DISTINCT s.id) as times_sold +FROM pos_micro.sale_items si +JOIN pos_micro.sales s ON si.sale_id = s.id +JOIN pos_micro.products p ON si.product_id = p.id +WHERE s.created_at >= CURRENT_DATE - INTERVAL '30 days' + AND s.status = 'completed' +GROUP BY p.tenant_id, p.id, p.name +ORDER BY total_revenue DESC; + +-- ============================================================================ +-- SEED DATA: Default payment methods +-- ============================================================================ + +-- This will be inserted per-tenant on registration +-- Just documenting the expected defaults here + +/* +INSERT INTO pos_micro.payment_methods (tenant_id, code, name, icon, is_default, sort_order) VALUES +('{tenant_id}', 'cash', 'Efectivo', 'banknote', TRUE, 1), +('{tenant_id}', 'card', 'Tarjeta', 'credit-card', FALSE, 2), +('{tenant_id}', 'transfer', 'Transferencia', 'smartphone', FALSE, 3); +*/ + +-- ============================================================================ +-- COMMENTS +-- ============================================================================ + +COMMENT ON SCHEMA pos_micro IS 'POS Micro - Ultra-minimal point of sale for street vendors'; +COMMENT ON TABLE pos_micro.tenants IS 'Tenant/business registration with subscription limits'; +COMMENT ON TABLE pos_micro.users IS 'Single user per tenant (micro plan limit)'; +COMMENT ON TABLE pos_micro.categories IS 'Product categories (max 20 per tenant)'; +COMMENT ON TABLE pos_micro.products IS 'Products catalog (max 500 per tenant)'; +COMMENT ON TABLE pos_micro.payment_methods IS 'Accepted payment methods'; +COMMENT ON TABLE pos_micro.sales IS 'Sales/tickets with totals'; +COMMENT ON TABLE pos_micro.sale_items IS 'Line items per sale'; +COMMENT ON TABLE pos_micro.cash_movements IS 'Cash register movements'; +COMMENT ON TABLE pos_micro.daily_summaries IS 'Daily closing reports'; +COMMENT ON TABLE pos_micro.whatsapp_sessions IS 'WhatsApp bot conversation sessions'; + +-- ============================================================================ +-- SCHEMA COMPLETE +-- ============================================================================ + +DO $$ +BEGIN + RAISE NOTICE 'POS Micro schema created successfully!'; + RAISE NOTICE 'Tables: 10 (tenants, users, categories, products, payment_methods, sales, sale_items, cash_movements, daily_summaries, whatsapp_sessions)'; + RAISE NOTICE 'Target: Street vendors, small shops, food stands'; + RAISE NOTICE 'Price: 100 MXN/month'; +END $$; diff --git a/apps/products/pos-micro/docker-compose.yml b/apps/products/pos-micro/docker-compose.yml new file mode 100644 index 0000000..7cf8052 --- /dev/null +++ b/apps/products/pos-micro/docker-compose.yml @@ -0,0 +1,73 @@ +version: '3.8' + +services: + # PostgreSQL Database + postgres: + image: postgres:15-alpine + container_name: pos-micro-db + environment: + POSTGRES_USER: pos_micro + POSTGRES_PASSWORD: pos_micro_secret + POSTGRES_DB: pos_micro_db + ports: + - "5433:5432" + volumes: + - pos_micro_data:/var/lib/postgresql/data + - ./database/ddl:/docker-entrypoint-initdb.d:ro + healthcheck: + test: ["CMD-SHELL", "pg_isready -U pos_micro -d pos_micro_db"] + interval: 10s + timeout: 5s + retries: 5 + networks: + - pos-micro-network + + # Backend API (NestJS) + backend: + build: + context: ./backend + dockerfile: Dockerfile + container_name: pos-micro-api + environment: + NODE_ENV: development + PORT: 3071 + DB_HOST: postgres + DB_PORT: 5432 + DB_USERNAME: pos_micro + DB_PASSWORD: pos_micro_secret + DB_DATABASE: pos_micro_db + DB_SCHEMA: pos_micro + JWT_SECRET: pos-micro-jwt-secret-change-in-production + JWT_EXPIRES_IN: 24h + JWT_REFRESH_EXPIRES_IN: 7d + ports: + - "3071:3071" + depends_on: + postgres: + condition: service_healthy + volumes: + - ./backend/src:/app/src:ro + networks: + - pos-micro-network + + # Frontend PWA (Vite + React) + frontend: + build: + context: ./frontend + dockerfile: Dockerfile + container_name: pos-micro-web + environment: + VITE_API_URL: http://localhost:3071/api/v1 + ports: + - "5173:5173" + volumes: + - ./frontend/src:/app/src:ro + networks: + - pos-micro-network + +volumes: + pos_micro_data: + +networks: + pos-micro-network: + driver: bridge diff --git a/apps/products/pos-micro/docs/ANALISIS-GAPS.md b/apps/products/pos-micro/docs/ANALISIS-GAPS.md new file mode 100644 index 0000000..c8a591e --- /dev/null +++ b/apps/products/pos-micro/docs/ANALISIS-GAPS.md @@ -0,0 +1,192 @@ +# POS Micro - Analisis de Gaps vs ERP Core y Odoo POS + +## Resumen Ejecutivo + +Este documento analiza las diferencias entre POS Micro (producto MVP), ERP Core (arquitectura base) y Odoo POS (referencia de mercado) para identificar gaps y oportunidades de mejora. + +## 1. Comparativa de Arquitectura + +### ERP Core (Express + TypeScript) +- Framework: Express.js con TypeScript +- ORM: Raw PostgreSQL queries con Pool +- Autenticacion: JWT + Bcrypt + RBAC completo +- Validacion: Zod schemas +- Multi-tenancy: Schema isolation con RLS +- Modulos: 13 modulos completos (auth, users, companies, partners, inventory, products, warehouses, pickings, lots, financial, purchases, sales, crm, hr, projects, system) + +### POS Micro (NestJS + TypeORM) +- Framework: NestJS con TypeScript +- ORM: TypeORM +- Autenticacion: JWT + Bcrypt + PIN simplificado +- Validacion: class-validator decorators +- Multi-tenancy: tenant_id column (simplificado) +- Modulos: 5 modulos minimos (auth, products, categories, sales, payments) + +### Odoo POS (Python + ORM) +- Framework: Odoo 18 (Python) +- ORM: Odoo ORM +- Modulos POS: 40+ tablas/modelos interconectados +- Funcionalidades avanzadas: Restaurant, Loyalty, IoT, Multiple payment terminals + +## 2. Gaps Identificados + +### 2.1 Seguridad + +| Feature | ERP Core | POS Micro | Odoo POS | Gap | +|---------|----------|-----------|----------|-----| +| RBAC completo | ✅ | ❌ | ✅ | POS Micro solo tiene owner/cashier | +| Rate limiting | ❌ | ❌ | ✅ | Ninguno implementa | +| Audit logs | ✅ | ❌ | ✅ | POS Micro no tiene | +| Session management | ✅ | ❌ | ✅ | POS Micro no maneja sesiones de caja | + +### 2.2 Funcionalidad POS + +| Feature | ERP Core | POS Micro | Odoo POS | Gap | +|---------|----------|-----------|----------|-----| +| Sesiones de caja | N/A | ❌ | ✅ | Critico para control de caja | +| Cierre de caja | N/A | ❌ | ✅ | Critico para contabilidad | +| Arqueo de caja | N/A | ❌ | ✅ | Control de efectivo | +| Devoluciones | N/A | Parcial | ✅ | Solo cancelacion same-day | +| Descuentos globales | N/A | ❌ | ✅ | Solo descuento por linea | +| Impuestos configurables | N/A | Hardcoded 16% | ✅ | No flexible | +| Multi-tarifa | N/A | ❌ | ✅ | Un precio por producto | +| Combos/Kits | N/A | ❌ | ✅ | No soportado | +| Variantes producto | N/A | ❌ | ✅ | No soportado | + +### 2.3 Integraciones + +| Feature | ERP Core | POS Micro | Odoo POS | Gap | +|---------|----------|-----------|----------|-----| +| Inventario | ✅ Completo | Basico | ✅ Completo | Sin lotes/series | +| Contabilidad | ✅ | ❌ | ✅ | No genera asientos | +| Facturacion | ❌ | ❌ | ✅ | No hay CFDI | +| WhatsApp | ❌ | Tabla vacia | ❌ | Preparado pero no implementado | +| Impresoras | ❌ | ❌ | ✅ | No hay soporte | +| Terminal pago | ❌ | ❌ | ✅ | No integrado | + +### 2.4 Reportes + +| Feature | ERP Core | POS Micro | Odoo POS | Gap | +|---------|----------|-----------|----------|-----| +| Ventas del dia | ❌ | ✅ Basico | ✅ Completo | Solo totales | +| Por vendedor | ❌ | ❌ | ✅ | No soportado | +| Por producto | ❌ | ❌ | ✅ | No soportado | +| Por hora | ❌ | ❌ | ✅ | No soportado | +| Margen | ❌ | ❌ | ✅ | No soportado | +| Exportable | ❌ | ❌ | ✅ | No hay exports | + +## 3. Correcciones Aplicadas + +### 3.1 Frontend - Login +- **Problema**: Frontend enviaba `businessName` donde backend esperaba `phone` +- **Solucion**: Actualizado LoginPage para usar `phone` y agregar `ownerName` para registro + +### 3.2 Frontend - Endpoints +- **Problema**: Endpoints no coincidian con backend +- **Correcciones**: + - `/products/favorites` → `/products?isFavorite=true` + - `/products/{id}/favorite` → `/products/{id}/toggle-favorite` + - `/sales?date=` → `/sales/recent?limit=50` + - `PATCH /sales/{id}/cancel` → `POST /sales/{id}/cancel` + - `/sales/summary/{date}` → `/sales/today` + +### 3.3 Frontend - Tipos TypeScript +- **Problema**: Tipos no alineados con entidades backend +- **Correcciones**: + - `currentStock` → `stockQuantity` + - `minStock` → `lowStockAlert` + - `discount` → `discountAmount/discountPercent` + - `tax` → `taxAmount` + - `change` → `changeAmount` + - Agregado `SubscriptionStatus` type + +### 3.4 Frontend - Cart Store +- **Problema**: Calculo de descuentos no funcionaba +- **Solucion**: Actualizado para aplicar `discountPercent` correctamente al subtotal + +## 4. Gaps Pendientes (Roadmap) + +### Fase 2 - Funcionalidad Core +1. **Sesiones de caja**: Apertura, cierre, arqueo +2. **Devoluciones completas**: No solo same-day +3. **Descuentos globales**: Por orden, no solo por linea +4. **Impuestos configurables**: Permitir diferentes tasas + +### Fase 3 - Integraciones +1. **WhatsApp Business**: Tickets por WhatsApp +2. **Facturacion CFDI**: Integracion con PAC +3. **Impresoras termicas**: Soporte ESC/POS +4. **Terminales de pago**: Integracion basica + +### Fase 4 - Reportes +1. **Reporte por producto**: Top ventas, margenes +2. **Reporte por periodo**: Semanal, mensual +3. **Exportacion**: CSV, PDF + +## 5. Patrones de ERP Core a Adoptar + +### 5.1 Base Service Pattern +```typescript +// ERP Core tiene un servicio base reutilizable +abstract class BaseService { + // findAll con paginacion, busqueda y filtros + // findById, findByIdOrFail + // exists, softDelete, hardDelete + // withTransaction +} +``` +**Recomendacion**: Implementar en POS Micro para consistencia + +### 5.2 Error Handling +```typescript +// ERP Core usa clases de error personalizadas +class ValidationError extends AppError { } +class NotFoundError extends AppError { } +class ConflictError extends AppError { } +``` +**Recomendacion**: Adoptar mismo patron en NestJS + +### 5.3 Audit Fields +```typescript +// ERP Core tiene campos de auditoria consistentes +created_at, created_by +updated_at, updated_by +deleted_at, deleted_by +``` +**Recomendacion**: Agregar `created_by`, `updated_by` a todas las tablas + +## 6. Funcionalidades de Odoo a Considerar + +### 6.1 Session Management (Critico) +- Apertura de sesion con saldo inicial +- Estado: opening_control → opened → closing_control → closed +- Validacion de diferencias de caja +- Asientos contables automaticos + +### 6.2 Loyalty Programs (Futuro) +- Puntos por compra +- Recompensas configurables +- Tarjetas de cliente +- Cupones/Promociones + +### 6.3 Restaurant Mode (Futuro) +- Mesas/pisos +- Ordenes abiertas +- Impresion a cocina +- Division de cuentas + +## 7. Conclusion + +POS Micro esta correctamente posicionado como un MVP minimo para el mercado mexicano informal (vendedores ambulantes, tienditas, fondas). Las correcciones aplicadas resuelven los problemas criticos de comunicacion frontend-backend. + +Los gaps identificados son caracteristicas para fases futuras, no bloquean el lanzamiento del MVP que cumple con: +- ✅ Registro/Login simple con PIN +- ✅ Catalogo de productos (max 500) +- ✅ Ventas rapidas (max 1000/mes) +- ✅ Multiples formas de pago +- ✅ Reportes basicos del dia +- ✅ Offline-first PWA + +--- +*Documento generado: 2025-12-08* +*Version: 1.0* diff --git a/apps/products/pos-micro/frontend/.env.example b/apps/products/pos-micro/frontend/.env.example new file mode 100644 index 0000000..77a7ad3 --- /dev/null +++ b/apps/products/pos-micro/frontend/.env.example @@ -0,0 +1,6 @@ +# ============================================================================= +# POS MICRO - Frontend Environment Variables +# ============================================================================= + +# API URL +VITE_API_URL=http://localhost:3071/api/v1 diff --git a/apps/products/pos-micro/frontend/Dockerfile b/apps/products/pos-micro/frontend/Dockerfile new file mode 100644 index 0000000..001fc2c --- /dev/null +++ b/apps/products/pos-micro/frontend/Dockerfile @@ -0,0 +1,58 @@ +# ============================================================================= +# POS MICRO - Frontend Dockerfile +# ============================================================================= + +# Build stage +FROM node:20-alpine AS builder + +WORKDIR /app + +# Copy package files +COPY package*.json ./ + +# Install dependencies +RUN npm ci + +# Copy source code +COPY . . + +# Build application +RUN npm run build + +# Production stage - serve with nginx +FROM nginx:alpine AS production + +# Copy built files +COPY --from=builder /app/dist /usr/share/nginx/html + +# Copy nginx config +COPY nginx.conf /etc/nginx/conf.d/default.conf + +# Expose port +EXPOSE 80 + +# Health check +HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \ + CMD wget --no-verbose --tries=1 --spider http://localhost/ || exit 1 + +CMD ["nginx", "-g", "daemon off;"] + +# Development stage +FROM node:20-alpine AS development + +WORKDIR /app + +# Copy package files +COPY package*.json ./ + +# Install dependencies +RUN npm ci + +# Copy source code +COPY . . + +# Expose port +EXPOSE 5173 + +# Start in development mode +CMD ["npm", "run", "dev"] diff --git a/apps/products/pos-micro/frontend/index.html b/apps/products/pos-micro/frontend/index.html new file mode 100644 index 0000000..6c90275 --- /dev/null +++ b/apps/products/pos-micro/frontend/index.html @@ -0,0 +1,19 @@ + + + + + + + + + + + + + POS Micro + + +
+ + + diff --git a/apps/products/pos-micro/frontend/nginx.conf b/apps/products/pos-micro/frontend/nginx.conf new file mode 100644 index 0000000..ba3160c --- /dev/null +++ b/apps/products/pos-micro/frontend/nginx.conf @@ -0,0 +1,35 @@ +server { + listen 80; + server_name localhost; + root /usr/share/nginx/html; + index index.html; + + # Gzip compression + gzip on; + gzip_vary on; + gzip_min_length 1024; + gzip_proxied expired no-cache no-store private auth; + gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml application/javascript; + + # Cache static assets + location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ { + expires 1y; + add_header Cache-Control "public, immutable"; + } + + # PWA manifest and service worker - no cache + location ~* (manifest\.json|sw\.js)$ { + expires -1; + add_header Cache-Control "no-store, no-cache, must-revalidate"; + } + + # SPA fallback - all routes go to index.html + location / { + try_files $uri $uri/ /index.html; + } + + # Security headers + add_header X-Frame-Options "SAMEORIGIN" always; + add_header X-Content-Type-Options "nosniff" always; + add_header X-XSS-Protection "1; mode=block" always; +} diff --git a/apps/products/pos-micro/frontend/package-lock.json b/apps/products/pos-micro/frontend/package-lock.json new file mode 100644 index 0000000..bae5e53 --- /dev/null +++ b/apps/products/pos-micro/frontend/package-lock.json @@ -0,0 +1,8820 @@ +{ + "name": "pos-micro-frontend", + "version": "1.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "pos-micro-frontend", + "version": "1.0.0", + "dependencies": { + "@tanstack/react-query": "^5.8.4", + "axios": "^1.6.2", + "clsx": "^2.0.0", + "lucide-react": "^0.294.0", + "react": "^18.2.0", + "react-dom": "^18.2.0", + "react-router-dom": "^6.20.0", + "zustand": "^4.4.7" + }, + "devDependencies": { + "@types/react": "^18.2.37", + "@types/react-dom": "^18.2.15", + "@typescript-eslint/eslint-plugin": "^6.10.0", + "@typescript-eslint/parser": "^6.10.0", + "@vitejs/plugin-react": "^4.2.0", + "autoprefixer": "^10.4.16", + "eslint": "^8.53.0", + "eslint-plugin-react-hooks": "^4.6.0", + "eslint-plugin-react-refresh": "^0.4.4", + "postcss": "^8.4.31", + "tailwindcss": "^3.3.5", + "typescript": "^5.2.2", + "vite": "^5.0.0", + "vite-plugin-pwa": "^0.17.4", + "workbox-window": "^7.0.0" + } + }, + "node_modules/@alloc/quick-lru": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/@alloc/quick-lru/-/quick-lru-5.2.0.tgz", + "integrity": "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@babel/code-frame": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz", + "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.27.1", + "js-tokens": "^4.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/compat-data": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.5.tgz", + "integrity": "sha512-6uFXyCayocRbqhZOB+6XcuZbkMNimwfVGFji8CTZnCzOHVGvDqzvitu1re2AU5LROliz7eQPhB8CpAMvnx9EjA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/core": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.5.tgz", + "integrity": "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/code-frame": "^7.27.1", + "@babel/generator": "^7.28.5", + "@babel/helper-compilation-targets": "^7.27.2", + "@babel/helper-module-transforms": "^7.28.3", + "@babel/helpers": "^7.28.4", + "@babel/parser": "^7.28.5", + "@babel/template": "^7.27.2", + "@babel/traverse": "^7.28.5", + "@babel/types": "^7.28.5", + "@jridgewell/remapping": "^2.3.5", + "convert-source-map": "^2.0.0", + "debug": "^4.1.0", + "gensync": "^1.0.0-beta.2", + "json5": "^2.2.3", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/babel" + } + }, + "node_modules/@babel/core/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/@babel/generator": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.5.tgz", + "integrity": "sha512-3EwLFhZ38J4VyIP6WNtt2kUdW9dokXA9Cr4IVIFHuCpZ3H8/YFOl5JjZHisrn1fATPBmKKqXzDFvh9fUwHz6CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.28.5", + "@babel/types": "^7.28.5", + "@jridgewell/gen-mapping": "^0.3.12", + "@jridgewell/trace-mapping": "^0.3.28", + "jsesc": "^3.0.2" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-annotate-as-pure": { + "version": "7.27.3", + "resolved": "https://registry.npmjs.org/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.27.3.tgz", + "integrity": "sha512-fXSwMQqitTGeHLBC08Eq5yXz2m37E4pJX1qAU1+2cNedz/ifv/bVXft90VeSav5nFO61EcNgwr0aJxbyPaWBPg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.27.3" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-compilation-targets": { + "version": "7.27.2", + "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz", + "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.27.2", + "@babel/helper-validator-option": "^7.27.1", + "browserslist": "^4.24.0", + "lru-cache": "^5.1.1", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-compilation-targets/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/@babel/helper-create-class-features-plugin": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.28.5.tgz", + "integrity": "sha512-q3WC4JfdODypvxArsJQROfupPBq9+lMwjKq7C33GhbFYJsufD0yd/ziwD+hJucLeWsnFPWZjsU2DNFqBPE7jwQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.27.3", + "@babel/helper-member-expression-to-functions": "^7.28.5", + "@babel/helper-optimise-call-expression": "^7.27.1", + "@babel/helper-replace-supers": "^7.27.1", + "@babel/helper-skip-transparent-expression-wrappers": "^7.27.1", + "@babel/traverse": "^7.28.5", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-create-class-features-plugin/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/@babel/helper-create-regexp-features-plugin": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-create-regexp-features-plugin/-/helper-create-regexp-features-plugin-7.28.5.tgz", + "integrity": "sha512-N1EhvLtHzOvj7QQOUCCS3NrPJP8c5W6ZXCHDn7Yialuy1iu4r5EmIYkXlKNqT99Ciw+W0mDqWoR6HWMZlFP3hw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.27.3", + "regexpu-core": "^6.3.1", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-create-regexp-features-plugin/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/@babel/helper-define-polyfill-provider": { + "version": "0.6.5", + "resolved": "https://registry.npmjs.org/@babel/helper-define-polyfill-provider/-/helper-define-polyfill-provider-0.6.5.tgz", + "integrity": "sha512-uJnGFcPsWQK8fvjgGP5LZUZZsYGIoPeRjSF5PGwrelYgq7Q15/Ft9NGFp1zglwgIv//W0uG4BevRuSJRyylZPg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-compilation-targets": "^7.27.2", + "@babel/helper-plugin-utils": "^7.27.1", + "debug": "^4.4.1", + "lodash.debounce": "^4.0.8", + "resolve": "^1.22.10" + }, + "peerDependencies": { + "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0" + } + }, + "node_modules/@babel/helper-globals": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz", + "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-member-expression-to-functions": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.28.5.tgz", + "integrity": "sha512-cwM7SBRZcPCLgl8a7cY0soT1SptSzAlMH39vwiRpOQkJlh53r5hdHwLSCZpQdVLT39sZt+CRpNwYG4Y2v77atg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/traverse": "^7.28.5", + "@babel/types": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-imports": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz", + "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/traverse": "^7.27.1", + "@babel/types": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-transforms": { + "version": "7.28.3", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz", + "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.27.1", + "@babel/helper-validator-identifier": "^7.27.1", + "@babel/traverse": "^7.28.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-optimise-call-expression": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.27.1.tgz", + "integrity": "sha512-URMGH08NzYFhubNSGJrpUEphGKQwMQYBySzat5cAByY1/YgIRkULnIy3tAMeszlL/so2HbeilYloUmSpd7GdVw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-plugin-utils": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.27.1.tgz", + "integrity": "sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-remap-async-to-generator": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-remap-async-to-generator/-/helper-remap-async-to-generator-7.27.1.tgz", + "integrity": "sha512-7fiA521aVw8lSPeI4ZOD3vRFkoqkJcS+z4hFo82bFSH/2tNd6eJ5qCVMS5OzDmZh/kaHQeBaeyxK6wljcPtveA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.27.1", + "@babel/helper-wrap-function": "^7.27.1", + "@babel/traverse": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-replace-supers": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-replace-supers/-/helper-replace-supers-7.27.1.tgz", + "integrity": "sha512-7EHz6qDZc8RYS5ElPoShMheWvEgERonFCs7IAonWLLUTXW59DP14bCZt89/GKyreYn8g3S83m21FelHKbeDCKA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-member-expression-to-functions": "^7.27.1", + "@babel/helper-optimise-call-expression": "^7.27.1", + "@babel/traverse": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-skip-transparent-expression-wrappers": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-skip-transparent-expression-wrappers/-/helper-skip-transparent-expression-wrappers-7.27.1.tgz", + "integrity": "sha512-Tub4ZKEXqbPjXgWLl2+3JpQAYBJ8+ikpQ2Ocj/q/r0LwE3UhENh7EUabyHjz2kCEsrRY83ew2DQdHluuiDQFzg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/traverse": "^7.27.1", + "@babel/types": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz", + "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", + "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-option": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz", + "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-wrap-function": { + "version": "7.28.3", + "resolved": "https://registry.npmjs.org/@babel/helper-wrap-function/-/helper-wrap-function-7.28.3.tgz", + "integrity": "sha512-zdf983tNfLZFletc0RRXYrHrucBEg95NIFMkn6K9dbeMYnsgHaSBGcQqdsCSStG2PYwRre0Qc2NNSCXbG+xc6g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/template": "^7.27.2", + "@babel/traverse": "^7.28.3", + "@babel/types": "^7.28.2" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helpers": { + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.4.tgz", + "integrity": "sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/template": "^7.27.2", + "@babel/types": "^7.28.4" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.5.tgz", + "integrity": "sha512-KKBU1VGYR7ORr3At5HAtUQ+TV3SzRCXmA/8OdDZiLDBIZxVyzXuztPjfLd3BV1PRAQGCMWWSHYhL0F8d5uHBDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.28.5" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/plugin-bugfix-firefox-class-in-computed-class-key": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-firefox-class-in-computed-class-key/-/plugin-bugfix-firefox-class-in-computed-class-key-7.28.5.tgz", + "integrity": "sha512-87GDMS3tsmMSi/3bWOte1UblL+YUTFMV8SZPZ2eSEL17s74Cw/l63rR6NmGVKMYW2GYi85nE+/d6Hw5N0bEk2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/traverse": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/plugin-bugfix-safari-class-field-initializer-scope": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-safari-class-field-initializer-scope/-/plugin-bugfix-safari-class-field-initializer-scope-7.27.1.tgz", + "integrity": "sha512-qNeq3bCKnGgLkEXUuFry6dPlGfCdQNZbn7yUAPCInwAJHMU7THJfrBSozkcWq5sNM6RcF3S8XyQL2A52KNR9IA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression/-/plugin-bugfix-safari-id-destructuring-collision-in-function-expression-7.27.1.tgz", + "integrity": "sha512-g4L7OYun04N1WyqMNjldFwlfPCLVkgB54A/YCXICZYBsvJJE3kByKv9c9+R/nAfmIfjl2rKYLNyMHboYbZaWaA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining/-/plugin-bugfix-v8-spread-parameters-in-optional-chaining-7.27.1.tgz", + "integrity": "sha512-oO02gcONcD5O1iTLi/6frMJBIwWEHceWGSGqrpCmEL8nogiS6J9PBlE48CaK20/Jx1LuRml9aDftLgdjXT8+Cw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/helper-skip-transparent-expression-wrappers": "^7.27.1", + "@babel/plugin-transform-optional-chaining": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.13.0" + } + }, + "node_modules/@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly": { + "version": "7.28.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly/-/plugin-bugfix-v8-static-class-fields-redefine-readonly-7.28.3.tgz", + "integrity": "sha512-b6YTX108evsvE4YgWyQ921ZAFFQm3Bn+CA3+ZXlNVnPhx+UfsVURoPjfGAPCjBgrqo30yX/C2nZGX96DxvR9Iw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/traverse": "^7.28.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/plugin-proposal-private-property-in-object": { + "version": "7.21.0-placeholder-for-preset-env.2", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-private-property-in-object/-/plugin-proposal-private-property-in-object-7.21.0-placeholder-for-preset-env.2.tgz", + "integrity": "sha512-SOSkfJDddaM7mak6cPEpswyTRnuRltl429hMraQEglW+OkovnCzsiszTmsrlY//qLFjCpQDFRvjdm2wA5pPm9w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-import-assertions": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-assertions/-/plugin-syntax-import-assertions-7.27.1.tgz", + "integrity": "sha512-UT/Jrhw57xg4ILHLFnzFpPDlMbcdEicaAtjPQpbj9wa8T4r5KVWCimHcL/460g8Ht0DMxDyjsLgiWSkVjnwPFg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-import-attributes": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.27.1.tgz", + "integrity": "sha512-oFT0FrKHgF53f4vOsZGi2Hh3I35PfSmVs4IBFLFj4dnafP+hIWDLg3VyKmUHfLoLHlyxY4C7DGtmHuJgn+IGww==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-unicode-sets-regex": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-unicode-sets-regex/-/plugin-syntax-unicode-sets-regex-7.18.6.tgz", + "integrity": "sha512-727YkEAPwSIQTv5im8QHz3upqp92JTWhidIC81Tdx4VJYIte/VndKf1qKrfnnhPLiPghStWfvC/iFaMCQu7Nqg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/plugin-transform-arrow-functions": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-arrow-functions/-/plugin-transform-arrow-functions-7.27.1.tgz", + "integrity": "sha512-8Z4TGic6xW70FKThA5HYEKKyBpOOsucTOD1DjU3fZxDg+K3zBJcXMFnt/4yQiZnf5+MiOMSXQ9PaEK/Ilh1DeA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-async-generator-functions": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-generator-functions/-/plugin-transform-async-generator-functions-7.28.0.tgz", + "integrity": "sha512-BEOdvX4+M765icNPZeidyADIvQ1m1gmunXufXxvRESy/jNNyfovIqUyE7MVgGBjWktCoJlzvFA1To2O4ymIO3Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/helper-remap-async-to-generator": "^7.27.1", + "@babel/traverse": "^7.28.0" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-async-to-generator": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-to-generator/-/plugin-transform-async-to-generator-7.27.1.tgz", + "integrity": "sha512-NREkZsZVJS4xmTr8qzE5y8AfIPqsdQfRuUiLRTEzb7Qii8iFWCyDKaUV2c0rCuh4ljDZ98ALHP/PetiBV2nddA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/helper-remap-async-to-generator": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-block-scoped-functions": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoped-functions/-/plugin-transform-block-scoped-functions-7.27.1.tgz", + "integrity": "sha512-cnqkuOtZLapWYZUYM5rVIdv1nXYuFVIltZ6ZJ7nIj585QsjKM5dhL2Fu/lICXZ1OyIAFc7Qy+bvDAtTXqGrlhg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-block-scoping": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoping/-/plugin-transform-block-scoping-7.28.5.tgz", + "integrity": "sha512-45DmULpySVvmq9Pj3X9B+62Xe+DJGov27QravQJU1LLcapR6/10i+gYVAucGGJpHBp5mYxIMK4nDAT/QDLr47g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-class-properties": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-class-properties/-/plugin-transform-class-properties-7.27.1.tgz", + "integrity": "sha512-D0VcalChDMtuRvJIu3U/fwWjf8ZMykz5iZsg77Nuj821vCKI3zCyRLwRdWbsuJ/uRwZhZ002QtCqIkwC/ZkvbA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-class-features-plugin": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-class-static-block": { + "version": "7.28.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-class-static-block/-/plugin-transform-class-static-block-7.28.3.tgz", + "integrity": "sha512-LtPXlBbRoc4Njl/oh1CeD/3jC+atytbnf/UqLoqTDcEYGUPj022+rvfkbDYieUrSj3CaV4yHDByPE+T2HwfsJg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-class-features-plugin": "^7.28.3", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.12.0" + } + }, + "node_modules/@babel/plugin-transform-classes": { + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-classes/-/plugin-transform-classes-7.28.4.tgz", + "integrity": "sha512-cFOlhIYPBv/iBoc+KS3M6et2XPtbT2HiCRfBXWtfpc9OAyostldxIf9YAYB6ypURBBbx+Qv6nyrLzASfJe+hBA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.27.3", + "@babel/helper-compilation-targets": "^7.27.2", + "@babel/helper-globals": "^7.28.0", + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/helper-replace-supers": "^7.27.1", + "@babel/traverse": "^7.28.4" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-computed-properties": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-computed-properties/-/plugin-transform-computed-properties-7.27.1.tgz", + "integrity": "sha512-lj9PGWvMTVksbWiDT2tW68zGS/cyo4AkZ/QTp0sQT0mjPopCmrSkzxeXkznjqBxzDI6TclZhOJbBmbBLjuOZUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/template": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-destructuring": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-destructuring/-/plugin-transform-destructuring-7.28.5.tgz", + "integrity": "sha512-Kl9Bc6D0zTUcFUvkNuQh4eGXPKKNDOJQXVyyM4ZAQPMveniJdxi8XMJwLo+xSoW3MIq81bD33lcUe9kZpl0MCw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/traverse": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-dotall-regex": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-dotall-regex/-/plugin-transform-dotall-regex-7.27.1.tgz", + "integrity": "sha512-gEbkDVGRvjj7+T1ivxrfgygpT7GUd4vmODtYpbs0gZATdkX8/iSnOtZSxiZnsgm1YjTgjI6VKBGSJJevkrclzw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-duplicate-keys": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-duplicate-keys/-/plugin-transform-duplicate-keys-7.27.1.tgz", + "integrity": "sha512-MTyJk98sHvSs+cvZ4nOauwTTG1JeonDjSGvGGUNHreGQns+Mpt6WX/dVzWBHgg+dYZhkC4X+zTDfkTU+Vy9y7Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-duplicate-named-capturing-groups-regex": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-duplicate-named-capturing-groups-regex/-/plugin-transform-duplicate-named-capturing-groups-regex-7.27.1.tgz", + "integrity": "sha512-hkGcueTEzuhB30B3eJCbCYeCaaEQOmQR0AdvzpD4LoN0GXMWzzGSuRrxR2xTnCrvNbVwK9N6/jQ92GSLfiZWoQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/plugin-transform-dynamic-import": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-dynamic-import/-/plugin-transform-dynamic-import-7.27.1.tgz", + "integrity": "sha512-MHzkWQcEmjzzVW9j2q8LGjwGWpG2mjwaaB0BNQwst3FIjqsg8Ct/mIZlvSPJvfi9y2AC8mi/ktxbFVL9pZ1I4A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-explicit-resource-management": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-explicit-resource-management/-/plugin-transform-explicit-resource-management-7.28.0.tgz", + "integrity": "sha512-K8nhUcn3f6iB+P3gwCv/no7OdzOZQcKchW6N389V6PD8NUWKZHzndOd9sPDVbMoBsbmjMqlB4L9fm+fEFNVlwQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/plugin-transform-destructuring": "^7.28.0" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-exponentiation-operator": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-exponentiation-operator/-/plugin-transform-exponentiation-operator-7.28.5.tgz", + "integrity": "sha512-D4WIMaFtwa2NizOp+dnoFjRez/ClKiC2BqqImwKd1X28nqBtZEyCYJ2ozQrrzlxAFrcrjxo39S6khe9RNDlGzw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-export-namespace-from": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-export-namespace-from/-/plugin-transform-export-namespace-from-7.27.1.tgz", + "integrity": "sha512-tQvHWSZ3/jH2xuq/vZDy0jNn+ZdXJeM8gHvX4lnJmsc3+50yPlWdZXIc5ay+umX+2/tJIqHqiEqcJvxlmIvRvQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-for-of": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-for-of/-/plugin-transform-for-of-7.27.1.tgz", + "integrity": "sha512-BfbWFFEJFQzLCQ5N8VocnCtA8J1CLkNTe2Ms2wocj75dd6VpiqS5Z5quTYcUoo4Yq+DN0rtikODccuv7RU81sw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/helper-skip-transparent-expression-wrappers": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-function-name": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-function-name/-/plugin-transform-function-name-7.27.1.tgz", + "integrity": "sha512-1bQeydJF9Nr1eBCMMbC+hdwmRlsv5XYOMu03YSWFwNs0HsAmtSxxF1fyuYPqemVldVyFmlCU7w8UE14LupUSZQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-compilation-targets": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/traverse": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-json-strings": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-json-strings/-/plugin-transform-json-strings-7.27.1.tgz", + "integrity": "sha512-6WVLVJiTjqcQauBhn1LkICsR2H+zm62I3h9faTDKt1qP4jn2o72tSvqMwtGFKGTpojce0gJs+76eZ2uCHRZh0Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-literals": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-literals/-/plugin-transform-literals-7.27.1.tgz", + "integrity": "sha512-0HCFSepIpLTkLcsi86GG3mTUzxV5jpmbv97hTETW3yzrAij8aqlD36toB1D0daVFJM8NK6GvKO0gslVQmm+zZA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-logical-assignment-operators": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-logical-assignment-operators/-/plugin-transform-logical-assignment-operators-7.28.5.tgz", + "integrity": "sha512-axUuqnUTBuXyHGcJEVVh9pORaN6wC5bYfE7FGzPiaWa3syib9m7g+/IT/4VgCOe2Upef43PHzeAvcrVek6QuuA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-member-expression-literals": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-member-expression-literals/-/plugin-transform-member-expression-literals-7.27.1.tgz", + "integrity": "sha512-hqoBX4dcZ1I33jCSWcXrP+1Ku7kdqXf1oeah7ooKOIiAdKQ+uqftgCFNOSzA5AMS2XIHEYeGFg4cKRCdpxzVOQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-modules-amd": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-amd/-/plugin-transform-modules-amd-7.27.1.tgz", + "integrity": "sha512-iCsytMg/N9/oFq6n+gFTvUYDZQOMK5kEdeYxmxt91fcJGycfxVP9CnrxoliM0oumFERba2i8ZtwRUCMhvP1LnA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-transforms": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-modules-commonjs": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-commonjs/-/plugin-transform-modules-commonjs-7.27.1.tgz", + "integrity": "sha512-OJguuwlTYlN0gBZFRPqwOGNWssZjfIUdS7HMYtN8c1KmwpwHFBwTeFZrg9XZa+DFTitWOW5iTAG7tyCUPsCCyw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-transforms": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-modules-systemjs": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-systemjs/-/plugin-transform-modules-systemjs-7.28.5.tgz", + "integrity": "sha512-vn5Jma98LCOeBy/KpeQhXcV2WZgaRUtjwQmjoBuLNlOmkg0fB5pdvYVeWRYI69wWKwK2cD1QbMiUQnoujWvrew==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-transforms": "^7.28.3", + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5", + "@babel/traverse": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-modules-umd": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-umd/-/plugin-transform-modules-umd-7.27.1.tgz", + "integrity": "sha512-iQBE/xC5BV1OxJbp6WG7jq9IWiD+xxlZhLrdwpPkTX3ydmXdvoCpyfJN7acaIBZaOqTfr76pgzqBJflNbeRK+w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-transforms": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-named-capturing-groups-regex": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-named-capturing-groups-regex/-/plugin-transform-named-capturing-groups-regex-7.27.1.tgz", + "integrity": "sha512-SstR5JYy8ddZvD6MhV0tM/j16Qds4mIpJTOd1Yu9J9pJjH93bxHECF7pgtc28XvkzTD6Pxcm/0Z73Hvk7kb3Ng==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/plugin-transform-new-target": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-new-target/-/plugin-transform-new-target-7.27.1.tgz", + "integrity": "sha512-f6PiYeqXQ05lYq3TIfIDu/MtliKUbNwkGApPUvyo6+tc7uaR4cPjPe7DFPr15Uyycg2lZU6btZ575CuQoYh7MQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-nullish-coalescing-operator": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-nullish-coalescing-operator/-/plugin-transform-nullish-coalescing-operator-7.27.1.tgz", + "integrity": "sha512-aGZh6xMo6q9vq1JGcw58lZ1Z0+i0xB2x0XaauNIUXd6O1xXc3RwoWEBlsTQrY4KQ9Jf0s5rgD6SiNkaUdJegTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-numeric-separator": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-numeric-separator/-/plugin-transform-numeric-separator-7.27.1.tgz", + "integrity": "sha512-fdPKAcujuvEChxDBJ5c+0BTaS6revLV7CJL08e4m3de8qJfNIuCc2nc7XJYOjBoTMJeqSmwXJ0ypE14RCjLwaw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-object-rest-spread": { + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-object-rest-spread/-/plugin-transform-object-rest-spread-7.28.4.tgz", + "integrity": "sha512-373KA2HQzKhQCYiRVIRr+3MjpCObqzDlyrM6u4I201wL8Mp2wHf7uB8GhDwis03k2ti8Zr65Zyyqs1xOxUF/Ew==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-compilation-targets": "^7.27.2", + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/plugin-transform-destructuring": "^7.28.0", + "@babel/plugin-transform-parameters": "^7.27.7", + "@babel/traverse": "^7.28.4" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-object-super": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-object-super/-/plugin-transform-object-super-7.27.1.tgz", + "integrity": "sha512-SFy8S9plRPbIcxlJ8A6mT/CxFdJx/c04JEctz4jf8YZaVS2px34j7NXRrlGlHkN/M2gnpL37ZpGRGVFLd3l8Ng==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/helper-replace-supers": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-optional-catch-binding": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-optional-catch-binding/-/plugin-transform-optional-catch-binding-7.27.1.tgz", + "integrity": "sha512-txEAEKzYrHEX4xSZN4kJ+OfKXFVSWKB2ZxM9dpcE3wT7smwkNmXo5ORRlVzMVdJbD+Q8ILTgSD7959uj+3Dm3Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-optional-chaining": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-optional-chaining/-/plugin-transform-optional-chaining-7.28.5.tgz", + "integrity": "sha512-N6fut9IZlPnjPwgiQkXNhb+cT8wQKFlJNqcZkWlcTqkcqx6/kU4ynGmLFoa4LViBSirn05YAwk+sQBbPfxtYzQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/helper-skip-transparent-expression-wrappers": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-parameters": { + "version": "7.27.7", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-parameters/-/plugin-transform-parameters-7.27.7.tgz", + "integrity": "sha512-qBkYTYCb76RRxUM6CcZA5KRu8K4SM8ajzVeUgVdMVO9NN9uI/GaVmBg/WKJJGnNokV9SY8FxNOVWGXzqzUidBg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-private-methods": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-private-methods/-/plugin-transform-private-methods-7.27.1.tgz", + "integrity": "sha512-10FVt+X55AjRAYI9BrdISN9/AQWHqldOeZDUoLyif1Kn05a56xVBXb8ZouL8pZ9jem8QpXaOt8TS7RHUIS+GPA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-class-features-plugin": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-private-property-in-object": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-private-property-in-object/-/plugin-transform-private-property-in-object-7.27.1.tgz", + "integrity": "sha512-5J+IhqTi1XPa0DXF83jYOaARrX+41gOewWbkPyjMNRDqgOCqdffGh8L3f/Ek5utaEBZExjSAzcyjmV9SSAWObQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.27.1", + "@babel/helper-create-class-features-plugin": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-property-literals": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-property-literals/-/plugin-transform-property-literals-7.27.1.tgz", + "integrity": "sha512-oThy3BCuCha8kDZ8ZkgOg2exvPYUlprMukKQXI1r1pJ47NCvxfkEy8vK+r/hT9nF0Aa4H1WUPZZjHTFtAhGfmQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-react-jsx-self": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-self/-/plugin-transform-react-jsx-self-7.27.1.tgz", + "integrity": "sha512-6UzkCs+ejGdZ5mFFC/OCUrv028ab2fp1znZmCZjAOBKiBK2jXD1O+BPSfX8X2qjJ75fZBMSnQn3Rq2mrBJK2mw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-react-jsx-source": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-source/-/plugin-transform-react-jsx-source-7.27.1.tgz", + "integrity": "sha512-zbwoTsBruTeKB9hSq73ha66iFeJHuaFkUbwvqElnygoNbj/jHRsSeokowZFN3CZ64IvEqcmmkVe89OPXc7ldAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-regenerator": { + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-regenerator/-/plugin-transform-regenerator-7.28.4.tgz", + "integrity": "sha512-+ZEdQlBoRg9m2NnzvEeLgtvBMO4tkFBw5SQIUgLICgTrumLoU7lr+Oghi6km2PFj+dbUt2u1oby2w3BDO9YQnA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-regexp-modifiers": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-regexp-modifiers/-/plugin-transform-regexp-modifiers-7.27.1.tgz", + "integrity": "sha512-TtEciroaiODtXvLZv4rmfMhkCv8jx3wgKpL68PuiPh2M4fvz5jhsA7697N1gMvkvr/JTF13DrFYyEbY9U7cVPA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/plugin-transform-reserved-words": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-reserved-words/-/plugin-transform-reserved-words-7.27.1.tgz", + "integrity": "sha512-V2ABPHIJX4kC7HegLkYoDpfg9PVmuWy/i6vUM5eGK22bx4YVFD3M5F0QQnWQoDs6AGsUWTVOopBiMFQgHaSkVw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-shorthand-properties": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-shorthand-properties/-/plugin-transform-shorthand-properties-7.27.1.tgz", + "integrity": "sha512-N/wH1vcn4oYawbJ13Y/FxcQrWk63jhfNa7jef0ih7PHSIHX2LB7GWE1rkPrOnka9kwMxb6hMl19p7lidA+EHmQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-spread": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-spread/-/plugin-transform-spread-7.27.1.tgz", + "integrity": "sha512-kpb3HUqaILBJcRFVhFUs6Trdd4mkrzcGXss+6/mxUd273PfbWqSDHRzMT2234gIg2QYfAjvXLSquP1xECSg09Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/helper-skip-transparent-expression-wrappers": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-sticky-regex": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-sticky-regex/-/plugin-transform-sticky-regex-7.27.1.tgz", + "integrity": "sha512-lhInBO5bi/Kowe2/aLdBAawijx+q1pQzicSgnkB6dUPc1+RC8QmJHKf2OjvU+NZWitguJHEaEmbV6VWEouT58g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-template-literals": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-template-literals/-/plugin-transform-template-literals-7.27.1.tgz", + "integrity": "sha512-fBJKiV7F2DxZUkg5EtHKXQdbsbURW3DZKQUWphDum0uRP6eHGGa/He9mc0mypL680pb+e/lDIthRohlv8NCHkg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-typeof-symbol": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-typeof-symbol/-/plugin-transform-typeof-symbol-7.27.1.tgz", + "integrity": "sha512-RiSILC+nRJM7FY5srIyc4/fGIwUhyDuuBSdWn4y6yT6gm652DpCHZjIipgn6B7MQ1ITOUnAKWixEUjQRIBIcLw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-unicode-escapes": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-escapes/-/plugin-transform-unicode-escapes-7.27.1.tgz", + "integrity": "sha512-Ysg4v6AmF26k9vpfFuTZg8HRfVWzsh1kVfowA23y9j/Gu6dOuahdUVhkLqpObp3JIv27MLSii6noRnuKN8H0Mg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-unicode-property-regex": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-property-regex/-/plugin-transform-unicode-property-regex-7.27.1.tgz", + "integrity": "sha512-uW20S39PnaTImxp39O5qFlHLS9LJEmANjMG7SxIhap8rCHqu0Ik+tLEPX5DKmHn6CsWQ7j3lix2tFOa5YtL12Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-unicode-regex": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-regex/-/plugin-transform-unicode-regex-7.27.1.tgz", + "integrity": "sha512-xvINq24TRojDuyt6JGtHmkVkrfVV3FPT16uytxImLeBZqW3/H52yN+kM1MGuyPkIQxrzKwPHs5U/MP3qKyzkGw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-unicode-sets-regex": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-sets-regex/-/plugin-transform-unicode-sets-regex-7.27.1.tgz", + "integrity": "sha512-EtkOujbc4cgvb0mlpQefi4NTPBzhSIevblFevACNLUspmrALgmEBdL/XfnyyITfd8fKBZrZys92zOWcik7j9Tw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.27.1", + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/preset-env": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/preset-env/-/preset-env-7.28.5.tgz", + "integrity": "sha512-S36mOoi1Sb6Fz98fBfE+UZSpYw5mJm0NUHtIKrOuNcqeFauy1J6dIvXm2KRVKobOSaGq4t/hBXdN4HGU3wL9Wg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.28.5", + "@babel/helper-compilation-targets": "^7.27.2", + "@babel/helper-plugin-utils": "^7.27.1", + "@babel/helper-validator-option": "^7.27.1", + "@babel/plugin-bugfix-firefox-class-in-computed-class-key": "^7.28.5", + "@babel/plugin-bugfix-safari-class-field-initializer-scope": "^7.27.1", + "@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": "^7.27.1", + "@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": "^7.27.1", + "@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly": "^7.28.3", + "@babel/plugin-proposal-private-property-in-object": "7.21.0-placeholder-for-preset-env.2", + "@babel/plugin-syntax-import-assertions": "^7.27.1", + "@babel/plugin-syntax-import-attributes": "^7.27.1", + "@babel/plugin-syntax-unicode-sets-regex": "^7.18.6", + "@babel/plugin-transform-arrow-functions": "^7.27.1", + "@babel/plugin-transform-async-generator-functions": "^7.28.0", + "@babel/plugin-transform-async-to-generator": "^7.27.1", + "@babel/plugin-transform-block-scoped-functions": "^7.27.1", + "@babel/plugin-transform-block-scoping": "^7.28.5", + "@babel/plugin-transform-class-properties": "^7.27.1", + "@babel/plugin-transform-class-static-block": "^7.28.3", + "@babel/plugin-transform-classes": "^7.28.4", + "@babel/plugin-transform-computed-properties": "^7.27.1", + "@babel/plugin-transform-destructuring": "^7.28.5", + "@babel/plugin-transform-dotall-regex": "^7.27.1", + "@babel/plugin-transform-duplicate-keys": "^7.27.1", + "@babel/plugin-transform-duplicate-named-capturing-groups-regex": "^7.27.1", + "@babel/plugin-transform-dynamic-import": "^7.27.1", + "@babel/plugin-transform-explicit-resource-management": "^7.28.0", + "@babel/plugin-transform-exponentiation-operator": "^7.28.5", + "@babel/plugin-transform-export-namespace-from": "^7.27.1", + "@babel/plugin-transform-for-of": "^7.27.1", + "@babel/plugin-transform-function-name": "^7.27.1", + "@babel/plugin-transform-json-strings": "^7.27.1", + "@babel/plugin-transform-literals": "^7.27.1", + "@babel/plugin-transform-logical-assignment-operators": "^7.28.5", + "@babel/plugin-transform-member-expression-literals": "^7.27.1", + "@babel/plugin-transform-modules-amd": "^7.27.1", + "@babel/plugin-transform-modules-commonjs": "^7.27.1", + "@babel/plugin-transform-modules-systemjs": "^7.28.5", + "@babel/plugin-transform-modules-umd": "^7.27.1", + "@babel/plugin-transform-named-capturing-groups-regex": "^7.27.1", + "@babel/plugin-transform-new-target": "^7.27.1", + "@babel/plugin-transform-nullish-coalescing-operator": "^7.27.1", + "@babel/plugin-transform-numeric-separator": "^7.27.1", + "@babel/plugin-transform-object-rest-spread": "^7.28.4", + "@babel/plugin-transform-object-super": "^7.27.1", + "@babel/plugin-transform-optional-catch-binding": "^7.27.1", + "@babel/plugin-transform-optional-chaining": "^7.28.5", + "@babel/plugin-transform-parameters": "^7.27.7", + "@babel/plugin-transform-private-methods": "^7.27.1", + "@babel/plugin-transform-private-property-in-object": "^7.27.1", + "@babel/plugin-transform-property-literals": "^7.27.1", + "@babel/plugin-transform-regenerator": "^7.28.4", + "@babel/plugin-transform-regexp-modifiers": "^7.27.1", + "@babel/plugin-transform-reserved-words": "^7.27.1", + "@babel/plugin-transform-shorthand-properties": "^7.27.1", + "@babel/plugin-transform-spread": "^7.27.1", + "@babel/plugin-transform-sticky-regex": "^7.27.1", + "@babel/plugin-transform-template-literals": "^7.27.1", + "@babel/plugin-transform-typeof-symbol": "^7.27.1", + "@babel/plugin-transform-unicode-escapes": "^7.27.1", + "@babel/plugin-transform-unicode-property-regex": "^7.27.1", + "@babel/plugin-transform-unicode-regex": "^7.27.1", + "@babel/plugin-transform-unicode-sets-regex": "^7.27.1", + "@babel/preset-modules": "0.1.6-no-external-plugins", + "babel-plugin-polyfill-corejs2": "^0.4.14", + "babel-plugin-polyfill-corejs3": "^0.13.0", + "babel-plugin-polyfill-regenerator": "^0.6.5", + "core-js-compat": "^3.43.0", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/preset-env/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/@babel/preset-modules": { + "version": "0.1.6-no-external-plugins", + "resolved": "https://registry.npmjs.org/@babel/preset-modules/-/preset-modules-0.1.6-no-external-plugins.tgz", + "integrity": "sha512-HrcgcIESLm9aIR842yhJ5RWan/gebQUJ6E/E5+rf0y9o6oj7w0Br+sWuL6kEQ/o/AdfvR1Je9jG18/gnpwjEyA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.0.0", + "@babel/types": "^7.4.4", + "esutils": "^2.0.2" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0 || ^8.0.0-0 <8.0.0" + } + }, + "node_modules/@babel/runtime": { + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.28.4.tgz", + "integrity": "sha512-Q/N6JNWvIvPnLDvjlE1OUBLPQHH6l3CltCEsHIujp45zQUSSh8K+gHnaEX45yAT1nyngnINhvWtzN+Nb9D8RAQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/template": { + "version": "7.27.2", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz", + "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.27.1", + "@babel/parser": "^7.27.2", + "@babel/types": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/traverse": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.5.tgz", + "integrity": "sha512-TCCj4t55U90khlYkVV/0TfkJkAkUg3jZFA3Neb7unZT8CPok7iiRfaX0F+WnqWqt7OxhOn0uBKXCw4lbL8W0aQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.27.1", + "@babel/generator": "^7.28.5", + "@babel/helper-globals": "^7.28.0", + "@babel/parser": "^7.28.5", + "@babel/template": "^7.27.2", + "@babel/types": "^7.28.5", + "debug": "^4.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/types": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.5.tgz", + "integrity": "sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz", + "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz", + "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz", + "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz", + "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz", + "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz", + "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz", + "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz", + "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz", + "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz", + "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz", + "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz", + "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz", + "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz", + "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz", + "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz", + "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz", + "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz", + "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz", + "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz", + "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz", + "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz", + "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz", + "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@eslint-community/eslint-utils": { + "version": "4.9.0", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", + "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "eslint-visitor-keys": "^3.4.3" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" + } + }, + "node_modules/@eslint-community/regexpp": { + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", + "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.0.0 || ^14.0.0 || >=16.0.0" + } + }, + "node_modules/@eslint/eslintrc": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-2.1.4.tgz", + "integrity": "sha512-269Z39MS6wVJtsoUl10L60WdkhJVdPG24Q4eZTH3nnF6lpvSShEK3wQjDX9JRWAUPvPh7COouPpU9IrqaZFvtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^6.12.4", + "debug": "^4.3.2", + "espree": "^9.6.0", + "globals": "^13.19.0", + "ignore": "^5.2.0", + "import-fresh": "^3.2.1", + "js-yaml": "^4.1.0", + "minimatch": "^3.1.2", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint/eslintrc/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/@eslint/eslintrc/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/@eslint/js": { + "version": "8.57.1", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.57.1.tgz", + "integrity": "sha512-d9zaMRSTIKDLhctzH12MtXvJKSSUhaHcjV+2Z+GK+EEY7XKpP5yR4x+N3TAcHTcu963nIr+TMcCb4DBCYX1z6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + } + }, + "node_modules/@humanwhocodes/config-array": { + "version": "0.13.0", + "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.13.0.tgz", + "integrity": "sha512-DZLEEqFWQFiyK6h5YIeynKx7JlvCYWL0cImfSRXZ9l4Sg2efkFGTuFf6vzXjK1cq6IYkU+Eg/JizXw+TD2vRNw==", + "deprecated": "Use @eslint/config-array instead", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanwhocodes/object-schema": "^2.0.3", + "debug": "^4.3.1", + "minimatch": "^3.0.5" + }, + "engines": { + "node": ">=10.10.0" + } + }, + "node_modules/@humanwhocodes/config-array/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/@humanwhocodes/config-array/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/@humanwhocodes/module-importer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", + "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.22" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@humanwhocodes/object-schema": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-2.0.3.tgz", + "integrity": "sha512-93zYdMES/c1D69yZiKDBj0V24vqNzB/koF26KPaagAfd3P/4gUlh3Dys5ogAK+Exi9QyzlD8x/08Zt7wIKcDcA==", + "deprecated": "Use @eslint/object-schema instead", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@isaacs/balanced-match": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/@isaacs/balanced-match/-/balanced-match-4.0.1.tgz", + "integrity": "sha512-yzMTt9lEb8Gv7zRioUilSglI0c0smZ9k5D65677DLWLtWJaXIS3CqcGyUFByYKlnUj6TkjLVs54fBl6+TiGQDQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/@isaacs/brace-expansion": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/@isaacs/brace-expansion/-/brace-expansion-5.0.0.tgz", + "integrity": "sha512-ZT55BDLV0yv0RBm2czMiZ+SqCGO7AvmOM3G/w2xhVPH+te0aKgFjmBvGlL1dH+ql2tgGO3MVrbb3jCKyvpgnxA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@isaacs/balanced-match": "^4.0.1" + }, + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/@isaacs/cliui": { + "version": "8.0.2", + "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz", + "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==", + "dev": true, + "license": "ISC", + "dependencies": { + "string-width": "^5.1.2", + "string-width-cjs": "npm:string-width@^4.2.0", + "strip-ansi": "^7.0.1", + "strip-ansi-cjs": "npm:strip-ansi@^6.0.1", + "wrap-ansi": "^8.1.0", + "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/@isaacs/cliui/node_modules/ansi-regex": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz", + "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/@isaacs/cliui/node_modules/strip-ansi": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.2.tgz", + "integrity": "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/@jridgewell/gen-mapping": { + "version": "0.3.13", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", + "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.0", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/remapping": { + "version": "2.3.5", + "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz", + "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "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/source-map": { + "version": "0.3.11", + "resolved": "https://registry.npmjs.org/@jridgewell/source-map/-/source-map-0.3.11.tgz", + "integrity": "sha512-ZMp1V8ZFcPG5dIWnQLr3NSI1MiCU7UETdS/A0G8V/XWHvJv3ZsFqutJn1Y5RPmAPX6F3BiE397OqveU/9NCuIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.25" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "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/@nodelib/fs.scandir": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", + "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "2.0.5", + "run-parallel": "^1.1.9" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.stat": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", + "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.walk": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", + "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.scandir": "2.1.5", + "fastq": "^1.6.0" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@remix-run/router": { + "version": "1.23.1", + "resolved": "https://registry.npmjs.org/@remix-run/router/-/router-1.23.1.tgz", + "integrity": "sha512-vDbaOzF7yT2Qs4vO6XV1MHcJv+3dgR1sT+l3B8xxOVhUC336prMvqrvsLL/9Dnw2xr6Qhz4J0dmS0llNAbnUmQ==", + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@rolldown/pluginutils": { + "version": "1.0.0-beta.27", + "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-beta.27.tgz", + "integrity": "sha512-+d0F4MKMCbeVUJwG96uQ4SgAznZNSq93I3V+9NHA4OpvqG8mRCpGdKmK8l/dl02h2CCDHwW2FqilnTyDcAnqjA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@rollup/plugin-node-resolve": { + "version": "15.3.1", + "resolved": "https://registry.npmjs.org/@rollup/plugin-node-resolve/-/plugin-node-resolve-15.3.1.tgz", + "integrity": "sha512-tgg6b91pAybXHJQMAAwW9VuWBO6Thi+q7BCNARLwSqlmsHz0XYURtGvh/AuwSADXSI4h/2uHbs7s4FzlZDGSGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@rollup/pluginutils": "^5.0.1", + "@types/resolve": "1.20.2", + "deepmerge": "^4.2.2", + "is-module": "^1.0.0", + "resolve": "^1.22.1" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "rollup": "^2.78.0||^3.0.0||^4.0.0" + }, + "peerDependenciesMeta": { + "rollup": { + "optional": true + } + } + }, + "node_modules/@rollup/plugin-terser": { + "version": "0.4.4", + "resolved": "https://registry.npmjs.org/@rollup/plugin-terser/-/plugin-terser-0.4.4.tgz", + "integrity": "sha512-XHeJC5Bgvs8LfukDwWZp7yeqin6ns8RTl2B9avbejt6tZqsqvVoWI7ZTQrcNsfKEDWBTnTxM8nMDkO2IFFbd0A==", + "dev": true, + "license": "MIT", + "dependencies": { + "serialize-javascript": "^6.0.1", + "smob": "^1.0.0", + "terser": "^5.17.4" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "rollup": "^2.0.0||^3.0.0||^4.0.0" + }, + "peerDependenciesMeta": { + "rollup": { + "optional": true + } + } + }, + "node_modules/@rollup/pluginutils": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-5.3.0.tgz", + "integrity": "sha512-5EdhGZtnu3V88ces7s53hhfK5KSASnJZv8Lulpc04cWO3REESroJXg73DFsOmgbU2BhwV0E20bu2IDZb3VKW4Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "estree-walker": "^2.0.2", + "picomatch": "^4.0.2" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0" + }, + "peerDependenciesMeta": { + "rollup": { + "optional": true + } + } + }, + "node_modules/@rollup/pluginutils/node_modules/picomatch": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz", + "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.53.3.tgz", + "integrity": "sha512-mRSi+4cBjrRLoaal2PnqH82Wqyb+d3HsPUN/W+WslCXsZsyHa9ZeQQX/pQsZaVIWDkPcpV6jJ+3KLbTbgnwv8w==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.53.3.tgz", + "integrity": "sha512-CbDGaMpdE9sh7sCmTrTUyllhrg65t6SwhjlMJsLr+J8YjFuPmCEjbBSx4Z/e4SmDyH3aB5hGaJUP2ltV/vcs4w==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.53.3.tgz", + "integrity": "sha512-Nr7SlQeqIBpOV6BHHGZgYBuSdanCXuw09hon14MGOLGmXAFYjx1wNvquVPmpZnl0tLjg25dEdr4IQ6GgyToCUA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.53.3.tgz", + "integrity": "sha512-DZ8N4CSNfl965CmPktJ8oBnfYr3F8dTTNBQkRlffnUarJ2ohudQD17sZBa097J8xhQ26AwhHJ5mvUyQW8ddTsQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.53.3.tgz", + "integrity": "sha512-yMTrCrK92aGyi7GuDNtGn2sNW+Gdb4vErx4t3Gv/Tr+1zRb8ax4z8GWVRfr3Jw8zJWvpGHNpss3vVlbF58DZ4w==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.53.3.tgz", + "integrity": "sha512-lMfF8X7QhdQzseM6XaX0vbno2m3hlyZFhwcndRMw8fbAGUGL3WFMBdK0hbUBIUYcEcMhVLr1SIamDeuLBnXS+Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.53.3.tgz", + "integrity": "sha512-k9oD15soC/Ln6d2Wv/JOFPzZXIAIFLp6B+i14KhxAfnq76ajt0EhYc5YPeX6W1xJkAdItcVT+JhKl1QZh44/qw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.53.3.tgz", + "integrity": "sha512-vTNlKq+N6CK/8UktsrFuc+/7NlEYVxgaEgRXVUVK258Z5ymho29skzW1sutgYjqNnquGwVUObAaxae8rZ6YMhg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.53.3.tgz", + "integrity": "sha512-RGrFLWgMhSxRs/EWJMIFM1O5Mzuz3Xy3/mnxJp/5cVhZ2XoCAxJnmNsEyeMJtpK+wu0FJFWz+QF4mjCA7AUQ3w==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.53.3.tgz", + "integrity": "sha512-kASyvfBEWYPEwe0Qv4nfu6pNkITLTb32p4yTgzFCocHnJLAHs+9LjUu9ONIhvfT/5lv4YS5muBHyuV84epBo/A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.53.3.tgz", + "integrity": "sha512-JiuKcp2teLJwQ7vkJ95EwESWkNRFJD7TQgYmCnrPtlu50b4XvT5MOmurWNrCj3IFdyjBQ5p9vnrX4JM6I8OE7g==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.53.3.tgz", + "integrity": "sha512-EoGSa8nd6d3T7zLuqdojxC20oBfNT8nexBbB/rkxgKj5T5vhpAQKKnD+h3UkoMuTyXkP5jTjK/ccNRmQrPNDuw==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.53.3.tgz", + "integrity": "sha512-4s+Wped2IHXHPnAEbIB0YWBv7SDohqxobiiPA1FIWZpX+w9o2i4LezzH/NkFUl8LRci/8udci6cLq+jJQlh+0g==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.53.3.tgz", + "integrity": "sha512-68k2g7+0vs2u9CxDt5ktXTngsxOQkSEV/xBbwlqYcUrAVh6P9EgMZvFsnHy4SEiUl46Xf0IObWVbMvPrr2gw8A==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.53.3.tgz", + "integrity": "sha512-VYsFMpULAz87ZW6BVYw3I6sWesGpsP9OPcyKe8ofdg9LHxSbRMd7zrVrr5xi/3kMZtpWL/wC+UIJWJYVX5uTKg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.53.3.tgz", + "integrity": "sha512-3EhFi1FU6YL8HTUJZ51imGJWEX//ajQPfqWLI3BQq4TlvHy4X0MOr5q3D2Zof/ka0d5FNdPwZXm3Yyib/UEd+w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.53.3.tgz", + "integrity": "sha512-eoROhjcc6HbZCJr+tvVT8X4fW3/5g/WkGvvmwz/88sDtSJzO7r/blvoBDgISDiCjDRZmHpwud7h+6Q9JxFwq1Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.53.3.tgz", + "integrity": "sha512-OueLAWgrNSPGAdUdIjSWXw+u/02BRTcnfw9PN41D2vq/JSEPnJnVuBgw18VkN8wcd4fjUs+jFHVM4t9+kBSNLw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.53.3.tgz", + "integrity": "sha512-GOFuKpsxR/whszbF/bzydebLiXIHSgsEUp6M0JI8dWvi+fFa1TD6YQa4aSZHtpmh2/uAlj/Dy+nmby3TJ3pkTw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.53.3.tgz", + "integrity": "sha512-iah+THLcBJdpfZ1TstDFbKNznlzoxa8fmnFYK4V67HvmuNYkVdAywJSoteUszvBQ9/HqN2+9AZghbajMsFT+oA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.53.3.tgz", + "integrity": "sha512-J9QDiOIZlZLdcot5NXEepDkstocktoVjkaKUtqzgzpt2yWjGlbYiKyp05rWwk4nypbYUNoFAztEgixoLaSETkg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.53.3.tgz", + "integrity": "sha512-UhTd8u31dXadv0MopwGgNOBpUVROFKWVQgAg5N1ESyCz8AuBcMqm4AuTjrwgQKGDfoFuz02EuMRHQIw/frmYKQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@surma/rollup-plugin-off-main-thread": { + "version": "2.2.3", + "resolved": "https://registry.npmjs.org/@surma/rollup-plugin-off-main-thread/-/rollup-plugin-off-main-thread-2.2.3.tgz", + "integrity": "sha512-lR8q/9W7hZpMWweNiAKU7NQerBnzQQLvi8qnTDU/fxItPhtZVMbPV3lbCwjhIlNBe9Bbr5V+KHshvWmVSG9cxQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "ejs": "^3.1.6", + "json5": "^2.2.0", + "magic-string": "^0.25.0", + "string.prototype.matchall": "^4.0.6" + } + }, + "node_modules/@tanstack/query-core": { + "version": "5.90.12", + "resolved": "https://registry.npmjs.org/@tanstack/query-core/-/query-core-5.90.12.tgz", + "integrity": "sha512-T1/8t5DhV/SisWjDnaiU2drl6ySvsHj1bHBCWNXd+/T+Hh1cf6JodyEYMd5sgwm+b/mETT4EV3H+zCVczCU5hg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/tannerlinsley" + } + }, + "node_modules/@tanstack/react-query": { + "version": "5.90.12", + "resolved": "https://registry.npmjs.org/@tanstack/react-query/-/react-query-5.90.12.tgz", + "integrity": "sha512-graRZspg7EoEaw0a8faiUASCyJrqjKPdqJ9EwuDRUF9mEYJ1YPczI9H+/agJ0mOJkPCJDk0lsz5QTrLZ/jQ2rg==", + "license": "MIT", + "dependencies": { + "@tanstack/query-core": "5.90.12" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/tannerlinsley" + }, + "peerDependencies": { + "react": "^18 || ^19" + } + }, + "node_modules/@types/babel__core": { + "version": "7.20.5", + "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz", + "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.20.7", + "@babel/types": "^7.20.7", + "@types/babel__generator": "*", + "@types/babel__template": "*", + "@types/babel__traverse": "*" + } + }, + "node_modules/@types/babel__generator": { + "version": "7.27.0", + "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz", + "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__template": { + "version": "7.4.4", + "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz", + "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.1.0", + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__traverse": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz", + "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.28.2" + } + }, + "node_modules/@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/prop-types": { + "version": "15.7.15", + "resolved": "https://registry.npmjs.org/@types/prop-types/-/prop-types-15.7.15.tgz", + "integrity": "sha512-F6bEyamV9jKGAFBEmlQnesRPGOQqS2+Uwi0Em15xenOxHaf2hv6L8YCVn3rPdPJOiJfPiCnLIRyvwVaqMY3MIw==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/@types/react": { + "version": "18.3.27", + "resolved": "https://registry.npmjs.org/@types/react/-/react-18.3.27.tgz", + "integrity": "sha512-cisd7gxkzjBKU2GgdYrTdtQx1SORymWyaAFhaxQPK9bYO9ot3Y5OikQRvY0VYQtvwjeQnizCINJAenh/V7MK2w==", + "devOptional": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@types/prop-types": "*", + "csstype": "^3.2.2" + } + }, + "node_modules/@types/react-dom": { + "version": "18.3.7", + "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-18.3.7.tgz", + "integrity": "sha512-MEe3UeoENYVFXzoXEWsvcpg6ZvlrFNlOQ7EOsvhI3CfAXwzPfO8Qwuxd40nepsYKqyyVQnTdEfv68q91yLcKrQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "@types/react": "^18.0.0" + } + }, + "node_modules/@types/resolve": { + "version": "1.20.2", + "resolved": "https://registry.npmjs.org/@types/resolve/-/resolve-1.20.2.tgz", + "integrity": "sha512-60BCwRFOZCQhDncwQdxxeOEEkbc5dIMccYLwbxsS4TUNeVECQ/pBJ0j09mrHOl/JJvpRPGwO9SvE4nR2Nb/a4Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/semver": { + "version": "7.7.1", + "resolved": "https://registry.npmjs.org/@types/semver/-/semver-7.7.1.tgz", + "integrity": "sha512-FmgJfu+MOcQ370SD0ev7EI8TlCAfKYU+B4m5T3yXc1CiRN94g/SZPtsCkk506aUDtlMnFZvasDwHHUcZUEaYuA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/trusted-types": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz", + "integrity": "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@typescript-eslint/eslint-plugin": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-6.21.0.tgz", + "integrity": "sha512-oy9+hTPCUFpngkEZUSzbf9MxI65wbKFoQYsgPdILTfbUldp5ovUuphZVe4i30emU9M/kP+T64Di0mxl7dSw3MA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/regexpp": "^4.5.1", + "@typescript-eslint/scope-manager": "6.21.0", + "@typescript-eslint/type-utils": "6.21.0", + "@typescript-eslint/utils": "6.21.0", + "@typescript-eslint/visitor-keys": "6.21.0", + "debug": "^4.3.4", + "graphemer": "^1.4.0", + "ignore": "^5.2.4", + "natural-compare": "^1.4.0", + "semver": "^7.5.4", + "ts-api-utils": "^1.0.1" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "@typescript-eslint/parser": "^6.0.0 || ^6.0.0-alpha", + "eslint": "^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/parser": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-6.21.0.tgz", + "integrity": "sha512-tbsV1jPne5CkFQCgPBcDOt30ItF7aJoZL997JSF7MhGQqOeT3svWRYxiqlfA5RUdlHN6Fi+EI9bxqbdyAUZjYQ==", + "dev": true, + "license": "BSD-2-Clause", + "peer": true, + "dependencies": { + "@typescript-eslint/scope-manager": "6.21.0", + "@typescript-eslint/types": "6.21.0", + "@typescript-eslint/typescript-estree": "6.21.0", + "@typescript-eslint/visitor-keys": "6.21.0", + "debug": "^4.3.4" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/scope-manager": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-6.21.0.tgz", + "integrity": "sha512-OwLUIWZJry80O99zvqXVEioyniJMa+d2GrqpUTqi5/v5D5rOrppJVBPa0yKCblcigC0/aYAzxxqQ1B+DS2RYsg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "6.21.0", + "@typescript-eslint/visitor-keys": "6.21.0" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/type-utils": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-6.21.0.tgz", + "integrity": "sha512-rZQI7wHfao8qMX3Rd3xqeYSMCL3SoiSQLBATSiVKARdFGCYSRvmViieZjqc58jKgs8Y8i9YvVVhRbHSTA4VBag==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/typescript-estree": "6.21.0", + "@typescript-eslint/utils": "6.21.0", + "debug": "^4.3.4", + "ts-api-utils": "^1.0.1" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/types": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-6.21.0.tgz", + "integrity": "sha512-1kFmZ1rOm5epu9NZEZm1kckCDGj5UJEf7P1kliH4LKu/RkwpsfqqGmY2OOcUs18lSlQBKLDYBOGxRVtrMN5lpg==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/typescript-estree": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-6.21.0.tgz", + "integrity": "sha512-6npJTkZcO+y2/kr+z0hc4HwNfrrP4kNYh57ek7yCNlrBjWQ1Y0OS7jiZTkgumrvkX5HkEKXFZkkdFNkaW2wmUQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "@typescript-eslint/types": "6.21.0", + "@typescript-eslint/visitor-keys": "6.21.0", + "debug": "^4.3.4", + "globby": "^11.1.0", + "is-glob": "^4.0.3", + "minimatch": "9.0.3", + "semver": "^7.5.4", + "ts-api-utils": "^1.0.1" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/utils": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-6.21.0.tgz", + "integrity": "sha512-NfWVaC8HP9T8cbKQxHcsJBY5YE1O33+jpMwN45qzWWaPDZgLIbo12toGMWnmhvCpd3sIxkpDw3Wv1B3dYrbDQQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.4.0", + "@types/json-schema": "^7.0.12", + "@types/semver": "^7.5.0", + "@typescript-eslint/scope-manager": "6.21.0", + "@typescript-eslint/types": "6.21.0", + "@typescript-eslint/typescript-estree": "6.21.0", + "semver": "^7.5.4" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^7.0.0 || ^8.0.0" + } + }, + "node_modules/@typescript-eslint/visitor-keys": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-6.21.0.tgz", + "integrity": "sha512-JJtkDduxLi9bivAB+cYOVMtbkqdPOhZ+ZI5LC47MIRrDV4Yn2o+ZnW10Nkmr28xRpSpdJ6Sm42Hjf2+REYXm0A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "6.21.0", + "eslint-visitor-keys": "^3.4.1" + }, + "engines": { + "node": "^16.0.0 || >=18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@ungap/structured-clone": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.0.tgz", + "integrity": "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==", + "dev": true, + "license": "ISC" + }, + "node_modules/@vitejs/plugin-react": { + "version": "4.7.0", + "resolved": "https://registry.npmjs.org/@vitejs/plugin-react/-/plugin-react-4.7.0.tgz", + "integrity": "sha512-gUu9hwfWvvEDBBmgtAowQCojwZmJ5mcLn3aufeCsitijs3+f2NsrPtlAWIR6OPiqljl96GVCUbLe0HyqIpVaoA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/core": "^7.28.0", + "@babel/plugin-transform-react-jsx-self": "^7.27.1", + "@babel/plugin-transform-react-jsx-source": "^7.27.1", + "@rolldown/pluginutils": "1.0.0-beta.27", + "@types/babel__core": "^7.20.5", + "react-refresh": "^0.17.0" + }, + "engines": { + "node": "^14.18.0 || >=16.0.0" + }, + "peerDependencies": { + "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0" + } + }, + "node_modules/acorn": { + "version": "8.15.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", + "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", + "dev": true, + "license": "MIT", + "peer": true, + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/ajv": { + "version": "6.12.6", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", + "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "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/any-promise": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/any-promise/-/any-promise-1.3.0.tgz", + "integrity": "sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==", + "dev": true, + "license": "MIT" + }, + "node_modules/anymatch": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", + "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", + "dev": true, + "license": "ISC", + "dependencies": { + "normalize-path": "^3.0.0", + "picomatch": "^2.0.4" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/arg": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz", + "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==", + "dev": true, + "license": "MIT" + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" + }, + "node_modules/array-buffer-byte-length": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/array-buffer-byte-length/-/array-buffer-byte-length-1.0.2.tgz", + "integrity": "sha512-LHE+8BuR7RYGDKvnrmcuSq3tDcKv9OFEXQt/HpbZhY7V6h0zlUXutnAD82GiFx9rdieCMjkvtcsPqBwgUl1Iiw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "is-array-buffer": "^3.0.5" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array-union": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz", + "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/arraybuffer.prototype.slice": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.4.tgz", + "integrity": "sha512-BNoCY6SXXPQ7gF2opIP4GBE+Xw7U+pHMYKuzjgCN3GwiaIR09UUeKfheyIry77QtrCBlC0KK0q5/TER/tYh3PQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-buffer-byte-length": "^1.0.1", + "call-bind": "^1.0.8", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.5", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.6", + "is-array-buffer": "^3.0.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/async": { + "version": "3.2.6", + "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", + "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", + "dev": true, + "license": "MIT" + }, + "node_modules/async-function": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz", + "integrity": "sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/asynckit": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", + "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", + "license": "MIT" + }, + "node_modules/at-least-node": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/at-least-node/-/at-least-node-1.0.0.tgz", + "integrity": "sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">= 4.0.0" + } + }, + "node_modules/autoprefixer": { + "version": "10.4.22", + "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.22.tgz", + "integrity": "sha512-ARe0v/t9gO28Bznv6GgqARmVqcWOV3mfgUPn9becPHMiD3o9BwlRgaeccZnwTpZ7Zwqrm+c1sUSsMxIzQzc8Xg==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/autoprefixer" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "browserslist": "^4.27.0", + "caniuse-lite": "^1.0.30001754", + "fraction.js": "^5.3.4", + "normalize-range": "^0.1.2", + "picocolors": "^1.1.1", + "postcss-value-parser": "^4.2.0" + }, + "bin": { + "autoprefixer": "bin/autoprefixer" + }, + "engines": { + "node": "^10 || ^12 || >=14" + }, + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/available-typed-arrays": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/available-typed-arrays/-/available-typed-arrays-1.0.7.tgz", + "integrity": "sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "possible-typed-array-names": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/axios": { + "version": "1.13.2", + "resolved": "https://registry.npmjs.org/axios/-/axios-1.13.2.tgz", + "integrity": "sha512-VPk9ebNqPcy5lRGuSlKx752IlDatOjT9paPlm8A7yOuW2Fbvp4X3JznJtT4f0GzGLLiWE9W8onz51SqLYwzGaA==", + "license": "MIT", + "dependencies": { + "follow-redirects": "^1.15.6", + "form-data": "^4.0.4", + "proxy-from-env": "^1.1.0" + } + }, + "node_modules/babel-plugin-polyfill-corejs2": { + "version": "0.4.14", + "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs2/-/babel-plugin-polyfill-corejs2-0.4.14.tgz", + "integrity": "sha512-Co2Y9wX854ts6U8gAAPXfn0GmAyctHuK8n0Yhfjd6t30g7yvKjspvvOo9yG+z52PZRgFErt7Ka2pYnXCjLKEpg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.27.7", + "@babel/helper-define-polyfill-provider": "^0.6.5", + "semver": "^6.3.1" + }, + "peerDependencies": { + "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0" + } + }, + "node_modules/babel-plugin-polyfill-corejs2/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/babel-plugin-polyfill-corejs3": { + "version": "0.13.0", + "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.13.0.tgz", + "integrity": "sha512-U+GNwMdSFgzVmfhNm8GJUX88AadB3uo9KpJqS3FaqNIPKgySuvMb+bHPsOmmuWyIcuqZj/pzt1RUIUZns4y2+A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-define-polyfill-provider": "^0.6.5", + "core-js-compat": "^3.43.0" + }, + "peerDependencies": { + "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0" + } + }, + "node_modules/babel-plugin-polyfill-regenerator": { + "version": "0.6.5", + "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-regenerator/-/babel-plugin-polyfill-regenerator-0.6.5.tgz", + "integrity": "sha512-ISqQ2frbiNU9vIJkzg7dlPpznPZ4jOiUQ1uSmB0fEHeowtN3COYRsXr/xexn64NpU13P06jc/L5TgiJXOgrbEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-define-polyfill-provider": "^0.6.5" + }, + "peerDependencies": { + "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0" + } + }, + "node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/baseline-browser-mapping": { + "version": "2.9.5", + "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.9.5.tgz", + "integrity": "sha512-D5vIoztZOq1XM54LUdttJVc96ggEsIfju2JBvht06pSzpckp3C7HReun67Bghzrtdsq9XdMGbSSB3v3GhMNmAA==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "baseline-browser-mapping": "dist/cli.js" + } + }, + "node_modules/binary-extensions": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz", + "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/brace-expansion": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz", + "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0" + } + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/browserslist": { + "version": "4.28.1", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.1.tgz", + "integrity": "sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "peer": true, + "dependencies": { + "baseline-browser-mapping": "^2.9.0", + "caniuse-lite": "^1.0.30001759", + "electron-to-chromium": "^1.5.263", + "node-releases": "^2.0.27", + "update-browserslist-db": "^1.2.0" + }, + "bin": { + "browserslist": "cli.js" + }, + "engines": { + "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" + } + }, + "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/call-bind": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.8.tgz", + "integrity": "sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.0", + "es-define-property": "^1.0.0", + "get-intrinsic": "^1.2.4", + "set-function-length": "^1.2.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "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==", + "dev": true, + "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/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/camelcase-css": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/camelcase-css/-/camelcase-css-2.0.1.tgz", + "integrity": "sha512-QOSvevhslijgYwRx6Rv7zKdMF8lbRmx+uQGx2+vDc+KI/eBnsy9kit5aj23AgGu3pa4t9AgwbnXWqS+iOY+2aA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, + "node_modules/caniuse-lite": { + "version": "1.0.30001759", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001759.tgz", + "integrity": "sha512-Pzfx9fOKoKvevQf8oCXoyNRQ5QyxJj+3O0Rqx2V5oxT61KGx8+n6hV/IUyJeifUci2clnmmKVpvtiqRzgiWjSw==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/caniuse-lite" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "CC-BY-4.0" + }, + "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/chokidar": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz", + "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "anymatch": "~3.1.2", + "braces": "~3.0.2", + "glob-parent": "~5.1.2", + "is-binary-path": "~2.1.0", + "is-glob": "~4.0.1", + "normalize-path": "~3.0.0", + "readdirp": "~3.6.0" + }, + "engines": { + "node": ">= 8.10.0" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + }, + "optionalDependencies": { + "fsevents": "~2.3.2" + } + }, + "node_modules/chokidar/node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/clsx": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz", + "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "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==", + "license": "MIT", + "dependencies": { + "delayed-stream": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "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/common-tags": { + "version": "1.8.2", + "resolved": "https://registry.npmjs.org/common-tags/-/common-tags-1.8.2.tgz", + "integrity": "sha512-gk/Z852D2Wtb//0I+kRFNKKE9dIIVirjoqPoA1wJU+XePVXZfGeBpk45+A1rKO4Q43prqWBNY/MiIeRLbPWUaA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", + "dev": true, + "license": "MIT" + }, + "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/core-js-compat": { + "version": "3.47.0", + "resolved": "https://registry.npmjs.org/core-js-compat/-/core-js-compat-3.47.0.tgz", + "integrity": "sha512-IGfuznZ/n7Kp9+nypamBhvwdwLsW6KC8IOaURw2doAK5e98AG3acVLdh0woOnEqCfUtS+Vu882JE4k/DAm3ItQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "browserslist": "^4.28.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/core-js" + } + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/crypto-random-string": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/crypto-random-string/-/crypto-random-string-2.0.0.tgz", + "integrity": "sha512-v1plID3y9r/lPhviJ1wrXpLeyUIGAZ2SHNYTEapm7/8A9nLPoyvVp3RK/EPFqn5kEznyWgYZNsRtYYIWbuG8KA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/cssesc": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz", + "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==", + "dev": true, + "license": "MIT", + "bin": { + "cssesc": "bin/cssesc" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/csstype": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/data-view-buffer": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/data-view-buffer/-/data-view-buffer-1.0.2.tgz", + "integrity": "sha512-EmKO5V3OLXh1rtK2wgXRansaK1/mtVdTUEiEI0W8RkvgT05kfxaH29PliLnpLP73yYO6142Q72QNa8Wx/A5CqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "es-errors": "^1.3.0", + "is-data-view": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/data-view-byte-length": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/data-view-byte-length/-/data-view-byte-length-1.0.2.tgz", + "integrity": "sha512-tuhGbE6CfTM9+5ANGf+oQb72Ky/0+s3xKUpHvShfiz2RxMFgFPjsXuRLBVMtvMs15awe45SRb83D6wH4ew6wlQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "es-errors": "^1.3.0", + "is-data-view": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/inspect-js" + } + }, + "node_modules/data-view-byte-offset": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/data-view-byte-offset/-/data-view-byte-offset-1.0.1.tgz", + "integrity": "sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "is-data-view": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/deepmerge": { + "version": "4.3.1", + "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz", + "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/define-data-property": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz", + "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-define-property": "^1.0.0", + "es-errors": "^1.3.0", + "gopd": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/define-properties": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz", + "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-data-property": "^1.0.1", + "has-property-descriptors": "^1.0.0", + "object-keys": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/delayed-stream": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", + "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", + "license": "MIT", + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/didyoumean": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/didyoumean/-/didyoumean-1.2.2.tgz", + "integrity": "sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/dir-glob": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz", + "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-type": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/dlv": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz", + "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA==", + "dev": true, + "license": "MIT" + }, + "node_modules/doctrine": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-3.0.0.tgz", + "integrity": "sha512-yS+Q5i3hBf7GBkd4KG8a7eBNNWNGLTaEwwYWUijIYM7zrlYDM0BFXHjjPWlWZ1Rg7UaddZeIDmi9jF3HmqiQ2w==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "esutils": "^2.0.2" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "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/eastasianwidth": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz", + "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==", + "dev": true, + "license": "MIT" + }, + "node_modules/ejs": { + "version": "3.1.10", + "resolved": "https://registry.npmjs.org/ejs/-/ejs-3.1.10.tgz", + "integrity": "sha512-UeJmFfOrAQS8OJWPZ4qtgHyWExa088/MtK5UEyoJGFH67cDEXkZSviOiKRCZ4Xij0zxI3JECgYs3oKx+AizQBA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "jake": "^10.8.5" + }, + "bin": { + "ejs": "bin/cli.js" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/electron-to-chromium": { + "version": "1.5.267", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.267.tgz", + "integrity": "sha512-0Drusm6MVRXSOJpGbaSVgcQsuB4hEkMpHXaVstcPmhu5LIedxs1xNK/nIxmQIU/RPC0+1/o0AVZfBTkTNJOdUw==", + "dev": true, + "license": "ISC" + }, + "node_modules/emoji-regex": { + "version": "9.2.2", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", + "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==", + "dev": true, + "license": "MIT" + }, + "node_modules/es-abstract": { + "version": "1.24.0", + "resolved": "https://registry.npmjs.org/es-abstract/-/es-abstract-1.24.0.tgz", + "integrity": "sha512-WSzPgsdLtTcQwm4CROfS5ju2Wa1QQcVeT37jFjYzdFz1r9ahadC8B8/a4qxJxM+09F18iumCdRmlr96ZYkQvEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-buffer-byte-length": "^1.0.2", + "arraybuffer.prototype.slice": "^1.0.4", + "available-typed-arrays": "^1.0.7", + "call-bind": "^1.0.8", + "call-bound": "^1.0.4", + "data-view-buffer": "^1.0.2", + "data-view-byte-length": "^1.0.2", + "data-view-byte-offset": "^1.0.1", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "es-set-tostringtag": "^2.1.0", + "es-to-primitive": "^1.3.0", + "function.prototype.name": "^1.1.8", + "get-intrinsic": "^1.3.0", + "get-proto": "^1.0.1", + "get-symbol-description": "^1.1.0", + "globalthis": "^1.0.4", + "gopd": "^1.2.0", + "has-property-descriptors": "^1.0.2", + "has-proto": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "internal-slot": "^1.1.0", + "is-array-buffer": "^3.0.5", + "is-callable": "^1.2.7", + "is-data-view": "^1.0.2", + "is-negative-zero": "^2.0.3", + "is-regex": "^1.2.1", + "is-set": "^2.0.3", + "is-shared-array-buffer": "^1.0.4", + "is-string": "^1.1.1", + "is-typed-array": "^1.1.15", + "is-weakref": "^1.1.1", + "math-intrinsics": "^1.1.0", + "object-inspect": "^1.13.4", + "object-keys": "^1.1.1", + "object.assign": "^4.1.7", + "own-keys": "^1.0.1", + "regexp.prototype.flags": "^1.5.4", + "safe-array-concat": "^1.1.3", + "safe-push-apply": "^1.0.0", + "safe-regex-test": "^1.1.0", + "set-proto": "^1.0.0", + "stop-iteration-iterator": "^1.1.0", + "string.prototype.trim": "^1.2.10", + "string.prototype.trimend": "^1.0.9", + "string.prototype.trimstart": "^1.0.8", + "typed-array-buffer": "^1.0.3", + "typed-array-byte-length": "^1.0.3", + "typed-array-byte-offset": "^1.0.4", + "typed-array-length": "^1.0.7", + "unbox-primitive": "^1.1.0", + "which-typed-array": "^1.1.19" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", + "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/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==", + "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-to-primitive": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-to-primitive/-/es-to-primitive-1.3.0.tgz", + "integrity": "sha512-w+5mJ3GuFL+NjVtJlvydShqE1eN3h3PbI7/5LAsYJP/2qtuMXjfL2LpHSRqo4b4eSF5K/DH1JXKUAHSB2UW50g==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-callable": "^1.2.7", + "is-date-object": "^1.0.5", + "is-symbol": "^1.0.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/esbuild": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz", + "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=12" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.21.5", + "@esbuild/android-arm": "0.21.5", + "@esbuild/android-arm64": "0.21.5", + "@esbuild/android-x64": "0.21.5", + "@esbuild/darwin-arm64": "0.21.5", + "@esbuild/darwin-x64": "0.21.5", + "@esbuild/freebsd-arm64": "0.21.5", + "@esbuild/freebsd-x64": "0.21.5", + "@esbuild/linux-arm": "0.21.5", + "@esbuild/linux-arm64": "0.21.5", + "@esbuild/linux-ia32": "0.21.5", + "@esbuild/linux-loong64": "0.21.5", + "@esbuild/linux-mips64el": "0.21.5", + "@esbuild/linux-ppc64": "0.21.5", + "@esbuild/linux-riscv64": "0.21.5", + "@esbuild/linux-s390x": "0.21.5", + "@esbuild/linux-x64": "0.21.5", + "@esbuild/netbsd-x64": "0.21.5", + "@esbuild/openbsd-x64": "0.21.5", + "@esbuild/sunos-x64": "0.21.5", + "@esbuild/win32-arm64": "0.21.5", + "@esbuild/win32-ia32": "0.21.5", + "@esbuild/win32-x64": "0.21.5" + } + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint": { + "version": "8.57.1", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.57.1.tgz", + "integrity": "sha512-ypowyDxpVSYpkXr9WPv2PAZCtNip1Mv5KTW0SCurXv/9iOpcrH9PaqUElksqEB6pChqHGDRCFTyrZlGhnLNGiA==", + "deprecated": "This version is no longer supported. Please see https://eslint.org/version-support for other options.", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@eslint-community/eslint-utils": "^4.2.0", + "@eslint-community/regexpp": "^4.6.1", + "@eslint/eslintrc": "^2.1.4", + "@eslint/js": "8.57.1", + "@humanwhocodes/config-array": "^0.13.0", + "@humanwhocodes/module-importer": "^1.0.1", + "@nodelib/fs.walk": "^1.2.8", + "@ungap/structured-clone": "^1.2.0", + "ajv": "^6.12.4", + "chalk": "^4.0.0", + "cross-spawn": "^7.0.2", + "debug": "^4.3.2", + "doctrine": "^3.0.0", + "escape-string-regexp": "^4.0.0", + "eslint-scope": "^7.2.2", + "eslint-visitor-keys": "^3.4.3", + "espree": "^9.6.1", + "esquery": "^1.4.2", + "esutils": "^2.0.2", + "fast-deep-equal": "^3.1.3", + "file-entry-cache": "^6.0.1", + "find-up": "^5.0.0", + "glob-parent": "^6.0.2", + "globals": "^13.19.0", + "graphemer": "^1.4.0", + "ignore": "^5.2.0", + "imurmurhash": "^0.1.4", + "is-glob": "^4.0.0", + "is-path-inside": "^3.0.3", + "js-yaml": "^4.1.0", + "json-stable-stringify-without-jsonify": "^1.0.1", + "levn": "^0.4.1", + "lodash.merge": "^4.6.2", + "minimatch": "^3.1.2", + "natural-compare": "^1.4.0", + "optionator": "^0.9.3", + "strip-ansi": "^6.0.1", + "text-table": "^0.2.0" + }, + "bin": { + "eslint": "bin/eslint.js" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-plugin-react-hooks": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/eslint-plugin-react-hooks/-/eslint-plugin-react-hooks-4.6.2.tgz", + "integrity": "sha512-QzliNJq4GinDBcD8gPB5v0wh6g8q3SUi6EFF0x8N/BL9PoVs0atuGc47ozMRyOWAKdwaZ5OnbOEa3WR+dSGKuQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "peerDependencies": { + "eslint": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0" + } + }, + "node_modules/eslint-plugin-react-refresh": { + "version": "0.4.24", + "resolved": "https://registry.npmjs.org/eslint-plugin-react-refresh/-/eslint-plugin-react-refresh-0.4.24.tgz", + "integrity": "sha512-nLHIW7TEq3aLrEYWpVaJ1dRgFR+wLDPN8e8FpYAql/bMV2oBEfC37K0gLEGgv9fy66juNShSMV8OkTqzltcG/w==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "eslint": ">=8.40" + } + }, + "node_modules/eslint-scope": { + "version": "7.2.2", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-7.2.2.tgz", + "integrity": "sha512-dOt21O7lTMhDM+X9mB4GX+DZrZtCUJPL/wlcTqxyrx5IvO0IYtILdtrQGQp+8n5S0gwSVmOf9NQrjMOgfQZlIg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^5.2.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/eslint/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/espree": { + "version": "9.6.1", + "resolved": "https://registry.npmjs.org/espree/-/espree-9.6.1.tgz", + "integrity": "sha512-oruZaFkjorTpF32kDSI5/75ViwGeZginGGy2NoOSg3Q9bnwlnmDm4HLnkl0RE3n+njDXR037aY1+x58Z/zFdwQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.9.0", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^3.4.1" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/esquery": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", + "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "estraverse": "^5.1.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "estraverse": "^5.2.0" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "dev": true, + "license": "MIT" + }, + "node_modules/esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-glob": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz", + "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "^2.0.2", + "@nodelib/fs.walk": "^1.2.3", + "glob-parent": "^5.1.2", + "merge2": "^1.3.0", + "micromatch": "^4.0.8" + }, + "engines": { + "node": ">=8.6.0" + } + }, + "node_modules/fast-glob/node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/fast-json-stable-stringify": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", + "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-uri": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.0.tgz", + "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/fastq": { + "version": "1.19.1", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz", + "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "reusify": "^1.0.4" + } + }, + "node_modules/file-entry-cache": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-6.0.1.tgz", + "integrity": "sha512-7Gps/XWymbLk2QLYK4NzpMOrYjMhdIxXuIvy2QBsLE6ljuodKvdkWs/cpyJJ3CVIVpH0Oi1Hvg1ovbMzLdFBBg==", + "dev": true, + "license": "MIT", + "dependencies": { + "flat-cache": "^3.0.4" + }, + "engines": { + "node": "^10.12.0 || >=12.0.0" + } + }, + "node_modules/filelist": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/filelist/-/filelist-1.0.4.tgz", + "integrity": "sha512-w1cEuf3S+DrLCQL7ET6kz+gmlJdbq9J7yXCSjK/OZCPA+qEN1WyF4ZAf0YYJa4/shHJra2t/d/r8SV4Ji+x+8Q==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "minimatch": "^5.0.1" + } + }, + "node_modules/filelist/node_modules/minimatch": { + "version": "5.1.6", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.6.tgz", + "integrity": "sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.1" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^6.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/flat-cache": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-3.2.0.tgz", + "integrity": "sha512-CYcENa+FtcUKLmhhqyctpclsq7QF38pKjZHsGNiSQF5r4FtoKDWabFDl3hzaEQMvT1LHEysw5twgLvpYYb4vbw==", + "dev": true, + "license": "MIT", + "dependencies": { + "flatted": "^3.2.9", + "keyv": "^4.5.3", + "rimraf": "^3.0.2" + }, + "engines": { + "node": "^10.12.0 || >=12.0.0" + } + }, + "node_modules/flatted": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz", + "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==", + "dev": true, + "license": "ISC" + }, + "node_modules/follow-redirects": { + "version": "1.15.11", + "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.11.tgz", + "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==", + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/RubenVerborgh" + } + ], + "license": "MIT", + "engines": { + "node": ">=4.0" + }, + "peerDependenciesMeta": { + "debug": { + "optional": true + } + } + }, + "node_modules/for-each": { + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/for-each/-/for-each-0.3.5.tgz", + "integrity": "sha512-dKx12eRCVIzqCxFGplyFKJMPvLEWgmNtUrpTiJIR5u97zEhRG8ySrtboPHZXx7daLxQVrl643cTzbab2tkQjxg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-callable": "^1.2.7" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/foreground-child": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz", + "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==", + "dev": true, + "license": "ISC", + "dependencies": { + "cross-spawn": "^7.0.6", + "signal-exit": "^4.0.1" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/form-data": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz", + "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==", + "license": "MIT", + "dependencies": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.8", + "es-set-tostringtag": "^2.1.0", + "hasown": "^2.0.2", + "mime-types": "^2.1.12" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/fraction.js": { + "version": "5.3.4", + "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-5.3.4.tgz", + "integrity": "sha512-1X1NTtiJphryn/uLQz3whtY6jK3fTqoE3ohKs0tT+Ujr1W59oopxmoEh7Lu5p6vBaPbgoM0bzveAW4Qi5RyWDQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": "*" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/rawify" + } + }, + "node_modules/fs-extra": { + "version": "9.1.0", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-9.1.0.tgz", + "integrity": "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "at-least-node": "^1.0.0", + "graceful-fs": "^4.2.0", + "jsonfile": "^6.0.1", + "universalify": "^2.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/fs.realpath": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", + "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", + "dev": true, + "license": "ISC" + }, + "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/function.prototype.name": { + "version": "1.1.8", + "resolved": "https://registry.npmjs.org/function.prototype.name/-/function.prototype.name-1.1.8.tgz", + "integrity": "sha512-e5iwyodOHhbMr/yNrc7fDYG4qlbIvI5gajyzPnb5TCwyhjApznQh1BMFou9b30SevY43gCJKXycoCBjMbsuW0Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.3", + "define-properties": "^1.2.1", + "functions-have-names": "^1.2.3", + "hasown": "^2.0.2", + "is-callable": "^1.2.7" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/functions-have-names": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/functions-have-names/-/functions-have-names-1.2.3.tgz", + "integrity": "sha512-xckBUXyTIqT97tq2x2AMb+g163b5JFysYk0x4qxNFwbfQkmNZoiRHb6sPzI9/QV33WeuvVYBUIiD4NzNIyqaRQ==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/generator-function": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/generator-function/-/generator-function-2.0.1.tgz", + "integrity": "sha512-SFdFmIJi+ybC0vjlHN0ZGVGHc3lgE0DxPAT0djjVg+kjOnSqclqmj0KQ7ykTOLP6YxoqOvuAODGdcHJn+43q3g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/gensync": { + "version": "1.0.0-beta.2", + "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz", + "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "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-own-enumerable-property-symbols": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/get-own-enumerable-property-symbols/-/get-own-enumerable-property-symbols-3.0.2.tgz", + "integrity": "sha512-I0UBV/XOz1XkIJHEUDMZAbzCThU/H8DxmSfmdGcKPnVhu2VfFqr34jr9777IyaTYvxjedWhqVIilEDsCdP5G6g==", + "dev": true, + "license": "ISC" + }, + "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/get-symbol-description": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/get-symbol-description/-/get-symbol-description-1.1.0.tgz", + "integrity": "sha512-w9UMqWwJxHNOvoNzSJ2oPF5wvYcvP7jUvYzhp67yEhTi17ZDBBC1z9pTdGuzjD+EFIqLSYRweZjqfiPzQ06Ebg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.6" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/glob": { + "version": "7.2.3", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", + "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "deprecated": "Glob versions prior to v9 are no longer supported", + "dev": true, + "license": "ISC", + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/glob/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/glob/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/globals": { + "version": "13.24.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-13.24.0.tgz", + "integrity": "sha512-AhO5QUcj8llrbG09iWhPU2B204J1xnPeL8kQmVorSsy+Sjj1sk8gIyh6cUocGmH4L0UuhAJy+hJMRA4mgA4mFQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "type-fest": "^0.20.2" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/globalthis": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz", + "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-properties": "^1.2.1", + "gopd": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/globby": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/globby/-/globby-11.1.0.tgz", + "integrity": "sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-union": "^2.1.0", + "dir-glob": "^3.0.1", + "fast-glob": "^3.2.9", + "ignore": "^5.2.0", + "merge2": "^1.4.1", + "slash": "^3.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "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/graceful-fs": { + "version": "4.2.11", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", + "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/graphemer": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz", + "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==", + "dev": true, + "license": "MIT" + }, + "node_modules/has-bigints": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-bigints/-/has-bigints-1.1.0.tgz", + "integrity": "sha512-R3pbpkcIqv2Pm3dUwgjclDRVmWpTJW2DcMzcIhEXEx1oh/CEMObMm3KLmRJOdvhM7o4uQBnwr8pzRK2sJWIqfg==", + "dev": true, + "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-property-descriptors": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz", + "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-define-property": "^1.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-proto": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.2.0.tgz", + "integrity": "sha512-KIL7eQPfHQRC8+XluaIw7BHUwwqL19bQn4hzNgdr+1wXoU0KKj6rufu47lhY7KbJR2C6T6+PfyN0Ea7wkSS+qQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "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==", + "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.2", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", + "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/idb": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/idb/-/idb-7.1.1.tgz", + "integrity": "sha512-gchesWBzyvGHRO9W8tzUWFDycow5gwjvFKfyV9FF32Y7F50yZMp7mP+T2mJIWFx49zicqyC4uefHM17o6xKIVQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.19" + } + }, + "node_modules/inflight": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", + "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", + "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.", + "dev": true, + "license": "ISC", + "dependencies": { + "once": "^1.3.0", + "wrappy": "1" + } + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/internal-slot": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.1.0.tgz", + "integrity": "sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "hasown": "^2.0.2", + "side-channel": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/is-array-buffer": { + "version": "3.0.5", + "resolved": "https://registry.npmjs.org/is-array-buffer/-/is-array-buffer-3.0.5.tgz", + "integrity": "sha512-DDfANUiiG2wC1qawP66qlTugJeL5HyzMpfr8lLK+jMQirGzNod0B12cFB/9q838Ru27sBwfw78/rdoU7RERz6A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.3", + "get-intrinsic": "^1.2.6" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-async-function": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-async-function/-/is-async-function-2.1.1.tgz", + "integrity": "sha512-9dgM/cZBnNvjzaMYHVoxxfPj2QXt22Ev7SuuPrs+xav0ukGB0S6d4ydZdEiM48kLx5kDV+QBPrpVnFyefL8kkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "async-function": "^1.0.0", + "call-bound": "^1.0.3", + "get-proto": "^1.0.1", + "has-tostringtag": "^1.0.2", + "safe-regex-test": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-bigint": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/is-bigint/-/is-bigint-1.1.0.tgz", + "integrity": "sha512-n4ZT37wG78iz03xPRKJrHTdZbe3IicyucEtdRsV5yglwc3GyUfbAfpSeD0FJ41NbUNSt5wbhqfp1fS+BgnvDFQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-bigints": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-binary-path": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz", + "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==", + "dev": true, + "license": "MIT", + "dependencies": { + "binary-extensions": "^2.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/is-boolean-object": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/is-boolean-object/-/is-boolean-object-1.2.2.tgz", + "integrity": "sha512-wa56o2/ElJMYqjCjGkXri7it5FbebW5usLw/nPmCMs5DeZ7eziSYZhSmPRn0txqeW4LnAmQQU7FgqLpsEFKM4A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-callable": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/is-callable/-/is-callable-1.2.7.tgz", + "integrity": "sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-core-module": { + "version": "2.16.1", + "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz", + "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==", + "dev": true, + "license": "MIT", + "dependencies": { + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-data-view": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-data-view/-/is-data-view-1.0.2.tgz", + "integrity": "sha512-RKtWF8pGmS87i2D6gqQu/l7EYRlVdfzemCJN/P3UOs//x1QE7mfhvzHIApBTRf7axvT6DMGwSwBXYCT0nfB9xw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "get-intrinsic": "^1.2.6", + "is-typed-array": "^1.1.13" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-date-object": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/is-date-object/-/is-date-object-1.1.0.tgz", + "integrity": "sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-finalizationregistry": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-finalizationregistry/-/is-finalizationregistry-1.1.1.tgz", + "integrity": "sha512-1pC6N8qWJbWoPtEjgcL2xyhQOP491EQjeUo3qTKcmV8YSDDJrOepfG8pcC7h/QgnQHYSv0mJ3Z/ZWxmatVrysg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "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-generator-function": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/is-generator-function/-/is-generator-function-1.1.2.tgz", + "integrity": "sha512-upqt1SkGkODW9tsGNG5mtXTXtECizwtS2kA161M+gJPc1xdb/Ax629af6YrTwcOeQHbewrPNlE5Dx7kzvXTizA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.4", + "generator-function": "^2.0.0", + "get-proto": "^1.0.1", + "has-tostringtag": "^1.0.2", + "safe-regex-test": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-map": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/is-map/-/is-map-2.0.3.tgz", + "integrity": "sha512-1Qed0/Hr2m+YqxnM09CjA2d/i6YZNfF6R2oRAOj36eUdS6qIV/huPJNSEpKbupewFs+ZsJlxsjjPbc0/afW6Lw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-module": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-module/-/is-module-1.0.0.tgz", + "integrity": "sha512-51ypPSPCoTEIN9dy5Oy+h4pShgJmPCygKfyRCISBI+JoWT/2oJvK8QPxmwv7b/p239jXrm9M1mlQbyKJ5A152g==", + "dev": true, + "license": "MIT" + }, + "node_modules/is-negative-zero": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/is-negative-zero/-/is-negative-zero-2.0.3.tgz", + "integrity": "sha512-5KoIu2Ngpyek75jXodFvnafB6DJgr3u8uuK0LEZJjrU19DrMD3EVERaR8sjz8CCGgpZvxPl9SuE1GMVPFHx1mw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/is-number-object": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-number-object/-/is-number-object-1.1.1.tgz", + "integrity": "sha512-lZhclumE1G6VYD8VHe35wFaIif+CTy5SJIi5+3y4psDgWu4wPDoBhF8NxUOinEc7pHgiTsT6MaBb92rKhhD+Xw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-obj": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-obj/-/is-obj-1.0.1.tgz", + "integrity": "sha512-l4RyHgRqGN4Y3+9JHVrNqO+tN0rV5My76uW5/nuO4K1b6vw5G8d/cmFjP9tRfEsdhZNt0IFdZuK/c2Vr4Nb+Qg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-path-inside": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/is-path-inside/-/is-path-inside-3.0.3.tgz", + "integrity": "sha512-Fd4gABb+ycGAmKou8eMftCupSir5lRxqf4aD/vd0cD2qc4HL07OjCeuHMr8Ro4CoMaeCKDB0/ECBOVWjTwUvPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-regex": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/is-regex/-/is-regex-1.2.1.tgz", + "integrity": "sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "gopd": "^1.2.0", + "has-tostringtag": "^1.0.2", + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-regexp": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-regexp/-/is-regexp-1.0.0.tgz", + "integrity": "sha512-7zjFAPO4/gwyQAAgRRmqeEeyIICSdmCqa3tsVHMdBzaXXRiqopZL4Cyghg/XulGWrtABTpbnYYzzIRffLkP4oA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-set": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/is-set/-/is-set-2.0.3.tgz", + "integrity": "sha512-iPAjerrse27/ygGLxw+EBR9agv9Y6uLeYVJMu+QNCoouJ1/1ri0mGrcWpfCqFZuzzx3WjtwxG098X+n4OuRkPg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-shared-array-buffer": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/is-shared-array-buffer/-/is-shared-array-buffer-1.0.4.tgz", + "integrity": "sha512-ISWac8drv4ZGfwKl5slpHG9OwPNty4jOWPRIhBpxOoD+hqITiwuipOQ2bNthAzwA3B4fIjO4Nln74N0S9byq8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-stream": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz", + "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-string": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-string/-/is-string-1.1.1.tgz", + "integrity": "sha512-BtEeSsoaQjlSPBemMQIrY1MY0uM6vnS1g5fmufYOtnxLGUZM2178PKbhsk7Ffv58IX+ZtcvoGwccYsh0PglkAA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-symbol": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-symbol/-/is-symbol-1.1.1.tgz", + "integrity": "sha512-9gGx6GTtCQM73BgmHQXfDmLtfjjTUDSyoxTCbp5WtoixAhfgsDirWIcVQ/IHpvI5Vgd5i/J5F7B9cN/WlVbC/w==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "has-symbols": "^1.1.0", + "safe-regex-test": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-typed-array": { + "version": "1.1.15", + "resolved": "https://registry.npmjs.org/is-typed-array/-/is-typed-array-1.1.15.tgz", + "integrity": "sha512-p3EcsicXjit7SaskXHs1hA91QxgTw46Fv6EFKKGS5DRFLD8yKnohjF3hxoju94b/OcMZoQukzpPpBE9uLVKzgQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "which-typed-array": "^1.1.16" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-weakmap": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/is-weakmap/-/is-weakmap-2.0.2.tgz", + "integrity": "sha512-K5pXYOm9wqY1RgjpL3YTkF39tni1XajUIkawTLUo9EZEVUFga5gSQJF8nNS7ZwJQ02y+1YCNYcMh+HIf1ZqE+w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-weakref": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-weakref/-/is-weakref-1.1.1.tgz", + "integrity": "sha512-6i9mGWSlqzNMEqpCp93KwRS1uUOodk2OJ6b+sq7ZPDSy2WuI5NFIxp/254TytR8ftefexkWn5xNiHUNpPOfSew==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-weakset": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/is-weakset/-/is-weakset-2.0.4.tgz", + "integrity": "sha512-mfcwb6IzQyOKTs84CQMrOwW4gQcaTOAWJ0zzJCl2WSPDrWk/OzDaImWFH3djXhb24g4eudZfLRozAvPGw4d9hQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "get-intrinsic": "^1.2.6" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/isarray": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz", + "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==", + "dev": true, + "license": "MIT" + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC" + }, + "node_modules/jackspeak": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-4.1.1.tgz", + "integrity": "sha512-zptv57P3GpL+O0I7VdMJNBZCu+BPHVQUk55Ft8/QCJjTVxrnJHuVuX/0Bl2A6/+2oyR/ZMEuFKwmzqqZ/U5nPQ==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "@isaacs/cliui": "^8.0.2" + }, + "engines": { + "node": "20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/jake": { + "version": "10.9.4", + "resolved": "https://registry.npmjs.org/jake/-/jake-10.9.4.tgz", + "integrity": "sha512-wpHYzhxiVQL+IV05BLE2Xn34zW1S223hvjtqk0+gsPrwd/8JNLXJgZZM/iPFsYc1xyphF+6M6EvdE5E9MBGkDA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "async": "^3.2.6", + "filelist": "^1.0.4", + "picocolors": "^1.1.1" + }, + "bin": { + "jake": "bin/cli.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/jiti": { + "version": "1.21.7", + "resolved": "https://registry.npmjs.org/jiti/-/jiti-1.21.7.tgz", + "integrity": "sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==", + "dev": true, + "license": "MIT", + "peer": true, + "bin": { + "jiti": "bin/jiti.js" + } + }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "license": "MIT" + }, + "node_modules/js-yaml": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", + "dev": true, + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/jsesc": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz", + "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==", + "dev": true, + "license": "MIT", + "bin": { + "jsesc": "bin/jsesc" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/json-buffer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", + "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-schema": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/json-schema/-/json-schema-0.4.0.tgz", + "integrity": "sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA==", + "dev": true, + "license": "(AFL-2.1 OR BSD-3-Clause)" + }, + "node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "dev": true, + "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/jsonfile": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.0.tgz", + "integrity": "sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg==", + "dev": true, + "license": "MIT", + "dependencies": { + "universalify": "^2.0.0" + }, + "optionalDependencies": { + "graceful-fs": "^4.1.6" + } + }, + "node_modules/jsonpointer": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/jsonpointer/-/jsonpointer-5.0.1.tgz", + "integrity": "sha512-p/nXbhSEcu3pZRdkW1OfJhpsVtW1gd4Wa1fnQc9YLiTfAjn0312eMKimbdIQzuZl9aa9xUGaRlP9T/CJE/ditQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/keyv": { + "version": "4.5.4", + "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", + "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "json-buffer": "3.0.1" + } + }, + "node_modules/leven": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz", + "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1", + "type-check": "~0.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/lilconfig": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.3.tgz", + "integrity": "sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/antonk52" + } + }, + "node_modules/lines-and-columns": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz", + "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==", + "dev": true, + "license": "MIT" + }, + "node_modules/locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^5.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/lodash": { + "version": "4.17.21", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", + "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.debounce": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/lodash.debounce/-/lodash.debounce-4.0.8.tgz", + "integrity": "sha512-FT1yDzDYEoYWhnSGnpE/4Kj1fLZkDFyqRb7fNt6FdYOSxlUWAtp42Eh6Wb0rGIv/m9Bgo7x4GhQbm5Ys4SG5ow==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.merge": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", + "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.sortby": { + "version": "4.7.0", + "resolved": "https://registry.npmjs.org/lodash.sortby/-/lodash.sortby-4.7.0.tgz", + "integrity": "sha512-HDWXG8isMntAyRF5vZ7xKuEvOhT4AhlRt/3czTSjvGUxjYCBVRQY48ViDHyfYz9VIoBkW4TMGQNapx+l3RUwdA==", + "dev": true, + "license": "MIT" + }, + "node_modules/loose-envify": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz", + "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==", + "license": "MIT", + "dependencies": { + "js-tokens": "^3.0.0 || ^4.0.0" + }, + "bin": { + "loose-envify": "cli.js" + } + }, + "node_modules/lru-cache": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz", + "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==", + "dev": true, + "license": "ISC", + "dependencies": { + "yallist": "^3.0.2" + } + }, + "node_modules/lucide-react": { + "version": "0.294.0", + "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-0.294.0.tgz", + "integrity": "sha512-V7o0/VECSGbLHn3/1O67FUgBwWB+hmzshrgDVRJQhMh8uj5D3HBuIvhuAmQTtlupILSplwIZg5FTc4tTKMA2SA==", + "license": "ISC", + "peerDependencies": { + "react": "^16.5.1 || ^17.0.0 || ^18.0.0" + } + }, + "node_modules/magic-string": { + "version": "0.25.9", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.25.9.tgz", + "integrity": "sha512-RmF0AsMzgt25qzqqLc1+MbHmhdx0ojF2Fvs4XnOqz2ZOBXzzkEwc/dJQZCYHAn7v1jbVOjAZfK8msRn4BxO4VQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "sourcemap-codec": "^1.4.8" + } + }, + "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/merge2": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", + "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/minimatch": { + "version": "9.0.3", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.3.tgz", + "integrity": "sha512-RHiac9mvaRw0x3AYRgDC1CxAP7HTcNrrECeA8YYJeWnpo+2Q5CegtZjaotWTWxDG3UeGA1coE05iH1mPjT/2mg==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.1" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/minipass": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.2.tgz", + "integrity": "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=16 || 14 >=14.17" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/mz": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/mz/-/mz-2.7.0.tgz", + "integrity": "sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "any-promise": "^1.0.0", + "object-assign": "^4.0.1", + "thenify-all": "^1.0.0" + } + }, + "node_modules/nanoid": { + "version": "3.3.11", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz", + "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==", + "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/natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "dev": true, + "license": "MIT" + }, + "node_modules/node-releases": { + "version": "2.0.27", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.27.tgz", + "integrity": "sha512-nmh3lCkYZ3grZvqcCH+fjmQ7X+H0OeZgP40OierEaAptX4XofMh5kwNbWh7lBduUzCcV/8kZ+NDLCwm2iorIlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/normalize-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", + "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/normalize-range": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz", + "integrity": "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-assign": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", + "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-hash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz", + "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, + "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==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/object-keys": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz", + "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/object.assign": { + "version": "4.1.7", + "resolved": "https://registry.npmjs.org/object.assign/-/object.assign-4.1.7.tgz", + "integrity": "sha512-nK28WOo+QIjBkDduTINE4JkF/UJJKyf2EJxvJKfblDpyg0Q+pkOHNTL0Qwy6NP6FhE/EnzV73BxxqcJaXY9anw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.3", + "define-properties": "^1.2.1", + "es-object-atoms": "^1.0.0", + "has-symbols": "^1.1.0", + "object-keys": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "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==", + "dev": true, + "license": "ISC", + "dependencies": { + "wrappy": "1" + } + }, + "node_modules/optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "deep-is": "^0.1.3", + "fast-levenshtein": "^2.0.6", + "levn": "^0.4.1", + "prelude-ls": "^1.2.1", + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/own-keys": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/own-keys/-/own-keys-1.0.1.tgz", + "integrity": "sha512-qFOyK5PjiWZd+QQIh+1jhdb9LpxTF0qs7Pm8o5QHYZ0M3vKqSqzsZaEB6oWlxZ+q2sJBMI/Ktgd2N5ZwQoRHfg==", + "dev": true, + "license": "MIT", + "dependencies": { + "get-intrinsic": "^1.2.6", + "object-keys": "^1.1.1", + "safe-push-apply": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "yocto-queue": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/package-json-from-dist": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz", + "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==", + "dev": true, + "license": "BlueOak-1.0.0" + }, + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "dev": true, + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-is-absolute": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", + "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-parse": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz", + "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", + "dev": true, + "license": "MIT" + }, + "node_modules/path-scurry": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.1.tgz", + "integrity": "sha512-oWyT4gICAu+kaA7QWk/jvCHWarMKNs6pXOGWKDTr7cw4IGcUbW+PeTfbaQiLGheFRpjo6O9J0PmyMfQPjH71oA==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "lru-cache": "^11.0.0", + "minipass": "^7.1.2" + }, + "engines": { + "node": "20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/path-scurry/node_modules/lru-cache": { + "version": "11.2.4", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.4.tgz", + "integrity": "sha512-B5Y16Jr9LB9dHVkh6ZevG+vAbOsNOYCX+sXvFWFu7B3Iz5mijW3zdbMyhsh8ANd2mSWBYdJgnqi+mL7/LrOPYg==", + "dev": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/path-type": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz", + "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "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": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pify": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", + "integrity": "sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/pirates": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.7.tgz", + "integrity": "sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, + "node_modules/possible-typed-array-names": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/possible-typed-array-names/-/possible-typed-array-names-1.1.0.tgz", + "integrity": "sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/postcss": { + "version": "8.5.6", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz", + "integrity": "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==", + "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", + "peer": true, + "dependencies": { + "nanoid": "^3.3.11", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/postcss-import": { + "version": "15.1.0", + "resolved": "https://registry.npmjs.org/postcss-import/-/postcss-import-15.1.0.tgz", + "integrity": "sha512-hpr+J05B2FVYUAXHeK1YyI267J/dDDhMU6B6civm8hSY1jYJnBXxzKDKDswzJmtLHryrjhnDjqqp/49t8FALew==", + "dev": true, + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.0.0", + "read-cache": "^1.0.0", + "resolve": "^1.1.7" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "postcss": "^8.0.0" + } + }, + "node_modules/postcss-js": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/postcss-js/-/postcss-js-4.1.0.tgz", + "integrity": "sha512-oIAOTqgIo7q2EOwbhb8UalYePMvYoIeRY2YKntdpFQXNosSu3vLrniGgmH9OKs/qAkfoj5oB3le/7mINW1LCfw==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "camelcase-css": "^2.0.1" + }, + "engines": { + "node": "^12 || ^14 || >= 16" + }, + "peerDependencies": { + "postcss": "^8.4.21" + } + }, + "node_modules/postcss-load-config": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-6.0.1.tgz", + "integrity": "sha512-oPtTM4oerL+UXmx+93ytZVN82RrlY/wPUV8IeDxFrzIjXOLF1pN+EmKPLbubvKHT2HC20xXsCAH2Z+CKV6Oz/g==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "lilconfig": "^3.1.1" + }, + "engines": { + "node": ">= 18" + }, + "peerDependencies": { + "jiti": ">=1.21.0", + "postcss": ">=8.0.9", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "jiti": { + "optional": true + }, + "postcss": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/postcss-nested": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/postcss-nested/-/postcss-nested-6.2.0.tgz", + "integrity": "sha512-HQbt28KulC5AJzG+cZtj9kvKB93CFCdLvog1WFLf1D+xmMvPGlBstkpTEZfK5+AN9hfJocyBFCNiqyS48bpgzQ==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "postcss-selector-parser": "^6.1.1" + }, + "engines": { + "node": ">=12.0" + }, + "peerDependencies": { + "postcss": "^8.2.14" + } + }, + "node_modules/postcss-selector-parser": { + "version": "6.1.2", + "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.1.2.tgz", + "integrity": "sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==", + "dev": true, + "license": "MIT", + "dependencies": { + "cssesc": "^3.0.0", + "util-deprecate": "^1.0.2" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/postcss-value-parser": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz", + "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/pretty-bytes": { + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/pretty-bytes/-/pretty-bytes-6.1.1.tgz", + "integrity": "sha512-mQUvGU6aUFQ+rNvTIAcZuWGRT9a6f6Yrg9bHs4ImKF+HZCEK+plBvnAZYSIQztknZF2qnzNtr6F8s0+IuptdlQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/proxy-from-env": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-1.1.0.tgz", + "integrity": "sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==", + "license": "MIT" + }, + "node_modules/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/queue-microtask": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", + "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/randombytes": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz", + "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "safe-buffer": "^5.1.0" + } + }, + "node_modules/react": { + "version": "18.3.1", + "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz", + "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "loose-envify": "^1.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-dom": { + "version": "18.3.1", + "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz", + "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==", + "license": "MIT", + "peer": true, + "dependencies": { + "loose-envify": "^1.1.0", + "scheduler": "^0.23.2" + }, + "peerDependencies": { + "react": "^18.3.1" + } + }, + "node_modules/react-refresh": { + "version": "0.17.0", + "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.17.0.tgz", + "integrity": "sha512-z6F7K9bV85EfseRCp2bzrpyQ0Gkw1uLoCel9XBVWPg/TjRj94SkJzUTGfOa4bs7iJvBWtQG0Wq7wnI0syw3EBQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-router": { + "version": "6.30.2", + "resolved": "https://registry.npmjs.org/react-router/-/react-router-6.30.2.tgz", + "integrity": "sha512-H2Bm38Zu1bm8KUE5NVWRMzuIyAV8p/JrOaBJAwVmp37AXG72+CZJlEBw6pdn9i5TBgLMhNDgijS4ZlblpHyWTA==", + "license": "MIT", + "dependencies": { + "@remix-run/router": "1.23.1" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "react": ">=16.8" + } + }, + "node_modules/react-router-dom": { + "version": "6.30.2", + "resolved": "https://registry.npmjs.org/react-router-dom/-/react-router-dom-6.30.2.tgz", + "integrity": "sha512-l2OwHn3UUnEVUqc6/1VMmR1cvZryZ3j3NzapC2eUXO1dB0sYp5mvwdjiXhpUbRb21eFow3qSxpP8Yv6oAU824Q==", + "license": "MIT", + "dependencies": { + "@remix-run/router": "1.23.1", + "react-router": "6.30.2" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "react": ">=16.8", + "react-dom": ">=16.8" + } + }, + "node_modules/read-cache": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/read-cache/-/read-cache-1.0.0.tgz", + "integrity": "sha512-Owdv/Ft7IjOgm/i0xvNDZ1LrRANRfew4b2prF3OWMQLxLfu3bS8FVhCsrSCMK4lR56Y9ya+AThoTpDCTxCmpRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "pify": "^2.3.0" + } + }, + "node_modules/readdirp": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz", + "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==", + "dev": true, + "license": "MIT", + "dependencies": { + "picomatch": "^2.2.1" + }, + "engines": { + "node": ">=8.10.0" + } + }, + "node_modules/reflect.getprototypeof": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/reflect.getprototypeof/-/reflect.getprototypeof-1.0.10.tgz", + "integrity": "sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.9", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.0.0", + "get-intrinsic": "^1.2.7", + "get-proto": "^1.0.1", + "which-builtin-type": "^1.2.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/regenerate": { + "version": "1.4.2", + "resolved": "https://registry.npmjs.org/regenerate/-/regenerate-1.4.2.tgz", + "integrity": "sha512-zrceR/XhGYU/d/opr2EKO7aRHUeiBI8qjtfHqADTwZd6Szfy16la6kqD0MIUs5z5hx6AaKa+PixpPrR289+I0A==", + "dev": true, + "license": "MIT" + }, + "node_modules/regenerate-unicode-properties": { + "version": "10.2.2", + "resolved": "https://registry.npmjs.org/regenerate-unicode-properties/-/regenerate-unicode-properties-10.2.2.tgz", + "integrity": "sha512-m03P+zhBeQd1RGnYxrGyDAPpWX/epKirLrp8e3qevZdVkKtnCrjjWczIbYc8+xd6vcTStVlqfycTx1KR4LOr0g==", + "dev": true, + "license": "MIT", + "dependencies": { + "regenerate": "^1.4.2" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/regexp.prototype.flags": { + "version": "1.5.4", + "resolved": "https://registry.npmjs.org/regexp.prototype.flags/-/regexp.prototype.flags-1.5.4.tgz", + "integrity": "sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "define-properties": "^1.2.1", + "es-errors": "^1.3.0", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "set-function-name": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/regexpu-core": { + "version": "6.4.0", + "resolved": "https://registry.npmjs.org/regexpu-core/-/regexpu-core-6.4.0.tgz", + "integrity": "sha512-0ghuzq67LI9bLXpOX/ISfve/Mq33a4aFRzoQYhnnok1JOFpmE/A2TBGkNVenOGEeSBCjIiWcc6MVOG5HEQv0sA==", + "dev": true, + "license": "MIT", + "dependencies": { + "regenerate": "^1.4.2", + "regenerate-unicode-properties": "^10.2.2", + "regjsgen": "^0.8.0", + "regjsparser": "^0.13.0", + "unicode-match-property-ecmascript": "^2.0.0", + "unicode-match-property-value-ecmascript": "^2.2.1" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/regjsgen": { + "version": "0.8.0", + "resolved": "https://registry.npmjs.org/regjsgen/-/regjsgen-0.8.0.tgz", + "integrity": "sha512-RvwtGe3d7LvWiDQXeQw8p5asZUmfU1G/l6WbUXeHta7Y2PEIvBTwH6E2EfmYUK8pxcxEdEmaomqyp0vZZ7C+3Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/regjsparser": { + "version": "0.13.0", + "resolved": "https://registry.npmjs.org/regjsparser/-/regjsparser-0.13.0.tgz", + "integrity": "sha512-NZQZdC5wOE/H3UT28fVGL+ikOZcEzfMGk/c3iN9UGxzWHMa1op7274oyiUVrAG4B2EuFhus8SvkaYnhvW92p9Q==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "jsesc": "~3.1.0" + }, + "bin": { + "regjsparser": "bin/parser" + } + }, + "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==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/resolve": { + "version": "1.22.11", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz", + "integrity": "sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-core-module": "^2.16.1", + "path-parse": "^1.0.7", + "supports-preserve-symlinks-flag": "^1.0.0" + }, + "bin": { + "resolve": "bin/resolve" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/reusify": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz", + "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==", + "dev": true, + "license": "MIT", + "engines": { + "iojs": ">=1.0.0", + "node": ">=0.10.0" + } + }, + "node_modules/rimraf": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz", + "integrity": "sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==", + "deprecated": "Rimraf versions prior to v4 are no longer supported", + "dev": true, + "license": "ISC", + "dependencies": { + "glob": "^7.1.3" + }, + "bin": { + "rimraf": "bin.js" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/rollup": { + "version": "4.53.3", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.53.3.tgz", + "integrity": "sha512-w8GmOxZfBmKknvdXU1sdM9NHcoQejwF/4mNgj2JuEEdRaHwwF12K7e9eXn1nLZ07ad+du76mkVsyeb2rKGllsA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.8" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@rollup/rollup-android-arm-eabi": "4.53.3", + "@rollup/rollup-android-arm64": "4.53.3", + "@rollup/rollup-darwin-arm64": "4.53.3", + "@rollup/rollup-darwin-x64": "4.53.3", + "@rollup/rollup-freebsd-arm64": "4.53.3", + "@rollup/rollup-freebsd-x64": "4.53.3", + "@rollup/rollup-linux-arm-gnueabihf": "4.53.3", + "@rollup/rollup-linux-arm-musleabihf": "4.53.3", + "@rollup/rollup-linux-arm64-gnu": "4.53.3", + "@rollup/rollup-linux-arm64-musl": "4.53.3", + "@rollup/rollup-linux-loong64-gnu": "4.53.3", + "@rollup/rollup-linux-ppc64-gnu": "4.53.3", + "@rollup/rollup-linux-riscv64-gnu": "4.53.3", + "@rollup/rollup-linux-riscv64-musl": "4.53.3", + "@rollup/rollup-linux-s390x-gnu": "4.53.3", + "@rollup/rollup-linux-x64-gnu": "4.53.3", + "@rollup/rollup-linux-x64-musl": "4.53.3", + "@rollup/rollup-openharmony-arm64": "4.53.3", + "@rollup/rollup-win32-arm64-msvc": "4.53.3", + "@rollup/rollup-win32-ia32-msvc": "4.53.3", + "@rollup/rollup-win32-x64-gnu": "4.53.3", + "@rollup/rollup-win32-x64-msvc": "4.53.3", + "fsevents": "~2.3.2" + } + }, + "node_modules/run-parallel": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", + "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "queue-microtask": "^1.2.2" + } + }, + "node_modules/safe-array-concat": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/safe-array-concat/-/safe-array-concat-1.1.3.tgz", + "integrity": "sha512-AURm5f0jYEOydBj7VQlVvDrjeFgthDdEF5H1dP+6mNpoXOMo1quQqJ4wvJDyRZ9+pO3kGWoOdmV08cSv2aJV6Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.2", + "get-intrinsic": "^1.2.6", + "has-symbols": "^1.1.0", + "isarray": "^2.0.5" + }, + "engines": { + "node": ">=0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "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-push-apply": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/safe-push-apply/-/safe-push-apply-1.0.0.tgz", + "integrity": "sha512-iKE9w/Z7xCzUMIZqdBsp6pEQvwuEebH4vdpjcDWnyzaI6yl6O9FHvVpmGelvEHNsoY6wGblkxR6Zty/h00WiSA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "isarray": "^2.0.5" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/safe-regex-test": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/safe-regex-test/-/safe-regex-test-1.1.0.tgz", + "integrity": "sha512-x/+Cz4YrimQxQccJf5mKEbIa1NzeCRNI5Ecl/ekmlYaampdNLPalVyIcCZNNH3MvmqBugV5TMYZXv0ljslUlaw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "is-regex": "^1.2.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/scheduler": { + "version": "0.23.2", + "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz", + "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==", + "license": "MIT", + "dependencies": { + "loose-envify": "^1.1.0" + } + }, + "node_modules/semver": { + "version": "7.7.3", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz", + "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/serialize-javascript": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-6.0.2.tgz", + "integrity": "sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "randombytes": "^2.1.0" + } + }, + "node_modules/set-function-length": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz", + "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-data-property": "^1.1.4", + "es-errors": "^1.3.0", + "function-bind": "^1.1.2", + "get-intrinsic": "^1.2.4", + "gopd": "^1.0.1", + "has-property-descriptors": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/set-function-name": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/set-function-name/-/set-function-name-2.0.2.tgz", + "integrity": "sha512-7PGFlmtwsEADb0WYyvCMa1t+yke6daIG4Wirafur5kcf+MhUnPms1UeR0CKQdTZD81yESwMHbtn+TR+dMviakQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-data-property": "^1.1.4", + "es-errors": "^1.3.0", + "functions-have-names": "^1.2.3", + "has-property-descriptors": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/set-proto": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/set-proto/-/set-proto-1.0.0.tgz", + "integrity": "sha512-RJRdvCo6IAnPdsvP/7m6bsQqNnn1FCBX5ZNtFL98MmFF/4xAIJTIg1YbHW5DC2W5SKZanrC6i4HsJqlajw/dZw==", + "dev": true, + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "dev": true, + "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==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/side-channel": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz", + "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3", + "side-channel-list": "^1.0.0", + "side-channel-map": "^1.0.1", + "side-channel-weakmap": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-list": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz", + "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-map": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz", + "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", + "dev": true, + "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==", + "dev": true, + "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/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/slash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz", + "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/smob": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/smob/-/smob-1.5.0.tgz", + "integrity": "sha512-g6T+p7QO8npa+/hNx9ohv1E5pVCmWrVCUzUXJyLdMmftX6ER0oiWY/w9knEonLpnOp6b6FenKnMfR8gqwWdwig==", + "dev": true, + "license": "MIT" + }, + "node_modules/source-map": { + "version": "0.8.0-beta.0", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.8.0-beta.0.tgz", + "integrity": "sha512-2ymg6oRBpebeZi9UUNsgQ89bhx01TcTkmNTGnNO88imTmbSgy4nfujrgVEFKWpMTEGA11EDkTt7mqObTPdigIA==", + "deprecated": "The work that was done in this beta branch won't be included in future versions", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "whatwg-url": "^7.0.0" + }, + "engines": { + "node": ">= 8" + } + }, + "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/sourcemap-codec": { + "version": "1.4.8", + "resolved": "https://registry.npmjs.org/sourcemap-codec/-/sourcemap-codec-1.4.8.tgz", + "integrity": "sha512-9NykojV5Uih4lgo5So5dtw+f0JgJX30KCNI8gwhz2J9A15wD0Ml6tjHKwf6fTSa6fAdVBdZeNOs9eJ71qCk8vA==", + "deprecated": "Please use @jridgewell/sourcemap-codec instead", + "dev": true, + "license": "MIT" + }, + "node_modules/stop-iteration-iterator": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/stop-iteration-iterator/-/stop-iteration-iterator-1.1.0.tgz", + "integrity": "sha512-eLoXW/DHyl62zxY4SCaIgnRhuMr6ri4juEYARS8E6sCEqzKpOiE521Ucofdx+KnDZl5xmvGYaaKCk5FEOxJCoQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "internal-slot": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/string-width": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", + "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "eastasianwidth": "^0.2.0", + "emoji-regex": "^9.2.2", + "strip-ansi": "^7.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/string-width-cjs": { + "name": "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/string-width-cjs/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/string-width/node_modules/ansi-regex": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz", + "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/string-width/node_modules/strip-ansi": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.2.tgz", + "integrity": "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/string.prototype.matchall": { + "version": "4.0.12", + "resolved": "https://registry.npmjs.org/string.prototype.matchall/-/string.prototype.matchall-4.0.12.tgz", + "integrity": "sha512-6CC9uyBL+/48dYizRf7H7VAYCMCNTBeM78x/VTUe9bFEaxBepPJDa1Ow99LqI/1yF7kuy7Q3cQsYMrcjGUcskA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.3", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.6", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.0.0", + "get-intrinsic": "^1.2.6", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "internal-slot": "^1.1.0", + "regexp.prototype.flags": "^1.5.3", + "set-function-name": "^2.0.2", + "side-channel": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/string.prototype.trim": { + "version": "1.2.10", + "resolved": "https://registry.npmjs.org/string.prototype.trim/-/string.prototype.trim-1.2.10.tgz", + "integrity": "sha512-Rs66F0P/1kedk5lyYyH9uBzuiI/kNRmwJAR9quK6VOtIpZ2G+hMZd+HQbbv25MgCA6gEffoMZYxlTod4WcdrKA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.2", + "define-data-property": "^1.1.4", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.5", + "es-object-atoms": "^1.0.0", + "has-property-descriptors": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/string.prototype.trimend": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/string.prototype.trimend/-/string.prototype.trimend-1.0.9.tgz", + "integrity": "sha512-G7Ok5C6E/j4SGfyLCloXTrngQIQU3PWtXGst3yM7Bea9FRURf1S42ZHlZZtsNque2FN2PoUhfZXYLNWwEr4dLQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.2", + "define-properties": "^1.2.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/string.prototype.trimstart": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/string.prototype.trimstart/-/string.prototype.trimstart-1.0.8.tgz", + "integrity": "sha512-UXSH262CSZY1tfu3G3Secr6uGLCFVPMhIqHjlgCUtCCcgihYc/xKs9djMTMUOb2j1mVSeU8EU6NWc/iQKU6Gfg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/stringify-object": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/stringify-object/-/stringify-object-3.3.0.tgz", + "integrity": "sha512-rHqiFh1elqCQ9WPLIC8I0Q/g/wj5J1eMkyoiD6eoQApWHP0FtlK7rqnhmabL5VUY9JQCcqwwvlOaSuutekgyrw==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "get-own-enumerable-property-symbols": "^3.0.0", + "is-obj": "^1.0.1", + "is-regexp": "^1.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "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-ansi-cjs": { + "name": "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-comments": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/strip-comments/-/strip-comments-2.0.1.tgz", + "integrity": "sha512-ZprKx+bBLXv067WTCALv8SSz5l2+XhpYCsVtSqlMnkAXMWDq+/ekVbl1ghqP9rUHTzv6sm/DwCOiYutU/yp1fw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/strip-json-comments": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", + "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/sucrase": { + "version": "3.35.1", + "resolved": "https://registry.npmjs.org/sucrase/-/sucrase-3.35.1.tgz", + "integrity": "sha512-DhuTmvZWux4H1UOnWMB3sk0sbaCVOoQZjv8u1rDoTV0HTdGem9hkAZtl4JZy8P2z4Bg0nT+YMeOFyVr4zcG5Tw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.2", + "commander": "^4.0.0", + "lines-and-columns": "^1.1.6", + "mz": "^2.7.0", + "pirates": "^4.0.1", + "tinyglobby": "^0.2.11", + "ts-interface-checker": "^0.1.9" + }, + "bin": { + "sucrase": "bin/sucrase", + "sucrase-node": "bin/sucrase-node" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + } + }, + "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/supports-preserve-symlinks-flag": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz", + "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/tailwindcss": { + "version": "3.4.18", + "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.18.tgz", + "integrity": "sha512-6A2rnmW5xZMdw11LYjhcI5846rt9pbLSabY5XPxo+XWdxwZaFEn47Go4NzFiHu9sNNmr/kXivP1vStfvMaK1GQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@alloc/quick-lru": "^5.2.0", + "arg": "^5.0.2", + "chokidar": "^3.6.0", + "didyoumean": "^1.2.2", + "dlv": "^1.1.3", + "fast-glob": "^3.3.2", + "glob-parent": "^6.0.2", + "is-glob": "^4.0.3", + "jiti": "^1.21.7", + "lilconfig": "^3.1.3", + "micromatch": "^4.0.8", + "normalize-path": "^3.0.0", + "object-hash": "^3.0.0", + "picocolors": "^1.1.1", + "postcss": "^8.4.47", + "postcss-import": "^15.1.0", + "postcss-js": "^4.0.1", + "postcss-load-config": "^4.0.2 || ^5.0 || ^6.0", + "postcss-nested": "^6.2.0", + "postcss-selector-parser": "^6.1.2", + "resolve": "^1.22.8", + "sucrase": "^3.35.0" + }, + "bin": { + "tailwind": "lib/cli.js", + "tailwindcss": "lib/cli.js" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/temp-dir": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/temp-dir/-/temp-dir-2.0.0.tgz", + "integrity": "sha512-aoBAniQmmwtcKp/7BzsH8Cxzv8OL736p7v1ihGb5e9DJ9kTwGWHrQrVB5+lfVDzfGrdRzXch+ig7LHaY1JTOrg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/tempy": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/tempy/-/tempy-0.6.0.tgz", + "integrity": "sha512-G13vtMYPT/J8A4X2SjdtBTphZlrp1gKv6hZiOjw14RCWg6GbHuQBGtjlx75xLbYV/wEc0D7G5K4rxKP/cXk8Bw==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-stream": "^2.0.0", + "temp-dir": "^2.0.0", + "type-fest": "^0.16.0", + "unique-string": "^2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/tempy/node_modules/type-fest": { + "version": "0.16.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.16.0.tgz", + "integrity": "sha512-eaBzG6MxNzEn9kiwvtre90cXaNLkmadMWa1zQMs3XORCXNbsH/OewwbxC5ia9dCxIxnTAsSxXJaa/p5y8DlvJg==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/terser": { + "version": "5.44.1", + "resolved": "https://registry.npmjs.org/terser/-/terser-5.44.1.tgz", + "integrity": "sha512-t/R3R/n0MSwnnazuPpPNVO60LX0SKL45pyl9YlvxIdkH0Of7D5qM2EVe+yASRIlY5pZ73nclYJfNANGWPwFDZw==", + "dev": true, + "license": "BSD-2-Clause", + "peer": true, + "dependencies": { + "@jridgewell/source-map": "^0.3.3", + "acorn": "^8.15.0", + "commander": "^2.20.0", + "source-map-support": "~0.5.20" + }, + "bin": { + "terser": "bin/terser" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/terser/node_modules/commander": { + "version": "2.20.3", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz", + "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/text-table": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/text-table/-/text-table-0.2.0.tgz", + "integrity": "sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw==", + "dev": true, + "license": "MIT" + }, + "node_modules/thenify": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/thenify/-/thenify-3.3.1.tgz", + "integrity": "sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==", + "dev": true, + "license": "MIT", + "dependencies": { + "any-promise": "^1.0.0" + } + }, + "node_modules/thenify-all": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/thenify-all/-/thenify-all-1.6.0.tgz", + "integrity": "sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==", + "dev": true, + "license": "MIT", + "dependencies": { + "thenify": ">= 3.1.0 < 4" + }, + "engines": { + "node": ">=0.8" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.15", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz", + "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.3" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tinyglobby/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/tinyglobby/node_modules/picomatch": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz", + "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/tr46": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/tr46/-/tr46-1.0.1.tgz", + "integrity": "sha512-dTpowEjclQ7Kgx5SdBkqRzVhERQXov8/l9Ft9dVM9fmg0W0KQSVaXX9T4i6twCPNtYiZM53lpSSUAwJbFPOHxA==", + "dev": true, + "license": "MIT", + "dependencies": { + "punycode": "^2.1.0" + } + }, + "node_modules/ts-api-utils": { + "version": "1.4.3", + "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-1.4.3.tgz", + "integrity": "sha512-i3eMG77UTMD0hZhgRS562pv83RC6ukSAC2GMNWc+9dieh/+jDM5u5YG+NHX6VNDRHQcHwmsTHctP9LhbC3WxVw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=16" + }, + "peerDependencies": { + "typescript": ">=4.2.0" + } + }, + "node_modules/ts-interface-checker": { + "version": "0.1.13", + "resolved": "https://registry.npmjs.org/ts-interface-checker/-/ts-interface-checker-0.1.13.tgz", + "integrity": "sha512-Y/arvbn+rrz3JCKl9C4kVNfTfSm2/mEp5FSz5EsZSANGPSlQrpRI5M4PKF+mJnE52jOO90PnPSc3Ur3bTQw0gA==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/type-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/type-fest": { + "version": "0.20.2", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.20.2.tgz", + "integrity": "sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/typed-array-buffer": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/typed-array-buffer/-/typed-array-buffer-1.0.3.tgz", + "integrity": "sha512-nAYYwfY3qnzX30IkA6AQZjVbtK6duGontcQm1WSG1MD94YLqK0515GNApXkoxKOWMusVssAHWLh9SeaoefYFGw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "es-errors": "^1.3.0", + "is-typed-array": "^1.1.14" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/typed-array-byte-length": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/typed-array-byte-length/-/typed-array-byte-length-1.0.3.tgz", + "integrity": "sha512-BaXgOuIxz8n8pIq3e7Atg/7s+DpiYrxn4vdot3w9KbnBhcRQq6o3xemQdIfynqSeXeDrF32x+WvfzmOjPiY9lg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "for-each": "^0.3.3", + "gopd": "^1.2.0", + "has-proto": "^1.2.0", + "is-typed-array": "^1.1.14" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/typed-array-byte-offset": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/typed-array-byte-offset/-/typed-array-byte-offset-1.0.4.tgz", + "integrity": "sha512-bTlAFB/FBYMcuX81gbL4OcpH5PmlFHqlCCpAl8AlEzMz5k53oNDvN8p1PNOWLEmI2x4orp3raOFB51tv9X+MFQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "available-typed-arrays": "^1.0.7", + "call-bind": "^1.0.8", + "for-each": "^0.3.3", + "gopd": "^1.2.0", + "has-proto": "^1.2.0", + "is-typed-array": "^1.1.15", + "reflect.getprototypeof": "^1.0.9" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/typed-array-length": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/typed-array-length/-/typed-array-length-1.0.7.tgz", + "integrity": "sha512-3KS2b+kL7fsuk/eJZ7EQdnEmQoaho/r6KUef7hxvltNA5DR8NAUM+8wJMbJyZ4G9/7i3v5zPBIMN5aybAh2/Jg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "for-each": "^0.3.3", + "gopd": "^1.0.1", + "is-typed-array": "^1.1.13", + "possible-typed-array-names": "^1.0.0", + "reflect.getprototypeof": "^1.0.6" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "peer": true, + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/unbox-primitive": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/unbox-primitive/-/unbox-primitive-1.1.0.tgz", + "integrity": "sha512-nWJ91DjeOkej/TA8pXQ3myruKpKEYgqvpw9lz4OPHj/NWFNluYrjbz9j01CJ8yKQd2g4jFoOkINCTW2I5LEEyw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "has-bigints": "^1.0.2", + "has-symbols": "^1.1.0", + "which-boxed-primitive": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/unicode-canonical-property-names-ecmascript": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/unicode-canonical-property-names-ecmascript/-/unicode-canonical-property-names-ecmascript-2.0.1.tgz", + "integrity": "sha512-dA8WbNeb2a6oQzAQ55YlT5vQAWGV9WXOsi3SskE3bcCdM0P4SDd+24zS/OCacdRq5BkdsRj9q3Pg6YyQoxIGqg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/unicode-match-property-ecmascript": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/unicode-match-property-ecmascript/-/unicode-match-property-ecmascript-2.0.0.tgz", + "integrity": "sha512-5kaZCrbp5mmbz5ulBkDkbY0SsPOjKqVS35VpL9ulMPfSl0J0Xsm+9Evphv9CoIZFwre7aJoa94AY6seMKGVN5Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "unicode-canonical-property-names-ecmascript": "^2.0.0", + "unicode-property-aliases-ecmascript": "^2.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/unicode-match-property-value-ecmascript": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/unicode-match-property-value-ecmascript/-/unicode-match-property-value-ecmascript-2.2.1.tgz", + "integrity": "sha512-JQ84qTuMg4nVkx8ga4A16a1epI9H6uTXAknqxkGF/aFfRLw1xC/Bp24HNLaZhHSkWd3+84t8iXnp1J0kYcZHhg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/unicode-property-aliases-ecmascript": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/unicode-property-aliases-ecmascript/-/unicode-property-aliases-ecmascript-2.2.0.tgz", + "integrity": "sha512-hpbDzxUY9BFwX+UeBnxv3Sh1q7HFxj48DTmXchNgRa46lO8uj3/1iEn3MiNUYTg1g9ctIqXCCERn8gYZhHC5lQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/unique-string": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/unique-string/-/unique-string-2.0.0.tgz", + "integrity": "sha512-uNaeirEPvpZWSgzwsPGtU2zVSTrn/8L5q/IexZmH0eH6SA73CmAA5U4GwORTxQAZs95TAXLNqeLoPPNO5gZfWg==", + "dev": true, + "license": "MIT", + "dependencies": { + "crypto-random-string": "^2.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/universalify": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz", + "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 10.0.0" + } + }, + "node_modules/upath": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/upath/-/upath-1.2.0.tgz", + "integrity": "sha512-aZwGpamFO61g3OlfT7OQCHqhGnW43ieH9WZeP7QxN/G/jS4jfqUkZxoryvJgVPEcrl5NL/ggHsSmLMHuH64Lhg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4", + "yarn": "*" + } + }, + "node_modules/update-browserslist-db": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.2.tgz", + "integrity": "sha512-E85pfNzMQ9jpKkA7+TJAi4TJN+tBCuWh5rUcS/sv6cFi+1q9LYDwDI5dpUL0u/73EElyQ8d3TEaeW4sPedBqYA==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "escalade": "^3.2.0", + "picocolors": "^1.1.1" + }, + "bin": { + "update-browserslist-db": "cli.js" + }, + "peerDependencies": { + "browserslist": ">= 4.21.0" + } + }, + "node_modules/uri-js": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", + "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "punycode": "^2.1.0" + } + }, + "node_modules/use-sync-external-store": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/use-sync-external-store/-/use-sync-external-store-1.6.0.tgz", + "integrity": "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==", + "license": "MIT", + "peerDependencies": { + "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" + } + }, + "node_modules/util-deprecate": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", + "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "dev": true, + "license": "MIT" + }, + "node_modules/vite": { + "version": "5.4.21", + "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.21.tgz", + "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "esbuild": "^0.21.3", + "postcss": "^8.4.43", + "rollup": "^4.20.0" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^18.0.0 || >=20.0.0", + "less": "*", + "lightningcss": "^1.21.0", + "sass": "*", + "sass-embedded": "*", + "stylus": "*", + "sugarss": "*", + "terser": "^5.4.0" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + } + } + }, + "node_modules/vite-plugin-pwa": { + "version": "0.17.5", + "resolved": "https://registry.npmjs.org/vite-plugin-pwa/-/vite-plugin-pwa-0.17.5.tgz", + "integrity": "sha512-UxRNPiJBzh4tqU/vc8G2TxmrUTzT6BqvSzhszLk62uKsf+npXdvLxGDz9C675f4BJi6MbD2tPnJhi5txlMzxbQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^4.3.4", + "fast-glob": "^3.3.2", + "pretty-bytes": "^6.1.1", + "workbox-build": "^7.0.0", + "workbox-window": "^7.0.0" + }, + "engines": { + "node": ">=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/antfu" + }, + "peerDependencies": { + "vite": "^3.1.0 || ^4.0.0 || ^5.0.0", + "workbox-build": "^7.0.0", + "workbox-window": "^7.0.0" + } + }, + "node_modules/webidl-conversions": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-4.0.2.tgz", + "integrity": "sha512-YQ+BmxuTgd6UXZW3+ICGfyqRyHXVlD5GtQr5+qjiNW7bF0cqrzX500HVXPBOvgXb5YnzDd+h0zqyv61KUD7+Sg==", + "dev": true, + "license": "BSD-2-Clause" + }, + "node_modules/whatwg-url": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-7.1.0.tgz", + "integrity": "sha512-WUu7Rg1DroM7oQvGWfOiAK21n74Gg+T4elXEQYkOhtyLeWiJFoOGLXPKI/9gzIie9CtwVLm8wtw6YJdKyxSjeg==", + "dev": true, + "license": "MIT", + "dependencies": { + "lodash.sortby": "^4.7.0", + "tr46": "^1.0.1", + "webidl-conversions": "^4.0.2" + } + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "dev": true, + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/which-boxed-primitive": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/which-boxed-primitive/-/which-boxed-primitive-1.1.1.tgz", + "integrity": "sha512-TbX3mj8n0odCBFVlY8AxkqcHASw3L60jIuF8jFP78az3C2YhmGvqbHBpAjTRH2/xqYunrJ9g1jSyjCjpoWzIAA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-bigint": "^1.1.0", + "is-boolean-object": "^1.2.1", + "is-number-object": "^1.1.1", + "is-string": "^1.1.1", + "is-symbol": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/which-builtin-type": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/which-builtin-type/-/which-builtin-type-1.2.1.tgz", + "integrity": "sha512-6iBczoX+kDQ7a3+YJBnh3T+KZRxM/iYNPXicqk66/Qfm1b93iu+yOImkg0zHbj5LNOcNv1TEADiZ0xa34B4q6Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "function.prototype.name": "^1.1.6", + "has-tostringtag": "^1.0.2", + "is-async-function": "^2.0.0", + "is-date-object": "^1.1.0", + "is-finalizationregistry": "^1.1.0", + "is-generator-function": "^1.0.10", + "is-regex": "^1.2.1", + "is-weakref": "^1.0.2", + "isarray": "^2.0.5", + "which-boxed-primitive": "^1.1.0", + "which-collection": "^1.0.2", + "which-typed-array": "^1.1.16" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/which-collection": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/which-collection/-/which-collection-1.0.2.tgz", + "integrity": "sha512-K4jVyjnBdgvc86Y6BkaLZEN933SwYOuBFkdmBu9ZfkcAbdVbpITnDmjvZ/aQjRXQrv5EPkTnD1s39GiiqbngCw==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-map": "^2.0.3", + "is-set": "^2.0.3", + "is-weakmap": "^2.0.2", + "is-weakset": "^2.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/which-typed-array": { + "version": "1.1.19", + "resolved": "https://registry.npmjs.org/which-typed-array/-/which-typed-array-1.1.19.tgz", + "integrity": "sha512-rEvr90Bck4WZt9HHFC4DJMsjvu7x+r6bImz0/BrbWb7A2djJ8hnZMrWnHo9F8ssv0OMErasDhftrfROTyqSDrw==", + "dev": true, + "license": "MIT", + "dependencies": { + "available-typed-arrays": "^1.0.7", + "call-bind": "^1.0.8", + "call-bound": "^1.0.4", + "for-each": "^0.3.5", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/workbox-background-sync": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-background-sync/-/workbox-background-sync-7.4.0.tgz", + "integrity": "sha512-8CB9OxKAgKZKyNMwfGZ1XESx89GryWTfI+V5yEj8sHjFH8MFelUwYXEyldEK6M6oKMmn807GoJFUEA1sC4XS9w==", + "dev": true, + "license": "MIT", + "dependencies": { + "idb": "^7.0.1", + "workbox-core": "7.4.0" + } + }, + "node_modules/workbox-broadcast-update": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-broadcast-update/-/workbox-broadcast-update-7.4.0.tgz", + "integrity": "sha512-+eZQwoktlvo62cI0b+QBr40v5XjighxPq3Fzo9AWMiAosmpG5gxRHgTbGGhaJv/q/MFVxwFNGh/UwHZ/8K88lA==", + "dev": true, + "license": "MIT", + "dependencies": { + "workbox-core": "7.4.0" + } + }, + "node_modules/workbox-build": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-build/-/workbox-build-7.4.0.tgz", + "integrity": "sha512-Ntk1pWb0caOFIvwz/hfgrov/OJ45wPEhI5PbTywQcYjyZiVhT3UrwwUPl6TRYbTm4moaFYithYnl1lvZ8UjxcA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@apideck/better-ajv-errors": "^0.3.1", + "@babel/core": "^7.24.4", + "@babel/preset-env": "^7.11.0", + "@babel/runtime": "^7.11.2", + "@rollup/plugin-babel": "^5.2.0", + "@rollup/plugin-node-resolve": "^15.2.3", + "@rollup/plugin-replace": "^2.4.1", + "@rollup/plugin-terser": "^0.4.3", + "@surma/rollup-plugin-off-main-thread": "^2.2.3", + "ajv": "^8.6.0", + "common-tags": "^1.8.0", + "fast-json-stable-stringify": "^2.1.0", + "fs-extra": "^9.0.1", + "glob": "^11.0.1", + "lodash": "^4.17.20", + "pretty-bytes": "^5.3.0", + "rollup": "^2.79.2", + "source-map": "^0.8.0-beta.0", + "stringify-object": "^3.3.0", + "strip-comments": "^2.0.1", + "tempy": "^0.6.0", + "upath": "^1.2.0", + "workbox-background-sync": "7.4.0", + "workbox-broadcast-update": "7.4.0", + "workbox-cacheable-response": "7.4.0", + "workbox-core": "7.4.0", + "workbox-expiration": "7.4.0", + "workbox-google-analytics": "7.4.0", + "workbox-navigation-preload": "7.4.0", + "workbox-precaching": "7.4.0", + "workbox-range-requests": "7.4.0", + "workbox-recipes": "7.4.0", + "workbox-routing": "7.4.0", + "workbox-strategies": "7.4.0", + "workbox-streams": "7.4.0", + "workbox-sw": "7.4.0", + "workbox-window": "7.4.0" + }, + "engines": { + "node": ">=20.0.0" + } + }, + "node_modules/workbox-build/node_modules/@apideck/better-ajv-errors": { + "version": "0.3.6", + "resolved": "https://registry.npmjs.org/@apideck/better-ajv-errors/-/better-ajv-errors-0.3.6.tgz", + "integrity": "sha512-P+ZygBLZtkp0qqOAJJVX4oX/sFo5JR3eBWwwuqHHhK0GIgQOKWrAfiAaWX0aArHkRWHMuggFEgAZNxVPwPZYaA==", + "dev": true, + "license": "MIT", + "dependencies": { + "json-schema": "^0.4.0", + "jsonpointer": "^5.0.0", + "leven": "^3.1.0" + }, + "engines": { + "node": ">=10" + }, + "peerDependencies": { + "ajv": ">=8" + } + }, + "node_modules/workbox-build/node_modules/@rollup/plugin-babel": { + "version": "5.3.1", + "resolved": "https://registry.npmjs.org/@rollup/plugin-babel/-/plugin-babel-5.3.1.tgz", + "integrity": "sha512-WFfdLWU/xVWKeRQnKmIAQULUI7Il0gZnBIH/ZFO069wYIfPu+8zrfp/KMW0atmELoRDq8FbiP3VCss9MhCut7Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.10.4", + "@rollup/pluginutils": "^3.1.0" + }, + "engines": { + "node": ">= 10.0.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0", + "@types/babel__core": "^7.1.9", + "rollup": "^1.20.0||^2.0.0" + }, + "peerDependenciesMeta": { + "@types/babel__core": { + "optional": true + } + } + }, + "node_modules/workbox-build/node_modules/@rollup/plugin-replace": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/@rollup/plugin-replace/-/plugin-replace-2.4.2.tgz", + "integrity": "sha512-IGcu+cydlUMZ5En85jxHH4qj2hta/11BHq95iHEyb2sbgiN0eCdzvUcHw5gt9pBL5lTi4JDYJ1acCoMGpTvEZg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@rollup/pluginutils": "^3.1.0", + "magic-string": "^0.25.7" + }, + "peerDependencies": { + "rollup": "^1.20.0 || ^2.0.0" + } + }, + "node_modules/workbox-build/node_modules/@rollup/pluginutils": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-3.1.0.tgz", + "integrity": "sha512-GksZ6pr6TpIjHm8h9lSQ8pi8BE9VeubNT0OMJ3B5uZJ8pz73NPiqOtCog/x2/QzM1ENChPKxMDhiQuRHsqc+lg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "0.0.39", + "estree-walker": "^1.0.1", + "picomatch": "^2.2.2" + }, + "engines": { + "node": ">= 8.0.0" + }, + "peerDependencies": { + "rollup": "^1.20.0||^2.0.0" + } + }, + "node_modules/workbox-build/node_modules/@types/estree": { + "version": "0.0.39", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-0.0.39.tgz", + "integrity": "sha512-EYNwp3bU+98cpU4lAWYYL7Zz+2gryWH1qbdDTidVd6hkiR6weksdbMadyXKXNPEkQFhXM+hVO9ZygomHXp+AIw==", + "dev": true, + "license": "MIT" + }, + "node_modules/workbox-build/node_modules/ajv": { + "version": "8.17.1", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz", + "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==", + "dev": true, + "license": "MIT", + "peer": true, + "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/workbox-build/node_modules/estree-walker": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-1.0.1.tgz", + "integrity": "sha512-1fMXF3YP4pZZVozF8j/ZLfvnR8NSIljt56UhbZ5PeeDmmGHpgpdwQt7ITlGvYaQukCvuBRMLEiKiYC+oeIg4cg==", + "dev": true, + "license": "MIT" + }, + "node_modules/workbox-build/node_modules/glob": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/glob/-/glob-11.1.0.tgz", + "integrity": "sha512-vuNwKSaKiqm7g0THUBu2x7ckSs3XJLXE+2ssL7/MfTGPLLcrJQ/4Uq1CjPTtO5cCIiRxqvN6Twy1qOwhL0Xjcw==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "foreground-child": "^3.3.1", + "jackspeak": "^4.1.1", + "minimatch": "^10.1.1", + "minipass": "^7.1.2", + "package-json-from-dist": "^1.0.0", + "path-scurry": "^2.0.0" + }, + "bin": { + "glob": "dist/esm/bin.mjs" + }, + "engines": { + "node": "20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/workbox-build/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==", + "dev": true, + "license": "MIT" + }, + "node_modules/workbox-build/node_modules/minimatch": { + "version": "10.1.1", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.1.1.tgz", + "integrity": "sha512-enIvLvRAFZYXJzkCYG5RKmPfrFArdLv+R+lbQ53BmIMLIry74bjKzX6iHAm8WYamJkhSSEabrWN5D97XnKObjQ==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "@isaacs/brace-expansion": "^5.0.0" + }, + "engines": { + "node": "20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/workbox-build/node_modules/pretty-bytes": { + "version": "5.6.0", + "resolved": "https://registry.npmjs.org/pretty-bytes/-/pretty-bytes-5.6.0.tgz", + "integrity": "sha512-FFw039TmrBqFK8ma/7OL3sDz/VytdtJr044/QUJtH0wK9lb9jLq9tJyIxUwtQJHwar2BqtiA4iCWSwo9JLkzFg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/workbox-build/node_modules/rollup": { + "version": "2.79.2", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-2.79.2.tgz", + "integrity": "sha512-fS6iqSPZDs3dr/y7Od6y5nha8dW1YnbgtsyotCVvoFGKbERG++CVRFv1meyGDE1SNItQA8BrnCw7ScdAhRJ3XQ==", + "dev": true, + "license": "MIT", + "peer": true, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=10.0.0" + }, + "optionalDependencies": { + "fsevents": "~2.3.2" + } + }, + "node_modules/workbox-cacheable-response": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-cacheable-response/-/workbox-cacheable-response-7.4.0.tgz", + "integrity": "sha512-0Fb8795zg/x23ISFkAc7lbWes6vbw34DGFIMw31cwuHPgDEC/5EYm6m/ZkylLX0EnEbbOyOCLjKgFS/Z5g0HeQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "workbox-core": "7.4.0" + } + }, + "node_modules/workbox-core": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-core/-/workbox-core-7.4.0.tgz", + "integrity": "sha512-6BMfd8tYEnN4baG4emG9U0hdXM4gGuDU3ectXuVHnj71vwxTFI7WOpQJC4siTOlVtGqCUtj0ZQNsrvi6kZZTAQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/workbox-expiration": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-expiration/-/workbox-expiration-7.4.0.tgz", + "integrity": "sha512-V50p4BxYhtA80eOvulu8xVfPBgZbkxJ1Jr8UUn0rvqjGhLDqKNtfrDfjJKnLz2U8fO2xGQJTx/SKXNTzHOjnHw==", + "dev": true, + "license": "MIT", + "dependencies": { + "idb": "^7.0.1", + "workbox-core": "7.4.0" + } + }, + "node_modules/workbox-google-analytics": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-google-analytics/-/workbox-google-analytics-7.4.0.tgz", + "integrity": "sha512-MVPXQslRF6YHkzGoFw1A4GIB8GrKym/A5+jYDUSL+AeJw4ytQGrozYdiZqUW1TPQHW8isBCBtyFJergUXyNoWQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "workbox-background-sync": "7.4.0", + "workbox-core": "7.4.0", + "workbox-routing": "7.4.0", + "workbox-strategies": "7.4.0" + } + }, + "node_modules/workbox-navigation-preload": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-navigation-preload/-/workbox-navigation-preload-7.4.0.tgz", + "integrity": "sha512-etzftSgdQfjMcfPgbfaZCfM2QuR1P+4o8uCA2s4rf3chtKTq/Om7g/qvEOcZkG6v7JZOSOxVYQiOu6PbAZgU6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "workbox-core": "7.4.0" + } + }, + "node_modules/workbox-precaching": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-precaching/-/workbox-precaching-7.4.0.tgz", + "integrity": "sha512-VQs37T6jDqf1rTxUJZXRl3yjZMf5JX/vDPhmx2CPgDDKXATzEoqyRqhYnRoxl6Kr0rqaQlp32i9rtG5zTzIlNg==", + "dev": true, + "license": "MIT", + "dependencies": { + "workbox-core": "7.4.0", + "workbox-routing": "7.4.0", + "workbox-strategies": "7.4.0" + } + }, + "node_modules/workbox-range-requests": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-range-requests/-/workbox-range-requests-7.4.0.tgz", + "integrity": "sha512-3Vq854ZNuP6Y0KZOQWLaLC9FfM7ZaE+iuQl4VhADXybwzr4z/sMmnLgTeUZLq5PaDlcJBxYXQ3U91V7dwAIfvw==", + "dev": true, + "license": "MIT", + "dependencies": { + "workbox-core": "7.4.0" + } + }, + "node_modules/workbox-recipes": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-recipes/-/workbox-recipes-7.4.0.tgz", + "integrity": "sha512-kOkWvsAn4H8GvAkwfJTbwINdv4voFoiE9hbezgB1sb/0NLyTG4rE7l6LvS8lLk5QIRIto+DjXLuAuG3Vmt3cxQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "workbox-cacheable-response": "7.4.0", + "workbox-core": "7.4.0", + "workbox-expiration": "7.4.0", + "workbox-precaching": "7.4.0", + "workbox-routing": "7.4.0", + "workbox-strategies": "7.4.0" + } + }, + "node_modules/workbox-routing": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-routing/-/workbox-routing-7.4.0.tgz", + "integrity": "sha512-C/ooj5uBWYAhAqwmU8HYQJdOjjDKBp9MzTQ+otpMmd+q0eF59K+NuXUek34wbL0RFrIXe/KKT+tUWcZcBqxbHQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "workbox-core": "7.4.0" + } + }, + "node_modules/workbox-strategies": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-strategies/-/workbox-strategies-7.4.0.tgz", + "integrity": "sha512-T4hVqIi5A4mHi92+5EppMX3cLaVywDp8nsyUgJhOZxcfSV/eQofcOA6/EMo5rnTNmNTpw0rUgjAI6LaVullPpg==", + "dev": true, + "license": "MIT", + "dependencies": { + "workbox-core": "7.4.0" + } + }, + "node_modules/workbox-streams": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-streams/-/workbox-streams-7.4.0.tgz", + "integrity": "sha512-QHPBQrey7hQbnTs5GrEVoWz7RhHJXnPT+12qqWM378orDMo5VMJLCkCM1cnCk+8Eq92lccx/VgRZ7WAzZWbSLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "workbox-core": "7.4.0", + "workbox-routing": "7.4.0" + } + }, + "node_modules/workbox-sw": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-sw/-/workbox-sw-7.4.0.tgz", + "integrity": "sha512-ltU+Kr3qWR6BtbdlMnCjobZKzeV1hN+S6UvDywBrwM19TTyqA03X66dzw1tEIdJvQ4lYKkBFox6IAEhoSEZ8Xw==", + "dev": true, + "license": "MIT" + }, + "node_modules/workbox-window": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/workbox-window/-/workbox-window-7.4.0.tgz", + "integrity": "sha512-/bIYdBLAVsNR3v7gYGaV4pQW3M3kEPx5E8vDxGvxo6khTrGtSSCS7QiFKv9ogzBgZiy0OXLP9zO28U/1nF1mfw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/trusted-types": "^2.0.2", + "workbox-core": "7.4.0" + } + }, + "node_modules/wrap-ansi": { + "version": "8.1.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz", + "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.1.0", + "string-width": "^5.0.1", + "strip-ansi": "^7.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/wrap-ansi-cjs": { + "name": "wrap-ansi", + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/wrap-ansi-cjs/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/wrap-ansi-cjs/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/wrap-ansi/node_modules/ansi-regex": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz", + "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/strip-ansi": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.2.tgz", + "integrity": "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "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==", + "dev": true, + "license": "ISC" + }, + "node_modules/yallist": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz", + "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==", + "dev": true, + "license": "ISC" + }, + "node_modules/yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/zustand": { + "version": "4.5.7", + "resolved": "https://registry.npmjs.org/zustand/-/zustand-4.5.7.tgz", + "integrity": "sha512-CHOUy7mu3lbD6o6LJLfllpjkzhHXSBlX8B9+qPddUsIfeF5S/UZ5q0kmCsnRqT1UHFQZchNFDDzMbQsuesHWlw==", + "license": "MIT", + "dependencies": { + "use-sync-external-store": "^1.2.2" + }, + "engines": { + "node": ">=12.7.0" + }, + "peerDependencies": { + "@types/react": ">=16.8", + "immer": ">=9.0.6", + "react": ">=16.8" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + }, + "immer": { + "optional": true + }, + "react": { + "optional": true + } + } + } + } +} diff --git a/apps/products/pos-micro/frontend/package.json b/apps/products/pos-micro/frontend/package.json new file mode 100644 index 0000000..c3c674c --- /dev/null +++ b/apps/products/pos-micro/frontend/package.json @@ -0,0 +1,40 @@ +{ + "name": "pos-micro-frontend", + "private": true, + "version": "1.0.0", + "type": "module", + "scripts": { + "dev": "vite", + "build": "tsc && vite build", + "preview": "vite preview", + "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0", + "typecheck": "tsc --noEmit" + }, + "dependencies": { + "react": "^18.2.0", + "react-dom": "^18.2.0", + "react-router-dom": "^6.20.0", + "zustand": "^4.4.7", + "@tanstack/react-query": "^5.8.4", + "axios": "^1.6.2", + "lucide-react": "^0.294.0", + "clsx": "^2.0.0" + }, + "devDependencies": { + "@types/react": "^18.2.37", + "@types/react-dom": "^18.2.15", + "@typescript-eslint/eslint-plugin": "^6.10.0", + "@typescript-eslint/parser": "^6.10.0", + "@vitejs/plugin-react": "^4.2.0", + "autoprefixer": "^10.4.16", + "eslint": "^8.53.0", + "eslint-plugin-react-hooks": "^4.6.0", + "eslint-plugin-react-refresh": "^0.4.4", + "postcss": "^8.4.31", + "tailwindcss": "^3.3.5", + "typescript": "^5.2.2", + "vite": "^5.0.0", + "vite-plugin-pwa": "^0.17.4", + "workbox-window": "^7.0.0" + } +} diff --git a/apps/products/pos-micro/frontend/postcss.config.js b/apps/products/pos-micro/frontend/postcss.config.js new file mode 100644 index 0000000..2aa7205 --- /dev/null +++ b/apps/products/pos-micro/frontend/postcss.config.js @@ -0,0 +1,6 @@ +export default { + plugins: { + tailwindcss: {}, + autoprefixer: {}, + }, +}; diff --git a/apps/products/pos-micro/frontend/src/App.tsx b/apps/products/pos-micro/frontend/src/App.tsx new file mode 100644 index 0000000..1815871 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/App.tsx @@ -0,0 +1,62 @@ +import { Routes, Route, Navigate } from 'react-router-dom'; +import { useAuthStore } from '@/store/auth'; +import { POSPage } from '@/pages/POSPage'; +import { LoginPage } from '@/pages/LoginPage'; +import { ReportsPage } from '@/pages/ReportsPage'; + +function ProtectedRoute({ children }: { children: React.ReactNode }) { + const isAuthenticated = useAuthStore((state) => state.isAuthenticated); + + if (!isAuthenticated) { + return ; + } + + return <>{children}; +} + +function PublicRoute({ children }: { children: React.ReactNode }) { + const isAuthenticated = useAuthStore((state) => state.isAuthenticated); + + if (isAuthenticated) { + return ; + } + + return <>{children}; +} + +export default function App() { + return ( + + {/* Public routes */} + + + + } + /> + + {/* Protected routes */} + + + + } + /> + + + + } + /> + + {/* Fallback */} + } /> + + ); +} diff --git a/apps/products/pos-micro/frontend/src/components/CartPanel.tsx b/apps/products/pos-micro/frontend/src/components/CartPanel.tsx new file mode 100644 index 0000000..8eb26a8 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/components/CartPanel.tsx @@ -0,0 +1,103 @@ +import { Minus, Plus, Trash2, ShoppingCart } from 'lucide-react'; +import { useCartStore } from '@/store/cart'; +import type { CartItem } from '@/types'; + +interface CartPanelProps { + onCheckout: () => void; +} + +export function CartPanel({ onCheckout }: CartPanelProps) { + const { items, total, itemCount, updateQuantity, removeItem } = useCartStore(); + + if (items.length === 0) { + return ( +
+ +

Carrito vacio

+

Selecciona productos para agregar

+
+ ); + } + + return ( +
+ {/* Cart items */} +
+ {items.map((item) => ( + updateQuantity(item.product.id, qty)} + onRemove={() => removeItem(item.product.id)} + /> + ))} +
+ + {/* Cart summary */} +
+
+ Total ({itemCount} productos) + ${total.toFixed(2)} +
+ + +
+
+ ); +} + +interface CartItemRowProps { + item: CartItem; + onUpdateQuantity: (quantity: number) => void; + onRemove: () => void; +} + +function CartItemRow({ item, onUpdateQuantity, onRemove }: CartItemRowProps) { + return ( +
+
+

{item.product.name}

+

+ ${item.unitPrice.toFixed(2)} c/u +

+
+ +
+ {/* Quantity controls */} + + + {item.quantity} + + + + {/* Subtotal */} + + ${item.subtotal.toFixed(2)} + + + {/* Remove button */} + +
+
+ ); +} diff --git a/apps/products/pos-micro/frontend/src/components/CategoryTabs.tsx b/apps/products/pos-micro/frontend/src/components/CategoryTabs.tsx new file mode 100644 index 0000000..9b2d8a7 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/components/CategoryTabs.tsx @@ -0,0 +1,58 @@ +import clsx from 'clsx'; +import type { Category } from '@/types'; + +interface CategoryTabsProps { + categories: Category[]; + selectedCategoryId: string | null; + onSelect: (categoryId: string | null) => void; +} + +export function CategoryTabs({ categories, selectedCategoryId, onSelect }: CategoryTabsProps) { + return ( +
+ + + + + {categories.map((category) => ( + + ))} +
+ ); +} diff --git a/apps/products/pos-micro/frontend/src/components/CheckoutModal.tsx b/apps/products/pos-micro/frontend/src/components/CheckoutModal.tsx new file mode 100644 index 0000000..9e1da78 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/components/CheckoutModal.tsx @@ -0,0 +1,306 @@ +import { useState } from 'react'; +import { X, CreditCard, Banknote, Smartphone, Check } from 'lucide-react'; +import clsx from 'clsx'; +import { useCartStore } from '@/store/cart'; +import { usePaymentMethods } from '@/hooks/usePayments'; +import { useCreateSale } from '@/hooks/useSales'; +import type { PaymentMethod, Sale } from '@/types'; + +interface CheckoutModalProps { + isOpen: boolean; + onClose: () => void; + onSuccess: (sale: Sale) => void; +} + +const QUICK_AMOUNTS = [20, 50, 100, 200, 500]; + +export function CheckoutModal({ isOpen, onClose, onSuccess }: CheckoutModalProps) { + const { items, total, paymentMethod, setPaymentMethod, amountReceived, setAmountReceived } = useCartStore(); + const { data: paymentMethods } = usePaymentMethods(); + const createSale = useCreateSale(); + + const [step, setStep] = useState<'payment' | 'amount' | 'confirm'>('payment'); + + const change = paymentMethod?.type === 'cash' ? Math.max(0, amountReceived - total) : 0; + + const handleSelectPayment = (method: PaymentMethod) => { + setPaymentMethod(method); + if (method.type === 'cash') { + setStep('amount'); + } else { + setStep('confirm'); + } + }; + + const handleConfirm = async () => { + if (!paymentMethod) return; + + try { + // Payload that matches backend CreateSaleDto + const sale = await createSale.mutateAsync({ + items: items.map((item) => ({ + productId: item.product.id, + quantity: item.quantity, + discountPercent: item.discountPercent || 0, + })), + paymentMethodId: paymentMethod.id, + amountReceived: paymentMethod.type === 'cash' ? amountReceived : total, + }); + + onSuccess(sale); + setStep('payment'); + setAmountReceived(0); + } catch (error) { + console.error('Error creating sale:', error); + } + }; + + const handleClose = () => { + setStep('payment'); + setAmountReceived(0); + onClose(); + }; + + if (!isOpen) return null; + + return ( +
+ {/* Backdrop */} +
+ + {/* Modal */} +
+ {/* Header */} +
+

Cobrar

+ +
+ + {/* Total */} +
+

Total a cobrar

+

${total.toFixed(2)}

+
+ + {/* Content */} +
+ {step === 'payment' && ( + + )} + + {step === 'amount' && ( + setStep('payment')} + onConfirm={() => setStep('confirm')} + /> + )} + + {step === 'confirm' && ( + setStep(paymentMethod?.type === 'cash' ? 'amount' : 'payment')} + onConfirm={handleConfirm} + /> + )} +
+
+
+ ); +} + +interface PaymentStepProps { + paymentMethods: PaymentMethod[]; + onSelect: (method: PaymentMethod) => void; +} + +function PaymentStep({ paymentMethods, onSelect }: PaymentStepProps) { + const getIcon = (type: string) => { + switch (type) { + case 'cash': + return Banknote; + case 'card': + return CreditCard; + case 'transfer': + return Smartphone; + default: + return Banknote; + } + }; + + return ( +
+

Selecciona forma de pago

+ {paymentMethods.map((method) => { + const Icon = getIcon(method.type); + return ( + + ); + })} +
+ ); +} + +interface AmountStepProps { + total: number; + amountReceived: number; + onAmountChange: (amount: number) => void; + onBack: () => void; + onConfirm: () => void; +} + +function AmountStep({ total, amountReceived, onAmountChange, onBack, onConfirm }: AmountStepProps) { + return ( +
+

Cantidad recibida

+ + {/* Input */} + onAmountChange(Number(e.target.value))} + placeholder="0.00" + autoFocus + /> + + {/* Quick amounts */} +
+ {QUICK_AMOUNTS.map((amount) => ( + + ))} +
+ + {/* Exact amount button */} + + + {/* Change preview */} + {amountReceived >= total && ( +
+

Cambio

+

+ ${(amountReceived - total).toFixed(2)} +

+
+ )} + + {/* Actions */} +
+ + +
+
+ ); +} + +interface ConfirmStepProps { + total: number; + paymentMethod: PaymentMethod; + amountReceived: number; + change: number; + isLoading: boolean; + onBack: () => void; + onConfirm: () => void; +} + +function ConfirmStep({ + total, + paymentMethod, + amountReceived, + change, + isLoading, + onBack, + onConfirm, +}: ConfirmStepProps) { + return ( +
+
+
+ Metodo de pago + {paymentMethod.name} +
+
+ Total + ${total.toFixed(2)} +
+ {paymentMethod.type === 'cash' && ( + <> +
+ Recibido + ${amountReceived.toFixed(2)} +
+
+ Cambio + ${change.toFixed(2)} +
+ + )} +
+ +
+ + +
+
+ ); +} diff --git a/apps/products/pos-micro/frontend/src/components/Header.tsx b/apps/products/pos-micro/frontend/src/components/Header.tsx new file mode 100644 index 0000000..e1ef78c --- /dev/null +++ b/apps/products/pos-micro/frontend/src/components/Header.tsx @@ -0,0 +1,102 @@ +import { Menu, BarChart3, Package, Settings, LogOut } from 'lucide-react'; +import { useState } from 'react'; +import { Link, useNavigate } from 'react-router-dom'; +import { useAuthStore } from '@/store/auth'; + +export function Header() { + const [isMenuOpen, setIsMenuOpen] = useState(false); + const { tenant, logout } = useAuthStore(); + const navigate = useNavigate(); + + const handleLogout = () => { + logout(); + navigate('/login'); + }; + + return ( + <> +
+
+ +
+

POS Micro

+

{tenant?.businessName}

+
+
+
+ + {/* Mobile menu overlay */} + {isMenuOpen && ( +
+
setIsMenuOpen(false)} + /> + +
+ )} + + ); +} + +interface NavLinkProps { + to: string; + icon: React.ReactNode; + label: string; + onClick: () => void; +} + +function NavLink({ to, icon, label, onClick }: NavLinkProps) { + return ( + + {icon} + {label} + + ); +} diff --git a/apps/products/pos-micro/frontend/src/components/ProductCard.tsx b/apps/products/pos-micro/frontend/src/components/ProductCard.tsx new file mode 100644 index 0000000..0d29f90 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/components/ProductCard.tsx @@ -0,0 +1,77 @@ +import { Star } from 'lucide-react'; +import clsx from 'clsx'; +import type { Product } from '@/types'; + +interface ProductCardProps { + product: Product; + onSelect: (product: Product) => void; + onToggleFavorite?: (productId: string) => void; +} + +export function ProductCard({ product, onSelect, onToggleFavorite }: ProductCardProps) { + const isLowStock = product.trackStock && product.stockQuantity <= product.lowStockAlert; + const isOutOfStock = product.trackStock && product.stockQuantity <= 0; + + return ( +
!isOutOfStock && onSelect(product)} + > + {/* Favorite button */} + {onToggleFavorite && ( + + )} + + {/* Product image or placeholder */} + {product.imageUrl ? ( + {product.name} + ) : ( +
+ + {product.name.charAt(0).toUpperCase()} + +
+ )} + + {/* Product info */} +

+ {product.name} +

+

+ ${product.price.toFixed(2)} +

+ + {/* Stock indicator */} + {product.trackStock && ( +

+ {isOutOfStock ? 'Agotado' : `${product.stockQuantity} disponibles`} +

+ )} +
+ ); +} diff --git a/apps/products/pos-micro/frontend/src/components/SuccessModal.tsx b/apps/products/pos-micro/frontend/src/components/SuccessModal.tsx new file mode 100644 index 0000000..ca59e92 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/components/SuccessModal.tsx @@ -0,0 +1,114 @@ +import { CheckCircle, Printer, Share2, X } from 'lucide-react'; +import type { Sale } from '@/types'; + +interface SuccessModalProps { + isOpen: boolean; + sale: Sale | null; + onClose: () => void; +} + +export function SuccessModal({ isOpen, sale, onClose }: SuccessModalProps) { + if (!isOpen || !sale) return null; + + const handlePrint = () => { + // In a real app, this would trigger receipt printing + window.print(); + }; + + const handleShare = async () => { + const text = `Venta #${sale.ticketNumber}\nTotal: $${sale.total.toFixed(2)}\nGracias por su compra!`; + + if (navigator.share) { + try { + await navigator.share({ text }); + } catch { + // User cancelled or error + } + } else { + // Fallback: copy to clipboard + await navigator.clipboard.writeText(text); + } + }; + + return ( +
+ {/* Backdrop */} +
+ + {/* Modal */} +
+ {/* Close button */} + + + {/* Success icon */} +
+
+ +
+
+ + {/* Content */} +
+

Venta completada!

+

Ticket #{sale.ticketNumber}

+ +
+
+ Subtotal + ${sale.subtotal.toFixed(2)} +
+ {sale.discountAmount > 0 && ( +
+ Descuento + -${sale.discountAmount.toFixed(2)} +
+ )} +
+ Total + ${sale.total.toFixed(2)} +
+ {sale.changeAmount > 0 && ( +
+ Cambio + ${sale.changeAmount.toFixed(2)} +
+ )} +
+ + {/* Actions */} +
+ + +
+ + +
+
+
+ ); +} diff --git a/apps/products/pos-micro/frontend/src/hooks/usePayments.ts b/apps/products/pos-micro/frontend/src/hooks/usePayments.ts new file mode 100644 index 0000000..d829855 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/hooks/usePayments.ts @@ -0,0 +1,14 @@ +import { useQuery } from '@tanstack/react-query'; +import api from '@/services/api'; +import type { PaymentMethod } from '@/types'; + +export function usePaymentMethods() { + return useQuery({ + queryKey: ['payment-methods'], + queryFn: async () => { + const { data } = await api.get('/payments/methods'); + return data; + }, + staleTime: 1000 * 60 * 30, // 30 minutes - payment methods don't change often + }); +} diff --git a/apps/products/pos-micro/frontend/src/hooks/useProducts.ts b/apps/products/pos-micro/frontend/src/hooks/useProducts.ts new file mode 100644 index 0000000..ff3b94f --- /dev/null +++ b/apps/products/pos-micro/frontend/src/hooks/useProducts.ts @@ -0,0 +1,70 @@ +import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'; +import api from '@/services/api'; +import type { Product, Category } from '@/types'; + +// Products - matches backend ProductsController +export function useProducts(categoryId?: string) { + return useQuery({ + queryKey: ['products', categoryId], + queryFn: async () => { + const params = new URLSearchParams(); + if (categoryId) params.append('categoryId', categoryId); + params.append('isActive', 'true'); + + const { data } = await api.get(`/products?${params}`); + return data; + }, + }); +} + +export function useFavoriteProducts() { + return useQuery({ + queryKey: ['products', 'favorites'], + queryFn: async () => { + // Backend: GET /products?isFavorite=true + const { data } = await api.get('/products?isFavorite=true&isActive=true'); + return data; + }, + }); +} + +export function useSearchProduct() { + const queryClient = useQueryClient(); + + return useMutation({ + mutationFn: async (barcode: string) => { + // Backend: GET /products/barcode/:barcode + const { data } = await api.get(`/products/barcode/${barcode}`); + return data; + }, + onSuccess: (product) => { + queryClient.setQueryData(['product', product.id], product); + }, + }); +} + +export function useToggleFavorite() { + const queryClient = useQueryClient(); + + return useMutation({ + mutationFn: async (productId: string) => { + // Backend: PATCH /products/:id/toggle-favorite + const { data } = await api.patch(`/products/${productId}/toggle-favorite`); + return data; + }, + onSuccess: () => { + queryClient.invalidateQueries({ queryKey: ['products'] }); + }, + }); +} + +// Categories - matches backend CategoriesController +export function useCategories() { + return useQuery({ + queryKey: ['categories'], + queryFn: async () => { + const { data } = await api.get('/categories'); + return data; + }, + }); +} diff --git a/apps/products/pos-micro/frontend/src/hooks/useSales.ts b/apps/products/pos-micro/frontend/src/hooks/useSales.ts new file mode 100644 index 0000000..7d918f7 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/hooks/useSales.ts @@ -0,0 +1,84 @@ +import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'; +import api from '@/services/api'; +import { useCartStore } from '@/store/cart'; +import type { Sale } from '@/types'; + +// DTO que coincide con backend CreateSaleDto +interface CreateSaleDto { + items: { + productId: string; + quantity: number; + discountPercent?: number; + }[]; + paymentMethodId: string; + amountReceived: number; + customerName?: string; + customerPhone?: string; + notes?: string; +} + +// Response del backend para summary +interface TodaySummary { + totalSales: number; + totalRevenue: number; + totalTax: number; + avgTicket: number; +} + +export function useCreateSale() { + const queryClient = useQueryClient(); + const clearCart = useCartStore((state) => state.clear); + + return useMutation({ + mutationFn: async (sale: CreateSaleDto) => { + // Backend: POST /sales + const { data } = await api.post('/sales', sale); + return data; + }, + onSuccess: () => { + clearCart(); + queryClient.invalidateQueries({ queryKey: ['sales'] }); + queryClient.invalidateQueries({ queryKey: ['daily-summary'] }); + queryClient.invalidateQueries({ queryKey: ['products'] }); // Stock updated + }, + }); +} + +export function useTodaySales() { + return useQuery({ + queryKey: ['sales', 'today'], + queryFn: async () => { + // Backend: GET /sales/recent?limit=50 + const { data } = await api.get('/sales/recent?limit=50'); + return data; + }, + }); +} + +export function useDailySummary() { + return useQuery({ + queryKey: ['daily-summary'], + queryFn: async () => { + // Backend: GET /sales/today + const { data } = await api.get('/sales/today'); + return data; + }, + }); +} + +export function useCancelSale() { + const queryClient = useQueryClient(); + + return useMutation({ + mutationFn: async ({ saleId, reason }: { saleId: string; reason?: string }) => { + // Backend: POST /sales/:id/cancel + const { data } = await api.post(`/sales/${saleId}/cancel`, { reason }); + return data; + }, + onSuccess: () => { + queryClient.invalidateQueries({ queryKey: ['sales'] }); + queryClient.invalidateQueries({ queryKey: ['daily-summary'] }); + queryClient.invalidateQueries({ queryKey: ['products'] }); // Stock restored + }, + }); +} diff --git a/apps/products/pos-micro/frontend/src/main.tsx b/apps/products/pos-micro/frontend/src/main.tsx new file mode 100644 index 0000000..321d557 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/main.tsx @@ -0,0 +1,25 @@ +import React from 'react'; +import ReactDOM from 'react-dom/client'; +import { QueryClient, QueryClientProvider } from '@tanstack/react-query'; +import { BrowserRouter } from 'react-router-dom'; +import App from './App'; +import './styles/index.css'; + +const queryClient = new QueryClient({ + defaultOptions: { + queries: { + staleTime: 1000 * 60 * 5, // 5 minutes + retry: 1, + }, + }, +}); + +ReactDOM.createRoot(document.getElementById('root')!).render( + + + + + + + +); diff --git a/apps/products/pos-micro/frontend/src/pages/LoginPage.tsx b/apps/products/pos-micro/frontend/src/pages/LoginPage.tsx new file mode 100644 index 0000000..a4ed8cf --- /dev/null +++ b/apps/products/pos-micro/frontend/src/pages/LoginPage.tsx @@ -0,0 +1,183 @@ +import { useState } from 'react'; +import { useNavigate } from 'react-router-dom'; +import { ShoppingBag, Eye, EyeOff } from 'lucide-react'; +import api from '@/services/api'; +import { useAuthStore } from '@/store/auth'; +import type { AuthResponse } from '@/types'; + +export function LoginPage() { + // Campos compartidos + const [phone, setPhone] = useState(''); + const [pin, setPin] = useState(''); + const [showPin, setShowPin] = useState(false); + const [isLoading, setIsLoading] = useState(false); + const [error, setError] = useState(''); + const [isRegister, setIsRegister] = useState(false); + + // Campos solo para registro + const [businessName, setBusinessName] = useState(''); + const [ownerName, setOwnerName] = useState(''); + + const login = useAuthStore((state) => state.login); + const navigate = useNavigate(); + + const handleSubmit = async (e: React.FormEvent) => { + e.preventDefault(); + setError(''); + setIsLoading(true); + + try { + const endpoint = isRegister ? '/auth/register' : '/auth/login'; + const payload = isRegister + ? { businessName, ownerName, phone, pin } + : { phone, pin }; + + const { data } = await api.post(endpoint, payload); + + login(data.accessToken, data.refreshToken, data.user, data.tenant); + navigate('/'); + } catch (err: unknown) { + const errorMessage = + err instanceof Error + ? err.message + : (err as { response?: { data?: { message?: string } } })?.response?.data?.message || + (isRegister ? 'Error al registrar negocio' : 'Telefono o PIN incorrecto'); + setError(errorMessage); + } finally { + setIsLoading(false); + } + }; + + return ( +
+ {/* Logo */} +
+
+ +
+

POS Micro

+

Punto de venta simple

+
+ + {/* Login Card */} +
+

+ {isRegister ? 'Registrar negocio' : 'Iniciar sesion'} +

+ +
+ {isRegister && ( + <> +
+ + setBusinessName(e.target.value)} + required + /> +
+ +
+ + setOwnerName(e.target.value)} + required + /> +
+ + )} + +
+ + setPhone(e.target.value.replace(/\D/g, '').slice(0, 10))} + required + minLength={10} + maxLength={10} + inputMode="numeric" + pattern="[0-9]*" + /> +
+ +
+ +
+ setPin(e.target.value.replace(/\D/g, '').slice(0, 6))} + required + minLength={4} + maxLength={6} + inputMode="numeric" + pattern="[0-9]*" + /> + +
+
+ + {error && ( +
+ {error} +
+ )} + + +
+ +
+ +
+
+ + {/* Footer */} +

+ $100 MXN/mes - Cancela cuando quieras +

+
+ ); +} diff --git a/apps/products/pos-micro/frontend/src/pages/POSPage.tsx b/apps/products/pos-micro/frontend/src/pages/POSPage.tsx new file mode 100644 index 0000000..1af9414 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/pages/POSPage.tsx @@ -0,0 +1,154 @@ +import { useState } from 'react'; +import { Search } from 'lucide-react'; +import { Header } from '@/components/Header'; +import { ProductCard } from '@/components/ProductCard'; +import { CartPanel } from '@/components/CartPanel'; +import { CategoryTabs } from '@/components/CategoryTabs'; +import { CheckoutModal } from '@/components/CheckoutModal'; +import { SuccessModal } from '@/components/SuccessModal'; +import { useProducts, useFavoriteProducts, useCategories, useToggleFavorite, useSearchProduct } from '@/hooks/useProducts'; +import { useCartStore } from '@/store/cart'; +import type { Product, Sale } from '@/types'; + +export function POSPage() { + const [selectedCategory, setSelectedCategory] = useState(null); + const [searchQuery, setSearchQuery] = useState(''); + const [isCheckoutOpen, setIsCheckoutOpen] = useState(false); + const [completedSale, setCompletedSale] = useState(null); + + const { data: categories } = useCategories(); + const { data: products, isLoading: productsLoading } = useProducts( + selectedCategory && selectedCategory !== 'favorites' ? selectedCategory : undefined + ); + const { data: favorites } = useFavoriteProducts(); + const toggleFavorite = useToggleFavorite(); + const searchProduct = useSearchProduct(); + const addItem = useCartStore((state) => state.addItem); + + const displayProducts = selectedCategory === 'favorites' ? favorites : products; + + const filteredProducts = displayProducts?.filter((product) => + product.name.toLowerCase().includes(searchQuery.toLowerCase()) || + product.barcode?.includes(searchQuery) + ); + + const handleSelectProduct = (product: Product) => { + addItem(product); + }; + + const handleBarcodeSearch = async (e: React.FormEvent) => { + e.preventDefault(); + if (!searchQuery) return; + + try { + const product = await searchProduct.mutateAsync(searchQuery); + if (product) { + addItem(product); + setSearchQuery(''); + } + } catch { + // Product not found - will show filtered list instead + } + }; + + const handleCheckoutSuccess = (sale: Sale) => { + setIsCheckoutOpen(false); + setCompletedSale(sale); + }; + + return ( +
+
+ +
+ {/* Products Panel */} +
+ {/* Search bar */} +
+
+ + setSearchQuery(e.target.value)} + /> +
+
+ + {/* Category tabs */} + + + {/* Products grid */} +
+ {productsLoading ? ( +
+
+
+ ) : filteredProducts?.length === 0 ? ( +
+ +

No se encontraron productos

+
+ ) : ( +
+ {filteredProducts?.map((product) => ( + toggleFavorite.mutate(product.id)} + /> + ))} +
+ )} +
+
+ + {/* Cart Panel - Hidden on mobile, shown on larger screens */} +
+ setIsCheckoutOpen(true)} /> +
+
+ + {/* Mobile Cart Button */} + setIsCheckoutOpen(true)} /> + + {/* Checkout Modal */} + setIsCheckoutOpen(false)} + onSuccess={handleCheckoutSuccess} + /> + + {/* Success Modal */} + setCompletedSale(null)} + /> +
+ ); +} + +function MobileCartButton({ onCheckout }: { onCheckout: () => void }) { + const { itemCount, total } = useCartStore(); + + if (itemCount === 0) return null; + + return ( +
+ +
+ ); +} + +// Import for the empty state +import { Package } from 'lucide-react'; diff --git a/apps/products/pos-micro/frontend/src/pages/ReportsPage.tsx b/apps/products/pos-micro/frontend/src/pages/ReportsPage.tsx new file mode 100644 index 0000000..23d7a95 --- /dev/null +++ b/apps/products/pos-micro/frontend/src/pages/ReportsPage.tsx @@ -0,0 +1,115 @@ +import { ArrowLeft, TrendingUp, ShoppingCart, DollarSign, Receipt } from 'lucide-react'; +import { Link } from 'react-router-dom'; +import { useDailySummary, useTodaySales } from '@/hooks/useSales'; + +export function ReportsPage() { + const { data: summary, isLoading: summaryLoading } = useDailySummary(); + const { data: sales, isLoading: salesLoading } = useTodaySales(); + + const isLoading = summaryLoading || salesLoading; + + return ( +
+ {/* Header */} +
+ + + +

Reporte del dia

+
+ + {isLoading ? ( +
+
+
+ ) : ( +
+ {/* Summary Cards - aligned with backend TodaySummary */} +
+ } + label="Ingresos" + value={`$${summary?.totalRevenue?.toFixed(2) || '0.00'}`} + bgColor="bg-green-50" + /> + } + label="Ventas" + value={summary?.totalSales?.toString() || '0'} + bgColor="bg-blue-50" + /> + } + label="IVA recaudado" + value={`$${summary?.totalTax?.toFixed(2) || '0.00'}`} + bgColor="bg-yellow-50" + /> + } + label="Ticket promedio" + value={`$${summary?.avgTicket?.toFixed(2) || '0.00'}`} + bgColor="bg-purple-50" + /> +
+ + {/* Recent sales */} +
+
+

Ventas de hoy

+
+
+ {sales?.length === 0 ? ( +
+ No hay ventas registradas hoy +
+ ) : ( + sales?.slice(0, 10).map((sale) => ( +
+
+

#{sale.ticketNumber}

+

+ {new Date(sale.createdAt).toLocaleTimeString('es-MX', { + hour: '2-digit', + minute: '2-digit', + })} + {' - '} + {sale.items.length} productos +

+
+
+

+ ${sale.total.toFixed(2)} +

+ {sale.status === 'cancelled' && ( + Cancelada + )} +
+
+ )) + )} +
+
+
+ )} +
+ ); +} + +interface SummaryCardProps { + icon: React.ReactNode; + label: string; + value: string; + bgColor: string; +} + +function SummaryCard({ icon, label, value, bgColor }: SummaryCardProps) { + return ( +
+
+ {icon} +
+

{label}

+

{value}

+
+ ); +} diff --git a/apps/products/pos-micro/frontend/src/services/api.ts b/apps/products/pos-micro/frontend/src/services/api.ts new file mode 100644 index 0000000..d1e0b0b --- /dev/null +++ b/apps/products/pos-micro/frontend/src/services/api.ts @@ -0,0 +1,61 @@ +import axios, { AxiosError, InternalAxiosRequestConfig } from 'axios'; +import { useAuthStore } from '@/store/auth'; + +const API_URL = import.meta.env.VITE_API_URL || 'http://localhost:3000/api/v1'; + +export const api = axios.create({ + baseURL: API_URL, + headers: { + 'Content-Type': 'application/json', + }, +}); + +// Request interceptor - add auth token +api.interceptors.request.use( + (config: InternalAxiosRequestConfig) => { + const token = useAuthStore.getState().accessToken; + if (token) { + config.headers.Authorization = `Bearer ${token}`; + } + return config; + }, + (error) => Promise.reject(error) +); + +// Response interceptor - handle token refresh +api.interceptors.response.use( + (response) => response, + async (error: AxiosError) => { + const originalRequest = error.config as InternalAxiosRequestConfig & { _retry?: boolean }; + + // If 401 and we haven't retried yet + if (error.response?.status === 401 && !originalRequest._retry) { + originalRequest._retry = true; + + try { + const refreshToken = useAuthStore.getState().refreshToken; + if (!refreshToken) { + throw new Error('No refresh token'); + } + + const response = await axios.post(`${API_URL}/auth/refresh`, { + refreshToken, + }); + + const { accessToken, refreshToken: newRefreshToken } = response.data; + useAuthStore.getState().setTokens(accessToken, newRefreshToken); + + originalRequest.headers.Authorization = `Bearer ${accessToken}`; + return api(originalRequest); + } catch { + useAuthStore.getState().logout(); + window.location.href = '/login'; + return Promise.reject(error); + } + } + + return Promise.reject(error); + } +); + +export default api; diff --git a/apps/products/pos-micro/frontend/src/store/auth.ts b/apps/products/pos-micro/frontend/src/store/auth.ts new file mode 100644 index 0000000..108494d --- /dev/null +++ b/apps/products/pos-micro/frontend/src/store/auth.ts @@ -0,0 +1,61 @@ +import { create } from 'zustand'; +import { persist } from 'zustand/middleware'; +import type { User, Tenant } from '@/types'; + +interface AuthState { + accessToken: string | null; + refreshToken: string | null; + user: User | null; + tenant: Tenant | null; + isAuthenticated: boolean; + setTokens: (accessToken: string, refreshToken: string) => void; + setUser: (user: User, tenant: Tenant) => void; + login: (accessToken: string, refreshToken: string, user: User, tenant: Tenant) => void; + logout: () => void; +} + +export const useAuthStore = create()( + persist( + (set) => ({ + accessToken: null, + refreshToken: null, + user: null, + tenant: null, + isAuthenticated: false, + + setTokens: (accessToken, refreshToken) => + set({ accessToken, refreshToken }), + + setUser: (user, tenant) => + set({ user, tenant }), + + login: (accessToken, refreshToken, user, tenant) => + set({ + accessToken, + refreshToken, + user, + tenant, + isAuthenticated: true, + }), + + logout: () => + set({ + accessToken: null, + refreshToken: null, + user: null, + tenant: null, + isAuthenticated: false, + }), + }), + { + name: 'pos-micro-auth', + partialize: (state) => ({ + accessToken: state.accessToken, + refreshToken: state.refreshToken, + user: state.user, + tenant: state.tenant, + isAuthenticated: state.isAuthenticated, + }), + } + ) +); diff --git a/apps/products/pos-micro/frontend/src/store/cart.ts b/apps/products/pos-micro/frontend/src/store/cart.ts new file mode 100644 index 0000000..b7b7c9a --- /dev/null +++ b/apps/products/pos-micro/frontend/src/store/cart.ts @@ -0,0 +1,149 @@ +import { create } from 'zustand'; +import type { Product, CartItem, PaymentMethod } from '@/types'; + +interface CartState { + items: CartItem[]; + paymentMethod: PaymentMethod | null; + amountReceived: number; + notes: string; + + // Computed + subtotal: number; + discountAmount: number; + taxAmount: number; + total: number; + itemCount: number; + + // Actions + addItem: (product: Product, quantity?: number) => void; + removeItem: (productId: string) => void; + updateQuantity: (productId: string, quantity: number) => void; + applyItemDiscount: (productId: string, discountPercent: number) => void; + setPaymentMethod: (method: PaymentMethod) => void; + setAmountReceived: (amount: number) => void; + setNotes: (notes: string) => void; + clear: () => void; +} + +const calculateTotals = (items: CartItem[]) => { + // Subtotal = sum of line subtotals (already with discount applied) + const subtotal = items.reduce((sum, item) => sum + item.subtotal, 0); + // Discount amount = original price - discounted price + const discountAmount = items.reduce((sum, item) => { + const originalPrice = item.unitPrice * item.quantity; + return sum + (originalPrice - item.subtotal); + }, 0); + // Tax included in price (16% IVA) + const taxRate = 0.16; + const taxAmount = subtotal - (subtotal / (1 + taxRate)); + const total = subtotal; + const itemCount = items.reduce((sum, item) => sum + item.quantity, 0); + + return { subtotal, discountAmount, taxAmount, total, itemCount }; +}; + +export const useCartStore = create((set, get) => ({ + items: [], + paymentMethod: null, + amountReceived: 0, + notes: '', + subtotal: 0, + discountAmount: 0, + taxAmount: 0, + total: 0, + itemCount: 0, + + addItem: (product, quantity = 1) => { + const { items } = get(); + const existingIndex = items.findIndex((item) => item.product.id === product.id); + + let newItems: CartItem[]; + + if (existingIndex >= 0) { + // Update existing item + newItems = items.map((item, index) => { + if (index === existingIndex) { + const newQty = item.quantity + quantity; + const discountMultiplier = 1 - (item.discountPercent / 100); + return { + ...item, + quantity: newQty, + subtotal: newQty * item.unitPrice * discountMultiplier, + }; + } + return item; + }); + } else { + // Add new item + const newItem: CartItem = { + product, + quantity, + unitPrice: product.price, + discountPercent: 0, + subtotal: quantity * product.price, + }; + newItems = [...items, newItem]; + } + + set({ items: newItems, ...calculateTotals(newItems) }); + }, + + removeItem: (productId) => { + const newItems = get().items.filter((item) => item.product.id !== productId); + set({ items: newItems, ...calculateTotals(newItems) }); + }, + + updateQuantity: (productId, quantity) => { + if (quantity <= 0) { + get().removeItem(productId); + return; + } + + const newItems = get().items.map((item) => { + if (item.product.id === productId) { + const discountMultiplier = 1 - (item.discountPercent / 100); + return { + ...item, + quantity, + subtotal: quantity * item.unitPrice * discountMultiplier, + }; + } + return item; + }); + set({ items: newItems, ...calculateTotals(newItems) }); + }, + + applyItemDiscount: (productId, discountPercent) => { + const newItems = get().items.map((item) => { + if (item.product.id === productId) { + const discountMultiplier = 1 - (discountPercent / 100); + return { + ...item, + discountPercent, + subtotal: item.quantity * item.unitPrice * discountMultiplier, + }; + } + return item; + }); + set({ items: newItems, ...calculateTotals(newItems) }); + }, + + setPaymentMethod: (method) => set({ paymentMethod: method }), + + setAmountReceived: (amount) => set({ amountReceived: amount }), + + setNotes: (notes) => set({ notes }), + + clear: () => + set({ + items: [], + paymentMethod: null, + amountReceived: 0, + notes: '', + subtotal: 0, + discountAmount: 0, + taxAmount: 0, + total: 0, + itemCount: 0, + }), +})); diff --git a/apps/products/pos-micro/frontend/src/styles/index.css b/apps/products/pos-micro/frontend/src/styles/index.css new file mode 100644 index 0000000..142cf4e --- /dev/null +++ b/apps/products/pos-micro/frontend/src/styles/index.css @@ -0,0 +1,82 @@ +@tailwind base; +@tailwind components; +@tailwind utilities; + +@layer base { + html { + font-family: 'Inter', system-ui, sans-serif; + -webkit-tap-highlight-color: transparent; + } + + body { + @apply bg-gray-50 text-gray-900 antialiased; + touch-action: manipulation; + } + + /* Prevent pull-to-refresh on mobile */ + html, body { + overscroll-behavior-y: contain; + } +} + +@layer components { + .btn { + @apply inline-flex items-center justify-center px-4 py-2 rounded-lg font-medium transition-colors focus:outline-none focus:ring-2 focus:ring-offset-2 disabled:opacity-50 disabled:cursor-not-allowed; + } + + .btn-primary { + @apply btn bg-primary-500 text-white hover:bg-primary-600 focus:ring-primary-500 active:bg-primary-700; + } + + .btn-secondary { + @apply btn bg-gray-200 text-gray-800 hover:bg-gray-300 focus:ring-gray-500; + } + + .btn-danger { + @apply btn bg-red-500 text-white hover:bg-red-600 focus:ring-red-500; + } + + .btn-lg { + @apply px-6 py-3 text-lg; + } + + .card { + @apply bg-white rounded-xl shadow-sm border border-gray-100; + } + + .input { + @apply w-full px-4 py-3 rounded-lg border border-gray-300 focus:border-primary-500 focus:ring-2 focus:ring-primary-500/20 focus:outline-none transition-colors; + } + + .product-card { + @apply card p-3 flex flex-col items-center justify-center cursor-pointer hover:shadow-md transition-shadow active:scale-95; + min-height: 100px; + } + + .cart-item { + @apply flex items-center justify-between py-3 border-b border-gray-100 last:border-0; + } + + .quantity-btn { + @apply w-10 h-10 rounded-full flex items-center justify-center text-lg font-bold transition-colors; + } +} + +@layer utilities { + .safe-bottom { + padding-bottom: env(safe-area-inset-bottom); + } + + .safe-top { + padding-top: env(safe-area-inset-top); + } + + /* Hide scrollbar but keep functionality */ + .no-scrollbar::-webkit-scrollbar { + display: none; + } + .no-scrollbar { + -ms-overflow-style: none; + scrollbar-width: none; + } +} diff --git a/apps/products/pos-micro/frontend/src/types/index.ts b/apps/products/pos-micro/frontend/src/types/index.ts new file mode 100644 index 0000000..081d50a --- /dev/null +++ b/apps/products/pos-micro/frontend/src/types/index.ts @@ -0,0 +1,144 @@ +// ============================================================================= +// POS MICRO - TypeScript Types (aligned with backend entities) +// ============================================================================= + +// Matches backend Product entity +export interface Product { + id: string; + tenantId: string; + name: string; + description?: string; + sku?: string; + barcode?: string; + price: number; + cost?: number; + categoryId?: string; + category?: Category; + imageUrl?: string; + trackStock: boolean; + stockQuantity: number; + lowStockAlert: number; + isFavorite: boolean; + isActive: boolean; + createdAt: string; + updatedAt: string; +} + +// Matches backend Category entity +export interface Category { + id: string; + tenantId: string; + name: string; + description?: string; + color?: string; + sortOrder: number; + isActive: boolean; + createdAt: string; + updatedAt: string; +} + +// Frontend cart item +export interface CartItem { + product: Product; + quantity: number; + unitPrice: number; + discountPercent: number; + subtotal: number; +} + +// Matches backend Sale entity +export interface Sale { + id: string; + tenantId: string; + ticketNumber: string; + items: SaleItem[]; + subtotal: number; + discountAmount: number; + taxAmount: number; + total: number; + paymentMethodId: string; + paymentMethod?: PaymentMethod; + amountReceived: number; + changeAmount: number; + customerName?: string; + customerPhone?: string; + status: 'completed' | 'cancelled' | 'refunded'; + notes?: string; + cancelledAt?: string; + cancelReason?: string; + createdAt: string; + updatedAt: string; +} + +// Matches backend SaleItem entity +export interface SaleItem { + id: string; + saleId: string; + productId: string; + productName: string; + productSku?: string; + quantity: number; + unitPrice: number; + discountPercent: number; + subtotal: number; +} + +// Matches backend PaymentMethod entity +export interface PaymentMethod { + id: string; + tenantId: string; + name: string; + type: 'cash' | 'card' | 'transfer' | 'other'; + isActive: boolean; + isDefault: boolean; + requiresReference: boolean; + sortOrder: number; +} + +// Matches backend TodaySummary response +export interface TodaySummary { + totalSales: number; + totalRevenue: number; + totalTax: number; + avgTicket: number; +} + +// Matches backend User entity +export interface User { + id: string; + name: string; + isOwner: boolean; +} + +// Matches backend Tenant entity (partial for auth response) +export type SubscriptionStatus = 'trial' | 'active' | 'past_due' | 'cancelled' | 'suspended'; + +export interface Tenant { + id: string; + businessName: string; + plan: string; + subscriptionStatus: SubscriptionStatus; + trialEndsAt: string | null; +} + +// Matches backend AuthResponse +export interface AuthResponse { + accessToken: string; + refreshToken: string; + user: User; + tenant: Tenant; +} + +// API Response types +export interface ApiResponse { + data: T; + message?: string; +} + +export interface PaginatedResponse { + data: T[]; + total: number; + page: number; + limit: number; + totalPages: number; +} diff --git a/apps/products/pos-micro/frontend/src/vite-env.d.ts b/apps/products/pos-micro/frontend/src/vite-env.d.ts new file mode 100644 index 0000000..11f02fe --- /dev/null +++ b/apps/products/pos-micro/frontend/src/vite-env.d.ts @@ -0,0 +1 @@ +/// diff --git a/apps/products/pos-micro/frontend/tailwind.config.js b/apps/products/pos-micro/frontend/tailwind.config.js new file mode 100644 index 0000000..3d46f8b --- /dev/null +++ b/apps/products/pos-micro/frontend/tailwind.config.js @@ -0,0 +1,26 @@ +/** @type {import('tailwindcss').Config} */ +export default { + content: ['./index.html', './src/**/*.{js,ts,jsx,tsx}'], + theme: { + extend: { + colors: { + primary: { + 50: '#ecfdf5', + 100: '#d1fae5', + 200: '#a7f3d0', + 300: '#6ee7b7', + 400: '#34d399', + 500: '#10b981', + 600: '#059669', + 700: '#047857', + 800: '#065f46', + 900: '#064e3b', + }, + }, + fontFamily: { + sans: ['Inter', 'system-ui', 'sans-serif'], + }, + }, + }, + plugins: [], +}; diff --git a/apps/products/pos-micro/frontend/tsconfig.json b/apps/products/pos-micro/frontend/tsconfig.json new file mode 100644 index 0000000..5413626 --- /dev/null +++ b/apps/products/pos-micro/frontend/tsconfig.json @@ -0,0 +1,25 @@ +{ + "compilerOptions": { + "target": "ES2020", + "useDefineForClassFields": true, + "lib": ["ES2020", "DOM", "DOM.Iterable"], + "module": "ESNext", + "skipLibCheck": true, + "moduleResolution": "bundler", + "allowImportingTsExtensions": true, + "resolveJsonModule": true, + "isolatedModules": true, + "noEmit": true, + "jsx": "react-jsx", + "strict": true, + "noUnusedLocals": true, + "noUnusedParameters": true, + "noFallthroughCasesInSwitch": true, + "baseUrl": ".", + "paths": { + "@/*": ["src/*"] + } + }, + "include": ["src"], + "references": [{ "path": "./tsconfig.node.json" }] +} diff --git a/apps/products/pos-micro/frontend/tsconfig.node.json b/apps/products/pos-micro/frontend/tsconfig.node.json new file mode 100644 index 0000000..42872c5 --- /dev/null +++ b/apps/products/pos-micro/frontend/tsconfig.node.json @@ -0,0 +1,10 @@ +{ + "compilerOptions": { + "composite": true, + "skipLibCheck": true, + "module": "ESNext", + "moduleResolution": "bundler", + "allowSyntheticDefaultImports": true + }, + "include": ["vite.config.ts"] +} diff --git a/apps/products/pos-micro/frontend/vite.config.ts b/apps/products/pos-micro/frontend/vite.config.ts new file mode 100644 index 0000000..e602774 --- /dev/null +++ b/apps/products/pos-micro/frontend/vite.config.ts @@ -0,0 +1,70 @@ +import { defineConfig } from 'vite'; +import react from '@vitejs/plugin-react'; +import { VitePWA } from 'vite-plugin-pwa'; +import path from 'path'; + +export default defineConfig({ + plugins: [ + react(), + VitePWA({ + registerType: 'autoUpdate', + includeAssets: ['favicon.ico', 'apple-touch-icon.png', 'mask-icon.svg'], + manifest: { + name: 'POS Micro', + short_name: 'POS', + description: 'Punto de venta ultra-simple para negocios pequeños', + theme_color: '#10b981', + background_color: '#ffffff', + display: 'standalone', + orientation: 'portrait', + start_url: '/', + icons: [ + { + src: 'pwa-192x192.png', + sizes: '192x192', + type: 'image/png', + }, + { + src: 'pwa-512x512.png', + sizes: '512x512', + type: 'image/png', + }, + { + src: 'pwa-512x512.png', + sizes: '512x512', + type: 'image/png', + purpose: 'any maskable', + }, + ], + }, + workbox: { + globPatterns: ['**/*.{js,css,html,ico,png,svg,woff2}'], + runtimeCaching: [ + { + urlPattern: /^https:\/\/api\./i, + handler: 'NetworkFirst', + options: { + cacheName: 'api-cache', + expiration: { + maxEntries: 100, + maxAgeSeconds: 60 * 60 * 24, // 24 hours + }, + cacheableResponse: { + statuses: [0, 200], + }, + }, + }, + ], + }, + }), + ], + resolve: { + alias: { + '@': path.resolve(__dirname, './src'), + }, + }, + server: { + port: 5173, + host: true, + }, +}); diff --git a/apps/products/pos-micro/orchestration/00-guidelines/CONTEXTO-PROYECTO.md b/apps/products/pos-micro/orchestration/00-guidelines/CONTEXTO-PROYECTO.md new file mode 100644 index 0000000..abb6715 --- /dev/null +++ b/apps/products/pos-micro/orchestration/00-guidelines/CONTEXTO-PROYECTO.md @@ -0,0 +1,164 @@ +# Contexto del Proyecto: POS Micro + +## Identificación + +| Campo | Valor | +|-------|-------| +| **Nombre** | POS Micro | +| **Tipo** | Producto SaaS | +| **Nivel** | 2B.2 (Producto dentro de Suite) | +| **Suite Padre** | erp-suite | +| **Ruta Base** | `projects/erp-suite/apps/products/pos-micro/` | +| **Estado** | En Planificación | + +## Descripción + +Sistema de punto de venta ultra-minimalista diseñado para el mercado informal mexicano. Precio target: **100 MXN/mes**. + +## Target de Mercado + +- Puestos ambulantes +- Tiendas de abarrotes +- Misceláneas +- Puestos de comida +- Pequeños comercios + +## Propuesta de Valor + +1. **Precio accesible** - 100 MXN/mes (vs 500+ de competidores) +2. **Simplicidad** - Solo lo esencial +3. **Offline** - Funciona sin internet +4. **WhatsApp** - Consultas por chat +5. **Sin fricción** - Registro en 5 minutos + +## Stack Tecnológico + +```yaml +backend: + runtime: Node.js 20+ + framework: Express + language: TypeScript + orm: TypeORM (simplificado) + +frontend: + framework: React 18 + bundler: Vite + styling: Tailwind CSS + pwa: Workbox + +database: + engine: PostgreSQL 15+ + multi_tenant: true (RLS) + max_tables: 10 + +integrations: + whatsapp: WhatsApp Business API + ai: Claude API (opcional) + payments: Stripe/Conekta +``` + +## Variables del Proyecto + +```yaml +# Identificadores +PROJECT_NAME: pos-micro +PROJECT_CODE: POS +SUITE: erp-suite + +# Database +DB_SCHEMA: pos_micro +DB_NAME: erp_suite_db # Compartida +MAX_TABLES: 10 + +# Paths +BACKEND_ROOT: apps/products/pos-micro/backend +FRONTEND_ROOT: apps/products/pos-micro/frontend +PWA_ROOT: apps/products/pos-micro/pwa +DATABASE_ROOT: apps/products/pos-micro/database + +# Business +PRICE_MXN: 100 +PRICE_USD: 6 +MAX_PRODUCTS: 500 +MAX_SALES_MONTH: 1000 +``` + +## Herencia del Core + +### SÍ Hereda + +| Componente | Origen | Adaptación | +|------------|--------|------------| +| Auth básico | erp-core/auth | Simplificado (solo email/WA) | +| Multi-tenant | erp-core/tenant | RLS básico | +| API patterns | erp-core/shared | Endpoints mínimos | + +### NO Hereda (Por Diseño) + +| Componente | Razón | +|------------|-------| +| Contabilidad | Demasiado complejo | +| RRHH | No aplica | +| CRM | Simplificar | +| Compras | No necesario | +| Reportes avanzados | Overkill | + +## Módulos del Producto + +| Módulo | Prioridad | Tablas | Endpoints | +|--------|-----------|--------|-----------| +| auth | P0 | 2 | 4 | +| products | P0 | 1 | 5 | +| sales | P0 | 2 | 4 | +| inventory | P0 | 1 | 3 | +| reports | P1 | 1 | 3 | +| whatsapp | P1 | 2 | 2 | +| billing | P1 | 1 | 2 | + +## Restricciones de Diseño + +1. **Máximo 10 tablas** - Simplicidad de BD +2. **Máximo 20 endpoints** - API mínima +3. **Máximo 10 pantallas** - UI simple +4. **Offline-first** - Service Worker obligatorio +5. **Mobile-first** - Diseño responsivo primero móvil +6. **3-click rule** - Cualquier acción en máximo 3 clicks + +## Métricas de Éxito + +| Métrica | Target | +|---------|--------| +| Tiempo de onboarding | < 5 minutos | +| Tiempo carga PWA | < 2 segundos | +| Funcionalidad offline | 100% ventas | +| Costo infraestructura/usuario | < $1 USD/mes | +| Churn mensual | < 5% | + +## Roadmap + +### MVP (v1.0) +- [ ] Auth por WhatsApp +- [ ] CRUD productos +- [ ] Registro de ventas +- [ ] Corte de caja +- [ ] PWA offline + +### v1.1 +- [ ] WhatsApp Bot básico +- [ ] Reportes por WhatsApp +- [ ] Notificaciones stock bajo + +### v1.2 +- [ ] Dashboard web simple +- [ ] Exportar datos CSV +- [ ] Backup automático + +## Documentos Relacionados + +- `../README.md` - Descripción general +- `../../erp-core/orchestration/` - Core heredado +- `../../../orchestration/` - Suite level + +--- + +*Última actualización: 2025-12-08* diff --git a/apps/products/pos-micro/orchestration/00-guidelines/HERENCIA-SIMCO.md b/apps/products/pos-micro/orchestration/00-guidelines/HERENCIA-SIMCO.md new file mode 100644 index 0000000..8c5d749 --- /dev/null +++ b/apps/products/pos-micro/orchestration/00-guidelines/HERENCIA-SIMCO.md @@ -0,0 +1,130 @@ +# Herencia SIMCO - POS Micro + +**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol +**Fecha:** 2025-12-08 + +--- + +## Configuración del Proyecto + +| Propiedad | Valor | +|-----------|-------| +| **Proyecto** | POS Micro - Punto de Venta Simplificado | +| **Nivel** | PRODUCT (Nivel 2) | +| **Padre** | erp-suite | +| **SIMCO Version** | 2.2.0 | +| **CAPVED** | Habilitado | +| **CCA Protocol** | Habilitado | +| **Estado** | Por iniciar | + +## Jerarquía de Herencia + +``` +Nivel 0: core/orchestration/ ← FUENTE PRINCIPAL + │ + └── Nivel 1: erp-suite/orchestration/ ← PADRE + │ + └── Nivel 2: pos-micro/orchestration/ ← ESTE PROYECTO +``` + +**Nota:** POS Micro es un PRODUCTO standalone dentro de la suite. +Es un punto de venta minimalista para micro-negocios. + +--- + +## Directivas Heredadas de CORE (OBLIGATORIAS) + +### Ciclo de Vida +| Alias | Propósito | +|-------|-----------| +| `@TAREA` | Punto de entrada para toda HU | +| `@CAPVED` | Ciclo de 6 fases | +| `@INICIALIZACION` | Bootstrap de agentes | + +### Operaciones Universales +| Alias | Propósito | +|-------|-----------| +| `@CREAR` | Crear archivos nuevos | +| `@MODIFICAR` | Modificar existentes | +| `@VALIDAR` | Validar código | +| `@DOCUMENTAR` | Documentar trabajo | +| `@BUSCAR` | Buscar información | +| `@DELEGAR` | Delegar a subagentes | + +### Principios Fundamentales +| Alias | Resumen | +|-------|---------| +| `@CAPVED` | Toda tarea pasa por 6 fases | +| `@DOC_PRIMERO` | Consultar docs/ antes de implementar | +| `@ANTI_DUP` | Verificar que no existe | +| `@VALIDACION` | Build y lint DEBEN pasar | +| `@TOKENS` | Desglosar tareas grandes | + +--- + +## Directivas por Dominio Técnico + +| Alias | Aplica | Notas | +|-------|--------|-------| +| `@OP_DDL` | **SÍ** | Schema mínimo | +| `@OP_BACKEND` | **SÍ** | API de ventas | +| `@OP_FRONTEND` | **SÍ** | UI táctil POS | +| `@OP_MOBILE` | **SÍ** | App de caja | +| `@OP_ML` | NO | - | + +--- + +## Patrones Heredados (OBLIGATORIOS) + +Todos los patrones de `core/orchestration/patrones/` aplican. + +**Especialmente importantes:** +- `@PATRON-TRANSACCIONES` - Ventas atómicas +- `@PATRON-PERFORMANCE` - Respuesta rápida +- `@PATRON-SEGURIDAD` - Manejo de dinero + +--- + +## Variables de Contexto CCA + +```yaml +PROJECT_NAME: "pos-micro" +PROJECT_LEVEL: "PRODUCT" +PROJECT_ROOT: "./" +PARENT_PROJECT: "erp-suite" + +DB_DDL_PATH: "database/ddl" +BACKEND_ROOT: "backend/src" +FRONTEND_ROOT: "frontend/src" + +# POS simplificado +TENANT_COLUMN: "negocio_id" +SIMPLIFIED: true +OFFLINE_CAPABLE: true +``` + +--- + +## Módulos de POS Micro + +| Módulo | Descripción | Estado | +|--------|-------------|--------| +| POS-VEN | Ventas rápidas | Por definir | +| POS-INV | Inventario simple | Por definir | +| POS-CAJ | Corte de caja | Por definir | +| POS-REP | Reportes básicos | Por definir | + +--- + +## Características Especiales + +- **Offline-first**: Funciona sin conexión +- **Touch-friendly**: Optimizado para tablets +- **Rápido**: < 2s por transacción +- **Simple**: Curva de aprendizaje mínima + +--- + +**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol +**Nivel:** PRODUCT (2) +**Última actualización:** 2025-12-08 diff --git a/apps/products/pos-micro/scripts/dev.sh b/apps/products/pos-micro/scripts/dev.sh new file mode 100755 index 0000000..f1ebafb --- /dev/null +++ b/apps/products/pos-micro/scripts/dev.sh @@ -0,0 +1,75 @@ +#!/bin/bash +# ============================================================================= +# POS MICRO - Development Script +# ============================================================================= + +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +PROJECT_DIR="$(dirname "$SCRIPT_DIR")" + +cd "$PROJECT_DIR" + +# Colors +RED='\033[0;31m' +GREEN='\033[0;32m' +YELLOW='\033[1;33m' +NC='\033[0m' # No Color + +echo -e "${GREEN}" +echo "╔══════════════════════════════════════════════════════════════╗" +echo "║ POS MICRO ║" +echo "║ Development Environment ║" +echo "╚══════════════════════════════════════════════════════════════╝" +echo -e "${NC}" + +case "${1:-up}" in + up) + echo -e "${YELLOW}Starting development environment...${NC}" + docker-compose up -d postgres + echo -e "${GREEN}Waiting for database...${NC}" + sleep 5 + echo -e "${GREEN}Starting backend...${NC}" + cd backend && npm run start:dev & + echo -e "${GREEN}Starting frontend...${NC}" + cd ../frontend && npm run dev & + wait + ;; + + down) + echo -e "${YELLOW}Stopping development environment...${NC}" + docker-compose down + pkill -f "nest start" || true + pkill -f "vite" || true + ;; + + db) + echo -e "${YELLOW}Starting database only...${NC}" + docker-compose up -d postgres + echo -e "${GREEN}Database available at localhost:5433${NC}" + ;; + + logs) + docker-compose logs -f + ;; + + reset-db) + echo -e "${RED}Resetting database...${NC}" + docker-compose down -v + docker-compose up -d postgres + sleep 5 + echo -e "${GREEN}Database reset complete!${NC}" + ;; + + *) + echo "Usage: $0 {up|down|db|logs|reset-db}" + echo "" + echo "Commands:" + echo " up - Start full development environment" + echo " down - Stop all services" + echo " db - Start database only" + echo " logs - View container logs" + echo " reset-db - Reset database (WARNING: deletes all data)" + exit 1 + ;; +esac diff --git a/apps/saas/README.md b/apps/saas/README.md new file mode 100644 index 0000000..7169ff8 --- /dev/null +++ b/apps/saas/README.md @@ -0,0 +1,198 @@ +# SaaS Layer - ERP Suite + +## Descripción + +Capa de servicios SaaS que gestiona multi-tenancy, billing, suscripciones y portal de clientes para todos los productos del ERP Suite. + +## Componentes + +``` +saas/ +├── billing/ # Facturación y cobros +├── portal/ # Portal de clientes +├── admin/ # Administración multi-tenant +├── onboarding/ # Registro y configuración inicial +├── docs/ # Documentación +└── orchestration/ # Sistema NEXUS +``` + +## Billing + +Gestión de suscripciones y cobros. + +### Funcionalidades + +- Planes de suscripción (POS Micro, ERP Básico, Verticales) +- Cobro recurrente (mensual/anual) +- Integración con Stripe/Conekta +- Facturación automática (CFDI México) +- Gestión de módulos opcionales + +### Planes + +| Plan | Precio Base | Productos | +|------|-------------|-----------| +| POS Micro | 100 MXN/mes | pos-micro | +| ERP Básico | 300 MXN/mes | erp-basico | +| ERP Pro | 500 MXN/mes | erp-basico + módulos | +| Vertical | 1,000+ MXN/mes | erp-core + vertical | + +### Módulos Opcionales + +| Módulo | Precio | Disponible en | +|--------|--------|---------------| +| Contabilidad | +150 MXN/mes | ERP Básico, Verticales | +| RRHH | +100 MXN/mes | ERP Básico, Verticales | +| CFDI | +100 MXN/mes | Todos | +| WhatsApp Bot | Por consumo | Todos | +| Usuario extra | +50 MXN/mes | Todos | + +## Portal + +Portal self-service para clientes. + +### Funcionalidades + +- Dashboard de cuenta +- Gestión de suscripción +- Historial de facturas +- Cambio de plan +- Soporte/tickets +- Configuración de módulos + +## Admin + +Panel de administración para operadores. + +### Funcionalidades + +- Gestión de tenants +- Métricas de uso +- Facturación manual +- Soporte nivel 1 +- Configuración global +- Feature flags por tenant + +## Onboarding + +Flujo de registro y configuración inicial. + +### Flujo + +1. **Registro** - Email o WhatsApp +2. **Selección de plan** - POS Micro, ERP Básico, etc. +3. **Datos de empresa** - RFC, dirección, giro +4. **Configuración inicial** - Productos, usuarios +5. **Pago** - Tarjeta o transferencia +6. **Activación** - Acceso inmediato + +## Stack Tecnológico + +```yaml +backend: + runtime: Node.js 20+ + framework: NestJS + language: TypeScript + payments: Stripe + Conekta + invoicing: PAC CFDI + +frontend: + framework: React 18 + bundler: Vite + styling: Tailwind CSS + +database: + engine: PostgreSQL 15+ + schema: saas + tables: ~15 +``` + +## Base de Datos + +### Schema: `saas` + +```sql +-- Gestión de tenants y suscripciones + +saas.tenants -- Empresas/clientes +saas.subscriptions -- Suscripciones activas +saas.plans -- Catálogo de planes +saas.plan_features -- Features por plan +saas.invoices -- Facturas emitidas +saas.payments -- Pagos recibidos +saas.payment_methods -- Métodos de pago guardados +saas.usage_tracking -- Tracking de consumo +saas.support_tickets -- Tickets de soporte +saas.onboarding_sessions -- Sesiones de registro +``` + +## Integración con Productos + +``` +┌─────────────────────────────────────────────────────────────┐ +│ SAAS LAYER │ +│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ +│ │ billing │ │ portal │ │ admin │ │onboarding│ │ +│ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │ +│ │ │ │ │ │ +│ └───────────┴───────────┴───────────┘ │ +│ │ │ +│ API Gateway │ +│ │ │ +└─────────────────────────┼───────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + │ │ │ + ▼ ▼ ▼ + ┌──────────┐ ┌──────────┐ ┌──────────┐ + │ POS Micro│ │ERP Básico│ │Verticales│ + └──────────┘ └──────────┘ └──────────┘ +``` + +## Variables de Entorno + +```env +# Payments +STRIPE_SECRET_KEY=sk_xxx +STRIPE_WEBHOOK_SECRET=whsec_xxx +CONEKTA_API_KEY=key_xxx + +# CFDI +PAC_RFC=XXX +PAC_API_KEY=xxx +PAC_ENVIRONMENT=sandbox|production + +# Database +DATABASE_URL=postgresql://... +SAAS_SCHEMA=saas + +# General +ONBOARDING_URL=https://registro.erp-suite.com +PORTAL_URL=https://portal.erp-suite.com +``` + +## Roadmap + +### MVP (v1.0) +- [ ] Modelo de datos billing +- [ ] Integración Stripe básica +- [ ] Portal mínimo (ver facturas) +- [ ] Onboarding POS Micro +- [ ] Admin básico + +### v1.1 +- [ ] Integración Conekta +- [ ] CFDI automático +- [ ] Onboarding ERP Básico +- [ ] Métricas de uso + +### v1.2 +- [ ] Portal completo +- [ ] Cambio de plan self-service +- [ ] Soporte integrado +- [ ] Referidos + +--- + +*SaaS Layer v1.0* +*ERP Suite* diff --git a/apps/saas/billing/database/ddl/00-schema.sql b/apps/saas/billing/database/ddl/00-schema.sql new file mode 100644 index 0000000..3d0b5a2 --- /dev/null +++ b/apps/saas/billing/database/ddl/00-schema.sql @@ -0,0 +1,676 @@ +-- ============================================================================ +-- SAAS LAYER - BILLING SCHEMA +-- ============================================================================ +-- Version: 1.0.0 +-- Description: Billing, subscriptions, and payments management for SaaS +-- Target: All ERP Suite products (POS Micro, ERP Básico, Verticales) +-- ============================================================================ + +-- Enable required extensions +CREATE EXTENSION IF NOT EXISTS "uuid-ossp"; +CREATE EXTENSION IF NOT EXISTS "pgcrypto"; + +-- ============================================================================ +-- SCHEMA CREATION +-- ============================================================================ + +CREATE SCHEMA IF NOT EXISTS saas; + +SET search_path TO saas, public; + +-- ============================================================================ +-- ENUMS +-- ============================================================================ + +CREATE TYPE saas.plan_type AS ENUM ( + 'pos_micro', -- 100 MXN/mes + 'erp_basic', -- 300 MXN/mes + 'erp_pro', -- 500 MXN/mes + 'vertical' -- 1000+ MXN/mes +); + +CREATE TYPE saas.billing_cycle AS ENUM ( + 'monthly', + 'yearly' +); + +CREATE TYPE saas.subscription_status AS ENUM ( + 'trial', + 'active', + 'past_due', + 'suspended', + 'cancelled', + 'expired' +); + +CREATE TYPE saas.payment_status AS ENUM ( + 'pending', + 'processing', + 'completed', + 'failed', + 'refunded', + 'cancelled' +); + +CREATE TYPE saas.invoice_status AS ENUM ( + 'draft', + 'pending', + 'paid', + 'overdue', + 'cancelled', + 'refunded' +); + +CREATE TYPE saas.payment_provider AS ENUM ( + 'stripe', + 'conekta', + 'oxxo', + 'transfer', + 'manual' +); + +-- ============================================================================ +-- TABLE 1: plans (Subscription plans) +-- ============================================================================ + +CREATE TABLE saas.plans ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + + -- Identification + code VARCHAR(50) UNIQUE NOT NULL, + name VARCHAR(100) NOT NULL, + description TEXT, + + -- Type + plan_type saas.plan_type NOT NULL, + + -- Pricing (MXN) + price_monthly DECIMAL(10,2) NOT NULL, + price_yearly DECIMAL(10,2), -- Usually with discount + + -- Limits + max_users INTEGER NOT NULL DEFAULT 1, + max_products INTEGER DEFAULT 500, + max_sales_per_month INTEGER DEFAULT 1000, + max_storage_mb INTEGER DEFAULT 100, + + -- Features (JSON for flexibility) + features JSONB NOT NULL DEFAULT '{}', + + -- Status + is_active BOOLEAN NOT NULL DEFAULT TRUE, + is_public BOOLEAN NOT NULL DEFAULT TRUE, -- Show in pricing page + sort_order INTEGER DEFAULT 0, + + -- Stripe/Conekta IDs + stripe_price_id_monthly VARCHAR(100), + stripe_price_id_yearly VARCHAR(100), + conekta_plan_id VARCHAR(100), + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP +); + +-- ============================================================================ +-- TABLE 2: plan_features (Feature definitions) +-- ============================================================================ + +CREATE TABLE saas.plan_features ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + plan_id UUID NOT NULL REFERENCES saas.plans(id) ON DELETE CASCADE, + + -- Feature + feature_code VARCHAR(50) NOT NULL, -- e.g., 'accounting', 'hr', 'cfdi' + feature_name VARCHAR(100) NOT NULL, + + -- Pricing (for add-ons) + is_included BOOLEAN NOT NULL DEFAULT FALSE, + addon_price_monthly DECIMAL(10,2), -- Price if add-on + + -- Status + is_active BOOLEAN NOT NULL DEFAULT TRUE, + + CONSTRAINT uq_plan_features UNIQUE (plan_id, feature_code) +); + +-- ============================================================================ +-- TABLE 3: tenants (All SaaS customers) +-- ============================================================================ + +CREATE TABLE saas.tenants ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + + -- Business info + business_name VARCHAR(200) NOT NULL, + legal_name VARCHAR(200), + tax_id VARCHAR(20), -- RFC México + + -- Contact + owner_name VARCHAR(200) NOT NULL, + email VARCHAR(255) NOT NULL, + phone VARCHAR(20) NOT NULL, + whatsapp VARCHAR(20), + + -- Address + address TEXT, + city VARCHAR(100), + state VARCHAR(50), + zip_code VARCHAR(10), + country VARCHAR(2) DEFAULT 'MX', + + -- Product reference (which product schema to use) + product_type saas.plan_type NOT NULL, + product_schema VARCHAR(50), -- e.g., 'pos_micro', 'erp_basic' + + -- Settings + timezone VARCHAR(50) DEFAULT 'America/Mexico_City', + currency VARCHAR(3) DEFAULT 'MXN', + language VARCHAR(10) DEFAULT 'es', + settings JSONB DEFAULT '{}', + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT uq_tenants_email UNIQUE (email), + CONSTRAINT uq_tenants_phone UNIQUE (phone) +); + +CREATE INDEX idx_tenants_email ON saas.tenants(email); +CREATE INDEX idx_tenants_phone ON saas.tenants(phone); +CREATE INDEX idx_tenants_product_type ON saas.tenants(product_type); + +-- ============================================================================ +-- TABLE 4: subscriptions (Active subscriptions) +-- ============================================================================ + +CREATE TABLE saas.subscriptions ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES saas.tenants(id) ON DELETE CASCADE, + plan_id UUID NOT NULL REFERENCES saas.plans(id), + + -- Billing + billing_cycle saas.billing_cycle NOT NULL DEFAULT 'monthly', + current_price DECIMAL(10,2) NOT NULL, + + -- Dates + trial_starts_at TIMESTAMP, + trial_ends_at TIMESTAMP, + current_period_start TIMESTAMP NOT NULL, + current_period_end TIMESTAMP NOT NULL, + cancelled_at TIMESTAMP, + + -- Status + status saas.subscription_status NOT NULL DEFAULT 'trial', + cancel_reason TEXT, + + -- External IDs + stripe_subscription_id VARCHAR(100), + conekta_subscription_id VARCHAR(100), + + -- Features (active add-ons) + active_features JSONB DEFAULT '[]', + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT uq_subscriptions_tenant UNIQUE (tenant_id) -- One active subscription per tenant +); + +CREATE INDEX idx_subscriptions_tenant_id ON saas.subscriptions(tenant_id); +CREATE INDEX idx_subscriptions_status ON saas.subscriptions(status); +CREATE INDEX idx_subscriptions_period_end ON saas.subscriptions(current_period_end); + +-- ============================================================================ +-- TABLE 5: invoices (Billing invoices) +-- ============================================================================ + +CREATE TABLE saas.invoices ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES saas.tenants(id) ON DELETE CASCADE, + subscription_id UUID REFERENCES saas.subscriptions(id), + + -- Invoice number + invoice_number VARCHAR(50) NOT NULL, + + -- Dates + invoice_date DATE NOT NULL DEFAULT CURRENT_DATE, + due_date DATE NOT NULL, + paid_at TIMESTAMP, + + -- Amounts + subtotal DECIMAL(10,2) NOT NULL, + tax_amount DECIMAL(10,2) NOT NULL DEFAULT 0, + discount_amount DECIMAL(10,2) NOT NULL DEFAULT 0, + total DECIMAL(10,2) NOT NULL, + + -- Currency + currency VARCHAR(3) NOT NULL DEFAULT 'MXN', + + -- Status + status saas.invoice_status NOT NULL DEFAULT 'draft', + + -- CFDI (Mexico) + cfdi_uuid VARCHAR(50), + cfdi_xml TEXT, + cfdi_pdf_url VARCHAR(500), + + -- External IDs + stripe_invoice_id VARCHAR(100), + conekta_order_id VARCHAR(100), + + -- Notes + notes TEXT, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT uq_invoices_number UNIQUE (invoice_number) +); + +CREATE INDEX idx_invoices_tenant_id ON saas.invoices(tenant_id); +CREATE INDEX idx_invoices_status ON saas.invoices(status); +CREATE INDEX idx_invoices_due_date ON saas.invoices(due_date); + +-- ============================================================================ +-- TABLE 6: invoice_items (Invoice line items) +-- ============================================================================ + +CREATE TABLE saas.invoice_items ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + invoice_id UUID NOT NULL REFERENCES saas.invoices(id) ON DELETE CASCADE, + + -- Description + description VARCHAR(255) NOT NULL, + + -- Amounts + quantity INTEGER NOT NULL DEFAULT 1, + unit_price DECIMAL(10,2) NOT NULL, + subtotal DECIMAL(10,2) NOT NULL, + + -- Reference + plan_id UUID REFERENCES saas.plans(id), + feature_code VARCHAR(50), + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE INDEX idx_invoice_items_invoice_id ON saas.invoice_items(invoice_id); + +-- ============================================================================ +-- TABLE 7: payments (Payment transactions) +-- ============================================================================ + +CREATE TABLE saas.payments ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES saas.tenants(id) ON DELETE CASCADE, + invoice_id UUID REFERENCES saas.invoices(id), + + -- Amount + amount DECIMAL(10,2) NOT NULL, + currency VARCHAR(3) NOT NULL DEFAULT 'MXN', + + -- Provider + provider saas.payment_provider NOT NULL, + provider_payment_id VARCHAR(100), + provider_customer_id VARCHAR(100), + + -- Status + status saas.payment_status NOT NULL DEFAULT 'pending', + + -- Details + payment_method_type VARCHAR(50), -- card, oxxo, spei, etc. + last_four VARCHAR(4), + brand VARCHAR(20), -- visa, mastercard, etc. + + -- Error handling + failure_code VARCHAR(50), + failure_message TEXT, + + -- Dates + paid_at TIMESTAMP, + refunded_at TIMESTAMP, + + -- Metadata + metadata JSONB DEFAULT '{}', + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP +); + +CREATE INDEX idx_payments_tenant_id ON saas.payments(tenant_id); +CREATE INDEX idx_payments_invoice_id ON saas.payments(invoice_id); +CREATE INDEX idx_payments_status ON saas.payments(status); +CREATE INDEX idx_payments_provider ON saas.payments(provider); + +-- ============================================================================ +-- TABLE 8: payment_methods (Saved payment methods) +-- ============================================================================ + +CREATE TABLE saas.payment_methods ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES saas.tenants(id) ON DELETE CASCADE, + + -- Provider + provider saas.payment_provider NOT NULL, + provider_payment_method_id VARCHAR(100) NOT NULL, + + -- Card details (if applicable) + card_type VARCHAR(20), + card_brand VARCHAR(20), + card_last_four VARCHAR(4), + card_exp_month INTEGER, + card_exp_year INTEGER, + + -- Status + is_default BOOLEAN NOT NULL DEFAULT FALSE, + is_active BOOLEAN NOT NULL DEFAULT TRUE, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP +); + +CREATE INDEX idx_payment_methods_tenant_id ON saas.payment_methods(tenant_id); + +-- ============================================================================ +-- TABLE 9: usage_tracking (Usage metrics for billing) +-- ============================================================================ + +CREATE TABLE saas.usage_tracking ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES saas.tenants(id) ON DELETE CASCADE, + + -- Period + period_start DATE NOT NULL, + period_end DATE NOT NULL, + + -- Metrics + users_count INTEGER DEFAULT 0, + products_count INTEGER DEFAULT 0, + sales_count INTEGER DEFAULT 0, + storage_used_mb INTEGER DEFAULT 0, + api_calls INTEGER DEFAULT 0, + + -- WhatsApp/AI usage (billable) + whatsapp_messages INTEGER DEFAULT 0, + ai_tokens_used INTEGER DEFAULT 0, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT uq_usage_tracking_tenant_period UNIQUE (tenant_id, period_start, period_end) +); + +CREATE INDEX idx_usage_tracking_tenant_id ON saas.usage_tracking(tenant_id); +CREATE INDEX idx_usage_tracking_period ON saas.usage_tracking(period_start, period_end); + +-- ============================================================================ +-- TABLE 10: support_tickets (Basic support) +-- ============================================================================ + +CREATE TABLE saas.support_tickets ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES saas.tenants(id) ON DELETE CASCADE, + + -- Ticket + ticket_number VARCHAR(20) NOT NULL, + subject VARCHAR(255) NOT NULL, + description TEXT NOT NULL, + + -- Category + category VARCHAR(50) NOT NULL DEFAULT 'general', -- billing, technical, feature, general + priority VARCHAR(20) NOT NULL DEFAULT 'normal', -- low, normal, high, urgent + + -- Status + status VARCHAR(20) NOT NULL DEFAULT 'open', -- open, in_progress, waiting, resolved, closed + + -- Assignment + assigned_to VARCHAR(100), + + -- Resolution + resolution TEXT, + resolved_at TIMESTAMP, + + -- Audit + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP, + + CONSTRAINT uq_support_tickets_number UNIQUE (ticket_number) +); + +CREATE INDEX idx_support_tickets_tenant_id ON saas.support_tickets(tenant_id); +CREATE INDEX idx_support_tickets_status ON saas.support_tickets(status); + +-- ============================================================================ +-- UTILITY FUNCTIONS +-- ============================================================================ + +-- Function: Update updated_at timestamp +CREATE OR REPLACE FUNCTION saas.update_updated_at() +RETURNS TRIGGER AS $$ +BEGIN + NEW.updated_at = CURRENT_TIMESTAMP; + RETURN NEW; +END; +$$ LANGUAGE plpgsql; + +-- Function: Generate invoice number +CREATE OR REPLACE FUNCTION saas.generate_invoice_number() +RETURNS VARCHAR AS $$ +DECLARE + v_year VARCHAR; + v_seq INTEGER; +BEGIN + v_year := TO_CHAR(CURRENT_DATE, 'YYYY'); + + SELECT COALESCE(MAX( + CAST(SUBSTRING(invoice_number FROM 5) AS INTEGER) + ), 0) + 1 + INTO v_seq + FROM saas.invoices + WHERE invoice_number LIKE v_year || '%'; + + RETURN v_year || LPAD(v_seq::TEXT, 6, '0'); +END; +$$ LANGUAGE plpgsql; + +-- Function: Generate ticket number +CREATE OR REPLACE FUNCTION saas.generate_ticket_number() +RETURNS VARCHAR AS $$ +DECLARE + v_date VARCHAR; + v_seq INTEGER; +BEGIN + v_date := TO_CHAR(CURRENT_DATE, 'YYMMDD'); + + SELECT COALESCE(MAX( + CAST(SUBSTRING(ticket_number FROM 8) AS INTEGER) + ), 0) + 1 + INTO v_seq + FROM saas.support_tickets + WHERE DATE(created_at) = CURRENT_DATE; + + RETURN 'TK' || v_date || LPAD(v_seq::TEXT, 4, '0'); +END; +$$ LANGUAGE plpgsql; + +-- ============================================================================ +-- TRIGGERS +-- ============================================================================ + +CREATE TRIGGER trg_plans_updated_at + BEFORE UPDATE ON saas.plans + FOR EACH ROW EXECUTE FUNCTION saas.update_updated_at(); + +CREATE TRIGGER trg_tenants_updated_at + BEFORE UPDATE ON saas.tenants + FOR EACH ROW EXECUTE FUNCTION saas.update_updated_at(); + +CREATE TRIGGER trg_subscriptions_updated_at + BEFORE UPDATE ON saas.subscriptions + FOR EACH ROW EXECUTE FUNCTION saas.update_updated_at(); + +CREATE TRIGGER trg_invoices_updated_at + BEFORE UPDATE ON saas.invoices + FOR EACH ROW EXECUTE FUNCTION saas.update_updated_at(); + +CREATE TRIGGER trg_payments_updated_at + BEFORE UPDATE ON saas.payments + FOR EACH ROW EXECUTE FUNCTION saas.update_updated_at(); + +CREATE TRIGGER trg_payment_methods_updated_at + BEFORE UPDATE ON saas.payment_methods + FOR EACH ROW EXECUTE FUNCTION saas.update_updated_at(); + +CREATE TRIGGER trg_usage_tracking_updated_at + BEFORE UPDATE ON saas.usage_tracking + FOR EACH ROW EXECUTE FUNCTION saas.update_updated_at(); + +CREATE TRIGGER trg_support_tickets_updated_at + BEFORE UPDATE ON saas.support_tickets + FOR EACH ROW EXECUTE FUNCTION saas.update_updated_at(); + +-- Auto-generate invoice number +CREATE OR REPLACE FUNCTION saas.auto_invoice_number() +RETURNS TRIGGER AS $$ +BEGIN + IF NEW.invoice_number IS NULL THEN + NEW.invoice_number := saas.generate_invoice_number(); + END IF; + RETURN NEW; +END; +$$ LANGUAGE plpgsql; + +CREATE TRIGGER trg_invoices_auto_number + BEFORE INSERT ON saas.invoices + FOR EACH ROW EXECUTE FUNCTION saas.auto_invoice_number(); + +-- Auto-generate ticket number +CREATE OR REPLACE FUNCTION saas.auto_ticket_number() +RETURNS TRIGGER AS $$ +BEGIN + IF NEW.ticket_number IS NULL THEN + NEW.ticket_number := saas.generate_ticket_number(); + END IF; + RETURN NEW; +END; +$$ LANGUAGE plpgsql; + +CREATE TRIGGER trg_tickets_auto_number + BEFORE INSERT ON saas.support_tickets + FOR EACH ROW EXECUTE FUNCTION saas.auto_ticket_number(); + +-- ============================================================================ +-- SEED DATA: Default plans +-- ============================================================================ + +INSERT INTO saas.plans (code, name, description, plan_type, price_monthly, price_yearly, max_users, max_products, max_sales_per_month, features) VALUES +-- POS Micro +('pos_micro', 'POS Micro', 'Punto de venta ultra-básico para pequeños negocios', 'pos_micro', 100.00, 1000.00, 1, 500, 1000, + '{"offline_mode": true, "whatsapp_basic": true, "reports_basic": true}'), + +-- ERP Básico +('erp_basic', 'ERP Básico', 'ERP completo pero austero para PyMEs', 'erp_basic', 300.00, 3000.00, 5, 10000, 5000, + '{"inventory": true, "sales": true, "purchases": true, "reports": true, "multi_warehouse": false}'), + +-- ERP Pro +('erp_pro', 'ERP Pro', 'ERP completo con módulos avanzados', 'erp_pro', 500.00, 5000.00, 10, 50000, 20000, + '{"inventory": true, "sales": true, "purchases": true, "reports": true, "multi_warehouse": true, "accounting_basic": true}'), + +-- Vertical (template) +('vertical_base', 'Vertical Industry', 'ERP especializado por industria', 'vertical', 1000.00, 10000.00, 20, 100000, 50000, + '{"inventory": true, "sales": true, "purchases": true, "reports": true, "multi_warehouse": true, "accounting": true, "industry_specific": true}'); + +-- Feature definitions +INSERT INTO saas.plan_features (plan_id, feature_code, feature_name, is_included, addon_price_monthly) VALUES +-- POS Micro add-ons +((SELECT id FROM saas.plans WHERE code = 'pos_micro'), 'cfdi', 'Facturación CFDI', FALSE, 50.00), +((SELECT id FROM saas.plans WHERE code = 'pos_micro'), 'whatsapp_pro', 'WhatsApp Avanzado', FALSE, 100.00), + +-- ERP Básico add-ons +((SELECT id FROM saas.plans WHERE code = 'erp_basic'), 'accounting', 'Contabilidad', FALSE, 150.00), +((SELECT id FROM saas.plans WHERE code = 'erp_basic'), 'hr', 'Recursos Humanos', FALSE, 100.00), +((SELECT id FROM saas.plans WHERE code = 'erp_basic'), 'cfdi', 'Facturación CFDI', FALSE, 100.00), +((SELECT id FROM saas.plans WHERE code = 'erp_basic'), 'extra_user', 'Usuario Extra', FALSE, 50.00), +((SELECT id FROM saas.plans WHERE code = 'erp_basic'), 'multi_warehouse', 'Multi-Almacén', FALSE, 100.00), + +-- ERP Pro included features +((SELECT id FROM saas.plans WHERE code = 'erp_pro'), 'accounting', 'Contabilidad Básica', TRUE, NULL), +((SELECT id FROM saas.plans WHERE code = 'erp_pro'), 'multi_warehouse', 'Multi-Almacén', TRUE, NULL), +((SELECT id FROM saas.plans WHERE code = 'erp_pro'), 'cfdi', 'Facturación CFDI', FALSE, 100.00), +((SELECT id FROM saas.plans WHERE code = 'erp_pro'), 'hr', 'Recursos Humanos', FALSE, 100.00), +((SELECT id FROM saas.plans WHERE code = 'erp_pro'), 'extra_user', 'Usuario Extra', FALSE, 50.00); + +-- ============================================================================ +-- VIEWS +-- ============================================================================ + +-- View: Active subscriptions with plan details +CREATE OR REPLACE VIEW saas.active_subscriptions_view AS +SELECT + s.id, + s.tenant_id, + t.business_name, + t.email, + p.code as plan_code, + p.name as plan_name, + s.billing_cycle, + s.current_price, + s.status, + s.current_period_start, + s.current_period_end, + s.trial_ends_at, + CASE + WHEN s.status = 'trial' THEN s.trial_ends_at - CURRENT_TIMESTAMP + ELSE s.current_period_end - CURRENT_TIMESTAMP + END as time_remaining +FROM saas.subscriptions s +JOIN saas.tenants t ON s.tenant_id = t.id +JOIN saas.plans p ON s.plan_id = p.id +WHERE s.status IN ('trial', 'active', 'past_due'); + +-- View: Revenue by plan +CREATE OR REPLACE VIEW saas.revenue_by_plan AS +SELECT + p.code as plan_code, + p.name as plan_name, + COUNT(s.id) as active_subscriptions, + SUM(s.current_price) as monthly_revenue +FROM saas.plans p +LEFT JOIN saas.subscriptions s ON p.id = s.plan_id + AND s.status IN ('active', 'trial') +GROUP BY p.id, p.code, p.name +ORDER BY monthly_revenue DESC NULLS LAST; + +-- ============================================================================ +-- COMMENTS +-- ============================================================================ + +COMMENT ON SCHEMA saas IS 'SaaS Layer - Billing, subscriptions, and multi-tenancy management'; +COMMENT ON TABLE saas.plans IS 'Available subscription plans with pricing'; +COMMENT ON TABLE saas.plan_features IS 'Features included or available as add-ons per plan'; +COMMENT ON TABLE saas.tenants IS 'All SaaS customers/businesses'; +COMMENT ON TABLE saas.subscriptions IS 'Active subscriptions per tenant'; +COMMENT ON TABLE saas.invoices IS 'Generated invoices for billing'; +COMMENT ON TABLE saas.payments IS 'Payment transactions'; +COMMENT ON TABLE saas.payment_methods IS 'Saved payment methods per tenant'; +COMMENT ON TABLE saas.usage_tracking IS 'Usage metrics for billing and limits'; +COMMENT ON TABLE saas.support_tickets IS 'Customer support tickets'; + +-- ============================================================================ +-- SCHEMA COMPLETE +-- ============================================================================ + +DO $$ +BEGIN + RAISE NOTICE 'SaaS Billing schema created successfully!'; + RAISE NOTICE 'Tables: 10 (plans, plan_features, tenants, subscriptions, invoices, invoice_items, payments, payment_methods, usage_tracking, support_tickets)'; + RAISE NOTICE 'Default plans: POS Micro (100 MXN), ERP Básico (300 MXN), ERP Pro (500 MXN), Vertical (1000+ MXN)'; +END $$; diff --git a/apps/saas/orchestration/CONTEXTO-SAAS.md b/apps/saas/orchestration/CONTEXTO-SAAS.md new file mode 100644 index 0000000..3857af0 --- /dev/null +++ b/apps/saas/orchestration/CONTEXTO-SAAS.md @@ -0,0 +1,122 @@ +# Contexto del Proyecto: SaaS Layer + +## Identificación + +| Campo | Valor | +|-------|-------| +| **Nombre** | SaaS Layer | +| **Tipo** | Infraestructura | +| **Nivel** | 2B.1 (Core de Suite) | +| **Suite** | erp-suite | +| **Ruta Base** | `projects/erp-suite/apps/saas/` | +| **Estado** | En Planificación | + +## Descripción + +Capa de servicios compartidos para gestión de multi-tenancy, billing, suscripciones y portal de clientes. + +## Responsabilidades + +1. **Billing** - Cobros, suscripciones, facturación +2. **Portal** - Self-service para clientes +3. **Admin** - Gestión de tenants +4. **Onboarding** - Registro de nuevos clientes + +## Stack Tecnológico + +```yaml +backend: + runtime: Node.js 20+ + framework: NestJS + language: TypeScript 5.3+ + +frontend: + framework: React 18 + bundler: Vite + styling: Tailwind CSS + +database: + engine: PostgreSQL 15+ + schema: saas + +integrations: + payments: Stripe, Conekta + invoicing: PAC CFDI (México) + notifications: Email, WhatsApp +``` + +## Variables del Proyecto + +```yaml +PROJECT_NAME: saas-layer +PROJECT_CODE: SAAS +SUITE: erp-suite + +# Paths +BILLING_ROOT: apps/saas/billing +PORTAL_ROOT: apps/saas/portal +ADMIN_ROOT: apps/saas/admin +ONBOARDING_ROOT: apps/saas/onboarding + +# Database +DB_SCHEMA: saas +MAX_TABLES: 15 +``` + +## Módulos + +| Módulo | Descripción | Prioridad | +|--------|-------------|-----------| +| billing | Suscripciones y cobros | P0 | +| portal | Portal de clientes | P1 | +| admin | Panel de administración | P1 | +| onboarding | Registro de clientes | P0 | + +## Planes de Suscripción + +| ID | Plan | Precio | Target | +|----|------|--------|--------| +| pos-micro | POS Micro | 100 MXN/mes | Mercado informal | +| erp-basic | ERP Básico | 300 MXN/mes | PyMEs | +| erp-pro | ERP Pro | 500 MXN/mes | PyMEs+ | +| vertical-x | Vertical | 1,000+ MXN/mes | Industrias específicas | + +## Dependencias + +### Productos que dependen de SaaS Layer + +- `products/pos-micro` - Billing, onboarding +- `products/erp-basico` - Billing, portal, onboarding +- `verticales/*` - Billing, portal, admin + +### Servicios externos + +- Stripe - Pagos internacionales +- Conekta - Pagos México +- PAC CFDI - Facturación electrónica +- SendGrid - Email transaccional +- WhatsApp Business API - Notificaciones + +## Roadmap + +### Sprint 1: Billing MVP +- [ ] Modelo de datos +- [ ] Integración Stripe básica +- [ ] Webhook de pagos +- [ ] API de suscripciones + +### Sprint 2: Onboarding +- [ ] Flujo de registro +- [ ] Selección de plan +- [ ] Configuración inicial +- [ ] Activación automática + +### Sprint 3: Portal +- [ ] Dashboard cliente +- [ ] Ver facturas +- [ ] Cambiar plan +- [ ] Soporte básico + +--- + +*Última actualización: 2025-12-08* diff --git a/apps/shared-libs/core/MIGRATION_GUIDE.md b/apps/shared-libs/core/MIGRATION_GUIDE.md new file mode 100644 index 0000000..85a40ed --- /dev/null +++ b/apps/shared-libs/core/MIGRATION_GUIDE.md @@ -0,0 +1,615 @@ +# Repository Pattern Migration Guide + +## Overview + +This guide helps you migrate from direct service-to-database access to the Repository pattern, implementing proper Dependency Inversion Principle (DIP) for the ERP-Suite project. + +## Why Migrate? + +### Problems with Current Approach +- **Tight Coupling**: Services directly depend on concrete implementations +- **Testing Difficulty**: Hard to mock database access +- **DIP Violation**: High-level modules depend on low-level modules +- **Code Duplication**: Similar queries repeated across services + +### Benefits of Repository Pattern +- **Loose Coupling**: Services depend on interfaces, not implementations +- **Testability**: Easy to mock repositories for unit tests +- **Maintainability**: Centralized data access logic +- **Flexibility**: Swap implementations without changing service code + +## Architecture + +``` +┌─────────────────────────────────────────────────┐ +│ Service Layer │ +│ (Depends on IRepository interfaces) │ +└────────────────────┬────────────────────────────┘ + │ (Dependency Inversion) + ▼ +┌─────────────────────────────────────────────────┐ +│ Repository Interfaces │ +│ IUserRepository, ITenantRepository, etc. │ +└────────────────────┬────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────┐ +│ Repository Implementations │ +│ UserRepository, TenantRepository, etc. │ +└────────────────────┬────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────┐ +│ Database (TypeORM) │ +└─────────────────────────────────────────────────┘ +``` + +## Step-by-Step Migration + +### Step 1: Create Repository Implementation + +**Before (Direct TypeORM in Service):** +```typescript +// services/user.service.ts +import { Injectable } from '@nestjs/common'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository } from 'typeorm'; +import { User } from '@erp-suite/core'; + +@Injectable() +export class UserService { + constructor( + @InjectRepository(User) + private userRepo: Repository, + ) {} + + async findByEmail(email: string): Promise { + return this.userRepo.findOne({ where: { email } }); + } +} +``` + +**After (Create Repository):** +```typescript +// repositories/user.repository.ts +import { Injectable } from '@nestjs/common'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository } from 'typeorm'; +import { + User, + IUserRepository, + ServiceContext, + PaginatedResult, + PaginationOptions, +} from '@erp-suite/core'; + +@Injectable() +export class UserRepository implements IUserRepository { + constructor( + @InjectRepository(User) + private readonly ormRepo: Repository, + ) {} + + async findById(ctx: ServiceContext, id: string): Promise { + return this.ormRepo.findOne({ + where: { id, tenantId: ctx.tenantId }, + }); + } + + async findByEmail(ctx: ServiceContext, email: string): Promise { + return this.ormRepo.findOne({ + where: { email, tenantId: ctx.tenantId }, + }); + } + + async findByTenantId(ctx: ServiceContext, tenantId: string): Promise { + return this.ormRepo.find({ + where: { tenantId }, + }); + } + + async findActiveUsers( + ctx: ServiceContext, + filters?: PaginationOptions, + ): Promise> { + const page = filters?.page || 1; + const pageSize = filters?.pageSize || 20; + + const [data, total] = await this.ormRepo.findAndCount({ + where: { tenantId: ctx.tenantId, status: 'active' }, + skip: (page - 1) * pageSize, + take: pageSize, + }); + + return { + data, + meta: { + page, + pageSize, + totalRecords: total, + totalPages: Math.ceil(total / pageSize), + }, + }; + } + + async updateLastLogin(ctx: ServiceContext, userId: string): Promise { + await this.ormRepo.update( + { id: userId, tenantId: ctx.tenantId }, + { lastLoginAt: new Date() }, + ); + } + + async updatePasswordHash( + ctx: ServiceContext, + userId: string, + passwordHash: string, + ): Promise { + await this.ormRepo.update( + { id: userId, tenantId: ctx.tenantId }, + { passwordHash }, + ); + } + + // Implement remaining IRepository methods... + async create(ctx: ServiceContext, data: Partial): Promise { + const user = this.ormRepo.create({ + ...data, + tenantId: ctx.tenantId, + }); + return this.ormRepo.save(user); + } + + async update( + ctx: ServiceContext, + id: string, + data: Partial, + ): Promise { + await this.ormRepo.update( + { id, tenantId: ctx.tenantId }, + data, + ); + return this.findById(ctx, id); + } + + // ... implement other methods +} +``` + +### Step 2: Register Repository in Module + +```typescript +// user.module.ts +import { Module } from '@nestjs/common'; +import { TypeOrmModule } from '@nestjs/typeorm'; +import { User } from '@erp-suite/core'; +import { UserService } from './services/user.service'; +import { UserRepository } from './repositories/user.repository'; +import { UserController } from './controllers/user.controller'; + +@Module({ + imports: [TypeOrmModule.forFeature([User])], + providers: [ + UserService, + UserRepository, + // Register in RepositoryFactory + { + provide: 'REPOSITORY_FACTORY_SETUP', + useFactory: (userRepository: UserRepository) => { + const factory = RepositoryFactory.getInstance(); + factory.register('UserRepository', userRepository); + }, + inject: [UserRepository], + }, + ], + controllers: [UserController], + exports: [UserRepository], +}) +export class UserModule {} +``` + +### Step 3: Update Service to Use Repository + +```typescript +// services/user.service.ts +import { Injectable } from '@nestjs/common'; +import { + IUserRepository, + ServiceContext, + RepositoryFactory, +} from '@erp-suite/core'; + +@Injectable() +export class UserService { + private readonly userRepository: IUserRepository; + + constructor() { + const factory = RepositoryFactory.getInstance(); + this.userRepository = factory.getRequired('UserRepository'); + } + + async findByEmail( + ctx: ServiceContext, + email: string, + ): Promise { + return this.userRepository.findByEmail(ctx, email); + } + + async getActiveUsers( + ctx: ServiceContext, + page: number = 1, + pageSize: number = 20, + ): Promise> { + return this.userRepository.findActiveUsers(ctx, { page, pageSize }); + } + + async updateLastLogin(ctx: ServiceContext, userId: string): Promise { + await this.userRepository.updateLastLogin(ctx, userId); + } +} +``` + +### Step 4: Alternative - Use Decorator Pattern + +```typescript +// services/user.service.ts (with decorator) +import { Injectable } from '@nestjs/common'; +import { + IUserRepository, + InjectRepository, + ServiceContext, +} from '@erp-suite/core'; + +@Injectable() +export class UserService { + @InjectRepository('UserRepository') + private readonly userRepository: IUserRepository; + + async findByEmail( + ctx: ServiceContext, + email: string, + ): Promise { + return this.userRepository.findByEmail(ctx, email); + } +} +``` + +## Testing with Repositories + +### Create Mock Repository + +```typescript +// tests/mocks/user.repository.mock.ts +import { IUserRepository, ServiceContext, User } from '@erp-suite/core'; + +export class MockUserRepository implements IUserRepository { + private users: User[] = []; + + async findById(ctx: ServiceContext, id: string): Promise { + return this.users.find(u => u.id === id) || null; + } + + async findByEmail(ctx: ServiceContext, email: string): Promise { + return this.users.find(u => u.email === email) || null; + } + + async create(ctx: ServiceContext, data: Partial): Promise { + const user = { id: 'test-id', ...data } as User; + this.users.push(user); + return user; + } + + // Implement other methods as needed +} +``` + +### Use Mock in Tests + +```typescript +// tests/user.service.spec.ts +import { Test } from '@nestjs/testing'; +import { UserService } from '../services/user.service'; +import { RepositoryFactory } from '@erp-suite/core'; +import { MockUserRepository } from './mocks/user.repository.mock'; + +describe('UserService', () => { + let service: UserService; + let mockRepo: MockUserRepository; + let factory: RepositoryFactory; + + beforeEach(async () => { + mockRepo = new MockUserRepository(); + factory = RepositoryFactory.getInstance(); + factory.clear(); // Clear previous registrations + factory.register('UserRepository', mockRepo); + + const module = await Test.createTestingModule({ + providers: [UserService], + }).compile(); + + service = module.get(UserService); + }); + + afterEach(() => { + factory.clear(); + }); + + it('should find user by email', async () => { + const ctx = { tenantId: 'tenant-1', userId: 'user-1' }; + const user = await mockRepo.create(ctx, { + email: 'test@example.com', + fullName: 'Test User', + }); + + const found = await service.findByEmail(ctx, 'test@example.com'); + expect(found).toEqual(user); + }); +}); +``` + +## Common Repository Patterns + +### 1. Tenant-Scoped Queries + +```typescript +async findAll( + ctx: ServiceContext, + filters?: PaginationOptions, +): Promise> { + // Always filter by tenant + const where = { tenantId: ctx.tenantId }; + + const [data, total] = await this.ormRepo.findAndCount({ + where, + skip: ((filters?.page || 1) - 1) * (filters?.pageSize || 20), + take: filters?.pageSize || 20, + }); + + return { + data, + meta: { + page: filters?.page || 1, + pageSize: filters?.pageSize || 20, + totalRecords: total, + totalPages: Math.ceil(total / (filters?.pageSize || 20)), + }, + }; +} +``` + +### 2. Audit Trail Integration + +```typescript +async create(ctx: ServiceContext, data: Partial): Promise { + const entity = this.ormRepo.create({ + ...data, + tenantId: ctx.tenantId, + createdBy: ctx.userId, + }); + + const saved = await this.ormRepo.save(entity); + + // Log audit trail + await this.auditRepository.logAction(ctx, { + tenantId: ctx.tenantId, + userId: ctx.userId, + action: 'CREATE', + entityType: this.entityName, + entityId: saved.id, + timestamp: new Date(), + }); + + return saved; +} +``` + +### 3. Complex Queries with QueryBuilder + +```typescript +async findWithRelations( + ctx: ServiceContext, + filters: any, +): Promise { + return this.ormRepo + .createQueryBuilder('user') + .leftJoinAndSelect('user.tenant', 'tenant') + .where('user.tenantId = :tenantId', { tenantId: ctx.tenantId }) + .andWhere('user.status = :status', { status: 'active' }) + .orderBy('user.createdAt', 'DESC') + .getMany(); +} +``` + +## Migration Checklist + +For each service: + +- [ ] Identify all database access patterns +- [ ] Create repository interface (or use existing IRepository) +- [ ] Implement repository class +- [ ] Register repository in module +- [ ] Update service to use repository +- [ ] Create mock repository for tests +- [ ] Update tests to use mock repository +- [ ] Verify multi-tenancy filtering +- [ ] Add audit logging if needed +- [ ] Document any custom repository methods + +## Repository Factory Best Practices + +### 1. Initialize Once at Startup + +```typescript +// main.ts or app.module.ts +import { RepositoryFactory } from '@erp-suite/core'; + +async function bootstrap() { + const app = await NestFactory.create(AppModule); + + // Initialize factory with all repositories + const factory = RepositoryFactory.getInstance(); + + // Repositories are registered in their respective modules + console.log( + `Registered repositories: ${factory.getRegisteredNames().join(', ')}`, + ); + + await app.listen(3000); +} +``` + +### 2. Use Dependency Injection + +```typescript +// Prefer constructor injection with factory +@Injectable() +export class MyService { + private readonly userRepo: IUserRepository; + private readonly tenantRepo: ITenantRepository; + + constructor() { + const factory = RepositoryFactory.getInstance(); + this.userRepo = factory.getRequired('UserRepository'); + this.tenantRepo = factory.getRequired('TenantRepository'); + } +} +``` + +### 3. Testing Isolation + +```typescript +describe('MyService', () => { + let factory: RepositoryFactory; + + beforeEach(() => { + factory = RepositoryFactory.getInstance(); + factory.clear(); // Ensure clean slate + factory.register('UserRepository', mockUserRepo); + }); + + afterEach(() => { + factory.clear(); // Clean up + }); +}); +``` + +## Troubleshooting + +### Error: "Repository 'XYZ' not found in factory registry" + +**Cause**: Repository not registered before being accessed. + +**Solution**: Ensure repository is registered in module providers: + +```typescript +{ + provide: 'REPOSITORY_FACTORY_SETUP', + useFactory: (repo: XYZRepository) => { + RepositoryFactory.getInstance().register('XYZRepository', repo); + }, + inject: [XYZRepository], +} +``` + +### Error: "Repository 'XYZ' is already registered" + +**Cause**: Attempting to register a repository that already exists. + +**Solution**: Use `replace()` instead of `register()`, or check if already registered: + +```typescript +const factory = RepositoryFactory.getInstance(); +if (!factory.has('XYZRepository')) { + factory.register('XYZRepository', repo); +} +``` + +### Circular Dependency Issues + +**Cause**: Services and repositories depend on each other. + +**Solution**: Use `forwardRef()` or restructure dependencies: + +```typescript +@Injectable() +export class UserService { + constructor( + @Inject(forwardRef(() => UserRepository)) + private userRepo: UserRepository, + ) {} +} +``` + +## Advanced Patterns + +### Generic Repository Base Class + +```typescript +// repositories/base.repository.ts +import { Repository } from 'typeorm'; +import { IRepository, ServiceContext } from '@erp-suite/core'; + +export abstract class BaseRepositoryImpl implements IRepository { + constructor(protected readonly ormRepo: Repository) {} + + async findById(ctx: ServiceContext, id: string): Promise { + return this.ormRepo.findOne({ + where: { id, tenantId: ctx.tenantId } as any, + }); + } + + // Implement common methods once... +} + +// Use in specific repositories +export class UserRepository extends BaseRepositoryImpl implements IUserRepository { + async findByEmail(ctx: ServiceContext, email: string): Promise { + return this.ormRepo.findOne({ + where: { email, tenantId: ctx.tenantId }, + }); + } +} +``` + +### Repository Composition + +```typescript +// Compose multiple repositories +export class OrderService { + @InjectRepository('OrderRepository') + private orderRepo: IOrderRepository; + + @InjectRepository('ProductRepository') + private productRepo: IProductRepository; + + @InjectRepository('CustomerRepository') + private customerRepo: ICustomerRepository; + + async createOrder(ctx: ServiceContext, data: CreateOrderDto) { + const customer = await this.customerRepo.findById(ctx, data.customerId); + const products = await this.productRepo.findMany(ctx, { + id: In(data.productIds), + }); + + const order = await this.orderRepo.create(ctx, { + customerId: customer.id, + items: products.map(p => ({ productId: p.id, quantity: 1 })), + }); + + return order; + } +} +``` + +## Resources + +- [Dependency Inversion Principle](https://en.wikipedia.org/wiki/Dependency_inversion_principle) +- [Repository Pattern](https://martinfowler.com/eaaCatalog/repository.html) +- [Factory Pattern](https://refactoring.guru/design-patterns/factory-method) +- [ERP-Suite Core Library](/apps/shared-libs/core/README.md) + +## Support + +For questions or issues: +- Check existing implementations in `/apps/shared-libs/core/` +- Review test files for usage examples +- Open an issue on the project repository diff --git a/apps/shared-libs/core/constants/database.constants.ts b/apps/shared-libs/core/constants/database.constants.ts new file mode 100644 index 0000000..c2f3cae --- /dev/null +++ b/apps/shared-libs/core/constants/database.constants.ts @@ -0,0 +1,163 @@ +/** + * Database Constants - Schema and table names for ERP-Suite + * + * @module @erp-suite/core/constants + */ + +/** + * Database schema names + */ +export const DB_SCHEMAS = { + AUTH: 'auth', + ERP: 'erp', + INVENTORY: 'inventory', + SALES: 'sales', + PURCHASE: 'purchase', + ACCOUNTING: 'accounting', + HR: 'hr', + CRM: 'crm', + PUBLIC: 'public', +} as const; + +/** + * Auth schema tables + */ +export const AUTH_TABLES = { + USERS: 'users', + TENANTS: 'tenants', + ROLES: 'roles', + PERMISSIONS: 'permissions', + USER_ROLES: 'user_roles', + ROLE_PERMISSIONS: 'role_permissions', + SESSIONS: 'sessions', +} as const; + +/** + * ERP schema tables + */ +export const ERP_TABLES = { + PARTNERS: 'partners', + CONTACTS: 'contacts', + ADDRESSES: 'addresses', + PRODUCTS: 'products', + CATEGORIES: 'categories', + PRICE_LISTS: 'price_lists', + TAX_RATES: 'tax_rates', +} as const; + +/** + * Inventory schema tables + */ +export const INVENTORY_TABLES = { + WAREHOUSES: 'warehouses', + LOCATIONS: 'locations', + STOCK_MOVES: 'stock_moves', + STOCK_LEVELS: 'stock_levels', + ADJUSTMENTS: 'adjustments', +} as const; + +/** + * Sales schema tables + */ +export const SALES_TABLES = { + ORDERS: 'orders', + ORDER_LINES: 'order_lines', + INVOICES: 'invoices', + INVOICE_LINES: 'invoice_lines', + QUOTES: 'quotes', + QUOTE_LINES: 'quote_lines', +} as const; + +/** + * Purchase schema tables + */ +export const PURCHASE_TABLES = { + ORDERS: 'orders', + ORDER_LINES: 'order_lines', + RECEIPTS: 'receipts', + RECEIPT_LINES: 'receipt_lines', + BILLS: 'bills', + BILL_LINES: 'bill_lines', +} as const; + +/** + * Accounting schema tables + */ +export const ACCOUNTING_TABLES = { + ACCOUNTS: 'accounts', + JOURNALS: 'journals', + JOURNAL_ENTRIES: 'journal_entries', + JOURNAL_LINES: 'journal_lines', + FISCAL_YEARS: 'fiscal_years', + PERIODS: 'periods', +} as const; + +/** + * HR schema tables + */ +export const HR_TABLES = { + EMPLOYEES: 'employees', + DEPARTMENTS: 'departments', + POSITIONS: 'positions', + CONTRACTS: 'contracts', + PAYROLLS: 'payrolls', + ATTENDANCES: 'attendances', +} as const; + +/** + * CRM schema tables + */ +export const CRM_TABLES = { + LEADS: 'leads', + OPPORTUNITIES: 'opportunities', + ACTIVITIES: 'activities', + CAMPAIGNS: 'campaigns', + PIPELINE_STAGES: 'pipeline_stages', +} as const; + +/** + * Common column names used across all tables + */ +export const COMMON_COLUMNS = { + ID: 'id', + TENANT_ID: 'tenant_id', + CREATED_AT: 'created_at', + CREATED_BY_ID: 'created_by_id', + UPDATED_AT: 'updated_at', + UPDATED_BY_ID: 'updated_by_id', + DELETED_AT: 'deleted_at', + DELETED_BY_ID: 'deleted_by_id', +} as const; + +/** + * Status constants + */ +export const STATUS = { + ACTIVE: 'active', + INACTIVE: 'inactive', + SUSPENDED: 'suspended', + PENDING: 'pending', + APPROVED: 'approved', + REJECTED: 'rejected', + DRAFT: 'draft', + CONFIRMED: 'confirmed', + CANCELLED: 'cancelled', + DONE: 'done', +} as const; + +/** + * Helper function to build fully qualified table name + * + * @param schema - Schema name + * @param table - Table name + * @returns Fully qualified table name + * + * @example + * ```typescript + * const tableName = getFullTableName(DB_SCHEMAS.AUTH, AUTH_TABLES.USERS); + * // Returns: 'auth.users' + * ``` + */ +export function getFullTableName(schema: string, table: string): string { + return `${schema}.${table}`; +} diff --git a/apps/shared-libs/core/database/policies/CENTRALIZATION-SUMMARY.md b/apps/shared-libs/core/database/policies/CENTRALIZATION-SUMMARY.md new file mode 100644 index 0000000..7fc9c1d --- /dev/null +++ b/apps/shared-libs/core/database/policies/CENTRALIZATION-SUMMARY.md @@ -0,0 +1,390 @@ +# RLS Policies Centralization - Summary + +## Project Overview + +**Project**: ERP-Suite +**Objective**: Centralize duplicated RLS policies in shared-libs +**Location**: `/home/isem/workspace/projects/erp-suite/apps/shared-libs/core/database/policies/` +**Date**: 2025-12-12 + +--- + +## Files Created + +### 1. `rls-policies.sql` (17 KB, 514 lines) +- 5 generic RLS policy templates (SQL comments) +- Helper functions (`get_current_tenant_id`, `get_current_user_id`, etc.) +- Utility functions to apply policies dynamically +- Migration helpers and testing functions +- Complete with documentation and examples + +### 2. `apply-rls.ts` (15 KB, 564 lines) +- TypeScript API for applying RLS policies +- 18+ exported functions +- Type-safe interfaces and enums +- Complete error handling +- Full JSDoc documentation + +### 3. `README.md` (8.6 KB, 324 lines) +- Comprehensive documentation +- Usage examples for all policy types +- API reference table +- Migration guide +- Troubleshooting section +- Best practices + +### 4. `usage-example.ts` (12 KB, 405 lines) +- 12 complete working examples +- Covers all use cases +- Ready to run +- Demonstrates best practices + +### 5. `migration-example.ts` (4.9 KB, ~150 lines) +- Migration template for replacing duplicated policies +- `up`/`down` functions +- TypeORM format included +- Complete rollback support + +### 6. `CENTRALIZATION-SUMMARY.md` (this file) +- Project summary and overview +- Quick reference guide + +--- + +## 5 Generic RLS Policies + +### 1. TENANT_ISOLATION_POLICY +- **Purpose**: Multi-tenant data isolation +- **Usage**: All tables with `tenant_id` column +- **SQL Function**: `apply_tenant_isolation_policy(schema, table, tenant_column)` +- **TypeScript**: `applyTenantIsolationPolicy(pool, schema, table, tenantColumn)` + +### 2. USER_DATA_POLICY +- **Purpose**: User-specific data access +- **Usage**: Tables with `created_by`, `assigned_to`, or `owner_id` +- **SQL Function**: `apply_user_data_policy(schema, table, user_columns[])` +- **TypeScript**: `applyUserDataPolicy(pool, schema, table, userColumns)` + +### 3. READ_OWN_DATA_POLICY +- **Purpose**: Read-only access to own data +- **Usage**: SELECT-only restrictions +- **Template**: Available in SQL (manual application required) + +### 4. WRITE_OWN_DATA_POLICY +- **Purpose**: Write access to own data +- **Usage**: INSERT/UPDATE/DELETE restrictions +- **Template**: Available in SQL (manual application required) + +### 5. ADMIN_BYPASS_POLICY +- **Purpose**: Admin access for support and management +- **Usage**: All tables requiring admin override capability +- **SQL Function**: `apply_admin_bypass_policy(schema, table)` +- **TypeScript**: `applyAdminBypassPolicy(pool, schema, table)` + +--- + +## Exported Functions (18+) + +### Policy Application +| Function | Description | +|----------|-------------| +| `applyTenantIsolationPolicy()` | Apply tenant isolation to a table | +| `applyAdminBypassPolicy()` | Apply admin bypass to a table | +| `applyUserDataPolicy()` | Apply user data policy to a table | +| `applyCompleteRlsPolicies()` | Apply tenant + admin policies | +| `applyCompletePoliciesForSchema()` | Apply to multiple tables in schema | +| `batchApplyRlsPolicies()` | Batch apply with custom configs | + +### RLS Management +| Function | Description | +|----------|-------------| +| `enableRls()` | Enable RLS on a table | +| `disableRls()` | Disable RLS on a table | +| `isRlsEnabled()` | Check if RLS is enabled | +| `listRlsPolicies()` | List all policies on a table | +| `dropRlsPolicy()` | Drop a specific policy | +| `dropAllRlsPolicies()` | Drop all policies from a table | + +### Status & Inspection +| Function | Description | +|----------|-------------| +| `getSchemaRlsStatus()` | Get RLS status for all tables in schema | + +### Context Management +| Function | Description | +|----------|-------------| +| `setRlsContext()` | Set session context (tenant, user, role) | +| `clearRlsContext()` | Clear session context | +| `withRlsContext()` | Execute function with RLS context | + +### Types & Enums +- `RlsPolicyType` (enum) +- `RlsPolicyOptions` (interface) +- `RlsPolicyStatus` (interface) + +--- + +## Integration + +**Updated**: `apps/shared-libs/core/index.ts` +- All RLS functions exported +- Available via `@erp-suite/core` package +- Type definitions included + +--- + +## Usage Examples + +### TypeScript + +```typescript +import { + applyCompleteRlsPolicies, + applyCompletePoliciesForSchema, + withRlsContext +} from '@erp-suite/core'; +import { Pool } from 'pg'; + +const pool = new Pool({ /* config */ }); + +// Apply to single table +await applyCompleteRlsPolicies(pool, 'core', 'partners'); + +// Apply to multiple tables +await applyCompletePoliciesForSchema(pool, 'inventory', [ + 'products', 'warehouses', 'locations' +]); + +// Query with RLS context +const result = await withRlsContext(pool, { + tenantId: 'tenant-uuid', + userId: 'user-uuid', + userRole: 'user', +}, async (client) => { + return await client.query('SELECT * FROM core.partners'); +}); +``` + +### SQL (Direct) + +```sql +-- Install functions first +\i apps/shared-libs/core/database/policies/rls-policies.sql + +-- Apply policies +SELECT apply_tenant_isolation_policy('core', 'partners'); +SELECT apply_admin_bypass_policy('core', 'partners'); +SELECT apply_complete_rls_policies('inventory', 'products'); + +-- Apply to multiple tables +DO $$ +BEGIN + PERFORM apply_complete_rls_policies('core', 'partners'); + PERFORM apply_complete_rls_policies('core', 'addresses'); + PERFORM apply_complete_rls_policies('core', 'notes'); +END $$; +``` + +--- + +## Benefits + +### 1. No Duplication +- 5 RLS functions previously duplicated across 5+ verticales +- Now centralized in shared-libs +- Single source of truth +- Easier to maintain and update + +### 2. Consistency +- All modules use same policy patterns +- Easier to audit security +- Standardized approach across entire ERP +- Reduced risk of configuration errors + +### 3. Type Safety +- TypeScript interfaces for all functions +- Compile-time error checking +- Better IDE autocomplete +- Catch errors before runtime + +### 4. Testing +- Comprehensive examples included +- Migration templates provided +- Easy to verify RLS isolation +- Automated testing possible + +### 5. Documentation +- Complete API reference +- Usage examples for all scenarios +- Troubleshooting guide +- Best practices documented + +--- + +## Migration Path + +### BEFORE (Duplicated in each vertical) + +``` +apps/verticales/construccion/database/init/02-rls-functions.sql +apps/verticales/mecanicas-diesel/database/init/02-rls-functions.sql +apps/verticales/retail/database/init/03-rls.sql +apps/verticales/vidrio-templado/database/init/02-rls.sql +apps/verticales/clinicas/database/init/02-rls.sql +``` + +Each vertical had: +- Duplicated helper functions +- Similar but slightly different policies +- Inconsistent naming +- Harder to maintain + +### AFTER (Centralized) + +``` +apps/shared-libs/core/database/policies/ +├── rls-policies.sql # SQL functions and templates +├── apply-rls.ts # TypeScript API +├── README.md # Documentation +├── usage-example.ts # Working examples +├── migration-example.ts # Migration template +└── CENTRALIZATION-SUMMARY.md # This file +``` + +Verticales now use: + +```typescript +import { applyCompleteRlsPolicies } from '@erp-suite/core'; +await applyCompleteRlsPolicies(pool, schema, table, tenantColumn); +``` + +--- + +## Directory Structure + +``` +/home/isem/workspace/projects/erp-suite/ +└── apps/ + └── shared-libs/ + └── core/ + ├── database/ + │ └── policies/ + │ ├── rls-policies.sql (17 KB, 514 lines) + │ ├── apply-rls.ts (15 KB, 564 lines) + │ ├── README.md (8.6 KB, 324 lines) + │ ├── usage-example.ts (12 KB, 405 lines) + │ ├── migration-example.ts (4.9 KB, ~150 lines) + │ └── CENTRALIZATION-SUMMARY.md (this file) + └── index.ts (updated with exports) +``` + +--- + +## Next Steps + +### 1. Install SQL Functions +```bash +cd /home/isem/workspace/projects/erp-suite +psql -d erp_suite -f apps/shared-libs/core/database/policies/rls-policies.sql +``` + +### 2. Update Vertical Migrations +Replace duplicated RLS code with imports from `@erp-suite/core`: + +```typescript +// Old way +// CREATE OR REPLACE FUNCTION get_current_tenant_id() ... + +// New way +import { applyCompleteRlsPolicies } from '@erp-suite/core'; +await applyCompleteRlsPolicies(pool, 'schema', 'table'); +``` + +### 3. Remove Duplicated Files +After migration, remove old RLS files from verticales: +- `apps/verticales/*/database/init/02-rls-functions.sql` + +### 4. Test RLS Isolation +Run the examples in `usage-example.ts` to verify: +```bash +ts-node apps/shared-libs/core/database/policies/usage-example.ts +``` + +### 5. Update Documentation +Update each vertical's README to reference centralized RLS policies. + +--- + +## Quick Reference + +### Apply RLS to All ERP Core Tables + +```typescript +import { batchApplyRlsPolicies } from '@erp-suite/core'; + +const erpCoreTables = [ + { schema: 'core', table: 'partners' }, + { schema: 'core', table: 'addresses' }, + { schema: 'inventory', table: 'products' }, + { schema: 'sales', table: 'sales_orders' }, + { schema: 'purchase', table: 'purchase_orders' }, + { schema: 'financial', table: 'invoices' }, + // ... more tables +]; + +await batchApplyRlsPolicies(pool, erpCoreTables); +``` + +### Check RLS Status + +```typescript +import { getSchemaRlsStatus } from '@erp-suite/core'; + +const status = await getSchemaRlsStatus(pool, 'core'); +status.forEach(s => { + console.log(`${s.table}: RLS ${s.rlsEnabled ? '✓' : '✗'}, ${s.policies.length} policies`); +}); +``` + +### Query with Context + +```typescript +import { withRlsContext } from '@erp-suite/core'; + +const records = await withRlsContext(pool, { + tenantId: 'tenant-uuid', + userId: 'user-uuid', + userRole: 'user', +}, async (client) => { + const result = await client.query('SELECT * FROM core.partners'); + return result.rows; +}); +``` + +--- + +## Support + +For questions or issues: +1. Check the `README.md` for detailed documentation +2. Review `usage-example.ts` for working examples +3. Consult `migration-example.ts` for migration patterns +4. Contact the ERP-Suite core team + +--- + +## Statistics + +- **Total Lines**: 1,807 lines (SQL + TypeScript + Markdown) +- **Total Files**: 6 files +- **Total Size**: ~57 KB +- **Functions**: 18+ TypeScript functions, 8+ SQL functions +- **Policy Types**: 5 generic templates +- **Examples**: 12 working examples +- **Documentation**: Complete API reference + guides + +--- + +**Created**: 2025-12-12 +**Author**: Claude (ERP-Suite Core Team) +**Version**: 1.0.0 diff --git a/apps/shared-libs/core/database/policies/README.md b/apps/shared-libs/core/database/policies/README.md new file mode 100644 index 0000000..b2b9198 --- /dev/null +++ b/apps/shared-libs/core/database/policies/README.md @@ -0,0 +1,324 @@ +# RLS Policies - ERP Suite Shared Library + +Centralized Row-Level Security (RLS) policies for multi-tenant isolation across all ERP-Suite modules. + +## Overview + +This module provides: + +- **5 generic RLS policy templates** (SQL) +- **TypeScript functions** for dynamic policy application +- **Helper utilities** for RLS management and context handling + +## Files + +- `rls-policies.sql` - SQL policy templates and helper functions +- `apply-rls.ts` - TypeScript utilities for applying RLS policies +- `README.md` - This documentation +- `usage-example.ts` - Usage examples + +## RLS Policy Types + +### 1. Tenant Isolation Policy + +**Purpose**: Ensures users can only access data from their own tenant. + +**Usage**: Apply to all tables with `tenant_id` column. + +```sql +-- SQL +SELECT apply_tenant_isolation_policy('core', 'partners'); +``` + +```typescript +// TypeScript +import { applyTenantIsolationPolicy } from '@erp-suite/core'; +await applyTenantIsolationPolicy(pool, 'core', 'partners'); +``` + +### 2. User Data Policy + +**Purpose**: Restricts access to data created by or assigned to the current user. + +**Usage**: Apply to tables with `created_by`, `assigned_to`, or `owner_id` columns. + +```sql +-- SQL +SELECT apply_user_data_policy('projects', 'tasks', ARRAY['created_by', 'assigned_to']::TEXT[]); +``` + +```typescript +// TypeScript +import { applyUserDataPolicy } from '@erp-suite/core'; +await applyUserDataPolicy(pool, 'projects', 'tasks', ['created_by', 'assigned_to']); +``` + +### 3. Read Own Data Policy + +**Purpose**: Allows users to read only their own data (SELECT only). + +**Usage**: Apply when users need read access to own data but restricted write. + +```sql +-- See rls-policies.sql for template +-- No dedicated function yet - use custom SQL +``` + +### 4. Write Own Data Policy + +**Purpose**: Allows users to insert/update/delete only their own data. + +**Usage**: Companion to READ_OWN_DATA_POLICY for write operations. + +```sql +-- See rls-policies.sql for template +-- No dedicated function yet - use custom SQL +``` + +### 5. Admin Bypass Policy + +**Purpose**: Allows admin users to bypass RLS restrictions for support/management. + +**Usage**: Apply as permissive policy to allow admin full access. + +```sql +-- SQL +SELECT apply_admin_bypass_policy('financial', 'invoices'); +``` + +```typescript +// TypeScript +import { applyAdminBypassPolicy } from '@erp-suite/core'; +await applyAdminBypassPolicy(pool, 'financial', 'invoices'); +``` + +## Quick Start + +### 1. Apply RLS to Database + +First, run the SQL functions to create the helper functions: + +```bash +psql -d your_database -f apps/shared-libs/core/database/policies/rls-policies.sql +``` + +### 2. Apply Policies to Tables + +#### Single Table + +```typescript +import { applyCompleteRlsPolicies } from '@erp-suite/core'; +import { Pool } from 'pg'; + +const pool = new Pool({ /* config */ }); + +// Apply tenant isolation + admin bypass +await applyCompleteRlsPolicies(pool, 'core', 'partners'); +``` + +#### Multiple Tables + +```typescript +import { applyCompletePoliciesForSchema } from '@erp-suite/core'; + +await applyCompletePoliciesForSchema(pool, 'inventory', [ + 'products', + 'warehouses', + 'locations', + 'lots' +]); +``` + +#### Batch Application + +```typescript +import { batchApplyRlsPolicies } from '@erp-suite/core'; + +await batchApplyRlsPolicies(pool, [ + { schema: 'core', table: 'partners' }, + { schema: 'core', table: 'addresses' }, + { schema: 'inventory', table: 'products', includeAdminBypass: false }, + { schema: 'projects', table: 'tasks', tenantColumn: 'company_id' }, +]); +``` + +### 3. Set RLS Context + +Before querying data, set the session context: + +```typescript +import { setRlsContext, withRlsContext } from '@erp-suite/core'; + +// Manual context setting +await setRlsContext(pool, { + tenantId: 'uuid-tenant-id', + userId: 'uuid-user-id', + userRole: 'admin', +}); + +// Or use helper for scoped context +const result = await withRlsContext(pool, { + tenantId: 'tenant-uuid', + userId: 'user-uuid', + userRole: 'user', +}, async (client) => { + return await client.query('SELECT * FROM core.partners'); +}); +``` + +## API Reference + +### Policy Application + +| Function | Description | +|----------|-------------| +| `applyTenantIsolationPolicy()` | Apply tenant isolation policy to a table | +| `applyAdminBypassPolicy()` | Apply admin bypass policy to a table | +| `applyUserDataPolicy()` | Apply user data policy to a table | +| `applyCompleteRlsPolicies()` | Apply complete policies (tenant + admin) | +| `applyCompletePoliciesForSchema()` | Apply to multiple tables in a schema | +| `batchApplyRlsPolicies()` | Batch apply policies to multiple tables | + +### RLS Management + +| Function | Description | +|----------|-------------| +| `enableRls()` | Enable RLS on a table | +| `disableRls()` | Disable RLS on a table | +| `isRlsEnabled()` | Check if RLS is enabled | +| `listRlsPolicies()` | List all policies on a table | +| `dropRlsPolicy()` | Drop a specific policy | +| `dropAllRlsPolicies()` | Drop all policies from a table | + +### Status and Inspection + +| Function | Description | +|----------|-------------| +| `getSchemaRlsStatus()` | Get RLS status for all tables in a schema | + +### Context Management + +| Function | Description | +|----------|-------------| +| `setRlsContext()` | Set session context for RLS | +| `clearRlsContext()` | Clear RLS context from session | +| `withRlsContext()` | Execute function within RLS context | + +## Migration Guide + +### From Vertical-Specific RLS to Centralized + +**Before** (in vertical migrations): + +```sql +-- apps/verticales/construccion/database/migrations/001-rls.sql +CREATE OR REPLACE FUNCTION get_current_tenant_id() ...; +CREATE POLICY tenant_isolation_projects ON projects.projects ...; +``` + +**After** (using shared-libs): + +```typescript +// apps/verticales/construccion/database/migrations/001-rls.ts +import { applyCompleteRlsPolicies } from '@erp-suite/core'; +import { pool } from '../db'; + +export async function up() { + await applyCompleteRlsPolicies(pool, 'projects', 'projects'); +} +``` + +## Best Practices + +1. **Always apply tenant isolation** to tables with `tenant_id` +2. **Include admin bypass** for support and troubleshooting (default: enabled) +3. **Use user data policies** for user-specific tables (tasks, notifications, etc.) +4. **Set RLS context** in middleware or at the application boundary +5. **Test RLS policies** thoroughly before deploying to production +6. **Document custom policies** if you deviate from the templates + +## Testing RLS Policies + +### Check if RLS is enabled + +```typescript +import { isRlsEnabled } from '@erp-suite/core'; + +const enabled = await isRlsEnabled(pool, 'core', 'partners'); +console.log(`RLS enabled: ${enabled}`); +``` + +### List policies + +```typescript +import { listRlsPolicies } from '@erp-suite/core'; + +const status = await listRlsPolicies(pool, 'core', 'partners'); +console.log(`Policies on core.partners:`, status.policies); +``` + +### Get schema-wide status + +```typescript +import { getSchemaRlsStatus } from '@erp-suite/core'; + +const statuses = await getSchemaRlsStatus(pool, 'core'); +statuses.forEach(status => { + console.log(`${status.table}: RLS ${status.rlsEnabled ? 'enabled' : 'disabled'}, ${status.policies.length} policies`); +}); +``` + +## Troubleshooting + +### RLS blocking legitimate queries? + +1. Check that RLS context is set correctly: + ```typescript + await setRlsContext(pool, { tenantId, userId, userRole }); + ``` + +2. Verify the policy USING clause matches your data: + ```typescript + const status = await listRlsPolicies(pool, 'schema', 'table'); + console.log(status.policies); + ``` + +3. Test with admin bypass to isolate the issue: + ```typescript + await setRlsContext(pool, { userRole: 'admin' }); + ``` + +### Policy not being applied? + +1. Ensure RLS is enabled: + ```typescript + const enabled = await isRlsEnabled(pool, 'schema', 'table'); + ``` + +2. Check that the policy exists: + ```typescript + const status = await listRlsPolicies(pool, 'schema', 'table'); + ``` + +3. Verify the session context is set: + ```sql + SELECT current_setting('app.current_tenant_id', true); + ``` + +## Examples + +See `usage-example.ts` for complete working examples. + +## Contributing + +When adding new RLS policy types: + +1. Add SQL template to `rls-policies.sql` +2. Add TypeScript function to `apply-rls.ts` +3. Export from `index.ts` +4. Update this README +5. Add example to `usage-example.ts` + +## Support + +For questions or issues, contact the ERP-Suite core team or file an issue in the repository. diff --git a/apps/shared-libs/core/database/policies/apply-rls.ts b/apps/shared-libs/core/database/policies/apply-rls.ts new file mode 100644 index 0000000..053b5c2 --- /dev/null +++ b/apps/shared-libs/core/database/policies/apply-rls.ts @@ -0,0 +1,564 @@ +/** + * RLS Policy Application Utilities + * + * Centralized functions for applying Row-Level Security policies to database tables. + * These utilities work in conjunction with the SQL policy templates in rls-policies.sql. + * + * @module @erp-suite/core/database/policies + * + * @example + * ```typescript + * import { applyTenantIsolationPolicy, applyCompleteRlsPolicies } from '@erp-suite/core'; + * import { Pool } from 'pg'; + * + * const pool = new Pool({ ... }); + * + * // Apply tenant isolation to a single table + * await applyTenantIsolationPolicy(pool, 'core', 'partners'); + * + * // Apply complete policies (tenant + admin) to multiple tables + * await applyCompletePoliciesForSchema(pool, 'inventory', ['products', 'warehouses', 'locations']); + * ``` + */ + +import { Pool, PoolClient } from 'pg'; + +/** + * RLS Policy Configuration Options + */ +export interface RlsPolicyOptions { + /** Schema name */ + schema: string; + /** Table name */ + table: string; + /** Column name for tenant isolation (default: 'tenant_id') */ + tenantColumn?: string; + /** Include admin bypass policy (default: true) */ + includeAdminBypass?: boolean; + /** Custom user columns for user data policy */ + userColumns?: string[]; +} + +/** + * RLS Policy Type + */ +export enum RlsPolicyType { + TENANT_ISOLATION = 'tenant_isolation', + USER_DATA = 'user_data', + READ_OWN_DATA = 'read_own_data', + WRITE_OWN_DATA = 'write_own_data', + ADMIN_BYPASS = 'admin_bypass', +} + +/** + * RLS Policy Status + */ +export interface RlsPolicyStatus { + schema: string; + table: string; + rlsEnabled: boolean; + policies: Array<{ + name: string; + command: string; + using: string | null; + check: string | null; + }>; +} + +/** + * Apply tenant isolation policy to a table + * + * @param client - Database client or pool + * @param schema - Schema name + * @param table - Table name + * @param tenantColumn - Column name for tenant isolation (default: 'tenant_id') + * @returns Promise + * + * @example + * ```typescript + * await applyTenantIsolationPolicy(pool, 'core', 'partners'); + * await applyTenantIsolationPolicy(pool, 'inventory', 'products', 'company_id'); + * ``` + */ +export async function applyTenantIsolationPolicy( + client: Pool | PoolClient, + schema: string, + table: string, + tenantColumn: string = 'tenant_id', +): Promise { + const query = `SELECT apply_tenant_isolation_policy($1, $2, $3)`; + await client.query(query, [schema, table, tenantColumn]); +} + +/** + * Apply admin bypass policy to a table + * + * @param client - Database client or pool + * @param schema - Schema name + * @param table - Table name + * @returns Promise + * + * @example + * ```typescript + * await applyAdminBypassPolicy(pool, 'financial', 'invoices'); + * ``` + */ +export async function applyAdminBypassPolicy( + client: Pool | PoolClient, + schema: string, + table: string, +): Promise { + const query = `SELECT apply_admin_bypass_policy($1, $2)`; + await client.query(query, [schema, table]); +} + +/** + * Apply user data policy to a table + * + * @param client - Database client or pool + * @param schema - Schema name + * @param table - Table name + * @param userColumns - Array of column names to check (default: ['created_by', 'assigned_to', 'owner_id']) + * @returns Promise + * + * @example + * ```typescript + * await applyUserDataPolicy(pool, 'projects', 'tasks'); + * await applyUserDataPolicy(pool, 'crm', 'leads', ['created_by', 'assigned_to']); + * ``` + */ +export async function applyUserDataPolicy( + client: Pool | PoolClient, + schema: string, + table: string, + userColumns: string[] = ['created_by', 'assigned_to', 'owner_id'], +): Promise { + const query = `SELECT apply_user_data_policy($1, $2, $3)`; + await client.query(query, [schema, table, userColumns]); +} + +/** + * Apply complete RLS policies to a table (tenant isolation + optional admin bypass) + * + * @param client - Database client or pool + * @param schema - Schema name + * @param table - Table name + * @param tenantColumn - Column name for tenant isolation (default: 'tenant_id') + * @param includeAdminBypass - Whether to include admin bypass policy (default: true) + * @returns Promise + * + * @example + * ```typescript + * await applyCompleteRlsPolicies(pool, 'core', 'partners'); + * await applyCompleteRlsPolicies(pool, 'sales', 'orders', 'tenant_id', false); + * ``` + */ +export async function applyCompleteRlsPolicies( + client: Pool | PoolClient, + schema: string, + table: string, + tenantColumn: string = 'tenant_id', + includeAdminBypass: boolean = true, +): Promise { + const query = `SELECT apply_complete_rls_policies($1, $2, $3, $4)`; + await client.query(query, [schema, table, tenantColumn, includeAdminBypass]); +} + +/** + * Apply complete RLS policies to multiple tables in a schema + * + * @param client - Database client or pool + * @param schema - Schema name + * @param tables - Array of table names + * @param options - Optional configuration + * @returns Promise + * + * @example + * ```typescript + * await applyCompletePoliciesForSchema(pool, 'inventory', [ + * 'products', + * 'warehouses', + * 'locations', + * 'lots' + * ]); + * ``` + */ +export async function applyCompletePoliciesForSchema( + client: Pool | PoolClient, + schema: string, + tables: string[], + options?: { + tenantColumn?: string; + includeAdminBypass?: boolean; + }, +): Promise { + const { tenantColumn = 'tenant_id', includeAdminBypass = true } = options || {}; + + for (const table of tables) { + await applyCompleteRlsPolicies( + client, + schema, + table, + tenantColumn, + includeAdminBypass, + ); + } +} + +/** + * Check if RLS is enabled on a table + * + * @param client - Database client or pool + * @param schema - Schema name + * @param table - Table name + * @returns Promise - True if RLS is enabled + * + * @example + * ```typescript + * const isEnabled = await isRlsEnabled(pool, 'core', 'partners'); + * console.log(`RLS enabled: ${isEnabled}`); + * ``` + */ +export async function isRlsEnabled( + client: Pool | PoolClient, + schema: string, + table: string, +): Promise { + const query = `SELECT is_rls_enabled($1, $2) as enabled`; + const result = await client.query(query, [schema, table]); + return result.rows[0]?.enabled ?? false; +} + +/** + * List all RLS policies on a table + * + * @param client - Database client or pool + * @param schema - Schema name + * @param table - Table name + * @returns Promise - Policy status information + * + * @example + * ```typescript + * const status = await listRlsPolicies(pool, 'core', 'partners'); + * console.log(`Policies on core.partners:`, status.policies); + * ``` + */ +export async function listRlsPolicies( + client: Pool | PoolClient, + schema: string, + table: string, +): Promise { + const rlsEnabled = await isRlsEnabled(client, schema, table); + + const query = `SELECT * FROM list_rls_policies($1, $2)`; + const result = await client.query(query, [schema, table]); + + return { + schema, + table, + rlsEnabled, + policies: result.rows.map((row) => ({ + name: row.policy_name, + command: row.policy_cmd, + using: row.policy_using, + check: row.policy_check, + })), + }; +} + +/** + * Enable RLS on a table (without applying any policies) + * + * @param client - Database client or pool + * @param schema - Schema name + * @param table - Table name + * @returns Promise + * + * @example + * ```typescript + * await enableRls(pool, 'core', 'custom_table'); + * ``` + */ +export async function enableRls( + client: Pool | PoolClient, + schema: string, + table: string, +): Promise { + const query = `ALTER TABLE ${schema}.${table} ENABLE ROW LEVEL SECURITY`; + await client.query(query); +} + +/** + * Disable RLS on a table + * + * @param client - Database client or pool + * @param schema - Schema name + * @param table - Table name + * @returns Promise + * + * @example + * ```typescript + * await disableRls(pool, 'core', 'temp_table'); + * ``` + */ +export async function disableRls( + client: Pool | PoolClient, + schema: string, + table: string, +): Promise { + const query = `ALTER TABLE ${schema}.${table} DISABLE ROW LEVEL SECURITY`; + await client.query(query); +} + +/** + * Drop a specific RLS policy from a table + * + * @param client - Database client or pool + * @param schema - Schema name + * @param table - Table name + * @param policyName - Policy name to drop + * @returns Promise + * + * @example + * ```typescript + * await dropRlsPolicy(pool, 'core', 'partners', 'tenant_isolation_partners'); + * ``` + */ +export async function dropRlsPolicy( + client: Pool | PoolClient, + schema: string, + table: string, + policyName: string, +): Promise { + const query = `DROP POLICY IF EXISTS ${policyName} ON ${schema}.${table}`; + await client.query(query); +} + +/** + * Drop all RLS policies from a table + * + * @param client - Database client or pool + * @param schema - Schema name + * @param table - Table name + * @returns Promise - Number of policies dropped + * + * @example + * ```typescript + * const count = await dropAllRlsPolicies(pool, 'core', 'partners'); + * console.log(`Dropped ${count} policies`); + * ``` + */ +export async function dropAllRlsPolicies( + client: Pool | PoolClient, + schema: string, + table: string, +): Promise { + const status = await listRlsPolicies(client, schema, table); + + for (const policy of status.policies) { + await dropRlsPolicy(client, schema, table, policy.name); + } + + return status.policies.length; +} + +/** + * Batch apply RLS policies to tables based on configuration + * + * @param client - Database client or pool + * @param configs - Array of policy configurations + * @returns Promise + * + * @example + * ```typescript + * await batchApplyRlsPolicies(pool, [ + * { schema: 'core', table: 'partners' }, + * { schema: 'core', table: 'addresses' }, + * { schema: 'inventory', table: 'products', includeAdminBypass: false }, + * { schema: 'projects', table: 'tasks', tenantColumn: 'company_id' }, + * ]); + * ``` + */ +export async function batchApplyRlsPolicies( + client: Pool | PoolClient, + configs: RlsPolicyOptions[], +): Promise { + for (const config of configs) { + const { + schema, + table, + tenantColumn = 'tenant_id', + includeAdminBypass = true, + } = config; + + await applyCompleteRlsPolicies( + client, + schema, + table, + tenantColumn, + includeAdminBypass, + ); + } +} + +/** + * Get RLS status for all tables in a schema + * + * @param client - Database client or pool + * @param schema - Schema name + * @returns Promise - Array of policy statuses + * + * @example + * ```typescript + * const statuses = await getSchemaRlsStatus(pool, 'core'); + * statuses.forEach(status => { + * console.log(`${status.table}: RLS ${status.rlsEnabled ? 'enabled' : 'disabled'}, ${status.policies.length} policies`); + * }); + * ``` + */ +export async function getSchemaRlsStatus( + client: Pool | PoolClient, + schema: string, +): Promise { + // Get all tables in schema + const tablesQuery = ` + SELECT table_name + FROM information_schema.tables + WHERE table_schema = $1 + AND table_type = 'BASE TABLE' + ORDER BY table_name + `; + const tablesResult = await client.query(tablesQuery, [schema]); + + const statuses: RlsPolicyStatus[] = []; + for (const row of tablesResult.rows) { + const status = await listRlsPolicies(client, schema, row.table_name); + statuses.push(status); + } + + return statuses; +} + +/** + * Set session context for RLS (tenant_id, user_id, user_role) + * + * @param client - Database client or pool + * @param context - Session context + * @returns Promise + * + * @example + * ```typescript + * await setRlsContext(client, { + * tenantId: 'uuid-tenant-id', + * userId: 'uuid-user-id', + * userRole: 'admin', + * }); + * ``` + */ +export async function setRlsContext( + client: Pool | PoolClient, + context: { + tenantId?: string; + userId?: string; + userRole?: string; + }, +): Promise { + const { tenantId, userId, userRole } = context; + + if (tenantId) { + await client.query(`SET app.current_tenant_id = $1`, [tenantId]); + } + + if (userId) { + await client.query(`SET app.current_user_id = $1`, [userId]); + } + + if (userRole) { + await client.query(`SET app.current_user_role = $1`, [userRole]); + } +} + +/** + * Clear RLS context from session + * + * @param client - Database client or pool + * @returns Promise + * + * @example + * ```typescript + * await clearRlsContext(client); + * ``` + */ +export async function clearRlsContext(client: Pool | PoolClient): Promise { + await client.query(`RESET app.current_tenant_id`); + await client.query(`RESET app.current_user_id`); + await client.query(`RESET app.current_user_role`); +} + +/** + * Helper: Execute function within RLS context + * + * @param client - Database client or pool + * @param context - RLS context + * @param fn - Function to execute + * @returns Promise - Result of the function + * + * @example + * ```typescript + * const result = await withRlsContext(pool, { + * tenantId: 'tenant-uuid', + * userId: 'user-uuid', + * userRole: 'user', + * }, async (client) => { + * return await client.query('SELECT * FROM core.partners'); + * }); + * ``` + */ +export async function withRlsContext( + client: Pool | PoolClient, + context: { + tenantId?: string; + userId?: string; + userRole?: string; + }, + fn: (client: Pool | PoolClient) => Promise, +): Promise { + await setRlsContext(client, context); + try { + return await fn(client); + } finally { + await clearRlsContext(client); + } +} + +/** + * Export all RLS utility functions + */ +export default { + // Policy application + applyTenantIsolationPolicy, + applyAdminBypassPolicy, + applyUserDataPolicy, + applyCompleteRlsPolicies, + applyCompletePoliciesForSchema, + batchApplyRlsPolicies, + + // RLS management + enableRls, + disableRls, + isRlsEnabled, + listRlsPolicies, + dropRlsPolicy, + dropAllRlsPolicies, + + // Status and inspection + getSchemaRlsStatus, + + // Context management + setRlsContext, + clearRlsContext, + withRlsContext, + + // Types + RlsPolicyType, +}; diff --git a/apps/shared-libs/core/database/policies/migration-example.ts b/apps/shared-libs/core/database/policies/migration-example.ts new file mode 100644 index 0000000..3be16a6 --- /dev/null +++ b/apps/shared-libs/core/database/policies/migration-example.ts @@ -0,0 +1,152 @@ +/** + * Migration Example: Applying Centralized RLS Policies + * + * This migration demonstrates how to replace vertical-specific RLS policies + * with the centralized shared library policies. + * + * BEFORE: Each vertical had duplicated RLS functions and policies + * AFTER: Use shared-libs centralized RLS policies + */ + +import { Pool } from 'pg'; +import { + applyCompleteRlsPolicies, + applyCompletePoliciesForSchema, + batchApplyRlsPolicies, + getSchemaRlsStatus, +} from '@erp-suite/core'; + +/** + * Migration UP: Apply RLS policies to all tables + */ +export async function up(pool: Pool): Promise { + console.log('Starting RLS migration...'); + + // STEP 1: Install RLS helper functions (run once per database) + console.log('Installing RLS helper functions...'); + // Note: This would be done via SQL file first: + // psql -d database -f apps/shared-libs/core/database/policies/rls-policies.sql + + // STEP 2: Apply RLS to ERP Core tables + console.log('Applying RLS to ERP Core tables...'); + + const coreSchemas = [ + { + schema: 'core', + tables: ['partners', 'addresses', 'product_categories', 'tags', 'sequences', 'attachments', 'notes'], + }, + { + schema: 'inventory', + tables: ['products', 'warehouses', 'locations', 'lots', 'pickings', 'stock_moves'], + }, + { + schema: 'sales', + tables: ['sales_orders', 'quotations', 'pricelists'], + }, + { + schema: 'purchase', + tables: ['purchase_orders', 'rfqs', 'vendor_pricelists'], + }, + { + schema: 'financial', + tables: ['accounts', 'invoices', 'payments', 'journal_entries'], + }, + ]; + + for (const { schema, tables } of coreSchemas) { + await applyCompletePoliciesForSchema(pool, schema, tables); + console.log(` Applied RLS to ${schema} schema (${tables.length} tables)`); + } + + // STEP 3: Apply RLS to vertical-specific tables + console.log('Applying RLS to vertical tables...'); + + // Example: Construccion vertical + const construccionTables = [ + { schema: 'construction', table: 'projects', tenantColumn: 'constructora_id' }, + { schema: 'construction', table: 'estimates', tenantColumn: 'constructora_id' }, + { schema: 'construction', table: 'work_orders', tenantColumn: 'constructora_id' }, + { schema: 'hse', table: 'incidents', tenantColumn: 'constructora_id' }, + ]; + + await batchApplyRlsPolicies(pool, construccionTables); + console.log(` Applied RLS to construccion vertical (${construccionTables.length} tables)`); + + // Example: Mecanicas-diesel vertical + const mecanicasTables = [ + { schema: 'mechanics', table: 'work_orders' }, + { schema: 'mechanics', table: 'vehicles' }, + { schema: 'mechanics', table: 'parts' }, + ]; + + await batchApplyRlsPolicies(pool, mecanicasTables); + console.log(` Applied RLS to mecanicas-diesel vertical (${mecanicasTables.length} tables)`); + + // STEP 4: Verify RLS application + console.log('Verifying RLS policies...'); + const coreStatus = await getSchemaRlsStatus(pool, 'core'); + const enabledCount = coreStatus.filter(s => s.rlsEnabled).length; + console.log(` Core schema: ${enabledCount}/${coreStatus.length} tables have RLS enabled`); + + console.log('RLS migration completed successfully!'); +} + +/** + * Migration DOWN: Remove RLS policies + */ +export async function down(pool: Pool): Promise { + console.log('Rolling back RLS migration...'); + + // Import cleanup functions + const { dropAllRlsPolicies, disableRls } = await import('@erp-suite/core'); + + // Remove RLS from all tables + const schemas = ['core', 'inventory', 'sales', 'purchase', 'financial', 'construction', 'hse', 'mechanics']; + + for (const schema of schemas) { + const tablesQuery = ` + SELECT table_name + FROM information_schema.tables + WHERE table_schema = $1 + AND table_type = 'BASE TABLE' + `; + const result = await pool.query(tablesQuery, [schema]); + + for (const row of result.rows) { + const table = row.table_name; + try { + const count = await dropAllRlsPolicies(pool, schema, table); + if (count > 0) { + await disableRls(pool, schema, table); + console.log(` Removed RLS from ${schema}.${table} (${count} policies)`); + } + } catch (error) { + console.error(` Error removing RLS from ${schema}.${table}:`, error.message); + } + } + } + + console.log('RLS migration rollback completed!'); +} + +/** + * Example usage in a migration framework + */ +export default { + up, + down, +}; + +// TypeORM migration class format +export class ApplyRlsPolicies1234567890123 { + public async up(queryRunner: any): Promise { + // Get pool from queryRunner or create one + const pool = queryRunner.connection.driver.master; + await up(pool); + } + + public async down(queryRunner: any): Promise { + const pool = queryRunner.connection.driver.master; + await down(pool); + } +} diff --git a/apps/shared-libs/core/database/policies/rls-policies.sql b/apps/shared-libs/core/database/policies/rls-policies.sql new file mode 100644 index 0000000..614a45b --- /dev/null +++ b/apps/shared-libs/core/database/policies/rls-policies.sql @@ -0,0 +1,514 @@ +-- ============================================================================ +-- SHARED RLS POLICIES - ERP-Suite Core Library +-- ============================================================================ +-- Purpose: Centralized Row-Level Security policies for multi-tenant isolation +-- Location: apps/shared-libs/core/database/policies/rls-policies.sql +-- Usage: Applied dynamically via apply-rls.ts functions +-- ============================================================================ + +-- ============================================================================ +-- HELPER FUNCTIONS FOR RLS +-- ============================================================================ + +-- Function: Get current tenant ID from session context +CREATE OR REPLACE FUNCTION get_current_tenant_id() +RETURNS UUID AS $$ +BEGIN + RETURN NULLIF(current_setting('app.current_tenant_id', true), '')::UUID; +EXCEPTION + WHEN OTHERS THEN + RETURN NULL; +END; +$$ LANGUAGE plpgsql STABLE SECURITY DEFINER; + +COMMENT ON FUNCTION get_current_tenant_id() IS +'Retrieves the tenant_id from the current session context for RLS policies. +Returns NULL if not set. Used by all tenant isolation policies.'; + +-- Function: Get current user ID from session context +CREATE OR REPLACE FUNCTION get_current_user_id() +RETURNS UUID AS $$ +BEGIN + RETURN NULLIF(current_setting('app.current_user_id', true), '')::UUID; +EXCEPTION + WHEN OTHERS THEN + RETURN NULL; +END; +$$ LANGUAGE plpgsql STABLE SECURITY DEFINER; + +COMMENT ON FUNCTION get_current_user_id() IS +'Retrieves the user_id from the current session context. +Used for user-specific RLS policies (read/write own data).'; + +-- Function: Get current user role from session context +CREATE OR REPLACE FUNCTION get_current_user_role() +RETURNS TEXT AS $$ +BEGIN + RETURN current_setting('app.current_user_role', true); +EXCEPTION + WHEN OTHERS THEN + RETURN 'guest'; +END; +$$ LANGUAGE plpgsql STABLE SECURITY DEFINER; + +COMMENT ON FUNCTION get_current_user_role() IS +'Retrieves the user role from the current session context. +Used for role-based access control in RLS policies. Defaults to "guest".'; + +-- Function: Check if current user is admin +CREATE OR REPLACE FUNCTION is_current_user_admin() +RETURNS BOOLEAN AS $$ +BEGIN + RETURN get_current_user_role() IN ('admin', 'super_admin', 'system_admin'); +END; +$$ LANGUAGE plpgsql STABLE SECURITY DEFINER; + +COMMENT ON FUNCTION is_current_user_admin() IS +'Returns TRUE if the current user has an admin role. +Used for admin bypass policies.'; + +-- ============================================================================ +-- GENERIC RLS POLICY TEMPLATES +-- ============================================================================ + +-- POLICY 1: TENANT_ISOLATION_POLICY +-- Purpose: Ensures users can only access data from their own tenant +-- Usage: Apply to all tables with tenant_id column +-- ============================================================================ + +/* +TEMPLATE FOR TENANT_ISOLATION_POLICY: + +ALTER TABLE {schema}.{table} ENABLE ROW LEVEL SECURITY; + +CREATE POLICY tenant_isolation_{table} +ON {schema}.{table} +FOR ALL +TO authenticated +USING (tenant_id = get_current_tenant_id()) +WITH CHECK (tenant_id = get_current_tenant_id()); + +COMMENT ON POLICY tenant_isolation_{table} ON {schema}.{table} IS +'Multi-tenant isolation: Users can only access records from their own tenant. +Applied to all operations (SELECT, INSERT, UPDATE, DELETE).'; +*/ + +-- ============================================================================ +-- POLICY 2: USER_DATA_POLICY +-- Purpose: Restricts access to data created by or assigned to the current user +-- Usage: Apply to tables with created_by or assigned_to columns +-- ============================================================================ + +/* +TEMPLATE FOR USER_DATA_POLICY: + +ALTER TABLE {schema}.{table} ENABLE ROW LEVEL SECURITY; + +CREATE POLICY user_data_{table} +ON {schema}.{table} +FOR ALL +TO authenticated +USING ( + tenant_id = get_current_tenant_id() + AND ( + created_by = get_current_user_id() + OR assigned_to = get_current_user_id() + OR owner_id = get_current_user_id() + ) +) +WITH CHECK ( + tenant_id = get_current_tenant_id() + AND ( + created_by = get_current_user_id() + OR assigned_to = get_current_user_id() + OR owner_id = get_current_user_id() + ) +); + +COMMENT ON POLICY user_data_{table} ON {schema}.{table} IS +'User-level isolation: Users can only access their own records. +Checks: created_by, assigned_to, or owner_id matches current user.'; +*/ + +-- ============================================================================ +-- POLICY 3: READ_OWN_DATA_POLICY +-- Purpose: Allows users to read only their own data (more permissive for SELECT) +-- Usage: Apply when users need read access to own data but restricted write +-- ============================================================================ + +/* +TEMPLATE FOR READ_OWN_DATA_POLICY: + +ALTER TABLE {schema}.{table} ENABLE ROW LEVEL SECURITY; + +CREATE POLICY read_own_data_{table} +ON {schema}.{table} +FOR SELECT +TO authenticated +USING ( + tenant_id = get_current_tenant_id() + AND ( + created_by = get_current_user_id() + OR assigned_to = get_current_user_id() + OR owner_id = get_current_user_id() + ) +); + +COMMENT ON POLICY read_own_data_{table} ON {schema}.{table} IS +'Read access: Users can view records they created, are assigned to, or own. +SELECT only - write operations controlled by separate policies.'; +*/ + +-- ============================================================================ +-- POLICY 4: WRITE_OWN_DATA_POLICY +-- Purpose: Allows users to insert/update/delete only their own data +-- Usage: Companion to READ_OWN_DATA_POLICY for write operations +-- ============================================================================ + +/* +TEMPLATE FOR WRITE_OWN_DATA_POLICY: + +ALTER TABLE {schema}.{table} ENABLE ROW LEVEL SECURITY; + +-- INSERT policy +CREATE POLICY write_own_data_insert_{table} +ON {schema}.{table} +FOR INSERT +TO authenticated +WITH CHECK ( + tenant_id = get_current_tenant_id() + AND created_by = get_current_user_id() +); + +-- UPDATE policy +CREATE POLICY write_own_data_update_{table} +ON {schema}.{table} +FOR UPDATE +TO authenticated +USING ( + tenant_id = get_current_tenant_id() + AND ( + created_by = get_current_user_id() + OR owner_id = get_current_user_id() + ) +) +WITH CHECK ( + tenant_id = get_current_tenant_id() + AND ( + created_by = get_current_user_id() + OR owner_id = get_current_user_id() + ) +); + +-- DELETE policy +CREATE POLICY write_own_data_delete_{table} +ON {schema}.{table} +FOR DELETE +TO authenticated +USING ( + tenant_id = get_current_tenant_id() + AND ( + created_by = get_current_user_id() + OR owner_id = get_current_user_id() + ) +); + +COMMENT ON POLICY write_own_data_insert_{table} ON {schema}.{table} IS +'Write access (INSERT): Users can only create records for themselves.'; + +COMMENT ON POLICY write_own_data_update_{table} ON {schema}.{table} IS +'Write access (UPDATE): Users can only update their own records.'; + +COMMENT ON POLICY write_own_data_delete_{table} ON {schema}.{table} IS +'Write access (DELETE): Users can only delete their own records.'; +*/ + +-- ============================================================================ +-- POLICY 5: ADMIN_BYPASS_POLICY +-- Purpose: Allows admin users to bypass RLS restrictions for support/management +-- Usage: Apply as permissive policy to allow admin full access +-- ============================================================================ + +/* +TEMPLATE FOR ADMIN_BYPASS_POLICY: + +ALTER TABLE {schema}.{table} ENABLE ROW LEVEL SECURITY; + +CREATE POLICY admin_bypass_{table} +ON {schema}.{table} +FOR ALL +TO authenticated +USING (is_current_user_admin()) +WITH CHECK (is_current_user_admin()); + +COMMENT ON POLICY admin_bypass_{table} ON {schema}.{table} IS +'Admin bypass: Admin users (admin, super_admin, system_admin) have full access. +Use for support, troubleshooting, and system management. +Security: Only assign admin roles to trusted users.'; +*/ + +-- ============================================================================ +-- UTILITY FUNCTION: Apply RLS Policies Dynamically +-- ============================================================================ + +-- Function: Apply tenant isolation policy to a table +CREATE OR REPLACE FUNCTION apply_tenant_isolation_policy( + p_schema TEXT, + p_table TEXT, + p_tenant_column TEXT DEFAULT 'tenant_id' +) +RETURNS VOID AS $$ +DECLARE + v_policy_name TEXT; +BEGIN + v_policy_name := 'tenant_isolation_' || p_table; + + -- Enable RLS + EXECUTE format('ALTER TABLE %I.%I ENABLE ROW LEVEL SECURITY', p_schema, p_table); + + -- Drop policy if exists + EXECUTE format( + 'DROP POLICY IF EXISTS %I ON %I.%I', + v_policy_name, p_schema, p_table + ); + + -- Create policy + EXECUTE format( + 'CREATE POLICY %I ON %I.%I FOR ALL TO authenticated USING (%I = get_current_tenant_id()) WITH CHECK (%I = get_current_tenant_id())', + v_policy_name, p_schema, p_table, p_tenant_column, p_tenant_column + ); + + -- Add comment + EXECUTE format( + 'COMMENT ON POLICY %I ON %I.%I IS %L', + v_policy_name, p_schema, p_table, + 'Multi-tenant isolation: Users can only access records from their own tenant.' + ); + + RAISE NOTICE 'Applied tenant_isolation_policy to %.%', p_schema, p_table; +END; +$$ LANGUAGE plpgsql; + +COMMENT ON FUNCTION apply_tenant_isolation_policy IS +'Applies tenant isolation RLS policy to a table. +Parameters: + - p_schema: Schema name + - p_table: Table name + - p_tenant_column: Column name for tenant isolation (default: tenant_id)'; + +-- Function: Apply admin bypass policy to a table +CREATE OR REPLACE FUNCTION apply_admin_bypass_policy( + p_schema TEXT, + p_table TEXT +) +RETURNS VOID AS $$ +DECLARE + v_policy_name TEXT; +BEGIN + v_policy_name := 'admin_bypass_' || p_table; + + -- Enable RLS (if not already enabled) + EXECUTE format('ALTER TABLE %I.%I ENABLE ROW LEVEL SECURITY', p_schema, p_table); + + -- Drop policy if exists + EXECUTE format( + 'DROP POLICY IF EXISTS %I ON %I.%I', + v_policy_name, p_schema, p_table + ); + + -- Create policy + EXECUTE format( + 'CREATE POLICY %I ON %I.%I FOR ALL TO authenticated USING (is_current_user_admin()) WITH CHECK (is_current_user_admin())', + v_policy_name, p_schema, p_table + ); + + -- Add comment + EXECUTE format( + 'COMMENT ON POLICY %I ON %I.%I IS %L', + v_policy_name, p_schema, p_table, + 'Admin bypass: Admin users have full access for support and management.' + ); + + RAISE NOTICE 'Applied admin_bypass_policy to %.%', p_schema, p_table; +END; +$$ LANGUAGE plpgsql; + +COMMENT ON FUNCTION apply_admin_bypass_policy IS +'Applies admin bypass RLS policy to a table. +Admins can access all records regardless of tenant or ownership. +Parameters: + - p_schema: Schema name + - p_table: Table name'; + +-- Function: Apply user data policy to a table +CREATE OR REPLACE FUNCTION apply_user_data_policy( + p_schema TEXT, + p_table TEXT, + p_user_columns TEXT[] DEFAULT ARRAY['created_by', 'assigned_to', 'owner_id']::TEXT[] +) +RETURNS VOID AS $$ +DECLARE + v_policy_name TEXT; + v_using_clause TEXT; + v_column TEXT; + v_conditions TEXT[] := ARRAY[]::TEXT[]; +BEGIN + v_policy_name := 'user_data_' || p_table; + + -- Build USING clause with provided user columns + FOREACH v_column IN ARRAY p_user_columns + LOOP + v_conditions := array_append(v_conditions, format('%I = get_current_user_id()', v_column)); + END LOOP; + + v_using_clause := 'tenant_id = get_current_tenant_id() AND (' || array_to_string(v_conditions, ' OR ') || ')'; + + -- Enable RLS + EXECUTE format('ALTER TABLE %I.%I ENABLE ROW LEVEL SECURITY', p_schema, p_table); + + -- Drop policy if exists + EXECUTE format( + 'DROP POLICY IF EXISTS %I ON %I.%I', + v_policy_name, p_schema, p_table + ); + + -- Create policy + EXECUTE format( + 'CREATE POLICY %I ON %I.%I FOR ALL TO authenticated USING (%s) WITH CHECK (%s)', + v_policy_name, p_schema, p_table, v_using_clause, v_using_clause + ); + + -- Add comment + EXECUTE format( + 'COMMENT ON POLICY %I ON %I.%I IS %L', + v_policy_name, p_schema, p_table, + 'User-level isolation: Users can only access their own records based on: ' || array_to_string(p_user_columns, ', ') + ); + + RAISE NOTICE 'Applied user_data_policy to %.% using columns: %', p_schema, p_table, array_to_string(p_user_columns, ', '); +END; +$$ LANGUAGE plpgsql; + +COMMENT ON FUNCTION apply_user_data_policy IS +'Applies user data RLS policy to a table. +Users can only access records they created, are assigned to, or own. +Parameters: + - p_schema: Schema name + - p_table: Table name + - p_user_columns: Array of column names to check (default: created_by, assigned_to, owner_id)'; + +-- Function: Apply complete RLS policies to a table (tenant + admin) +CREATE OR REPLACE FUNCTION apply_complete_rls_policies( + p_schema TEXT, + p_table TEXT, + p_tenant_column TEXT DEFAULT 'tenant_id', + p_include_admin_bypass BOOLEAN DEFAULT TRUE +) +RETURNS VOID AS $$ +BEGIN + -- Apply tenant isolation + PERFORM apply_tenant_isolation_policy(p_schema, p_table, p_tenant_column); + + -- Apply admin bypass if requested + IF p_include_admin_bypass THEN + PERFORM apply_admin_bypass_policy(p_schema, p_table); + END IF; + + RAISE NOTICE 'Applied complete RLS policies to %.%', p_schema, p_table; +END; +$$ LANGUAGE plpgsql; + +COMMENT ON FUNCTION apply_complete_rls_policies IS +'Applies a complete set of RLS policies (tenant isolation + optional admin bypass). +Parameters: + - p_schema: Schema name + - p_table: Table name + - p_tenant_column: Column name for tenant isolation (default: tenant_id) + - p_include_admin_bypass: Whether to include admin bypass policy (default: TRUE)'; + +-- ============================================================================ +-- EXAMPLE USAGE +-- ============================================================================ + +/* +-- Example 1: Apply tenant isolation to a single table +SELECT apply_tenant_isolation_policy('core', 'partners'); + +-- Example 2: Apply complete policies (tenant + admin) to a table +SELECT apply_complete_rls_policies('inventory', 'products'); + +-- Example 3: Apply user data policy +SELECT apply_user_data_policy('projects', 'tasks', ARRAY['created_by', 'assigned_to']::TEXT[]); + +-- Example 4: Apply admin bypass only +SELECT apply_admin_bypass_policy('financial', 'invoices'); + +-- Example 5: Apply to multiple tables at once +DO $$ +DECLARE + r RECORD; +BEGIN + FOR r IN + SELECT table_name + FROM information_schema.tables + WHERE table_schema = 'core' + AND table_name IN ('partners', 'addresses', 'notes', 'attachments') + LOOP + PERFORM apply_complete_rls_policies('core', r.table_name); + END LOOP; +END $$; +*/ + +-- ============================================================================ +-- MIGRATION HELPERS +-- ============================================================================ + +-- Function: Check if RLS is enabled on a table +CREATE OR REPLACE FUNCTION is_rls_enabled(p_schema TEXT, p_table TEXT) +RETURNS BOOLEAN AS $$ +DECLARE + v_enabled BOOLEAN; +BEGIN + SELECT relrowsecurity INTO v_enabled + FROM pg_class c + JOIN pg_namespace n ON n.oid = c.relnamespace + WHERE n.nspname = p_schema AND c.relname = p_table; + + RETURN COALESCE(v_enabled, FALSE); +END; +$$ LANGUAGE plpgsql STABLE; + +COMMENT ON FUNCTION is_rls_enabled IS +'Check if RLS is enabled on a specific table. +Returns TRUE if enabled, FALSE otherwise.'; + +-- Function: List all RLS policies on a table +CREATE OR REPLACE FUNCTION list_rls_policies(p_schema TEXT, p_table TEXT) +RETURNS TABLE(policy_name NAME, policy_cmd TEXT, policy_using TEXT, policy_check TEXT) AS $$ +BEGIN + RETURN QUERY + SELECT + pol.polname::NAME as policy_name, + CASE pol.polcmd + WHEN 'r' THEN 'SELECT' + WHEN 'a' THEN 'INSERT' + WHEN 'w' THEN 'UPDATE' + WHEN 'd' THEN 'DELETE' + WHEN '*' THEN 'ALL' + END as policy_cmd, + pg_get_expr(pol.polqual, pol.polrelid) as policy_using, + pg_get_expr(pol.polwithcheck, pol.polrelid) as policy_check + FROM pg_policy pol + JOIN pg_class c ON c.oid = pol.polrelid + JOIN pg_namespace n ON n.oid = c.relnamespace + WHERE n.nspname = p_schema AND c.relname = p_table; +END; +$$ LANGUAGE plpgsql STABLE; + +COMMENT ON FUNCTION list_rls_policies IS +'List all RLS policies configured on a specific table. +Returns: policy_name, policy_cmd, policy_using, policy_check'; + +-- ============================================================================ +-- END OF RLS POLICIES +-- ============================================================================ diff --git a/apps/shared-libs/core/database/policies/usage-example.ts b/apps/shared-libs/core/database/policies/usage-example.ts new file mode 100644 index 0000000..b722adf --- /dev/null +++ b/apps/shared-libs/core/database/policies/usage-example.ts @@ -0,0 +1,405 @@ +/** + * RLS Policies - Usage Examples + * + * This file demonstrates how to use the centralized RLS policies + * in various scenarios across the ERP-Suite. + */ + +import { Pool } from 'pg'; +import { + applyTenantIsolationPolicy, + applyAdminBypassPolicy, + applyUserDataPolicy, + applyCompleteRlsPolicies, + applyCompletePoliciesForSchema, + batchApplyRlsPolicies, + isRlsEnabled, + listRlsPolicies, + getSchemaRlsStatus, + setRlsContext, + clearRlsContext, + withRlsContext, + RlsPolicyOptions, +} from '@erp-suite/core'; + +// Database connection pool +const pool = new Pool({ + host: 'localhost', + port: 5432, + database: 'erp_suite', + user: 'postgres', + password: 'password', +}); + +/** + * EXAMPLE 1: Apply tenant isolation to a single table + */ +async function example1_singleTable() { + console.log('Example 1: Apply tenant isolation to core.partners'); + + // Apply tenant isolation policy + await applyTenantIsolationPolicy(pool, 'core', 'partners'); + + // Verify it was applied + const enabled = await isRlsEnabled(pool, 'core', 'partners'); + console.log(`RLS enabled: ${enabled}`); + + // List policies + const status = await listRlsPolicies(pool, 'core', 'partners'); + console.log(`Policies: ${status.policies.map(p => p.name).join(', ')}`); +} + +/** + * EXAMPLE 2: Apply complete policies (tenant + admin) to a table + */ +async function example2_completePolicies() { + console.log('Example 2: Apply complete policies to inventory.products'); + + // Apply tenant isolation + admin bypass + await applyCompleteRlsPolicies(pool, 'inventory', 'products'); + + // Check status + const status = await listRlsPolicies(pool, 'inventory', 'products'); + console.log(`Applied ${status.policies.length} policies:`); + status.policies.forEach(p => { + console.log(` - ${p.name} (${p.command})`); + }); +} + +/** + * EXAMPLE 3: Apply policies to multiple tables in a schema + */ +async function example3_multipleTablesInSchema() { + console.log('Example 3: Apply policies to multiple inventory tables'); + + const tables = ['products', 'warehouses', 'locations', 'lots', 'pickings']; + + await applyCompletePoliciesForSchema(pool, 'inventory', tables); + + console.log(`Applied RLS to ${tables.length} tables in inventory schema`); +} + +/** + * EXAMPLE 4: Batch apply with different configurations + */ +async function example4_batchApply() { + console.log('Example 4: Batch apply with custom configurations'); + + const configs: RlsPolicyOptions[] = [ + // Standard tables + { schema: 'core', table: 'partners' }, + { schema: 'core', table: 'addresses' }, + { schema: 'core', table: 'notes' }, + + // Table without admin bypass + { schema: 'financial', table: 'audit_logs', includeAdminBypass: false }, + + // Table with custom tenant column + { schema: 'projects', table: 'tasks', tenantColumn: 'company_id' }, + ]; + + await batchApplyRlsPolicies(pool, configs); + + console.log(`Applied RLS to ${configs.length} tables`); +} + +/** + * EXAMPLE 5: Apply user data policy for user-specific tables + */ +async function example5_userDataPolicy() { + console.log('Example 5: Apply user data policy to projects.tasks'); + + // Apply user data policy (users can only see their own tasks) + await applyUserDataPolicy(pool, 'projects', 'tasks', ['created_by', 'assigned_to']); + + const status = await listRlsPolicies(pool, 'projects', 'tasks'); + console.log(`User data policy applied: ${status.policies[0]?.name}`); +} + +/** + * EXAMPLE 6: Get RLS status for entire schema + */ +async function example6_schemaStatus() { + console.log('Example 6: Get RLS status for core schema'); + + const statuses = await getSchemaRlsStatus(pool, 'core'); + + console.log(`RLS Status for core schema:`); + statuses.forEach(status => { + const policyCount = status.policies.length; + const rlsStatus = status.rlsEnabled ? 'enabled' : 'disabled'; + console.log(` ${status.table}: RLS ${rlsStatus}, ${policyCount} policies`); + }); +} + +/** + * EXAMPLE 7: Query data with RLS context + */ +async function example7_queryWithContext() { + console.log('Example 7: Query data with RLS context'); + + const tenantId = 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa'; + const userId = 'bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb'; + + // Method 1: Manual context setting + await setRlsContext(pool, { tenantId, userId, userRole: 'user' }); + + const result1 = await pool.query('SELECT COUNT(*) FROM core.partners'); + console.log(`Partners visible to user: ${result1.rows[0].count}`); + + await clearRlsContext(pool); + + // Method 2: Using withRlsContext helper + const result2 = await withRlsContext( + pool, + { tenantId, userId, userRole: 'admin' }, + async (client) => { + return await client.query('SELECT COUNT(*) FROM core.partners'); + } + ); + console.log(`Partners visible to admin: ${result2.rows[0].count}`); +} + +/** + * EXAMPLE 8: Migration script for a vertical + */ +async function example8_verticalMigration() { + console.log('Example 8: Migration script for construccion vertical'); + + // Tables in construccion vertical + const constructionTables = [ + { schema: 'construction', table: 'projects' }, + { schema: 'construction', table: 'estimates' }, + { schema: 'construction', table: 'work_orders' }, + { schema: 'construction', table: 'materials' }, + { schema: 'hse', table: 'incidents' }, + { schema: 'hse', table: 'inspections' }, + ]; + + console.log('Applying RLS to construccion vertical tables...'); + + for (const { schema, table } of constructionTables) { + try { + await applyCompleteRlsPolicies(pool, schema, table, 'constructora_id'); + console.log(` ✓ ${schema}.${table}`); + } catch (error) { + console.error(` ✗ ${schema}.${table}: ${error.message}`); + } + } + + console.log('Migration complete!'); +} + +/** + * EXAMPLE 9: Verify RLS isolation (testing) + */ +async function example9_testRlsIsolation() { + console.log('Example 9: Test RLS isolation between tenants'); + + const tenant1 = 'tenant-1111-1111-1111-111111111111'; + const tenant2 = 'tenant-2222-2222-2222-222222222222'; + + // Query as tenant 1 + const result1 = await withRlsContext( + pool, + { tenantId: tenant1, userRole: 'user' }, + async (client) => { + return await client.query('SELECT COUNT(*) FROM core.partners'); + } + ); + + // Query as tenant 2 + const result2 = await withRlsContext( + pool, + { tenantId: tenant2, userRole: 'user' }, + async (client) => { + return await client.query('SELECT COUNT(*) FROM core.partners'); + } + ); + + console.log(`Tenant 1 sees: ${result1.rows[0].count} partners`); + console.log(`Tenant 2 sees: ${result2.rows[0].count} partners`); + console.log('RLS isolation verified!'); +} + +/** + * EXAMPLE 10: Apply admin bypass for support team + */ +async function example10_adminBypass() { + console.log('Example 10: Test admin bypass policy'); + + const tenantId = 'tenant-1111-1111-1111-111111111111'; + + // Query as regular user + const userResult = await withRlsContext( + pool, + { tenantId, userRole: 'user' }, + async (client) => { + return await client.query('SELECT COUNT(*) FROM core.partners'); + } + ); + + // Query as admin (should see all tenants) + const adminResult = await withRlsContext( + pool, + { userRole: 'admin' }, // No tenantId set + async (client) => { + return await client.query('SELECT COUNT(*) FROM core.partners'); + } + ); + + console.log(`User sees: ${userResult.rows[0].count} partners (own tenant only)`); + console.log(`Admin sees: ${adminResult.rows[0].count} partners (all tenants)`); +} + +/** + * EXAMPLE 11: Apply RLS to ERP Core tables + */ +async function example11_erpCoreTables() { + console.log('Example 11: Apply RLS to ERP Core tables'); + + const erpCoreConfigs: RlsPolicyOptions[] = [ + // Core schema + { schema: 'core', table: 'partners' }, + { schema: 'core', table: 'addresses' }, + { schema: 'core', table: 'product_categories' }, + { schema: 'core', table: 'tags' }, + { schema: 'core', table: 'sequences' }, + { schema: 'core', table: 'attachments' }, + { schema: 'core', table: 'notes' }, + + // Inventory schema + { schema: 'inventory', table: 'products' }, + { schema: 'inventory', table: 'warehouses' }, + { schema: 'inventory', table: 'locations' }, + { schema: 'inventory', table: 'lots' }, + { schema: 'inventory', table: 'pickings' }, + { schema: 'inventory', table: 'stock_moves' }, + + // Sales schema + { schema: 'sales', table: 'sales_orders' }, + { schema: 'sales', table: 'quotations' }, + { schema: 'sales', table: 'pricelists' }, + + // Purchase schema + { schema: 'purchase', table: 'purchase_orders' }, + { schema: 'purchase', table: 'rfqs' }, + { schema: 'purchase', table: 'vendor_pricelists' }, + + // Financial schema + { schema: 'financial', table: 'accounts' }, + { schema: 'financial', table: 'invoices' }, + { schema: 'financial', table: 'payments' }, + { schema: 'financial', table: 'journal_entries' }, + + // Projects schema + { schema: 'projects', table: 'projects' }, + { schema: 'projects', table: 'tasks' }, + { schema: 'projects', table: 'timesheets' }, + ]; + + console.log(`Applying RLS to ${erpCoreConfigs.length} ERP Core tables...`); + + let successCount = 0; + let errorCount = 0; + + for (const config of erpCoreConfigs) { + try { + await applyCompleteRlsPolicies( + pool, + config.schema, + config.table, + config.tenantColumn || 'tenant_id', + config.includeAdminBypass ?? true + ); + console.log(` ✓ ${config.schema}.${config.table}`); + successCount++; + } catch (error) { + console.error(` ✗ ${config.schema}.${config.table}: ${error.message}`); + errorCount++; + } + } + + console.log(`\nComplete! Success: ${successCount}, Errors: ${errorCount}`); +} + +/** + * EXAMPLE 12: Cleanup - Remove RLS from a table + */ +async function example12_cleanup() { + console.log('Example 12: Remove RLS from a table'); + + // Import dropAllRlsPolicies + const { dropAllRlsPolicies, disableRls } = await import('@erp-suite/core'); + + const schema = 'test'; + const table = 'temp_table'; + + // Drop all policies + const policyCount = await dropAllRlsPolicies(pool, schema, table); + console.log(`Dropped ${policyCount} policies from ${schema}.${table}`); + + // Disable RLS + await disableRls(pool, schema, table); + console.log(`Disabled RLS on ${schema}.${table}`); + + // Verify + const enabled = await isRlsEnabled(pool, schema, table); + console.log(`RLS enabled: ${enabled}`); +} + +/** + * Main function - Run all examples + */ +async function main() { + try { + console.log('='.repeat(60)); + console.log('RLS POLICIES - USAGE EXAMPLES'); + console.log('='.repeat(60)); + console.log(); + + // Uncomment the examples you want to run + // await example1_singleTable(); + // await example2_completePolicies(); + // await example3_multipleTablesInSchema(); + // await example4_batchApply(); + // await example5_userDataPolicy(); + // await example6_schemaStatus(); + // await example7_queryWithContext(); + // await example8_verticalMigration(); + // await example9_testRlsIsolation(); + // await example10_adminBypass(); + // await example11_erpCoreTables(); + // await example12_cleanup(); + + console.log(); + console.log('='.repeat(60)); + console.log('Examples completed successfully!'); + console.log('='.repeat(60)); + } catch (error) { + console.error('Error running examples:', error); + } finally { + await pool.end(); + } +} + +// Run if executed directly +if (require.main === module) { + main(); +} + +// Export examples for individual use +export { + example1_singleTable, + example2_completePolicies, + example3_multipleTablesInSchema, + example4_batchApply, + example5_userDataPolicy, + example6_schemaStatus, + example7_queryWithContext, + example8_verticalMigration, + example9_testRlsIsolation, + example10_adminBypass, + example11_erpCoreTables, + example12_cleanup, +}; diff --git a/apps/shared-libs/core/entities/base.entity.ts b/apps/shared-libs/core/entities/base.entity.ts new file mode 100644 index 0000000..e4bc26e --- /dev/null +++ b/apps/shared-libs/core/entities/base.entity.ts @@ -0,0 +1,57 @@ +/** + * Base Entity - Common fields for all entities in ERP-Suite + * + * @module @erp-suite/core/entities + */ + +import { + PrimaryGeneratedColumn, + Column, + CreateDateColumn, + UpdateDateColumn, + DeleteDateColumn, +} from 'typeorm'; + +/** + * Base entity with common audit fields + * + * All entities in ERP-Suite should extend this class to inherit: + * - id: UUID primary key + * - tenantId: Multi-tenancy isolation + * - Audit fields (created, updated, deleted) + * - Soft delete support + * + * @example + * ```typescript + * @Entity('partners', { schema: 'erp' }) + * export class Partner extends BaseEntity { + * @Column() + * name: string; + * } + * ``` + */ +export abstract class BaseEntity { + @PrimaryGeneratedColumn('uuid') + id: string; + + @Column({ name: 'tenant_id', type: 'uuid' }) + tenantId: string; + + @CreateDateColumn({ name: 'created_at', type: 'timestamptz' }) + createdAt: Date; + + @Column({ name: 'created_by_id', type: 'uuid', nullable: true }) + createdById?: string; + + @UpdateDateColumn({ name: 'updated_at', type: 'timestamptz' }) + updatedAt: Date; + + @Column({ name: 'updated_by_id', type: 'uuid', nullable: true }) + updatedById?: string; + + @DeleteDateColumn({ name: 'deleted_at', type: 'timestamptz', nullable: true }) + deletedAt?: Date; + + @Column({ name: 'deleted_by_id', type: 'uuid', nullable: true }) + deletedById?: string; +} diff --git a/apps/shared-libs/core/entities/tenant.entity.ts b/apps/shared-libs/core/entities/tenant.entity.ts new file mode 100644 index 0000000..8153639 --- /dev/null +++ b/apps/shared-libs/core/entities/tenant.entity.ts @@ -0,0 +1,43 @@ +/** + * Tenant Entity - Multi-tenancy organization + * + * @module @erp-suite/core/entities + */ + +import { Entity, Column } from 'typeorm'; +import { BaseEntity } from './base.entity'; + +/** + * Tenant entity for multi-tenancy support + * + * Each tenant represents an independent organization with isolated data. + * All other entities reference tenant_id for Row-Level Security (RLS). + * + * @example + * ```typescript + * const tenant = new Tenant(); + * tenant.name = 'Acme Corp'; + * tenant.slug = 'acme-corp'; + * tenant.status = 'active'; + * ``` + */ +@Entity('tenants', { schema: 'auth' }) +export class Tenant extends BaseEntity { + @Column({ type: 'varchar', length: 255 }) + name: string; + + @Column({ type: 'varchar', length: 100, unique: true }) + slug: string; + + @Column({ type: 'varchar', length: 50, default: 'active' }) + status: 'active' | 'inactive' | 'suspended'; + + @Column({ type: 'jsonb', nullable: true }) + settings?: Record; + + @Column({ type: 'varchar', length: 255, nullable: true }) + domain?: string; + + @Column({ type: 'text', nullable: true }) + logo_url?: string; +} diff --git a/apps/shared-libs/core/entities/user.entity.ts b/apps/shared-libs/core/entities/user.entity.ts new file mode 100644 index 0000000..dd4e7a5 --- /dev/null +++ b/apps/shared-libs/core/entities/user.entity.ts @@ -0,0 +1,54 @@ +/** + * User Entity - Authentication and authorization + * + * @module @erp-suite/core/entities + */ + +import { Entity, Column, ManyToOne, JoinColumn } from 'typeorm'; +import { BaseEntity } from './base.entity'; +import { Tenant } from './tenant.entity'; + +/** + * User entity for authentication and multi-tenancy + * + * Users belong to a tenant and have roles for authorization. + * Stored in auth.users schema for centralized authentication. + * + * @example + * ```typescript + * const user = new User(); + * user.email = 'user@example.com'; + * user.fullName = 'John Doe'; + * user.status = 'active'; + * ``` + */ +@Entity('users', { schema: 'auth' }) +export class User extends BaseEntity { + @Column({ type: 'varchar', length: 255, unique: true }) + email: string; + + @Column({ name: 'password_hash', type: 'varchar', length: 255 }) + passwordHash: string; + + @Column({ name: 'full_name', type: 'varchar', length: 255 }) + fullName: string; + + @Column({ type: 'varchar', length: 50, default: 'active' }) + status: 'active' | 'inactive' | 'suspended'; + + @Column({ name: 'last_login_at', type: 'timestamptz', nullable: true }) + lastLoginAt?: Date; + + @Column({ type: 'jsonb', nullable: true }) + preferences?: Record; + + @Column({ name: 'avatar_url', type: 'text', nullable: true }) + avatarUrl?: string; + + @Column({ type: 'varchar', length: 50, nullable: true }) + phone?: string; + + @ManyToOne(() => Tenant) + @JoinColumn({ name: 'tenant_id' }) + tenant?: Tenant; +} diff --git a/apps/shared-libs/core/errors/IMPLEMENTATION_SUMMARY.md b/apps/shared-libs/core/errors/IMPLEMENTATION_SUMMARY.md new file mode 100644 index 0000000..1d2161d --- /dev/null +++ b/apps/shared-libs/core/errors/IMPLEMENTATION_SUMMARY.md @@ -0,0 +1,277 @@ +# Error Handling Implementation Summary + +**Sprint 1 P1 - Cross-cutting Corrections** +**Date:** 2025-12-12 + +## Overview + +Implemented standardized error handling system across all ERP-Suite backends (NestJS and Express). + +## Files Created + +### Core Error Handling Files + +1. **base-error.ts** (1.8 KB) + - `ErrorResponse` interface - standardized error response structure + - `BaseError` abstract class - base for all application errors + - `toResponse()` method for converting errors to HTTP responses + +2. **http-errors.ts** (3.5 KB) + - `BadRequestError` (400) + - `UnauthorizedError` (401) + - `ForbiddenError` (403) + - `NotFoundError` (404) + - `ConflictError` (409) + - `ValidationError` (422) + - `InternalServerError` (500) + +3. **error-filter.ts** (6.3 KB) + - `GlobalExceptionFilter` - NestJS exception filter + - Handles BaseError, HttpException, and generic errors + - Automatic request ID extraction + - Severity-based logging (ERROR/WARN/INFO) + +4. **error-middleware.ts** (6.5 KB) + - `createErrorMiddleware()` - Express error middleware factory + - `errorMiddleware` - default middleware instance + - `notFoundMiddleware` - 404 handler + - `ErrorLogger` interface for custom logging + - `ErrorMiddlewareOptions` for configuration + +5. **index.ts** (1.1 KB) + - Barrel exports for all error handling components + +### Documentation & Examples + +6. **README.md** (13 KB) + - Comprehensive documentation + - API reference + - Best practices + - Migration guide + - Testing examples + +7. **INTEGRATION_GUIDE.md** (8.5 KB) + - Quick start guide for each backend + - Step-by-step integration instructions + - Common patterns + - Checklist for migration + +8. **nestjs-integration.example.ts** (6.7 KB) + - Complete NestJS integration example + - Bootstrap configuration + - Service/Controller examples + - Request ID middleware + - Custom domain errors + +9. **express-integration.example.ts** (12 KB) + - Complete Express integration example + - App setup + - Router examples + - Async handler wrapper + - Custom logger integration + +## Updates to Existing Files + +### shared-libs/core/index.ts + +Added error handling exports (lines 136-153): +```typescript +// Error Handling +export { + BaseError, + ErrorResponse, + BadRequestError, + UnauthorizedError, + ForbiddenError, + NotFoundError, + ConflictError, + ValidationError, + InternalServerError, + GlobalExceptionFilter, + createErrorMiddleware, + errorMiddleware, + notFoundMiddleware, + ErrorLogger, + ErrorMiddlewareOptions, +} from './errors'; +``` + +## Error Response Format + +All backends now return errors in this standardized format: + +```json +{ + "statusCode": 404, + "error": "Not Found", + "message": "User not found", + "details": { + "userId": "999" + }, + "timestamp": "2025-12-12T10:30:00.000Z", + "path": "/api/users/999", + "requestId": "550e8400-e29b-41d4-a716-446655440000" +} +``` + +## Features + +### 1. Standardized Error Structure +- Consistent error format across all backends +- HTTP status codes +- Error type strings +- Human-readable messages +- Optional contextual details +- ISO 8601 timestamps +- Request path tracking +- Request ID correlation + +### 2. Framework Support +- **NestJS**: Global exception filter with decorator support +- **Express**: Error middleware with custom logger support +- Both frameworks support request ID tracking + +### 3. Error Classes +- Base abstract class for extensibility +- 7 built-in HTTP error classes +- Support for custom domain-specific errors +- Type-safe error details + +### 4. Logging +- Automatic severity-based logging +- ERROR level for 500+ errors +- WARN level for 400-499 errors +- INFO level for other status codes +- Stack trace inclusion in logs +- Request correlation via request IDs + +### 5. Developer Experience +- TypeScript support with full type definitions +- Comprehensive JSDoc documentation +- Extensive examples for both frameworks +- Easy migration path from existing error handling +- No try/catch required in controllers/routes + +## Integration Requirements + +### For NestJS Backends (gamilit, platform_marketing_content) + +1. Add `GlobalExceptionFilter` to main.ts +2. Replace manual error throwing with standardized error classes +3. Remove try/catch blocks from controllers +4. Optional: Add request ID middleware + +### For Express Backends (trading-platform) + +1. Add error middleware (must be last) +2. Optional: Add 404 middleware +3. Update route handlers to use error classes +4. Use async handler wrapper for async routes +5. Optional: Add request ID middleware + +## Testing + +Both frameworks support standard testing patterns: + +```typescript +// Test example +it('should return 404 when user not found', async () => { + const response = await request(app) + .get('/api/users/999') + .expect(404); + + expect(response.body).toMatchObject({ + statusCode: 404, + error: 'Not Found', + message: 'User not found' + }); +}); +``` + +## Benefits + +1. **Consistency**: All backends return errors in the same format +2. **Maintainability**: Centralized error handling logic +3. **Debugging**: Request IDs for tracing errors across services +4. **Type Safety**: Full TypeScript support +5. **Extensibility**: Easy to add custom domain errors +6. **Logging**: Automatic structured logging +7. **API Documentation**: Predictable error responses +8. **Client Experience**: Clear, actionable error messages + +## Next Steps + +1. **gamilit backend**: Integrate GlobalExceptionFilter +2. **trading-platform backend**: Integrate error middleware +3. **platform_marketing_content backend**: Integrate GlobalExceptionFilter +4. Update API documentation with new error format +5. Update client-side error handling +6. Add integration tests for error responses +7. Configure error monitoring/alerting + +## File Locations + +All files are located in: +``` +/home/isem/workspace/projects/erp-suite/apps/shared-libs/core/errors/ +``` + +### Core Files +- `base-error.ts` +- `http-errors.ts` +- `error-filter.ts` +- `error-middleware.ts` +- `index.ts` + +### Documentation +- `README.md` +- `INTEGRATION_GUIDE.md` +- `IMPLEMENTATION_SUMMARY.md` (this file) + +### Examples +- `nestjs-integration.example.ts` +- `express-integration.example.ts` + +## Import Usage + +```typescript +// Import from @erp-suite/core +import { + NotFoundError, + ValidationError, + GlobalExceptionFilter, + createErrorMiddleware, +} from '@erp-suite/core'; +``` + +## Custom Error Example + +```typescript +import { BaseError } from '@erp-suite/core'; + +export class InsufficientBalanceError extends BaseError { + readonly statusCode = 400; + readonly error = 'Insufficient Balance'; + + constructor(required: number, available: number) { + super('Insufficient balance for this operation', { + required, + available, + deficit: required - available, + }); + } +} +``` + +## Support + +For questions or issues: +- See detailed examples in `nestjs-integration.example.ts` and `express-integration.example.ts` +- Refer to `README.md` for comprehensive documentation +- Follow `INTEGRATION_GUIDE.md` for step-by-step integration + +--- + +**Status**: ✅ Implementation Complete +**Ready for Integration**: Yes +**Breaking Changes**: No (additive only) diff --git a/apps/shared-libs/core/errors/INTEGRATION_GUIDE.md b/apps/shared-libs/core/errors/INTEGRATION_GUIDE.md new file mode 100644 index 0000000..4fc633b --- /dev/null +++ b/apps/shared-libs/core/errors/INTEGRATION_GUIDE.md @@ -0,0 +1,421 @@ +# Error Handling Integration Guide + +Quick start guide for integrating standardized error handling into each backend. + +## Sprint 1 P1 - Cross-cutting Corrections + +### Projects to Update + +1. **gamilit** (NestJS) - `/home/isem/workspace/projects/gamilit/apps/backend` +2. **trading-platform** (Express) - `/home/isem/workspace/projects/trading-platform/apps/backend` +3. **platform_marketing_content** (NestJS) - `/home/isem/workspace/projects/platform_marketing_content/apps/backend` + +--- + +## NestJS Integration (gamilit, platform_marketing_content) + +### Step 1: Update main.ts + +```typescript +// src/main.ts +import { NestFactory } from '@nestjs/core'; +import { GlobalExceptionFilter } from '@erp-suite/core'; +import { AppModule } from './app.module'; + +async function bootstrap() { + const app = await NestFactory.create(AppModule); + + // Add global exception filter + app.useGlobalFilters(new GlobalExceptionFilter()); + + // ... rest of your configuration + + await app.listen(3000); +} + +bootstrap(); +``` + +### Step 2: Update Services + +Replace manual error throwing with standardized errors: + +**Before:** +```typescript +async findById(id: string): Promise { + const user = await this.repository.findOne({ where: { id } }); + if (!user) { + throw new HttpException('User not found', HttpStatus.NOT_FOUND); + } + return user; +} +``` + +**After:** +```typescript +import { NotFoundError } from '@erp-suite/core'; + +async findById(id: string): Promise { + const user = await this.repository.findOne({ where: { id } }); + if (!user) { + throw new NotFoundError('User not found', { userId: id }); + } + return user; +} +``` + +### Step 3: Remove Try/Catch from Controllers + +**Before:** +```typescript +@Get(':id') +async getUser(@Param('id') id: string) { + try { + return await this.service.findById(id); + } catch (error) { + throw new HttpException('Error finding user', 500); + } +} +``` + +**After:** +```typescript +@Get(':id') +async getUser(@Param('id') id: string) { + return this.service.findById(id); + // GlobalExceptionFilter handles errors automatically +} +``` + +### Step 4: Add Request ID Middleware (Optional) + +```typescript +// src/middleware/request-id.middleware.ts +import { Injectable, NestMiddleware } from '@nestjs/common'; +import { Request, Response, NextFunction } from 'express'; +import { randomUUID } from 'crypto'; + +@Injectable() +export class RequestIdMiddleware implements NestMiddleware { + use(req: Request, res: Response, next: NextFunction) { + const requestId = + (req.headers['x-request-id'] as string) || + randomUUID(); + + req.headers['x-request-id'] = requestId; + res.setHeader('X-Request-ID', requestId); + + next(); + } +} +``` + +```typescript +// src/app.module.ts +import { Module, NestModule, MiddlewareConsumer } from '@nestjs/common'; +import { RequestIdMiddleware } from './middleware/request-id.middleware'; + +@Module({ + // ... your module config +}) +export class AppModule implements NestModule { + configure(consumer: MiddlewareConsumer) { + consumer.apply(RequestIdMiddleware).forRoutes('*'); + } +} +``` + +--- + +## Express Integration (trading-platform) + +### Step 1: Update Main Server File + +```typescript +// src/index.ts +import express from 'express'; +import { + createErrorMiddleware, + notFoundMiddleware +} from '@erp-suite/core'; + +const app = express(); + +// Body parsing +app.use(express.json()); +app.use(express.urlencoded({ extended: true })); + +// Request ID middleware (optional) +app.use(requestIdMiddleware); + +// Your routes +app.use('/api/users', usersRouter); +app.use('/api/products', productsRouter); + +// 404 handler (must be before error handler) +app.use(notFoundMiddleware); + +// Error handling middleware (MUST BE LAST) +app.use(createErrorMiddleware({ + includeStackTrace: process.env.NODE_ENV !== 'production' +})); + +app.listen(3000); +``` + +### Step 2: Update Route Handlers + +**Before:** +```typescript +router.get('/:id', async (req, res) => { + try { + const user = await findUser(req.params.id); + res.json(user); + } catch (error) { + res.status(500).json({ error: 'Internal server error' }); + } +}); +``` + +**After:** +```typescript +import { NotFoundError } from '@erp-suite/core'; + +// Create async handler helper +const asyncHandler = (fn) => (req, res, next) => { + Promise.resolve(fn(req, res, next)).catch(next); +}; + +router.get('/:id', asyncHandler(async (req, res) => { + const user = await findUser(req.params.id); + res.json(user); + // Errors automatically caught and passed to error middleware +})); + +// In service/model +async function findUser(id: string): Promise { + const user = await db.users.findOne(id); + if (!user) { + throw new NotFoundError('User not found', { userId: id }); + } + return user; +} +``` + +### Step 3: Add Request ID Middleware (Optional) + +```typescript +// src/middleware/request-id.middleware.ts +import { Request, Response, NextFunction } from 'express'; +import { randomUUID } from 'crypto'; + +export function requestIdMiddleware( + req: Request, + res: Response, + next: NextFunction +) { + const requestId = + (req.headers['x-request-id'] as string) || + randomUUID(); + + (req as any).requestId = requestId; + res.setHeader('X-Request-ID', requestId); + + next(); +} +``` + +### Step 4: Update Services + +```typescript +// Before +async function createUser(email: string, name: string) { + if (!email.includes('@')) { + throw new Error('Invalid email'); + } + // ... +} + +// After +import { ValidationError, ConflictError } from '@erp-suite/core'; + +async function createUser(email: string, name: string) { + if (!email.includes('@')) { + throw new ValidationError('Invalid email format', { + field: 'email', + value: email + }); + } + + const existing = await db.users.findByEmail(email); + if (existing) { + throw new ConflictError('Email already exists', { + email, + existingUserId: existing.id + }); + } + + // ... +} +``` + +--- + +## Common Error Patterns + +### Validation Errors + +```typescript +import { ValidationError } from '@erp-suite/core'; + +throw new ValidationError('Validation failed', { + errors: [ + { field: 'email', message: 'Invalid format' }, + { field: 'age', message: 'Must be at least 18' } + ] +}); +``` + +### Not Found + +```typescript +import { NotFoundError } from '@erp-suite/core'; + +throw new NotFoundError('Resource not found', { + resourceType: 'User', + resourceId: id +}); +``` + +### Unauthorized + +```typescript +import { UnauthorizedError } from '@erp-suite/core'; + +throw new UnauthorizedError('Invalid credentials'); +``` + +### Conflict + +```typescript +import { ConflictError } from '@erp-suite/core'; + +throw new ConflictError('Email already exists', { + email, + existingId: existingUser.id +}); +``` + +### Custom Domain Errors + +```typescript +import { BaseError } from '@erp-suite/core'; + +export class InsufficientBalanceError extends BaseError { + readonly statusCode = 400; + readonly error = 'Insufficient Balance'; + + constructor(required: number, available: number) { + super('Insufficient balance for this operation', { + required, + available, + deficit: required - available + }); + } +} +``` + +--- + +## Testing + +### NestJS Tests + +```typescript +it('should return 404 when user not found', async () => { + const response = await request(app.getHttpServer()) + .get('/users/999') + .expect(404); + + expect(response.body).toMatchObject({ + statusCode: 404, + error: 'Not Found', + message: 'User not found' + }); +}); +``` + +### Express Tests + +```typescript +it('should return 404 when user not found', async () => { + const response = await request(app) + .get('/api/users/999') + .expect(404); + + expect(response.body).toMatchObject({ + statusCode: 404, + error: 'Not Found', + message: 'User not found' + }); +}); +``` + +--- + +## Migration Checklist + +### For Each Backend: + +- [ ] Install/update `@erp-suite/core` dependency +- [ ] Add global error filter/middleware +- [ ] Add request ID middleware (optional but recommended) +- [ ] Update services to use standardized error classes +- [ ] Remove try/catch blocks from controllers/routes +- [ ] Update error responses in tests +- [ ] Test error responses in development +- [ ] Verify error logging works correctly +- [ ] Update API documentation with new error format + +--- + +## Error Response Format + +All backends now return errors in this standardized format: + +```json +{ + "statusCode": 404, + "error": "Not Found", + "message": "User not found", + "details": { + "userId": "999" + }, + "timestamp": "2025-12-12T10:30:00.000Z", + "path": "/api/users/999", + "requestId": "550e8400-e29b-41d4-a716-446655440000" +} +``` + +--- + +## Available Error Classes + +| Class | Status | Use Case | +|-------|--------|----------| +| `BadRequestError` | 400 | Invalid request parameters | +| `UnauthorizedError` | 401 | Missing/invalid authentication | +| `ForbiddenError` | 403 | Insufficient permissions | +| `NotFoundError` | 404 | Resource doesn't exist | +| `ConflictError` | 409 | Resource conflict | +| `ValidationError` | 422 | Validation failed | +| `InternalServerError` | 500 | Unexpected server error | + +--- + +## Support + +For detailed examples, see: +- `nestjs-integration.example.ts` +- `express-integration.example.ts` +- `README.md` diff --git a/apps/shared-libs/core/errors/QUICK_REFERENCE.md b/apps/shared-libs/core/errors/QUICK_REFERENCE.md new file mode 100644 index 0000000..7915463 --- /dev/null +++ b/apps/shared-libs/core/errors/QUICK_REFERENCE.md @@ -0,0 +1,243 @@ +# Error Handling Quick Reference + +## Import + +```typescript +import { + NotFoundError, + ValidationError, + UnauthorizedError, + BadRequestError, + ConflictError, + ForbiddenError, + InternalServerError, + GlobalExceptionFilter, + createErrorMiddleware, + notFoundMiddleware, +} from '@erp-suite/core'; +``` + +## Error Classes + +| Class | Status | Usage | +|-------|--------|-------| +| `BadRequestError(msg, details?)` | 400 | Invalid request | +| `UnauthorizedError(msg, details?)` | 401 | No/invalid auth | +| `ForbiddenError(msg, details?)` | 403 | No permission | +| `NotFoundError(msg, details?)` | 404 | Not found | +| `ConflictError(msg, details?)` | 409 | Duplicate/conflict | +| `ValidationError(msg, details?)` | 422 | Validation failed | +| `InternalServerError(msg, details?)` | 500 | Server error | + +## NestJS Setup + +### main.ts +```typescript +import { GlobalExceptionFilter } from '@erp-suite/core'; + +app.useGlobalFilters(new GlobalExceptionFilter()); +``` + +### Usage +```typescript +throw new NotFoundError('User not found', { userId: id }); +``` + +## Express Setup + +### index.ts +```typescript +import { createErrorMiddleware, notFoundMiddleware } from '@erp-suite/core'; + +// Routes +app.use('/api', routes); + +// 404 handler +app.use(notFoundMiddleware); + +// Error handler (MUST BE LAST) +app.use(createErrorMiddleware()); +``` + +### Async Handler +```typescript +const asyncHandler = (fn) => (req, res, next) => + Promise.resolve(fn(req, res, next)).catch(next); + +app.get('/users/:id', asyncHandler(async (req, res) => { + const user = await findUser(req.params.id); + res.json(user); +})); +``` + +### Usage +```typescript +throw new NotFoundError('User not found', { userId: id }); +``` + +## Common Patterns + +### Not Found +```typescript +if (!user) { + throw new NotFoundError('User not found', { userId: id }); +} +``` + +### Validation +```typescript +throw new ValidationError('Validation failed', { + errors: [ + { field: 'email', message: 'Invalid format' }, + { field: 'age', message: 'Must be 18+' } + ] +}); +``` + +### Unauthorized +```typescript +if (!token) { + throw new UnauthorizedError('Token required'); +} +``` + +### Conflict +```typescript +if (existingUser) { + throw new ConflictError('Email exists', { email }); +} +``` + +### Bad Request +```typescript +if (!validInput) { + throw new BadRequestError('Invalid input', { field: 'value' }); +} +``` + +## Custom Errors + +```typescript +import { BaseError } from '@erp-suite/core'; + +export class CustomError extends BaseError { + readonly statusCode = 400; + readonly error = 'Custom Error'; + + constructor(details?: Record) { + super('Custom error message', details); + } +} +``` + +## Error Response + +```json +{ + "statusCode": 404, + "error": "Not Found", + "message": "User not found", + "details": { "userId": "999" }, + "timestamp": "2025-12-12T10:30:00.000Z", + "path": "/api/users/999", + "requestId": "uuid-here" +} +``` + +## Request ID Middleware + +### NestJS +```typescript +@Injectable() +export class RequestIdMiddleware implements NestMiddleware { + use(req: Request, res: Response, next: NextFunction) { + const id = req.headers['x-request-id'] || randomUUID(); + req.headers['x-request-id'] = id; + res.setHeader('X-Request-ID', id); + next(); + } +} +``` + +### Express +```typescript +function requestIdMiddleware(req, res, next) { + const id = req.headers['x-request-id'] || randomUUID(); + req.requestId = id; + res.setHeader('X-Request-ID', id); + next(); +} + +app.use(requestIdMiddleware); +``` + +## Testing + +```typescript +it('should return 404', async () => { + const res = await request(app) + .get('/users/999') + .expect(404); + + expect(res.body).toMatchObject({ + statusCode: 404, + error: 'Not Found', + message: 'User not found' + }); +}); +``` + +## DON'Ts + +❌ Don't use generic Error +```typescript +throw new Error('Not found'); // Bad +``` + +❌ Don't try/catch in controllers (NestJS) +```typescript +try { + return await service.findById(id); +} catch (e) { + throw new HttpException('Error', 500); +} +``` + +❌ Don't handle errors manually (Express) +```typescript +try { + const user = await findUser(id); + res.json(user); +} catch (e) { + res.status(500).json({ error: 'Error' }); +} +``` + +## DOs + +✅ Use specific error classes +```typescript +throw new NotFoundError('User not found', { userId: id }); +``` + +✅ Let filter/middleware handle (NestJS) +```typescript +async getUser(id: string) { + return this.service.findById(id); +} +``` + +✅ Use asyncHandler (Express) +```typescript +app.get('/users/:id', asyncHandler(async (req, res) => { + const user = await findUser(req.params.id); + res.json(user); +})); +``` + +✅ Add contextual details +```typescript +throw new ValidationError('Validation failed', { + errors: validationErrors +}); +``` diff --git a/apps/shared-libs/core/errors/README.md b/apps/shared-libs/core/errors/README.md new file mode 100644 index 0000000..983297d --- /dev/null +++ b/apps/shared-libs/core/errors/README.md @@ -0,0 +1,574 @@ +# Error Handling System + +Standardized error handling for all ERP-Suite backends (NestJS and Express). + +## Overview + +This module provides: +- **Base error classes** with consistent structure +- **HTTP-specific errors** for common status codes +- **NestJS exception filter** for automatic error handling +- **Express middleware** for error handling +- **Request tracking** with request IDs +- **Structured logging** with severity levels + +## Installation + +The error handling module is part of `@erp-suite/core`: + +```typescript +import { + // Base types + BaseError, + ErrorResponse, + + // HTTP errors + BadRequestError, + UnauthorizedError, + ForbiddenError, + NotFoundError, + ConflictError, + ValidationError, + InternalServerError, + + // NestJS + GlobalExceptionFilter, + + // Express + createErrorMiddleware, + errorMiddleware, + notFoundMiddleware, +} from '@erp-suite/core'; +``` + +## Quick Start + +### NestJS Integration + +```typescript +// main.ts +import { NestFactory } from '@nestjs/core'; +import { GlobalExceptionFilter } from '@erp-suite/core'; + +async function bootstrap() { + const app = await NestFactory.create(AppModule); + + // Register global exception filter + app.useGlobalFilters(new GlobalExceptionFilter()); + + await app.listen(3000); +} +``` + +### Express Integration + +```typescript +// index.ts +import express from 'express'; +import { createErrorMiddleware, notFoundMiddleware } from '@erp-suite/core'; + +const app = express(); + +// Your routes here +app.use('/api', routes); + +// 404 handler (before error middleware) +app.use(notFoundMiddleware); + +// Error handler (must be last) +app.use(createErrorMiddleware()); + +app.listen(3000); +``` + +## Error Classes + +### HTTP Errors + +All HTTP error classes extend `BaseError` and include: +- `statusCode`: HTTP status code +- `error`: Error type string +- `message`: Human-readable message +- `details`: Optional additional context + +#### Available Error Classes + +| Class | Status Code | Usage | +|-------|-------------|-------| +| `BadRequestError` | 400 | Invalid request parameters | +| `UnauthorizedError` | 401 | Missing or invalid authentication | +| `ForbiddenError` | 403 | Authenticated but insufficient permissions | +| `NotFoundError` | 404 | Resource doesn't exist | +| `ConflictError` | 409 | Resource conflict (e.g., duplicate) | +| `ValidationError` | 422 | Validation failed | +| `InternalServerError` | 500 | Unexpected server error | + +#### Usage Examples + +```typescript +// Not Found +throw new NotFoundError('User not found', { userId: '123' }); + +// Validation +throw new ValidationError('Invalid input', { + errors: [ + { field: 'email', message: 'Invalid format' }, + { field: 'age', message: 'Must be 18+' } + ] +}); + +// Unauthorized +throw new UnauthorizedError('Invalid token'); + +// Conflict +throw new ConflictError('Email already exists', { email: 'user@example.com' }); +``` + +### Custom Domain Errors + +Create custom errors for your domain: + +```typescript +import { BaseError } from '@erp-suite/core'; + +export class InsufficientBalanceError extends BaseError { + readonly statusCode = 400; + readonly error = 'Insufficient Balance'; + + constructor(required: number, available: number) { + super('Insufficient balance for this operation', { + required, + available, + deficit: required - available, + }); + } +} + +// Usage +throw new InsufficientBalanceError(100, 50); +``` + +## Error Response Format + +All errors are converted to this standardized format: + +```typescript +interface ErrorResponse { + statusCode: number; // HTTP status code + error: string; // Error type + message: string; // Human-readable message + details?: object; // Optional additional context + timestamp: string; // ISO 8601 timestamp + path?: string; // Request path + requestId?: string; // Request tracking ID +} +``` + +### Example Response + +```json +{ + "statusCode": 404, + "error": "Not Found", + "message": "User not found", + "details": { + "userId": "999" + }, + "timestamp": "2025-12-12T10:30:00.000Z", + "path": "/api/users/999", + "requestId": "550e8400-e29b-41d4-a716-446655440000" +} +``` + +## NestJS Details + +### Global Filter Registration + +**Option 1: In main.ts** (Recommended for simple cases) +```typescript +const app = await NestFactory.create(AppModule); +app.useGlobalFilters(new GlobalExceptionFilter()); +``` + +**Option 2: As Provider** (Recommended for DI support) +```typescript +import { APP_FILTER } from '@nestjs/core'; + +@Module({ + providers: [ + { + provide: APP_FILTER, + useClass: GlobalExceptionFilter, + }, + ], +}) +export class AppModule {} +``` + +### Using in Controllers/Services + +```typescript +@Injectable() +export class UsersService { + async findById(id: string): Promise { + const user = await this.repository.findOne({ where: { id } }); + + if (!user) { + throw new NotFoundError('User not found', { userId: id }); + } + + return user; + } +} + +@Controller('users') +export class UsersController { + @Get(':id') + async getUser(@Param('id') id: string): Promise { + // Errors are automatically caught and formatted + return this.usersService.findById(id); + } +} +``` + +### Request ID Tracking + +```typescript +import { Injectable, NestMiddleware } from '@nestjs/common'; +import { randomUUID } from 'crypto'; + +@Injectable() +export class RequestIdMiddleware implements NestMiddleware { + use(req: Request, res: Response, next: NextFunction) { + const requestId = req.headers['x-request-id'] || randomUUID(); + req.headers['x-request-id'] = requestId; + res.setHeader('X-Request-ID', requestId); + next(); + } +} +``` + +## Express Details + +### Middleware Setup + +```typescript +import express from 'express'; +import { + createErrorMiddleware, + notFoundMiddleware, + ErrorLogger, +} from '@erp-suite/core'; + +const app = express(); + +// Body parsing +app.use(express.json()); + +// Your routes +app.use('/api/users', usersRouter); + +// 404 handler (optional but recommended) +app.use(notFoundMiddleware); + +// Error middleware (MUST be last) +app.use(createErrorMiddleware({ + logger: customLogger, + includeStackTrace: process.env.NODE_ENV !== 'production', +})); +``` + +### Configuration Options + +```typescript +interface ErrorMiddlewareOptions { + logger?: ErrorLogger; // Custom logger + includeStackTrace?: boolean; // Include stack traces (dev only) + transformer?: (error, response) => response; // Custom transformer +} +``` + +### Custom Logger + +```typescript +import { ErrorLogger } from '@erp-suite/core'; + +class CustomLogger implements ErrorLogger { + error(message: string, ...meta: any[]): void { + winston.error(message, ...meta); + } + + warn(message: string, ...meta: any[]): void { + winston.warn(message, ...meta); + } + + log(message: string, ...meta: any[]): void { + winston.info(message, ...meta); + } +} + +app.use(createErrorMiddleware({ + logger: new CustomLogger(), +})); +``` + +### Async Route Handlers + +Use an async handler wrapper to automatically catch errors: + +```typescript +function asyncHandler(fn) { + return (req, res, next) => { + Promise.resolve(fn(req, res, next)).catch(next); + }; +} + +app.get('/users/:id', asyncHandler(async (req, res) => { + const user = await findUserById(req.params.id); + res.json(user); +})); +``` + +### Using in Routes + +```typescript +const router = express.Router(); + +router.get('/:id', async (req, res, next) => { + try { + const user = await usersService.findById(req.params.id); + res.json(user); + } catch (error) { + next(error); // Pass to error middleware + } +}); +``` + +## Logging + +### Log Levels + +Errors are automatically logged with appropriate severity: + +- **ERROR** (500+): Server errors, unexpected errors +- **WARN** (400-499): Client errors, validation failures +- **INFO** (<400): Informational messages + +### Log Format + +```typescript +// Error log +[500] Internal Server Error: Database connection failed +{ + "path": "/api/users", + "requestId": "req-123", + "details": { ... }, + "stack": "Error: ...\n at ..." +} + +// Warning log +[404] Not Found: User not found +{ + "path": "/api/users/999", + "requestId": "req-124", + "details": { "userId": "999" } +} +``` + +## Best Practices + +### 1. Use Specific Error Classes + +```typescript +// Good +throw new NotFoundError('User not found', { userId }); + +// Avoid +throw new Error('Not found'); +``` + +### 2. Include Contextual Details + +```typescript +// Good - includes helpful context +throw new ValidationError('Validation failed', { + errors: [ + { field: 'email', message: 'Invalid format' }, + { field: 'password', message: 'Too short' } + ] +}); + +// Less helpful +throw new ValidationError('Invalid input'); +``` + +### 3. Throw Early, Handle Centrally + +```typescript +// Service layer - throw errors +async findById(id: string): Promise { + const user = await this.repository.findOne(id); + if (!user) { + throw new NotFoundError('User not found', { userId: id }); + } + return user; +} + +// Controller/Route - let filter/middleware handle +@Get(':id') +async getUser(@Param('id') id: string) { + return this.service.findById(id); // Don't try/catch here +} +``` + +### 4. Don't Expose Internal Details in Production + +```typescript +// Good +throw new InternalServerError('Database operation failed'); + +// Avoid in production +throw new InternalServerError('Connection to PostgreSQL at 10.0.0.5:5432 failed'); +``` + +### 5. Use Request IDs for Tracking + +Always include request ID middleware to enable request tracing across logs. + +## Migration Guide + +### From Manual Error Handling (NestJS) + +**Before:** +```typescript +@Get(':id') +async getUser(@Param('id') id: string) { + try { + const user = await this.service.findById(id); + return user; + } catch (error) { + throw new HttpException('User not found', HttpStatus.NOT_FOUND); + } +} +``` + +**After:** +```typescript +@Get(':id') +async getUser(@Param('id') id: string) { + return this.service.findById(id); // Service throws NotFoundError +} + +// In service +async findById(id: string) { + const user = await this.repository.findOne(id); + if (!user) { + throw new NotFoundError('User not found', { userId: id }); + } + return user; +} +``` + +### From Manual Error Handling (Express) + +**Before:** +```typescript +app.get('/users/:id', async (req, res) => { + try { + const user = await findUser(req.params.id); + res.json(user); + } catch (error) { + res.status(500).json({ error: 'Internal error' }); + } +}); +``` + +**After:** +```typescript +app.get('/users/:id', asyncHandler(async (req, res) => { + const user = await findUser(req.params.id); // Throws NotFoundError + res.json(user); +})); + +// Error middleware handles it automatically +``` + +## Testing + +### Testing Error Responses (NestJS) + +```typescript +it('should return 404 when user not found', async () => { + const response = await request(app.getHttpServer()) + .get('/users/999') + .expect(404); + + expect(response.body).toMatchObject({ + statusCode: 404, + error: 'Not Found', + message: 'User not found', + details: { userId: '999' }, + }); + + expect(response.body.timestamp).toBeDefined(); + expect(response.body.path).toBe('/users/999'); +}); +``` + +### Testing Error Responses (Express) + +```typescript +it('should return 404 when user not found', async () => { + const response = await request(app) + .get('/api/users/999') + .expect(404); + + expect(response.body).toMatchObject({ + statusCode: 404, + error: 'Not Found', + message: 'User not found', + }); +}); +``` + +### Testing Custom Errors + +```typescript +describe('InsufficientBalanceError', () => { + it('should create error with correct details', () => { + const error = new InsufficientBalanceError(100, 50); + + expect(error.statusCode).toBe(400); + expect(error.message).toBe('Insufficient balance for this operation'); + expect(error.details).toEqual({ + required: 100, + available: 50, + deficit: 50, + }); + }); +}); +``` + +## Examples + +See detailed integration examples: +- **NestJS**: `nestjs-integration.example.ts` +- **Express**: `express-integration.example.ts` + +## Files + +``` +errors/ +├── base-error.ts # Base error class and types +├── http-errors.ts # HTTP-specific error classes +├── error-filter.ts # NestJS exception filter +├── error-middleware.ts # Express error middleware +├── index.ts # Module exports +├── README.md # This file +├── nestjs-integration.example.ts # NestJS examples +└── express-integration.example.ts # Express examples +``` + +## Support + +For questions or issues, contact the ERP-Suite development team. diff --git a/apps/shared-libs/core/errors/STRUCTURE.md b/apps/shared-libs/core/errors/STRUCTURE.md new file mode 100644 index 0000000..22ad358 --- /dev/null +++ b/apps/shared-libs/core/errors/STRUCTURE.md @@ -0,0 +1,241 @@ +# Error Handling Module Structure + +``` +erp-suite/apps/shared-libs/core/errors/ +│ +├── Core Implementation Files +│ ├── base-error.ts # Base error class & ErrorResponse interface +│ ├── http-errors.ts # 7 HTTP-specific error classes +│ ├── error-filter.ts # NestJS GlobalExceptionFilter +│ ├── error-middleware.ts # Express error middleware +│ └── index.ts # Module exports +│ +├── Documentation +│ ├── README.md # Comprehensive documentation (13 KB) +│ ├── INTEGRATION_GUIDE.md # Step-by-step integration guide (9.4 KB) +│ ├── IMPLEMENTATION_SUMMARY.md # Implementation summary (7.2 KB) +│ ├── QUICK_REFERENCE.md # Quick reference cheat sheet (4.9 KB) +│ └── STRUCTURE.md # This file +│ +└── Examples + ├── nestjs-integration.example.ts # Complete NestJS example (6.7 KB) + └── express-integration.example.ts # Complete Express example (12 KB) +``` + +## File Purposes + +### Core Files + +**base-error.ts** +- `ErrorResponse` interface: Standardized error response structure +- `BaseError` abstract class: Base for all custom errors +- Methods: `toResponse()` for HTTP response conversion + +**http-errors.ts** +- BadRequestError (400) +- UnauthorizedError (401) +- ForbiddenError (403) +- NotFoundError (404) +- ConflictError (409) +- ValidationError (422) +- InternalServerError (500) + +**error-filter.ts** +- `GlobalExceptionFilter`: NestJS exception filter +- Handles: BaseError, HttpException, generic errors +- Features: Request ID tracking, severity-based logging + +**error-middleware.ts** +- `createErrorMiddleware()`: Factory function +- `errorMiddleware`: Default instance +- `notFoundMiddleware`: 404 handler +- `ErrorLogger` interface +- `ErrorMiddlewareOptions` interface + +**index.ts** +- Barrel exports for all error handling components + +### Documentation Files + +**README.md** - Main documentation +- Overview and installation +- Quick start guides +- Detailed API reference +- Best practices +- Migration guide +- Testing examples + +**INTEGRATION_GUIDE.md** - Integration instructions +- Step-by-step for each backend +- NestJS integration +- Express integration +- Common patterns +- Migration checklist + +**IMPLEMENTATION_SUMMARY.md** - Summary +- Files created +- Features implemented +- Integration requirements +- Benefits +- Next steps + +**QUICK_REFERENCE.md** - Cheat sheet +- Quick imports +- Error class reference +- Common patterns +- Setup snippets +- DOs and DON'Ts + +**STRUCTURE.md** - This file +- Module structure +- File purposes +- Dependencies + +### Example Files + +**nestjs-integration.example.ts** +- Bootstrap configuration +- Global filter setup +- Service examples +- Controller examples +- Request ID middleware +- Custom domain errors + +**express-integration.example.ts** +- App setup +- Middleware configuration +- Router examples +- Async handler wrapper +- Custom logger integration +- Service layer examples + +## Dependencies + +### External Dependencies +- `@nestjs/common` (for NestJS filter) +- `express` (for Express middleware) +- `crypto` (for request ID generation) + +### Internal Dependencies +- None (standalone module in @erp-suite/core) + +## Exports + +All exports available from `@erp-suite/core`: + +```typescript +// Types +import { ErrorResponse } from '@erp-suite/core'; + +// Base class +import { BaseError } from '@erp-suite/core'; + +// HTTP errors +import { + BadRequestError, + UnauthorizedError, + ForbiddenError, + NotFoundError, + ConflictError, + ValidationError, + InternalServerError, +} from '@erp-suite/core'; + +// NestJS +import { GlobalExceptionFilter } from '@erp-suite/core'; + +// Express +import { + createErrorMiddleware, + errorMiddleware, + notFoundMiddleware, + ErrorLogger, + ErrorMiddlewareOptions, +} from '@erp-suite/core'; +``` + +## Target Backends + +1. **gamilit** - NestJS backend + - Location: `~/workspace/projects/gamilit/apps/backend` + - Integration: GlobalExceptionFilter + +2. **trading-platform** - Express backend + - Location: `~/workspace/projects/trading-platform/apps/backend` + - Integration: createErrorMiddleware + +3. **platform_marketing_content** - NestJS backend + - Location: `~/workspace/projects/platform_marketing_content/apps/backend` + - Integration: GlobalExceptionFilter + +## Integration Flow + +``` +1. Import from @erp-suite/core + ↓ +2. Setup (one-time) + - NestJS: Register GlobalExceptionFilter + - Express: Add error middleware + ↓ +3. Usage (in services/controllers) + - Throw standardized error classes + - No try/catch in controllers/routes + ↓ +4. Automatic handling + - Filter/middleware catches errors + - Converts to ErrorResponse format + - Logs with appropriate severity + - Returns to client +``` + +## Error Flow + +``` +Service/Controller + ↓ (throws BaseError) +Filter/Middleware + ↓ (catches exception) +ErrorResponse Builder + ↓ (formats response) +Logger + ↓ (logs with severity) +HTTP Response + ↓ +Client +``` + +## Testing Structure + +```typescript +// Unit tests +describe('NotFoundError', () => { + it('should create error with correct properties', () => { + const error = new NotFoundError('Not found', { id: '123' }); + expect(error.statusCode).toBe(404); + }); +}); + +// Integration tests +describe('GET /users/:id', () => { + it('should return 404 for non-existent user', async () => { + const response = await request(app) + .get('/users/999') + .expect(404); + + expect(response.body.error).toBe('Not Found'); + }); +}); +``` + +## Total Size + +- Core files: ~18 KB +- Documentation: ~35 KB +- Examples: ~19 KB +- Total: ~72 KB + +## Version + +- Created: 2025-12-12 +- Sprint: Sprint 1 P1 +- Status: Complete diff --git a/apps/shared-libs/core/errors/base-error.ts b/apps/shared-libs/core/errors/base-error.ts new file mode 100644 index 0000000..8e94d2d --- /dev/null +++ b/apps/shared-libs/core/errors/base-error.ts @@ -0,0 +1,71 @@ +/** + * Base Error Handling System + * + * Provides standardized error response structure and base error class + * for all ERP-Suite backends. + * + * @module @erp-suite/core/errors + */ + +/** + * Standardized error response structure + */ +export interface ErrorResponse { + statusCode: number; + error: string; + message: string; + details?: Record; + timestamp: string; + path?: string; + requestId?: string; +} + +/** + * Base error class for all application errors + * + * @abstract + * @example + * ```typescript + * class CustomError extends BaseError { + * readonly statusCode = 400; + * readonly error = 'Custom Error'; + * } + * + * throw new CustomError('Something went wrong', { field: 'value' }); + * ``` + */ +export abstract class BaseError extends Error { + abstract readonly statusCode: number; + abstract readonly error: string; + readonly details?: Record; + + constructor(message: string, details?: Record) { + super(message); + this.details = details; + this.name = this.constructor.name; + + // Maintains proper stack trace for where our error was thrown (only available on V8) + if (Error.captureStackTrace) { + Error.captureStackTrace(this, this.constructor); + } + } + + /** + * Converts the error to a standardized error response + * + * @param path - Optional request path + * @param requestId - Optional request ID for tracking + * @returns Standardized error response object + */ + toResponse(path?: string, requestId?: string): ErrorResponse { + return { + statusCode: this.statusCode, + error: this.error, + message: this.message, + details: this.details, + timestamp: new Date().toISOString(), + path, + requestId, + }; + } +} diff --git a/apps/shared-libs/core/errors/error-filter.ts b/apps/shared-libs/core/errors/error-filter.ts new file mode 100644 index 0000000..8b0efcc --- /dev/null +++ b/apps/shared-libs/core/errors/error-filter.ts @@ -0,0 +1,230 @@ +/** + * NestJS Global Exception Filter + * + * Catches and transforms all exceptions into standardized error responses + * for NestJS applications. + * + * @module @erp-suite/core/errors + */ + +import { + ExceptionFilter, + Catch, + ArgumentsHost, + HttpException, + HttpStatus, + Logger, +} from '@nestjs/common'; +import { Request, Response } from 'express'; +import { BaseError, ErrorResponse } from './base-error'; + +/** + * Global exception filter for NestJS applications + * + * Handles: + * - BaseError instances (custom application errors) + * - HttpException instances (NestJS built-in exceptions) + * - Generic Error instances (unexpected errors) + * + * @example + * ```typescript + * // In main.ts or app.module.ts + * import { GlobalExceptionFilter } from '@erp-suite/core'; + * + * // Option 1: Global filter in main.ts + * const app = await NestFactory.create(AppModule); + * app.useGlobalFilters(new GlobalExceptionFilter()); + * + * // Option 2: As a provider in app.module.ts + * @Module({ + * providers: [ + * { + * provide: APP_FILTER, + * useClass: GlobalExceptionFilter, + * }, + * ], + * }) + * export class AppModule {} + * ``` + */ +@Catch() +export class GlobalExceptionFilter implements ExceptionFilter { + private readonly logger = new Logger(GlobalExceptionFilter.name); + + catch(exception: unknown, host: ArgumentsHost): void { + const ctx = host.switchToHttp(); + const response = ctx.getResponse(); + const request = ctx.getRequest(); + + // Generate request ID if available + const requestId = this.getRequestId(request); + const path = request.url; + + let errorResponse: ErrorResponse; + + // Handle BaseError instances (our custom errors) + if (exception instanceof BaseError) { + errorResponse = exception.toResponse(path, requestId); + this.logError(errorResponse, exception); + } + // Handle NestJS HttpException + else if (exception instanceof HttpException) { + const status = exception.getStatus(); + const exceptionResponse = exception.getResponse(); + + errorResponse = this.buildHttpExceptionResponse( + status, + exceptionResponse, + path, + requestId, + ); + this.logError(errorResponse, exception); + } + // Handle generic errors (unexpected) + else if (exception instanceof Error) { + errorResponse = this.buildGenericErrorResponse( + exception, + path, + requestId, + ); + this.logError(errorResponse, exception, true); + } + // Handle unknown exceptions + else { + errorResponse = this.buildUnknownErrorResponse(path, requestId); + this.logger.error( + `Unknown exception caught: ${JSON.stringify(exception)}`, + exception instanceof Error ? exception.stack : undefined, + ); + } + + response.status(errorResponse.statusCode).json(errorResponse); + } + + /** + * Builds error response from NestJS HttpException + */ + private buildHttpExceptionResponse( + status: number, + exceptionResponse: string | object, + path?: string, + requestId?: string, + ): ErrorResponse { + if (typeof exceptionResponse === 'string') { + return { + statusCode: status, + error: this.getErrorNameFromStatus(status), + message: exceptionResponse, + timestamp: new Date().toISOString(), + path, + requestId, + }; + } + + // Handle structured exception response + const response = exceptionResponse as any; + return { + statusCode: status, + error: response.error || this.getErrorNameFromStatus(status), + message: response.message || 'An error occurred', + details: response.details, + timestamp: new Date().toISOString(), + path, + requestId, + }; + } + + /** + * Builds error response from generic Error + */ + private buildGenericErrorResponse( + error: Error, + path?: string, + requestId?: string, + ): ErrorResponse { + return { + statusCode: HttpStatus.INTERNAL_SERVER_ERROR, + error: 'Internal Server Error', + message: error.message || 'An unexpected error occurred', + details: process.env.NODE_ENV !== 'production' + ? { stack: error.stack } + : undefined, + timestamp: new Date().toISOString(), + path, + requestId, + }; + } + + /** + * Builds error response for unknown exceptions + */ + private buildUnknownErrorResponse( + path?: string, + requestId?: string, + ): ErrorResponse { + return { + statusCode: HttpStatus.INTERNAL_SERVER_ERROR, + error: 'Internal Server Error', + message: 'An unexpected error occurred', + timestamp: new Date().toISOString(), + path, + requestId, + }; + } + + /** + * Gets error name from HTTP status code + */ + private getErrorNameFromStatus(status: number): string { + const errorNames: Record = { + 400: 'Bad Request', + 401: 'Unauthorized', + 403: 'Forbidden', + 404: 'Not Found', + 409: 'Conflict', + 422: 'Validation Error', + 500: 'Internal Server Error', + }; + + return errorNames[status] || 'Error'; + } + + /** + * Extracts request ID from request headers or generates one + */ + private getRequestId(request: Request): string | undefined { + return ( + (request.headers['x-request-id'] as string) || + (request.headers['x-correlation-id'] as string) || + undefined + ); + } + + /** + * Logs error based on severity + */ + private logError( + errorResponse: ErrorResponse, + exception: Error, + isUnexpected: boolean = false, + ): void { + const logMessage = `[${errorResponse.statusCode}] ${errorResponse.error}: ${errorResponse.message}`; + const logContext = { + path: errorResponse.path, + requestId: errorResponse.requestId, + details: errorResponse.details, + }; + + if (isUnexpected || errorResponse.statusCode >= 500) { + this.logger.error( + logMessage, + exception.stack, + JSON.stringify(logContext), + ); + } else if (errorResponse.statusCode >= 400) { + this.logger.warn(logMessage, JSON.stringify(logContext)); + } else { + this.logger.log(logMessage, JSON.stringify(logContext)); + } + } +} diff --git a/apps/shared-libs/core/errors/error-middleware.ts b/apps/shared-libs/core/errors/error-middleware.ts new file mode 100644 index 0000000..49efe48 --- /dev/null +++ b/apps/shared-libs/core/errors/error-middleware.ts @@ -0,0 +1,262 @@ +/** + * Express Error Handling Middleware + * + * Catches and transforms all errors into standardized error responses + * for Express applications. + * + * @module @erp-suite/core/errors + */ + +import { Request, Response, NextFunction, ErrorRequestHandler } from 'express'; +import { BaseError, ErrorResponse } from './base-error'; + +/** + * Logger interface for custom logging implementations + */ +export interface ErrorLogger { + error(message: string, ...meta: any[]): void; + warn(message: string, ...meta: any[]): void; + log(message: string, ...meta: any[]): void; +} + +/** + * Default console logger implementation + */ +class ConsoleLogger implements ErrorLogger { + error(message: string, ...meta: any[]): void { + console.error(message, ...meta); + } + + warn(message: string, ...meta: any[]): void { + console.warn(message, ...meta); + } + + log(message: string, ...meta: any[]): void { + console.log(message, ...meta); + } +} + +/** + * Configuration options for error middleware + */ +export interface ErrorMiddlewareOptions { + /** + * Custom logger instance (defaults to console) + */ + logger?: ErrorLogger; + + /** + * Whether to include stack traces in development mode + */ + includeStackTrace?: boolean; + + /** + * Custom error response transformer + */ + transformer?: (error: Error, errorResponse: ErrorResponse) => ErrorResponse; +} + +/** + * Creates Express error handling middleware + * + * Handles: + * - BaseError instances (custom application errors) + * - Generic Error instances (unexpected errors) + * - Any other thrown values + * + * @param options - Configuration options + * @returns Express error middleware + * + * @example + * ```typescript + * import express from 'express'; + * import { createErrorMiddleware } from '@erp-suite/core'; + * + * const app = express(); + * + * // Your routes here + * app.use('/api', routes); + * + * // Error middleware should be registered last + * app.use(createErrorMiddleware({ + * logger: customLogger, + * includeStackTrace: process.env.NODE_ENV !== 'production' + * })); + * ``` + */ +export function createErrorMiddleware( + options: ErrorMiddlewareOptions = {}, +): ErrorRequestHandler { + const logger = options.logger || new ConsoleLogger(); + const includeStackTrace = options.includeStackTrace ?? process.env.NODE_ENV !== 'production'; + + return ( + err: unknown, + req: Request, + res: Response, + next: NextFunction, + ): void => { + // Extract request metadata + const requestId = getRequestId(req); + const path = req.originalUrl || req.url; + + let errorResponse: ErrorResponse; + + // Handle BaseError instances (our custom errors) + if (err instanceof BaseError) { + errorResponse = err.toResponse(path, requestId); + logError(logger, errorResponse, err); + } + // Handle generic Error instances + else if (err instanceof Error) { + errorResponse = buildGenericErrorResponse( + err, + path, + requestId, + includeStackTrace, + ); + logError(logger, errorResponse, err, true); + } + // Handle unknown errors + else { + errorResponse = buildUnknownErrorResponse(path, requestId); + logger.error( + `Unknown error caught: ${JSON.stringify(err)}`, + { path, requestId }, + ); + } + + // Apply custom transformer if provided + if (options.transformer) { + errorResponse = options.transformer( + err instanceof Error ? err : new Error(String(err)), + errorResponse, + ); + } + + // Send error response + res.status(errorResponse.statusCode).json(errorResponse); + }; +} + +/** + * Legacy export for backward compatibility + * + * @example + * ```typescript + * import { errorMiddleware } from '@erp-suite/core'; + * + * app.use(errorMiddleware); + * ``` + */ +export const errorMiddleware = createErrorMiddleware(); + +/** + * Builds error response from generic Error + */ +function buildGenericErrorResponse( + error: Error, + path?: string, + requestId?: string, + includeStackTrace: boolean = false, +): ErrorResponse { + return { + statusCode: 500, + error: 'Internal Server Error', + message: error.message || 'An unexpected error occurred', + details: includeStackTrace ? { stack: error.stack } : undefined, + timestamp: new Date().toISOString(), + path, + requestId, + }; +} + +/** + * Builds error response for unknown errors + */ +function buildUnknownErrorResponse( + path?: string, + requestId?: string, +): ErrorResponse { + return { + statusCode: 500, + error: 'Internal Server Error', + message: 'An unexpected error occurred', + timestamp: new Date().toISOString(), + path, + requestId, + }; +} + +/** + * Extracts request ID from request headers + */ +function getRequestId(req: Request): string | undefined { + return ( + (req.headers['x-request-id'] as string) || + (req.headers['x-correlation-id'] as string) || + undefined + ); +} + +/** + * Logs error based on severity + */ +function logError( + logger: ErrorLogger, + errorResponse: ErrorResponse, + exception: Error, + isUnexpected: boolean = false, +): void { + const logMessage = `[${errorResponse.statusCode}] ${errorResponse.error}: ${errorResponse.message}`; + const logContext = { + path: errorResponse.path, + requestId: errorResponse.requestId, + details: errorResponse.details, + stack: exception.stack, + }; + + if (isUnexpected || errorResponse.statusCode >= 500) { + logger.error(logMessage, logContext); + } else if (errorResponse.statusCode >= 400) { + logger.warn(logMessage, logContext); + } else { + logger.log(logMessage, logContext); + } +} + +/** + * Not Found (404) middleware helper + * + * Use this before your error middleware to catch routes that don't exist + * + * @example + * ```typescript + * import { notFoundMiddleware, createErrorMiddleware } from '@erp-suite/core'; + * + * // Your routes + * app.use('/api', routes); + * + * // 404 handler + * app.use(notFoundMiddleware); + * + * // Error handler (must be last) + * app.use(createErrorMiddleware()); + * ``` + */ +export function notFoundMiddleware( + req: Request, + res: Response, + next: NextFunction, +): void { + const errorResponse: ErrorResponse = { + statusCode: 404, + error: 'Not Found', + message: `Cannot ${req.method} ${req.originalUrl || req.url}`, + timestamp: new Date().toISOString(), + path: req.originalUrl || req.url, + requestId: getRequestId(req), + }; + + res.status(404).json(errorResponse); +} diff --git a/apps/shared-libs/core/errors/express-integration.example.ts b/apps/shared-libs/core/errors/express-integration.example.ts new file mode 100644 index 0000000..5e664ee --- /dev/null +++ b/apps/shared-libs/core/errors/express-integration.example.ts @@ -0,0 +1,464 @@ +/** + * Express Integration Example + * + * This file demonstrates how to integrate the error handling system + * into an Express application. + * + * @example Integration Steps: + * 1. Set up error middleware (must be last) + * 2. Optionally add 404 handler + * 3. Use custom error classes in your routes + * 4. Configure request ID generation (optional) + */ + +import express, { Request, Response, NextFunction, Router } from 'express'; +import { + createErrorMiddleware, + notFoundMiddleware, + NotFoundError, + ValidationError, + UnauthorizedError, + BadRequestError, + BaseError, +} from '@erp-suite/core'; + +// ======================================== +// Basic Express App Setup +// ======================================== + +/** + * Create Express app with error handling + */ +function createApp() { + const app = express(); + + // Body parsing middleware + app.use(express.json()); + app.use(express.urlencoded({ extended: true })); + + // Request ID middleware (optional but recommended) + app.use(requestIdMiddleware); + + // Your routes + app.use('/api/users', usersRouter); + app.use('/api/products', productsRouter); + + // 404 handler (must be after all routes) + app.use(notFoundMiddleware); + + // Error handling middleware (must be last) + app.use(createErrorMiddleware({ + includeStackTrace: process.env.NODE_ENV !== 'production', + })); + + return app; +} + +// ======================================== +// Request ID Middleware (Optional) +// ======================================== + +import { randomUUID } from 'crypto'; + +/** + * Middleware to generate and track request IDs + */ +function requestIdMiddleware(req: Request, res: Response, next: NextFunction) { + const requestId = + (req.headers['x-request-id'] as string) || + (req.headers['x-correlation-id'] as string) || + randomUUID(); + + // Attach to request for access in handlers + (req as any).requestId = requestId; + + // Include in response headers + res.setHeader('X-Request-ID', requestId); + + next(); +} + +// ======================================== +// Custom Logger Integration +// ======================================== + +import { ErrorLogger } from '@erp-suite/core'; + +/** + * Custom logger implementation (e.g., Winston, Pino) + */ +class WinstonLogger implements ErrorLogger { + error(message: string, ...meta: any[]): void { + // winston.error(message, ...meta); + console.error('[ERROR]', message, ...meta); + } + + warn(message: string, ...meta: any[]): void { + // winston.warn(message, ...meta); + console.warn('[WARN]', message, ...meta); + } + + log(message: string, ...meta: any[]): void { + // winston.info(message, ...meta); + console.log('[INFO]', message, ...meta); + } +} + +/** + * App with custom logger + */ +function createAppWithCustomLogger() { + const app = express(); + + app.use(express.json()); + app.use('/api/users', usersRouter); + + // Error middleware with custom logger + app.use(createErrorMiddleware({ + logger: new WinstonLogger(), + includeStackTrace: process.env.NODE_ENV !== 'production', + })); + + return app; +} + +// ======================================== +// Users Router Example +// ======================================== + +interface User { + id: string; + email: string; + name: string; +} + +// Mock database +const users: User[] = [ + { id: '1', email: 'user1@example.com', name: 'User One' }, + { id: '2', email: 'user2@example.com', name: 'User Two' }, +]; + +const usersRouter = Router(); + +/** + * GET /api/users/:id + * + * Demonstrates NotFoundError handling + */ +usersRouter.get('/:id', (req: Request, res: Response, next: NextFunction) => { + try { + const user = users.find(u => u.id === req.params.id); + + if (!user) { + throw new NotFoundError('User not found', { userId: req.params.id }); + } + + res.json(user); + } catch (error) { + next(error); // Pass to error middleware + } +}); + +/** + * POST /api/users + * + * Demonstrates ValidationError handling + */ +usersRouter.post('/', (req: Request, res: Response, next: NextFunction) => { + try { + const { email, name } = req.body; + + // Validation + const errors: any[] = []; + + if (!email || !email.includes('@')) { + errors.push({ field: 'email', message: 'Valid email is required' }); + } + + if (!name || name.length < 2) { + errors.push({ field: 'name', message: 'Name must be at least 2 characters' }); + } + + if (errors.length > 0) { + throw new ValidationError('Validation failed', { errors }); + } + + // Check for duplicate email + const existing = users.find(u => u.email === email); + if (existing) { + throw new BadRequestError('Email already exists', { + email, + existingUserId: existing.id, + }); + } + + // Create user + const user: User = { + id: String(users.length + 1), + email, + name, + }; + + users.push(user); + + res.status(201).json(user); + } catch (error) { + next(error); + } +}); + +/** + * Async/await route handler with error handling + */ +usersRouter.get( + '/:id/profile', + asyncHandler(async (req: Request, res: Response) => { + const user = await findUserById(req.params.id); + const profile = await getUserProfile(user.id); + + res.json(profile); + }) +); + +// ======================================== +// Async Handler Wrapper +// ======================================== + +/** + * Wraps async route handlers to automatically catch errors + * + * Usage: app.get('/route', asyncHandler(async (req, res) => { ... })) + */ +function asyncHandler( + fn: (req: Request, res: Response, next: NextFunction) => Promise +) { + return (req: Request, res: Response, next: NextFunction) => { + Promise.resolve(fn(req, res, next)).catch(next); + }; +} + +// ======================================== +// Products Router Example +// ======================================== + +const productsRouter = Router(); + +/** + * Protected route example + */ +productsRouter.get( + '/', + authMiddleware, // Authentication middleware + asyncHandler(async (req: Request, res: Response) => { + // This route is protected and will throw UnauthorizedError + // if authentication fails + const products = await getProducts(); + res.json(products); + }) +); + +/** + * Authentication middleware example + */ +function authMiddleware(req: Request, res: Response, next: NextFunction) { + const token = req.headers.authorization?.replace('Bearer ', ''); + + if (!token) { + throw new UnauthorizedError('Authentication token required'); + } + + // Validate token... + if (token !== 'valid-token') { + throw new UnauthorizedError('Invalid or expired token', { + providedToken: token.substring(0, 10) + '...', + }); + } + + // Attach user to request + (req as any).user = { id: '1', email: 'user@example.com' }; + next(); +} + +// ======================================== +// Service Layer Example +// ======================================== + +/** + * Service layer with error handling + */ +class UserService { + async findById(id: string): Promise { + const user = users.find(u => u.id === id); + + if (!user) { + throw new NotFoundError('User not found', { userId: id }); + } + + return user; + } + + async create(email: string, name: string): Promise { + // Validation + if (!email || !email.includes('@')) { + throw new ValidationError('Invalid email address', { + field: 'email', + value: email, + }); + } + + // Business logic validation + const existing = users.find(u => u.email === email); + if (existing) { + throw new BadRequestError('Email already exists', { + email, + existingUserId: existing.id, + }); + } + + const user: User = { + id: String(users.length + 1), + email, + name, + }; + + users.push(user); + return user; + } +} + +// ======================================== +// Custom Domain Errors +// ======================================== + +/** + * Create custom errors for your domain + */ +class InsufficientBalanceError extends BaseError { + readonly statusCode = 400; + readonly error = 'Insufficient Balance'; + + constructor(required: number, available: number) { + super('Insufficient balance for this operation', { + required, + available, + deficit: required - available, + }); + } +} + +class PaymentService { + async processPayment(userId: string, amount: number): Promise { + const balance = await this.getBalance(userId); + + if (balance < amount) { + throw new InsufficientBalanceError(amount, balance); + } + + // Process payment... + } + + private async getBalance(userId: string): Promise { + return 100; // Mock + } +} + +// ======================================== +// Error Response Examples +// ======================================== + +/** + * Example error responses generated by the system: + * + * 404 Not Found: + * GET /api/users/999 + * { + * "statusCode": 404, + * "error": "Not Found", + * "message": "User not found", + * "details": { "userId": "999" }, + * "timestamp": "2025-12-12T10:30:00.000Z", + * "path": "/api/users/999", + * "requestId": "550e8400-e29b-41d4-a716-446655440000" + * } + * + * 422 Validation Error: + * POST /api/users { "email": "invalid", "name": "A" } + * { + * "statusCode": 422, + * "error": "Validation Error", + * "message": "Validation failed", + * "details": { + * "errors": [ + * { "field": "email", "message": "Valid email is required" }, + * { "field": "name", "message": "Name must be at least 2 characters" } + * ] + * }, + * "timestamp": "2025-12-12T10:30:00.000Z", + * "path": "/api/users", + * "requestId": "550e8400-e29b-41d4-a716-446655440001" + * } + * + * 401 Unauthorized: + * GET /api/products (without token) + * { + * "statusCode": 401, + * "error": "Unauthorized", + * "message": "Authentication token required", + * "timestamp": "2025-12-12T10:30:00.000Z", + * "path": "/api/products", + * "requestId": "550e8400-e29b-41d4-a716-446655440002" + * } + * + * 400 Bad Request: + * POST /api/users { "email": "existing@example.com", "name": "Test" } + * { + * "statusCode": 400, + * "error": "Bad Request", + * "message": "Email already exists", + * "details": { + * "email": "existing@example.com", + * "existingUserId": "1" + * }, + * "timestamp": "2025-12-12T10:30:00.000Z", + * "path": "/api/users", + * "requestId": "550e8400-e29b-41d4-a716-446655440003" + * } + */ + +// ======================================== +// Helper Functions (Mock) +// ======================================== + +async function findUserById(id: string): Promise { + const user = users.find(u => u.id === id); + if (!user) { + throw new NotFoundError('User not found', { userId: id }); + } + return user; +} + +async function getUserProfile(userId: string): Promise { + return { userId, bio: 'User bio', avatar: 'avatar.jpg' }; +} + +async function getProducts(): Promise { + return [ + { id: '1', name: 'Product 1', price: 100 }, + { id: '2', name: 'Product 2', price: 200 }, + ]; +} + +// ======================================== +// Start Server +// ======================================== + +if (require.main === module) { + const app = createApp(); + const PORT = process.env.PORT || 3000; + + app.listen(PORT, () => { + console.log(`Server running on port ${PORT}`); + }); +} + +export { createApp, createAppWithCustomLogger, asyncHandler }; diff --git a/apps/shared-libs/core/errors/http-errors.ts b/apps/shared-libs/core/errors/http-errors.ts new file mode 100644 index 0000000..7da3baf --- /dev/null +++ b/apps/shared-libs/core/errors/http-errors.ts @@ -0,0 +1,148 @@ +/** + * HTTP Error Classes + * + * Specific error classes for common HTTP status codes. + * All classes extend BaseError for consistent error handling. + * + * @module @erp-suite/core/errors + */ + +import { BaseError } from './base-error'; + +/** + * 400 Bad Request Error + * + * Used when the request cannot be processed due to client error + * + * @example + * ```typescript + * throw new BadRequestError('Invalid input', { field: 'email' }); + * ``` + */ +export class BadRequestError extends BaseError { + readonly statusCode = 400; + readonly error = 'Bad Request'; + + constructor(message: string = 'Bad request', details?: Record) { + super(message, details); + } +} + +/** + * 401 Unauthorized Error + * + * Used when authentication is required but not provided or invalid + * + * @example + * ```typescript + * throw new UnauthorizedError('Invalid credentials'); + * ``` + */ +export class UnauthorizedError extends BaseError { + readonly statusCode = 401; + readonly error = 'Unauthorized'; + + constructor(message: string = 'Unauthorized', details?: Record) { + super(message, details); + } +} + +/** + * 403 Forbidden Error + * + * Used when the user is authenticated but doesn't have permission + * + * @example + * ```typescript + * throw new ForbiddenError('Insufficient permissions'); + * ``` + */ +export class ForbiddenError extends BaseError { + readonly statusCode = 403; + readonly error = 'Forbidden'; + + constructor(message: string = 'Forbidden', details?: Record) { + super(message, details); + } +} + +/** + * 404 Not Found Error + * + * Used when the requested resource doesn't exist + * + * @example + * ```typescript + * throw new NotFoundError('User not found', { userId: '123' }); + * ``` + */ +export class NotFoundError extends BaseError { + readonly statusCode = 404; + readonly error = 'Not Found'; + + constructor(message: string = 'Resource not found', details?: Record) { + super(message, details); + } +} + +/** + * 409 Conflict Error + * + * Used when the request conflicts with the current state + * + * @example + * ```typescript + * throw new ConflictError('Email already exists', { email: 'user@example.com' }); + * ``` + */ +export class ConflictError extends BaseError { + readonly statusCode = 409; + readonly error = 'Conflict'; + + constructor(message: string = 'Resource conflict', details?: Record) { + super(message, details); + } +} + +/** + * 422 Validation Error + * + * Used when the request is well-formed but contains semantic errors + * + * @example + * ```typescript + * throw new ValidationError('Validation failed', { + * errors: [ + * { field: 'email', message: 'Invalid email format' }, + * { field: 'age', message: 'Must be at least 18' } + * ] + * }); + * ``` + */ +export class ValidationError extends BaseError { + readonly statusCode = 422; + readonly error = 'Validation Error'; + + constructor(message: string = 'Validation failed', details?: Record) { + super(message, details); + } +} + +/** + * 500 Internal Server Error + * + * Used for unexpected server errors + * + * @example + * ```typescript + * throw new InternalServerError('Database connection failed'); + * ``` + */ +export class InternalServerError extends BaseError { + readonly statusCode = 500; + readonly error = 'Internal Server Error'; + + constructor(message: string = 'Internal server error', details?: Record) { + super(message, details); + } +} diff --git a/apps/shared-libs/core/errors/index.ts b/apps/shared-libs/core/errors/index.ts new file mode 100644 index 0000000..f54a89d --- /dev/null +++ b/apps/shared-libs/core/errors/index.ts @@ -0,0 +1,44 @@ +/** + * Error Handling Module + * + * Standardized error handling for all ERP-Suite backends. + * Provides base error classes, HTTP-specific errors, and + * middleware/filters for NestJS and Express. + * + * @module @erp-suite/core/errors + * + * @example + * ```typescript + * // Using in NestJS + * import { GlobalExceptionFilter, NotFoundError } from '@erp-suite/core'; + * + * // Using in Express + * import { createErrorMiddleware, BadRequestError } from '@erp-suite/core'; + * ``` + */ + +// Base error types +export { BaseError, ErrorResponse } from './base-error'; + +// HTTP error classes +export { + BadRequestError, + UnauthorizedError, + ForbiddenError, + NotFoundError, + ConflictError, + ValidationError, + InternalServerError, +} from './http-errors'; + +// NestJS exception filter +export { GlobalExceptionFilter } from './error-filter'; + +// Express middleware +export { + createErrorMiddleware, + errorMiddleware, + notFoundMiddleware, + ErrorLogger, + ErrorMiddlewareOptions, +} from './error-middleware'; diff --git a/apps/shared-libs/core/errors/nestjs-integration.example.ts b/apps/shared-libs/core/errors/nestjs-integration.example.ts new file mode 100644 index 0000000..d9c6952 --- /dev/null +++ b/apps/shared-libs/core/errors/nestjs-integration.example.ts @@ -0,0 +1,272 @@ +/** + * NestJS Integration Example + * + * This file demonstrates how to integrate the error handling system + * into a NestJS application. + * + * @example Integration Steps: + * 1. Install the global exception filter + * 2. Use custom error classes in your services/controllers + * 3. Configure request ID generation (optional) + */ + +import { NestFactory } from '@nestjs/core'; +import { Module, Controller, Get, Injectable, Param } from '@nestjs/common'; +import { APP_FILTER } from '@nestjs/core'; +import { + GlobalExceptionFilter, + NotFoundError, + ValidationError, + UnauthorizedError, + BadRequestError, +} from '@erp-suite/core'; + +// ======================================== +// Option 1: Global Filter in main.ts +// ======================================== + +/** + * Bootstrap function with global exception filter + */ +async function bootstrap() { + const app = await NestFactory.create(AppModule); + + // Register global exception filter + app.useGlobalFilters(new GlobalExceptionFilter()); + + // Enable CORS, validation, etc. + app.enableCors(); + + await app.listen(3000); +} + +// ======================================== +// Option 2: Provider-based Registration +// ======================================== + +/** + * App module with provider-based filter registration + * + * This approach allows dependency injection into the filter + */ +@Module({ + imports: [], + controllers: [UsersController], + providers: [ + UsersService, + // Register filter as a provider + { + provide: APP_FILTER, + useClass: GlobalExceptionFilter, + }, + ], +}) +export class AppModule {} + +// ======================================== +// Usage in Services +// ======================================== + +interface User { + id: string; + email: string; + name: string; +} + +@Injectable() +export class UsersService { + private users: User[] = [ + { id: '1', email: 'user1@example.com', name: 'User One' }, + { id: '2', email: 'user2@example.com', name: 'User Two' }, + ]; + + /** + * Find user by ID - throws NotFoundError if not found + */ + async findById(id: string): Promise { + const user = this.users.find(u => u.id === id); + + if (!user) { + throw new NotFoundError('User not found', { userId: id }); + } + + return user; + } + + /** + * Create user - throws ValidationError on invalid data + */ + async create(email: string, name: string): Promise { + // Validate email + if (!email || !email.includes('@')) { + throw new ValidationError('Invalid email address', { + field: 'email', + value: email, + }); + } + + // Check for duplicate email + const existing = this.users.find(u => u.email === email); + if (existing) { + throw new BadRequestError('Email already exists', { + email, + existingUserId: existing.id, + }); + } + + const user: User = { + id: String(this.users.length + 1), + email, + name, + }; + + this.users.push(user); + return user; + } + + /** + * Verify user access - throws UnauthorizedError + */ + async verifyAccess(userId: string, token?: string): Promise { + if (!token) { + throw new UnauthorizedError('Access token required'); + } + + // Token validation logic... + if (token !== 'valid-token') { + throw new UnauthorizedError('Invalid or expired token', { + userId, + }); + } + } +} + +// ======================================== +// Usage in Controllers +// ======================================== + +@Controller('users') +export class UsersController { + constructor(private readonly usersService: UsersService) {} + + /** + * GET /users/:id + * + * Returns 200 with user data or 404 if not found + */ + @Get(':id') + async getUser(@Param('id') id: string): Promise { + // Service throws NotFoundError which is automatically + // caught by GlobalExceptionFilter and converted to proper response + return this.usersService.findById(id); + } + + /** + * Example error responses: + * + * Success (200): + * { + * "id": "1", + * "email": "user1@example.com", + * "name": "User One" + * } + * + * Not Found (404): + * { + * "statusCode": 404, + * "error": "Not Found", + * "message": "User not found", + * "details": { "userId": "999" }, + * "timestamp": "2025-12-12T10:30:00.000Z", + * "path": "/users/999", + * "requestId": "req-123-456" + * } + */ +} + +// ======================================== +// Request ID Middleware (Optional) +// ======================================== + +import { Injectable, NestMiddleware } from '@nestjs/core'; +import { Request, Response, NextFunction } from 'express'; +import { randomUUID } from 'crypto'; + +/** + * Middleware to generate request IDs + * + * Add this to your middleware chain to enable request tracking + */ +@Injectable() +export class RequestIdMiddleware implements NestMiddleware { + use(req: Request, res: Response, next: NextFunction) { + // Use existing request ID or generate new one + const requestId = + (req.headers['x-request-id'] as string) || + (req.headers['x-correlation-id'] as string) || + randomUUID(); + + // Set in request headers for downstream access + req.headers['x-request-id'] = requestId; + + // Include in response headers + res.setHeader('X-Request-ID', requestId); + + next(); + } +} + +// Register in AppModule +import { MiddlewareConsumer, NestModule } from '@nestjs/common'; + +@Module({ + // ... module configuration +}) +export class AppModuleWithRequestId implements NestModule { + configure(consumer: MiddlewareConsumer) { + consumer + .apply(RequestIdMiddleware) + .forRoutes('*'); // Apply to all routes + } +} + +// ======================================== +// Custom Error Examples +// ======================================== + +/** + * You can also create custom domain-specific errors + */ +import { BaseError } from '@erp-suite/core'; + +export class InsufficientBalanceError extends BaseError { + readonly statusCode = 400; + readonly error = 'Insufficient Balance'; + + constructor(required: number, available: number) { + super('Insufficient balance for this operation', { + required, + available, + deficit: required - available, + }); + } +} + +// Usage in service +@Injectable() +export class PaymentService { + async processPayment(userId: string, amount: number): Promise { + const balance = await this.getBalance(userId); + + if (balance < amount) { + throw new InsufficientBalanceError(amount, balance); + } + + // Process payment... + } + + private async getBalance(userId: string): Promise { + // Mock implementation + return 100; + } +} diff --git a/apps/shared-libs/core/examples/user.repository.example.ts b/apps/shared-libs/core/examples/user.repository.example.ts new file mode 100644 index 0000000..e18bfd3 --- /dev/null +++ b/apps/shared-libs/core/examples/user.repository.example.ts @@ -0,0 +1,371 @@ +/** + * Example: User Repository Implementation + * + * This example demonstrates how to implement IUserRepository + * using TypeORM as the underlying data access layer. + * + * @module @erp-suite/core/examples + */ + +import { Injectable } from '@nestjs/common'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository } from 'typeorm'; +import { + User, + IUserRepository, + ServiceContext, + PaginatedResult, + PaginationOptions, + QueryOptions, +} from '@erp-suite/core'; + +/** + * User repository implementation + * + * Implements IUserRepository interface with TypeORM + * + * @example + * ```typescript + * // In your module + * @Module({ + * imports: [TypeOrmModule.forFeature([User])], + * providers: [UserRepository], + * exports: [UserRepository], + * }) + * export class UserModule {} + * + * // In your service + * const factory = RepositoryFactory.getInstance(); + * const userRepo = factory.getRequired('UserRepository'); + * const user = await userRepo.findByEmail(ctx, 'user@example.com'); + * ``` + */ +@Injectable() +export class UserRepository implements IUserRepository { + constructor( + @InjectRepository(User) + private readonly ormRepo: Repository, + ) {} + + // ============================================================================ + // Core CRUD Operations (from IRepository) + // ============================================================================ + + async findById( + ctx: ServiceContext, + id: string, + options?: QueryOptions, + ): Promise { + return this.ormRepo.findOne({ + where: { id, tenantId: ctx.tenantId }, + relations: options?.relations, + select: options?.select as any, + }); + } + + async findOne( + ctx: ServiceContext, + criteria: Partial, + options?: QueryOptions, + ): Promise { + return this.ormRepo.findOne({ + where: { ...criteria, tenantId: ctx.tenantId }, + relations: options?.relations, + select: options?.select as any, + }); + } + + async findAll( + ctx: ServiceContext, + filters?: PaginationOptions & Partial, + options?: QueryOptions, + ): Promise> { + const page = filters?.page || 1; + const pageSize = filters?.pageSize || 20; + + // Extract pagination params + const { page: _, pageSize: __, ...criteria } = filters || {}; + + const [data, total] = await this.ormRepo.findAndCount({ + where: { ...criteria, tenantId: ctx.tenantId }, + relations: options?.relations, + select: options?.select as any, + skip: (page - 1) * pageSize, + take: pageSize, + order: { createdAt: 'DESC' }, + }); + + return { + data, + meta: { + page, + pageSize, + totalRecords: total, + totalPages: Math.ceil(total / pageSize), + }, + }; + } + + async findMany( + ctx: ServiceContext, + criteria: Partial, + options?: QueryOptions, + ): Promise { + return this.ormRepo.find({ + where: { ...criteria, tenantId: ctx.tenantId }, + relations: options?.relations, + select: options?.select as any, + }); + } + + async create(ctx: ServiceContext, data: Partial): Promise { + const user = this.ormRepo.create({ + ...data, + tenantId: ctx.tenantId, + }); + return this.ormRepo.save(user); + } + + async createMany(ctx: ServiceContext, data: Partial[]): Promise { + const users = data.map(item => + this.ormRepo.create({ + ...item, + tenantId: ctx.tenantId, + }), + ); + return this.ormRepo.save(users); + } + + async update( + ctx: ServiceContext, + id: string, + data: Partial, + ): Promise { + await this.ormRepo.update( + { id, tenantId: ctx.tenantId }, + data, + ); + return this.findById(ctx, id); + } + + async updateMany( + ctx: ServiceContext, + criteria: Partial, + data: Partial, + ): Promise { + const result = await this.ormRepo.update( + { ...criteria, tenantId: ctx.tenantId }, + data, + ); + return result.affected || 0; + } + + async softDelete(ctx: ServiceContext, id: string): Promise { + const result = await this.ormRepo.softDelete({ + id, + tenantId: ctx.tenantId, + }); + return (result.affected || 0) > 0; + } + + async hardDelete(ctx: ServiceContext, id: string): Promise { + const result = await this.ormRepo.delete({ + id, + tenantId: ctx.tenantId, + }); + return (result.affected || 0) > 0; + } + + async deleteMany(ctx: ServiceContext, criteria: Partial): Promise { + const result = await this.ormRepo.delete({ + ...criteria, + tenantId: ctx.tenantId, + }); + return result.affected || 0; + } + + async count( + ctx: ServiceContext, + criteria?: Partial, + options?: QueryOptions, + ): Promise { + return this.ormRepo.count({ + where: { ...criteria, tenantId: ctx.tenantId }, + relations: options?.relations, + }); + } + + async exists( + ctx: ServiceContext, + id: string, + options?: QueryOptions, + ): Promise { + const count = await this.ormRepo.count({ + where: { id, tenantId: ctx.tenantId }, + relations: options?.relations, + }); + return count > 0; + } + + async query( + ctx: ServiceContext, + sql: string, + params: unknown[], + ): Promise { + // Add tenant filtering to raw SQL + const tenantParam = ctx.tenantId; + return this.ormRepo.query(sql, [...params, tenantParam]); + } + + async queryOne( + ctx: ServiceContext, + sql: string, + params: unknown[], + ): Promise { + const results = await this.query(ctx, sql, params); + return results[0] || null; + } + + // ============================================================================ + // User-Specific Operations (from IUserRepository) + // ============================================================================ + + async findByEmail( + ctx: ServiceContext, + email: string, + ): Promise { + return this.ormRepo.findOne({ + where: { + email, + tenantId: ctx.tenantId, + }, + }); + } + + async findByTenantId( + ctx: ServiceContext, + tenantId: string, + ): Promise { + // Note: This bypasses ctx.tenantId for admin use cases + return this.ormRepo.find({ + where: { tenantId }, + order: { createdAt: 'DESC' }, + }); + } + + async findActiveUsers( + ctx: ServiceContext, + filters?: PaginationOptions, + ): Promise> { + const page = filters?.page || 1; + const pageSize = filters?.pageSize || 20; + + const [data, total] = await this.ormRepo.findAndCount({ + where: { + tenantId: ctx.tenantId, + status: 'active', + }, + skip: (page - 1) * pageSize, + take: pageSize, + order: { fullName: 'ASC' }, + }); + + return { + data, + meta: { + page, + pageSize, + totalRecords: total, + totalPages: Math.ceil(total / pageSize), + }, + }; + } + + async updateLastLogin(ctx: ServiceContext, userId: string): Promise { + await this.ormRepo.update( + { id: userId, tenantId: ctx.tenantId }, + { lastLoginAt: new Date() }, + ); + } + + async updatePasswordHash( + ctx: ServiceContext, + userId: string, + passwordHash: string, + ): Promise { + await this.ormRepo.update( + { id: userId, tenantId: ctx.tenantId }, + { passwordHash }, + ); + } + + // ============================================================================ + // Additional Helper Methods (Not in interface, but useful) + // ============================================================================ + + /** + * Find users by status + */ + async findByStatus( + ctx: ServiceContext, + status: 'active' | 'inactive' | 'suspended', + filters?: PaginationOptions, + ): Promise> { + const page = filters?.page || 1; + const pageSize = filters?.pageSize || 20; + + const [data, total] = await this.ormRepo.findAndCount({ + where: { + tenantId: ctx.tenantId, + status, + }, + skip: (page - 1) * pageSize, + take: pageSize, + order: { createdAt: 'DESC' }, + }); + + return { + data, + meta: { + page, + pageSize, + totalRecords: total, + totalPages: Math.ceil(total / pageSize), + }, + }; + } + + /** + * Search users by name or email + */ + async search( + ctx: ServiceContext, + query: string, + filters?: PaginationOptions, + ): Promise> { + const page = filters?.page || 1; + const pageSize = filters?.pageSize || 20; + + const queryBuilder = this.ormRepo.createQueryBuilder('user'); + queryBuilder.where('user.tenantId = :tenantId', { tenantId: ctx.tenantId }); + queryBuilder.andWhere( + '(user.fullName ILIKE :query OR user.email ILIKE :query)', + { query: `%${query}%` }, + ); + queryBuilder.orderBy('user.fullName', 'ASC'); + queryBuilder.skip((page - 1) * pageSize); + queryBuilder.take(pageSize); + + const [data, total] = await queryBuilder.getManyAndCount(); + + return { + data, + meta: { + page, + pageSize, + totalRecords: total, + totalPages: Math.ceil(total / pageSize), + }, + }; + } +} diff --git a/apps/shared-libs/core/factories/repository.factory.ts b/apps/shared-libs/core/factories/repository.factory.ts new file mode 100644 index 0000000..c42a18b --- /dev/null +++ b/apps/shared-libs/core/factories/repository.factory.ts @@ -0,0 +1,343 @@ +/** + * Repository Factory - Dependency Injection pattern for repositories + * + * @module @erp-suite/core/factories + * + * @example + * ```typescript + * import { RepositoryFactory, IUserRepository } from '@erp-suite/core'; + * + * // Register repositories at app startup + * const factory = RepositoryFactory.getInstance(); + * factory.register('UserRepository', new UserRepositoryImpl()); + * + * // Get repository in services + * const userRepo = factory.getRequired('UserRepository'); + * const user = await userRepo.findByEmail(ctx, 'user@example.com'); + * ``` + */ + +/** + * Repository not found error + */ +export class RepositoryNotFoundError extends Error { + constructor(repositoryName: string) { + super(`Repository '${repositoryName}' not found in factory registry`); + this.name = 'RepositoryNotFoundError'; + } +} + +/** + * Repository already registered error + */ +export class RepositoryAlreadyRegisteredError extends Error { + constructor(repositoryName: string) { + super( + `Repository '${repositoryName}' is already registered. Use 'replace' to override.`, + ); + this.name = 'RepositoryAlreadyRegisteredError'; + } +} + +/** + * Repository factory for managing repository instances + * + * Implements Singleton and Registry patterns for centralized + * repository management and dependency injection. + * + * @example + * ```typescript + * // Initialize factory + * const factory = RepositoryFactory.getInstance(); + * + * // Register repositories + * factory.register('UserRepository', userRepository); + * factory.register('TenantRepository', tenantRepository); + * + * // Retrieve repositories + * const userRepo = factory.get('UserRepository'); + * const tenantRepo = factory.getRequired('TenantRepository'); + * + * // Check registration + * if (factory.has('AuditRepository')) { + * const auditRepo = factory.get('AuditRepository'); + * } + * ``` + */ +export class RepositoryFactory { + private static instance: RepositoryFactory; + private repositories: Map; + + /** + * Private constructor for Singleton pattern + */ + private constructor() { + this.repositories = new Map(); + } + + /** + * Get singleton instance of RepositoryFactory + * + * @returns The singleton instance + * + * @example + * ```typescript + * const factory = RepositoryFactory.getInstance(); + * ``` + */ + public static getInstance(): RepositoryFactory { + if (!RepositoryFactory.instance) { + RepositoryFactory.instance = new RepositoryFactory(); + } + return RepositoryFactory.instance; + } + + /** + * Register a repository instance + * + * @param name - Unique repository identifier + * @param repository - Repository instance + * @throws {RepositoryAlreadyRegisteredError} If repository name already exists + * + * @example + * ```typescript + * factory.register('UserRepository', new UserRepository(dataSource)); + * factory.register('TenantRepository', new TenantRepository(dataSource)); + * ``` + */ + public register(name: string, repository: T): void { + if (this.repositories.has(name)) { + throw new RepositoryAlreadyRegisteredError(name); + } + this.repositories.set(name, repository); + } + + /** + * Register or replace an existing repository + * + * @param name - Unique repository identifier + * @param repository - Repository instance + * + * @example + * ```typescript + * // Override existing repository for testing + * factory.replace('UserRepository', mockUserRepository); + * ``` + */ + public replace(name: string, repository: T): void { + this.repositories.set(name, repository); + } + + /** + * Get a repository instance (returns undefined if not found) + * + * @param name - Repository identifier + * @returns Repository instance or undefined + * + * @example + * ```typescript + * const userRepo = factory.get('UserRepository'); + * if (userRepo) { + * const user = await userRepo.findById(ctx, userId); + * } + * ``` + */ + public get(name: string): T | undefined { + return this.repositories.get(name) as T | undefined; + } + + /** + * Get a required repository instance + * + * @param name - Repository identifier + * @returns Repository instance + * @throws {RepositoryNotFoundError} If repository not found + * + * @example + * ```typescript + * const userRepo = factory.getRequired('UserRepository'); + * const user = await userRepo.findById(ctx, userId); + * ``` + */ + public getRequired(name: string): T { + const repository = this.repositories.get(name) as T | undefined; + if (!repository) { + throw new RepositoryNotFoundError(name); + } + return repository; + } + + /** + * Check if a repository is registered + * + * @param name - Repository identifier + * @returns True if repository exists + * + * @example + * ```typescript + * if (factory.has('AuditRepository')) { + * const auditRepo = factory.get('AuditRepository'); + * } + * ``` + */ + public has(name: string): boolean { + return this.repositories.has(name); + } + + /** + * Unregister a repository + * + * @param name - Repository identifier + * @returns True if repository was removed + * + * @example + * ```typescript + * factory.unregister('TempRepository'); + * ``` + */ + public unregister(name: string): boolean { + return this.repositories.delete(name); + } + + /** + * Clear all registered repositories + * + * Useful for testing scenarios + * + * @example + * ```typescript + * afterEach(() => { + * factory.clear(); + * }); + * ``` + */ + public clear(): void { + this.repositories.clear(); + } + + /** + * Get all registered repository names + * + * @returns Array of repository names + * + * @example + * ```typescript + * const names = factory.getRegisteredNames(); + * console.log('Registered repositories:', names); + * ``` + */ + public getRegisteredNames(): string[] { + return Array.from(this.repositories.keys()); + } + + /** + * Get count of registered repositories + * + * @returns Number of registered repositories + * + * @example + * ```typescript + * console.log(`Total repositories: ${factory.count()}`); + * ``` + */ + public count(): number { + return this.repositories.size; + } + + /** + * Register multiple repositories at once + * + * @param repositories - Map of repository name to instance + * + * @example + * ```typescript + * factory.registerBatch({ + * UserRepository: new UserRepository(dataSource), + * TenantRepository: new TenantRepository(dataSource), + * AuditRepository: new AuditRepository(dataSource), + * }); + * ``` + */ + public registerBatch(repositories: Record): void { + Object.entries(repositories).forEach(([name, repository]) => { + this.register(name, repository); + }); + } + + /** + * Clone factory instance with same repositories + * + * Useful for creating isolated scopes in testing + * + * @returns New factory instance with cloned registry + * + * @example + * ```typescript + * const testFactory = factory.clone(); + * testFactory.replace('UserRepository', mockUserRepository); + * ``` + */ + public clone(): RepositoryFactory { + const cloned = new RepositoryFactory(); + this.repositories.forEach((repository, name) => { + cloned.register(name, repository); + }); + return cloned; + } +} + +/** + * Helper function to create and configure a repository factory + * + * @param repositories - Optional initial repositories + * @returns Configured RepositoryFactory instance + * + * @example + * ```typescript + * const factory = createRepositoryFactory({ + * UserRepository: new UserRepository(dataSource), + * TenantRepository: new TenantRepository(dataSource), + * }); + * ``` + */ +export function createRepositoryFactory( + repositories?: Record, +): RepositoryFactory { + const factory = RepositoryFactory.getInstance(); + + if (repositories) { + factory.registerBatch(repositories); + } + + return factory; +} + +/** + * Decorator for automatic repository injection + * + * @param repositoryName - Name of repository to inject + * @returns Property decorator + * + * @example + * ```typescript + * class UserService { + * @InjectRepository('UserRepository') + * private userRepository: IUserRepository; + * + * async getUser(ctx: ServiceContext, id: string) { + * return this.userRepository.findById(ctx, id); + * } + * } + * ``` + */ +export function InjectRepository(repositoryName: string) { + return function (target: any, propertyKey: string) { + Object.defineProperty(target, propertyKey, { + get() { + return RepositoryFactory.getInstance().getRequired(repositoryName); + }, + enumerable: true, + configurable: true, + }); + }; +} diff --git a/apps/shared-libs/core/index.ts b/apps/shared-libs/core/index.ts new file mode 100644 index 0000000..433ff05 --- /dev/null +++ b/apps/shared-libs/core/index.ts @@ -0,0 +1,153 @@ +/** + * ERP-Suite Core Library + * + * Shared types, interfaces, and base classes for all ERP-Suite modules. + * + * @module @erp-suite/core + * + * @example + * ```typescript + * import { + * BaseTypeOrmService, + * ServiceContext, + * PaginatedResult, + * BaseEntity, + * createAuthMiddleware, + * } from '@erp-suite/core'; + * ``` + */ + +// Types +export { + PaginationOptions, + PaginationMeta, + PaginatedResult, + createPaginationMeta, +} from './types/pagination.types'; + +// Interfaces +export { + IBaseService, + ServiceContext, + QueryOptions, +} from './interfaces/base-service.interface'; + +export { + IRepository, + IReadOnlyRepository, + IWriteOnlyRepository, + IUserRepository, + ITenantRepository, + IAuditRepository, + IConfigRepository, + AuditLogEntry, + ConfigEntry, +} from './interfaces/repository.interface'; + +// Entities +export { BaseEntity } from './entities/base.entity'; +export { User } from './entities/user.entity'; +export { Tenant } from './entities/tenant.entity'; + +// Services +export { BaseTypeOrmService } from './services/base-typeorm.service'; + +// Auth Service (P0-014: Centralized) +export { + AuthService, + createAuthService, + LoginDto, + RegisterDto, + LoginResponse, + AuthTokens, + AuthUser, + JwtPayload, + AuthServiceConfig, + AuthUnauthorizedError, + AuthValidationError, + AuthNotFoundError, + splitFullName, + buildFullName, +} from './services/auth.service'; + +// Middleware +export { + createAuthMiddleware, + AuthGuard, + AuthRequest, + AuthMiddlewareConfig, +} from './middleware/auth.middleware'; + +export { + createTenantMiddleware, + TenantInterceptor, + TenantRequest, + TenantMiddlewareConfig, +} from './middleware/tenant.middleware'; + +// Factories +export { + RepositoryFactory, + createRepositoryFactory, + InjectRepository, + RepositoryNotFoundError, + RepositoryAlreadyRegisteredError, +} from './factories/repository.factory'; + +// Constants +export { + DB_SCHEMAS, + AUTH_TABLES, + ERP_TABLES, + INVENTORY_TABLES, + SALES_TABLES, + PURCHASE_TABLES, + ACCOUNTING_TABLES, + HR_TABLES, + CRM_TABLES, + COMMON_COLUMNS, + STATUS, + getFullTableName, +} from './constants/database.constants'; + +// Database RLS Policies +export { + applyTenantIsolationPolicy, + applyAdminBypassPolicy, + applyUserDataPolicy, + applyCompleteRlsPolicies, + applyCompletePoliciesForSchema, + batchApplyRlsPolicies, + enableRls, + disableRls, + isRlsEnabled, + listRlsPolicies, + dropRlsPolicy, + dropAllRlsPolicies, + getSchemaRlsStatus, + setRlsContext, + clearRlsContext, + withRlsContext, + RlsPolicyType, + RlsPolicyOptions, + RlsPolicyStatus, +} from './database/policies/apply-rls'; + +// Error Handling +export { + BaseError, + ErrorResponse, + BadRequestError, + UnauthorizedError, + ForbiddenError, + NotFoundError, + ConflictError, + ValidationError, + InternalServerError, + GlobalExceptionFilter, + createErrorMiddleware, + errorMiddleware, + notFoundMiddleware, + ErrorLogger, + ErrorMiddlewareOptions, +} from './errors'; diff --git a/apps/shared-libs/core/interfaces/base-service.interface.ts b/apps/shared-libs/core/interfaces/base-service.interface.ts new file mode 100644 index 0000000..4375a95 --- /dev/null +++ b/apps/shared-libs/core/interfaces/base-service.interface.ts @@ -0,0 +1,83 @@ +/** + * Base Service Interface - Contract for all domain services + * + * @module @erp-suite/core/interfaces + */ + +import { PaginatedResult, PaginationOptions } from '../types/pagination.types'; + +/** + * Service context with tenant and user info + */ +export interface ServiceContext { + tenantId: string; + userId: string; +} + +/** + * Query options for service methods + */ +export interface QueryOptions { + includeDeleted?: boolean; +} + +/** + * Base service interface for CRUD operations + * + * @template T - Entity type + * @template CreateDto - DTO for create operations + * @template UpdateDto - DTO for update operations + */ +export interface IBaseService { + /** + * Find all records with pagination + */ + findAll( + ctx: ServiceContext, + filters?: PaginationOptions & Record, + options?: QueryOptions, + ): Promise>; + + /** + * Find record by ID + */ + findById( + ctx: ServiceContext, + id: string, + options?: QueryOptions, + ): Promise; + + /** + * Create new record + */ + create(ctx: ServiceContext, data: CreateDto): Promise; + + /** + * Update existing record + */ + update(ctx: ServiceContext, id: string, data: UpdateDto): Promise; + + /** + * Soft delete record + */ + softDelete(ctx: ServiceContext, id: string): Promise; + + /** + * Hard delete record + */ + hardDelete(ctx: ServiceContext, id: string): Promise; + + /** + * Count records + */ + count( + ctx: ServiceContext, + filters?: Record, + options?: QueryOptions, + ): Promise; + + /** + * Check if record exists + */ + exists(ctx: ServiceContext, id: string, options?: QueryOptions): Promise; +} diff --git a/apps/shared-libs/core/interfaces/repository.interface.ts b/apps/shared-libs/core/interfaces/repository.interface.ts new file mode 100644 index 0000000..a618209 --- /dev/null +++ b/apps/shared-libs/core/interfaces/repository.interface.ts @@ -0,0 +1,483 @@ +/** + * Repository Interface - Generic repository contract + * + * @module @erp-suite/core/interfaces + */ + +import { ServiceContext, QueryOptions } from './base-service.interface'; +import { PaginatedResult, PaginationOptions } from '../types/pagination.types'; + +/** + * Generic repository interface for data access + * + * This interface defines the contract for repository implementations, + * supporting both TypeORM and raw SQL approaches. + * + * @template T - Entity type + * + * @example + * ```typescript + * export class PartnerRepository implements IRepository { + * async findById(ctx: ServiceContext, id: string): Promise { + * // Implementation + * } + * } + * ``` + */ +export interface IRepository { + /** + * Find entity by ID + */ + findById( + ctx: ServiceContext, + id: string, + options?: QueryOptions, + ): Promise; + + /** + * Find one entity by criteria + */ + findOne( + ctx: ServiceContext, + criteria: Partial, + options?: QueryOptions, + ): Promise; + + /** + * Find all entities with pagination + */ + findAll( + ctx: ServiceContext, + filters?: PaginationOptions & Partial, + options?: QueryOptions, + ): Promise>; + + /** + * Find multiple entities by criteria + */ + findMany( + ctx: ServiceContext, + criteria: Partial, + options?: QueryOptions, + ): Promise; + + /** + * Create new entity + */ + create(ctx: ServiceContext, data: Partial): Promise; + + /** + * Create multiple entities + */ + createMany(ctx: ServiceContext, data: Partial[]): Promise; + + /** + * Update existing entity + */ + update(ctx: ServiceContext, id: string, data: Partial): Promise; + + /** + * Update multiple entities by criteria + */ + updateMany( + ctx: ServiceContext, + criteria: Partial, + data: Partial, + ): Promise; + + /** + * Soft delete entity + */ + softDelete(ctx: ServiceContext, id: string): Promise; + + /** + * Hard delete entity + */ + hardDelete(ctx: ServiceContext, id: string): Promise; + + /** + * Delete multiple entities by criteria + */ + deleteMany(ctx: ServiceContext, criteria: Partial): Promise; + + /** + * Count entities matching criteria + */ + count( + ctx: ServiceContext, + criteria?: Partial, + options?: QueryOptions, + ): Promise; + + /** + * Check if entity exists + */ + exists( + ctx: ServiceContext, + id: string, + options?: QueryOptions, + ): Promise; + + /** + * Execute raw SQL query + */ + query( + ctx: ServiceContext, + sql: string, + params: unknown[], + ): Promise; + + /** + * Execute raw SQL query and return first result + */ + queryOne( + ctx: ServiceContext, + sql: string, + params: unknown[], + ): Promise; +} + +/** + * Read-only repository interface + * + * For repositories that only need read operations (e.g., views, reports) + * + * @template T - Entity type + */ +export interface IReadOnlyRepository { + findById( + ctx: ServiceContext, + id: string, + options?: QueryOptions, + ): Promise; + + findOne( + ctx: ServiceContext, + criteria: Partial, + options?: QueryOptions, + ): Promise; + + findAll( + ctx: ServiceContext, + filters?: PaginationOptions & Partial, + options?: QueryOptions, + ): Promise>; + + findMany( + ctx: ServiceContext, + criteria: Partial, + options?: QueryOptions, + ): Promise; + + count( + ctx: ServiceContext, + criteria?: Partial, + options?: QueryOptions, + ): Promise; + + exists( + ctx: ServiceContext, + id: string, + options?: QueryOptions, + ): Promise; +} + +/** + * Write-only repository interface + * + * For repositories that only need write operations (e.g., event stores) + * + * @template T - Entity type + */ +export interface IWriteOnlyRepository { + create(ctx: ServiceContext, data: Partial): Promise; + + createMany(ctx: ServiceContext, data: Partial[]): Promise; + + update(ctx: ServiceContext, id: string, data: Partial): Promise; + + updateMany( + ctx: ServiceContext, + criteria: Partial, + data: Partial, + ): Promise; + + softDelete(ctx: ServiceContext, id: string): Promise; + + hardDelete(ctx: ServiceContext, id: string): Promise; + + deleteMany(ctx: ServiceContext, criteria: Partial): Promise; +} + +// ============================================================================ +// Domain-Specific Repository Interfaces +// ============================================================================ + +/** + * User repository interface + * + * Extends the base repository with user-specific operations + * + * @example + * ```typescript + * export class UserRepository implements IUserRepository { + * async findByEmail(ctx: ServiceContext, email: string): Promise { + * return this.findOne(ctx, { email }); + * } + * } + * ``` + */ +export interface IUserRepository extends IRepository { + /** + * Find user by email address + */ + findByEmail(ctx: ServiceContext, email: string): Promise; + + /** + * Find users by tenant ID + */ + findByTenantId(ctx: ServiceContext, tenantId: string): Promise; + + /** + * Find active users only + */ + findActiveUsers( + ctx: ServiceContext, + filters?: PaginationOptions, + ): Promise>; + + /** + * Update last login timestamp + */ + updateLastLogin(ctx: ServiceContext, userId: string): Promise; + + /** + * Update user password hash + */ + updatePasswordHash( + ctx: ServiceContext, + userId: string, + passwordHash: string, + ): Promise; +} + +/** + * Tenant repository interface + * + * Extends the base repository with tenant-specific operations + * + * @example + * ```typescript + * export class TenantRepository implements ITenantRepository { + * async findBySlug(ctx: ServiceContext, slug: string): Promise { + * return this.findOne(ctx, { slug }); + * } + * } + * ``` + */ +export interface ITenantRepository extends IRepository { + /** + * Find tenant by unique slug + */ + findBySlug(ctx: ServiceContext, slug: string): Promise; + + /** + * Find tenant by domain + */ + findByDomain(ctx: ServiceContext, domain: string): Promise; + + /** + * Find active tenants only + */ + findActiveTenants( + ctx: ServiceContext, + filters?: PaginationOptions, + ): Promise>; + + /** + * Update tenant settings + */ + updateSettings( + ctx: ServiceContext, + tenantId: string, + settings: Record, + ): Promise; +} + +/** + * Audit log entry type + */ +export interface AuditLogEntry { + id?: string; + tenantId: string; + userId: string; + action: string; + entityType: string; + entityId: string; + changes?: Record; + metadata?: Record; + ipAddress?: string; + userAgent?: string; + timestamp: Date; +} + +/** + * Audit repository interface + * + * Specialized repository for audit logging and compliance + * + * @example + * ```typescript + * export class AuditRepository implements IAuditRepository { + * async logAction(ctx: ServiceContext, entry: AuditLogEntry): Promise { + * await this.create(ctx, entry); + * } + * } + * ``` + */ +export interface IAuditRepository { + /** + * Log an audit entry + */ + logAction(ctx: ServiceContext, entry: AuditLogEntry): Promise; + + /** + * Find audit logs by entity + */ + findByEntity( + ctx: ServiceContext, + entityType: string, + entityId: string, + filters?: PaginationOptions, + ): Promise>; + + /** + * Find audit logs by user + */ + findByUser( + ctx: ServiceContext, + userId: string, + filters?: PaginationOptions, + ): Promise>; + + /** + * Find audit logs by tenant + */ + findByTenant( + ctx: ServiceContext, + tenantId: string, + filters?: PaginationOptions, + ): Promise>; + + /** + * Find audit logs by action type + */ + findByAction( + ctx: ServiceContext, + action: string, + filters?: PaginationOptions, + ): Promise>; + + /** + * Find audit logs within date range + */ + findByDateRange( + ctx: ServiceContext, + startDate: Date, + endDate: Date, + filters?: PaginationOptions, + ): Promise>; +} + +/** + * Configuration entry type + */ +export interface ConfigEntry { + id?: string; + tenantId?: string; + key: string; + value: unknown; + type: 'string' | 'number' | 'boolean' | 'json'; + scope: 'system' | 'tenant' | 'module'; + module?: string; + description?: string; + isEncrypted?: boolean; + updatedAt?: Date; +} + +/** + * Config repository interface + * + * Specialized repository for application configuration + * + * @example + * ```typescript + * export class ConfigRepository implements IConfigRepository { + * async getValue(ctx: ServiceContext, key: string): Promise { + * const entry = await this.findByKey(ctx, key); + * return entry ? (entry.value as T) : null; + * } + * } + * ``` + */ +export interface IConfigRepository { + /** + * Find configuration by key + */ + findByKey( + ctx: ServiceContext, + key: string, + scope?: 'system' | 'tenant' | 'module', + ): Promise; + + /** + * Get typed configuration value + */ + getValue( + ctx: ServiceContext, + key: string, + defaultValue?: T, + ): Promise; + + /** + * Set configuration value + */ + setValue(ctx: ServiceContext, key: string, value: T): Promise; + + /** + * Find all configurations by scope + */ + findByScope( + ctx: ServiceContext, + scope: 'system' | 'tenant' | 'module', + filters?: PaginationOptions, + ): Promise>; + + /** + * Find all configurations by module + */ + findByModule( + ctx: ServiceContext, + module: string, + filters?: PaginationOptions, + ): Promise>; + + /** + * Find all tenant-specific configurations + */ + findByTenant( + ctx: ServiceContext, + tenantId: string, + filters?: PaginationOptions, + ): Promise>; + + /** + * Delete configuration by key + */ + deleteByKey(ctx: ServiceContext, key: string): Promise; + + /** + * Bulk update configurations + */ + bulkUpdate(ctx: ServiceContext, configs: ConfigEntry[]): Promise; +} diff --git a/apps/shared-libs/core/middleware/auth.middleware.ts b/apps/shared-libs/core/middleware/auth.middleware.ts new file mode 100644 index 0000000..30dd2f4 --- /dev/null +++ b/apps/shared-libs/core/middleware/auth.middleware.ts @@ -0,0 +1,131 @@ +/** + * Auth Middleware - JWT verification for Express/NestJS + * + * @module @erp-suite/core/middleware + */ + +import { Request, Response, NextFunction } from 'express'; +import jwt from 'jsonwebtoken'; + +/** + * JWT payload structure + */ +export interface JwtPayload { + userId: string; + tenantId: string; + email: string; + roles: string[]; + iat?: number; + exp?: number; +} + +/** + * Extended Express Request with auth context + */ +export interface AuthRequest extends Request { + user?: JwtPayload; +} + +/** + * Auth middleware configuration + */ +export interface AuthMiddlewareConfig { + jwtSecret: string; + skipPaths?: string[]; +} + +/** + * Creates an auth middleware that verifies JWT tokens + * + * @param config - Middleware configuration + * @returns Express middleware function + * + * @example + * ```typescript + * import { createAuthMiddleware } from '@erp-suite/core/middleware'; + * + * const authMiddleware = createAuthMiddleware({ + * jwtSecret: process.env.JWT_SECRET, + * skipPaths: ['/health', '/login'], + * }); + * + * app.use(authMiddleware); + * ``` + */ +export function createAuthMiddleware(config: AuthMiddlewareConfig) { + return (req: AuthRequest, res: Response, next: NextFunction): void => { + // Skip authentication for certain paths + if (config.skipPaths?.some((path) => req.path.startsWith(path))) { + return next(); + } + + const authHeader = req.headers.authorization; + + if (!authHeader) { + res.status(401).json({ error: 'No authorization header' }); + return; + } + + const parts = authHeader.split(' '); + if (parts.length !== 2 || parts[0] !== 'Bearer') { + res.status(401).json({ error: 'Invalid authorization header format' }); + return; + } + + const token = parts[1]; + + try { + const payload = jwt.verify(token, config.jwtSecret) as JwtPayload; + req.user = payload; + next(); + } catch (error) { + if (error instanceof jwt.TokenExpiredError) { + res.status(401).json({ error: 'Token expired' }); + return; + } + res.status(401).json({ error: 'Invalid token' }); + } + }; +} + +/** + * NestJS Guard for JWT authentication + * + * @example + * ```typescript + * import { AuthGuard } from '@erp-suite/core/middleware'; + * + * @Controller('api') + * @UseGuards(AuthGuard) + * export class ApiController { + * // Protected routes + * } + * ``` + */ +export class AuthGuard { + constructor(private readonly jwtSecret: string) {} + + canActivate(context: any): boolean { + const request = context.switchToHttp().getRequest(); + const authHeader = request.headers.authorization; + + if (!authHeader) { + return false; + } + + const parts = authHeader.split(' '); + if (parts.length !== 2 || parts[0] !== 'Bearer') { + return false; + } + + const token = parts[1]; + + try { + const payload = jwt.verify(token, this.jwtSecret) as JwtPayload; + request.user = payload; + return true; + } catch { + return false; + } + } +} diff --git a/apps/shared-libs/core/middleware/tenant.middleware.ts b/apps/shared-libs/core/middleware/tenant.middleware.ts new file mode 100644 index 0000000..0e168ff --- /dev/null +++ b/apps/shared-libs/core/middleware/tenant.middleware.ts @@ -0,0 +1,114 @@ +/** + * Tenant Middleware - RLS context for multi-tenancy + * + * @module @erp-suite/core/middleware + */ + +import { Request, Response, NextFunction } from 'express'; +import { AuthRequest } from './auth.middleware'; + +/** + * Extended Express Request with tenant context + */ +export interface TenantRequest extends AuthRequest { + tenantId?: string; +} + +/** + * Database query function type + */ +export type QueryFn = (sql: string, params: unknown[]) => Promise; + +/** + * Tenant middleware configuration + */ +export interface TenantMiddlewareConfig { + query: QueryFn; + skipPaths?: string[]; +} + +/** + * Creates a tenant middleware that sets RLS context + * + * This middleware must run after auth middleware to access user.tenantId. + * It sets the PostgreSQL session variable for Row-Level Security (RLS). + * + * @param config - Middleware configuration + * @returns Express middleware function + * + * @example + * ```typescript + * import { createTenantMiddleware } from '@erp-suite/core/middleware'; + * + * const tenantMiddleware = createTenantMiddleware({ + * query: (sql, params) => pool.query(sql, params), + * skipPaths: ['/health'], + * }); + * + * app.use(authMiddleware); + * app.use(tenantMiddleware); + * ``` + */ +export function createTenantMiddleware(config: TenantMiddlewareConfig) { + return async ( + req: TenantRequest, + res: Response, + next: NextFunction, + ): Promise => { + // Skip tenant context for certain paths + if (config.skipPaths?.some((path) => req.path.startsWith(path))) { + return next(); + } + + // Extract tenant ID from authenticated user + const tenantId = req.user?.tenantId; + + if (!tenantId) { + res.status(401).json({ error: 'No tenant context available' }); + return; + } + + try { + // Set PostgreSQL session variable for RLS + await config.query('SET LOCAL app.current_tenant_id = $1', [tenantId]); + req.tenantId = tenantId; + next(); + } catch (error) { + console.error('Failed to set tenant context:', error); + res.status(500).json({ error: 'Failed to set tenant context' }); + } + }; +} + +/** + * NestJS Interceptor for tenant context + * + * @example + * ```typescript + * import { TenantInterceptor } from '@erp-suite/core/middleware'; + * + * @Controller('api') + * @UseInterceptors(TenantInterceptor) + * export class ApiController { + * // Tenant-isolated routes + * } + * ``` + */ +export class TenantInterceptor { + constructor(private readonly query: QueryFn) {} + + async intercept(context: any, next: any): Promise { + const request = context.switchToHttp().getRequest(); + const tenantId = request.user?.tenantId; + + if (!tenantId) { + throw new Error('No tenant context available'); + } + + // Set PostgreSQL session variable for RLS + await this.query('SET LOCAL app.current_tenant_id = $1', [tenantId]); + request.tenantId = tenantId; + + return next.handle(); + } +} diff --git a/apps/shared-libs/core/services/auth.service.ts b/apps/shared-libs/core/services/auth.service.ts new file mode 100644 index 0000000..f6b8eff --- /dev/null +++ b/apps/shared-libs/core/services/auth.service.ts @@ -0,0 +1,419 @@ +/** + * AuthService + * + * @description Centralized authentication service for ERP-Suite. + * Moved from erp-core to shared-libs (P0-014). + * + * Features: + * - Email/password login + * - User registration with multi-tenancy support + * - JWT token generation and refresh + * - Password change + * - Profile retrieval + * + * @example + * ```typescript + * import { AuthService, createAuthService } from '@erp-suite/core'; + * + * const authService = createAuthService({ + * jwtSecret: process.env.JWT_SECRET, + * jwtExpiresIn: '1h', + * queryFn: myQueryFunction, + * }); + * + * const result = await authService.login({ email, password }); + * ``` + */ +import bcrypt from 'bcryptjs'; +import jwt, { SignOptions } from 'jsonwebtoken'; + +/** + * Login data transfer object + */ +export interface LoginDto { + email: string; + password: string; +} + +/** + * Registration data transfer object + */ +export interface RegisterDto { + email: string; + password: string; + full_name?: string; + firstName?: string; + lastName?: string; + tenant_id?: string; + companyName?: string; +} + +/** + * JWT payload structure + */ +export interface JwtPayload { + userId: string; + tenantId: string; + email: string; + roles: string[]; + iat?: number; + exp?: number; +} + +/** + * Auth tokens response + */ +export interface AuthTokens { + accessToken: string; + refreshToken: string; + expiresIn: string; +} + +/** + * User entity (without password) + */ +export interface AuthUser { + id: string; + tenant_id: string; + email: string; + full_name: string; + firstName?: string; + lastName?: string; + status: string; + role_codes?: string[]; + created_at: Date; + last_login_at?: Date; +} + +/** + * Internal user with password + */ +interface InternalUser extends AuthUser { + password_hash: string; +} + +/** + * Login response + */ +export interface LoginResponse { + user: AuthUser; + tokens: AuthTokens; +} + +/** + * Query function type for database operations + */ +export type QueryFn = (sql: string, params: unknown[]) => Promise; +export type QueryOneFn = (sql: string, params: unknown[]) => Promise; + +/** + * Logger interface + */ +export interface AuthLogger { + info: (message: string, meta?: Record) => void; + error: (message: string, meta?: Record) => void; + warn: (message: string, meta?: Record) => void; +} + +/** + * Auth service configuration + */ +export interface AuthServiceConfig { + jwtSecret: string; + jwtExpiresIn: string; + jwtRefreshExpiresIn: string; + queryOne: QueryOneFn; + query: QueryFn; + logger?: AuthLogger; +} + +/** + * Error types for auth operations + */ +export class AuthUnauthorizedError extends Error { + constructor(message: string) { + super(message); + this.name = 'UnauthorizedError'; + } +} + +export class AuthValidationError extends Error { + constructor(message: string) { + super(message); + this.name = 'ValidationError'; + } +} + +export class AuthNotFoundError extends Error { + constructor(message: string) { + super(message); + this.name = 'NotFoundError'; + } +} + +/** + * Transforms full_name to firstName/lastName + */ +export function splitFullName(fullName: string): { firstName: string; lastName: string } { + const parts = (fullName || '').trim().split(/\s+/); + if (parts.length === 0 || parts[0] === '') { + return { firstName: '', lastName: '' }; + } + if (parts.length === 1) { + return { firstName: parts[0], lastName: '' }; + } + const firstName = parts[0]; + const lastName = parts.slice(1).join(' '); + return { firstName, lastName }; +} + +/** + * Transforms firstName/lastName to full_name + */ +export function buildFullName( + firstName?: string, + lastName?: string, + fullName?: string, +): string { + if (fullName) return fullName.trim(); + return `${firstName || ''} ${lastName || ''}`.trim(); +} + +/** + * Centralized Auth Service for ERP-Suite + */ +export class AuthService { + private readonly config: AuthServiceConfig; + private readonly logger: AuthLogger; + + constructor(config: AuthServiceConfig) { + this.config = config; + this.logger = config.logger || { + info: console.log, + error: console.error, + warn: console.warn, + }; + } + + /** + * Login with email/password + */ + async login(dto: LoginDto): Promise { + const user = await this.config.queryOne( + `SELECT u.*, array_agg(r.code) as role_codes + FROM auth.users u + LEFT JOIN auth.user_roles ur ON u.id = ur.user_id + LEFT JOIN auth.roles r ON ur.role_id = r.id + WHERE u.email = $1 AND u.status = 'active' + GROUP BY u.id`, + [dto.email.toLowerCase()], + ); + + if (!user) { + throw new AuthUnauthorizedError('Credenciales invalidas'); + } + + const isValidPassword = await bcrypt.compare( + dto.password, + user.password_hash || '', + ); + + if (!isValidPassword) { + throw new AuthUnauthorizedError('Credenciales invalidas'); + } + + // Update last login + await this.config.query( + 'UPDATE auth.users SET last_login_at = NOW() WHERE id = $1', + [user.id], + ); + + const tokens = this.generateTokens(user); + const userResponse = this.formatUserResponse(user); + + this.logger.info('User logged in', { userId: user.id, email: user.email }); + + return { user: userResponse, tokens }; + } + + /** + * Register new user + */ + async register(dto: RegisterDto): Promise { + const existingUser = await this.config.queryOne( + 'SELECT id FROM auth.users WHERE email = $1', + [dto.email.toLowerCase()], + ); + + if (existingUser) { + throw new AuthValidationError('El email ya esta registrado'); + } + + const fullName = buildFullName(dto.firstName, dto.lastName, dto.full_name); + const password_hash = await bcrypt.hash(dto.password, 10); + const tenantId = dto.tenant_id || crypto.randomUUID(); + + const newUser = await this.config.queryOne( + `INSERT INTO auth.users (tenant_id, email, password_hash, full_name, status, created_at) + VALUES ($1, $2, $3, $4, 'active', NOW()) + RETURNING *`, + [tenantId, dto.email.toLowerCase(), password_hash, fullName], + ); + + if (!newUser) { + throw new Error('Error al crear usuario'); + } + + const tokens = this.generateTokens(newUser); + const userResponse = this.formatUserResponse(newUser); + + this.logger.info('User registered', { userId: newUser.id, email: newUser.email }); + + return { user: userResponse, tokens }; + } + + /** + * Refresh access token + */ + async refreshToken(refreshToken: string): Promise { + try { + const payload = jwt.verify( + refreshToken, + this.config.jwtSecret, + ) as JwtPayload; + + const user = await this.config.queryOne( + 'SELECT * FROM auth.users WHERE id = $1 AND status = $2', + [payload.userId, 'active'], + ); + + if (!user) { + throw new AuthUnauthorizedError('Usuario no encontrado o inactivo'); + } + + return this.generateTokens(user); + } catch (error) { + if (error instanceof jwt.TokenExpiredError) { + throw new AuthUnauthorizedError('Refresh token expirado'); + } + throw new AuthUnauthorizedError('Refresh token invalido'); + } + } + + /** + * Change user password + */ + async changePassword( + userId: string, + currentPassword: string, + newPassword: string, + ): Promise { + const user = await this.config.queryOne( + 'SELECT * FROM auth.users WHERE id = $1', + [userId], + ); + + if (!user) { + throw new AuthNotFoundError('Usuario no encontrado'); + } + + const isValidPassword = await bcrypt.compare( + currentPassword, + user.password_hash || '', + ); + + if (!isValidPassword) { + throw new AuthUnauthorizedError('Contrasena actual incorrecta'); + } + + const newPasswordHash = await bcrypt.hash(newPassword, 10); + await this.config.query( + 'UPDATE auth.users SET password_hash = $1, updated_at = NOW() WHERE id = $2', + [newPasswordHash, userId], + ); + + this.logger.info('Password changed', { userId }); + } + + /** + * Get user profile + */ + async getProfile(userId: string): Promise { + const user = await this.config.queryOne( + `SELECT u.*, array_agg(r.code) as role_codes + FROM auth.users u + LEFT JOIN auth.user_roles ur ON u.id = ur.user_id + LEFT JOIN auth.roles r ON ur.role_id = r.id + WHERE u.id = $1 + GROUP BY u.id`, + [userId], + ); + + if (!user) { + throw new AuthNotFoundError('Usuario no encontrado'); + } + + return this.formatUserResponse(user); + } + + /** + * Verify JWT token + */ + verifyToken(token: string): JwtPayload { + try { + return jwt.verify(token, this.config.jwtSecret) as JwtPayload; + } catch (error) { + if (error instanceof jwt.TokenExpiredError) { + throw new AuthUnauthorizedError('Token expirado'); + } + throw new AuthUnauthorizedError('Token invalido'); + } + } + + /** + * Generate JWT tokens + */ + private generateTokens(user: InternalUser): AuthTokens { + const payload: JwtPayload = { + userId: user.id, + tenantId: user.tenant_id, + email: user.email, + roles: user.role_codes || [], + }; + + const accessToken = jwt.sign(payload, this.config.jwtSecret, { + expiresIn: this.config.jwtExpiresIn, + } as SignOptions); + + const refreshToken = jwt.sign(payload, this.config.jwtSecret, { + expiresIn: this.config.jwtRefreshExpiresIn, + } as SignOptions); + + return { + accessToken, + refreshToken, + expiresIn: this.config.jwtExpiresIn, + }; + } + + /** + * Format user for response (remove password_hash, add firstName/lastName) + */ + private formatUserResponse(user: InternalUser): AuthUser { + const { firstName, lastName } = splitFullName(user.full_name); + const { password_hash: _, ...userWithoutPassword } = user; + + return { + ...userWithoutPassword, + firstName, + lastName, + }; + } +} + +/** + * Factory function to create AuthService instance + */ +export function createAuthService(config: AuthServiceConfig): AuthService { + return new AuthService(config); +} diff --git a/apps/shared-libs/core/services/base-typeorm.service.ts b/apps/shared-libs/core/services/base-typeorm.service.ts new file mode 100644 index 0000000..d336b63 --- /dev/null +++ b/apps/shared-libs/core/services/base-typeorm.service.ts @@ -0,0 +1,229 @@ +/** + * BaseService (TypeORM) - Abstract service with CRUD operations using TypeORM + * + * Use this base class when working with TypeORM repositories. + * For raw SQL, use BaseSqlService instead. + * + * @module @erp-suite/core/services + * + * @example + * ```typescript + * import { BaseTypeOrmService } from '@erp-suite/core/services'; + * + * export class PartnersService extends BaseTypeOrmService { + * constructor( + * @InjectRepository(Partner) + * repository: Repository, + * ) { + * super(repository); + * } + * } + * ``` + */ + +import { + Repository, + FindOptionsWhere, + FindManyOptions, + DeepPartial, + ObjectLiteral, +} from 'typeorm'; +import { + PaginatedResult, + PaginationOptions, + createPaginationMeta, +} from '../types/pagination.types'; +import { + IBaseService, + ServiceContext, + QueryOptions, +} from '../interfaces/base-service.interface'; + +export abstract class BaseTypeOrmService + implements IBaseService, DeepPartial> +{ + constructor(protected readonly repository: Repository) {} + + /** + * Find all records for a tenant with pagination + */ + async findAll( + ctx: ServiceContext, + filters?: PaginationOptions & Record, + options?: QueryOptions, + ): Promise> { + const { page = 1, limit = 20, sortBy, sortOrder, ...customFilters } = filters || {}; + const skip = (page - 1) * limit; + + const where = this.buildWhereClause(ctx, customFilters, options); + + const order = sortBy + ? { [sortBy]: sortOrder === 'asc' ? 'ASC' : 'DESC' } + : { createdAt: 'DESC' }; + + const [data, total] = await this.repository.findAndCount({ + where: where as FindOptionsWhere, + take: limit, + skip, + order: order as any, + }); + + return { + data, + meta: createPaginationMeta(total, page, limit), + }; + } + + /** + * Find record by ID + */ + async findById( + ctx: ServiceContext, + id: string, + options?: QueryOptions, + ): Promise { + const where = this.buildWhereClause(ctx, { id }, options); + return this.repository.findOne({ where: where as FindOptionsWhere }); + } + + /** + * Find one record by criteria + */ + async findOne( + ctx: ServiceContext, + criteria: FindOptionsWhere, + options?: QueryOptions, + ): Promise { + const where = this.buildWhereClause(ctx, criteria as Record, options); + return this.repository.findOne({ where: where as FindOptionsWhere }); + } + + /** + * Find multiple records + */ + async find( + ctx: ServiceContext, + findOptions: FindManyOptions, + options?: QueryOptions, + ): Promise { + const where = this.buildWhereClause( + ctx, + (findOptions.where || {}) as Record, + options, + ); + return this.repository.find({ + ...findOptions, + where: where as FindOptionsWhere, + }); + } + + /** + * Create new record + */ + async create(ctx: ServiceContext, data: DeepPartial): Promise { + const entity = this.repository.create({ + ...data, + tenantId: ctx.tenantId, + createdById: ctx.userId, + } as DeepPartial); + + return this.repository.save(entity); + } + + /** + * Update existing record + */ + async update( + ctx: ServiceContext, + id: string, + data: DeepPartial, + ): Promise { + const existing = await this.findById(ctx, id); + if (!existing) { + return null; + } + + const updated = this.repository.merge(existing, { + ...data, + updatedById: ctx.userId, + } as DeepPartial); + + return this.repository.save(updated); + } + + /** + * Soft delete record + */ + async softDelete(ctx: ServiceContext, id: string): Promise { + const existing = await this.findById(ctx, id); + if (!existing) { + return false; + } + + await this.repository.update( + { id, tenantId: ctx.tenantId } as FindOptionsWhere, + { + deletedAt: new Date(), + deletedById: ctx.userId, + } as any, + ); + + return true; + } + + /** + * Hard delete record + */ + async hardDelete(ctx: ServiceContext, id: string): Promise { + const result = await this.repository.delete({ + id, + tenantId: ctx.tenantId, + } as FindOptionsWhere); + + return (result.affected ?? 0) > 0; + } + + /** + * Count records + */ + async count( + ctx: ServiceContext, + filters?: Record, + options?: QueryOptions, + ): Promise { + const where = this.buildWhereClause(ctx, filters || {}, options); + return this.repository.count({ where: where as FindOptionsWhere }); + } + + /** + * Check if record exists + */ + async exists( + ctx: ServiceContext, + id: string, + options?: QueryOptions, + ): Promise { + const count = await this.count(ctx, { id }, options); + return count > 0; + } + + /** + * Build where clause with tenant isolation and soft delete + */ + protected buildWhereClause( + ctx: ServiceContext, + filters: Record, + options?: QueryOptions, + ): Record { + const where: Record = { + tenantId: ctx.tenantId, + ...filters, + }; + + if (!options?.includeDeleted) { + where.deletedAt = null; + } + + return where; + } +} diff --git a/apps/shared-libs/core/types/pagination.types.ts b/apps/shared-libs/core/types/pagination.types.ts new file mode 100644 index 0000000..6af0138 --- /dev/null +++ b/apps/shared-libs/core/types/pagination.types.ts @@ -0,0 +1,54 @@ +/** + * Pagination Types - Shared across all ERP-Suite modules + * + * @module @erp-suite/core/types + */ + +/** + * Pagination request options + */ +export interface PaginationOptions { + page?: number; + limit?: number; + sortBy?: string; + sortOrder?: 'asc' | 'desc'; +} + +/** + * Pagination metadata + */ +export interface PaginationMeta { + total: number; + page: number; + limit: number; + totalPages: number; + hasNext: boolean; + hasPrev: boolean; +} + +/** + * Paginated response wrapper + */ +export interface PaginatedResult { + data: T[]; + meta: PaginationMeta; +} + +/** + * Create pagination meta from count and options + */ +export function createPaginationMeta( + total: number, + page: number, + limit: number, +): PaginationMeta { + const totalPages = Math.ceil(total / limit); + return { + total, + page, + limit, + totalPages, + hasNext: page < totalPages, + hasPrev: page > 1, + }; +} diff --git a/docker/docker-compose.prod.yml b/docker/docker-compose.prod.yml new file mode 100644 index 0000000..206d6b9 --- /dev/null +++ b/docker/docker-compose.prod.yml @@ -0,0 +1,143 @@ +version: '3.8' + +# ============================================================================= +# ERP-SUITE - Production Docker Compose +# ============================================================================= +# Servidor: 72.60.226.4 +# Componentes: erp-core + verticales opcionales +# ============================================================================= + +services: + # =========================================================================== + # ERP-CORE + # =========================================================================== + erp-core-backend: + image: ${DOCKER_REGISTRY:-72.60.226.4:5000}/erp-core-backend:${VERSION:-latest} + container_name: erp-core-backend + restart: unless-stopped + ports: + - "3011:3011" + environment: + - NODE_ENV=production + env_file: + - ../apps/erp-core/backend/.env.production + volumes: + - erp-logs:/var/log/erp-core + healthcheck: + test: ["CMD", "wget", "--spider", "-q", "http://localhost:3011/health"] + interval: 30s + timeout: 10s + retries: 3 + networks: + - erp-network + - isem-network + deploy: + resources: + limits: + cpus: '1' + memory: 512M + + erp-core-frontend: + image: ${DOCKER_REGISTRY:-72.60.226.4:5000}/erp-core-frontend:${VERSION:-latest} + container_name: erp-core-frontend + restart: unless-stopped + ports: + - "3010:80" + depends_on: + erp-core-backend: + condition: service_healthy + networks: + - erp-network + deploy: + resources: + limits: + cpus: '0.5' + memory: 128M + + # =========================================================================== + # VERTICALES (descomentar según necesidad) + # =========================================================================== + + # CONSTRUCCION + # construccion-backend: + # image: ${DOCKER_REGISTRY}/erp-construccion-backend:${VERSION:-latest} + # container_name: erp-construccion-backend + # ports: + # - "3021:3021" + # env_file: + # - ../apps/verticales/construccion/backend/.env.production + # networks: + # - erp-network + + # construccion-frontend: + # image: ${DOCKER_REGISTRY}/erp-construccion-frontend:${VERSION:-latest} + # container_name: erp-construccion-frontend + # ports: + # - "3020:80" + # networks: + # - erp-network + + # VIDRIO-TEMPLADO + # vidrio-backend: + # image: ${DOCKER_REGISTRY}/erp-vidrio-backend:${VERSION:-latest} + # ports: + # - "3031:3031" + + # vidrio-frontend: + # image: ${DOCKER_REGISTRY}/erp-vidrio-frontend:${VERSION:-latest} + # ports: + # - "3030:80" + + # MECANICAS-DIESEL + # mecanicas-backend: + # image: ${DOCKER_REGISTRY}/erp-mecanicas-backend:${VERSION:-latest} + # ports: + # - "3041:3041" + + # mecanicas-frontend: + # image: ${DOCKER_REGISTRY}/erp-mecanicas-frontend:${VERSION:-latest} + # ports: + # - "3040:80" + + # RETAIL + # retail-backend: + # image: ${DOCKER_REGISTRY}/erp-retail-backend:${VERSION:-latest} + # ports: + # - "3051:3051" + + # retail-frontend: + # image: ${DOCKER_REGISTRY}/erp-retail-frontend:${VERSION:-latest} + # ports: + # - "3050:80" + + # CLINICAS + # clinicas-backend: + # image: ${DOCKER_REGISTRY}/erp-clinicas-backend:${VERSION:-latest} + # ports: + # - "3061:3061" + + # clinicas-frontend: + # image: ${DOCKER_REGISTRY}/erp-clinicas-frontend:${VERSION:-latest} + # ports: + # - "3060:80" + + # POS-MICRO + # pos-backend: + # image: ${DOCKER_REGISTRY}/erp-pos-backend:${VERSION:-latest} + # ports: + # - "3071:3071" + + # pos-frontend: + # image: ${DOCKER_REGISTRY}/erp-pos-frontend:${VERSION:-latest} + # ports: + # - "3070:80" + +volumes: + erp-logs: + +networks: + erp-network: + driver: bridge + isem-network: + external: true + name: isem-network diff --git a/docs/02-especificaciones-tecnicas/saas-platform/ANALISIS-REQUERIMIENTOS-SAAS-TRANSVERSALES.md b/docs/02-especificaciones-tecnicas/saas-platform/ANALISIS-REQUERIMIENTOS-SAAS-TRANSVERSALES.md new file mode 100644 index 0000000..995bf01 --- /dev/null +++ b/docs/02-especificaciones-tecnicas/saas-platform/ANALISIS-REQUERIMIENTOS-SAAS-TRANSVERSALES.md @@ -0,0 +1,983 @@ +# Analisis de Requerimientos SaaS Transversales - ERP Suite + +**Version:** 1.0.0 +**Fecha:** 2025-12-05 +**Autor:** Requirements-Analyst +**Estado:** Draft - Pendiente Aprobacion + +--- + +## Resumen Ejecutivo + +Este documento analiza los nuevos requerimientos transversales que impactan a todo el ERP Suite y sus verticales. Los requerimientos incluyen: + +1. **Modelo SaaS completo** con usuario cliente administrador +2. **Suscripciones por usuario** con Stripe +3. **Apps moviles** por perfil de usuario +4. **Integracion WhatsApp Business** con agente IA +5. **Onboarding y configuracion inicial** ($10,000 - $100,000 MXN) +6. **Control y facturacion de tokens IA** + +--- + +## 1. Modelo de Negocio SaaS + +### 1.1 Estructura de Tenants + +``` ++------------------------------------------+ +| PLATAFORMA ERP SUITE | ++------------------------------------------+ + | + v ++------------------------------------------+ +| TENANT (Cliente Empresa) | +| +------------------------------------+ | +| | Owner (Usuario Administrador) | | +| | - Gestiona usuarios | | +| | - Gestiona suscripcion | | +| | - Gestiona metodos de pago | | +| | - Configura integraciones | | +| +------------------------------------+ | +| | | +| v | +| +------------------------------------+ | +| | Usuarios del Tenant | | +| | - Roles asignados por Owner | | +| | - Permisos segun rol | | +| | - Acceso a app segun perfil | | +| +------------------------------------+ | ++------------------------------------------+ +``` + +### 1.2 Flujo de Adquisicion de Cliente + +``` +1. CONTRATACION INICIAL + └── Levantamiento de requerimientos + └── Analisis de necesidades + └── Cotizacion de implementacion ($10K - $100K MXN) + └── Configuracion e integracion + └── Capacitacion + +2. ONBOARDING + └── Creacion de tenant + └── Configuracion inicial + └── Migracion de datos (opcional) + └── Pruebas de aceptacion + +3. OPERACION CONTINUA + └── Suscripcion mensual por usuario + └── Cobro de tokens IA por uso + └── Soporte y mantenimiento +``` + +### 1.3 Modelo de Precios Actualizado + +#### Suscripcion por Usuario (Mensual) + +| Vertical | Precio Base/Usuario | Usuarios Min | Descuento Volumen | +|----------|---------------------|--------------|-------------------| +| Construccion | $25 USD/usuario | 5 | >20: 15%, >50: 25% | +| Vidrio Templado | $20 USD/usuario | 3 | >10: 10%, >30: 20% | +| Mecanicas Diesel | $15 USD/usuario | 2 | >10: 10% | +| Retail | $12 USD/usuario | 1 | >20: 15% | +| Clinicas | $30 USD/usuario | 3 | >10: 10% | + +#### Cargo por Implementacion (Unico) + +| Nivel | Rango MXN | Incluye | +|-------|-----------|---------| +| Basico | $10,000 - $25,000 | Config estandar, 1 capacitacion, datos muestra | +| Medio | $25,000 - $50,000 | Config personalizada, migracion basica, 3 capacitaciones | +| Avanzado | $50,000 - $75,000 | Config avanzada, migracion completa, integraciones | +| Enterprise | $75,000 - $100,000+ | Todo lo anterior + desarrollo custom, SLA premium | + +#### Tokens IA (Pago por Uso) + +| Tipo | Precio por 1K tokens | Uso tipico | +|------|---------------------|------------| +| Input tokens | $0.003 USD | Prompts de usuario | +| Output tokens | $0.015 USD | Respuestas del agente | +| Embeddings | $0.0001 USD | Busqueda semantica | + +--- + +## 2. Arquitectura de Suscripciones con Stripe + +### 2.1 Integracion Stripe + +**Razon de Stripe sobre MercadoPago:** +- API mas robusta para suscripciones +- Mejor soporte para prorratas +- Webhooks mas confiables +- Soporte para multiple moneda +- Facturacion automatizada + +### 2.2 Modelo de Datos Extendido + +```sql +-- Extensiones al schema billing existente + +-- Tabla: stripe_customers +CREATE TABLE billing.stripe_customers ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL UNIQUE REFERENCES core_tenants.tenants(id), + stripe_customer_id VARCHAR(50) NOT NULL UNIQUE, + stripe_subscription_id VARCHAR(50), + stripe_price_id VARCHAR(50), + + -- Metadatos sincronizados + email VARCHAR(200), + default_payment_method VARCHAR(50), + + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP +); + +-- Tabla: stripe_webhook_events +CREATE TABLE billing.stripe_webhook_events ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + stripe_event_id VARCHAR(50) NOT NULL UNIQUE, + event_type VARCHAR(100) NOT NULL, + tenant_id UUID REFERENCES core_tenants.tenants(id), + payload JSONB NOT NULL, + processed BOOLEAN DEFAULT false, + processed_at TIMESTAMPTZ, + error_message TEXT, + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP +); + +-- Tabla: implementation_projects +CREATE TABLE billing.implementation_projects ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID REFERENCES core_tenants.tenants(id), + + -- Cotizacion + quote_number VARCHAR(20) NOT NULL UNIQUE, + quote_amount DECIMAL(10,2) NOT NULL, + quote_currency VARCHAR(3) DEFAULT 'MXN', + quote_status VARCHAR(20) DEFAULT 'draft', + + -- Detalles + requirements_summary TEXT, + scope_document_url VARCHAR(500), + + -- Pagos (pueden ser parciales) + amount_paid DECIMAL(10,2) DEFAULT 0, + + -- Fechas + quoted_at TIMESTAMPTZ, + accepted_at TIMESTAMPTZ, + started_at TIMESTAMPTZ, + completed_at TIMESTAMPTZ, + + created_by UUID, + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT chk_quote_status CHECK (quote_status IN ( + 'draft', 'sent', 'accepted', 'in_progress', 'completed', 'cancelled' + )) +); + +-- Tabla: implementation_payments +CREATE TABLE billing.implementation_payments ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + project_id UUID NOT NULL REFERENCES billing.implementation_projects(id), + + description VARCHAR(200) NOT NULL, + amount DECIMAL(10,2) NOT NULL, + payment_type VARCHAR(20) NOT NULL, -- deposit, milestone, final + + stripe_payment_intent_id VARCHAR(50), + status VARCHAR(20) DEFAULT 'pending', + + paid_at TIMESTAMPTZ, + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT chk_payment_type CHECK (payment_type IN ('deposit', 'milestone', 'final')) +); +``` + +### 2.3 Flujo de Suscripcion con Stripe + +``` +ALTA DE CLIENTE + | + v +[1. Crear Customer en Stripe] + | + v +[2. Guardar stripe_customer_id] + | + v +[3. Crear Payment Method (tarjeta)] + | + v +[4. Crear Subscription] + | + └── price_id: segun plan/vertical + └── quantity: numero de usuarios + └── billing_cycle_anchor: dia de facturacion + | + v +[5. Webhook: invoice.payment_succeeded] + | + v +[6. Activar tenant] + +CAMBIO DE USUARIOS + | + v +[Stripe API: Update subscription quantity] + | + └── proration: create_prorations + | + v +[Webhook: invoice.created (prorata)] + | + v +[Cobro automatico] + +CANCELACION + | + v +[Stripe API: Cancel subscription at_period_end] + | + v +[Webhook: customer.subscription.deleted] + | + v +[Desactivar tenant al final del periodo] +``` + +--- + +## 3. Arquitectura de Apps Moviles por Perfil + +### 3.1 Matriz de Apps por Vertical + +| Vertical | App | Perfiles | Funciones Principales | +|----------|-----|----------|----------------------| +| **Construccion** | App Encargado Obra | Residente, Supervisor | Check in/out biometrico, avances, fotos, materiales | +| | App Almacen | Almacenista | Entradas, salidas, inventario, requisiciones | +| | App Derechohabiente | Cliente final | Estado vivienda, citas, documentos | +| **Vidrio Templado** | App Produccion | Operador | Ordenes, calidad, escaneo | +| | App Instalador | Instalador | Asignaciones, fotos, firmas | +| **Mecanicas Diesel** | App Tecnico | Mecanico | Ordenes servicio, diagnosticos, refacciones | +| **Retail** | App Vendedor | Vendedor | POS movil, inventario, clientes | +| **Clinicas** | App Doctor | Medico | Citas, expedientes, recetas | +| | App Paciente | Paciente | Citas, resultados, mensajes | + +### 3.2 Arquitectura Tecnica de Apps + +``` ++--------------------------------------------------+ +| MONOREPO APPS MOVILES | ++--------------------------------------------------+ +| packages/ | +| ├── core/ # Logica compartida | +| │ ├── auth/ # Autenticacion | +| │ ├── api/ # Cliente API | +| │ ├── storage/ # Almacenamiento | +| │ ├── biometrics/ # Facial/Huella | +| │ ├── camera/ # Camara/Fotos | +| │ ├── location/ # GPS | +| │ └── sync/ # Sincronizacion | +| │ | +| ├── ui/ # Componentes UI | +| │ ├── components/ | +| │ ├── theme/ | +| │ └── navigation/ | +| │ | +| apps/ | +| ├── construccion-encargado/ # App Encargado | +| ├── construccion-almacen/ # App Almacen | +| ├── construccion-cliente/ # App Cliente | +| ├── vidrio-produccion/ # App Produccion | +| ├── mecanicas-tecnico/ # App Tecnico | +| ├── retail-vendedor/ # App Vendedor | +| └── clinicas-doctor/ # App Doctor | ++--------------------------------------------------+ +``` + +### 3.3 Funcionalidades Biometricas + +#### Reconocimiento Facial + +```typescript +interface FacialRecognitionConfig { + provider: 'aws-rekognition' | 'azure-face' | 'local-ml'; + livenessDetection: boolean; // Detectar que es persona real + matchThreshold: number; // 0.80 - 0.95 + maxAttempts: number; // Intentos antes de bloquear +} + +interface AttendanceRecord { + userId: string; + tenantId: string; + projectId?: string; // Para construccion + type: 'check_in' | 'check_out'; + method: 'facial' | 'fingerprint' | 'manual'; + confidence: number; // Score de match + location: { + latitude: number; + longitude: number; + accuracy: number; + }; + photoUrl?: string; // Foto del check + deviceId: string; + timestamp: Date; +} +``` + +#### Huella Dactilar + +```typescript +interface FingerprintConfig { + provider: 'device-native' | 'external-scanner'; + fallbackToPin: boolean; + templateStorage: 'local' | 'server'; +} +``` + +### 3.4 Modo Offline + +```typescript +interface OfflineCapabilities { + // Datos pre-cargados + projectData: boolean; // Datos del proyecto + productCatalog: boolean; // Catalogo de productos + employeeList: boolean; // Lista de empleados + + // Operaciones offline + createRecords: boolean; // Crear registros + updateRecords: boolean; // Actualizar registros + capturePhotos: boolean; // Capturar fotos + + // Sincronizacion + syncStrategy: 'manual' | 'auto' | 'wifi-only'; + conflictResolution: 'server-wins' | 'client-wins' | 'manual'; + maxOfflineHours: number; // Tiempo maximo sin sincronizar +} +``` + +--- + +## 4. Integracion WhatsApp Business + Agente IA + +### 4.1 Arquitectura del Agente + +``` ++--------------------------------------------------+ +| WHATSAPP BUSINESS INTEGRATION | ++--------------------------------------------------+ +| | +| [Usuario WhatsApp] | +| | | +| v | +| +---------------+ | +| | Meta Cloud API| <-- Webhook | +| +---------------+ | +| | | +| v | +| +---------------+ +-------------------+ | +| | Message Router| --> | User Identification| | +| +---------------+ +-------------------+ | +| | | | +| | [Lookup by phone] | +| | | | +| v v | +| +---------------+ +-------------------+ | +| | Intent Detect | <-- | User Permissions | | +| +---------------+ +-------------------+ | +| | | +| v | +| +---------------+ | +| | AI Agent | <-- Claude/GPT | +| | (Contexto ERP)| | +| +---------------+ | +| | | +| v | +| +---------------+ | +| | Action Handler| | +| +---------------+ | +| | | +| +----+----+----+ | +| | | | | | +| v v v v | +| Query Create Update Notify | +| | ++--------------------------------------------------+ +``` + +### 4.2 Casos de Uso por Perfil + +#### Usuario Interno (Empleado Registrado) + +| Intent | Accion | Ejemplo | +|--------|--------|---------| +| Consultar inventario | Query ERP | "Cuanto cemento hay en bodega principal?" | +| Ver mis tareas | Query ERP | "Que tareas tengo pendientes hoy?" | +| Reportar avance | Update ERP | "Termine la partida de cimentacion" | +| Solicitar material | Create ERP | "Necesito 50 bultos de cemento para manana" | +| Consultar estado | Query ERP | "Como va el proyecto Valle Verde?" | + +#### Usuario Externo (Cliente/Prospecto) + +| Intent | Accion | Ejemplo | +|--------|--------|---------| +| Estado de servicio | Query ERP | "Como va mi orden de servicio?" | +| Agendar cita | Create ERP | "Quiero agendar una cita para la semana que viene" | +| Soporte | Create Ticket | "Tengo un problema con..." | +| Informacion general | FAQ + IA | "Que servicios ofrecen?" | +| Cotizacion | Create Lead | "Quiero una cotizacion para..." | + +### 4.3 Modelo de Datos WhatsApp + +```sql +-- Schema: whatsapp +CREATE SCHEMA IF NOT EXISTS whatsapp; + +-- Numeros de WhatsApp Business registrados +CREATE TABLE whatsapp.business_numbers ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES core_tenants.tenants(id), + + phone_number VARCHAR(20) NOT NULL, + waba_id VARCHAR(50) NOT NULL, -- WhatsApp Business Account ID + phone_number_id VARCHAR(50) NOT NULL, -- Meta Phone Number ID + + display_name VARCHAR(100), + verification_status VARCHAR(20), + + is_active BOOLEAN DEFAULT true, + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT uq_business_numbers UNIQUE (phone_number) +); + +-- Contactos conocidos +CREATE TABLE whatsapp.contacts ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES core_tenants.tenants(id), + + phone_number VARCHAR(20) NOT NULL, + whatsapp_id VARCHAR(50), -- WA ID del usuario + + -- Vinculacion con usuario ERP (si existe) + user_id UUID REFERENCES core_users.users(id), + + -- Datos del contacto + name VARCHAR(200), + profile_picture_url VARCHAR(500), + + -- Tipo de contacto + contact_type VARCHAR(20) DEFAULT 'unknown', + -- internal: empleado registrado + -- customer: cliente + -- lead: prospecto + -- unknown: no identificado + + -- Consentimiento + opted_in BOOLEAN DEFAULT false, + opted_in_at TIMESTAMPTZ, + + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + last_message_at TIMESTAMPTZ, + + CONSTRAINT uq_whatsapp_contacts UNIQUE (tenant_id, phone_number) +); + +-- Conversaciones +CREATE TABLE whatsapp.conversations ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES core_tenants.tenants(id), + business_number_id UUID NOT NULL REFERENCES whatsapp.business_numbers(id), + contact_id UUID NOT NULL REFERENCES whatsapp.contacts(id), + + status VARCHAR(20) DEFAULT 'active', + + -- Contexto del agente IA + ai_context JSONB DEFAULT '{}'::jsonb, + current_intent VARCHAR(100), + + -- Metricas + message_count INT DEFAULT 0, + ai_token_count INT DEFAULT 0, + + started_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + last_activity_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + ended_at TIMESTAMPTZ, + + CONSTRAINT chk_conversation_status CHECK (status IN ('active', 'resolved', 'escalated', 'expired')) +); + +-- Mensajes +CREATE TABLE whatsapp.messages ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + conversation_id UUID NOT NULL REFERENCES whatsapp.conversations(id), + + -- Meta IDs + wamid VARCHAR(100) UNIQUE, -- WhatsApp Message ID + + direction VARCHAR(10) NOT NULL, -- inbound | outbound + message_type VARCHAR(20) NOT NULL, -- text, image, document, audio, template + + -- Contenido + content TEXT, + media_url VARCHAR(500), + template_name VARCHAR(100), + + -- AI Processing + ai_processed BOOLEAN DEFAULT false, + ai_intent VARCHAR(100), + ai_response JSONB, + ai_tokens_used INT DEFAULT 0, + + -- Estado + status VARCHAR(20) DEFAULT 'sent', + error_message TEXT, + + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + delivered_at TIMESTAMPTZ, + read_at TIMESTAMPTZ, + + CONSTRAINT chk_message_direction CHECK (direction IN ('inbound', 'outbound')), + CONSTRAINT chk_message_type CHECK (message_type IN ('text', 'image', 'document', 'audio', 'video', 'template', 'interactive')) +); + +-- Acciones ejecutadas por el agente +CREATE TABLE whatsapp.ai_actions ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + message_id UUID NOT NULL REFERENCES whatsapp.messages(id), + conversation_id UUID NOT NULL REFERENCES whatsapp.conversations(id), + + action_type VARCHAR(50) NOT NULL, -- query, create, update, notify + entity_type VARCHAR(50), -- project, task, material, etc. + entity_id UUID, + + input_params JSONB, + result JSONB, + success BOOLEAN, + error_message TEXT, + + tokens_used INT DEFAULT 0, + execution_time_ms INT, + + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP +); +``` + +### 4.4 Facturacion de WhatsApp + +``` +COSTOS A CONSIDERAR: + +1. Meta Platform Fee + - Conversaciones de negocio: $0.0088 USD por mensaje + - Conversaciones de servicio: $0.0066 USD por mensaje + - Primeras 1000 conversaciones/mes: GRATIS + +2. Tokens IA (nuestro costo) + - Procesar mensaje: ~500 tokens input + - Generar respuesta: ~200 tokens output + - Costo por mensaje: ~$0.005 USD + +3. Modelo de cobro al cliente + - Incluir X conversaciones en plan base + - Cobrar excedente por conversacion + - O cobrar por tokens IA usados +``` + +--- + +## 5. Onboarding y Configuracion Inicial + +### 5.1 Proceso de Onboarding + +``` +FASE 1: PRE-VENTA (1-2 semanas) +├── Contacto inicial +├── Demo del sistema +├── Levantamiento de requerimientos +│ ├── Cuestionario de necesidades +│ ├── Catalogo de procesos actuales +│ ├── Volumenes estimados (usuarios, transacciones) +│ └── Integraciones requeridas +├── Propuesta tecnica y comercial +└── Aceptacion y anticipo + +FASE 2: CONFIGURACION (2-4 semanas) +├── Creacion de tenant +├── Configuracion de catalogos +│ ├── Usuarios y roles +│ ├── Centros de costo +│ ├── Proyectos/Sucursales +│ └── Productos/Materiales +├── Personalizacion de flujos +├── Configuracion de integraciones +│ ├── Facturacion electronica (CFDI) +│ ├── Bancos +│ ├── WhatsApp Business +│ └── Otras APIs +└── Migracion de datos (si aplica) + +FASE 3: CAPACITACION (1-2 semanas) +├── Capacitacion administradores +├── Capacitacion usuarios finales +├── Capacitacion especifica por rol +├── Material de consulta +└── Certificacion de usuarios clave + +FASE 4: PILOTO (2-4 semanas) +├── Operacion en paralelo +├── Soporte intensivo +├── Ajustes y correcciones +├── Validacion de reportes +└── Aceptacion formal + +FASE 5: GO-LIVE +├── Corte de operacion legacy +├── Operacion productiva +├── Soporte post-go-live (1 mes) +└── Traspaso a soporte regular +``` + +### 5.2 Modelo de Datos Onboarding + +```sql +-- Schema: onboarding +CREATE SCHEMA IF NOT EXISTS onboarding; + +-- Proyectos de implementacion +CREATE TABLE onboarding.projects ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID REFERENCES core_tenants.tenants(id), + + -- Identificacion + project_code VARCHAR(20) NOT NULL UNIQUE, + company_name VARCHAR(200) NOT NULL, + vertical VARCHAR(50) NOT NULL, + + -- Contacto principal + contact_name VARCHAR(200), + contact_email VARCHAR(200), + contact_phone VARCHAR(50), + + -- Comercial + sales_rep_id UUID, + quote_amount DECIMAL(12,2), + quote_currency VARCHAR(3) DEFAULT 'MXN', + + -- Estado + status VARCHAR(30) DEFAULT 'lead', + current_phase VARCHAR(30), + + -- Fechas + first_contact_at TIMESTAMPTZ, + quote_sent_at TIMESTAMPTZ, + quote_accepted_at TIMESTAMPTZ, + kickoff_at TIMESTAMPTZ, + go_live_at TIMESTAMPTZ, + closed_at TIMESTAMPTZ, + + -- Notas + requirements_notes TEXT, + + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT chk_project_status CHECK (status IN ( + 'lead', 'qualified', 'quoted', 'negotiating', 'accepted', + 'in_progress', 'pilot', 'live', 'cancelled', 'lost' + )), + CONSTRAINT chk_project_phase CHECK (current_phase IN ( + 'requirements', 'configuration', 'data_migration', + 'training', 'pilot', 'go_live', 'support' + )) +); + +-- Tareas de implementacion +CREATE TABLE onboarding.tasks ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + project_id UUID NOT NULL REFERENCES onboarding.projects(id), + + phase VARCHAR(30) NOT NULL, + task_code VARCHAR(20) NOT NULL, + title VARCHAR(200) NOT NULL, + description TEXT, + + -- Asignacion + assigned_to UUID, + + -- Estado + status VARCHAR(20) DEFAULT 'pending', + priority VARCHAR(10) DEFAULT 'medium', + + -- Fechas + due_date DATE, + started_at TIMESTAMPTZ, + completed_at TIMESTAMPTZ, + + -- Dependencias + depends_on UUID[], + + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT uq_task_code UNIQUE (project_id, task_code), + CONSTRAINT chk_task_status CHECK (status IN ('pending', 'in_progress', 'blocked', 'completed', 'cancelled')) +); + +-- Checklist de configuracion +CREATE TABLE onboarding.configuration_items ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + project_id UUID NOT NULL REFERENCES onboarding.projects(id), + + category VARCHAR(50) NOT NULL, + item_name VARCHAR(200) NOT NULL, + description TEXT, + + is_required BOOLEAN DEFAULT true, + is_completed BOOLEAN DEFAULT false, + completed_at TIMESTAMPTZ, + completed_by UUID, + + notes TEXT, + + sort_order INT DEFAULT 0, + + CONSTRAINT uq_config_item UNIQUE (project_id, category, item_name) +); + +-- Documentos de proyecto +CREATE TABLE onboarding.documents ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + project_id UUID NOT NULL REFERENCES onboarding.projects(id), + + document_type VARCHAR(50) NOT NULL, + title VARCHAR(200) NOT NULL, + file_url VARCHAR(500), + + uploaded_by UUID, + uploaded_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT chk_document_type CHECK (document_type IN ( + 'quote', 'contract', 'requirements', 'scope', 'migration_spec', + 'training_material', 'acceptance', 'invoice', 'other' + )) +); + +-- Pagos de implementacion +CREATE TABLE onboarding.payments ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + project_id UUID NOT NULL REFERENCES onboarding.projects(id), + + concept VARCHAR(100) NOT NULL, + amount DECIMAL(12,2) NOT NULL, + currency VARCHAR(3) DEFAULT 'MXN', + + payment_type VARCHAR(20) NOT NULL, + + -- Referencia de pago + invoice_id UUID REFERENCES billing.invoices(id), + stripe_payment_id VARCHAR(50), + + status VARCHAR(20) DEFAULT 'pending', + paid_at TIMESTAMPTZ, + + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT chk_payment_type CHECK (payment_type IN ('deposit', 'milestone', 'final', 'extra')) +); +``` + +--- + +## 6. Control de Tokens IA y Facturacion por Uso + +### 6.1 Metricas de Uso de IA + +```sql +-- Extender tabla billing.usage_records para tokens IA + +-- Tipos de metricas IA: +-- 'ai_input_tokens': Tokens de entrada (prompts) +-- 'ai_output_tokens': Tokens de salida (respuestas) +-- 'ai_embeddings': Tokens de embeddings +-- 'whatsapp_ai_conversations': Conversaciones WA procesadas por IA + +-- Vista agregada de uso de IA +CREATE VIEW billing.vw_ai_usage_summary AS +SELECT + tenant_id, + period, + SUM(CASE WHEN metric_type = 'ai_input_tokens' THEN value ELSE 0 END) AS input_tokens, + SUM(CASE WHEN metric_type = 'ai_output_tokens' THEN value ELSE 0 END) AS output_tokens, + SUM(CASE WHEN metric_type = 'ai_embeddings' THEN value ELSE 0 END) AS embedding_tokens, + SUM(CASE WHEN metric_type = 'whatsapp_ai_conversations' THEN value ELSE 0 END) AS wa_conversations, + + -- Costo calculado + SUM(CASE WHEN metric_type = 'ai_input_tokens' THEN value * 0.003 / 1000 ELSE 0 END) + + SUM(CASE WHEN metric_type = 'ai_output_tokens' THEN value * 0.015 / 1000 ELSE 0 END) + + SUM(CASE WHEN metric_type = 'ai_embeddings' THEN value * 0.0001 / 1000 ELSE 0 END) AS total_cost_usd + +FROM billing.usage_records +WHERE metric_type LIKE 'ai_%' OR metric_type = 'whatsapp_ai_conversations' +GROUP BY tenant_id, period; +``` + +### 6.2 Flujo de Registro de Tokens + +``` +[Llamada a AI API] + | + v +[Token Counter Middleware] + | + ├── input_tokens = count(prompt) + ├── output_tokens = count(response) + | + v +[Usage Logger Service] + | + ├── Incrementar usage_records (async) + ├── Verificar limites del plan + | + v +[Rate Limiter] + | + ├── Si excede limite: bloquear o alertar + └── Si OK: continuar + +[Fin del Periodo (Billing Job)] + | + v +[Calcular costo total] + | + v +[Generar linea en factura] + | + └── type: 'usage' + └── description: 'Tokens IA - Diciembre 2025' + └── quantity: total_tokens + └── unit_price: costo_por_token + └── amount: total_cost +``` + +### 6.3 Alertas de Consumo + +```typescript +interface UsageAlertConfig { + // Thresholds por tipo de metrica + thresholds: { + ai_tokens: { + warning: 80, // % del limite + critical: 95, // % del limite + action: 'notify' | 'block' | 'auto_upgrade' + }, + whatsapp_conversations: { + warning: 75, + critical: 90, + action: 'notify' + } + }; + + // Notificaciones + notifications: { + email: boolean; + push: boolean; + whatsapp: boolean; + }; + + // Destinatarios + recipients: string[]; // user_ids de administradores +} +``` + +--- + +## 7. Impacto en Verticales + +### 7.1 Construccion + +| Componente | Impacto | Nuevos Modulos | +|------------|---------|----------------| +| Apps Moviles | Alto | App Encargado, App Almacen, App Cliente | +| WhatsApp | Alto | Notificaciones, Consultas | +| Biometricos | Alto | Check in/out con facial | +| Tokens IA | Medio | Asistente de obra | +| Onboarding | Alto | Migracion de proyectos | + +### 7.2 Otras Verticales + +| Vertical | Apps Moviles | WhatsApp | Biometricos | IA | +|----------|--------------|----------|-------------|-----| +| Vidrio Templado | Produccion, Instalador | Si | Opcional | Medio | +| Mecanicas | Tecnico | Si | No | Alto | +| Retail | Vendedor | Si | Opcional | Medio | +| Clinicas | Doctor, Paciente | Si | Opcional | Alto | + +--- + +## 8. Plan de Implementacion + +### 8.1 Fases + +``` +FASE 1: INFRAESTRUCTURA BASE (8 semanas) +├── Integracion Stripe +├── Sistema de onboarding +├── Control de tokens IA +└── Base de apps moviles + +FASE 2: WHATSAPP (6 semanas) +├── Integracion Meta Cloud API +├── Agente IA basico +├── Registro de conversaciones +└── Facturacion WhatsApp + +FASE 3: APPS MOVILES - CONSTRUCCION (10 semanas) +├── App Encargado de Obra +├── App Almacen +├── App Derechohabiente +└── Biometricos + +FASE 4: APPS MOVILES - OTRAS VERTICALES (12 semanas) +├── Apps por vertical +└── Personalizaciones +``` + +### 8.2 Recursos Requeridos + +| Rol | Cantidad | Dedicacion | +|-----|----------|------------| +| Backend Developer | 2 | Full-time | +| Mobile Developer (React Native) | 2 | Full-time | +| Frontend Developer | 1 | Part-time | +| DevOps | 1 | Part-time | +| QA | 1 | Full-time | +| Product Owner | 1 | Part-time | + +--- + +## 9. Proximos Pasos + +1. **Validar** este documento con stakeholders +2. **Crear epicas** para cada modulo nuevo +3. **Disenar** arquitectura detallada de cada componente +4. **Priorizar** features para MVP +5. **Estimar** esfuerzo y crear roadmap + +--- + +## 10. Referencias + +- [EPIC-MGN-016-billing.md](/home/isem/workspace/projects/erp-suite/apps/erp-core/docs/08-epicas/EPIC-MGN-016-billing.md) +- [DDL-SPEC-billing.md](/home/isem/workspace/projects/erp-suite/apps/erp-core/docs/04-modelado/database-design/DDL-SPEC-billing.md) +- [Stripe Billing Documentation](https://stripe.com/docs/billing) +- [Meta WhatsApp Business API](https://developers.facebook.com/docs/whatsapp) + +--- + +*Ultima actualizacion: 2025-12-05* diff --git a/docs/02-especificaciones-tecnicas/saas-platform/arquitectura/ARQUITECTURA-INFRAESTRUCTURA-SAAS.md b/docs/02-especificaciones-tecnicas/saas-platform/arquitectura/ARQUITECTURA-INFRAESTRUCTURA-SAAS.md new file mode 100644 index 0000000..8ba4cb3 --- /dev/null +++ b/docs/02-especificaciones-tecnicas/saas-platform/arquitectura/ARQUITECTURA-INFRAESTRUCTURA-SAAS.md @@ -0,0 +1,875 @@ +# Arquitectura de Infraestructura - ERP Suite SaaS Platform + +## 1. Vista General de Arquitectura + +``` + ┌─────────────────────────────────────────────────────────┐ + │ INTERNET │ + └─────────────────────────────────────────────────────────┘ + │ + ┌─────────────────────────────────────────┼─────────────────────────────────────────┐ + │ │ │ + ▼ ▼ ▼ + ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ + │ Cloudflare │ │ Cloudflare │ │ Cloudflare │ + │ (CDN/WAF) │ │ (CDN/WAF) │ │ (CDN/WAF) │ + │ Web Apps │ │ API │ │ Webhooks │ + └───────┬────────┘ └───────┬────────┘ └───────┬────────┘ + │ │ │ + ▼ ▼ ▼ +┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ +│ KUBERNETES CLUSTER │ +│ ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │ +│ │ INGRESS CONTROLLER (nginx) │ │ +│ └─────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────── NAMESPACES ───────────────────────────────────────────────┐ │ +│ │ │ │ +│ │ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ │ +│ │ │ erp-web │ │ erp-api │ │ erp-workers │ │ erp-webhooks │ │ erp-mobile │ │ │ +│ │ │ │ │ │ │ │ │ │ │ │ │ │ +│ │ │ React Apps │ │ NestJS API │ │ Background │ │ Stripe WH │ │ Mobile BFF │ │ │ +│ │ │ (por vertical) │ │ (multi-tenant) │ │ Jobs │ │ WhatsApp WH │ │ │ │ │ +│ │ │ │ │ │ │ │ │ Meta WH │ │ │ │ │ +│ │ └─────────────────┘ └─────────────────┘ └─────────────────┘ └─────────────────┘ └─────────────────┘ │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌───────────────────────────────────────────── DATA LAYER ─────────────────────────────────────────────────┐ │ +│ │ │ │ +│ │ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ │ +│ │ │ PostgreSQL │ │ Redis │ │ RabbitMQ │ │ MinIO │ │ │ +│ │ │ (Primary) │ │ Cluster │ │ (Message Q) │ │ (Object Store)│ │ │ +│ │ │ │ │ │ │ │ │ │ │ │ +│ │ └─────────────────┘ └─────────────────┘ └─────────────────┘ └─────────────────┘ │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ │ +│ │ +└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ + │ │ │ + ▼ ▼ ▼ + ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ + │ Stripe │ │ Meta Cloud │ │ AI Services │ + │ API │ │ API (WA) │ │ Claude/GPT │ + └────────────────┘ └────────────────┘ └────────────────┘ +``` + +--- + +## 2. Arquitectura de Servicios + +### 2.1 API Gateway / Backend for Frontend + +``` +┌──────────────────────────────────────────────────────────────────────────────────┐ +│ API GATEWAY (Kong / nginx) │ +├──────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ Routes: │ +│ ├── /api/v1/* → erp-api-service (main API) │ +│ ├── /webhooks/stripe/* → webhook-service (Stripe callbacks) │ +│ ├── /webhooks/whatsapp/*→ webhook-service (Meta callbacks) │ +│ ├── /mobile/api/* → mobile-bff-service (mobile optimized) │ +│ └── /ws/* → websocket-service (real-time) │ +│ │ +│ Features: │ +│ ├── Rate Limiting (por tenant, por user, por IP) │ +│ ├── JWT Validation │ +│ ├── Request/Response Logging │ +│ ├── CORS Management │ +│ └── Circuit Breaker │ +│ │ +└──────────────────────────────────────────────────────────────────────────────────┘ +``` + +### 2.2 Microservicios Core + +``` +┌─────────────────────────────────────────────────────────────────────────────────────┐ +│ CORE SERVICES │ +├─────────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────────┐ │ +│ │ erp-api-service │ │ +│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ +│ │ │ Auth │ │ Tenants │ │ Users │ │ RBAC │ │ │ +│ │ │ Module │ │ Module │ │ Module │ │ Module │ │ │ +│ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │ │ +│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ +│ │ │ Billing │ │ Stripe │ │ AI Token │ │ Onboard │ │ │ +│ │ │ Module │ │ Module │ │ Module │ │ Module │ │ │ +│ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │ │ +│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ +│ │ │ Vertical │ │ Vertical │ │ Vertical │ ... (módulos por │ │ +│ │ │Construcción │ │ Vidrio │ │ Mecánicas │ vertical) │ │ +│ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ +│ └─────────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────────┐ │ +│ │ webhook-service │ │ +│ │ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │ │ +│ │ │ Stripe Handler │ │ WhatsApp Handler │ │ Generic Handler │ │ │ +│ │ │ - Signature │ │ - Signature │ │ - Custom hooks │ │ │ +│ │ │ - Events │ │ - Messages │ │ │ │ │ +│ │ │ - Idempotency │ │ - Status │ │ │ │ │ +│ │ └──────────────────┘ └──────────────────┘ └──────────────────┘ │ │ +│ └─────────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────────┐ │ +│ │ worker-service │ │ +│ │ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │ │ +│ │ │ Billing Jobs │ │ WhatsApp Jobs │ │ Notification │ │ │ +│ │ │ - Invoice gen │ │ - AI Process │ │ - Email │ │ │ +│ │ │ - Usage calc │ │ - Send message │ │ - Push │ │ │ +│ │ │ - Alerts │ │ - Media upload │ │ - In-app │ │ │ +│ │ └──────────────────┘ └──────────────────┘ └──────────────────┘ │ │ +│ └─────────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────────┐ │ +│ │ mobile-bff-service │ │ +│ │ - Optimized payloads for mobile │ │ +│ │ - Offline-friendly responses │ │ +│ │ - Batch operations │ │ +│ │ - Delta sync endpoints │ │ +│ └─────────────────────────────────────────────────────────────────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 3. Arquitectura de Base de Datos + +### 3.1 PostgreSQL Multi-Tenant con RLS + +```sql +-- Configuración de schemas por dominio +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ POSTGRESQL DATABASE │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────┐ Schema: core_tenants │ +│ │ tenants │ - Información de organizaciones │ +│ │ tenant_settings │ - Configuraciones por tenant │ +│ │ feature_flags │ - Features habilitadas │ +│ └─────────────────┘ │ +│ │ +│ ┌─────────────────┐ Schema: auth │ +│ │ users │ - Usuarios del sistema │ +│ │ sessions │ - Sesiones activas │ +│ │ roles │ - Roles y permisos │ +│ │ permissions │ - Permisos granulares │ +│ └─────────────────┘ │ +│ │ +│ ┌─────────────────┐ Schema: billing │ +│ │ plans │ - Planes de suscripción │ +│ │ subscriptions │ - Suscripciones activas │ +│ │ invoices │ - Facturas generadas │ +│ │ usage_records │ - Registros de uso (tokens, usuarios) │ +│ │ stripe_customers│ - Mapeo Stripe Customer │ +│ │ stripe_events │ - Log de webhooks Stripe │ +│ │ ai_token_pkgs │ - Paquetes de tokens comprados │ +│ └─────────────────┘ │ +│ │ +│ ┌─────────────────┐ Schema: whatsapp │ +│ │ business_numbers│ - Números WhatsApp Business │ +│ │ contacts │ - Contactos de WA │ +│ │ conversations │ - Conversaciones │ +│ │ messages │ - Mensajes enviados/recibidos │ +│ │ ai_actions │ - Acciones ejecutadas por IA │ +│ └─────────────────┘ │ +│ │ +│ ┌─────────────────┐ Schema: onboarding │ +│ │ prospects │ - Prospectos │ +│ │ projects │ - Proyectos de implementación │ +│ │ tasks │ - Tareas de configuración │ +│ │ quotes │ - Cotizaciones │ +│ │ payments │ - Pagos de implementación │ +│ └─────────────────┘ │ +│ │ +│ ┌─────────────────┐ Schemas por Vertical (con RLS) │ +│ │ construccion │ - Proyectos, contratos, avances... │ +│ │ vidrio_templado │ - Órdenes, producción, instalación... │ +│ │ mecanicas │ - Servicios, diagnósticos... │ +│ │ retail │ - Productos, ventas, inventario... │ +│ │ clinicas │ - Pacientes, citas, expedientes... │ +│ └─────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +### 3.2 Row Level Security (RLS) + +```sql +-- Ejemplo de política RLS para multi-tenancy +ALTER TABLE construccion.projects ENABLE ROW LEVEL SECURITY; + +CREATE POLICY tenant_isolation_policy ON construccion.projects + USING (tenant_id = current_setting('app.current_tenant_id')::uuid); + +-- Función para establecer tenant en conexión +CREATE OR REPLACE FUNCTION set_tenant_context(p_tenant_id uuid) +RETURNS void AS $$ +BEGIN + PERFORM set_config('app.current_tenant_id', p_tenant_id::text, false); +END; +$$ LANGUAGE plpgsql; +``` + +### 3.3 Estrategia de Conexiones + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ CONNECTION POOLING │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ +│ │ API Service │ │ Worker Service │ │ Webhook Service│ │ +│ │ Pool: 50 │ │ Pool: 20 │ │ Pool: 10 │ │ +│ └────────┬────────┘ └────────┬────────┘ └────────┬────────┘ │ +│ │ │ │ │ +│ └───────────────────────┼───────────────────────┘ │ +│ │ │ +│ ┌────────▼────────┐ │ +│ │ PgBouncer │ │ +│ │ Pool: 200 │ │ +│ │ Mode: txn │ │ +│ └────────┬────────┘ │ +│ │ │ +│ ┌────────▼────────┐ │ +│ │ PostgreSQL │ │ +│ │ Primary │ │ +│ │ max_conn: 300 │ │ +│ └─────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 4. Arquitectura de Caching + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ REDIS CLUSTER │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ DB 0: Sessions │ │ +│ │ - JWT tokens │ │ +│ │ - Refresh tokens │ │ +│ │ - TTL: 24h │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ DB 1: API Cache │ │ +│ │ - Query results │ │ +│ │ - Computed values │ │ +│ │ - TTL: 5min - 1h │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ DB 2: Rate Limiting │ │ +│ │ - Per tenant limits │ │ +│ │ - Per user limits │ │ +│ │ - API call counters │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ DB 3: Token Usage │ │ +│ │ - Real-time token counters │ │ +│ │ - Flush to DB every 1min │ │ +│ │ - Limit checks │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ DB 4: Pub/Sub │ │ +│ │ - Real-time notifications │ │ +│ │ - WebSocket broadcasts │ │ +│ │ - Cache invalidation │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 5. Arquitectura de Mensajería + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ RABBITMQ CLUSTER │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ Exchanges: │ +│ ├── billing.events (topic) │ +│ │ ├── billing.invoice.created │ +│ │ ├── billing.payment.succeeded │ +│ │ └── billing.subscription.changed │ +│ │ │ +│ ├── whatsapp.events (topic) │ +│ │ ├── whatsapp.message.received │ +│ │ ├── whatsapp.message.sent │ +│ │ └── whatsapp.status.updated │ +│ │ │ +│ ├── ai.events (topic) │ +│ │ ├── ai.process.request │ +│ │ ├── ai.process.complete │ +│ │ └── ai.tokens.recorded │ +│ │ │ +│ └── notifications.events (topic) │ +│ ├── notifications.email.send │ +│ ├── notifications.push.send │ +│ └── notifications.sms.send │ +│ │ +│ Queues: │ +│ ├── billing-processor (durable, 3 consumers) │ +│ ├── whatsapp-processor (durable, 5 consumers) │ +│ ├── ai-processor (durable, 3 consumers) │ +│ ├── email-sender (durable, 2 consumers) │ +│ ├── push-sender (durable, 2 consumers) │ +│ └── dead-letter-queue (for failed messages) │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 6. Flujo de Integración Stripe + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ STRIPE INTEGRATION FLOW │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ 1. CREACIÓN DE SUSCRIPCIÓN │ +│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ +│ │ Frontend│────►│ API │────►│ Stripe │────►│ Stripe │ │ +│ │ │ │ Service │ │ Service │ │ API │ │ +│ └─────────┘ └────┬────┘ └────┬────┘ └────┬────┘ │ +│ │ │ │ │ +│ ▼ │ │ │ +│ ┌──────────┐ │ │ │ +│ │ DB │◄─────────┴───────────────┘ │ +│ │ (local) │ (crear subscription record) │ +│ └──────────┘ │ +│ │ +│ 2. PROCESAMIENTO DE WEBHOOKS │ +│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ +│ │ Stripe │────►│ Webhook │────►│ Verify │────►│ Process │ │ +│ │ API │ │Endpoint │ │Signature│ │ Event │ │ +│ └─────────┘ └─────────┘ └────┬────┘ └────┬────┘ │ +│ │ │ │ +│ ▼ ▼ │ +│ ┌──────────┐ ┌──────────┐ │ +│ │ Check │ │ Update │ │ +│ │Idempotent│ │ State │ │ +│ └──────────┘ └──────────┘ │ +│ │ │ +│ ▼ │ +│ ┌──────────┐ │ +│ │ Publish │ │ +│ │ Event │ │ +│ └──────────┘ │ +│ │ +│ 3. ACTUALIZACIÓN DE CANTIDAD (per-seat) │ +│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ +│ │ Add/Rem │────►│ Count │────►│ Update │────►│ Stripe │ │ +│ │ User │ │ Users │ │Quantity │ │ API │ │ +│ └─────────┘ └─────────┘ └────┬────┘ └────┬────┘ │ +│ │ │ │ +│ ▼ ▼ │ +│ ┌──────────┐ ┌──────────┐ │ +│ │ Prorate │ │ New │ │ +│ │Calculate │ │ Invoice │ │ +│ └──────────┘ └──────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 7. Flujo de WhatsApp + AI Agent + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ WHATSAPP + AI AGENT FLOW │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌──────────┐ │ +│ │ User │ │ +│ │ WhatsApp │ │ +│ └────┬─────┘ │ +│ │ 1. Send Message │ +│ ▼ │ +│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ +│ │ Meta │────►│ Webhook │────►│ Verify │ │ +│ │ Cloud │ │ Handler │ │ Signature│ │ +│ │ API │ │ │ │ │ │ +│ └──────────┘ └──────────┘ └────┬─────┘ │ +│ │ 2. Valid │ +│ ▼ │ +│ ┌──────────┐ │ +│ │ Queue │ │ +│ │ Message │ │ +│ └────┬─────┘ │ +│ │ 3. Async Process │ +│ ▼ │ +│ ┌──────────────────────────────────────────────────────────────┐ │ +│ │ AI PROCESSOR │ │ +│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ +│ │ │ Identify │────►│ Check │────►│Determine │ │ │ +│ │ │ User │ │ Perms │ │ Intent │ │ │ +│ │ └──────────┘ └──────────┘ └────┬─────┘ │ │ +│ │ │ │ │ +│ │ ┌─────────────────────────────────┼─────────────┐ │ │ +│ │ │ │ │ │ │ +│ │ ▼ ▼ ▼ │ │ +│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ +│ │ │ Query │ │ Create │ │ Update │ │ │ +│ │ │ ERP │ │ Record │ │ Record │ │ │ +│ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │ +│ │ │ │ │ │ │ +│ │ └────────────────────────────────┼─────────────┘ │ │ +│ │ │ │ │ +│ │ ▼ │ │ +│ │ ┌──────────┐ │ │ +│ │ │ Generate │ │ │ +│ │ │ Response │ │ │ +│ │ │ (AI) │ │ │ +│ │ └────┬─────┘ │ │ +│ │ │ │ │ +│ └───────────────────────────────────────┼──────────────────────┘ │ +│ │ 4. Response │ +│ ▼ │ +│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ +│ │ Record │◄────│ Send │◄────│ Track │ │ +│ │ Tokens │ │ Message │ │ Usage │ │ +│ └──────────┘ └────┬─────┘ └──────────┘ │ +│ │ │ +│ ▼ │ +│ ┌──────────┐ │ +│ │ Meta │ │ +│ │ Cloud │ │ +│ │ API │ │ +│ └────┬─────┘ │ +│ │ │ +│ ▼ │ +│ ┌──────────┐ │ +│ │ User │ │ +│ │ WhatsApp │ │ +│ └──────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 8. Arquitectura Mobile + +### 8.1 Estructura del Monorepo + +``` +apps/mobile/ +├── packages/ +│ ├── core/ # Paquetes compartidos +│ │ ├── api/ # Cliente API +│ │ │ ├── client.ts # Axios instance +│ │ │ ├── interceptors.ts # Auth, retry, logging +│ │ │ └── endpoints/ # Endpoints por módulo +│ │ ├── auth/ # Autenticación +│ │ │ ├── AuthContext.tsx +│ │ │ ├── useAuth.ts +│ │ │ └── tokenStorage.ts +│ │ ├── storage/ # Persistencia local +│ │ │ ├── database.ts # WatermelonDB setup +│ │ │ ├── models/ # Modelos offline +│ │ │ └── migrations/ # Migraciones DB +│ │ └── sync/ # Sincronización +│ │ ├── SyncManager.ts +│ │ ├── ConflictResolver.ts +│ │ └── DeltaSync.ts +│ │ +│ ├── biometrics/ # Autenticación biométrica +│ │ ├── FacialRecognition.tsx +│ │ ├── Fingerprint.tsx +│ │ ├── LivenessDetection.ts +│ │ └── hooks/ +│ │ +│ ├── camera/ # Captura de fotos +│ │ ├── CameraCapture.tsx +│ │ ├── GeoTagging.ts +│ │ └── ImageCompression.ts +│ │ +│ ├── notifications/ # Push notifications +│ │ ├── FCMHandler.ts +│ │ └── NotificationService.ts +│ │ +│ └── ui/ # Componentes UI +│ ├── Button.tsx +│ ├── Card.tsx +│ ├── Input.tsx +│ └── theme/ +│ +├── apps/ # Apps por perfil +│ ├── construccion-encargado/ +│ │ ├── src/ +│ │ │ ├── screens/ +│ │ │ │ ├── CheckIn.tsx +│ │ │ │ ├── Projects.tsx +│ │ │ │ ├── DailyReport.tsx +│ │ │ │ └── Materials.tsx +│ │ │ └── navigation/ +│ │ ├── app.json +│ │ └── package.json +│ │ +│ ├── construccion-almacen/ +│ ├── construccion-cliente/ +│ ├── vidrio-produccion/ +│ ├── vidrio-instalador/ +│ ├── mecanicas-tecnico/ +│ └── retail-vendedor/ +│ +├── package.json # Workspaces config +└── turbo.json # Turborepo config +``` + +### 8.2 Flujo de Sincronización Offline + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ OFFLINE SYNC ARCHITECTURE │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ MOBILE APP │ │ +│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ +│ │ │ React │────►│ Zustand │────►│ WatermelonDB│ │ │ +│ │ │ Component │ │ Store │ │ (SQLite) │ │ │ +│ │ └─────────────┘ └──────┬──────┘ └──────┬──────┘ │ │ +│ │ │ │ │ │ +│ │ │ │ │ │ +│ │ ▼ ▼ │ │ +│ │ ┌──────────────────────────────┐ │ │ +│ │ │ SYNC MANAGER │ │ │ +│ │ │ ┌──────────┐ ┌──────────┐ │ │ │ +│ │ │ │ Pending │ │ Delta │ │ │ │ +│ │ │ │ Queue │ │ Tracker │ │ │ │ +│ │ │ └──────────┘ └──────────┘ │ │ │ +│ │ └──────────────┬───────────────┘ │ │ +│ │ │ │ │ +│ └─────────────────────────────────────┼────────────────────────────────────┘ │ +│ │ │ +│ ┌─────────▼─────────┐ │ +│ │ Network Status │ │ +│ │ Detector │ │ +│ └─────────┬─────────┘ │ +│ │ │ +│ ┌──────────────────────────────┴──────────────────────────────┐ │ +│ │ │ │ │ +│ ▼ (offline) │ (online) ▼ │ │ +│ ┌──────────────┐ │ ┌──────────────┐ │ +│ │ Queue Write │ │ │ Execute │ │ +│ │ Operations │ │ │ Sync │ │ +│ └──────────────┘ │ └──────┬───────┘ │ +│ │ │ │ +│ │ ▼ │ +│ │ ┌──────────────────┐ │ +│ │ │ 1. Push pending │ │ +│ │ │ 2. Pull changes │ │ +│ │ │ 3. Resolve │ │ +│ │ │ conflicts │ │ +│ │ │ 4. Update local │ │ +│ │ └────────┬─────────┘ │ +│ │ │ │ +│ │ ▼ │ +│ │ ┌──────────────────┐ │ +│ │ │ Mobile BFF │ │ +│ │ │ API │ │ +│ │ └──────────────────┘ │ +│ │ │ +└────────────────────────────────────────┴────────────────────────────────────────┘ +``` + +--- + +## 9. Arquitectura de CI/CD + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ CI/CD PIPELINE │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ GITHUB ACTIONS │ │ +│ │ │ │ +│ │ on: push to main │ │ +│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ +│ │ │ Lint │►│ Test │►│ Build │►│ Docker │►│ Deploy │ │ │ +│ │ │ │ │ (Jest) │ │ (TypeScript)│ │ Push │ │ K8s │ │ │ +│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ +│ │ │ │ +│ │ on: push to develop │ │ +│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ +│ │ │ Lint │►│ Test │►│ Build │►│ Deploy │ │ │ +│ │ │ │ │ (Jest) │ │ │ │ Staging │ │ │ +│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ MOBILE BUILDS (EAS) │ │ +│ │ │ │ +│ │ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │ │ +│ │ │ Development │ │ Preview │ │ Production │ │ │ +│ │ │ - Internal │ │ - TestFlight │ │ - App Store │ │ │ +│ │ │ - APK │ │ - Play Console │ │ - Play Store │ │ │ +│ │ └──────────────────┘ └──────────────────┘ └──────────────────┘ │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ ENVIRONMENTS │ │ +│ │ │ │ +│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ +│ │ │ Development │ │ Staging │ │ Production │ │ │ +│ │ │ │ │ │ │ │ │ │ +│ │ │ - Local K8s │ │ - GKE small │ │ - GKE prod │ │ │ +│ │ │ - PostgreSQL │ │ - CloudSQL │ │ - CloudSQL │ │ │ +│ │ │ local │ │ dev │ │ prod │ │ │ +│ │ │ - Stripe │ │ - Stripe │ │ - Stripe │ │ │ +│ │ │ test mode │ │ test mode │ │ live mode │ │ │ +│ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 10. Seguridad + +### 10.1 Capas de Seguridad + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ SECURITY LAYERS │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ Layer 1: Network │ +│ ├── Cloudflare WAF (DDoS, Bot protection) │ +│ ├── VPC isolation │ +│ ├── Private subnets for DB │ +│ └── Firewall rules (ingress/egress) │ +│ │ +│ Layer 2: Application │ +│ ├── JWT authentication │ +│ ├── API rate limiting │ +│ ├── Input validation (Zod schemas) │ +│ ├── SQL injection prevention (TypeORM) │ +│ ├── XSS prevention (React escaping) │ +│ └── CSRF tokens │ +│ │ +│ Layer 3: Data │ +│ ├── Row Level Security (RLS) for multi-tenancy │ +│ ├── Encryption at rest (PostgreSQL) │ +│ ├── Encryption in transit (TLS 1.3) │ +│ ├── Secrets in Vault/GCP Secret Manager │ +│ └── PII masking in logs │ +│ │ +│ Layer 4: Compliance │ +│ ├── Audit logging (todas las operaciones) │ +│ ├── Data retention policies │ +│ ├── GDPR/LFPDPPP compliance │ +│ └── SOC2 preparedness │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +### 10.2 Autenticación y Autorización + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ AUTH ARCHITECTURE │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ JWT TOKEN STRUCTURE │ │ +│ │ │ │ +│ │ { │ │ +│ │ "sub": "user_id", │ │ +│ │ "tid": "tenant_id", │ │ +│ │ "roles": ["admin", "operator"], │ │ +│ │ "permissions": ["project:read", "project:write"], │ │ +│ │ "plan": "growth", │ │ +│ │ "exp": 1699999999 │ │ +│ │ } │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ PERMISSION CHECK FLOW │ │ +│ │ │ │ +│ │ Request ──► Extract JWT ──► Validate ──► Set Tenant Context ──► │ │ +│ │ │ │ │ +│ │ Check Permission ◄───┘ │ │ +│ │ │ │ │ +│ │ ┌─────────────┴─────────────┐ │ │ +│ │ ▼ ▼ │ │ +│ │ Allowed Denied │ │ +│ │ │ │ │ │ +│ │ ▼ ▼ │ │ +│ │ Execute Handler Return 403 │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 11. Monitoreo y Observabilidad + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ OBSERVABILITY STACK │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ METRICS │ │ +│ │ │ │ +│ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │ +│ │ │ Prometheus │◄────│ Services │ │ Grafana │ │ │ +│ │ │ │ │ /metrics │ │ │ │ │ +│ │ └─────┬──────┘ └────────────┘ └─────┬──────┘ │ │ +│ │ │ │ │ │ +│ │ └─────────────────────────────────────┘ │ │ +│ │ │ │ +│ │ Key Metrics: │ │ +│ │ - Request latency (p50, p95, p99) │ │ +│ │ - Error rate by endpoint │ │ +│ │ - Active subscriptions │ │ +│ │ - Token usage per tenant │ │ +│ │ - WhatsApp message volume │ │ +│ │ - Queue depth │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ LOGGING │ │ +│ │ │ │ +│ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │ +│ │ │ Loki │◄────│ Promtail │◄────│ Services │ │ │ +│ │ │ │ │ │ │ stdout │ │ │ +│ │ └────────────┘ └────────────┘ └────────────┘ │ │ +│ │ │ │ +│ │ Log Structure: │ │ +│ │ { │ │ +│ │ "timestamp": "...", │ │ +│ │ "level": "info|warn|error", │ │ +│ │ "tenant_id": "...", │ │ +│ │ "user_id": "...", │ │ +│ │ "request_id": "...", │ │ +│ │ "message": "...", │ │ +│ │ "context": {...} │ │ +│ │ } │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ TRACING │ │ +│ │ │ │ +│ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │ +│ │ │ Jaeger │◄────│OpenTelemetry│◄───│ Services │ │ │ +│ │ │ │ │ Collector │ │ │ │ │ +│ │ └────────────┘ └────────────┘ └────────────┘ │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────────────────────────────┐ │ +│ │ ALERTING │ │ +│ │ │ │ +│ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │ +│ │ │ AlertMgr │────►│ Slack │ │ PagerDuty │ │ │ +│ │ │ │────►│ │ │ │ │ │ +│ │ └────────────┘ └────────────┘ └────────────┘ │ │ +│ │ │ │ +│ │ Alert Rules: │ │ +│ │ - Error rate > 1% for 5 min │ │ +│ │ - Latency p95 > 2s for 5 min │ │ +│ │ - Payment failure rate > 5% │ │ +│ │ - Queue depth > 1000 for 10 min │ │ +│ │ - Token usage > 90% of limit │ │ +│ │ │ │ +│ └─────────────────────────────────────────────────────────────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 12. Estimación de Infraestructura + +### 12.1 Recursos por Ambiente + +| Recurso | Development | Staging | Production | +|---------|-------------|---------|------------| +| K8s Nodes | 2 x n1-standard-2 | 3 x n1-standard-4 | 6 x n1-standard-8 | +| PostgreSQL | db-custom-2-4096 | db-custom-4-8192 | db-custom-8-16384 + replica | +| Redis | 1GB | 5GB | 10GB cluster | +| RabbitMQ | 1 node | 1 node | 3 node cluster | +| MinIO/GCS | 10GB | 100GB | 1TB | + +### 12.2 Costo Mensual Estimado (GCP) + +| Componente | Development | Staging | Production | +|------------|-------------|---------|------------| +| GKE Cluster | $100 | $300 | $1,200 | +| Cloud SQL | $50 | $200 | $600 | +| Memorystore (Redis) | $30 | $100 | $300 | +| Cloud Storage | $5 | $20 | $100 | +| Networking | $20 | $50 | $200 | +| Monitoring | $10 | $30 | $100 | +| **Total** | **$215** | **$700** | **$2,500** | + +### 12.3 Costos de Terceros + +| Servicio | Estimado Mensual | +|----------|------------------| +| Stripe fees | 2.9% + $0.30/txn | +| Claude API | ~$500-2,000 (según uso) | +| WhatsApp Business | $0.05-0.15/conversación | +| Firebase (Push) | $25 (Blaze plan) | +| App Store fees | $99/año | +| Play Store fees | $25 (único) | + +--- + +## 13. Próximos Pasos de Implementación + +### Sprint 22: Fundamentos Stripe + +1. **Infraestructura:** + - [ ] Configurar cuenta Stripe Connect + - [ ] Crear webhook endpoint seguro + - [ ] Setup de event logging + +2. **Base de Datos:** + - [ ] Crear tablas stripe_customers, stripe_events + - [ ] Índices para búsqueda rápida + +3. **Backend:** + - [ ] StripeService con métodos base + - [ ] StripeWebhookController + - [ ] Signature verification middleware + +4. **Testing:** + - [ ] Tests con Stripe CLI + - [ ] Webhook retry simulation + +--- + +**Creado por:** Requirements-Analyst +**Fecha:** 2025-12-05 +**Versión:** 1.0 diff --git a/docs/02-especificaciones-tecnicas/saas-platform/roadmap/ROADMAP-EPICAS-SAAS.md b/docs/02-especificaciones-tecnicas/saas-platform/roadmap/ROADMAP-EPICAS-SAAS.md new file mode 100644 index 0000000..150f9e0 --- /dev/null +++ b/docs/02-especificaciones-tecnicas/saas-platform/roadmap/ROADMAP-EPICAS-SAAS.md @@ -0,0 +1,318 @@ +# Roadmap Épicas SaaS Platform - ERP Suite + +## Resumen Ejecutivo + +| Épica | SP | Sprints | Dependencias | Prioridad | +|-------|-----|---------|--------------|-----------| +| EPIC-MGN-017 Stripe | 34 | 22-24 | MGN-016 Billing | P0 - Base | +| EPIC-MGN-021 AI Tokens | 26 | 24-26 | MGN-016, MGN-017 | P0 | +| EPIC-MGN-020 Onboarding | 42 | 23-25 | MGN-017, MGN-004 | P0 | +| EPIC-MGN-018 WhatsApp | 55 | 25-28 | MGN-017, MGN-001, MGN-021 | P1 | +| EPIC-MGN-019 Mobile Apps | 89 | 29-36 | MGN-001, APIs verticales | P1 | + +**Total Story Points:** 246 SP +**Duración Estimada:** 15 Sprints (Sprint 22-36) + +--- + +## Grafo de Dependencias + +``` + ┌─────────────────┐ + │ MGN-016 │ + │ Billing │ + │ (EXISTENTE) │ + └────────┬────────┘ + │ + ┌────────▼────────┐ + │ MGN-017 │ + │ Stripe │◄──── PUNTO DE INICIO + │ 34 SP │ + └────────┬────────┘ + │ + ┌─────────────────┼─────────────────┐ + │ │ │ + ┌────────▼────────┐ ┌──────▼───────┐ ┌──────▼───────┐ + │ MGN-020 │ │ MGN-021 │ │ MGN-001 │ + │ Onboarding │ │ AI Tokens │ │ Auth │ + │ 42 SP │ │ 26 SP │ │ (EXISTENTE) │ + └────────┬────────┘ └──────┬───────┘ └──────┬───────┘ + │ │ │ + │ │ │ + │ ┌──────▼───────┐ │ + │ │ MGN-018 │ │ + └─────────►│ WhatsApp │◄────────┘ + │ 55 SP │ + └──────┬───────┘ + │ + ┌──────▼───────┐ + │ MGN-019 │ + │ Mobile Apps │ + │ 89 SP │ + └──────────────┘ +``` + +--- + +## Fase 1: Fundamentos de Cobro (Sprint 22-24) + +### EPIC-MGN-017: Stripe Integration + +**Objetivo:** Establecer la infraestructura de cobros automatizados. + +| Sprint | Entregables | SP | +|--------|-------------|-----| +| 22 | US-001: Vincular cuenta Stripe | 3 | +| 22 | US-002: Agregar tarjeta de crédito | 5 | +| 23 | US-003: Crear suscripción al activar tenant | 5 | +| 23 | US-004: Actualizar cantidad de usuarios | 5 | +| 24 | US-005: Procesar webhooks | 8 | +| 24 | US-006: Manejar pagos fallidos | 5 | +| 24 | US-007: Portal de facturación | 3 | + +**Criterios de Salida:** +- [ ] Flujo completo de suscripción funcionando +- [ ] Webhooks procesando eventos en tiempo real +- [ ] Dunning (cobro de deuda) automatizado +- [ ] Tests de integración con Stripe Test Mode + +**Riesgos:** +- Complejidad de webhooks de Stripe +- Manejo de edge cases en prorratas + +--- + +## Fase 2: Control de IA y Onboarding (Sprint 24-26) + +### EPIC-MGN-021: Control de Tokens IA + +**Objetivo:** Sistema de medición y facturación de uso de IA. + +| Sprint | Entregables | SP | +|--------|-------------|-----| +| 24 | US-001: Registrar tokens por llamada | 5 | +| 24 | US-006: Configurar precios de tokens | 3 | +| 25 | US-002: Dashboard de consumo | 3 | +| 25 | US-003: Validar límites antes de ejecutar | 5 | +| 25 | US-004: Alertas de consumo alto | 3 | +| 26 | US-005: Calcular costo en factura | 5 | +| 26 | US-007: Comprar paquetes adicionales | 3 | + +**Criterios de Salida:** +- [ ] Tracking de tokens en tiempo real +- [ ] Límites por plan aplicados +- [ ] Alertas configurables funcionando +- [ ] Línea de tokens en facturas Stripe + +### EPIC-MGN-020: Onboarding (Sprint 23-25) + +**Objetivo:** Gestión del proceso de implementación y cobro de servicios profesionales. + +| Sprint | Entregables | SP | +|--------|-------------|-----| +| 23 | US-001: Registrar prospecto | 3 | +| 23 | US-002: Levantamiento de requerimientos | 5 | +| 24 | US-003: Generar cotización | 5 | +| 24 | US-004: Aceptar y pagar anticipo | 5 | +| 24 | US-010: Crear tenant al aprobar | 3 | +| 25 | US-005: Checklist de configuración | 5 | +| 25 | US-006: Marcar tareas completadas | 3 | +| 25 | US-007: Documentar progreso | 3 | +| 25 | US-008: Cobrar pagos por hitos | 5 | +| 25 | US-009: Dashboard de proyectos | 5 | + +**Criterios de Salida:** +- [ ] Flujo completo de prospecto a tenant activo +- [ ] Templates de cotización por vertical +- [ ] Checklists de implementación +- [ ] Cobros parciales via Stripe + +--- + +## Fase 3: Comunicación con IA (Sprint 25-28) + +### EPIC-MGN-018: WhatsApp Business + Agente IA + +**Objetivo:** Atención automatizada 24/7 via WhatsApp. + +| Sprint | Entregables | SP | +|--------|-------------|-----| +| 25 | US-001: Conectar número WhatsApp | 5 | +| 25 | US-002: Recibir mensajes via webhook | 5 | +| 26 | US-003: Identificar usuario por teléfono | 3 | +| 26 | US-004: Enviar mensajes de respuesta | 5 | +| 26 | US-011: Registrar tokens IA usados | 3 | +| 27 | US-005: Consultar información ERP | 8 | +| 27 | US-006: Crear registros via WA | 8 | +| 28 | US-007: Notificaciones proactivas | 5 | +| 28 | US-008: Historial de conversaciones | 5 | +| 28 | US-009: Escalar a humano | 5 | +| 28 | US-010: Métricas de uso | 3 | + +**Criterios de Salida:** +- [ ] Integración Meta Cloud API funcionando +- [ ] Agente IA procesando intents +- [ ] Validación de permisos por usuario +- [ ] Tokens contabilizados y facturados +- [ ] Escalamiento a humano funcionando + +**Riesgos:** +- Políticas de Meta para WhatsApp Business +- Latencia en respuestas de IA +- Costo de tokens puede escalar rápido + +--- + +## Fase 4: Plataforma Móvil (Sprint 29-36) + +### EPIC-MGN-019: Apps Móviles por Perfil + +**Objetivo:** Digitalizar operaciones en campo con apps especializadas. + +#### Sub-Fase 4.1: Core + App Encargado Obra (Sprint 29-32) + +| Sprint | Entregables | SP | +|--------|-------------|-----| +| 29 | Core: Auth package | 3 | +| 29 | Core: API package | 5 | +| 30 | Core: Storage package (WatermelonDB) | 5 | +| 30 | Core: Sync package | 5 | +| 31 | Biometrics: Facial recognition | 8 | +| 31 | Biometrics: Fingerprint | 5 | +| 32 | Camera: Fotos geolocalizadas | 5 | +| 32 | Push: Notificaciones | 3 | +| 32 | App Encargado: UI específica | 8 | + +**Entregable:** App Encargado de Obra funcional (21 SP de features específicas + 37 SP core) + +#### Sub-Fase 4.2: Apps Construcción (Sprint 33-34) + +| Sprint | Entregables | SP | +|--------|-------------|-----| +| 33 | App Almacén: Entradas/salidas | 8 | +| 33 | App Almacén: Inventario offline | 5 | +| 34 | App Derechohabiente: Estado vivienda | 8 | +| 34 | App Derechohabiente: Citas/documentos | 5 | + +**Entregable:** Apps Almacén y Derechohabiente funcionales + +#### Sub-Fase 4.3: Apps Otras Verticales (Sprint 35-36) + +| Sprint | Entregables | SP | +|--------|-------------|-----| +| 35 | App Producción Vidrio | 13 | +| 36 | App Técnico Mecánicas | 13 | + +**Entregable:** Apps para Vidrio Templado y Mecánicas + +**Criterios de Salida Fase 4:** +- [ ] 7 apps publicadas en App Store y Play Store +- [ ] Reconocimiento facial con liveness detection +- [ ] Modo offline completo +- [ ] Sincronización automática + +--- + +## Timeline Visual + +``` +Sprint: 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +MGN-017 ████████████████ +Stripe [========34 SP========] + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +MGN-021 │ ████████████████ +AI Tokens │ [=====26 SP=====] + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +MGN-020 ██████████████████ +Onboard │ [=======42 SP=======] + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +MGN-018 ████████████████████████ +WhatsApp [=========55 SP=========] + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +MGN-019 ████████████████████████████████ +Mobile [=============89 SP=============] + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ +``` + +--- + +## Hitos Principales + +| Hito | Sprint | Entregable | Impacto de Negocio | +|------|--------|------------|-------------------| +| H1 | 24 | Cobros Stripe funcionando | Inicio de facturación automática | +| H2 | 25 | Onboarding operativo | Venta de implementaciones | +| H3 | 26 | Control de tokens IA | Monetización de IA | +| H4 | 28 | WhatsApp + Agente IA | Atención 24/7 | +| H5 | 32 | Primera app móvil | Operación en campo | +| H6 | 36 | Suite móvil completa | Digitalización total | + +--- + +## Recursos Requeridos + +### Equipo Backend +- 2 desarrolladores senior (Stripe, WhatsApp integrations) +- 1 desarrollador mid (Token tracking, billing logic) + +### Equipo Frontend/Mobile +- 2 desarrolladores React Native senior +- 1 desarrollador mid (UI components) + +### DevOps +- 1 ingeniero (infraestructura, CI/CD para apps) + +### IA/ML +- 1 especialista en integraciones LLM + +### Total: 7-8 desarrolladores por 15 sprints + +--- + +## Métricas de Éxito + +| Métrica | Target Sprint 24 | Target Sprint 28 | Target Sprint 36 | +|---------|-----------------|-----------------|-----------------| +| Tenants con Stripe activo | 10 | 50 | 200 | +| Revenue mensual suscripciones | $50K MXN | $200K MXN | $500K MXN | +| Implementaciones vendidas | 5 | 20 | 50 | +| Revenue implementaciones | $200K MXN | $800K MXN | $2M MXN | +| Conversaciones WA/día | - | 100 | 1,000 | +| Apps instaladas | - | - | 500 | + +--- + +## Riesgos y Mitigaciones + +| Riesgo | Probabilidad | Impacto | Mitigación | +|--------|--------------|---------|------------| +| Retrasos en aprobación de Meta WA Business | Media | Alto | Iniciar proceso de verificación en Sprint 24 | +| Costos de IA mayores a proyectados | Media | Medio | Límites estrictos por plan, alertas tempranas | +| Complejidad de sincronización offline | Alta | Alto | Usar WatermelonDB probado, diseñar conflictos desde inicio | +| Rechazo en App Stores | Baja | Alto | Guidelines review pre-submit, beta testing | +| Stripe compliance en México | Baja | Alto | Consultar con Stripe México desde Sprint 22 | + +--- + +## Próximos Pasos Inmediatos + +1. **Sprint 22 - Semana 1:** + - [ ] Configurar cuenta Stripe Connect + - [ ] Crear productos y precios en Stripe Dashboard + - [ ] Implementar StripeService básico + +2. **Sprint 22 - Semana 2:** + - [ ] Endpoint de vinculación de Customer + - [ ] Stripe Elements para tarjetas + - [ ] Tests de integración + +3. **Paralelo:** + - [ ] Iniciar verificación WhatsApp Business con Meta + - [ ] Setup de proyecto React Native monorepo + +--- + +**Creado por:** Requirements-Analyst +**Fecha:** 2025-12-05 +**Versión:** 1.0 diff --git a/docs/02-especificaciones-tecnicas/saas-platform/stripe/SPEC-STRIPE-INTEGRATION.md b/docs/02-especificaciones-tecnicas/saas-platform/stripe/SPEC-STRIPE-INTEGRATION.md new file mode 100644 index 0000000..2ce0233 --- /dev/null +++ b/docs/02-especificaciones-tecnicas/saas-platform/stripe/SPEC-STRIPE-INTEGRATION.md @@ -0,0 +1,1799 @@ +# Especificación Técnica: EPIC-MGN-017 - Integración Stripe + +## 1. Resumen + +| Campo | Valor | +|-------|-------| +| **Épica** | EPIC-MGN-017 | +| **Módulo** | billing | +| **Story Points** | 34 SP | +| **Sprints** | 22-24 | +| **Dependencias** | MGN-016 Billing, MGN-004 Tenants | + +--- + +## 2. Modelo de Datos + +### 2.1 Diagrama ER + +``` +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ STRIPE INTEGRATION SCHEMA │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌──────────────────────┐ ┌──────────────────────┐ │ +│ │ core_tenants. │ │ billing.plans │ │ +│ │ tenants │ │ │ │ +│ │ ───────────────── │ │ ───────────────── │ │ +│ │ id │◄───┐ │ id │ │ +│ │ name │ │ │ name │ │ +│ │ status │ │ │ stripe_product_id │◄────────┐ │ +│ │ plan_id ───────────┼────┼────► stripe_price_id │ │ │ +│ └──────────────────────┘ │ │ price_per_user │ │ │ +│ │ │ features │ │ │ +│ │ └──────────────────────┘ │ │ +│ │ │ │ +│ ┌──────────────────────┐ │ ┌──────────────────────┐ │ │ +│ │ billing.stripe_ │ │ │ billing. │ │ │ +│ │ customers │ │ │ subscriptions │ │ │ +│ │ ───────────────── │ │ │ ───────────────── │ │ │ +│ │ id │ │ │ id │ │ │ +│ │ tenant_id ─────────┼────┘ │ tenant_id │ │ │ +│ │ stripe_customer_id │◄────────┤ stripe_subscription_id │ │ +│ │ email │ │ stripe_price_id ────┼─────────┘ │ +│ │ payment_method_id │ │ quantity │ │ +│ │ default_source │ │ status │ │ +│ │ created_at │ │ current_period_start│ │ +│ │ updated_at │ │ current_period_end │ │ +│ └──────────────────────┘ │ cancel_at_period_end│ │ +│ └──────────────────────┘ │ +│ │ +│ ┌──────────────────────┐ ┌──────────────────────┐ │ +│ │ billing.stripe_ │ │ billing. │ │ +│ │ webhook_events │ │ payment_methods │ │ +│ │ ───────────────── │ │ ───────────────── │ │ +│ │ id │ │ id │ │ +│ │ stripe_event_id │ │ tenant_id │ │ +│ │ event_type │ │ stripe_pm_id │ │ +│ │ payload │ │ type (card/bank) │ │ +│ │ processed │ │ last_four │ │ +│ │ processed_at │ │ brand │ │ +│ │ error │ │ exp_month │ │ +│ │ created_at │ │ exp_year │ │ +│ └──────────────────────┘ │ is_default │ │ +│ └──────────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +``` + +### 2.2 DDL + +```sql +-- ============================================================================ +-- STRIPE INTEGRATION TABLES +-- Schema: billing +-- ============================================================================ + +-- Stripe Customers (1:1 con tenants) +CREATE TABLE billing.stripe_customers ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL UNIQUE REFERENCES core_tenants.tenants(id) ON DELETE RESTRICT, + + -- Stripe IDs + stripe_customer_id VARCHAR(50) NOT NULL UNIQUE, + + -- Customer info (cached from Stripe) + email VARCHAR(255), + name VARCHAR(255), + phone VARCHAR(50), + + -- Default payment method + default_payment_method_id VARCHAR(50), + + -- Billing address (for invoices) + billing_address JSONB, + -- { + -- "line1": "Calle 123", + -- "line2": "Col. Centro", + -- "city": "CDMX", + -- "state": "CDMX", + -- "postal_code": "06600", + -- "country": "MX" + -- } + + -- Tax info + tax_id VARCHAR(20), -- RFC en México + tax_exempt VARCHAR(20) DEFAULT 'none', -- none, exempt, reverse + + -- Metadata + metadata JSONB DEFAULT '{}', + + -- Timestamps + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT valid_stripe_customer_id CHECK (stripe_customer_id ~ '^cus_[a-zA-Z0-9]+$') +); + +-- Índices +CREATE INDEX idx_stripe_customers_stripe_id ON billing.stripe_customers(stripe_customer_id); +CREATE INDEX idx_stripe_customers_email ON billing.stripe_customers(email); + +-- Payment Methods +CREATE TABLE billing.payment_methods ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES core_tenants.tenants(id) ON DELETE CASCADE, + stripe_customer_id UUID NOT NULL REFERENCES billing.stripe_customers(id) ON DELETE CASCADE, + + -- Stripe IDs + stripe_pm_id VARCHAR(50) NOT NULL UNIQUE, + + -- Type + type VARCHAR(20) NOT NULL, -- card, bank_transfer, oxxo + + -- Card details (if type = card) + card_brand VARCHAR(20), -- visa, mastercard, amex + card_last_four VARCHAR(4), + card_exp_month SMALLINT, + card_exp_year SMALLINT, + card_funding VARCHAR(20), -- credit, debit, prepaid + + -- Bank details (if type = bank_transfer) + bank_name VARCHAR(100), + bank_last_four VARCHAR(4), + + -- Status + is_default BOOLEAN DEFAULT false, + is_valid BOOLEAN DEFAULT true, + + -- Timestamps + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT valid_stripe_pm_id CHECK (stripe_pm_id ~ '^pm_[a-zA-Z0-9]+$') +); + +-- Índices +CREATE INDEX idx_payment_methods_tenant ON billing.payment_methods(tenant_id); +CREATE INDEX idx_payment_methods_stripe_pm ON billing.payment_methods(stripe_pm_id); +CREATE INDEX idx_payment_methods_default ON billing.payment_methods(tenant_id) WHERE is_default = true; + +-- Trigger para un solo default por tenant +CREATE OR REPLACE FUNCTION billing.ensure_single_default_payment_method() +RETURNS TRIGGER AS $$ +BEGIN + IF NEW.is_default = true THEN + UPDATE billing.payment_methods + SET is_default = false + WHERE tenant_id = NEW.tenant_id + AND id != NEW.id + AND is_default = true; + END IF; + RETURN NEW; +END; +$$ LANGUAGE plpgsql; + +CREATE TRIGGER trg_single_default_payment_method + BEFORE INSERT OR UPDATE ON billing.payment_methods + FOR EACH ROW + EXECUTE FUNCTION billing.ensure_single_default_payment_method(); + +-- Webhook Events (idempotency) +CREATE TABLE billing.stripe_webhook_events ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + + -- Stripe event info + stripe_event_id VARCHAR(50) NOT NULL UNIQUE, + event_type VARCHAR(100) NOT NULL, + api_version VARCHAR(20), + + -- Related entities + tenant_id UUID REFERENCES core_tenants.tenants(id), + stripe_customer_id VARCHAR(50), + stripe_subscription_id VARCHAR(50), + stripe_invoice_id VARCHAR(50), + stripe_payment_intent_id VARCHAR(50), + + -- Payload + payload JSONB NOT NULL, + + -- Processing status + status VARCHAR(20) DEFAULT 'pending', -- pending, processing, processed, failed + processed_at TIMESTAMPTZ, + error_message TEXT, + retry_count INT DEFAULT 0, + + -- Timestamps + created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT valid_stripe_event_id CHECK (stripe_event_id ~ '^evt_[a-zA-Z0-9]+$'), + CONSTRAINT valid_status CHECK (status IN ('pending', 'processing', 'processed', 'failed')) +); + +-- Índices para procesamiento de webhooks +CREATE INDEX idx_webhook_events_stripe_id ON billing.stripe_webhook_events(stripe_event_id); +CREATE INDEX idx_webhook_events_type ON billing.stripe_webhook_events(event_type); +CREATE INDEX idx_webhook_events_status ON billing.stripe_webhook_events(status) WHERE status != 'processed'; +CREATE INDEX idx_webhook_events_created ON billing.stripe_webhook_events(created_at); +CREATE INDEX idx_webhook_events_tenant ON billing.stripe_webhook_events(tenant_id); + +-- Extender tabla subscriptions existente +ALTER TABLE billing.subscriptions ADD COLUMN IF NOT EXISTS stripe_subscription_id VARCHAR(50) UNIQUE; +ALTER TABLE billing.subscriptions ADD COLUMN IF NOT EXISTS stripe_price_id VARCHAR(50); +ALTER TABLE billing.subscriptions ADD COLUMN IF NOT EXISTS stripe_status VARCHAR(30); +ALTER TABLE billing.subscriptions ADD COLUMN IF NOT EXISTS cancel_at_period_end BOOLEAN DEFAULT false; +ALTER TABLE billing.subscriptions ADD COLUMN IF NOT EXISTS canceled_at TIMESTAMPTZ; +ALTER TABLE billing.subscriptions ADD COLUMN IF NOT EXISTS trial_end TIMESTAMPTZ; + +CREATE INDEX idx_subscriptions_stripe_id ON billing.subscriptions(stripe_subscription_id); + +-- Extender tabla plans con Stripe IDs +ALTER TABLE billing.plans ADD COLUMN IF NOT EXISTS stripe_product_id VARCHAR(50); +ALTER TABLE billing.plans ADD COLUMN IF NOT EXISTS stripe_price_id VARCHAR(50); +ALTER TABLE billing.plans ADD COLUMN IF NOT EXISTS stripe_price_id_yearly VARCHAR(50); + +-- Extender tabla invoices con Stripe IDs +ALTER TABLE billing.invoices ADD COLUMN IF NOT EXISTS stripe_invoice_id VARCHAR(50) UNIQUE; +ALTER TABLE billing.invoices ADD COLUMN IF NOT EXISTS stripe_payment_intent_id VARCHAR(50); +ALTER TABLE billing.invoices ADD COLUMN IF NOT EXISTS stripe_hosted_invoice_url TEXT; +ALTER TABLE billing.invoices ADD COLUMN IF NOT EXISTS stripe_pdf_url TEXT; + +CREATE INDEX idx_invoices_stripe_id ON billing.invoices(stripe_invoice_id); + +-- Vista para estado de suscripción Stripe +CREATE OR REPLACE VIEW billing.vw_stripe_subscription_status AS +SELECT + t.id AS tenant_id, + t.name AS tenant_name, + sc.stripe_customer_id, + s.stripe_subscription_id, + s.stripe_status, + s.quantity AS user_count, + p.name AS plan_name, + p.price_per_user, + (s.quantity * p.price_per_user) AS monthly_amount, + s.current_period_start, + s.current_period_end, + s.cancel_at_period_end, + pm.card_brand, + pm.card_last_four +FROM core_tenants.tenants t +JOIN billing.stripe_customers sc ON sc.tenant_id = t.id +LEFT JOIN billing.subscriptions s ON s.tenant_id = t.id AND s.status = 'active' +LEFT JOIN billing.plans p ON p.id = s.plan_id +LEFT JOIN billing.payment_methods pm ON pm.tenant_id = t.id AND pm.is_default = true; +``` + +--- + +## 3. API Endpoints + +### 3.1 Stripe Customer Management + +```typescript +// ============================================================================ +// CUSTOMER ENDPOINTS +// Base: /api/v1/billing/stripe +// ============================================================================ + +/** + * POST /api/v1/billing/stripe/customers + * Crear Stripe Customer para el tenant actual + * + * Permisos: billing:manage + */ +interface CreateStripeCustomerRequest { + email: string; + name?: string; + phone?: string; + tax_id?: string; // RFC + billing_address?: { + line1: string; + line2?: string; + city: string; + state: string; + postal_code: string; + country: string; // Default: MX + }; +} + +interface CreateStripeCustomerResponse { + id: string; + stripe_customer_id: string; + email: string; + created_at: string; +} + +/** + * GET /api/v1/billing/stripe/customers/current + * Obtener Stripe Customer del tenant actual + * + * Permisos: billing:read + */ +interface GetCurrentCustomerResponse { + id: string; + stripe_customer_id: string; + email: string; + name?: string; + default_payment_method?: PaymentMethodSummary; + subscription?: SubscriptionSummary; +} + +/** + * PATCH /api/v1/billing/stripe/customers/current + * Actualizar datos del customer + * + * Permisos: billing:manage + */ +interface UpdateStripeCustomerRequest { + email?: string; + name?: string; + phone?: string; + tax_id?: string; + billing_address?: BillingAddress; +} +``` + +### 3.2 Payment Methods + +```typescript +// ============================================================================ +// PAYMENT METHODS ENDPOINTS +// Base: /api/v1/billing/stripe/payment-methods +// ============================================================================ + +/** + * POST /api/v1/billing/stripe/payment-methods/setup-intent + * Crear SetupIntent para agregar nueva tarjeta via Stripe Elements + * + * Permisos: billing:manage + */ +interface CreateSetupIntentResponse { + client_secret: string; + setup_intent_id: string; +} + +/** + * POST /api/v1/billing/stripe/payment-methods + * Confirmar y guardar payment method después del SetupIntent + * + * Permisos: billing:manage + */ +interface AttachPaymentMethodRequest { + payment_method_id: string; // pm_xxx del frontend + set_as_default?: boolean; +} + +interface AttachPaymentMethodResponse { + id: string; + stripe_pm_id: string; + type: 'card' | 'bank_transfer'; + card_brand?: string; + card_last_four?: string; + is_default: boolean; +} + +/** + * GET /api/v1/billing/stripe/payment-methods + * Listar payment methods del tenant + * + * Permisos: billing:read + */ +interface ListPaymentMethodsResponse { + data: PaymentMethod[]; + default_payment_method_id?: string; +} + +interface PaymentMethod { + id: string; + stripe_pm_id: string; + type: 'card' | 'bank_transfer'; + card_brand?: string; + card_last_four?: string; + card_exp_month?: number; + card_exp_year?: number; + is_default: boolean; + created_at: string; +} + +/** + * DELETE /api/v1/billing/stripe/payment-methods/:id + * Eliminar payment method + * + * Permisos: billing:manage + */ + +/** + * POST /api/v1/billing/stripe/payment-methods/:id/set-default + * Establecer como default + * + * Permisos: billing:manage + */ +``` + +### 3.3 Subscriptions + +```typescript +// ============================================================================ +// SUBSCRIPTION ENDPOINTS +// Base: /api/v1/billing/stripe/subscriptions +// ============================================================================ + +/** + * POST /api/v1/billing/stripe/subscriptions + * Crear nueva suscripción + * + * Permisos: billing:manage + */ +interface CreateSubscriptionRequest { + plan_id: string; // UUID del plan en nuestro sistema + payment_method_id?: string; // Si no se provee, usa default + quantity?: number; // Número de usuarios (default: usuarios activos) + coupon_code?: string; // Código de descuento +} + +interface CreateSubscriptionResponse { + id: string; + stripe_subscription_id: string; + status: 'active' | 'trialing' | 'past_due' | 'incomplete'; + current_period_start: string; + current_period_end: string; + plan: { + id: string; + name: string; + price_per_user: number; + }; + quantity: number; + total_amount: number; + // Si requiere acción adicional (3DS) + requires_action?: boolean; + client_secret?: string; +} + +/** + * GET /api/v1/billing/stripe/subscriptions/current + * Obtener suscripción activa + * + * Permisos: billing:read + */ +interface GetCurrentSubscriptionResponse { + id: string; + stripe_subscription_id: string; + status: SubscriptionStatus; + plan: PlanSummary; + quantity: number; + current_period_start: string; + current_period_end: string; + cancel_at_period_end: boolean; + trial_end?: string; + next_invoice?: { + amount: number; + date: string; + }; +} + +/** + * PATCH /api/v1/billing/stripe/subscriptions/current + * Actualizar suscripción (cambiar plan, quantity) + * + * Permisos: billing:manage + */ +interface UpdateSubscriptionRequest { + plan_id?: string; // Upgrade/downgrade + quantity?: number; // Ajuste manual de usuarios +} + +interface UpdateSubscriptionResponse { + id: string; + status: string; + proration_amount?: number; // Monto de prorrata + effective_date: string; +} + +/** + * POST /api/v1/billing/stripe/subscriptions/current/cancel + * Cancelar suscripción (al final del período) + * + * Permisos: billing:manage + */ +interface CancelSubscriptionRequest { + reason?: string; + feedback?: string; + cancel_immediately?: boolean; // Default: false (cancela al final del período) +} + +interface CancelSubscriptionResponse { + status: 'canceled' | 'cancel_scheduled'; + cancel_at: string; + effective_date: string; +} + +/** + * POST /api/v1/billing/stripe/subscriptions/current/reactivate + * Reactivar suscripción cancelada (antes de que expire) + * + * Permisos: billing:manage + */ +``` + +### 3.4 Invoices + +```typescript +// ============================================================================ +// INVOICE ENDPOINTS +// Base: /api/v1/billing/stripe/invoices +// ============================================================================ + +/** + * GET /api/v1/billing/stripe/invoices + * Listar facturas del tenant + * + * Permisos: billing:read + */ +interface ListInvoicesRequest { + page?: number; + limit?: number; // Default: 10, max: 100 + status?: 'draft' | 'open' | 'paid' | 'void' | 'uncollectible'; + from_date?: string; // ISO date + to_date?: string; +} + +interface ListInvoicesResponse { + data: Invoice[]; + pagination: { + page: number; + limit: number; + total: number; + total_pages: number; + }; +} + +interface Invoice { + id: string; + stripe_invoice_id: string; + number: string; + status: InvoiceStatus; + amount_due: number; + amount_paid: number; + currency: string; + period_start: string; + period_end: string; + due_date?: string; + paid_at?: string; + hosted_invoice_url: string; + pdf_url: string; + lines: InvoiceLine[]; +} + +interface InvoiceLine { + description: string; + quantity: number; + unit_amount: number; + amount: number; + period?: { + start: string; + end: string; + }; +} + +/** + * GET /api/v1/billing/stripe/invoices/:id + * Obtener detalle de factura + * + * Permisos: billing:read + */ + +/** + * POST /api/v1/billing/stripe/invoices/:id/pay + * Reintentar pago de factura pendiente + * + * Permisos: billing:manage + */ +interface PayInvoiceRequest { + payment_method_id?: string; // Opcional, usa default si no se provee +} +``` + +### 3.5 Billing Portal + +```typescript +// ============================================================================ +// BILLING PORTAL ENDPOINTS +// Base: /api/v1/billing/stripe/portal +// ============================================================================ + +/** + * POST /api/v1/billing/stripe/portal/session + * Crear sesión de Stripe Customer Portal + * + * Permisos: billing:manage + */ +interface CreatePortalSessionRequest { + return_url: string; // URL a donde regresar después del portal +} + +interface CreatePortalSessionResponse { + url: string; // URL del Customer Portal +} +``` + +### 3.6 Webhooks + +```typescript +// ============================================================================ +// WEBHOOK ENDPOINT +// Base: /webhooks/stripe +// ============================================================================ + +/** + * POST /webhooks/stripe + * Recibir eventos de Stripe + * + * Headers requeridos: + * - Stripe-Signature: firma del evento + * + * Sin autenticación (usa verificación de firma) + */ + +// Eventos manejados: +const HANDLED_EVENTS = [ + // Subscriptions + 'customer.subscription.created', + 'customer.subscription.updated', + 'customer.subscription.deleted', + 'customer.subscription.trial_will_end', + + // Invoices + 'invoice.created', + 'invoice.finalized', + 'invoice.paid', + 'invoice.payment_failed', + 'invoice.payment_action_required', + 'invoice.upcoming', + + // Payments + 'payment_intent.succeeded', + 'payment_intent.payment_failed', + 'payment_intent.requires_action', + + // Payment Methods + 'payment_method.attached', + 'payment_method.detached', + 'payment_method.updated', + + // Customer + 'customer.updated', + 'customer.deleted', + + // Charges (para disputas) + 'charge.dispute.created', + 'charge.refunded', +]; +``` + +--- + +## 4. Servicios Backend + +### 4.1 StripeService + +```typescript +// src/modules/billing/services/stripe.service.ts + +import Stripe from 'stripe'; +import { Injectable } from '@nestjs/common'; +import { ConfigService } from '@nestjs/config'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository } from 'typeorm'; + +@Injectable() +export class StripeService { + private stripe: Stripe; + + constructor( + private configService: ConfigService, + @InjectRepository(StripeCustomer) + private customerRepo: Repository, + @InjectRepository(PaymentMethod) + private paymentMethodRepo: Repository, + @InjectRepository(Subscription) + private subscriptionRepo: Repository, + ) { + this.stripe = new Stripe( + this.configService.get('STRIPE_SECRET_KEY'), + { apiVersion: '2023-10-16' } + ); + } + + // ======================================== + // CUSTOMER MANAGEMENT + // ======================================== + + async createCustomer(tenantId: string, data: CreateCustomerDto): Promise { + // 1. Verificar que no exista + const existing = await this.customerRepo.findOne({ where: { tenantId } }); + if (existing) { + throw new ConflictException('Stripe customer already exists for this tenant'); + } + + // 2. Crear en Stripe + const stripeCustomer = await this.stripe.customers.create({ + email: data.email, + name: data.name, + phone: data.phone, + metadata: { + tenant_id: tenantId, + environment: this.configService.get('NODE_ENV'), + }, + address: data.billing_address ? { + line1: data.billing_address.line1, + line2: data.billing_address.line2, + city: data.billing_address.city, + state: data.billing_address.state, + postal_code: data.billing_address.postal_code, + country: data.billing_address.country || 'MX', + } : undefined, + tax_id_data: data.tax_id ? [{ + type: 'mx_rfc', + value: data.tax_id, + }] : undefined, + }); + + // 3. Guardar en DB local + const customer = this.customerRepo.create({ + tenantId, + stripeCustomerId: stripeCustomer.id, + email: data.email, + name: data.name, + phone: data.phone, + taxId: data.tax_id, + billingAddress: data.billing_address, + }); + + return this.customerRepo.save(customer); + } + + async getCustomerByTenantId(tenantId: string): Promise { + return this.customerRepo.findOne({ + where: { tenantId }, + relations: ['paymentMethods'], + }); + } + + // ======================================== + // PAYMENT METHODS + // ======================================== + + async createSetupIntent(tenantId: string): Promise { + const customer = await this.getCustomerByTenantId(tenantId); + if (!customer) { + throw new NotFoundException('Stripe customer not found'); + } + + return this.stripe.setupIntents.create({ + customer: customer.stripeCustomerId, + payment_method_types: ['card'], + usage: 'off_session', // Para cobros recurrentes + }); + } + + async attachPaymentMethod( + tenantId: string, + paymentMethodId: string, + setAsDefault: boolean = false, + ): Promise { + const customer = await this.getCustomerByTenantId(tenantId); + if (!customer) { + throw new NotFoundException('Stripe customer not found'); + } + + // 1. Adjuntar a customer en Stripe + const stripepm = await this.stripe.paymentMethods.attach(paymentMethodId, { + customer: customer.stripeCustomerId, + }); + + // 2. Si es default, actualizar en Stripe + if (setAsDefault) { + await this.stripe.customers.update(customer.stripeCustomerId, { + invoice_settings: { + default_payment_method: paymentMethodId, + }, + }); + } + + // 3. Guardar en DB local + const paymentMethod = this.paymentMethodRepo.create({ + tenantId, + stripeCustomerId: customer.id, + stripePmId: stripepm.id, + type: stripepm.type, + cardBrand: stripepm.card?.brand, + cardLastFour: stripepm.card?.last4, + cardExpMonth: stripepm.card?.exp_month, + cardExpYear: stripepm.card?.exp_year, + cardFunding: stripepm.card?.funding, + isDefault: setAsDefault, + }); + + return this.paymentMethodRepo.save(paymentMethod); + } + + async listPaymentMethods(tenantId: string): Promise { + return this.paymentMethodRepo.find({ + where: { tenantId }, + order: { isDefault: 'DESC', createdAt: 'DESC' }, + }); + } + + async deletePaymentMethod(tenantId: string, paymentMethodId: string): Promise { + const pm = await this.paymentMethodRepo.findOne({ + where: { id: paymentMethodId, tenantId }, + }); + + if (!pm) { + throw new NotFoundException('Payment method not found'); + } + + if (pm.isDefault) { + throw new BadRequestException('Cannot delete default payment method'); + } + + // Detach de Stripe + await this.stripe.paymentMethods.detach(pm.stripePmId); + + // Eliminar de DB + await this.paymentMethodRepo.remove(pm); + } + + // ======================================== + // SUBSCRIPTIONS + // ======================================== + + async createSubscription( + tenantId: string, + planId: string, + quantity?: number, + paymentMethodId?: string, + ): Promise { + const customer = await this.getCustomerByTenantId(tenantId); + if (!customer) { + throw new NotFoundException('Stripe customer not found'); + } + + // Obtener plan con Stripe price ID + const plan = await this.planRepo.findOne({ where: { id: planId } }); + if (!plan || !plan.stripePriceId) { + throw new NotFoundException('Plan not found or not configured in Stripe'); + } + + // Contar usuarios activos si no se provee quantity + if (!quantity) { + quantity = await this.countActiveUsers(tenantId); + } + + // Crear suscripción en Stripe + const stripeSubscription = await this.stripe.subscriptions.create({ + customer: customer.stripeCustomerId, + items: [{ + price: plan.stripePriceId, + quantity, + }], + default_payment_method: paymentMethodId, + payment_behavior: 'default_incomplete', // Permite manejar 3DS + payment_settings: { + save_default_payment_method: 'on_subscription', + }, + expand: ['latest_invoice.payment_intent'], + metadata: { + tenant_id: tenantId, + plan_id: planId, + }, + }); + + // Guardar en DB local + const subscription = this.subscriptionRepo.create({ + tenantId, + planId, + stripeSubscriptionId: stripeSubscription.id, + stripePriceId: plan.stripePriceId, + stripeStatus: stripeSubscription.status, + quantity, + status: this.mapStripeStatus(stripeSubscription.status), + currentPeriodStart: new Date(stripeSubscription.current_period_start * 1000), + currentPeriodEnd: new Date(stripeSubscription.current_period_end * 1000), + }); + + const saved = await this.subscriptionRepo.save(subscription); + + // Verificar si requiere acción (3DS) + const invoice = stripeSubscription.latest_invoice as Stripe.Invoice; + const paymentIntent = invoice?.payment_intent as Stripe.PaymentIntent; + + if (paymentIntent?.status === 'requires_action') { + return { + ...saved, + requiresAction: true, + clientSecret: paymentIntent.client_secret, + }; + } + + return saved; + } + + async updateSubscriptionQuantity( + tenantId: string, + newQuantity: number, + ): Promise { + const subscription = await this.subscriptionRepo.findOne({ + where: { tenantId, status: 'active' }, + }); + + if (!subscription) { + throw new NotFoundException('Active subscription not found'); + } + + // Actualizar en Stripe (genera prorrata automática) + const stripeSubscription = await this.stripe.subscriptions.retrieve( + subscription.stripeSubscriptionId + ); + + await this.stripe.subscriptions.update(subscription.stripeSubscriptionId, { + items: [{ + id: stripeSubscription.items.data[0].id, + quantity: newQuantity, + }], + proration_behavior: 'create_prorations', + }); + + // Actualizar en DB local + subscription.quantity = newQuantity; + return this.subscriptionRepo.save(subscription); + } + + async cancelSubscription( + tenantId: string, + cancelImmediately: boolean = false, + ): Promise { + const subscription = await this.subscriptionRepo.findOne({ + where: { tenantId, status: 'active' }, + }); + + if (!subscription) { + throw new NotFoundException('Active subscription not found'); + } + + if (cancelImmediately) { + await this.stripe.subscriptions.cancel(subscription.stripeSubscriptionId); + subscription.status = 'canceled'; + subscription.canceledAt = new Date(); + } else { + await this.stripe.subscriptions.update(subscription.stripeSubscriptionId, { + cancel_at_period_end: true, + }); + subscription.cancelAtPeriodEnd = true; + } + + return this.subscriptionRepo.save(subscription); + } + + // ======================================== + // USER COUNT SYNC + // ======================================== + + async syncUserCount(tenantId: string): Promise { + const subscription = await this.subscriptionRepo.findOne({ + where: { tenantId, status: 'active' }, + }); + + if (!subscription) { + return; // No hay suscripción activa + } + + const currentUserCount = await this.countActiveUsers(tenantId); + + if (currentUserCount !== subscription.quantity) { + await this.updateSubscriptionQuantity(tenantId, currentUserCount); + } + } + + private async countActiveUsers(tenantId: string): Promise { + return this.userRepo.count({ + where: { tenantId, status: 'active' }, + }); + } + + // ======================================== + // BILLING PORTAL + // ======================================== + + async createBillingPortalSession( + tenantId: string, + returnUrl: string, + ): Promise { + const customer = await this.getCustomerByTenantId(tenantId); + if (!customer) { + throw new NotFoundException('Stripe customer not found'); + } + + const session = await this.stripe.billingPortal.sessions.create({ + customer: customer.stripeCustomerId, + return_url: returnUrl, + }); + + return session.url; + } + + // ======================================== + // HELPERS + // ======================================== + + private mapStripeStatus(stripeStatus: string): SubscriptionStatus { + const statusMap: Record = { + 'active': 'active', + 'trialing': 'trialing', + 'past_due': 'past_due', + 'canceled': 'canceled', + 'unpaid': 'suspended', + 'incomplete': 'pending', + 'incomplete_expired': 'canceled', + }; + return statusMap[stripeStatus] || 'pending'; + } +} +``` + +### 4.2 StripeWebhookService + +```typescript +// src/modules/billing/services/stripe-webhook.service.ts + +@Injectable() +export class StripeWebhookService { + private stripe: Stripe; + + constructor( + private configService: ConfigService, + @InjectRepository(StripeWebhookEvent) + private webhookEventRepo: Repository, + private stripeService: StripeService, + private subscriptionService: SubscriptionService, + private invoiceService: InvoiceService, + private notificationService: NotificationService, + private eventBus: EventBus, + ) { + this.stripe = new Stripe(this.configService.get('STRIPE_SECRET_KEY')); + } + + async handleWebhook( + payload: Buffer, + signature: string, + ): Promise<{ received: boolean }> { + // 1. Verificar firma + let event: Stripe.Event; + try { + event = this.stripe.webhooks.constructEvent( + payload, + signature, + this.configService.get('STRIPE_WEBHOOK_SECRET'), + ); + } catch (err) { + throw new BadRequestException(`Webhook signature verification failed: ${err.message}`); + } + + // 2. Verificar idempotencia + const existing = await this.webhookEventRepo.findOne({ + where: { stripeEventId: event.id }, + }); + + if (existing) { + // Ya procesado + return { received: true }; + } + + // 3. Guardar evento + const webhookEvent = this.webhookEventRepo.create({ + stripeEventId: event.id, + eventType: event.type, + apiVersion: event.api_version, + payload: event.data, + status: 'processing', + }); + + await this.webhookEventRepo.save(webhookEvent); + + // 4. Procesar evento + try { + await this.processEvent(event); + + webhookEvent.status = 'processed'; + webhookEvent.processedAt = new Date(); + } catch (error) { + webhookEvent.status = 'failed'; + webhookEvent.errorMessage = error.message; + webhookEvent.retryCount += 1; + + // Re-lanzar para que Stripe reintente + throw error; + } finally { + await this.webhookEventRepo.save(webhookEvent); + } + + return { received: true }; + } + + private async processEvent(event: Stripe.Event): Promise { + const handlers: Record Promise> = { + // Subscriptions + 'customer.subscription.created': this.handleSubscriptionCreated.bind(this), + 'customer.subscription.updated': this.handleSubscriptionUpdated.bind(this), + 'customer.subscription.deleted': this.handleSubscriptionDeleted.bind(this), + 'customer.subscription.trial_will_end': this.handleTrialWillEnd.bind(this), + + // Invoices + 'invoice.created': this.handleInvoiceCreated.bind(this), + 'invoice.finalized': this.handleInvoiceFinalized.bind(this), + 'invoice.paid': this.handleInvoicePaid.bind(this), + 'invoice.payment_failed': this.handleInvoicePaymentFailed.bind(this), + 'invoice.payment_action_required': this.handlePaymentActionRequired.bind(this), + + // Payment Intents + 'payment_intent.succeeded': this.handlePaymentSucceeded.bind(this), + 'payment_intent.payment_failed': this.handlePaymentFailed.bind(this), + + // Disputes + 'charge.dispute.created': this.handleDisputeCreated.bind(this), + }; + + const handler = handlers[event.type]; + if (handler) { + await handler(event.data.object); + } + } + + // ======================================== + // SUBSCRIPTION HANDLERS + // ======================================== + + private async handleSubscriptionCreated(subscription: Stripe.Subscription): Promise { + const tenantId = subscription.metadata.tenant_id; + if (!tenantId) return; + + await this.subscriptionService.syncFromStripe(tenantId, subscription); + + this.eventBus.emit('subscription.created', { + tenantId, + subscriptionId: subscription.id, + }); + } + + private async handleSubscriptionUpdated(subscription: Stripe.Subscription): Promise { + const tenantId = subscription.metadata.tenant_id; + if (!tenantId) return; + + await this.subscriptionService.syncFromStripe(tenantId, subscription); + + // Verificar cambios relevantes + if (subscription.cancel_at_period_end) { + await this.notificationService.sendSubscriptionCancelScheduled(tenantId); + } + + this.eventBus.emit('subscription.updated', { + tenantId, + subscriptionId: subscription.id, + status: subscription.status, + }); + } + + private async handleSubscriptionDeleted(subscription: Stripe.Subscription): Promise { + const tenantId = subscription.metadata.tenant_id; + if (!tenantId) return; + + await this.subscriptionService.markAsCanceled(tenantId, subscription.id); + await this.notificationService.sendSubscriptionCanceled(tenantId); + + this.eventBus.emit('subscription.canceled', { + tenantId, + subscriptionId: subscription.id, + }); + } + + private async handleTrialWillEnd(subscription: Stripe.Subscription): Promise { + const tenantId = subscription.metadata.tenant_id; + if (!tenantId) return; + + await this.notificationService.sendTrialEndingNotification(tenantId, subscription.trial_end); + } + + // ======================================== + // INVOICE HANDLERS + // ======================================== + + private async handleInvoiceCreated(invoice: Stripe.Invoice): Promise { + await this.invoiceService.createFromStripe(invoice); + } + + private async handleInvoiceFinalized(invoice: Stripe.Invoice): Promise { + await this.invoiceService.updateFromStripe(invoice); + } + + private async handleInvoicePaid(invoice: Stripe.Invoice): Promise { + const tenantId = await this.getTenantIdFromCustomer(invoice.customer as string); + if (!tenantId) return; + + await this.invoiceService.markAsPaid(invoice.id); + + // Activar tenant si estaba suspendido + await this.tenantService.activateIfSuspended(tenantId); + + await this.notificationService.sendInvoicePaid(tenantId, invoice); + + this.eventBus.emit('invoice.paid', { + tenantId, + invoiceId: invoice.id, + amount: invoice.amount_paid, + }); + } + + private async handleInvoicePaymentFailed(invoice: Stripe.Invoice): Promise { + const tenantId = await this.getTenantIdFromCustomer(invoice.customer as string); + if (!tenantId) return; + + await this.invoiceService.markAsPaymentFailed(invoice.id); + + // Enviar notificación de pago fallido + await this.notificationService.sendPaymentFailed(tenantId, invoice); + + // Incrementar contador de dunning + await this.dunningService.recordFailedPayment(tenantId); + + this.eventBus.emit('invoice.payment_failed', { + tenantId, + invoiceId: invoice.id, + attemptCount: invoice.attempt_count, + }); + } + + private async handlePaymentActionRequired(invoice: Stripe.Invoice): Promise { + const tenantId = await this.getTenantIdFromCustomer(invoice.customer as string); + if (!tenantId) return; + + // Notificar que se requiere acción (probablemente 3DS) + await this.notificationService.sendPaymentActionRequired(tenantId, invoice); + } + + // ======================================== + // PAYMENT HANDLERS + // ======================================== + + private async handlePaymentSucceeded(paymentIntent: Stripe.PaymentIntent): Promise { + const tenantId = paymentIntent.metadata?.tenant_id; + if (!tenantId) return; + + await this.paymentService.recordSuccessfulPayment(paymentIntent); + + this.eventBus.emit('payment.succeeded', { + tenantId, + paymentIntentId: paymentIntent.id, + amount: paymentIntent.amount, + }); + } + + private async handlePaymentFailed(paymentIntent: Stripe.PaymentIntent): Promise { + const tenantId = paymentIntent.metadata?.tenant_id; + if (!tenantId) return; + + await this.paymentService.recordFailedPayment(paymentIntent); + } + + // ======================================== + // DISPUTE HANDLERS + // ======================================== + + private async handleDisputeCreated(dispute: Stripe.Dispute): Promise { + // Alertar inmediatamente - las disputas tienen deadlines estrictos + await this.notificationService.sendDisputeAlert(dispute); + + // Log para review manual + this.logger.warn('Dispute created', { + disputeId: dispute.id, + chargeId: dispute.charge, + amount: dispute.amount, + reason: dispute.reason, + }); + } + + // ======================================== + // HELPERS + // ======================================== + + private async getTenantIdFromCustomer(stripeCustomerId: string): Promise { + const customer = await this.stripeCustomerRepo.findOne({ + where: { stripeCustomerId }, + }); + return customer?.tenantId || null; + } +} +``` + +### 4.3 User Count Event Listener + +```typescript +// src/modules/billing/listeners/user-count.listener.ts + +@Injectable() +export class UserCountListener { + constructor(private stripeService: StripeService) {} + + @OnEvent('user.created') + @OnEvent('user.activated') + async handleUserAdded(event: { tenantId: string; userId: string }) { + await this.stripeService.syncUserCount(event.tenantId); + } + + @OnEvent('user.deactivated') + @OnEvent('user.deleted') + async handleUserRemoved(event: { tenantId: string; userId: string }) { + await this.stripeService.syncUserCount(event.tenantId); + } +} +``` + +--- + +## 5. Frontend Integration + +### 5.1 Stripe Elements Setup + +```typescript +// src/components/billing/StripeProvider.tsx + +import { Elements } from '@stripe/react-stripe-js'; +import { loadStripe } from '@stripe/stripe-js'; + +const stripePromise = loadStripe(import.meta.env.VITE_STRIPE_PUBLISHABLE_KEY); + +export function StripeProvider({ children }: { children: React.ReactNode }) { + return ( + + {children} + + ); +} +``` + +### 5.2 Payment Method Form + +```typescript +// src/components/billing/AddPaymentMethodForm.tsx + +import { useStripe, useElements, CardElement } from '@stripe/react-stripe-js'; +import { useMutation } from '@tanstack/react-query'; + +export function AddPaymentMethodForm({ onSuccess }: { onSuccess: () => void }) { + const stripe = useStripe(); + const elements = useElements(); + const [error, setError] = useState(null); + const [isProcessing, setIsProcessing] = useState(false); + + // 1. Obtener SetupIntent + const { mutateAsync: createSetupIntent } = useMutation({ + mutationFn: () => billingApi.createSetupIntent(), + }); + + // 2. Guardar payment method + const { mutateAsync: attachPaymentMethod } = useMutation({ + mutationFn: (paymentMethodId: string) => + billingApi.attachPaymentMethod(paymentMethodId, true), + }); + + const handleSubmit = async (e: React.FormEvent) => { + e.preventDefault(); + + if (!stripe || !elements) return; + + setIsProcessing(true); + setError(null); + + try { + // Obtener client_secret + const { client_secret } = await createSetupIntent(); + + // Confirmar con Stripe + const { error: stripeError, setupIntent } = await stripe.confirmCardSetup( + client_secret, + { + payment_method: { + card: elements.getElement(CardElement)!, + }, + } + ); + + if (stripeError) { + setError(stripeError.message || 'Error al procesar la tarjeta'); + return; + } + + // Guardar en backend + await attachPaymentMethod(setupIntent.payment_method as string); + + onSuccess(); + } catch (err) { + setError('Error al guardar el método de pago'); + } finally { + setIsProcessing(false); + } + }; + + return ( +
+ + + {error &&
{error}
} + + + + ); +} +``` + +### 5.3 Subscription Management + +```typescript +// src/pages/billing/SubscriptionPage.tsx + +export function SubscriptionPage() { + const { data: subscription, isLoading } = useQuery({ + queryKey: ['subscription'], + queryFn: () => billingApi.getCurrentSubscription(), + }); + + const { mutate: cancelSubscription } = useMutation({ + mutationFn: () => billingApi.cancelSubscription(), + onSuccess: () => { + queryClient.invalidateQueries(['subscription']); + toast.success('Suscripción programada para cancelación'); + }, + }); + + const { mutate: openBillingPortal } = useMutation({ + mutationFn: () => billingApi.createBillingPortalSession(window.location.href), + onSuccess: (url) => { + window.location.href = url; + }, + }); + + if (isLoading) return ; + + return ( +
+ + + Tu Suscripción + + +
+
+ +

{subscription.plan.name}

+
+
+ +

{subscription.quantity}

+
+
+ +

+ ${subscription.quantity * subscription.plan.price_per_user} MXN +

+

+ {format(new Date(subscription.current_period_end), 'dd MMM yyyy')} +

+
+
+ + + {subscription.status} + +
+
+ + {subscription.cancel_at_period_end && ( + + Tu suscripción se cancelará el{' '} + {format(new Date(subscription.current_period_end), 'dd MMM yyyy')} + + )} + + + + {!subscription.cancel_at_period_end && ( + + )} + + +
+ ); +} +``` + +--- + +## 6. Testing + +### 6.1 Stripe Test Mode + +```bash +# Tarjetas de prueba +4242424242424242 # Visa - siempre exitosa +4000000000000002 # Visa - rechazada +4000002500003155 # Visa - requiere 3DS +4000000000009995 # Visa - fondos insuficientes + +# Webhook testing con Stripe CLI +stripe listen --forward-to localhost:3000/webhooks/stripe + +# Trigger eventos manualmente +stripe trigger invoice.payment_succeeded +stripe trigger customer.subscription.updated +``` + +### 6.2 Integration Tests + +```typescript +// tests/integration/stripe.test.ts + +describe('Stripe Integration', () => { + describe('Subscription Creation', () => { + it('should create subscription with valid payment method', async () => { + // Arrange + const tenant = await createTestTenant(); + const customer = await stripeService.createCustomer(tenant.id, { + email: 'test@example.com', + }); + + // Simular payment method (en tests usamos token de prueba) + const paymentMethod = await stripe.paymentMethods.create({ + type: 'card', + card: { token: 'tok_visa' }, + }); + + await stripeService.attachPaymentMethod( + tenant.id, + paymentMethod.id, + true + ); + + // Act + const subscription = await stripeService.createSubscription( + tenant.id, + testPlan.id, + 5 + ); + + // Assert + expect(subscription.status).toBe('active'); + expect(subscription.quantity).toBe(5); + expect(subscription.stripeSubscriptionId).toMatch(/^sub_/); + }); + + it('should handle 3DS authentication', async () => { + // Usar tarjeta que requiere 3DS + const paymentMethod = await stripe.paymentMethods.create({ + type: 'card', + card: { token: 'tok_threeDSecure2Required' }, + }); + + // ... setup ... + + const subscription = await stripeService.createSubscription( + tenant.id, + testPlan.id, + 1 + ); + + expect(subscription.requiresAction).toBe(true); + expect(subscription.clientSecret).toBeDefined(); + }); + }); + + describe('Webhook Processing', () => { + it('should process invoice.paid and activate tenant', async () => { + // Arrange + const tenant = await createSuspendedTenant(); + const invoice = createMockInvoice(tenant.id); + + // Act + await webhookService.handleWebhook( + Buffer.from(JSON.stringify({ + id: 'evt_test', + type: 'invoice.paid', + data: { object: invoice }, + })), + generateSignature(invoice) + ); + + // Assert + const updatedTenant = await tenantRepo.findOne(tenant.id); + expect(updatedTenant.status).toBe('active'); + }); + + it('should be idempotent for duplicate events', async () => { + const event = createMockEvent('invoice.paid'); + + // Primera llamada + await webhookService.handleWebhook(event.payload, event.signature); + + // Segunda llamada (duplicado) + await webhookService.handleWebhook(event.payload, event.signature); + + // Verificar que solo se procesó una vez + const events = await webhookEventRepo.find({ + where: { stripeEventId: event.id }, + }); + expect(events.length).toBe(1); + }); + }); +}); +``` + +--- + +## 7. Configuración de Stripe + +### 7.1 Products y Prices en Stripe Dashboard + +```json +// Productos a crear en Stripe +{ + "products": [ + { + "name": "ERP Construcción - Starter", + "description": "Plan básico para pequeñas constructoras", + "metadata": { + "plan_code": "construccion_starter", + "vertical": "construccion" + } + }, + { + "name": "ERP Construcción - Growth", + "description": "Plan avanzado con todas las funcionalidades", + "metadata": { + "plan_code": "construccion_growth", + "vertical": "construccion" + } + }, + { + "name": "ERP Construcción - Enterprise", + "description": "Plan personalizado para grandes constructoras", + "metadata": { + "plan_code": "construccion_enterprise", + "vertical": "construccion" + } + } + ], + "prices": [ + { + "product": "ERP Construcción - Starter", + "unit_amount": 49900, + "currency": "mxn", + "recurring": { + "interval": "month", + "usage_type": "licensed" + }, + "billing_scheme": "per_unit", + "metadata": { + "price_per_user": true + } + }, + { + "product": "ERP Construcción - Growth", + "unit_amount": 99900, + "currency": "mxn", + "recurring": { + "interval": "month", + "usage_type": "licensed" + }, + "billing_scheme": "per_unit" + } + ] +} +``` + +### 7.2 Webhook Endpoints + +``` +Endpoint URL: https://api.erp-suite.com/webhooks/stripe +Events to listen: +- customer.subscription.created +- customer.subscription.updated +- customer.subscription.deleted +- customer.subscription.trial_will_end +- invoice.created +- invoice.finalized +- invoice.paid +- invoice.payment_failed +- invoice.payment_action_required +- payment_intent.succeeded +- payment_intent.payment_failed +- payment_method.attached +- payment_method.detached +- charge.dispute.created +``` + +### 7.3 Customer Portal Configuration + +``` +Features habilitadas: +- Update payment methods +- Update billing information +- View invoice history +- Download invoices +- Cancel subscription (at period end only) +``` + +--- + +## 8. Seguridad + +### 8.1 Checklist de Seguridad + +- [ ] Stripe Secret Key solo en backend (nunca en frontend) +- [ ] Webhook signature verification obligatoria +- [ ] Idempotencia en procesamiento de webhooks +- [ ] Rate limiting en endpoints de billing +- [ ] Logs de todas las operaciones Stripe +- [ ] Encriptación de payment method IDs en reposo +- [ ] Validación de tenant ownership en cada operación + +### 8.2 Variables de Entorno + +```bash +# .env (ejemplo) +STRIPE_SECRET_KEY=sk_live_xxx # O sk_test_xxx para desarrollo +STRIPE_PUBLISHABLE_KEY=pk_live_xxx +STRIPE_WEBHOOK_SECRET=whsec_xxx +STRIPE_API_VERSION=2023-10-16 +``` + +--- + +**Creado por:** Requirements-Analyst +**Fecha:** 2025-12-05 +**Versión:** 1.0 diff --git a/docs/ANALISIS-ARQUITECTURA-ERP-SUITE.md b/docs/ANALISIS-ARQUITECTURA-ERP-SUITE.md new file mode 100644 index 0000000..68ddfb3 --- /dev/null +++ b/docs/ANALISIS-ARQUITECTURA-ERP-SUITE.md @@ -0,0 +1,572 @@ +# ANALISIS ARQUITECTONICO: ERP-SUITE + +**Fecha:** 2025-12-08 +**Agente:** Architecture Analyst +**Alcance:** erp-core + 5 verticales (construccion, mecanicas-diesel, clinicas, retail, vidrio-templado) + +--- + +## 1. RESUMEN EJECUTIVO + +ERP-Suite es una suite empresarial multi-vertical diseñada con una arquitectura modular que maximiza la reutilizacion de codigo. El sistema se compone de: + +- **erp-core:** Base generica que proporciona 60-70% del codigo compartido +- **5 verticales:** Extensiones especializadas por giro de negocio + +### Estado General + +| Componente | Progreso | Estado | +|------------|----------|--------| +| erp-core | 60% | En desarrollo activo | +| Construccion | 35% | Backend parcial, DDL 50% | +| Mecanicas Diesel | 95% docs / 30% codigo | DDL 100%, listo para dev | +| Clinicas | 25% | Solo documentacion | +| Retail | 25% | Solo documentacion | +| Vidrio Templado | 25% | Solo documentacion | + +--- + +## 2. ARQUITECTURA DE ERP-CORE + +### 2.1 Stack Tecnologico + +| Capa | Tecnologia | Version | +|------|------------|---------| +| Backend | Node.js + Express + TypeScript | 20+ / 4.18 / 5.3 | +| Frontend | React + Vite + TypeScript | 18.3 / 5.4 / 5.6 | +| Base de Datos | PostgreSQL con RLS | 15+ | +| State Management | Zustand | 5.0 | +| Validacion | Zod | 3.22+ | +| ORM/Driver | pg (raw queries) | 8.11 | + +### 2.2 Estructura de Modulos Backend (14 modulos) + +``` +erp-core/backend/src/modules/ +├── auth/ # JWT, bcryptjs, refresh tokens +├── users/ # CRUD usuarios +├── companies/ # Multi-company management +├── core/ # Catalogos (monedas, paises, UoM) +├── partners/ # Clientes/proveedores +├── inventory/ # Productos, almacenes, stock +├── financial/ # Contabilidad (cuentas, diarios) +├── purchases/ # Ordenes de compra +├── sales/ # Cotizaciones, pedidos +├── projects/ # Proyectos, tareas, timesheets +├── system/ # Mensajes, notificaciones +├── crm/ # Leads, oportunidades +└── hr/ # Nomina basica +``` + +### 2.3 Patrones de Arquitectura + +#### BaseService Generico +Ubicacion: `backend/src/shared/services/base.service.ts` + +```typescript +abstract class BaseService { + // CRUD con multi-tenancy automatico + findAll(tenantId, filters): PaginatedResult + findById(id, tenantId): T | null + softDelete(id, tenantId, userId): boolean + withTransaction(fn): Promise +} +``` + +**Beneficios:** +- Elimina duplicacion de codigo CRUD +- Multi-tenancy integrado (RLS) +- Paginacion, filtros, busqueda full-text +- Soft-delete por defecto + +#### Multi-Tenancy (Schema-Level + RLS) + +```sql +-- Todas las tablas tienen: +tenant_id UUID NOT NULL REFERENCES auth.tenants(id) + +-- RLS Policy estandar +CREATE POLICY tenant_isolation ON {tabla} + USING (tenant_id = current_setting('app.current_tenant_id')::uuid); +``` + +### 2.4 Base de Datos (12 Schemas, 144 tablas) + +| Schema | Proposito | Tablas | +|--------|-----------|--------| +| auth | Usuarios, roles, sesiones | 10 | +| core | Partners, catalogos | 12 | +| analytics | Contabilidad analitica | 7 | +| financial | Facturas, pagos | 15 | +| inventory | Productos, movimientos | 10 | +| purchase | Ordenes de compra | 8 | +| sales | Cotizaciones, pedidos | 10 | +| projects | Tareas, timesheets | 10 | +| system | Notificaciones, logs | 13 | +| billing | SaaS subscriptions | 11 | +| crm | Leads, pipeline | 6 | +| hr | Empleados, nomina | 6 | + +--- + +## 3. ANALISIS DE VERTICALES + +### 3.1 Matriz Comparativa + +| Aspecto | Construccion | Mecanicas | Clinicas | Retail | Vidrio | +|---------|--------------|-----------|----------|--------|--------| +| **Progreso** | 35% | 95% docs | 25% | 25% | 25% | +| **Modulos** | 18 | 6 | 12 | 10 | 8 | +| **Story Points** | 692 | 241 | 451 | 353 | 259 | +| **DDL** | 50% | 100% | 0% | 0% | 0% | +| **Backend** | 22% | 30% | 0% | 0% | 0% | +| **Frontend** | 5% | 0% | 0% | 0% | 0% | +| **Docs** | 100% | 100% | 100% | 100% | 100% | + +### 3.2 Porcentaje de Reutilizacion del Core + +| Vertical | % Core | Modulos Heredados | Modulos Nuevos | +|----------|--------|-------------------|----------------| +| Construccion | 61% | Auth, RBAC, Catalogos, Reportes | Proyectos, Presupuestos, INFONAVIT, HSE | +| Mecanicas | 60-70% | Auth, RBAC, Inventario | Ordenes servicio, Diagnosticos | +| Clinicas | 30-50% | Auth, RBAC, Farmacia | Expediente, Telemedicina, DICOM | +| Retail | 40-70% | Auth, RBAC, Inventario, Reportes | POS, Caja, E-commerce | +| Vidrio | 50-60% | Auth, RBAC, Inventario | Corte (nesting), Templado | + +### 3.3 Analisis por Vertical + +#### CONSTRUCCION (35% completado) + +**Modulos implementados:** +- DDL: 3/7 schemas (construction, hr, hse) +- Backend: 4 modulos con entidades TypeORM +- 449 archivos de documentacion + +**Fases:** +``` +Fase 1 (MAI): 14 modulos, ~670 SP +Fase 2 (MAE): 3 modulos enterprise, 210 SP +Fase 3 (MAA): 1 modulo HSE +``` + +**Gaps identificados:** +- [ ] DDL faltante: estimates, infonavit, inventory-ext, purchase-ext +- [ ] Servicios backend MAI-003 a MAI-013 pendientes +- [ ] Frontend no iniciado + +#### MECANICAS DIESEL (95% documentado) + +**Estado:** Listo para desarrollo + +**DDL completo (43 tablas):** +- workshop_core: 9 tablas +- service_management: 14 tablas +- parts_management: 12 tablas +- vehicle_management: 8 tablas + +**Modulos MVP:** +| Codigo | Modulo | SP | US | +|--------|--------|-----|-----| +| MMD-001 | Fundamentos | 42 | 9 | +| MMD-002 | Ordenes de Servicio | 55 | 11 | +| MMD-003 | Diagnosticos | 42 | 8 | +| MMD-004 | Inventario Refacciones | 42 | 10 | +| MMD-005 | Vehiculos | 34 | 8 | +| MMD-006 | Cotizaciones | 26 | 7 | + +**Directivas especificas documentadas:** +- DIRECTIVA-ORDENES-TRABAJO.md +- DIRECTIVA-INVENTARIO-REFACCIONES.md + +#### CLINICAS (25% documentado) + +**12 modulos planificados (451 SP):** +- CL-004 Consultas: 0% core (nuevo) +- CL-010 Telemedicina: 0% core (WebRTC) +- CL-012 Imagenologia: 0% core (DICOM) + +**Consideraciones especiales:** +- Cumplimiento: NOM-024-SSA3, LFPDPPP +- Encriptacion de datos medicos obligatoria +- Integraciones: PACS, timbrado CFDI + +#### RETAIL (25% documentado) + +**10 modulos planificados (353 SP):** +- RT-002 POS: PWA con capacidad offline +- RT-007 Caja: Arqueos y cortes +- RT-009 E-commerce: Integracion tienda online + +**Consideraciones especiales:** +- Sincronizacion bidireccional offline +- Integracion hardware (impresoras, cajas) + +#### VIDRIO TEMPLADO (25% documentado) + +**8 modulos planificados (259 SP):** +- VT-005 Corte: Algoritmo nesting (0% core) +- VT-006 Templado: Control de hornos (0% core) + +**Consideraciones especiales:** +- Cotizacion por dimensiones (alto x ancho) +- Trazabilidad de lotes obligatoria +- Pruebas de fragmentacion QC + +--- + +## 4. SISTEMA DE HERENCIA + +### 4.1 Jerarquia de 3 Niveles + +``` +NIVEL 0: CORE GLOBAL +└── /home/isem/workspace/core/orchestration/ + ├── directivas/simco/ # Sistema SIMCO v2.2.0 + ├── templates/ # Templates reutilizables + └── checklists/ # Validaciones + +NIVEL 1: ERP-CORE +└── apps/erp-core/orchestration/ + ├── directivas/ # Directivas ERP + └── 00-guidelines/ # Contexto proyecto + +NIVEL 2: VERTICALES +└── apps/verticales/{vertical}/orchestration/ + ├── 00-guidelines/ # CONTEXTO-PROYECTO.md + ├── directivas/ # Directivas especificas + └── inventarios/ # SSOT del vertical +``` + +### 4.2 Regla Fundamental + +> **Las verticales EXTIENDEN, nunca MODIFICAN el core** + +### 4.3 Documentos de Herencia Requeridos + +Cada vertical debe tener en `orchestration/00-guidelines/`: + +| Archivo | Proposito | Estado | +|---------|-----------|--------| +| CONTEXTO-PROYECTO.md | Vision y alcance | Todas tienen | +| HERENCIA-ERP-CORE.md | Modulos heredados | Mecanicas OK | +| HERENCIA-SPECS-CORE.md | SPECS aplicables | Mecanicas OK | +| HERENCIA-DIRECTIVAS.md | Jerarquia directivas | Mecanicas OK | +| HERENCIA-SIMCO.md | Sistema orquestacion | Mecanicas OK | + +--- + +## 5. HALLAZGOS Y PROBLEMAS + +### 5.1 Estado de Documentacion de Herencia + +#### A. Documentacion de Herencia - ACTUALIZADO + +| Vertical | HERENCIA-ERP-CORE | HERENCIA-SPECS | HERENCIA-SIMCO | HERENCIA-DIRECTIVAS | +|----------|-------------------|----------------|----------------|---------------------| +| Construccion | OK | OK | OK | OK | +| Mecanicas | OK | OK | OK | OK | +| Clinicas | OK | OK | OK | OK | +| Retail | OK | OK | OK | OK | +| Vidrio | OK | OK | OK | OK | + +**Estado:** Todas las verticales tienen documentacion de herencia completa. + +#### B. Nomenclatura de Schemas Inconsistente + +``` +erp-core: auth, core, financial, inventory... +construccion: construction, hr, hse +mecanicas: workshop_core, service_management, parts_management +``` + +**Documento de estandarizacion creado:** `docs/ESTANDAR-NOMENCLATURA-SCHEMAS.md` + +Prefijos definidos: +- `erp_*` para erp-core +- `con_*` para construccion +- `mec_*` para mecanicas +- `cli_*` para clinicas +- `ret_*` para retail +- `vit_*` para vidrio templado + +#### C. Estructura de Directorios Variable + +``` +erp-core/backend/src/modules/{modulo}/ + ├── {modulo}.controller.ts + ├── {modulo}.service.ts + └── {modulo}.routes.ts + +construccion/backend/src/modules/{modulo}/ + ├── entities/ # Diferente + ├── services/ # Diferente + └── controllers/ # Diferente +``` + +**Recomendacion:** Unificar estructura en todas las verticales. + +### 5.2 Gaps de Implementacion + +#### erp-core +- [ ] MGN-001 Auth: En desarrollo (JWT implementado) +- [ ] MGN-002-014: Solo DDL, sin backend completo +- [ ] Frontend: Estructura base, features incompletas + +#### Verticales +- [ ] Construccion: 4 schemas DDL pendientes +- [ ] Mecanicas: Backend y frontend pendientes +- [ ] Clinicas/Retail/Vidrio: Todo pendiente + +### 5.3 Dependencias Criticas + +``` +erp-core DEBE completarse primero: +├── MGN-001 Auth → Todas las verticales dependen +├── MGN-002 Users → Todas las verticales dependen +├── MGN-003 Roles → Todas las verticales dependen +├── MGN-004 Tenants → Todas las verticales dependen +├── MGN-005 Catalogs → Todas las verticales dependen +└── MGN-011 Inventory → Mecanicas, Retail, Vidrio, Construccion +``` + +--- + +## 6. RECOMENDACIONES + +### 6.1 Prioridad CRITICA (Hacer inmediatamente) + +#### R1: Completar Documentacion de Herencia + +```bash +# Para cada vertical (construccion, clinicas, retail, vidrio): +apps/verticales/{vertical}/orchestration/00-guidelines/ + ├── HERENCIA-ERP-CORE.md # Copiar de mecanicas, adaptar + ├── HERENCIA-SPECS-CORE.md # Listar SPECS aplicables + ├── HERENCIA-DIRECTIVAS.md # Jerarquia de directivas + └── HERENCIA-SIMCO.md # Configuracion SIMCO +``` + +#### R2: Estandarizar Estructura de Modulos Backend + +Adoptar estructura unificada: +``` +modules/{nombre}/ +├── {nombre}.module.ts # Opcional si no usa NestJS +├── {nombre}.controller.ts +├── {nombre}.service.ts +├── {nombre}.routes.ts +├── entities/ +│ └── {entidad}.entity.ts +├── dto/ +│ ├── create-{nombre}.dto.ts +│ └── update-{nombre}.dto.ts +└── __tests__/ +``` + +#### R3: Definir Convencion de Schemas + +```sql +-- Propuesta de prefijos +erp_core.* -- Schemas del core +con_* -- Construccion +mec_* -- Mecanicas diesel +cli_* -- Clinicas +ret_* -- Retail +vit_* -- Vidrio templado +``` + +### 6.2 Prioridad ALTA (Proximas 2-4 semanas) + +#### R4: Completar MGN-001 a MGN-005 en erp-core + +Orden de implementacion: +1. MGN-001 Auth (JWT, refresh tokens, 2FA) +2. MGN-002 Users (CRUD completo) +3. MGN-003 Roles (RBAC) +4. MGN-004 Tenants (Multi-tenancy) +5. MGN-005 Catalogs (Datos maestros) + +#### R5: Crear Inventario Unificado por Vertical + +Cada vertical debe tener en `orchestration/inventarios/`: +```yaml +# MASTER_INVENTORY.yml +project: + name: {vertical} + version: 1.0.0 + parent: erp-core + +metrics: + total_modules: X + implemented_modules: Y + total_tables: Z + total_endpoints: N + +modules: + inherited: + - MGN-001: 100% + - MGN-002: 100% + extended: + - MGN-005: +30% + new: + - {vertical}-001: Descripcion +``` + +#### R6: Iniciar Frontend de Mecanicas Diesel + +El DDL esta 100% completo. Siguiente paso: +1. Crear estructura React + Vite +2. Implementar modulo de autenticacion (heredar de core) +3. Desarrollar UI de ordenes de servicio + +### 6.3 Prioridad MEDIA (1-2 meses) + +#### R7: Crear Tests de Integracion Core-Vertical + +```typescript +// test/integration/vertical-inheritance.spec.ts +describe('Vertical inherits from Core', () => { + it('should use core auth service', () => {...}) + it('should extend catalog service', () => {...}) + it('should have RLS policies', () => {...}) +}) +``` + +#### R8: Documentar API Contracts + +Crear en cada vertical: +``` +docs/api-contracts/ +├── {vertical}-api.yml # OpenAPI 3.0 +└── README.md # Endpoints documentados +``` + +#### R9: Implementar CI/CD Pipeline + +```yaml +# .github/workflows/vertical-ci.yml +- Lint (ESLint) +- Type check (tsc) +- Unit tests (Jest) +- Build check +- DDL validation +``` + +### 6.4 Prioridad BAJA (3+ meses) + +#### R10: Crear SDK Compartido + +``` +shared-libs/ +├── @erp-suite/core-types/ # Tipos TypeScript compartidos +├── @erp-suite/ui-components/ # Componentes React reutilizables +└── @erp-suite/api-client/ # Cliente HTTP tipado +``` + +#### R11: Implementar Feature Flags + +Para deployment gradual de verticales: +```typescript +const featureFlags = { + 'construccion.hse': process.env.FF_CONSTRUCCION_HSE, + 'mecanicas.diagnosticos': process.env.FF_MECANICAS_DIAG, +} +``` + +--- + +## 7. ROADMAP RECOMENDADO + +### Fase 1: Fundamentos (Semanas 1-4) +- [ ] Completar MGN-001 a MGN-005 en erp-core +- [ ] Crear documentos HERENCIA-* en todas las verticales +- [ ] Estandarizar estructura de modulos + +### Fase 2: Vertical Piloto - Mecanicas (Semanas 5-8) +- [ ] Implementar frontend React +- [ ] Completar servicios backend +- [ ] Testing E2E +- [ ] Deploy MVP + +### Fase 3: Verticales Secundarias (Semanas 9-16) +- [ ] Construccion: Completar DDL + Backend +- [ ] Clinicas/Retail/Vidrio: Iniciar DDL + +### Fase 4: Consolidacion (Semanas 17-24) +- [ ] SDK compartido +- [ ] CI/CD completo +- [ ] Documentacion de usuario + +--- + +## 8. METRICAS DE ALINEACION + +### Checklist de Alineacion por Vertical + +| Criterio | Peso | Construccion | Mecanicas | Clinicas | Retail | Vidrio | +|----------|------|--------------|-----------|----------|--------|--------| +| CONTEXTO-PROYECTO.md | 10% | OK | OK | OK | OK | OK | +| HERENCIA-ERP-CORE.md | 15% | OK | OK | OK | OK | OK | +| HERENCIA-SPECS-CORE.md | 10% | OK | OK | OK | OK | OK | +| HERENCIA-DIRECTIVAS.md | 10% | OK | OK | OK | OK | OK | +| DDL con RLS | 20% | 50% | 100% | 0% | 0% | 0% | +| Backend hereda BaseService | 15% | NO | NO | NO | NO | NO | +| Inventarios SSOT | 10% | OK | OK | OK | OK | OK | +| Tests unitarios | 10% | NO | NO | NO | NO | NO | + +**Score de Alineacion (Actualizado 2025-12-08):** +- Construccion: 65% (+40%) +- Mecanicas Diesel: 85% (+10%) +- Clinicas: 55% (+40%) +- Retail: 55% (+40%) +- Vidrio Templado: 55% (+40%) + +--- + +## 9. CONCLUSION + +El proyecto ERP-Suite tiene una **arquitectura bien disenada** con: +- Separacion clara entre core y verticales +- Sistema de herencia documentado (SIMCO) +- Multi-tenancy robusto con RLS +- Documentacion exhaustiva + +### Estado Post-Analisis (Actualizado 2025-12-08) + +**Mejoras implementadas durante este analisis:** + +1. **Documentacion de herencia:** Todas las verticales ahora tienen documentos HERENCIA-* completos +2. **Inventarios SSOT:** Todas las verticales tienen MASTER_INVENTORY.yml y archivos relacionados +3. **Estandar de schemas:** Documento `ESTANDAR-NOMENCLATURA-SCHEMAS.md` creado con convenciones + +**Pendientes criticos:** + +1. **erp-core incompleto** (60%) - Bloquea desarrollo de verticales +2. **Migracion de schemas** - Aplicar prefijos estandarizados +3. **Tests de integracion** - No existen entre core y verticales +4. **Backend BaseService** - Ninguna vertical hereda del patron base + +### Proximos Pasos Recomendados + +| Prioridad | Accion | Responsable | +|-----------|--------|-------------| +| P0 | Completar MGN-001 a MGN-005 en erp-core | Backend Team | +| P0 | Iniciar frontend de Mecanicas Diesel | Frontend Team | +| P1 | Migrar schemas a nomenclatura estandar | Database Team | +| P1 | Completar DDL de Construccion (4 schemas) | Database Team | +| P2 | Crear tests de integracion core-vertical | QA Team | + +--- + +## 10. DOCUMENTOS GENERADOS + +| Documento | Ubicacion | Proposito | +|-----------|-----------|-----------| +| Analisis Arquitectonico | `docs/ANALISIS-ARQUITECTURA-ERP-SUITE.md` | Este documento | +| Estandar de Schemas | `docs/ESTANDAR-NOMENCLATURA-SCHEMAS.md` | Convencion de nomenclatura BD | + +--- + +*Documento generado automaticamente por Architecture Analyst Agent* +*Sistema NEXUS - Fabrica de Software con Agentes IA* +*Fecha: 2025-12-08* diff --git a/docs/ANALISIS-ESTRUCTURA-DOCUMENTACION.md b/docs/ANALISIS-ESTRUCTURA-DOCUMENTACION.md new file mode 100644 index 0000000..a0f1712 --- /dev/null +++ b/docs/ANALISIS-ESTRUCTURA-DOCUMENTACION.md @@ -0,0 +1,395 @@ +# ANALISIS DE ESTRUCTURA DE DOCUMENTACION - ERP Suite + +**Fecha:** 2025-12-05 +**Agente:** Requirements-Analyst +**Referencia:** Filosofia GAMILIT + +--- + +## 1. PROBLEMA IDENTIFICADO + +La documentacion de ERP Suite **NO cumple** con la filosofia de documentacion establecida en GAMILIT. La estructura actual esta orientada a **tipos de documento** en lugar de **modulos funcionales**, lo que dificulta: + +1. **Trazabilidad:** No hay conexion clara RF -> ET -> US -> Codigo +2. **Inventarios:** No existen inventarios consolidados de objetos +3. **Dependencias:** No hay grafo de dependencias documentado +4. **Localizacion:** Dificil encontrar toda la informacion de un modulo +5. **Conflictos:** Riesgo de duplicar objetos sin detectarlo + +--- + +## 2. COMPARATIVA GAMILIT vs ERP Suite + +### 2.1 Estructura GAMILIT (CORRECTA) + +``` +docs/ +├── 01-fase-alcance-inicial/ +│ └── EAI-001-fundamentos/ <- MODULO AUTOCONTENIDO +│ ├── _MAP.md <- Indice con metricas +│ ├── README.md <- Descripcion epica +│ ├── requerimientos/ <- RF del modulo +│ │ ├── RF-AUTH-001.md +│ │ └── RF-AUTH-002.md +│ ├── especificaciones/ <- ET del modulo +│ │ ├── ET-AUTH-001.md +│ │ └── ET-AUTH-002.md +│ ├── historias-usuario/ <- US del modulo +│ │ ├── US-FUND-001.md +│ │ └── US-FUND-002.md +│ └── implementacion/ +│ └── TRACEABILITY.yml <- TRAZABILIDAD COMPLETA +│ +├── 90-transversal/ +│ └── inventarios/ <- INVENTARIOS GLOBALES +│ ├── DATABASE_INVENTORY.yml +│ ├── BACKEND_INVENTORY.yml +│ ├── FRONTEND_INVENTORY.yml +│ ├── TRACEABILITY_MATRIX.yml +│ └── DEPENDENCY_GRAPH.yml +│ +└── orchestration/ + └── inventarios/ <- INVENTARIOS OPERACIONALES + ├── MASTER_INVENTORY.yml + ├── SEEDS_INVENTORY.yml + └── TEST_COVERAGE.yml +``` + +**Filosofia:** Todo lo de un modulo esta JUNTO. Inventarios GLOBALES para evitar duplicados. + +### 2.2 Estructura ERP Suite Actual (INCORRECTA) + +``` +apps/erp-core/docs/ +├── 02-definicion-modulos/ <- Solo READMEs genericos +│ ├── INDICE-MODULOS.md +│ └── MGN-001-auth/ +│ └── README.md <- Solo descripcion +│ +├── 03-requerimientos/ <- RF separados por tipo +│ └── RF-auth/ +│ └── RF-AUTH-001.md +│ +├── 04-modelado/ +│ ├── especificaciones-tecnicas/ <- ET separados +│ │ ├── backend/ +│ │ └── frontend/ +│ └── database-design/ <- DDL separados +│ +├── 05-user-stories/ <- US separadas +│ └── mgn-001/ +│ └── US-MGN-001-001.md +│ +└── 08-epicas/ <- Epicas separadas + └── EPIC-MGN-001-auth.md + +# NO EXISTEN: +# - _MAP.md por modulo +# - TRACEABILITY.yml por modulo +# - Inventarios globales (DATABASE_INVENTORY, BACKEND_INVENTORY) +# - DEPENDENCY_GRAPH.yml +# - MASTER_INVENTORY.yml +``` + +**Problema:** Informacion DISPERSA. Sin trazabilidad. Sin inventarios. + +--- + +## 3. GAPS CRITICOS IDENTIFICADOS + +### 3.1 Estructura + +| Elemento | GAMILIT | ERP Suite | Gap | +|----------|---------|-----------|-----| +| Modulos autocontenidos | Si | No | CRITICO | +| _MAP.md por modulo | Si | No | CRITICO | +| TRACEABILITY.yml por epica | Si | No | CRITICO | +| Inventarios globales | 4 archivos | 0 | CRITICO | +| DEPENDENCY_GRAPH.yml | Si | No | ALTO | +| MASTER_INVENTORY.yml | Si | No | ALTO | +| Trazabilidad RF->Codigo | 100% | 0% | CRITICO | + +### 3.2 Contenido + +| Elemento | GAMILIT | ERP Suite | Gap | +|----------|---------|-----------|-----| +| RF con paths a implementacion | Si | No | ALTO | +| ET con endpoints especificos | Si | Parcial | MEDIO | +| US con criterios Gherkin | 100% | 30% | ALTO | +| Metricas por modulo | Si | No | ALTO | +| Bug fixes documentados | Si | No | MEDIO | +| Changelog por modulo | Si | No | MEDIO | + +### 3.3 Operacional + +| Elemento | GAMILIT | ERP Suite | +|----------|---------|-----------| +| Ubicacion canonica de inventarios | orchestration/inventarios/ | No existe | +| Tests coverage tracking | TEST_COVERAGE.yml | No existe | +| Seeds inventory | SEEDS_INVENTORY.yml | No existe | + +--- + +## 4. CONSECUENCIAS DE LA ESTRUCTURA ACTUAL + +1. **Duplicacion de objetos:** Sin inventario global, se pueden crear tablas/endpoints duplicados +2. **Conflictos de nombres:** Sin DEPENDENCY_GRAPH, no se detectan colisiones +3. **Implementacion sin traza:** Codigo sin referencia a RF/US +4. **Perdida de contexto:** Desarrollador debe buscar en 5+ carpetas para entender un modulo +5. **Metricas perdidas:** No hay forma de medir avance real vs planificado +6. **Deuda tecnica oculta:** Sin tracking de bugs/fixes + +--- + +## 5. PLAN DE REESTRUCTURACION PROPUESTO + +### Fase 1: Crear Estructura Base (Prioridad Critica) + +1. **Crear carpeta orchestration/inventarios/** + - MASTER_INVENTORY.yml + - DATABASE_INVENTORY.yml + - BACKEND_INVENTORY.yml + - FRONTEND_INVENTORY.yml + - DEPENDENCY_GRAPH.yml + - TRACEABILITY_MATRIX.yml + +2. **Reestructurar docs/ por modulos:** + ``` + apps/erp-core/docs/ + ├── 01-fase-foundation/ + │ ├── MGN-001-auth/ <- TODO junto + │ │ ├── _MAP.md + │ │ ├── README.md + │ │ ├── requerimientos/ + │ │ ├── especificaciones/ + │ │ ├── historias-usuario/ + │ │ └── implementacion/ + │ │ └── TRACEABILITY.yml + │ ├── MGN-002-users/ + │ ├── MGN-003-roles/ + │ └── MGN-004-tenants/ + │ + ├── 02-fase-core-business/ + │ ├── MGN-005-catalogs/ + │ ├── MGN-010-financial/ + │ └── ... + │ + └── 90-transversal/ + └── inventarios/ <- Inventarios de docs + ``` + +### Fase 2: Migrar Documentacion Existente + +1. Mover RF de `03-requerimientos/` a `MGN-XXX/requerimientos/` +2. Mover ET de `04-modelado/` a `MGN-XXX/especificaciones/` +3. Mover US de `05-user-stories/` a `MGN-XXX/historias-usuario/` +4. Eliminar estructura dispersa + +### Fase 3: Crear Trazabilidad + +1. Crear TRACEABILITY.yml por cada modulo MGN-XXX +2. Crear _MAP.md por cada modulo +3. Poblar inventarios globales + +### Fase 4: Aplicar a Verticales + +1. Replicar estructura en verticales/construccion/ +2. Replicar en otras verticales + +--- + +## 6. ESTRUCTURA OBJETIVO FINAL + +``` +erp-suite/ +├── apps/ +│ ├── erp-core/ +│ │ ├── docs/ +│ │ │ ├── 01-fase-foundation/ +│ │ │ │ ├── _MAP.md <- Indice de fase +│ │ │ │ ├── README.md +│ │ │ │ ├── MGN-001-auth/ +│ │ │ │ │ ├── _MAP.md <- Indice modulo (metricas) +│ │ │ │ │ ├── README.md <- Descripcion +│ │ │ │ │ ├── requerimientos/ +│ │ │ │ │ │ ├── RF-AUTH-001.md +│ │ │ │ │ │ └── RF-AUTH-002.md +│ │ │ │ │ ├── especificaciones/ +│ │ │ │ │ │ ├── ET-AUTH-001-backend.md +│ │ │ │ │ │ ├── ET-AUTH-002-frontend.md +│ │ │ │ │ │ └── ET-AUTH-003-database.md +│ │ │ │ │ ├── historias-usuario/ +│ │ │ │ │ │ ├── US-AUTH-001.md +│ │ │ │ │ │ └── US-AUTH-002.md +│ │ │ │ │ └── implementacion/ +│ │ │ │ │ └── TRACEABILITY.yml <- RF->ET->US->Codigo +│ │ │ │ ├── MGN-002-users/ +│ │ │ │ ├── MGN-003-roles/ +│ │ │ │ └── MGN-004-tenants/ +│ │ │ │ +│ │ │ ├── 02-fase-core-business/ +│ │ │ │ └── [misma estructura] +│ │ │ │ +│ │ │ ├── 03-fase-extended/ +│ │ │ │ └── [misma estructura] +│ │ │ │ +│ │ │ ├── 04-fase-saas/ +│ │ │ │ └── [misma estructura] +│ │ │ │ +│ │ │ └── 90-transversal/ +│ │ │ ├── inventarios/ +│ │ │ │ └── README.md <- Referencia a orchestration +│ │ │ └── templates/ +│ │ │ +│ │ └── orchestration/ +│ │ └── inventarios/ <- INVENTARIOS CANONICOS +│ │ ├── MASTER_INVENTORY.yml +│ │ ├── DATABASE_INVENTORY.yml +│ │ ├── BACKEND_INVENTORY.yml +│ │ ├── FRONTEND_INVENTORY.yml +│ │ ├── DEPENDENCY_GRAPH.yml +│ │ ├── TRACEABILITY_MATRIX.yml +│ │ ├── SEEDS_INVENTORY.yml +│ │ └── TEST_COVERAGE.yml +│ │ +│ └── verticales/ +│ └── construccion/ +│ ├── docs/ +│ │ └── [misma estructura] +│ └── orchestration/ +│ └── inventarios/ +``` + +--- + +## 7. EJEMPLO DE TRACEABILITY.yml PARA ERP + +```yaml +# TRACEABILITY.yml - MGN-001: Autenticacion +# Matriz de trazabilidad: Documentacion -> Codigo + +epic_code: MGN-001 +epic_name: Autenticacion +phase: 1 +phase_name: Foundation +story_points: 34 +status: ready + +# DOCUMENTACION +documentation: + requirements: + - id: RF-AUTH-001 + file: requerimientos/RF-AUTH-001-login.md + title: Login con Email/Password + status: documented + + - id: RF-AUTH-002 + file: requerimientos/RF-AUTH-002-tokens.md + title: Manejo de Tokens JWT + status: documented + + specifications: + - id: ET-AUTH-001 + file: especificaciones/ET-AUTH-001-backend.md + rf: RF-AUTH-001 + title: Backend Implementation + status: documented + + user_stories: + - id: US-MGN001-001 + file: historias-usuario/US-MGN001-001-login.md + title: Login con Email/Password + rf: [RF-AUTH-001] + story_points: 8 + status: ready + +# IMPLEMENTACION +implementation: + database: + schemas: + - name: core_auth + path: apps/database/ddl/schemas/core_auth/ + tables: + - name: users_auth + file: apps/database/ddl/schemas/core_auth/tables/users_auth.sql + rf: RF-AUTH-001 + - name: sessions + file: apps/database/ddl/schemas/core_auth/tables/sessions.sql + rf: RF-AUTH-002 + functions: + - name: validate_password + file: apps/database/ddl/schemas/core_auth/functions/validate_password.sql + rf: RF-AUTH-001 + + backend: + module: auth + path: apps/backend/src/modules/auth/ + services: + - name: auth.service.ts + methods: [login, logout, refresh] + rf: [RF-AUTH-001, RF-AUTH-002] + controllers: + - name: auth.controller.ts + endpoints: + - POST /api/v1/auth/login + - POST /api/v1/auth/logout + - POST /api/v1/auth/refresh + rf: [RF-AUTH-001, RF-AUTH-002] + guards: + - name: jwt-auth.guard.ts + rf: RF-AUTH-002 + + frontend: + feature: auth + path: apps/frontend/src/features/auth/ + components: + - LoginForm.tsx + - LogoutButton.tsx + stores: + - authStore.ts + +# DEPENDENCIAS +dependencies: + depends_on: [] # Primera epica + required_by: [MGN-002, MGN-003, MGN-004, ALL] + +# METRICAS +metrics: + story_points: + estimated: 34 + actual: null + variance: null + coverage: + unit_tests: 0% + integration_tests: 0% + e2e_tests: 0% +``` + +--- + +## 8. PROXIMOS PASOS INMEDIATOS + +1. [ ] Crear orchestration/inventarios/ en erp-core +2. [ ] Crear MASTER_INVENTORY.yml inicial +3. [ ] Crear DATABASE_INVENTORY.yml con objetos existentes +4. [ ] Reestructurar MGN-001 como ejemplo completo +5. [ ] Crear _MAP.md para MGN-001 +6. [ ] Crear TRACEABILITY.yml para MGN-001 +7. [ ] Documentar proceso en guia de desarrollo + +--- + +## 9. BENEFICIOS ESPERADOS + +1. **Trazabilidad completa:** Cualquier linea de codigo tiene traza a RF +2. **Prevencion de duplicados:** Inventarios detectan colisiones +3. **Localizacion rapida:** Todo de un modulo en una carpeta +4. **Metricas precisas:** Story points, coverage, bugs por modulo +5. **Onboarding facil:** Nuevo desarrollador entiende modulo rapido +6. **Mantenimiento eficiente:** Cambio en RF actualiza traza automatica + +--- + +**Generado por:** Requirements-Analyst +**Fecha:** 2025-12-05 +**Accion requerida:** Aprobar plan de reestructuracion diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md new file mode 100644 index 0000000..1e72e6d --- /dev/null +++ b/docs/ARCHITECTURE.md @@ -0,0 +1,565 @@ +# Architecture + +## Overview + +**ERP Suite** es una suite empresarial multi-vertical diseñada para SaaS simple autocontratado y proyectos integrales personalizados. La arquitectura maximiza la reutilización de código mediante un **core genérico** (60-70% compartido) que es extendido por **verticales especializadas** según el giro de negocio. + +**Diseño basado en Odoo:** La arquitectura sigue los patrones de diseño de Odoo ERP, adaptados para Node.js/React. + +## Tech Stack + +- **Backend:** Node.js 20+ + Express.js 4.18+ + TypeScript 5.3+ +- **Frontend Web:** React 18.3+ + Vite 5.4+ + TypeScript 5.6+ + Tailwind CSS +- **Frontend Mobile:** React Native (future) +- **Database:** PostgreSQL 15+ con RLS (Row-Level Security) +- **State Management:** Zustand 5.0 +- **Validation:** Zod 3.22+ +- **Auth:** JWT + bcryptjs +- **ORM:** pg (raw queries, no ORM pesado) + +## Module Structure + +### Project-Level Organization (Autocontenido) + +``` +erp-suite/ +├── apps/ +│ ├── erp-core/ # ERP Base (60-70% compartido) +│ │ ├── backend/ # Node.js + Express + TypeScript +│ │ │ └── src/ +│ │ │ ├── modules/ # 14 módulos core +│ │ │ │ ├── auth/ # JWT, bcrypt, refresh tokens +│ │ │ │ ├── users/ # CRUD usuarios +│ │ │ │ ├── companies/ # Multi-company management +│ │ │ │ ├── core/ # Catálogos (monedas, países, UoM) +│ │ │ │ ├── partners/ # Clientes/proveedores +│ │ │ │ ├── inventory/ # Productos, almacenes, stock +│ │ │ │ ├── financial/ # Contabilidad +│ │ │ │ ├── purchases/ # Órdenes de compra +│ │ │ │ ├── sales/ # Cotizaciones, pedidos +│ │ │ │ ├── projects/ # Proyectos, tareas, timesheets +│ │ │ │ ├── crm/ # Leads, oportunidades +│ │ │ │ ├── hr/ # Nómina básica +│ │ │ │ └── system/ # Mensajes, notificaciones +│ │ │ ├── shared/ # Código compartido +│ │ │ │ ├── services/ # BaseService genérico +│ │ │ │ ├── middleware/ # Auth, error handling +│ │ │ │ ├── utils/ # Helpers +│ │ │ │ └── types/ # TypeScript types +│ │ │ ├── config/ # Configuration +│ │ │ └── routes/ # API routes +│ │ │ +│ │ ├── frontend/ # React + Vite + Tailwind +│ │ │ └── src/ +│ │ │ ├── modules/ # Feature modules +│ │ │ ├── shared/ # Shared components +│ │ │ └── layouts/ # App layouts +│ │ │ +│ │ ├── database/ # PostgreSQL +│ │ │ ├── ddl/ # Schema definitions +│ │ │ │ └── schemas/ # 12 schemas, 144 tables +│ │ │ ├── migrations/ # Database migrations +│ │ │ └── seeds/ # Test data +│ │ │ +│ │ ├── docs/ # Documentación PROPIA del core +│ │ └── orchestration/ # Sistema de agentes PROPIO +│ │ +│ ├── verticales/ +│ │ ├── construccion/ # Vertical INFONAVIT (35%) +│ │ │ ├── backend/ # Extensiones backend +│ │ │ │ └── src/ +│ │ │ │ ├── modules/ # 15 módulos específicos +│ │ │ │ │ ├── projects/ # Override core projects +│ │ │ │ │ ├── budgets/ # Presupuestos obra +│ │ │ │ │ ├── construction/ # Control de obra +│ │ │ │ │ ├── quality/ # Calidad y postventa +│ │ │ │ │ ├── infonavit/ # Integración INFONAVIT +│ │ │ │ │ └── ... +│ │ │ │ └── shared/ # Extensiones compartidas +│ │ │ │ +│ │ │ ├── frontend/ # UI específica construcción +│ │ │ ├── database/ # Schemas adicionales +│ │ │ │ └── ddl/ +│ │ │ │ └── schemas/ # 7 schemas verticales +│ │ │ ├── docs/ # 403 docs (5.9 MB) +│ │ │ └── orchestration/ # Sistema de agentes PROPIO +│ │ │ +│ │ ├── vidrio-templado/ # Vertical (0%) +│ │ │ ├── docs/ +│ │ │ └── orchestration/ +│ │ │ +│ │ ├── mecanicas-diesel/ # Vertical (30%) +│ │ │ ├── docs/ +│ │ │ └── orchestration/ +│ │ │ +│ │ ├── retail/ # Vertical POS +│ │ └── clinicas/ # Vertical Clínicas +│ │ +│ ├── saas/ # Capa SaaS (billing, multi-tenant) +│ │ ├── onboarding/ # Onboarding de tenants +│ │ ├── admin/ # Admin panel SaaS +│ │ ├── billing/ # Facturación SaaS +│ │ └── portal/ # Portal cliente +│ │ +│ └── shared-libs/ # Librerías compartidas +│ └── core/ # Utilidades cross-project +│ +├── docs/ # Documentación GENERAL del suite +└── orchestration/ # Orquestación GENERAL del suite +``` + +## Database Schemas + +### ERP Core (12 schemas, 144 tables) + +| Schema | Purpose | Tables | Key Entities | +|--------|---------|--------|--------------| +| **auth** | Autenticación, usuarios, roles | 10 | users, roles, permissions, sessions | +| **core** | Partners, catálogos | 12 | partners, currencies, countries, uom | +| **analytics** | Contabilidad analítica | 7 | analytic_accounts, cost_centers | +| **financial** | Facturas, pagos | 15 | invoices, payments, journals, accounts | +| **products** | Productos, categorías | 8 | products, categories, pricelists | +| **inventory** | Almacenes, stock | 14 | warehouses, locations, stock_moves | +| **sales** | Ventas | 10 | quotations, sales_orders, deliveries | +| **purchases** | Compras | 12 | purchase_orders, receptions | +| **projects** | Proyectos, tareas | 18 | projects, tasks, timesheets | +| **hr** | Recursos humanos | 12 | employees, contracts, payroll | +| **crm** | CRM | 10 | leads, opportunities, campaigns | +| **system** | Sistema | 16 | messages, notifications, settings | + +### Vertical Construcción (7 schemas adicionales, 60+ tables) + +| Schema | Purpose | Tables | +|--------|---------|--------| +| **project_management** | Proyectos, desarrollos, fases | 15 | +| **financial_management** | Presupuestos, estimaciones | 12 | +| **construction_management** | Avances, recursos, materiales | 10 | +| **quality_management** | Inspecciones, pruebas | 8 | +| **infonavit_management** | Integración INFONAVIT | 7 | +| **purchasing_management** | Compras específicas | 6 | +| **crm_management** | CRM Derechohabientes | 5 | + +## Data Flow Architecture + +``` +┌──────────────┐ +│ Frontend │ (React SPA) +│ (Browser) │ +└──────┬───────┘ + │ HTTP + ▼ +┌─────────────────────────────────────────┐ +│ Backend API (Express.js) │ +│ ┌─────────────────────────────────┐ │ +│ │ Routes (REST Endpoints) │ │ +│ └────────┬────────────────────────┘ │ +│ ▼ │ +│ ┌─────────────────────────────────┐ │ +│ │ Controllers │ │ +│ └────────┬────────────────────────┘ │ +│ ▼ │ +│ ┌─────────────────────────────────┐ │ +│ │ Services (Business Logic) │ │ +│ │ - BaseService │ │ +│ │ - Multi-tenancy enforcement │ │ +│ └────────┬────────────────────────┘ │ +│ ▼ │ +│ ┌─────────────────────────────────┐ │ +│ │ Database (pg driver) │ │ +│ │ - Raw SQL queries │ │ +│ │ - Parameterized │ │ +│ └─────────────────────────────────┘ │ +└───────────┼──────────────────────────────┘ + ▼ + ┌─────────────────┐ + │ PostgreSQL │ + │ (RLS enabled) │ + │ tenant_id │ + └─────────────────┘ +``` + +### Multi-Tenancy Flow + +``` +1. User login → JWT with tenant_id +2. Request to API with JWT +3. Middleware extracts tenant_id +4. SET LOCAL app.current_tenant_id = 'tenant-uuid' +5. RLS policies filter data automatically +6. Only tenant's data returned +``` + +## Key Design Decisions + +### 1. BaseService Pattern (Elimina duplicación de código) + +**Decision:** Implementar servicio genérico base que todos los módulos extienden. + +**Rationale:** +- Elimina ~80% de código duplicado CRUD +- Multi-tenancy enforcement automático +- Paginación, filtrado, búsqueda consistente +- Soft-delete por defecto +- Transactions simplificadas + +**Implementation:** + +```typescript +// shared/services/base.service.ts +abstract class BaseService { + constructor( + protected tableName: string, + protected schema: string + ) {} + + async findAll( + tenantId: string, + filters?: Filters, + pagination?: Pagination + ): Promise> { + // Auto-adds tenant_id filter + // Supports: search, sort, pagination + // Returns: { data, total, page, limit } + } + + async findById(id: string, tenantId: string): Promise {} + + async create(data: CreateDto, tenantId: string, userId: string): Promise {} + + async update(id: string, data: UpdateDto, tenantId: string, userId: string): Promise {} + + async softDelete(id: string, tenantId: string, userId: string): Promise {} + + async withTransaction(fn: (client: PoolClient) => Promise): Promise {} +} +``` + +**Usage:** + +```typescript +// modules/products/product.service.ts +class ProductService extends BaseService { + constructor() { + super('products', 'products'); + } + + // Override only when needed + async findByBarcode(barcode: string, tenantId: string): Promise { + // Custom query + } +} +``` + +### 2. Schema-Level Multi-Tenancy + RLS + +**Decision:** Usar `tenant_id` en cada tabla + Row-Level Security de PostgreSQL. + +**Rationale:** +- Aislamiento a nivel de base de datos (más seguro) +- RLS previene acceso cruzado incluso con bugs +- No requiere filtros manuales en cada query +- Compatible con herramientas de BI + +**Implementation:** + +```sql +-- Todas las tablas +CREATE TABLE products.products ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES auth.tenants(id), + name VARCHAR(255) NOT NULL, + -- ... + deleted_at TIMESTAMPTZ +); + +-- RLS Policy estándar +ALTER TABLE products.products ENABLE ROW LEVEL SECURITY; + +CREATE POLICY tenant_isolation ON products.products + USING (tenant_id = current_setting('app.current_tenant_id')::uuid); +``` + +**Backend:** + +```typescript +// Middleware sets tenant context +app.use(async (req, res, next) => { + const tenantId = req.user.tenantId; + await pool.query(`SET LOCAL app.current_tenant_id = $1`, [tenantId]); + next(); +}); +``` + +### 3. Vertical Extension Pattern (Herencia de Módulos) + +**Decision:** Las verticales extienden módulos del core sin modificarlos. + +**Rationale:** +- Core permanece genérico y reutilizable +- Verticales no "rompen" el core +- Actualizaciones del core no afectan verticales +- Basado en patrón de Odoo ERP + +**Pattern:** + +```typescript +// Core: erp-core/backend/src/modules/projects/project.service.ts +class ProjectService extends BaseService { + // Logic genérica +} + +// Vertical: construccion/backend/src/modules/projects/construction-project.service.ts +class ConstructionProjectService extends ProjectService { + // Override methods + async create(data: CreateConstructionProjectDto, tenantId, userId) { + // Add construction-specific logic + const project = await super.create(data, tenantId, userId); + await this.createDevelopment(project.id, data.development); + return project; + } + + // Add new methods + async createPhase(projectId: string, phase: PhaseDto) {} + async linkToINFONAVIT(projectId: string, infonavitData: any) {} +} +``` + +### 4. Raw SQL over Heavy ORM + +**Decision:** Usar driver `pg` con queries SQL en lugar de ORM (TypeORM, Prisma). + +**Rationale:** +- Mayor control sobre queries complejas +- Mejor performance (no overhead ORM) +- DDL mantenido manualmente = documentación viva +- Compatible con RLS (muchos ORMs tienen problemas) +- Evita migraciones automáticas peligrosas + +**Trade-off:** +- Más código SQL manual +- No hay auto-migrations +- Type-safety requiere interfaces manuales + +**Mitigación:** +- BaseService abstrae CRUD común +- TypeScript interfaces tipan resultados +- SQL formateado y versionado en DDL + +### 5. Soft Delete por Defecto + +**Decision:** Todas las tablas tienen `deleted_at` para soft delete. + +**Rationale:** +- Cumplimiento regulatorio (auditoría) +- Recuperación de datos borrados +- Integridad referencial preservada +- Historial completo + +**Implementation:** + +```sql +ALTER TABLE products.products +ADD COLUMN deleted_at TIMESTAMPTZ; + +-- BaseService auto-filtra deleted_at IS NULL +``` + +### 6. Pattern-Based on Odoo + +**Decision:** Replicar patrones de diseño de Odoo ERP (módulos, herencia, vistas). + +**Rationale:** +- Odoo es el ERP open-source más exitoso +- Patrones probados en miles de empresas +- Equipo familiarizado con Odoo +- Facilita migración futura de datos Odoo + +**Patterns Adopted:** +- Modular architecture +- Inheritance (core → vertical) +- Catálogos (countries, currencies, UoM) +- Multi-company +- Wizard pattern for complex operations + +Ver: `/home/isem/workspace/core/knowledge-base/patterns/PATRON-CORE-ODOO.md` + +## Dependencies + +### Critical Dependencies + +| Dependency | Purpose | Criticality | +|------------|---------|-------------| +| **PostgreSQL 15+** | Database with RLS | CRITICAL | +| **Node.js 20+** | Runtime | CRITICAL | +| **Express.js** | Web framework | CRITICAL | +| **React 18+** | Frontend | CRITICAL | +| **pg** | PostgreSQL driver | CRITICAL | +| **Zod** | Validation | HIGH | +| **Zustand** | State management | MEDIUM | + +### Internal Dependencies + +- **erp-core:** Base compartida para todas las verticales +- **Verticales:** Dependen de erp-core (herencia) +- **SaaS layer:** Depende de erp-core y verticales + +## Security Considerations + +- **Authentication:** JWT con refresh tokens +- **Authorization:** RBAC (Role-Based Access Control) +- **Multi-tenancy:** RLS garantiza aislamiento de datos +- **Password Hashing:** bcryptjs (10 rounds) +- **Input Validation:** Zod schemas +- **SQL Injection:** Parameterized queries (pg) +- **XSS Protection:** React auto-escape +- **CORS:** Configurado por entorno + +Ver documentación completa: [MULTI-TENANCY.md](./MULTI-TENANCY.md) + +## Performance Optimizations + +### Database +- Indexes en columnas frecuentes (`tenant_id`, `created_at`, foreign keys) +- Partitioning en tablas grandes (future) +- Connection pooling (pg.Pool) +- EXPLAIN ANALYZE para optimización + +### Backend +- Response caching (future: Redis) +- Pagination obligatoria en listas +- Lazy loading de relaciones +- Batch operations + +### Frontend +- Code splitting (React.lazy) +- Virtual scrolling para listas largas +- Debouncing en búsquedas +- Optimistic UI updates + +## Deployment Strategy + +**Current:** Development environment + +**Future Production:** +- Docker containers +- Kubernetes orchestration +- Multi-region for latency +- Database replicas (read/write split) + +## Monitoring & Observability + +**Planned:** +- Winston logging +- Error tracking (Sentry) +- Performance monitoring (Datadog) +- Database monitoring (pgAdmin, pg_stat_statements) + +## Vertical Development Order + +**Recomendado:** + +1. **ERP Core** (base genérica) - 60% completado +2. **Construcción** (más avanzado) - 35% completado +3. **Vidrio Templado** - 0% +4. **Mecánicas Diesel** - 30% +5. **Retail** - 0% +6. **Clínicas** - 0% + +## Module Breakdown (ERP Core) + +### Auth Module +- JWT authentication +- Refresh tokens +- Password reset +- Email verification +- RBAC (roles, permissions) + +### Users Module +- CRUD usuarios +- User profiles +- Preferences +- Activity tracking + +### Companies Module +- Multi-company support +- Company settings +- Fiscal configuration + +### Partners Module +- Clientes y proveedores +- Contactos +- Direcciones +- Categorías + +### Inventory Module +- Productos +- Categorías +- Almacenes +- Movimientos de stock +- Valoración (FIFO, LIFO, Average) + +### Financial Module +- Plan de cuentas +- Diarios contables +- Asientos contables +- Conciliación bancaria +- Reportes financieros + +### Sales Module +- Cotizaciones +- Órdenes de venta +- Entregas +- Facturación + +### Purchases Module +- Solicitudes de compra +- Órdenes de compra +- Recepciones +- Facturas de proveedor + +### Projects Module +- Proyectos +- Tareas +- Timesheets +- Planificación + +### HR Module +- Empleados +- Contratos +- Nómina básica +- Asistencias + +### CRM Module +- Leads +- Oportunidades +- Campañas +- Pipeline + +## Future Improvements + +### Short-term +- [ ] Completar modules faltantes en erp-core +- [ ] Implementar tests unitarios +- [ ] Agregar Redis caching +- [ ] Mobile app (React Native) + +### Medium-term +- [ ] Completar vertical Construcción +- [ ] Implementar vertical Vidrio Templado +- [ ] SaaS layer (billing, onboarding) +- [ ] Marketplace de módulos + +### Long-term +- [ ] Multi-currency completo +- [ ] Integración con pasarelas de pago +- [ ] BI/Analytics integrado +- [ ] AI-powered features +- [ ] White-label solution + +## References + +- [Multi-Tenancy Guide](./MULTI-TENANCY.md) +- [Vertical Development Guide](./VERTICAL-GUIDE.md) +- [Odoo Patterns](../../../workspace/core/knowledge-base/patterns/PATRON-CORE-ODOO.md) +- [Database Schema](../apps/erp-core/database/ddl/) +- [Directivas ERP](../apps/erp-core/orchestration/directivas/) diff --git a/docs/ESTANDAR-NOMENCLATURA-SCHEMAS.md b/docs/ESTANDAR-NOMENCLATURA-SCHEMAS.md new file mode 100644 index 0000000..e42edb0 --- /dev/null +++ b/docs/ESTANDAR-NOMENCLATURA-SCHEMAS.md @@ -0,0 +1,345 @@ +# Estandar de Nomenclatura de Schemas - ERP Suite + +**Version:** 1.0.0 +**Fecha:** 2025-12-08 +**Autor:** Architecture Analyst Agent +**Estado:** APROBADO + +--- + +## 1. Proposito + +Este documento define la convencion de nomenclatura para schemas de base de datos en todo el ecosistema ERP-Suite, asegurando consistencia entre erp-core y todas las verticales. + +--- + +## 2. Convencion General + +### 2.1 Formato de Nombres + +``` +{prefijo}_{dominio} +``` + +| Componente | Descripcion | Ejemplo | +|------------|-------------|---------| +| prefijo | Identificador del proyecto (3 letras) | `erp`, `con`, `mec` | +| dominio | Area funcional | `auth`, `inventory`, `sales` | + +### 2.2 Prefijos por Proyecto + +| Proyecto | Prefijo | Descripcion | +|----------|---------|-------------| +| **erp-core** | `erp_` | Schemas del core compartido | +| **construccion** | `con_` | Vertical de construccion | +| **mecanicas-diesel** | `mec_` | Vertical de mecanicas | +| **clinicas** | `cli_` | Vertical de clinicas | +| **retail** | `ret_` | Vertical de retail/POS | +| **vidrio-templado** | `vit_` | Vertical de vidrio templado | + +--- + +## 3. Schemas del ERP-Core + +### 3.1 Schemas Base (Compartidos) + +| Schema Actual | Schema Estandar | Descripcion | +|---------------|-----------------|-------------| +| `auth` | `erp_auth` | Autenticacion, sesiones | +| `core` | `erp_core` | Catalogos base, configuracion | +| `financial` | `erp_financial` | Contabilidad, diarios | +| `inventory` | `erp_inventory` | Productos, almacenes | +| `purchase` | `erp_purchase` | Ordenes de compra | +| `sales` | `erp_sales` | Cotizaciones, pedidos | +| `projects` | `erp_projects` | Proyectos, tareas | +| `system` | `erp_system` | Notificaciones, logs | +| `billing` | `erp_billing` | SaaS subscripciones | +| `crm` | `erp_crm` | Leads, oportunidades | +| `hr` | `erp_hr` | Recursos humanos | +| `analytics` | `erp_analytics` | Contabilidad analitica | + +--- + +## 4. Schemas por Vertical + +### 4.1 Construccion (`con_*`) + +| Schema | Descripcion | Tablas Estimadas | +|--------|-------------|------------------| +| `con_projects` | Proyectos, fraccionamientos, fases | 8 | +| `con_budgets` | Presupuestos, partidas, costos | 10 | +| `con_estimates` | Estimaciones, avances | 6 | +| `con_infonavit` | Integracion INFONAVIT | 6 | +| `con_quality` | Calidad, inspecciones | 5 | +| `con_contracts` | Contratos, subcontratos | 5 | +| `con_hse` | Seguridad, higiene | 8 | + +### 4.2 Mecanicas Diesel (`mec_*`) + +| Schema | Descripcion | Tablas | +|--------|-------------|--------| +| `mec_workshop` | Configuracion de taller | 9 | +| `mec_service` | Ordenes de servicio, diagnosticos | 14 | +| `mec_parts` | Refacciones, inventario | 12 | +| `mec_vehicles` | Vehiculos, flotas | 8 | + +### 4.3 Clinicas (`cli_*`) + +| Schema | Descripcion | Tablas Estimadas | +|--------|-------------|------------------| +| `cli_patients` | Pacientes, expedientes | 8 | +| `cli_appointments` | Citas, agenda | 5 | +| `cli_medical` | Consultas, recetas | 10 | +| `cli_lab` | Laboratorio, resultados | 6 | +| `cli_pharmacy` | Farmacia, medicamentos | 5 | +| `cli_imaging` | Imagenologia, DICOM | 4 | + +### 4.4 Retail (`ret_*`) + +| Schema | Descripcion | Tablas Estimadas | +|--------|-------------|------------------| +| `ret_pos` | Punto de venta, cajas | 8 | +| `ret_store` | Tiendas, sucursales | 5 | +| `ret_loyalty` | Fidelizacion, puntos | 6 | +| `ret_ecommerce` | Tienda online | 8 | + +### 4.5 Vidrio Templado (`vit_*`) + +| Schema | Descripcion | Tablas Estimadas | +|--------|-------------|------------------| +| `vit_production` | Produccion, ordenes | 8 | +| `vit_cutting` | Corte, nesting | 5 | +| `vit_tempering` | Templado, hornos | 5 | +| `vit_quality` | Calidad, fragmentacion | 6 | +| `vit_dispatch` | Despacho, entregas | 4 | + +--- + +## 5. Convencion de Tablas + +### 5.1 Formato de Nombres + +```sql +-- Tablas en plural, snake_case +{schema}.{nombre_tabla_plural} + +-- Ejemplos +erp_auth.users +erp_inventory.products +con_projects.developments +mec_service.work_orders +``` + +### 5.2 Columnas Obligatorias + +Todas las tablas transaccionales DEBEN incluir: + +```sql +-- Identificador +id UUID PRIMARY KEY DEFAULT gen_random_uuid() + +-- Multi-tenancy +tenant_id UUID NOT NULL + +-- Auditoria +created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP +created_by UUID +updated_at TIMESTAMPTZ +updated_by UUID + +-- Soft delete +is_active BOOLEAN DEFAULT true +deleted_at TIMESTAMPTZ +deleted_by UUID +``` + +### 5.3 Indices + +```sql +-- Formato: idx_{tabla}_{columnas} +CREATE INDEX idx_users_tenant_id ON erp_auth.users(tenant_id); +CREATE INDEX idx_users_email ON erp_auth.users(email); + +-- Unique con soft delete +CREATE UNIQUE INDEX idx_users_email_active + ON erp_auth.users(email) + WHERE deleted_at IS NULL; +``` + +### 5.4 Foreign Keys + +```sql +-- Formato: fk_{origen}_to_{destino} +ALTER TABLE mec_service.work_orders + ADD CONSTRAINT fk_work_orders_to_vehicles + FOREIGN KEY (vehicle_id) REFERENCES mec_vehicles.vehicles(id); +``` + +### 5.5 Triggers + +```sql +-- Formato: trg_{tabla}_{accion} +CREATE TRIGGER trg_users_updated_at + BEFORE UPDATE ON erp_auth.users + FOR EACH ROW EXECUTE FUNCTION update_updated_at(); +``` + +--- + +## 6. RLS (Row-Level Security) + +### 6.1 Patron Estandar + +```sql +-- Habilitar RLS +ALTER TABLE {schema}.{tabla} ENABLE ROW LEVEL SECURITY; + +-- Policy de aislamiento por tenant +CREATE POLICY tenant_isolation ON {schema}.{tabla} + USING (tenant_id = current_setting('app.current_tenant_id')::uuid); +``` + +### 6.2 Variable de Contexto por Vertical + +| Vertical | Variable de Contexto | +|----------|---------------------| +| erp-core | `app.current_tenant_id` | +| construccion | `app.current_tenant_id` | +| mecanicas | `app.current_taller_id` | +| clinicas | `app.current_clinica_id` | +| retail | `app.current_tienda_id` | +| vidrio | `app.current_planta_id` | + +--- + +## 7. Migracion de Schemas Existentes + +### 7.1 Plan de Migracion + +Para proyectos con schemas existentes, seguir este proceso: + +1. **Crear nuevo schema** con prefijo correcto +2. **Copiar estructura** de tablas +3. **Migrar datos** con INSERT...SELECT +4. **Actualizar referencias** en codigo +5. **Deprecar schema antiguo** +6. **Eliminar schema antiguo** (siguiente version) + +### 7.2 Mapeo de Schemas Existentes + +#### erp-core (ya implementado) +```sql +-- Actual → Estandar (pendiente migracion) +auth → erp_auth +core → erp_core +financial → erp_financial +inventory → erp_inventory +purchase → erp_purchase +sales → erp_sales +projects → erp_projects +system → erp_system +billing → erp_billing +crm → erp_crm +hr → erp_hr +analytics → erp_analytics +``` + +#### construccion +```sql +-- Actual → Estandar +construction → con_projects +hr → con_hr (o mover a erp_hr) +hse → con_hse +``` + +#### mecanicas-diesel +```sql +-- Actual → Estandar +workshop_core → mec_workshop +service_management → mec_service +parts_management → mec_parts +vehicle_management → mec_vehicles +``` + +--- + +## 8. Validacion + +### 8.1 Checklist de Validacion + +```yaml +validacion_schema: + - [ ] Prefijo correcto segun proyecto + - [ ] Nombre en snake_case + - [ ] Tablas en plural + - [ ] Columnas obligatorias presentes + - [ ] RLS habilitado + - [ ] Indices de tenant_id + - [ ] Triggers de auditoria +``` + +### 8.2 Script de Validacion + +```sql +-- Verificar schemas con prefijo correcto +SELECT schema_name +FROM information_schema.schemata +WHERE schema_name LIKE 'erp_%' + OR schema_name LIKE 'con_%' + OR schema_name LIKE 'mec_%' + OR schema_name LIKE 'cli_%' + OR schema_name LIKE 'ret_%' + OR schema_name LIKE 'vit_%'; + +-- Verificar RLS habilitado +SELECT schemaname, tablename, rowsecurity +FROM pg_tables +WHERE schemaname LIKE '%_%' + AND rowsecurity = false; +``` + +--- + +## 9. Excepciones + +### 9.1 Schemas de Sistema + +Los siguientes schemas NO requieren prefijo: + +- `public` - Extensiones PostgreSQL +- `pg_catalog` - Sistema PostgreSQL +- `information_schema` - Metadatos + +### 9.2 Schemas de Migracion + +Durante la migracion, pueden coexistir schemas antiguos y nuevos: + +```sql +-- Temporal durante migracion +auth -- Antiguo (deprecado) +erp_auth -- Nuevo (activo) +``` + +--- + +## 10. Referencias + +| Documento | Ubicacion | +|-----------|-----------| +| ADR-007 Database Design | `erp-core/docs/97-adr/ADR-007-database-design.md` | +| DDL erp-core | `erp-core/database/ddl/` | +| DDL mecanicas | `mecanicas-diesel/database/ddl/` | +| DDL construccion | `construccion/database/ddl/` | + +--- + +## 11. Historial de Cambios + +| Version | Fecha | Cambios | +|---------|-------|---------| +| 1.0.0 | 2025-12-08 | Version inicial | + +--- + +*Documento de arquitectura - ERP Suite* +*Sistema NEXUS - Fabrica de Software con Agentes IA* diff --git a/docs/ESTRUCTURA-DOCUMENTACION-ERP.md b/docs/ESTRUCTURA-DOCUMENTACION-ERP.md new file mode 100644 index 0000000..5f63090 --- /dev/null +++ b/docs/ESTRUCTURA-DOCUMENTACION-ERP.md @@ -0,0 +1,346 @@ +# Estructura de Documentacion - ERP Suite + +**Version:** 1.0.0 +**Fecha:** 2025-12-05 + +--- + +## Vision General + +Este documento define la estructura estandar de documentacion para todos los proyectos de la suite ERP: +- **ERP Core** (base generica) +- **Verticales** (construccion, vidrio-templado, mecanicas-diesel, clinicas, retail) + +--- + +## Principio: Documentacion Pre-Desarrollo + +> **Toda documentacion debe existir ANTES de iniciar el desarrollo** + +Ver: `apps/erp-core/orchestration/directivas/DIRECTIVA-DOCUMENTACION-PRE-DESARROLLO.md` + +--- + +## Estructura de Directorios + +### ERP Core (Base) + +``` +apps/erp-core/ +├── docs/ +│ ├── 00-vision-general/ +│ │ ├── VISION-ERP-CORE.md +│ │ ├── ARQUITECTURA-GENERAL.md +│ │ └── ROADMAP.md +│ │ +│ ├── 00-analisis-referencias/ +│ │ ├── ANALISIS-ODOO.md +│ │ ├── PATRONES-REFERENCIA.md +│ │ └── BENCHMARKS.md +│ │ +│ ├── 01-definicion-modulos/ +│ │ ├── INDICE-MODULOS.md +│ │ ├── MGN-001-auth/ +│ │ │ ├── DEFINICION.md +│ │ │ └── DEPENDENCIAS.md +│ │ ├── MGN-002-users/ +│ │ └── ... (hasta MGN-015) +│ │ +│ ├── 01-requerimientos/ +│ │ ├── RF-auth/ +│ │ │ ├── RF-AUTH-001.md +│ │ │ └── INDICE-RF-AUTH.md +│ │ ├── RF-users/ +│ │ ├── RNF/ +│ │ │ └── RNF-PERFORMANCE.md +│ │ └── MATRIZ-TRAZABILIDAD.md +│ │ +│ ├── 02-modelado/ +│ │ ├── database-design/ +│ │ │ ├── ERD-COMPLETO.md +│ │ │ ├── DDL-SPEC-core_auth.md +│ │ │ ├── DDL-SPEC-core_users.md +│ │ │ ├── DDL-SPEC-core_partners.md +│ │ │ └── DICCIONARIO-DATOS.md +│ │ ├── domain-models/ +│ │ │ ├── DM-auth.md +│ │ │ └── AGREGADOS.md +│ │ └── especificaciones-tecnicas/ +│ │ ├── ET-auth-database.md +│ │ ├── ET-auth-backend.md +│ │ ├── ET-auth-frontend.md +│ │ └── ET-auth-integration.md +│ │ +│ ├── 03-user-stories/ +│ │ ├── MGN-001-auth/ +│ │ │ ├── US-MGN001-001.md +│ │ │ ├── US-MGN001-002.md +│ │ │ └── BACKLOG-MGN001.md +│ │ ├── MGN-002-users/ +│ │ └── BACKLOG-MAESTRO.md +│ │ +│ ├── 04-test-plans/ +│ │ ├── TP-auth.md +│ │ ├── TC-auth/ +│ │ │ └── TC-AUTH-001.md +│ │ └── ESTRATEGIA-TESTING.md +│ │ +│ ├── 90-transversal/ +│ │ ├── SEGURIDAD.md +│ │ ├── MULTI-TENANCY.md +│ │ └── AUDITORIA.md +│ │ +│ ├── 95-guias-desarrollo/ +│ │ ├── GUIA-BACKEND.md +│ │ ├── GUIA-FRONTEND.md +│ │ ├── GUIA-DATABASE.md +│ │ └── CONVENCIONES.md +│ │ +│ └── 97-adr/ +│ ├── ADR-001-stack-tecnologico.md +│ ├── ADR-002-multi-tenancy.md +│ └── INDICE-ADR.md +│ +└── orchestration/ + ├── 00-guidelines/ + │ ├── CONTEXTO-PROYECTO.md + │ └── HERENCIA-DIRECTIVAS.md + ├── directivas/ + │ ├── DIRECTIVA-MULTI-TENANT.md + │ ├── DIRECTIVA-EXTENSION-VERTICALES.md + │ ├── DIRECTIVA-DOCUMENTACION-PRE-DESARROLLO.md + │ └── DIRECTIVA-PATRONES-ODOO.md + └── ... (estructura NEXUS estandar) +``` + +### Verticales (Extension) + +Cada vertical EXTIENDE la documentacion del core, no la duplica. + +``` +apps/verticales/{vertical}/ +├── docs/ +│ ├── 00-vision-general/ +│ │ ├── VISION-{VERTICAL}.md # Vision especifica +│ │ └── MAPEO-CORE.md # Que modulos del core usa +│ │ +│ ├── 01-requerimientos/ +│ │ ├── RF-{MAI-NNN}/ # Solo reqs NUEVOS de vertical +│ │ │ ├── RF-{MAI-NNN}-001.md +│ │ │ └── INDICE-RF.md +│ │ └── EXTENSIONES-CORE.md # Extensiones a RF del core +│ │ +│ ├── 02-modelado/ +│ │ ├── database-design/ +│ │ │ ├── ERD-{VERTICAL}.md # Solo schemas de vertical +│ │ │ └── DDL-SPEC-vertical_{x}.md +│ │ └── especificaciones-tecnicas/ +│ │ └── ET-{modulo}-extension.md # Extensiones al core +│ │ +│ ├── 03-user-stories/ +│ │ ├── {MAI-NNN}/ # Modulos especificos +│ │ │ ├── US-{MAI-NNN}-001.md +│ │ │ └── BACKLOG.md +│ │ └── BACKLOG-{VERTICAL}.md +│ │ +│ ├── 04-test-plans/ +│ │ └── TP-{modulo}.md +│ │ +│ └── 90-transversal/ +│ └── INTEGRACIONES-{VERTICAL}.md +│ +└── orchestration/ + ├── 00-guidelines/ + │ ├── CONTEXTO-PROYECTO.md # Contexto de la vertical + │ └── HERENCIA-DIRECTIVAS.md # Hereda core + erp-core + ├── directivas/ + │ └── DIRECTIVA-{VERTICAL}.md # Directivas propias + └── ... (estructura NEXUS estandar) +``` + +--- + +## Nomenclatura de Modulos + +### Core (MGN - Modulo Generico) + +| Codigo | Modulo | Descripcion | +|--------|--------|-------------| +| MGN-001 | auth | Autenticacion y sesiones | +| MGN-002 | users | Gestion de usuarios | +| MGN-003 | roles | Roles y permisos (RBAC) | +| MGN-004 | tenants | Multi-tenancy | +| MGN-005 | catalogs | Catalogos maestros | +| MGN-006 | settings | Configuracion sistema | +| MGN-007 | audit | Auditoria y logs | +| MGN-008 | notifications | Notificaciones | +| MGN-009 | reports | Reportes genericos | +| MGN-010 | financial | Contabilidad basica | +| MGN-011 | inventory | Inventario basico | +| MGN-012 | purchasing | Compras basicas | +| MGN-013 | sales | Ventas basicas | +| MGN-014 | crm | CRM basico | +| MGN-015 | projects | Proyectos genericos | + +### Construccion (MAI - Modulo Arquitectura Inmobiliaria) + +| Codigo | Modulo | Descripcion | +|--------|--------|-------------| +| MAI-001 | fundamentos | Base de construccion | +| MAI-002 | proyectos-obra | Proyectos de construccion | +| MAI-003 | presupuestos | Presupuestos de obra | +| MAI-004 | compras-inventarios | Compras especializadas | +| MAI-005 | control-obra | Control de avances | +| MAI-006 | subcontratistas | Gestion subcontratistas | +| MAI-007 | infonavit | Integracion INFONAVIT | + +### Vidrio Templado (MVT - Modulo Vidrio Templado) + +| Codigo | Modulo | Descripcion | +|--------|--------|-------------| +| MVT-001 | produccion | Ordenes de produccion | +| MVT-002 | corte-optimizacion | Optimizacion de corte | +| MVT-003 | templado | Proceso de templado | +| MVT-004 | instalacion | Instalacion en sitio | + +### Mecanicas Diesel (MMD - Modulo Mecanica Diesel) + +| Codigo | Modulo | Descripcion | +|--------|--------|-------------| +| MMD-001 | ordenes-servicio | Ordenes de trabajo | +| MMD-002 | diagnostico | Diagnostico diesel | +| MMD-003 | refacciones | Refacciones especializadas | + +--- + +## Flujo de Documentacion + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ PASO 1: REQUERIMIENTOS │ +│ ───────────────────── │ +│ • Crear RF-{modulo}-NNN.md con criterios de aceptacion │ +│ • Definir reglas de negocio │ +│ • Identificar dependencias con otros modulos │ +│ • Actualizar MATRIZ-TRAZABILIDAD.md │ +│ │ +│ Entregable: docs/01-requerimientos/RF-{modulo}/ │ +└────────────────────────────┬────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────────────────┐ +│ PASO 2: MODELADO DATABASE │ +│ ──────────────────────── │ +│ • Disenar diagrama ER (Mermaid) │ +│ • Crear DDL-SPEC-{schema}.md con todas las tablas │ +│ • Definir indices, constraints, triggers │ +│ • Especificar RLS policies │ +│ • Actualizar DICCIONARIO-DATOS.md │ +│ │ +│ Entregable: docs/02-modelado/database-design/ │ +└────────────────────────────┬────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────────────────┐ +│ PASO 3: ESPECIFICACIONES TECNICAS │ +│ ─────────────────────────────── │ +│ • ET-{modulo}-database.md (DDL final) │ +│ • ET-{modulo}-backend.md (endpoints, DTOs, validaciones) │ +│ • ET-{modulo}-frontend.md (componentes, paginas, estados) │ +│ • ET-{modulo}-integration.md (flujos entre capas) │ +│ │ +│ Entregable: docs/02-modelado/especificaciones-tecnicas/ │ +└────────────────────────────┬────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────────────────┐ +│ PASO 4: USER STORIES │ +│ ────────────────── │ +│ • Crear US-{modulo}-NNN.md con Gherkin │ +│ • Asignar story points y prioridad │ +│ • Vincular a requerimientos (trazabilidad) │ +│ • Actualizar BACKLOG-{modulo}.md │ +│ │ +│ Entregable: docs/03-user-stories/{modulo}/ │ +└────────────────────────────┬────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────────────────┐ +│ PASO 5: PLAN DE PRUEBAS │ +│ ───────────────────── │ +│ • Crear TP-{modulo}.md con estrategia │ +│ • Definir casos de prueba criticos │ +│ • Establecer cobertura minima │ +│ │ +│ Entregable: docs/04-test-plans/ │ +└────────────────────────────┬────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────────────────┐ +│ PASO 6: APROBACION │ +│ ──────────────── │ +│ • Tech Lead revisa completitud │ +│ • PO valida contra requerimientos │ +│ • Marcar docs como APROBADO │ +│ │ +│ Estado: LISTO PARA DESARROLLO │ +└─────────────────────────────────────────────────────────────────┘ +``` + +--- + +## Checklist por Tipo de Documento + +### Requerimiento Funcional (RF) +- [ ] Identificacion completa (ID, prioridad, modulo) +- [ ] Descripcion clara +- [ ] Criterios de aceptacion (minimo 3) +- [ ] Reglas de negocio definidas +- [ ] Impacto en capas identificado +- [ ] Dependencias listadas + +### DDL Specification +- [ ] Diagrama ER actualizado +- [ ] Todas las tablas documentadas +- [ ] Columnas con tipo, nullable, default +- [ ] Indices definidos con proposito +- [ ] Constraints (PK, FK, UQ, CHK) +- [ ] Triggers especificados +- [ ] RLS policies definidas + +### Especificacion Tecnica Backend +- [ ] Estructura de modulo definida +- [ ] Todos los endpoints documentados +- [ ] DTOs con validaciones +- [ ] Manejo de errores +- [ ] Permisos requeridos + +### Historia de Usuario +- [ ] Formato "Como/Quiero/Para" +- [ ] Escenarios Gherkin +- [ ] Story points asignados +- [ ] Trazabilidad a RF +- [ ] Mockups/wireframes (si aplica) + +### Plan de Pruebas +- [ ] Alcance definido +- [ ] Cobertura minima establecida +- [ ] Casos criticos identificados +- [ ] Datos de prueba especificados + +--- + +## Referencias + +### Directivas Relacionadas +- `core/orchestration/directivas/DIRECTIVA-DOCUMENTACION-OBLIGATORIA.md` +- `erp-core/orchestration/directivas/DIRECTIVA-DOCUMENTACION-PRE-DESARROLLO.md` +- `erp-core/orchestration/directivas/DIRECTIVA-PATRONES-ODOO.md` + +### Templates +- `core/orchestration/templates/TEMPLATE-ANALISIS.md` +- `core/orchestration/templates/TEMPLATE-PLAN.md` + +### Recursos de Referencia +- **Catálogo central:** `core/catalog/` *(componentes reutilizables)* +- **Estándares:** `core/standards/` *(estándares de documentación)* + +--- + +**Version:** 1.0.0 +**Ultima actualizacion:** 2025-12-05 diff --git a/docs/MULTI-TENANCY.md b/docs/MULTI-TENANCY.md new file mode 100644 index 0000000..5852e33 --- /dev/null +++ b/docs/MULTI-TENANCY.md @@ -0,0 +1,674 @@ +# Multi-Tenancy Guide + +## Overview + +ERP Suite implementa **multi-tenancy a nivel de schema** usando PostgreSQL Row-Level Security (RLS) para garantizar aislamiento completo de datos entre tenants. + +**Modelo:** Shared database, shared schema, **isolated by tenant_id** + +## Architecture + +### Tenant Isolation Strategy + +``` +┌─────────────────────────────────────────┐ +│ Single PostgreSQL Database │ +│ │ +│ ┌────────────────────────────────────┐ │ +│ │ Table: products.products │ │ +│ │ ┌──────────────────────────────┐ │ │ +│ │ │ Tenant A rows (tenant_id=A) │ │ │ +│ │ ├──────────────────────────────┤ │ │ +│ │ │ Tenant B rows (tenant_id=B) │ │ │ +│ │ ├──────────────────────────────┤ │ │ +│ │ │ Tenant C rows (tenant_id=C) │ │ │ +│ │ └──────────────────────────────┘ │ │ +│ │ │ │ +│ │ RLS Policy: WHERE tenant_id = │ │ +│ │ current_setting('app.current_ │ │ +│ │ tenant_id')::uuid │ │ +│ └────────────────────────────────────┘ │ +└─────────────────────────────────────────┘ +``` + +### Why RLS (Row-Level Security)? + +**Advantages:** +- **Security at database level** - Even if application has bugs, data is isolated +- **Transparent to application** - No manual filtering in every query +- **Works with BI tools** - Reports automatically scoped to tenant +- **Audit trail** - PostgreSQL logs enforce tenant context + +**Disadvantages:** +- PostgreSQL specific (not portable to MySQL/MongoDB) +- Slight performance overhead (minimal) +- Requires SET LOCAL on each connection + +## Implementation + +### 1. Database Schema Design + +#### Tenant Table + +```sql +-- Schema: auth +CREATE TABLE auth.tenants ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + name VARCHAR(255) NOT NULL, + slug VARCHAR(100) NOT NULL UNIQUE, + status VARCHAR(20) NOT NULL DEFAULT 'active', + plan VARCHAR(50) NOT NULL DEFAULT 'free', + settings JSONB DEFAULT '{}', + created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), + updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), + deleted_at TIMESTAMPTZ +); + +-- Index +CREATE INDEX idx_tenants_slug ON auth.tenants(slug) WHERE deleted_at IS NULL; +CREATE INDEX idx_tenants_status ON auth.tenants(status); +``` + +#### User-Tenant Relationship + +```sql +CREATE TABLE auth.users ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES auth.tenants(id), + email VARCHAR(255) NOT NULL, + password_hash VARCHAR(255) NOT NULL, + -- ... + CONSTRAINT uq_user_email_tenant UNIQUE (email, tenant_id) +); + +CREATE INDEX idx_users_tenant_id ON auth.users(tenant_id); +``` + +#### Standard Table Structure + +**Every table** (except auth.tenants) must have: + +```sql +CREATE TABLE {schema}.{table} ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES auth.tenants(id), + + -- Business columns + -- ... + + -- Audit columns + created_by UUID REFERENCES auth.users(id), + updated_by UUID REFERENCES auth.users(id), + created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), + updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), + deleted_at TIMESTAMPTZ -- Soft delete +); + +-- Standard indexes +CREATE INDEX idx_{table}_tenant_id ON {schema}.{table}(tenant_id); +CREATE INDEX idx_{table}_deleted_at ON {schema}.{table}(deleted_at); +``` + +### 2. Row-Level Security Policies + +#### Enable RLS + +```sql +ALTER TABLE {schema}.{table} ENABLE ROW LEVEL SECURITY; +``` + +#### Standard Policy + +```sql +-- Policy: tenant_isolation +-- Applies to: SELECT, INSERT, UPDATE, DELETE +CREATE POLICY tenant_isolation ON {schema}.{table} + USING (tenant_id = current_setting('app.current_tenant_id')::uuid); +``` + +**What this does:** +- `USING` clause filters SELECT queries +- Also applies to UPDATE and DELETE +- INSERT requires tenant_id to match + +#### Super Admin Bypass (Optional) + +```sql +-- Allow super admins to see all data +CREATE POLICY admin_bypass ON {schema}.{table} + USING ( + current_setting('app.current_tenant_id')::uuid = tenant_id + OR + current_setting('app.is_super_admin', true)::boolean = true + ); +``` + +#### Example: Full RLS Setup + +```sql +-- Create table +CREATE TABLE products.products ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES auth.tenants(id), + name VARCHAR(255) NOT NULL, + sku VARCHAR(100), + price NUMERIC(12, 2), + created_by UUID REFERENCES auth.users(id), + created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), + updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), + deleted_at TIMESTAMPTZ +); + +-- Indexes +CREATE INDEX idx_products_tenant_id ON products.products(tenant_id); +CREATE INDEX idx_products_sku ON products.products(tenant_id, sku) WHERE deleted_at IS NULL; + +-- Enable RLS +ALTER TABLE products.products ENABLE ROW LEVEL SECURITY; + +-- Create policy +CREATE POLICY tenant_isolation ON products.products + USING (tenant_id = current_setting('app.current_tenant_id')::uuid); + +-- Grant permissions +GRANT SELECT, INSERT, UPDATE, DELETE ON products.products TO erp_app_user; +``` + +### 3. Backend Implementation + +#### Middleware: Set Tenant Context + +```typescript +// middleware/tenant-context.middleware.ts +import { Request, Response, NextFunction } from 'express'; +import pool from '../config/database'; + +export const setTenantContext = async ( + req: Request, + res: Response, + next: NextFunction +) => { + const tenantId = req.user?.tenantId; // From JWT + + if (!tenantId) { + return res.status(401).json({ error: 'Tenant not found' }); + } + + try { + // Set tenant context for this connection + await pool.query( + `SET LOCAL app.current_tenant_id = $1`, + [tenantId] + ); + + // Optional: Set super admin flag + if (req.user?.role === 'super_admin') { + await pool.query(`SET LOCAL app.is_super_admin = true`); + } + + next(); + } catch (error) { + console.error('Error setting tenant context:', error); + res.status(500).json({ error: 'Internal server error' }); + } +}; +``` + +**Apply to all routes:** + +```typescript +// app.ts +import express from 'express'; +import { authenticateJWT } from './middleware/auth.middleware'; +import { setTenantContext } from './middleware/tenant-context.middleware'; + +const app = express(); + +// Apply to all routes after authentication +app.use(authenticateJWT); +app.use(setTenantContext); + +// Now all routes are tenant-scoped +app.use('/api/products', productRoutes); +``` + +#### BaseService with Tenant Enforcement + +```typescript +// shared/services/base.service.ts +export abstract class BaseService { + constructor( + protected tableName: string, + protected schema: string + ) {} + + async findAll( + tenantId: string, + filters?: Filters, + pagination?: Pagination + ): Promise> { + const { page = 1, limit = 20 } = pagination || {}; + const offset = (page - 1) * limit; + + // RLS automatically filters by tenant_id + // No need to add WHERE tenant_id = $1 + const query = ` + SELECT * + FROM ${this.schema}.${this.tableName} + WHERE deleted_at IS NULL + ORDER BY created_at DESC + LIMIT $1 OFFSET $2 + `; + + const result = await pool.query(query, [limit, offset]); + + return { + data: result.rows, + total: result.rowCount, + page, + limit + }; + } + + async create( + data: CreateDto, + tenantId: string, + userId: string + ): Promise { + const columns = Object.keys(data); + const values = Object.values(data); + + // Explicitly add tenant_id + columns.push('tenant_id', 'created_by'); + values.push(tenantId, userId); + + const placeholders = values.map((_, i) => `$${i + 1}`).join(', '); + + const query = ` + INSERT INTO ${this.schema}.${this.tableName} (${columns.join(', ')}) + VALUES (${placeholders}) + RETURNING * + `; + + const result = await pool.query(query, values); + return result.rows[0]; + } + + // Other CRUD methods... +} +``` + +### 4. Frontend Implementation + +#### Store Tenant Info in Auth State + +```typescript +// stores/auth.store.ts +import create from 'zustand'; + +interface User { + id: string; + email: string; + tenantId: string; + tenantName: string; + role: string; +} + +interface AuthState { + user: User | null; + token: string | null; + login: (email: string, password: string) => Promise; + logout: () => void; +} + +export const useAuthStore = create((set) => ({ + user: null, + token: null, + + login: async (email, password) => { + const response = await fetch('/api/auth/login', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ email, password }) + }); + + const { user, token } = await response.json(); + + set({ user, token }); + localStorage.setItem('token', token); + }, + + logout: () => { + set({ user: null, token: null }); + localStorage.removeItem('token'); + } +})); +``` + +#### Display Tenant Context + +```tsx +// components/TenantIndicator.tsx +import { useAuthStore } from '../stores/auth.store'; + +export const TenantIndicator = () => { + const user = useAuthStore((state) => state.user); + + if (!user) return null; + + return ( +
+ + Tenant: {user.tenantName} + +
+ ); +}; +``` + +## Multi-Tenant SaaS Features + +### Onboarding New Tenant + +```typescript +// services/tenant.service.ts +export class TenantService { + async createTenant(data: CreateTenantDto): Promise { + const client = await pool.connect(); + + try { + await client.query('BEGIN'); + + // 1. Create tenant + const tenantQuery = ` + INSERT INTO auth.tenants (name, slug, plan) + VALUES ($1, $2, $3) + RETURNING * + `; + const tenantResult = await client.query(tenantQuery, [ + data.name, + data.slug, + data.plan || 'free' + ]); + const tenant = tenantResult.rows[0]; + + // 2. Create admin user for tenant + const passwordHash = await bcrypt.hash(data.adminPassword, 10); + const userQuery = ` + INSERT INTO auth.users (tenant_id, email, password_hash, role) + VALUES ($1, $2, $3, $4) + RETURNING * + `; + await client.query(userQuery, [ + tenant.id, + data.adminEmail, + passwordHash, + 'admin' + ]); + + // 3. Initialize default data (catalogs, etc.) + await this.initializeTenantData(client, tenant.id); + + await client.query('COMMIT'); + return tenant; + + } catch (error) { + await client.query('ROLLBACK'); + throw error; + } finally { + client.release(); + } + } + + private async initializeTenantData(client: PoolClient, tenantId: string) { + // Create default categories + await client.query(` + INSERT INTO products.categories (tenant_id, name) + VALUES + ($1, 'General'), + ($1, 'Services') + `, [tenantId]); + + // Create default warehouse + await client.query(` + INSERT INTO inventory.warehouses (tenant_id, name, code) + VALUES ($1, 'Main Warehouse', 'WH01') + `, [tenantId]); + + // More defaults... + } +} +``` + +### Tenant Switching (for super admins) + +```typescript +// middleware/switch-tenant.middleware.ts +export const switchTenant = async ( + req: Request, + res: Response, + next: NextFunction +) => { + const targetTenantId = req.headers['x-tenant-id'] as string; + + if (req.user?.role !== 'super_admin') { + return res.status(403).json({ error: 'Only super admins can switch tenants' }); + } + + if (!targetTenantId) { + return res.status(400).json({ error: 'Target tenant ID required' }); + } + + // Override tenant context + await pool.query(`SET LOCAL app.current_tenant_id = $1`, [targetTenantId]); + next(); +}; +``` + +## Data Isolation Testing + +### Test Suite + +```typescript +// __tests__/multi-tenancy.test.ts +import { pool } from '../config/database'; +import { TenantService } from '../services/tenant.service'; +import { ProductService } from '../modules/products/product.service'; + +describe('Multi-Tenancy Data Isolation', () => { + let tenantA: Tenant; + let tenantB: Tenant; + + beforeAll(async () => { + tenantA = await TenantService.createTenant({ name: 'Tenant A', ... }); + tenantB = await TenantService.createTenant({ name: 'Tenant B', ... }); + }); + + it('should isolate data between tenants', async () => { + // Set context to Tenant A + await pool.query(`SET LOCAL app.current_tenant_id = $1`, [tenantA.id]); + + // Create product for Tenant A + const productA = await ProductService.create({ + name: 'Product A', + price: 100 + }, tenantA.id, 'user-a'); + + // Switch context to Tenant B + await pool.query(`SET LOCAL app.current_tenant_id = $1`, [tenantB.id]); + + // Try to fetch products (should only see Tenant B's data) + const products = await ProductService.findAll(tenantB.id); + + expect(products.data).toHaveLength(0); // Tenant B has no products + expect(products.data).not.toContainEqual(productA); + }); + + it('should prevent cross-tenant access', async () => { + // Set context to Tenant A + await pool.query(`SET LOCAL app.current_tenant_id = $1`, [tenantA.id]); + + // Create product for Tenant A + const productA = await ProductService.create({ + name: 'Product A' + }, tenantA.id, 'user-a'); + + // Switch to Tenant B + await pool.query(`SET LOCAL app.current_tenant_id = $1`, [tenantB.id]); + + // Try to access Tenant A's product + const result = await ProductService.findById(productA.id, tenantB.id); + + expect(result).toBeNull(); // RLS blocks access + }); +}); +``` + +## Performance Considerations + +### Indexing Strategy + +**Always index tenant_id:** + +```sql +CREATE INDEX idx_{table}_tenant_id ON {schema}.{table}(tenant_id); +``` + +**Composite indexes for common queries:** + +```sql +-- Query: Find product by SKU for tenant +CREATE INDEX idx_products_tenant_sku +ON products.products(tenant_id, sku) +WHERE deleted_at IS NULL; + +-- Query: List recent orders for tenant +CREATE INDEX idx_orders_tenant_created +ON sales.orders(tenant_id, created_at DESC); +``` + +### Query Performance + +**With RLS:** +```sql +EXPLAIN ANALYZE +SELECT * FROM products.products WHERE sku = 'ABC123'; + +-- Plan: +-- Index Scan using idx_products_tenant_sku +-- Filter: (tenant_id = '...'::uuid) ← Automatic +``` + +**RLS overhead:** ~5-10% (minimal with proper indexing) + +### Connection Pooling + +```typescript +// config/database.ts +import { Pool } from 'pg'; + +export const pool = new Pool({ + host: process.env.DB_HOST, + port: parseInt(process.env.DB_PORT || '5432'), + database: process.env.DB_NAME, + user: process.env.DB_USER, + password: process.env.DB_PASSWORD, + max: 20, // Max connections + idleTimeoutMillis: 30000, + connectionTimeoutMillis: 2000, +}); + +// Set tenant context on each query +pool.on('connect', async (client) => { + // This is set per-request, not per-connection + // Use middleware instead +}); +``` + +## Security Best Practices + +### 1. Always Validate Tenant Access + +```typescript +// Even with RLS, validate user belongs to tenant +if (req.user.tenantId !== req.params.tenantId) { + return res.status(403).json({ error: 'Forbidden' }); +} +``` + +### 2. Never Disable RLS + +```sql +-- ❌ NEVER DO THIS +ALTER TABLE products.products NO FORCE ROW LEVEL SECURITY; +``` + +### 3. Audit Tenant Changes + +```sql +CREATE TABLE audit.tenant_changes ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL, + user_id UUID NOT NULL, + action VARCHAR(50) NOT NULL, + table_name VARCHAR(100) NOT NULL, + record_id UUID, + old_data JSONB, + new_data JSONB, + created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() +); +``` + +### 4. Monitor Cross-Tenant Attempts + +```typescript +// Log suspicious activity +if (attemptedCrossTenantAccess) { + logger.warn('Cross-tenant access attempt', { + userId: req.user.id, + userTenant: req.user.tenantId, + targetTenant: req.params.tenantId, + ip: req.ip + }); +} +``` + +## Troubleshooting + +### RLS Not Working + +**Check if RLS is enabled:** +```sql +SELECT tablename, rowsecurity +FROM pg_tables +WHERE schemaname = 'products'; +``` + +**Check policies:** +```sql +SELECT * FROM pg_policies WHERE tablename = 'products'; +``` + +**Verify tenant context is set:** +```sql +SHOW app.current_tenant_id; +``` + +### Performance Issues + +**Check query plan:** +```sql +EXPLAIN ANALYZE +SELECT * FROM products.products WHERE name LIKE '%widget%'; +``` + +**Add missing indexes:** +```sql +CREATE INDEX idx_products_name ON products.products(tenant_id, name); +``` + +## References + +- [PostgreSQL RLS Documentation](https://www.postgresql.org/docs/current/ddl-rowsecurity.html) +- [Architecture Documentation](./ARCHITECTURE.md) +- [Database Schema](../apps/erp-core/database/ddl/) diff --git a/docs/PLAN-MIGRACION-SCHEMAS.md b/docs/PLAN-MIGRACION-SCHEMAS.md new file mode 100644 index 0000000..2f9bf8f --- /dev/null +++ b/docs/PLAN-MIGRACION-SCHEMAS.md @@ -0,0 +1,250 @@ +# Plan de Migración de Schemas - ERP Suite + +## Resumen Ejecutivo + +Este documento detalla el plan de migración para estandarizar los schemas de base de datos en todas las verticales del ERP Suite, alineándolos con el estándar definido en `ESTANDAR-NOMENCLATURA-SCHEMAS.md`. + +**Fecha**: 2025-12-08 +**Versión**: 1.0.0 +**Estado**: Planificado + +--- + +## 1. Estado Actual vs Estado Deseado + +### 1.1 Prefijos de Schema Estandarizados + +| Proyecto | Prefijo | Estado Actual | Estado Deseado | +|----------|---------|---------------|----------------| +| erp-core | `erp_*` | Parcial | 100% | +| Construcción | `con_*` | No aplicado | 100% | +| Mecánicas Diesel | `mec_*` | No aplicado | 100% | +| Clínicas | `cli_*` | Sin DDL | 100% | +| Retail | `ret_*` | Sin DDL | 100% | +| Vidrio Templado | `vit_*` | Sin DDL | 100% | + +### 1.2 Schemas por Vertical + +#### erp-core (Base) +``` +erp_auth → Autenticación, usuarios, roles +erp_core → Entidades base (tenants, companies) +erp_core_shared → Funciones compartidas +erp_inventory → Inventario base +erp_purchase → Compras base +erp_hr → RRHH base +erp_financial → Contabilidad base +``` + +#### Construcción +``` +con_construction → Obras, lotes, avances +con_estimates → Estimaciones, anticipos +con_infonavit → Cumplimiento INFONAVIT +con_hr → Extensiones RRHH (destajo, cuadrillas) +con_hse → Seguridad industrial +``` + +#### Mecánicas Diesel +``` +mec_workshop → Taller, bahías, órdenes +mec_diagnostic → Diagnósticos, DTC codes +mec_inventory → Extensiones inventario (refacciones) +mec_vehicles → Vehículos, especificaciones +mec_quotes → Cotizaciones +``` + +--- + +## 2. Estrategia de Migración + +### 2.1 Enfoque: Migración Progresiva + +**No migrar schemas existentes** - Solo aplicar nomenclatura en nuevos desarrollos. + +Razones: +1. Evitar downtime en sistemas en producción +2. No romper código existente +3. Costo de migración vs beneficio + +### 2.2 Nuevos Proyectos + +Para **nuevos proyectos** o **verticales sin código**: +- Aplicar prefijos desde el inicio +- Seguir estándar de nomenclatura + +### 2.3 Proyectos Existentes + +Para **proyectos con código existente** (Construcción, Mecánicas Diesel): +- Documentar schemas actuales +- No renombrar +- Aplicar prefijo solo a tablas nuevas opcionales + +--- + +## 3. Orden de Ejecución DDL + +### 3.1 ERP-Core (Prerequisito) + +```bash +# Ejecutar en orden: +1. 00-extensions.sql # PostGIS, uuid-ossp +2. 01-auth-schema.sql # auth.tenants, auth.users, auth.roles +3. 02-core-schema.sql # core.*, core_shared.* +4. 03-inventory-schema.sql # inventory base +5. 04-purchase-schema.sql # purchase base +6. 05-hr-schema.sql # hr base +7. 06-financial-schema.sql # financial base +``` + +### 3.2 Construcción (Después de ERP-Core) + +```bash +# Ejecutar en orden: +1. 01-construction-schema-ddl.sql # 24 tablas +2. 02-hr-schema-ddl.sql # 8 tablas extensión +3. 03-hse-schema-ddl.sql # 58 tablas +4. 04-estimates-schema-ddl.sql # 8 tablas +5. 05-infonavit-schema-ddl.sql # 8 tablas +6. 06-inventory-ext-schema-ddl.sql # 4 tablas +7. 07-purchase-ext-schema-ddl.sql # 5 tablas +``` + +### 3.3 Mecánicas Diesel (Después de ERP-Core) + +```bash +# DDL 100% completo - 43 tablas +1. 01-workshop-schema.sql +2. 02-diagnostic-schema.sql +3. 03-vehicles-schema.sql +4. 04-quotes-schema.sql +``` + +--- + +## 4. Dependencias entre Schemas + +``` +┌─────────────────────────────────────────────────────────────┐ +│ erp-core │ +│ ┌──────────┐ ┌──────────┐ ┌───────────┐ ┌────────────┐ │ +│ │ auth │ │ core │ │ inventory │ │ purchase │ │ +│ └────┬─────┘ └────┬─────┘ └─────┬─────┘ └─────┬──────┘ │ +└───────┼─────────────┼──────────────┼──────────────┼─────────┘ + │ │ │ │ + ▼ ▼ ▼ ▼ +┌───────────────────────────────────────────────────────────────┐ +│ VERTICAL: Construcción │ +│ ┌─────────────┐ ┌───────────┐ ┌──────────┐ ┌──────────┐ │ +│ │ construction│ │ estimates │ │ infonavit│ │ hse │ │ +│ └──────┬──────┘ └─────┬─────┘ └────┬─────┘ └────┬─────┘ │ +│ │ │ │ │ │ +│ ▼ ▼ ▼ ▼ │ +│ ┌──────────────────────────────────────────────────────────┐│ +│ │ inventory (ext) purchase (ext) ││ +│ └──────────────────────────────────────────────────────────┘│ +└───────────────────────────────────────────────────────────────┘ +``` + +--- + +## 5. Script de Verificación + +```sql +-- Verificar schemas existentes +SELECT schema_name +FROM information_schema.schemata +WHERE schema_name NOT IN ('pg_catalog', 'information_schema', 'public') +ORDER BY schema_name; + +-- Verificar tablas por schema +SELECT + schemaname, + COUNT(*) as table_count +FROM pg_tables +WHERE schemaname NOT IN ('pg_catalog', 'information_schema', 'public') +GROUP BY schemaname +ORDER BY schemaname; + +-- Verificar dependencias FK +SELECT + tc.table_schema || '.' || tc.table_name AS table_name, + kcu.column_name, + ccu.table_schema || '.' || ccu.table_name AS references_table +FROM information_schema.table_constraints AS tc +JOIN information_schema.key_column_usage AS kcu + ON tc.constraint_name = kcu.constraint_name +JOIN information_schema.constraint_column_usage AS ccu + ON ccu.constraint_name = tc.constraint_name +WHERE tc.constraint_type = 'FOREIGN KEY' +AND tc.table_schema NOT IN ('pg_catalog', 'information_schema') +ORDER BY tc.table_schema, tc.table_name; +``` + +--- + +## 6. Resumen de Tablas por Vertical + +### Construcción (Total: 115 tablas) + +| Schema | Tablas | Módulos | +|--------|--------|---------| +| construction | 24 | MAI-002, MAI-003, MAI-005, MAI-009, MAI-012 | +| hr (ext) | 8 | MAI-007 | +| hse | 58 | MAA-017 | +| estimates | 8 | MAI-008 | +| infonavit | 8 | MAI-010, MAI-011 | +| inventory (ext) | 4 | MAI-004 | +| purchase (ext) | 5 | MAI-004 | + +### Mecánicas Diesel (Total: 43 tablas) + +| Schema | Tablas | Módulos | +|--------|--------|---------| +| workshop | 15 | MMD-001, MMD-002 | +| diagnostic | 8 | MMD-003 | +| vehicles | 8 | MMD-005 | +| inventory (ext) | 6 | MMD-004 | +| quotes | 6 | MMD-006 | + +--- + +## 7. Checklist de Migración + +### Pre-Migración +- [ ] Backup completo de base de datos +- [ ] Verificar versión PostgreSQL >= 15 +- [ ] PostGIS instalado +- [ ] ERP-Core DDL ejecutado + +### Ejecución +- [ ] Ejecutar DDL en orden especificado +- [ ] Verificar cada schema después de creación +- [ ] Verificar FKs inter-schema + +### Post-Migración +- [ ] Ejecutar scripts de verificación +- [ ] Actualizar MASTER_INVENTORY.yml +- [ ] Documentar cualquier desviación + +--- + +## 8. Notas Importantes + +1. **RLS habilitado**: Todas las tablas usan Row-Level Security con tenant_id +2. **Soft Delete**: Todas las tablas tienen deleted_at para borrado lógico +3. **Auditoría**: created_at, created_by, updated_at, updated_by en todas las tablas +4. **PostGIS**: Requerido para columnas de tipo GEOMETRY +5. **TIMESTAMPTZ**: Usar siempre con timezone para fechas/horas + +--- + +## Historial de Cambios + +| Versión | Fecha | Descripción | +|---------|-------|-------------| +| 1.0.0 | 2025-12-08 | Versión inicial | + +--- + +*Documento generado como parte del análisis de arquitectura ERP-Suite* diff --git a/docs/REPORTE-ALINEACION-VERTICALES.md b/docs/REPORTE-ALINEACION-VERTICALES.md new file mode 100644 index 0000000..ef87df3 --- /dev/null +++ b/docs/REPORTE-ALINEACION-VERTICALES.md @@ -0,0 +1,281 @@ +# Reporte de Alineación: ERP-Core con Verticales + +**Fecha:** 2025-12-08 +**Sistema:** SIMCO v2.2.0 +**Nivel:** Suite 2B + +--- + +## Resumen Ejecutivo + +Se completó el análisis, validación y alineación del ERP-Core con las 5 verticales del ecosistema. El trabajo incluyó: + +1. **Mapeo de 30 SPECS transversales** a cada vertical +2. **Definición de 30 nuevos módulos** para verticales vacías +3. **Propagación de herencia** documentada en todos los niveles +4. **Sincronización de inventarios** SIMCO en todos los proyectos + +--- + +## Estado Final por Vertical + +| Vertical | Módulos | SP | SPECS Aplicables | SPECS Implementadas | Estado | +|----------|--------:|---:|----------------:|--------------------:|--------| +| **Construcción** | 18 | 450+ | 27 | 0 | EN_DESARROLLO | +| **Mecánicas Diesel** | 5 | 150+ | 25 | 0 | DDL_IMPLEMENTADO | +| **Vidrio Templado** | 8 | 212 | 25 | 0 | PLANIFICACION_COMPLETA | +| **Retail** | 10 | 322 | 26 | 0 | PLANIFICACION_COMPLETA | +| **Clínicas** | 12 | 395 | 22 | 0 | PLANIFICACION_COMPLETA | +| **TOTAL** | **53** | **1529+** | **125** | **0** | - | + +--- + +## Archivos Creados/Modificados + +### FASE 1: Auditoría y Mapeo +| Archivo | Acción | Ubicación | +|---------|--------|-----------| +| MAPEO-SPECS-VERTICALES.md | CREADO | apps/erp-core/docs/04-modelado/ | +| MASTER_INVENTORY.yml | ACTUALIZADO | apps/erp-core/orchestration/inventarios/ | + +### FASE 2: Propagación de Herencia +| Archivo | Acción | Verticales | +|---------|--------|------------| +| HERENCIA-SPECS-CORE.md | CREADO | 5 verticales | +| HERENCIA-ERP-CORE.md | ACTUALIZADO | vidrio-templado, retail, clinicas | + +### FASE 3: Definición de Módulos +| Vertical | Archivos Creados | Módulos | +|----------|------------------|---------| +| Vidrio Templado | 12+ | VT-001 a VT-008 | +| Retail | 14+ | RT-001 a RT-010 | +| Clínicas | 16+ | CL-001 a CL-012 | + +### FASE 4: Inventarios por Vertical +| Archivo | Verticales Actualizadas | +|---------|------------------------| +| MASTER_INVENTORY.yml | 5 verticales | +| TRACEABILITY_MATRIX.yml | 5 verticales | + +### FASE 5: Nivel Suite (ROOT) +| Archivo | Acción | +|---------|--------| +| SUITE_MASTER_INVENTORY.yml | ACTUALIZADO | +| REFERENCIAS.yml | ACTUALIZADO | +| STATUS.yml | ACTUALIZADO | + +### FASE 6: Consolidación +| Archivo | Acción | +|---------|--------| +| DIRECTIVA-EXTENSION-VERTICALES.md | ACTUALIZADO | +| REPORTE-ALINEACION-VERTICALES.md | CREADO | + +--- + +## Detalle por Vertical + +### Construcción (CONS) + +**Estado:** EN_DESARROLLO (40%) + +| Métrica | Valor | +|---------|-------| +| Módulos | 18 (MAI-001 a MAI-018) | +| Story Points | 450+ | +| SPECS Aplicables | 27 | +| Tablas Heredadas | 124 | +| Tablas Específicas | 33 | +| Backend Implementado | 15% | + +**SPECS Principales:** +- SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN +- SPEC-VALORACION-INVENTARIO +- SPEC-TRAZABILIDAD-LOTES-SERIES +- SPEC-RRHH-EVALUACIONES-SKILLS + +--- + +### Mecánicas Diesel (MMD) + +**Estado:** DDL_IMPLEMENTADO (20%) + +| Métrica | Valor | +|---------|-------| +| Módulos | 5 (MMD-001 a MMD-005) | +| Story Points | 150+ | +| SPECS Aplicables | 25 | +| Tablas Heredadas | 97 | +| DDL Líneas | 1561 | + +**SPECS Principales:** +- SPEC-VALORACION-INVENTARIO +- SPEC-TRAZABILIDAD-LOTES-SERIES +- SPEC-PRICING-RULES +- SPEC-FACTURACION-CFDI + +--- + +### Vidrio Templado (VT) + +**Estado:** PLANIFICACION_COMPLETA (20%) + +| Métrica | Valor | +|---------|-------| +| Módulos | 8 (VT-001 a VT-008) | +| Story Points | 212 | +| SPECS Aplicables | 25 | +| Tablas Planificadas | 25 | +| Schemas Planificados | production, quality, glass | + +**Módulos Definidos:** +1. VT-001: Fundamentos (100% herencia) +2. VT-002: Cotizaciones (34 SP) +3. VT-003: Producción (34 SP) +4. VT-004: Inventario (21 SP) +5. VT-005: Corte/Nesting (47 SP) +6. VT-006: Templado (34 SP) +7. VT-007: Calidad (21 SP) +8. VT-008: Despacho (21 SP) + +--- + +### Retail (RT) + +**Estado:** PLANIFICACION_COMPLETA (20%) + +| Métrica | Valor | +|---------|-------| +| Módulos | 10 (RT-001 a RT-010) | +| Story Points | 322 | +| SPECS Aplicables | 26 | +| Tablas Planificadas | 35 | +| Schemas Planificados | pos, loyalty, pricing | + +**Módulos Definidos:** +1. RT-001: Fundamentos (100% herencia) +2. RT-002: POS (55 SP) - **Crítico: offline-first** +3. RT-003: Inventario Multi-sucursal (34 SP) +4. RT-004: Compras (21 SP) +5. RT-005: Clientes/CRM (34 SP) +6. RT-006: Precios/Promociones (42 SP) +7. RT-007: Caja/Arqueos (34 SP) +8. RT-008: Reportes (34 SP) +9. RT-009: E-commerce (47 SP) +10. RT-010: Facturación CFDI (21 SP) + +--- + +### Clínicas (CL) + +**Estado:** PLANIFICACION_COMPLETA (20%) + +| Métrica | Valor | +|---------|-------| +| Módulos | 12 (CL-001 a CL-012) | +| Story Points | 395 | +| SPECS Aplicables | 22 | +| Tablas Planificadas | 45 | +| Schemas Planificados | clinical, pharmacy, laboratory, imaging | + +**Módulos Definidos:** +1. CL-001: Fundamentos + 2FA (90% herencia) +2. CL-002: Pacientes (34 SP) +3. CL-003: Citas (42 SP) +4. CL-004: Consultas (47 SP) +5. CL-005: Recetas (34 SP) +6. CL-006: Laboratorio (42 SP) +7. CL-007: Farmacia (34 SP) +8. CL-008: Facturación (21 SP) +9. CL-009: Reportes (34 SP) +10. CL-010: Telemedicina (47 SP) +11. CL-011: Expediente NOM-024 (39 SP) +12. CL-012: Imagenología/DICOM (21 SP) + +**Cumplimiento Normativo:** +- NOM-024-SSA3-2012 (Expediente clínico) +- LFPDPPP (Protección datos) + +--- + +## Matriz de Cobertura SPECS + +``` + CONS MMD VT RT CL +SPEC-SISTEMA-SECUENCIAS ✓ ✓ ✓ ✓ ✓ +SPEC-VALORACION-INVENTARIO ✓ ✓ ✓ ✓ ○ +SPEC-SEGURIDAD-API-KEYS ✓ ✓ ✓ ✓ ✓ +SPEC-TRAZABILIDAD-LOTES ✓ ✓ ✓ ✓ ✓ +SPEC-MAIL-THREAD-TRACKING ✓ ✓ ✓ ✓ ✓ +SPEC-PRICING-RULES ✗ ✓ ✓ ✓ ✗ +SPEC-PROYECTOS-BURNDOWN ✓ ✗ ✓ ✗ ✗ +SPEC-INTEGRACION-CALENDAR ✗ ✗ ✗ ✗ ✓ +SPEC-RRHH-EVALUACIONES ✓ ○ ○ ○ ✓ +SPEC-FACTURACION-CFDI ✓ ✓ ○ ✓ ✓ +SPEC-INVENTARIOS-CICLICOS ✗ ✓ ✗ ✓ ○ +SPEC-WIZARD-TRANSIENT ✓ ○ ○ ✓ ✓ +``` + +**Leyenda:** ✓ Obligatoria | ○ Opcional | ✗ No aplica + +--- + +## Validación de Propagación SIMCO + +| Nivel | Proyecto | Inventarios | Herencia | Estado | +|-------|----------|-------------|----------|--------| +| 2B | Suite ROOT | 3/3 | N/A | ✓ | +| 2B.1 | ERP-Core | 6/6 | Base | ✓ | +| 2B.2 | Construcción | 6/6 | ✓ | ✓ | +| 2B.2 | Mecánicas | 6/6 | ✓ | ✓ | +| 2B.2 | Vidrio | 6/6 | ✓ | ✓ | +| 2B.2 | Retail | 6/6 | ✓ | ✓ | +| 2B.2 | Clínicas | 6/6 | ✓ | ✓ | + +**Checklist Final:** +- [x] SUITE_MASTER_INVENTORY.yml actualizado +- [x] REFERENCIAS.yml sincronizado +- [x] STATUS.yml actualizado +- [x] HERENCIA-SPECS-CORE.md en 5 verticales +- [x] HERENCIA-ERP-CORE.md en 5 verticales +- [x] TRACEABILITY_MATRIX.yml en 5 verticales +- [x] MASTER_INVENTORY.yml en 5 verticales +- [x] MAPEO-SPECS-VERTICALES.md creado +- [x] DIRECTIVA-EXTENSION-VERTICALES.md actualizada +- [x] 30 módulos nuevos definidos (VT+RT+CL) + +--- + +## Próximos Pasos Recomendados + +### Prioridad 1: Construcción +1. Completar backend al 50% (MAI-001 a MAI-003) +2. Implementar SPECS P0 pendientes + +### Prioridad 2: Mecánicas Diesel +1. Cargar DDL en base de datos +2. Iniciar backend (MMD-001, MMD-002) + +### Prioridad 3: Verticales Vacías +1. Crear DDL para Vidrio Templado (VT-002 a VT-005) +2. Definir estructura de tablas específicas + +### Prioridad 4: Clínicas +1. Validar cumplimiento NOM-024 +2. Diseñar arquitectura de encriptación + +--- + +## Referencias + +| Documento | Ubicación | +|-----------|-----------| +| Mapeo SPECS | apps/erp-core/docs/04-modelado/MAPEO-SPECS-VERTICALES.md | +| Suite Master | orchestration/inventarios/SUITE_MASTER_INVENTORY.yml | +| Directiva Extensión | apps/erp-core/orchestration/directivas/DIRECTIVA-EXTENSION-VERTICALES.md | +| Core Inventory | apps/erp-core/orchestration/inventarios/MASTER_INVENTORY.yml | + +--- + +*Reporte generado automáticamente* +*Sistema: SIMCO v2.2.0 + NEXUS* +*Fecha: 2025-12-08* diff --git a/docs/REPORTE-CUMPLIMIENTO-DIRECTIVAS-VERTICALES.md b/docs/REPORTE-CUMPLIMIENTO-DIRECTIVAS-VERTICALES.md new file mode 100644 index 0000000..5a85f99 --- /dev/null +++ b/docs/REPORTE-CUMPLIMIENTO-DIRECTIVAS-VERTICALES.md @@ -0,0 +1,273 @@ +# Reporte de Cumplimiento de Directivas - Verticales ERP-Suite + +**Fecha:** 2025-12-08 +**Versión:** 1.1 +**Sistema:** SIMCO v2.2.0 + +--- + +## Resumen Ejecutivo + +Este reporte documenta el estado de cumplimiento de las directivas del sistema SIMCO y NEXUS-DEVENV para las 5 verticales de ERP-Suite. + +### Estado General + +| Directiva | Cumplimiento | Observación | +|-----------|-------------|-------------| +| DEVENV-PORTS.md | ✅ 100% | Puertos asignados y documentados | +| PROJECT-ENV-CONFIG.yml | ✅ 100% | Creado en todas las verticales | +| HERENCIA-SPECS-CORE.md | ✅ 100% | Propagado a todas las verticales | +| HERENCIA-DIRECTIVAS.md | ✅ 100% | Creado en todas las verticales | +| Prompts de Agentes | ✅ 100% | Backend agents creados (5/5) | +| PROXIMA-ACCION.md | ✅ 100% | Documentado en todas las verticales | +| MASTER_INVENTORY.yml | ✅ 100% | Sincronizado | +| TRACEABILITY_MATRIX.yml | ✅ 100% | Actualizado | +| .env.example | ✅ 100% | Templates creados (5/5) | +| Suite Root Sync | ✅ 100% | PROJECT-ENV-CONFIG.yml sincronizado | + +--- + +## Detalle por Vertical + +### 1. CONSTRUCCION (CON) + +**Estado:** EN_DESARROLLO (40%) + +| Elemento | Estado | Archivo | +|----------|--------|---------| +| PROJECT-ENV-CONFIG.yml | ✅ | `orchestration/environment/PROJECT-ENV-CONFIG.yml` | +| HERENCIA-SPECS-CORE.md | ✅ | `orchestration/00-guidelines/HERENCIA-SPECS-CORE.md` | +| HERENCIA-DIRECTIVAS.md | ✅ | `orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md` | +| PROXIMA-ACCION.md | ✅ | `orchestration/PROXIMA-ACCION.md` | +| Backend Agent Prompt | ✅ | `orchestration/prompts/PROMPT-CON-BACKEND-AGENT.md` | +| MASTER_INVENTORY.yml | ✅ | `orchestration/inventarios/MASTER_INVENTORY.yml` | +| .env.example | ✅ | `backend/.env.example` | + +**Puertos Asignados:** +- Backend: 3100 +- Frontend: 5174 +- Database: 5433 +- Redis: 6380 + +--- + +### 2. VIDRIO-TEMPLADO (VT) + +**Estado:** PLANIFICACION (15%) + +| Elemento | Estado | Archivo | +|----------|--------|---------| +| PROJECT-ENV-CONFIG.yml | ✅ | `orchestration/environment/PROJECT-ENV-CONFIG.yml` | +| HERENCIA-SPECS-CORE.md | ✅ | `orchestration/00-guidelines/HERENCIA-SPECS-CORE.md` | +| HERENCIA-DIRECTIVAS.md | ✅ | `orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md` | +| PROXIMA-ACCION.md | ✅ | `orchestration/PROXIMA-ACCION.md` | +| Backend Agent Prompt | ✅ | `orchestration/prompts/PROMPT-VT-BACKEND-AGENT.md` | +| MASTER_INVENTORY.yml | ✅ | `orchestration/inventarios/MASTER_INVENTORY.yml` | +| .env.example | ✅ | `.env.example` | + +**Puertos Asignados:** +- Backend: 3200 +- Frontend: 5175 +- Database: 5434 +- Redis: 6381 + +--- + +### 3. MECANICAS-DIESEL (MMD) + +**Estado:** DDL_IMPLEMENTADO (20%) + +| Elemento | Estado | Archivo | +|----------|--------|---------| +| PROJECT-ENV-CONFIG.yml | ✅ | `orchestration/environment/PROJECT-ENV-CONFIG.yml` | +| HERENCIA-SPECS-CORE.md | ✅ | `orchestration/00-guidelines/HERENCIA-SPECS-CORE.md` | +| HERENCIA-DIRECTIVAS.md | ✅ | `orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md` | +| PROXIMA-ACCION.md | ✅ | `orchestration/PROXIMA-ACCION.md` | +| Backend Agent Prompt | ✅ | `orchestration/prompts/PROMPT-MMD-BACKEND-AGENT.md` | +| MASTER_INVENTORY.yml | ✅ | `orchestration/inventarios/MASTER_INVENTORY.yml` | +| .env.example | ✅ | `backend/.env.example` | +| docker-compose.yml | ✅ | `docker-compose.yml` | + +**Puertos Asignados:** +- Backend: 3300 +- Frontend: 5176 +- Database: 5435 +- Redis: 6382 + +--- + +### 4. RETAIL (RT) + +**Estado:** PLANIFICACION (15%) + +| Elemento | Estado | Archivo | +|----------|--------|---------| +| PROJECT-ENV-CONFIG.yml | ✅ | `orchestration/environment/PROJECT-ENV-CONFIG.yml` | +| HERENCIA-SPECS-CORE.md | ✅ | `orchestration/00-guidelines/HERENCIA-SPECS-CORE.md` | +| HERENCIA-DIRECTIVAS.md | ✅ | `orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md` | +| PROXIMA-ACCION.md | ✅ | `orchestration/PROXIMA-ACCION.md` | +| Backend Agent Prompt | ✅ | `orchestration/prompts/PROMPT-RT-BACKEND-AGENT.md` | +| MASTER_INVENTORY.yml | ✅ | `orchestration/inventarios/MASTER_INVENTORY.yml` | +| .env.example | ✅ | `.env.example` | + +**Puertos Asignados:** +- Backend: 3400 +- Frontend: 5177 +- Database: 5436 +- Redis: 6383 + +**Consideración Especial:** OFFLINE-FIRST requerido para POS + +--- + +### 5. CLINICAS (CL) + +**Estado:** PLANIFICACION (15%) + +| Elemento | Estado | Archivo | +|----------|--------|---------| +| PROJECT-ENV-CONFIG.yml | ✅ | `orchestration/environment/PROJECT-ENV-CONFIG.yml` | +| HERENCIA-SPECS-CORE.md | ✅ | `orchestration/00-guidelines/HERENCIA-SPECS-CORE.md` | +| HERENCIA-DIRECTIVAS.md | ✅ | `orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md` | +| PROXIMA-ACCION.md | ✅ | `orchestration/PROXIMA-ACCION.md` | +| Backend Agent Prompt | ✅ | `orchestration/prompts/PROMPT-CL-BACKEND-AGENT.md` | +| MASTER_INVENTORY.yml | ✅ | `orchestration/inventarios/MASTER_INVENTORY.yml` | +| .env.example | ✅ | `.env.example` | + +**Puertos Asignados:** +- Backend: 3500 +- Frontend: 5178 +- Database: 5437 +- Redis: 6384 + +**Cumplimiento Normativo Requerido:** +- NOM-024-SSA3-2012 (Expediente Clínico) +- LFPDPPP (Protección de Datos) + +--- + +## Matriz de Puertos (DEVENV-PORTS.md) + +| Vertical | Backend | Frontend | Database | Redis | +|----------|---------|----------|----------|-------| +| construccion | 3100 | 5174 | 5433 | 6380 | +| vidrio-templado | 3200 | 5175 | 5434 | 6381 | +| mecanicas-diesel | 3300 | 5176 | 5435 | 6382 | +| retail | 3400 | 5177 | 5436 | 6383 | +| clinicas | 3500 | 5178 | 5437 | 6384 | + +**Estado:** ✅ Sin conflictos de puertos + +--- + +## SPECS del Core Propagadas + +| SPEC | CON | VT | MMD | RT | CL | +|------|-----|----|----|----|----| +| SPEC-VALORACION-INVENTARIO | ✅ | ✅ | ✅ | ✅ | ❌ | +| SPEC-TRAZABILIDAD-LOTES-SERIES | ✅ | ✅ | ✅ | ✅ | ✅ | +| SPEC-PRICING-RULES | ❌ | ✅ | ✅ | ✅ | ❌ | +| SPEC-INVENTARIOS-CICLICOS | ❌ | ❌ | ✅ | ✅ | ❌ | +| SPEC-PROYECTOS-DEPENDENCIAS | ✅ | ✅ | ❌ | ❌ | ❌ | +| SPEC-MAIL-THREAD-TRACKING | ✅ | ✅ | ✅ | ✅ | ✅ | +| SPEC-INTEGRACION-CALENDAR | ❌ | ❌ | ❌ | ❌ | ✅ | +| SPEC-FACTURACION-CFDI | ✅ | ❌ | ✅ | ✅ | ✅ | +| SPEC-TWO-FACTOR-AUTHENTICATION | ❌ | ❌ | ❌ | ❌ | ✅ | +| SPEC-RRHH-EVALUACIONES-SKILLS | ✅ | ✅ | ✅ | ✅ | ✅ | + +--- + +## Gaps Identificados + +### Nivel CRITICO +1. **Ninguno** - Todas las directivas SIMCO cubiertas + +### Nivel MEDIO +1. ~~**Construcción** - Falta PROMPT-CON-BACKEND-AGENT.md~~ ✅ RESUELTO +2. ~~**Todas** - Falta .env.example~~ ✅ RESUELTO +3. **Todas** - Falta docker-compose.yml (excepto mecanicas-diesel y construccion) + +### Nivel BAJO +1. ~~**Inconsistencia de puertos**~~ ✅ RESUELTO - PROJECT-ENV-CONFIG.yml sincronizado + +--- + +## Acciones Completadas + +| Acción | Estado | +|--------|--------| +| Crear PROJECT-ENV-CONFIG.yml en verticales | ✅ COMPLETADO | +| Crear prompts de agentes backend (5/5) | ✅ COMPLETADO | +| Crear PROXIMA-ACCION.md faltantes | ✅ COMPLETADO | +| Crear PROMPT-CON-BACKEND-AGENT.md | ✅ COMPLETADO | +| Sincronizar puertos en suite root | ✅ COMPLETADO | +| Crear .env.example para verticales | ✅ COMPLETADO | + +### Pendientes (Baja Prioridad) +1. Crear docker-compose.yml template para verticales faltantes + +--- + +## Archivos Creados/Modificados en esta Sesión + +### PROJECT-ENV-CONFIG.yml (5 archivos) +| Archivo | Vertical | +|---------|----------| +| `orchestration/environment/PROJECT-ENV-CONFIG.yml` | construccion | +| `orchestration/environment/PROJECT-ENV-CONFIG.yml` | vidrio-templado | +| `orchestration/environment/PROJECT-ENV-CONFIG.yml` | mecanicas-diesel | +| `orchestration/environment/PROJECT-ENV-CONFIG.yml` | retail | +| `orchestration/environment/PROJECT-ENV-CONFIG.yml` | clinicas | + +### Prompts de Agentes Backend (5 archivos) +| Archivo | Vertical | +|---------|----------| +| `orchestration/prompts/PROMPT-CON-BACKEND-AGENT.md` | construccion | +| `orchestration/prompts/PROMPT-VT-BACKEND-AGENT.md` | vidrio-templado | +| `orchestration/prompts/PROMPT-MMD-BACKEND-AGENT.md` | mecanicas-diesel | +| `orchestration/prompts/PROMPT-RT-BACKEND-AGENT.md` | retail | +| `orchestration/prompts/PROMPT-CL-BACKEND-AGENT.md` | clinicas | + +### PROXIMA-ACCION.md (2 archivos) +| Archivo | Vertical | +|---------|----------| +| `orchestration/PROXIMA-ACCION.md` | retail | +| `orchestration/PROXIMA-ACCION.md` | clinicas | + +### .env.example (3 archivos nuevos) +| Archivo | Vertical | +|---------|----------| +| `.env.example` | vidrio-templado | +| `.env.example` | retail | +| `.env.example` | clinicas | + +### Archivos Modificados +| Archivo | Cambio | +|---------|--------| +| `orchestration/environment/PROJECT-ENV-CONFIG.yml` | Suite root sincronizado con DEVENV-PORTS.md | + +--- + +## Conclusión + +**Cumplimiento General: 100%** + +Las 5 verticales de ERP-Suite ahora cumplen **completamente** con las directivas del sistema SIMCO y NEXUS-DEVENV: + +- ✅ Puertos asignados y sin conflictos (según DEVENV-PORTS.md) +- ✅ PROJECT-ENV-CONFIG.yml en todas las verticales +- ✅ Documentación de herencia propagada +- ✅ Prompts de agentes backend (5/5) +- ✅ Inventarios YAML sincronizados +- ✅ Próximas acciones documentadas +- ✅ .env.example en todas las verticales +- ✅ Suite root PROJECT-ENV-CONFIG.yml sincronizado + +**Total archivos creados/modificados: 16** + +--- + +**Generado por:** Claude Code +**Sistema:** SIMCO v2.2.0 +**Referencia:** DEVENV-PORTS.md, INIT-NEXUS-DEVENV.md +**Última actualización:** 2025-12-08 diff --git a/docs/REPORTE-VALIDACION-DDL-VERTICALES.md b/docs/REPORTE-VALIDACION-DDL-VERTICALES.md new file mode 100644 index 0000000..ed49125 --- /dev/null +++ b/docs/REPORTE-VALIDACION-DDL-VERTICALES.md @@ -0,0 +1,288 @@ +# Reporte de Validación DDL - Verticales ERP-Suite + +**Fecha:** 2025-12-08 +**Versión:** 1.1 +**Sistema:** SIMCO v2.2.0 + +--- + +## Resumen Ejecutivo + +Este reporte documenta la validación de los DDL implementados en los **proyectos verticales independientes** de ERP-Suite. + +**Arquitectura:** Cada vertical es un **proyecto independiente** (fork conceptual) que implementa y adapta patrones del ERP-Core para su dominio específico. Las verticales NO dependen del ERP-Core para ejecutarse. + +### Estado General + +| Vertical | Archivos DDL | Tablas | Estado | Discrepancias | +|----------|-------------|--------|--------|---------------| +| Construcción | 4 | ~35 | ✅ CORREGIDO | 0 (2 resueltas) | +| Mecánicas-Diesel | 6 | ~30 | ✅ VÁLIDO | 0 | +| Vidrio-Templado | 0 | 0 | N/A (Planificación) | - | +| Retail | 0 | 0 | N/A (Planificación) | - | +| Clínicas | 0 | 0 | N/A (Planificación) | - | + +--- + +## 1. Vertical: CONSTRUCCIÓN + +### 1.1 Archivos DDL Analizados + +| Archivo | Líneas | Tablas | +|---------|--------|--------| +| `database/schemas/01-construction-schema-ddl.sql` | 113 | 2 | +| `database/schemas/02-hr-schema-ddl.sql` | 153 | 3 | +| `database/schemas/03-hse-schema-ddl.sql` | 1268 | ~28 | +| `database/init-scripts/01-init-database.sql` | 317 | 2 (fallback) | + +### 1.2 Discrepancias Encontradas + +#### D-CON-001: CRÍTICA - Schema Incorrecto para tenants/users ✅ CORREGIDO + +**Ubicación:** Múltiples archivos +**Problema original:** +```sql +-- Construcción usaba: +REFERENCES core.tenants(id) +REFERENCES core.users(id) + +-- ERP-Core tiene: +auth.tenants +auth.users +``` + +**Corrección aplicada (2025-12-08):** +- `01-construction-schema-ddl.sql`: 4 referencias corregidas +- `02-hr-schema-ddl.sql`: 4 referencias corregidas +- `03-hse-schema-ddl.sql`: 42 referencias corregidas +- **Total: 50 referencias corregidas a `auth.tenants` y `auth.users`** + +**Estado:** ✅ RESUELTO + +#### D-CON-002: MEDIO - Tablas Fallback en init-database.sql + +**Ubicación:** `database/init-scripts/01-init-database.sql` líneas 264-284 +**Situación:** +```sql +-- Crea tablas fallback para uso standalone +CREATE TABLE IF NOT EXISTS core.tenants (...) +CREATE TABLE IF NOT EXISTS core.users (...) +``` + +**Nota:** Estas tablas permanecen como fallback para permitir uso standalone de construcción sin ERP-Core completo. El `IF NOT EXISTS` previene duplicación si auth.* ya existe. + +**Corrección aplicada en DDL de schemas:** +- `01-construction-schema-ddl.sql`: Ahora verifica que `auth.tenants` y `auth.users` existan +- Prerequisitos del ERP-Core son validados antes de crear tablas + +**Estado:** ⚠️ ACEPTABLE (fallback para standalone) + +### 1.3 Buenas Prácticas Detectadas + +| Práctica | Estado | Comentario | +|----------|--------|------------| +| Row-Level Security | ✅ | Implementado en todas las tablas | +| Triggers updated_at | ✅ | Usando `core_shared.set_updated_at()` | +| Índices por tenant_id | ✅ | Presente en todas las tablas | +| Comentarios en tablas | ✅ | Documentación clara | +| Verificación de prerequisitos | ✅ | Corregido: Ahora verifica `auth.tenants` y `auth.users` | + +--- + +## 2. Vertical: MECÁNICAS-DIESEL + +### 2.1 Archivos DDL Analizados + +| Archivo | Líneas | Tablas | +|---------|--------|--------| +| `database/init/00-extensions.sql` | 14 | 0 | +| `database/init/01-create-schemas.sql` | 30 | 0 | +| `database/init/02-rls-functions.sql` | 106 | 0 | +| `database/init/03-service-management-tables.sql` | 567 | ~18 | +| `database/init/04-parts-management-tables.sql` | 398 | ~12 | +| `database/init/05-vehicle-management-tables.sql` | 365 | ~8 | + +### 2.2 Estado de Validación + +✅ **Sin discrepancias críticas** + +**Enfoque diferente:** Mecánicas-diesel NO usa FK explícitas a `auth.*`: +```sql +-- Usa columnas sin FK: +tenant_id UUID NOT NULL, -- Sin REFERENCES +customer_id UUID NOT NULL, -- Comentario: core.partners +``` + +**Ventaja:** No depende del schema específico de ERP-Core +**Desventaja:** No hay integridad referencial a nivel de BD + +### 2.3 Referencias a ERP-Core (Comentadas) + +| Columna | Referencia Esperada | Estado | +|---------|---------------------|--------| +| `tenant_id` | `auth.tenants` | Solo comentario | +| `customer_id` | `core.partners` | Solo comentario | +| `assigned_to` | `auth.users` | Solo comentario | +| `created_by` | `auth.users` | Solo comentario | + +### 2.4 Buenas Prácticas Detectadas + +| Práctica | Estado | Comentario | +|----------|--------|------------| +| Row-Level Security | ✅ | Función `create_tenant_rls_policies()` | +| Triggers updated_at | ✅ | `trigger_set_updated_at()` | +| Índices optimizados | ✅ | Índices compuestos por tenant y estado | +| CHECK constraints | ✅ | Validaciones de dominio | +| JSONB para datos flex | ✅ | `raw_data` en diagnósticos | + +--- + +## 3. Matriz de Compatibilidad con ERP-Core + +| Schema ERP-Core | Construcción | Mecánicas-Diesel | +|-----------------|--------------|------------------| +| `auth.tenants` | ✅ Corregido (usa `auth.tenants`) | ✅ Compatible (sin FK) | +| `auth.users` | ✅ Corregido (usa `auth.users`) | ✅ Compatible (sin FK) | +| `core.partners` | ✅ Compatible | ✅ Compatible (sin FK) | +| `inventory.*` | ⚠️ Extensión paralela | ⚠️ Extensión paralela | +| `financial.*` | N/A | N/A | + +--- + +## 4. Acciones Recomendadas + +### Inmediatas (Construcción) + +1. **Corregir referencias FK** en archivos DDL: + ```bash + # Archivos a modificar: + - database/schemas/01-construction-schema-ddl.sql + - database/schemas/02-hr-schema-ddl.sql + - database/schemas/03-hse-schema-ddl.sql + ``` + +2. **Eliminar tablas fallback** en `01-init-database.sql`: + - Eliminar `CREATE TABLE IF NOT EXISTS core.tenants` + - Eliminar `CREATE TABLE IF NOT EXISTS core.users` + - Agregar verificación de `auth.tenants` y `auth.users` + +### Corto Plazo + +3. **Documentar prerequisitos** en HERENCIA-ERP-CORE.md: + - ERP-Core debe estar instalado primero + - DDL del core debe ejecutarse antes de verticales + +4. **Crear script de validación** que verifique: + - Schemas requeridos del core existen + - Tablas base del core existen + - FK referencias son válidas + +### Mediano Plazo (Mecánicas-Diesel) + +5. **Evaluar agregar FK explícitas** a mecánicas-diesel: + - Ventaja: Integridad referencial + - Desventaja: Acoplamiento con ERP-Core + +--- + +## 5. Scripts de Corrección Propuestos + +### 5.1 Corrección para Construcción + +```sql +-- Ejecutar para corregir referencias +-- En 01-construction-schema-ddl.sql + +-- Cambiar: +-- tenant_id UUID NOT NULL REFERENCES core.tenants(id), +-- A: +-- tenant_id UUID NOT NULL REFERENCES auth.tenants(id), + +-- Cambiar: +-- created_by UUID REFERENCES core.users(id), +-- A: +-- created_by UUID REFERENCES auth.users(id), +``` + +### 5.2 Validación de Prerequisitos Propuesta + +```sql +-- Agregar al inicio de cada DDL de vertical +DO $$ +BEGIN + -- Verificar ERP-Core instalado + IF NOT EXISTS (SELECT 1 FROM pg_tables WHERE schemaname = 'auth' AND tablename = 'tenants') THEN + RAISE EXCEPTION 'ERP-Core requerido: Falta auth.tenants'; + END IF; + + IF NOT EXISTS (SELECT 1 FROM pg_tables WHERE schemaname = 'auth' AND tablename = 'users') THEN + RAISE EXCEPTION 'ERP-Core requerido: Falta auth.users'; + END IF; + + IF NOT EXISTS (SELECT 1 FROM pg_tables WHERE schemaname = 'core' AND tablename = 'partners') THEN + RAISE EXCEPTION 'ERP-Core requerido: Falta core.partners'; + END IF; + + RAISE NOTICE 'ERP-Core verificado correctamente'; +END $$; +``` + +--- + +## 6. Conclusión + +### Construcción +- **Estado:** ✅ CORREGIDO - Compatible con ERP-Core +- **Correcciones aplicadas:** 50 referencias a `auth.tenants`/`auth.users` +- **Verificaciones de prerequisitos actualizadas** + +### Mecánicas-Diesel +- **Estado:** ✅ Compatible con ERP-Core +- **Nota:** Funciona independientemente pero sin integridad referencial FK + +### Verticales en Planificación +- **Vidrio-Templado, Retail, Clínicas:** Sin DDL implementado +- **Recomendación:** Seguir patrón de construcción corregido (con FK a `auth.*`) + +--- + +## 7. Resumen de Correcciones Aplicadas (2025-12-08) + +| Archivo | Correcciones | +|---------|--------------| +| `01-construction-schema-ddl.sql` | 4 FK + verificación prerequisitos | +| `02-hr-schema-ddl.sql` | 4 FK + verificación prerequisitos | +| `03-hse-schema-ddl.sql` | 42 FK corregidas | +| **Total** | **50 referencias corregidas** | + +--- + +## 8. Documentación Actualizada (2025-12-08) + +Como resultado de esta validación, los siguientes archivos fueron actualizados: + +### Construcción + +| Archivo | Actualización | +|---------|---------------| +| `database/schemas/01-construction-schema-ddl.sql` | 4 FK corregidas + prerequisitos | +| `database/schemas/02-hr-schema-ddl.sql` | 4 FK corregidas + prerequisitos | +| `database/schemas/03-hse-schema-ddl.sql` | 42 FK corregidas | +| `database/HERENCIA-ERP-CORE.md` | Sección de correcciones agregada | +| `orchestration/inventarios/DATABASE_INVENTORY.yml` | Sección validacion_ddl agregada | +| `orchestration/inventarios/MASTER_INVENTORY.yml` | Sección validacion_ddl agregada | + +### Mecánicas-Diesel + +| Archivo | Actualización | +|---------|---------------| +| `database/HERENCIA-ERP-CORE.md` | Sección de validación DDL agregada | +| `orchestration/inventarios/DATABASE_INVENTORY.yml` | Estado validacion_ddl actualizado | +| `orchestration/inventarios/MASTER_INVENTORY.yml` | Estado y conteos actualizados | + +--- + +**Generado por:** Claude Code +**Sistema:** SIMCO v2.2.0 +**Fecha:** 2025-12-08 +**Última actualización:** 2025-12-08 (documentación propagada a todas las verticales) diff --git a/docs/VERTICAL-GUIDE.md b/docs/VERTICAL-GUIDE.md new file mode 100644 index 0000000..15894e3 --- /dev/null +++ b/docs/VERTICAL-GUIDE.md @@ -0,0 +1,763 @@ +# Vertical Development Guide + +## Overview + +Este documento explica cómo crear una **nueva vertical** de negocio que extiende el **erp-core** genérico. El patrón sigue el modelo de Odoo ERP: core reutilizable + extensiones especializadas por industria. + +**Verticales Existentes:** +- Construcción (INFONAVIT) - 35% completado +- Vidrio Templado - 0% +- Mecánicas Diesel - 30% +- Retail (POS) - 0% +- Clínicas - 0% + +## Architecture Pattern + +### Core + Vertical Model + +``` +┌─────────────────────────────────────┐ +│ ERP CORE (60-70%) │ +│ Generic modules: auth, inventory, │ +│ sales, purchases, financial, etc. │ +└────────────┬────────────────────────┘ + │ extends + ▼ +┌─────────────────────────────────────┐ +│ VERTICAL (30-40%) │ +│ Industry-specific extensions │ +│ - Override methods │ +│ - Add new modules │ +│ - Extend database schemas │ +└─────────────────────────────────────┘ +``` + +### Key Principles + +1. **Don't modify core** - Core stays generic and reusable +2. **Extend, don't replace** - Vertical extends core modules +3. **Inheritance over duplication** - Use TypeScript class inheritance +4. **Additive database changes** - Add schemas, don't modify core schemas +5. **Separate documentation** - Each vertical has its own docs/ + +## Step-by-Step: Create New Vertical + +### 1. Project Structure + +```bash +# Create vertical directory +mkdir -p apps/verticales/my-vertical + +cd apps/verticales/my-vertical + +# Create standard structure +mkdir -p backend/src/{modules,shared} +mkdir -p frontend/src/{modules,shared} +mkdir -p database/ddl/schemas +mkdir -p docs +mkdir -p orchestration/{00-guidelines,trazas,estados} +``` + +**Result:** +``` +apps/verticales/my-vertical/ +├── backend/ +│ └── src/ +│ ├── modules/ # Industry-specific modules +│ ├── shared/ # Shared utilities +│ ├── routes/ # API routes +│ └── index.ts # Entry point +├── frontend/ +│ └── src/ +│ ├── modules/ # UI modules +│ └── shared/ # Shared components +├── database/ +│ ├── ddl/ +│ │ └── schemas/ # Vertical schemas +│ ├── migrations/ # Database migrations +│ └── seeds/ # Test data +├── docs/ # Vertical documentation +└── orchestration/ # Agent orchestration + ├── 00-guidelines/ + │ └── CONTEXTO-PROYECTO.md + ├── trazas/ + ├── estados/ + └── PROXIMA-ACCION.md +``` + +### 2. Define Vertical Context + +Create `orchestration/00-guidelines/CONTEXTO-PROYECTO.md`: + +```markdown +# Contexto del Proyecto: [Vertical Name] + +## Descripción +[What is this vertical? What industry problem does it solve?] + +## Módulos Específicos +1. [Module 1] - [Description] +2. [Module 2] - [Description] + +## Dependencias del Core +- auth: Authentication & authorization +- inventory: Product management (extended) +- sales: Sales management (extended) +- [List core modules used] + +## Schemas de Base de Datos +1. [schema_name] - [Purpose] +2. [schema_name] - [Purpose] + +## Estado Actual +[Current development status] +``` + +### 3. Database Schema Design + +#### Create Vertical Schema + +```bash +# Create schema DDL +touch database/ddl/schemas/my_vertical_management/schema.sql +``` + +**Example:** `database/ddl/schemas/my_vertical_management/schema.sql` + +```sql +-- ============================================ +-- SCHEMA: my_vertical_management +-- PURPOSE: Industry-specific data for my vertical +-- DEPENDS ON: auth, core, inventory (from erp-core) +-- ============================================ + +CREATE SCHEMA IF NOT EXISTS my_vertical_management; + +-- ============================================ +-- TABLE: my_vertical_management.custom_entities +-- ============================================ +CREATE TABLE my_vertical_management.custom_entities ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + tenant_id UUID NOT NULL REFERENCES auth.tenants(id), + + -- Link to core entities + product_id UUID REFERENCES products.products(id), + partner_id UUID REFERENCES core.partners(id), + + -- Vertical-specific fields + industry_code VARCHAR(50) NOT NULL, + certification_date DATE, + compliance_status VARCHAR(20), + + -- Standard audit fields + created_by UUID REFERENCES auth.users(id), + updated_by UUID REFERENCES auth.users(id), + created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), + updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), + deleted_at TIMESTAMPTZ +); + +-- Indexes +CREATE INDEX idx_custom_entities_tenant_id +ON my_vertical_management.custom_entities(tenant_id); + +CREATE INDEX idx_custom_entities_industry_code +ON my_vertical_management.custom_entities(tenant_id, industry_code) +WHERE deleted_at IS NULL; + +-- RLS Policy +ALTER TABLE my_vertical_management.custom_entities ENABLE ROW LEVEL SECURITY; + +CREATE POLICY tenant_isolation ON my_vertical_management.custom_entities + USING (tenant_id = current_setting('app.current_tenant_id')::uuid); + +-- Permissions +GRANT SELECT, INSERT, UPDATE, DELETE +ON my_vertical_management.custom_entities TO erp_app_user; + +-- Comments +COMMENT ON TABLE my_vertical_management.custom_entities IS + 'Stores industry-specific entity data for my vertical'; +``` + +### 4. Backend Module Structure + +#### Extend Core Module + +**Example:** Extending Projects module + +```typescript +// backend/src/modules/projects/vertical-project.service.ts +import { ProjectService } from '@erp-core/modules/projects/project.service'; +import { CreateProjectDto } from '@erp-core/modules/projects/dto'; + +interface CreateVerticalProjectDto extends CreateProjectDto { + // Add vertical-specific fields + industryCode: string; + certificationDate?: Date; + complianceStatus: string; +} + +export class VerticalProjectService extends ProjectService { + /** + * Override create method to add vertical logic + */ + async create( + data: CreateVerticalProjectDto, + tenantId: string, + userId: string + ): Promise { + const client = await this.pool.connect(); + + try { + await client.query('BEGIN'); + + // 1. Call parent method (creates core project) + const project = await super.create(data, tenantId, userId); + + // 2. Create vertical-specific data + await client.query(` + INSERT INTO my_vertical_management.custom_entities ( + tenant_id, product_id, industry_code, + certification_date, compliance_status, + created_by + ) VALUES ($1, $2, $3, $4, $5, $6) + `, [ + tenantId, + project.id, + data.industryCode, + data.certificationDate, + data.complianceStatus, + userId + ]); + + await client.query('COMMIT'); + return project; + + } catch (error) { + await client.query('ROLLBACK'); + throw error; + } finally { + client.release(); + } + } + + /** + * Add vertical-specific method + */ + async findByCertificationDate( + tenantId: string, + startDate: Date, + endDate: Date + ): Promise { + const query = ` + SELECT p.*, ce.industry_code, ce.certification_date + FROM projects.projects p + INNER JOIN my_vertical_management.custom_entities ce + ON p.id = ce.product_id + WHERE p.tenant_id = $1 + AND ce.certification_date BETWEEN $2 AND $3 + AND p.deleted_at IS NULL + `; + + const result = await this.pool.query(query, [tenantId, startDate, endDate]); + return result.rows; + } + + /** + * Override validation + */ + protected async validateProjectData(data: CreateVerticalProjectDto): Promise { + // Call parent validation + await super.validateProjectData(data); + + // Add vertical-specific validation + if (!data.industryCode) { + throw new Error('Industry code is required for this vertical'); + } + + if (data.complianceStatus && !['pending', 'approved', 'rejected'].includes(data.complianceStatus)) { + throw new Error('Invalid compliance status'); + } + } +} +``` + +#### Create New Module + +**Example:** Vertical-specific module + +```typescript +// backend/src/modules/certifications/certification.service.ts +import { BaseService } from '@erp-core/shared/services/base.service'; + +interface Certification { + id: string; + tenantId: string; + entityId: string; + certificationNumber: string; + issueDate: Date; + expiryDate: Date; + status: string; +} + +interface CreateCertificationDto { + entityId: string; + certificationNumber: string; + issueDate: Date; + expiryDate: Date; +} + +export class CertificationService extends BaseService< + Certification, + CreateCertificationDto, + Partial +> { + constructor() { + super('certifications', 'my_vertical_management'); + } + + /** + * Find certifications expiring soon + */ + async findExpiringSoon( + tenantId: string, + daysAhead: number = 30 + ): Promise { + const query = ` + SELECT * + FROM my_vertical_management.certifications + WHERE tenant_id = $1 + AND expiry_date <= NOW() + INTERVAL '${daysAhead} days' + AND expiry_date >= NOW() + AND deleted_at IS NULL + ORDER BY expiry_date ASC + `; + + const result = await this.pool.query(query, [tenantId]); + return result.rows; + } + + /** + * Renew certification + */ + async renew( + certificationId: string, + tenantId: string, + userId: string, + newExpiryDate: Date + ): Promise { + const query = ` + UPDATE my_vertical_management.certifications + SET + expiry_date = $1, + status = 'active', + updated_by = $2, + updated_at = NOW() + WHERE id = $3 AND tenant_id = $4 + RETURNING * + `; + + const result = await this.pool.query(query, [ + newExpiryDate, + userId, + certificationId, + tenantId + ]); + + return result.rows[0]; + } +} +``` + +### 5. API Routes + +```typescript +// backend/src/routes/index.ts +import express from 'express'; +import { VerticalProjectService } from '../modules/projects/vertical-project.service'; +import { CertificationService } from '../modules/certifications/certification.service'; +import { authenticateJWT } from '@erp-core/middleware/auth.middleware'; + +const router = express.Router(); + +const projectService = new VerticalProjectService(); +const certificationService = new CertificationService(); + +// Extend core projects endpoint +router.post('/projects', authenticateJWT, async (req, res) => { + try { + const project = await projectService.create( + req.body, + req.user.tenantId, + req.user.id + ); + res.status(201).json(project); + } catch (error) { + res.status(400).json({ error: error.message }); + } +}); + +// Vertical-specific endpoint +router.get('/certifications/expiring', authenticateJWT, async (req, res) => { + try { + const daysAhead = parseInt(req.query.days as string) || 30; + const certs = await certificationService.findExpiringSoon( + req.user.tenantId, + daysAhead + ); + res.json(certs); + } catch (error) { + res.status(500).json({ error: error.message }); + } +}); + +export default router; +``` + +### 6. Frontend Module + +```tsx +// frontend/src/modules/certifications/CertificationList.tsx +import React, { useEffect, useState } from 'react'; +import { api } from '../../shared/utils/api'; + +interface Certification { + id: string; + certificationNumber: string; + issueDate: string; + expiryDate: string; + status: string; +} + +export const CertificationList: React.FC = () => { + const [certifications, setCertifications] = useState([]); + + useEffect(() => { + fetchCertifications(); + }, []); + + const fetchCertifications = async () => { + const response = await api.get('/certifications/expiring?days=30'); + setCertifications(response.data); + }; + + return ( +
+

Certifications Expiring Soon

+ + + + + + + + + + + + {certifications.map((cert) => ( + + + + + + + ))} + +
Certification NumberIssue DateExpiry DateStatus
{cert.certificationNumber}{new Date(cert.issueDate).toLocaleDateString()}{new Date(cert.expiryDate).toLocaleDateString()} + + {cert.status} + +
+
+ ); +}; +``` + +### 7. Documentation + +Create documentation for your vertical: + +#### Required Docs + +1. **CONTEXTO-PROYECTO.md** - Project overview +2. **REQUERIMIENTOS.md** - Functional requirements +3. **MODELO-DATOS.md** - Database schema documentation +4. **API.md** - API endpoints +5. **GUIA-USUARIO.md** - User guide + +#### Example: MODELO-DATOS.md + +```markdown +# Modelo de Datos: [Vertical Name] + +## Schemas + +### my_vertical_management + +#### Tablas + +##### custom_entities +**Propósito:** Almacena datos específicos de la industria + +| Campo | Tipo | Descripción | +|-------|------|-------------| +| id | UUID | Primary key | +| tenant_id | UUID | Tenant isolation | +| product_id | UUID | Link to core product | +| industry_code | VARCHAR(50) | Industry classification code | +| certification_date | DATE | Date of certification | +| compliance_status | VARCHAR(20) | Compliance status | + +**Índices:** +- `idx_custom_entities_tenant_id` - Performance +- `idx_custom_entities_industry_code` - Queries by code + +**RLS:** Enabled (tenant_isolation policy) +``` + +### 8. Integration with Core + +#### Import Core Modules + +```typescript +// backend/src/modules/projects/vertical-project.service.ts + +// Option 1: Direct import (if monorepo) +import { ProjectService } from '../../../erp-core/backend/src/modules/projects/project.service'; + +// Option 2: Package import (if separate packages) +import { ProjectService } from '@erp-core/modules/projects'; +``` + +#### Share Types + +```typescript +// shared-libs/core/types/index.ts +export interface BaseEntity { + id: string; + tenantId: string; + createdBy: string; + updatedBy?: string; + createdAt: Date; + updatedAt: Date; + deletedAt?: Date; +} + +export interface Project extends BaseEntity { + name: string; + description?: string; + status: 'draft' | 'active' | 'completed'; +} +``` + +## Best Practices + +### 1. Follow Naming Conventions + +**Schemas:** +``` +{vertical}_management +example: construction_management, clinic_management +``` + +**Tables:** +``` +{vertical}_management.{entity_plural} +example: construction_management.phases +``` + +**Services:** +``` +{Vertical}{Entity}Service +example: ConstructionProjectService +``` + +### 2. Always Use Multi-Tenancy + +```sql +-- ✅ Good +CREATE TABLE my_vertical_management.entities ( + id UUID PRIMARY KEY, + tenant_id UUID NOT NULL REFERENCES auth.tenants(id), + -- ... +); + +-- ❌ Bad (missing tenant_id) +CREATE TABLE my_vertical_management.entities ( + id UUID PRIMARY KEY, + -- missing tenant_id! +); +``` + +### 3. Extend, Don't Duplicate + +```typescript +// ✅ Good - Extend core service +class VerticalProjectService extends ProjectService { + async create(...) { + const project = await super.create(...); + // Add vertical logic + return project; + } +} + +// ❌ Bad - Duplicate core logic +class VerticalProjectService { + async create(...) { + // Copy-pasted from ProjectService + // Now you have duplicated code! + } +} +``` + +### 4. Document Dependencies + +```markdown +## Dependencias del Core + +Este vertical extiende los siguientes módulos del core: + +- **projects** - Gestión de proyectos (override create, findAll) +- **inventory** - Productos (agrega campos custom) +- **sales** - Ventas (validación adicional) +- **financial** - Contabilidad (reportes específicos) +``` + +### 5. Use Transactions + +```typescript +async create(data: any, tenantId: string, userId: string) { + const client = await this.pool.connect(); + + try { + await client.query('BEGIN'); + + // 1. Core operation + const entity = await super.create(data, tenantId, userId); + + // 2. Vertical operation + await this.createVerticalData(client, entity.id, data); + + await client.query('COMMIT'); + return entity; + + } catch (error) { + await client.query('ROLLBACK'); + throw error; + } finally { + client.release(); + } +} +``` + +## Testing Your Vertical + +### Unit Tests + +```typescript +// __tests__/vertical-project.service.test.ts +import { VerticalProjectService } from '../modules/projects/vertical-project.service'; + +describe('VerticalProjectService', () => { + let service: VerticalProjectService; + + beforeEach(() => { + service = new VerticalProjectService(); + }); + + it('should create project with vertical data', async () => { + const data = { + name: 'Test Project', + industryCode: 'IND-001', + complianceStatus: 'pending' + }; + + const project = await service.create(data, 'tenant-id', 'user-id'); + + expect(project).toBeDefined(); + expect(project.name).toBe('Test Project'); + // Verify vertical data was created + }); +}); +``` + +### Integration Tests + +Test interaction with core modules and database. + +## Deployment + +### Database Migration + +```bash +# Run core migrations first +cd apps/erp-core/database +psql -U erp_user -d erp_db -f ddl/schemas/auth/schema.sql +psql -U erp_user -d erp_db -f ddl/schemas/core/schema.sql +# ... all core schemas + +# Then run vertical migrations +cd apps/verticales/my-vertical/database +psql -U erp_user -d erp_db -f ddl/schemas/my_vertical_management/schema.sql +``` + +### Environment Variables + +```bash +# .env for vertical +CORE_API_URL=http://localhost:3000 +VERTICAL_NAME=my-vertical +VERTICAL_DB_SCHEMA=my_vertical_management +``` + +## Examples from Existing Verticals + +### Construcción Vertical + +**Extends:** +- Projects → Construction Projects (adds phases, developments) +- Partners → Derechohabientes (adds INFONAVIT data) +- Financial → Presupuestos (construction budgets) + +**New Modules:** +- Quality Management +- INFONAVIT Integration +- Construction Control + +### Mecánicas Diesel Vertical + +**Extends:** +- Inventory → Vehicle Parts (adds vehicle compatibility) +- Sales → Work Orders (service orders) +- Partners → Vehicle Owners + +**New Modules:** +- Diagnostics +- Maintenance Schedules +- Vehicle Registry + +## Checklist: Create New Vertical + +- [ ] Create directory structure +- [ ] Write CONTEXTO-PROYECTO.md +- [ ] Design database schemas +- [ ] Create DDL files with RLS +- [ ] Identify core modules to extend +- [ ] Create service classes (extend BaseService) +- [ ] Implement API routes +- [ ] Create frontend modules +- [ ] Write documentation +- [ ] Write unit tests +- [ ] Integration testing +- [ ] Deploy database schemas + +## References + +- [Architecture Documentation](./ARCHITECTURE.md) +- [Multi-Tenancy Guide](./MULTI-TENANCY.md) +- [Core Modules Documentation](../apps/erp-core/docs/) +- [Odoo Development Patterns](../../../workspace/core/knowledge-base/patterns/PATRON-CORE-ODOO.md) diff --git a/docs/_MAP.md b/docs/_MAP.md new file mode 100644 index 0000000..9b5d6bb --- /dev/null +++ b/docs/_MAP.md @@ -0,0 +1,40 @@ +# Mapa de Documentacion: erp-suite + +**Proyecto:** erp-suite +**Actualizado:** 2026-01-04 +**Generado por:** EPIC-008 adapt-simco.sh + +--- + +## Estructura de Documentacion + +``` +docs/ +├── _MAP.md # Este archivo (indice de navegacion) +├── 00-overview/ # Vision general del proyecto +├── 01-architecture/ # Arquitectura y decisiones (ADRs) +├── 02-specs/ # Especificaciones tecnicas +├── 03-api/ # Documentacion de APIs +├── 04-guides/ # Guias de desarrollo +└── 99-finiquito/ # Entregables cliente (si aplica) +``` + +## Navegacion Rapida + +| Seccion | Descripcion | Estado | +|---------|-------------|--------| +| Overview | Vision general | - | +| Architecture | Decisiones arquitectonicas | - | +| Specs | Especificaciones tecnicas | - | +| API | Documentacion de endpoints | - | +| Guides | Guias de desarrollo | - | + +## Estadisticas + +- Total archivos en docs/: 15 +- Fecha de adaptacion: 2026-01-04 + +--- + +**Nota:** Este archivo fue generado automaticamente por EPIC-008. +Actualizar manualmente con la estructura real del proyecto. diff --git a/jenkins/Jenkinsfile b/jenkins/Jenkinsfile new file mode 100644 index 0000000..480ce42 --- /dev/null +++ b/jenkins/Jenkinsfile @@ -0,0 +1,449 @@ +// ============================================================================= +// ERP-SUITE - Jenkins Multi-Vertical Pipeline +// ============================================================================= +// Gestiona el despliegue de erp-core y todas las verticales +// Servidor: 72.60.226.4 +// ============================================================================= + +pipeline { + agent any + + parameters { + choice( + name: 'VERTICAL', + choices: ['erp-core', 'construccion', 'vidrio-templado', 'mecanicas-diesel', 'retail', 'clinicas', 'pos-micro', 'ALL'], + description: 'Vertical a desplegar (ALL despliega todas las activas)' + ) + choice( + name: 'ENVIRONMENT', + choices: ['staging', 'production'], + description: 'Ambiente de despliegue' + ) + booleanParam( + name: 'RUN_MIGRATIONS', + defaultValue: false, + description: 'Ejecutar migraciones de BD' + ) + booleanParam( + name: 'SKIP_TESTS', + defaultValue: false, + description: 'Saltar tests (solo para hotfixes)' + ) + } + + environment { + PROJECT_NAME = 'erp-suite' + DOCKER_REGISTRY = '72.60.226.4:5000' + DEPLOY_SERVER = '72.60.226.4' + DEPLOY_USER = 'deploy' + DEPLOY_PATH = '/opt/apps/erp-suite' + VERSION = "${env.BUILD_NUMBER}" + GIT_COMMIT_SHORT = sh(script: "git rev-parse --short HEAD", returnStdout: true).trim() + + // Verticales activas (con código desarrollado) + ACTIVE_VERTICALS = 'erp-core,construccion,mecanicas-diesel' + } + + options { + timeout(time: 60, unit: 'MINUTES') + disableConcurrentBuilds() + buildDiscarder(logRotator(numToKeepStr: '15')) + timestamps() + } + + stages { + // ===================================================================== + // PREPARACIÓN + // ===================================================================== + stage('Checkout') { + steps { + checkout scm + script { + env.GIT_BRANCH = sh(script: 'git rev-parse --abbrev-ref HEAD', returnStdout: true).trim() + currentBuild.displayName = "#${BUILD_NUMBER} - ${params.VERTICAL} - ${GIT_COMMIT_SHORT}" + } + } + } + + stage('Determine Verticals') { + steps { + script { + if (params.VERTICAL == 'ALL') { + env.VERTICALS_TO_BUILD = env.ACTIVE_VERTICALS + } else { + env.VERTICALS_TO_BUILD = params.VERTICAL + } + echo "Verticales a construir: ${env.VERTICALS_TO_BUILD}" + } + } + } + + // ===================================================================== + // BUILD & TEST POR VERTICAL + // ===================================================================== + stage('Build Verticals') { + steps { + script { + def verticals = env.VERTICALS_TO_BUILD.split(',') + def parallelStages = [:] + + verticals.each { vertical -> + parallelStages["Build ${vertical}"] = { + buildVertical(vertical) + } + } + + parallel parallelStages + } + } + } + + stage('Run Tests') { + when { + expression { return !params.SKIP_TESTS } + } + steps { + script { + def verticals = env.VERTICALS_TO_BUILD.split(',') + def parallelTests = [:] + + verticals.each { vertical -> + parallelTests["Test ${vertical}"] = { + testVertical(vertical) + } + } + + parallel parallelTests + } + } + } + + // ===================================================================== + // DOCKER BUILD & PUSH + // ===================================================================== + stage('Docker Build & Push') { + when { + anyOf { + branch 'main' + branch 'develop' + } + } + steps { + script { + def verticals = env.VERTICALS_TO_BUILD.split(',') + + verticals.each { vertical -> + def config = getVerticalConfig(vertical) + + // Build Backend + if (fileExists("${config.path}/backend/Dockerfile")) { + sh """ + docker build -t ${DOCKER_REGISTRY}/erp-${vertical}-backend:${VERSION} \ + -t ${DOCKER_REGISTRY}/erp-${vertical}-backend:latest \ + ${config.path}/backend/ + docker push ${DOCKER_REGISTRY}/erp-${vertical}-backend:${VERSION} + docker push ${DOCKER_REGISTRY}/erp-${vertical}-backend:latest + """ + } + + // Build Frontend + def frontendPath = config.frontendPath ?: "${config.path}/frontend" + if (fileExists("${frontendPath}/Dockerfile")) { + sh """ + docker build -t ${DOCKER_REGISTRY}/erp-${vertical}-frontend:${VERSION} \ + -t ${DOCKER_REGISTRY}/erp-${vertical}-frontend:latest \ + ${frontendPath}/ + docker push ${DOCKER_REGISTRY}/erp-${vertical}-frontend:${VERSION} + docker push ${DOCKER_REGISTRY}/erp-${vertical}-frontend:latest + """ + } + + echo "✅ Docker images pushed for ${vertical}" + } + } + } + } + + // ===================================================================== + // DATABASE MIGRATIONS + // ===================================================================== + stage('Run Migrations') { + when { + expression { return params.RUN_MIGRATIONS } + } + steps { + script { + // Siempre ejecutar migraciones de erp-core primero + if (env.VERTICALS_TO_BUILD.contains('erp-core') || params.VERTICAL == 'ALL') { + echo "Ejecutando migraciones de erp-core..." + runMigrations('erp-core') + } + + // Luego migraciones de verticales + def verticals = env.VERTICALS_TO_BUILD.split(',') + verticals.each { vertical -> + if (vertical != 'erp-core') { + echo "Ejecutando migraciones de ${vertical}..." + runMigrations(vertical) + } + } + } + } + } + + // ===================================================================== + // DEPLOY + // ===================================================================== + stage('Deploy to Staging') { + when { + allOf { + branch 'develop' + expression { return params.ENVIRONMENT == 'staging' } + } + } + steps { + script { + deployVerticals('staging') + } + } + } + + stage('Deploy to Production') { + when { + allOf { + branch 'main' + expression { return params.ENVIRONMENT == 'production' } + } + } + steps { + input message: '¿Confirmar despliegue a PRODUCCIÓN?', ok: 'Desplegar' + script { + deployVerticals('production') + } + } + } + + // ===================================================================== + // HEALTH CHECKS + // ===================================================================== + stage('Health Checks') { + steps { + script { + def verticals = env.VERTICALS_TO_BUILD.split(',') + + verticals.each { vertical -> + def config = getVerticalConfig(vertical) + def healthUrl = "http://${DEPLOY_SERVER}:${config.backendPort}/health" + + retry(5) { + sleep(time: 10, unit: 'SECONDS') + def response = sh(script: "curl -sf ${healthUrl}", returnStatus: true) + if (response != 0) { + error "Health check failed for ${vertical}" + } + } + echo "✅ ${vertical} is healthy" + } + } + } + } + } + + // ========================================================================= + // POST ACTIONS + // ========================================================================= + post { + success { + script { + def message = """ + ✅ *ERP-Suite Deploy Exitoso* + • *Verticales:* ${env.VERTICALS_TO_BUILD} + • *Ambiente:* ${params.ENVIRONMENT} + • *Build:* #${BUILD_NUMBER} + • *Commit:* ${GIT_COMMIT_SHORT} + """.stripIndent() + echo message + // slackSend(color: 'good', message: message) + } + } + failure { + script { + def message = """ + ❌ *ERP-Suite Deploy Fallido* + • *Verticales:* ${env.VERTICALS_TO_BUILD} + • *Build:* #${BUILD_NUMBER} + • *Console:* ${BUILD_URL}console + """.stripIndent() + echo message + // slackSend(color: 'danger', message: message) + } + } + always { + cleanWs() + } + } +} + +// ============================================================================= +// HELPER FUNCTIONS +// ============================================================================= + +def getVerticalConfig(String vertical) { + def configs = [ + 'erp-core': [ + path: 'apps/erp-core', + frontendPath: 'apps/erp-core/frontend', + frontendPort: 3010, + backendPort: 3011, + dbSchema: 'auth,core,inventory', + active: true + ], + 'construccion': [ + path: 'apps/verticales/construccion', + frontendPath: 'apps/verticales/construccion/frontend/web', + frontendPort: 3020, + backendPort: 3021, + dbSchema: 'construccion', + active: true + ], + 'vidrio-templado': [ + path: 'apps/verticales/vidrio-templado', + frontendPort: 3030, + backendPort: 3031, + dbSchema: 'vidrio', + active: false + ], + 'mecanicas-diesel': [ + path: 'apps/verticales/mecanicas-diesel', + frontendPort: 3040, + backendPort: 3041, + dbSchema: 'service_management,parts_management,vehicle_management', + active: true + ], + 'retail': [ + path: 'apps/verticales/retail', + frontendPort: 3050, + backendPort: 3051, + dbSchema: 'retail', + active: false + ], + 'clinicas': [ + path: 'apps/verticales/clinicas', + frontendPort: 3060, + backendPort: 3061, + dbSchema: 'clinicas', + active: false + ], + 'pos-micro': [ + path: 'apps/products/pos-micro', + frontendPort: 3070, + backendPort: 3071, + dbSchema: 'pos', + active: false + ] + ] + + return configs[vertical] ?: error("Vertical ${vertical} no configurada") +} + +def buildVertical(String vertical) { + def config = getVerticalConfig(vertical) + + stage("Install ${vertical}") { + if (fileExists("${config.path}/backend/package.json")) { + dir("${config.path}/backend") { + sh 'npm ci --prefer-offline' + } + } + + def frontendPath = config.frontendPath ?: "${config.path}/frontend" + if (fileExists("${frontendPath}/package.json")) { + dir(frontendPath) { + sh 'npm ci --prefer-offline' + } + } + } + + stage("Build ${vertical}") { + if (fileExists("${config.path}/backend/package.json")) { + dir("${config.path}/backend") { + sh 'npm run build' + } + } + + def frontendPath = config.frontendPath ?: "${config.path}/frontend" + if (fileExists("${frontendPath}/package.json")) { + dir(frontendPath) { + sh 'npm run build' + } + } + } +} + +def testVertical(String vertical) { + def config = getVerticalConfig(vertical) + + if (fileExists("${config.path}/backend/package.json")) { + dir("${config.path}/backend") { + sh 'npm run test || true' + sh 'npm run lint || true' + } + } +} + +def runMigrations(String vertical) { + def config = getVerticalConfig(vertical) + + sshagent(['deploy-ssh-key']) { + sh """ + ssh -o StrictHostKeyChecking=no ${DEPLOY_USER}@${DEPLOY_SERVER} ' + cd ${DEPLOY_PATH}/${vertical} + docker-compose exec -T backend npm run migration:run || true + ' + """ + } +} + +def deployVerticals(String environment) { + def verticals = env.VERTICALS_TO_BUILD.split(',') + + sshagent(['deploy-ssh-key']) { + // Desplegar erp-core primero si está en la lista + if (verticals.contains('erp-core')) { + deployVertical('erp-core', environment) + } + + // Luego el resto de verticales + verticals.each { vertical -> + if (vertical != 'erp-core') { + deployVertical(vertical, environment) + } + } + } +} + +def deployVertical(String vertical, String environment) { + def config = getVerticalConfig(vertical) + + echo "Desplegando ${vertical} a ${environment}..." + + sh """ + ssh -o StrictHostKeyChecking=no ${DEPLOY_USER}@${DEPLOY_SERVER} ' + cd ${DEPLOY_PATH}/${vertical} + + # Pull nuevas imágenes + docker-compose -f docker-compose.prod.yml pull + + # Detener contenedores actuales + docker-compose -f docker-compose.prod.yml down --remove-orphans + + # Iniciar nuevos contenedores + docker-compose -f docker-compose.prod.yml up -d + + # Cleanup + docker system prune -f + + echo "✅ ${vertical} desplegado" + ' + """ +} diff --git a/nginx/erp-suite.conf b/nginx/erp-suite.conf new file mode 100644 index 0000000..40e0816 --- /dev/null +++ b/nginx/erp-suite.conf @@ -0,0 +1,402 @@ +# ============================================================================= +# ERP-SUITE - Nginx Configuration Completa +# ============================================================================= +# Copiar a: /etc/nginx/conf.d/erp-suite.conf +# Servidor: 72.60.226.4 +# ============================================================================= + +# ============================================================================= +# UPSTREAMS - Todos los verticales +# ============================================================================= + +# ERP-CORE (Base) +upstream erp_core_frontend { + server 127.0.0.1:3010; + keepalive 32; +} +upstream erp_core_backend { + server 127.0.0.1:3011; + keepalive 32; +} + +# CONSTRUCCION +upstream erp_construccion_frontend { + server 127.0.0.1:3020; + keepalive 32; +} +upstream erp_construccion_backend { + server 127.0.0.1:3021; + keepalive 32; +} + +# VIDRIO-TEMPLADO +upstream erp_vidrio_frontend { + server 127.0.0.1:3030; + keepalive 32; +} +upstream erp_vidrio_backend { + server 127.0.0.1:3031; + keepalive 32; +} + +# MECANICAS-DIESEL +upstream erp_mecanicas_frontend { + server 127.0.0.1:3040; + keepalive 32; +} +upstream erp_mecanicas_backend { + server 127.0.0.1:3041; + keepalive 32; +} + +# RETAIL +upstream erp_retail_frontend { + server 127.0.0.1:3050; + keepalive 32; +} +upstream erp_retail_backend { + server 127.0.0.1:3051; + keepalive 32; +} + +# CLINICAS +upstream erp_clinicas_frontend { + server 127.0.0.1:3060; + keepalive 32; +} +upstream erp_clinicas_backend { + server 127.0.0.1:3061; + keepalive 32; +} + +# POS-MICRO +upstream erp_pos_frontend { + server 127.0.0.1:3070; + keepalive 32; +} +upstream erp_pos_backend { + server 127.0.0.1:3071; + keepalive 32; +} + +# ============================================================================= +# HTTP -> HTTPS REDIRECT (todos los subdominios) +# ============================================================================= +server { + listen 80; + server_name + erp.isem.dev api.erp.isem.dev + construccion.erp.isem.dev api.construccion.erp.isem.dev + vidrio.erp.isem.dev api.vidrio.erp.isem.dev + mecanicas.erp.isem.dev api.mecanicas.erp.isem.dev + retail.erp.isem.dev api.retail.erp.isem.dev + clinicas.erp.isem.dev api.clinicas.erp.isem.dev + pos.erp.isem.dev api.pos.erp.isem.dev; + + return 301 https://$server_name$request_uri; +} + +# ============================================================================= +# ERP-CORE - Base del sistema +# ============================================================================= +server { + listen 443 ssl http2; + server_name erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + ssl_protocols TLSv1.2 TLSv1.3; + + add_header X-Frame-Options "SAMEORIGIN" always; + add_header X-Content-Type-Options "nosniff" always; + add_header Strict-Transport-Security "max-age=31536000" always; + + access_log /var/log/nginx/erp-core-frontend.log; + error_log /var/log/nginx/erp-core-frontend.error.log; + + gzip on; + gzip_types text/plain text/css application/json application/javascript; + + location / { + proxy_pass http://erp_core_frontend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } + + location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ { + proxy_pass http://erp_core_frontend; + expires 1y; + add_header Cache-Control "public, immutable"; + } +} + +server { + listen 443 ssl http2; + server_name api.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + access_log /var/log/nginx/erp-core-api.log; + error_log /var/log/nginx/erp-core-api.error.log; + + client_max_body_size 50M; + + location / { + proxy_pass http://erp_core_backend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_connect_timeout 60s; + proxy_read_timeout 60s; + } + + location /health { + proxy_pass http://erp_core_backend/health; + access_log off; + } + + location /ws { + proxy_pass http://erp_core_backend; + proxy_http_version 1.1; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "upgrade"; + proxy_read_timeout 86400; + } +} + +# ============================================================================= +# CONSTRUCCION +# ============================================================================= +server { + listen 443 ssl http2; + server_name construccion.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + access_log /var/log/nginx/erp-construccion-frontend.log; + + location / { + proxy_pass http://erp_construccion_frontend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +server { + listen 443 ssl http2; + server_name api.construccion.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + access_log /var/log/nginx/erp-construccion-api.log; + client_max_body_size 100M; + + location / { + proxy_pass http://erp_construccion_backend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } + + location /health { proxy_pass http://erp_construccion_backend/health; access_log off; } +} + +# ============================================================================= +# MECANICAS-DIESEL +# ============================================================================= +server { + listen 443 ssl http2; + server_name mecanicas.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_mecanicas_frontend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +server { + listen 443 ssl http2; + server_name api.mecanicas.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_mecanicas_backend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } + + location /health { proxy_pass http://erp_mecanicas_backend/health; access_log off; } +} + +# ============================================================================= +# VIDRIO-TEMPLADO (Reservado) +# ============================================================================= +server { + listen 443 ssl http2; + server_name vidrio.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_vidrio_frontend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +server { + listen 443 ssl http2; + server_name api.vidrio.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_vidrio_backend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +# ============================================================================= +# RETAIL (Reservado) +# ============================================================================= +server { + listen 443 ssl http2; + server_name retail.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_retail_frontend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +server { + listen 443 ssl http2; + server_name api.retail.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_retail_backend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +# ============================================================================= +# CLINICAS (Reservado) +# ============================================================================= +server { + listen 443 ssl http2; + server_name clinicas.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_clinicas_frontend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +server { + listen 443 ssl http2; + server_name api.clinicas.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_clinicas_backend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +# ============================================================================= +# POS-MICRO (Reservado) +# ============================================================================= +server { + listen 443 ssl http2; + server_name pos.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_pos_frontend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +server { + listen 443 ssl http2; + server_name api.pos.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_pos_backend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} diff --git a/nginx/erp.conf b/nginx/erp.conf new file mode 100644 index 0000000..b2e47c3 --- /dev/null +++ b/nginx/erp.conf @@ -0,0 +1,130 @@ +# ============================================================================= +# ERP-SUITE - Nginx Configuration +# ============================================================================= +# Copiar a: /etc/nginx/conf.d/erp.conf +# ============================================================================= + +# =========================================================================== +# UPSTREAMS +# =========================================================================== + +# ERP-Core +upstream erp_core_frontend { server 127.0.0.1:3010; keepalive 32; } +upstream erp_core_backend { server 127.0.0.1:3011; keepalive 32; } + +# Verticales +upstream erp_construccion_frontend { server 127.0.0.1:3020; keepalive 32; } +upstream erp_construccion_backend { server 127.0.0.1:3021; keepalive 32; } + +upstream erp_vidrio_frontend { server 127.0.0.1:3030; keepalive 32; } +upstream erp_vidrio_backend { server 127.0.0.1:3031; keepalive 32; } + +upstream erp_mecanicas_frontend { server 127.0.0.1:3040; keepalive 32; } +upstream erp_mecanicas_backend { server 127.0.0.1:3041; keepalive 32; } + +upstream erp_retail_frontend { server 127.0.0.1:3050; keepalive 32; } +upstream erp_retail_backend { server 127.0.0.1:3051; keepalive 32; } + +upstream erp_clinicas_frontend { server 127.0.0.1:3060; keepalive 32; } +upstream erp_clinicas_backend { server 127.0.0.1:3061; keepalive 32; } + +upstream erp_pos_frontend { server 127.0.0.1:3070; keepalive 32; } +upstream erp_pos_backend { server 127.0.0.1:3071; keepalive 32; } + +# =========================================================================== +# HTTP -> HTTPS REDIRECT +# =========================================================================== +server { + listen 80; + server_name erp.isem.dev api.erp.isem.dev + construccion.erp.isem.dev api.construccion.erp.isem.dev + vidrio.erp.isem.dev api.vidrio.erp.isem.dev + mecanicas.erp.isem.dev api.mecanicas.erp.isem.dev + retail.erp.isem.dev api.retail.erp.isem.dev + clinicas.erp.isem.dev api.clinicas.erp.isem.dev + pos.erp.isem.dev api.pos.erp.isem.dev; + return 301 https://$server_name$request_uri; +} + +# =========================================================================== +# ERP-CORE +# =========================================================================== +server { + listen 443 ssl http2; + server_name erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_core_frontend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +server { + listen 443 ssl http2; + server_name api.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_core_backend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } + + location /health { + proxy_pass http://erp_core_backend/health; + access_log off; + } +} + +# =========================================================================== +# CONSTRUCCION +# =========================================================================== +server { + listen 443 ssl http2; + server_name construccion.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_construccion_frontend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +server { + listen 443 ssl http2; + server_name api.construccion.erp.isem.dev; + + ssl_certificate /etc/letsencrypt/live/isem.dev/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/isem.dev/privkey.pem; + + location / { + proxy_pass http://erp_construccion_backend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } +} + +# =========================================================================== +# (Agregar más verticales según se activen) +# =========================================================================== diff --git a/orchestration/00-guidelines/CONTEXTO-PROYECTO.md b/orchestration/00-guidelines/CONTEXTO-PROYECTO.md new file mode 100644 index 0000000..41bba99 --- /dev/null +++ b/orchestration/00-guidelines/CONTEXTO-PROYECTO.md @@ -0,0 +1,167 @@ +# Contexto del Proyecto: ERP Suite + +## Metadatos + +| Campo | Valor | +|-------|-------| +| **Nombre** | ERP Suite - Productos Derivados | +| **Tipo** | SUITE (contenedor de productos SaaS) | +| **Nivel** | Productos derivados de erp-core | +| **Estado** | En desarrollo | +| **Version** | 1.0.0 | +| **Fecha Reorganizacion** | 2025-12-27 | + +--- + +## REORGANIZACION 2025-12-27 + +**IMPORTANTE:** La estructura de erp-suite fue reorganizada: + +| Componente | Antes | Ahora | +|------------|-------|-------| +| erp-core | `erp-suite/apps/erp-core/` | `projects/erp-core/` (independiente) | +| verticales | `erp-suite/apps/verticales/` | `projects/erp-{vertical}/` (independientes) | +| products | `erp-suite/apps/products/` | Se mantiene aqui | +| saas | `erp-suite/apps/saas/` | Se mantiene aqui | + +--- + +## Descripcion + +ERP Suite ahora es el contenedor de **productos derivados** del erp-core: +- **products/erp-basico/** - ERP simplificado para PyMEs +- **products/pos-micro/** - Punto de venta minimalista +- **saas/billing/** - Infraestructura de facturacion de suscripciones +- **saas/portal/** - Portal de clientes + +**Nota:** erp-core y las verticales son ahora proyectos independientes en projects/. + +## Stack Tecnológico + +### Backend (erp-core/backend) +- **Runtime:** Node.js 20+ +- **Framework:** Express.js +- **Lenguaje:** TypeScript 5.3+ +- **ORM:** TypeORM 0.3.17 +- **Autenticación:** JWT + bcryptjs +- **Validación:** Zod, class-validator, class-transformer +- **Logger:** Winston +- **HTTP Security:** Helmet, CORS, express-rate-limit +- **Docs API:** Swagger/OpenAPI + +### Frontend Web (erp-core/frontend) +- **Framework:** React 18 +- **Build Tool:** Vite +- **Lenguaje:** TypeScript +- **State Management:** Zustand +- **Styling:** Tailwind CSS +- **Validación:** Zod + +### Base de Datos +- **Motor:** PostgreSQL 15+ +- **Extensiones:** uuid-ossp, postgis, pg_trgm, btree_gist +- **Seguridad:** Row-Level Security (RLS) con multi-tenant +- **Contexto:** `app.current_constructora_id` para aislamiento + +### Frontend Mobile +- **Framework:** React Native + +## Paths Críticos + +``` +/home/isem/workspace-v1/projects/erp-suite/ +├── apps/ +│ ├── erp-core/ +│ │ ├── backend/src/ # Código backend principal +│ │ ├── frontend/src/ # Código frontend principal +│ │ └── database/ # DDL, migrations, seeds +│ └── verticales/ +│ └── construccion/ # Vertical más avanzado (35%) +│ ├── backend/ +│ ├── frontend/ +│ └── database/ +├── docs/ +│ ├── 00-overview/ # Documentación general +│ ├── core/ # Docs del erp-core +│ └── verticales/ +│ └── construccion/ # 403+ archivos de especificaciones +│ ├── 01-fase-alcance-inicial/ # 15 módulos MAI-* +│ ├── 02-fase-enterprise/ # 3 épicas MAE-* +│ └── 02-modelado/database-design/ # Schemas SQL +└── orchestration/ + ├── 00-guidelines/ # Este archivo + └── legacy-reference/ # Sistema de orquestación migrado +``` + +## Convenciones de Código + +### Base de Datos +- **Schemas:** `snake_case` + sufijo `_management` +- **Tablas:** `snake_case` plural +- **Columnas:** `snake_case` singular +- **Índices:** `idx_{tabla}_{columnas}` +- **Foreign Keys:** `fk_{origen}_to_{destino}` +- **Auditoría:** `created_at`, `updated_at`, `created_by`, `updated_by` + +### Backend +- **Archivos:** `kebab-case.tipo.ts` (ej: `user-auth.service.ts`) +- **Clases:** `PascalCase` + sufijo (Entity, Service, Controller, Dto) +- **Variables:** `camelCase` +- **Constantes:** `UPPER_SNAKE_CASE` +- **Métodos:** `camelCase` + verbo al inicio + +### Frontend +- **Componentes:** `PascalCase.tsx` +- **Páginas:** `PascalCasePage.tsx` +- **Hooks:** `useCamelCase.ts` +- **Stores:** `camelCase.store.ts` +- **Tipos:** `camelCase.types.ts` + +## Verticales y Estado + +| Vertical | Path | Estado | Prioridad | +|----------|------|--------|-----------| +| **erp-core** | `apps/erp-core/` | 60% | Alta | +| **Construcción** | `apps/verticales/construccion/` | 35% | Alta | +| **Vidrio Templado** | `apps/verticales/vidrio-templado/` | 0% | Media | +| **Mecánicas Diesel** | `apps/verticales/mecanicas-diesel/` | 0% | Baja | +| **Retail** | `apps/verticales/retail/` | 0% | Futura | +| **Clínicas** | `apps/verticales/clinicas/` | 0% | Futura | + +## Directivas Específicas + +1. **Validación obligatoria:** Todo cambio debe validarse contra `/docs/verticales/construccion/` para evitar alucinaciones +2. **Herencia de directivas:** Este proyecto EXTIENDE las directivas de `/home/isem/workspace-v1/core/orchestration/directivas/` +3. **Multi-tenant:** Toda consulta debe filtrar por `constructora_id` usando RLS +4. **Modularidad:** Archivos <400 líneas, funciones <50 líneas +5. **Documentación:** Actualizar docs cuando se modifique código relacionado + +## Schemas de Base de Datos + +| Schema | Descripción | Estado | +|--------|-------------|--------| +| `auth_management` | Autenticación, usuarios, roles | Definido | +| `project_management` | Proyectos, desarrollos, fases | Definido | +| `financial_management` | Presupuestos, estimaciones | Definido | +| `purchasing_management` | Compras, proveedores | Definido | +| `construction_management` | Avances, recursos | Definido | +| `quality_management` | Inspecciones, calidad | Definido | +| `infonavit_management` | Integración INFONAVIT | Definido | + +## Referencias Clave + +- **Documentación Principal:** `/docs/verticales/construccion/` +- **DDL Schemas:** `/docs/verticales/construccion/02-modelado/database-design/schemas/` +- **RLS Policies:** `/docs/verticales/construccion/01-fase-alcance-inicial/*/implementacion/*-rls-policies.sql` +- **Patrones Odoo:** `/home/isem/workspace-v1/knowledge-base/patterns/` +- **Sistema Legacy:** `/orchestration/legacy-reference/` + +## Próximos Pasos + +1. Completar erp-core con módulos base (auth, usuarios, catálogos) +2. Implementar schemas de base de datos +3. Continuar desarrollo de vertical construcción +4. Documentar APIs con Swagger + +--- +*Última actualización: Diciembre 2025* diff --git a/orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md b/orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md new file mode 100644 index 0000000..c8509be --- /dev/null +++ b/orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md @@ -0,0 +1,128 @@ +# Herencia de Directivas - ERP Suite + +## Arquitectura de Directivas + +Este proyecto (nivel Suite) hereda directivas del workspace (core) y define directivas que aplican a todos sus verticales y al core ERP. + +## Directivas Globales (heredadas de core) + +**Path:** `~/workspace/core/orchestration/directivas/` + +Estas directivas aplican a TODOS los proyectos del workspace: + +| Directiva | Propósito | +|-----------|-----------| +| `DIRECTIVA-FLUJO-5-FASES.md` | Workflow obligatorio de 5 fases | +| `DIRECTIVA-VALIDACION-SUBAGENTES.md` | Validación de entregables | +| `POLITICAS-USO-AGENTES.md` | Reglas de delegación | +| `DIRECTIVA-DOCUMENTACION-OBLIGATORIA.md` | Documentación requerida | +| `DIRECTIVA-CALIDAD-CODIGO.md` | Estándares de código | +| `DIRECTIVA-CONTROL-VERSIONES.md` | Git y versionado | +| `DIRECTIVA-GESTION-BACKUPS-GITIGNORE.md` | Backups y gitignore | +| `PROTOCOLO-ESCALAMIENTO-PO.md` | Escalamiento al PO | +| `ESTANDARES-NOMENCLATURA-BASE.md` | Nomenclatura base | +| `SISTEMA-RETROALIMENTACION.md` | Mejora continua | + +## Directivas a Nivel Suite + +**Path:** `~/workspace/projects/erp-suite/orchestration/directivas/` + +| Directiva | Propósito | +|-----------|-----------| +| *(Por definir según necesidades de la suite)* | - | + +## Prompts Base (heredados de core) + +**Path:** `~/workspace/core/orchestration/prompts/base/` + +| Prompt | Uso | +|--------|-----| +| `PROMPT-SUBAGENTES-BASE.md` | Instrucciones generales para subagentes | +| `PROMPT-BUG-FIXER.md` | Corrección de bugs genérico | +| `PROMPT-CODE-REVIEWER.md` | Revisión de código | +| `PROMPT-FEATURE-DEVELOPER.md` | Desarrollo de features | +| `PROMPT-DOCUMENTATION-VALIDATOR.md` | Validación de documentación | +| `PROMPT-POLICY-AUDITOR.md` | Auditoría de políticas | +| `PROMPT-REQUIREMENTS-ANALYST.md` | Análisis de requerimientos | +| `PROMPT-WORKSPACE-MANAGER.md` | Gestión del workspace | + +## Templates y Checklists (core) + +**Path:** `~/workspace/core/orchestration/templates/` +- `TEMPLATE-ANALISIS.md` +- `TEMPLATE-PLAN.md` +- `TEMPLATE-VALIDACION.md` +- `TEMPLATE-CONTEXTO-SUBAGENTE.md` + +**Path:** `~/workspace/core/orchestration/checklists/` +- `CHECKLIST-CODE-REVIEW-API.md` +- `CHECKLIST-REFACTORIZACION.md` + +## Orden de Precedencia (Suite Multi-Nivel) + +Cuando hay conflicto entre directivas en la suite: + +1. **Directivas específicas del vertical** (mayor prioridad) +2. **Directivas de erp-core** +3. **Directivas a nivel suite** +4. **Directivas globales del workspace** +5. **Prompts específicos** +6. **Prompts base del workspace** + +## Estructura de Herencia en la Suite + +``` +workspace/core (Nivel 1) + └── erp-suite (Nivel 2B) + ├── erp-core (Nivel 2B.1) + │ └── [directivas core ERP] + └── verticales/ (Nivel 2B.2) + ├── construccion/ + ├── vidrio-templado/ + ├── mecanicas-diesel/ + ├── clinicas/ + └── retail/ +``` + +Cada vertical hereda: +1. Directivas de `core/orchestration/directivas/` +2. Directivas de `erp-suite/orchestration/directivas/` +3. Directivas de `erp-core/orchestration/directivas/` +4. Sus propias directivas específicas + +## Catálogo de Funcionalidades Usado + +Este proyecto utiliza las siguientes funcionalidades del catálogo core: + +| Funcionalidad | Uso en la suite | +|---------------|-----------------| +| `auth` | Autenticación centralizada | +| `multi-tenancy` | Separación por empresa/sucursal | + +**Path catálogo:** `~/workspace/core/catalog/` + +## Uso para Subagentes + +Al invocar un subagente para trabajar en la suite, incluir en el contexto: + +```yaml +DIRECTIVAS_A_LEER: + globales: + - ~/workspace/core/orchestration/directivas/DIRECTIVA-FLUJO-5-FASES.md + - ~/workspace/core/orchestration/directivas/POLITICAS-USO-AGENTES.md + suite: + - ~/workspace/projects/erp-suite/orchestration/directivas/[DIRECTIVA-SUITE].md + erp_core: + - ~/workspace/projects/erp-suite/apps/erp-core/orchestration/directivas/[DIRECTIVA-CORE].md + vertical: + - ~/workspace/projects/erp-suite/apps/verticales/[VERTICAL]/orchestration/directivas/[DIRECTIVA].md + prompt_base: + - ~/workspace/core/orchestration/prompts/base/PROMPT-SUBAGENTES-BASE.md + contexto_proyecto: + - ~/workspace/projects/erp-suite/orchestration/00-guidelines/CONTEXTO-PROYECTO.md +``` + +--- +*Sistema NEXUS + SIMCO v2.2.0 - ERP Suite* +*Nivel: 2B (Suite Multi-Vertical)* +*Actualizado: 2025-12-08* diff --git a/orchestration/00-guidelines/HERENCIA-ERP-CORE.md b/orchestration/00-guidelines/HERENCIA-ERP-CORE.md new file mode 100644 index 0000000..cad6a40 --- /dev/null +++ b/orchestration/00-guidelines/HERENCIA-ERP-CORE.md @@ -0,0 +1,105 @@ +# Herencia de ERP-Core + +**Proyecto:** ERP Suite (productos derivados) +**Nivel:** SUITE (contenedor de products/ y saas/) +**Fecha:** 2025-12-27 +**Version ERP-Core:** 1.2.0 + +--- + +## Cadena de Herencia + +``` +workspace-v1/orchestration/ <- BASE PRINCIPAL (directivas, perfiles) + | +projects/erp-core/ <- ERP-CORE (base de datos y modulos) + | +projects/erp-suite/ <- ESTE PROYECTO (productos derivados) + | + +-- apps/products/erp-basico/ <- Producto: ERP Simplificado + +-- apps/products/pos-micro/ <- Producto: POS Miniatura + +-- apps/saas/billing/ <- Infraestructura: Facturacion + +-- apps/saas/portal/ <- Infraestructura: Portal clientes +``` + +--- + +## Ubicacion de ERP-Core + +**IMPORTANTE:** erp-core fue migrado a proyecto independiente. + +| Antes | Ahora | +|-------|-------| +| `erp-suite/apps/erp-core/` | `projects/erp-core/` | + +**Nueva ruta absoluta:** +``` +/home/isem/workspace-v1/projects/erp-core/ +``` + +--- + +## Que Heredamos de ERP-Core + +### Schemas de Base de Datos (12 schemas, 144 tablas) + +| Schema | Tablas | Uso | +|--------|--------|-----| +| `auth_management` | 26 | Autenticacion, MFA, OAuth, roles, permisos | +| `core_management` | 12 | Partners, catalogos, UoM, monedas, secuencias | +| `financial_management` | 15 | Contabilidad, facturas, pagos, asientos | +| `inventory_management` | 20 | Productos, stock, valoracion FIFO/AVCO, lotes | +| `purchasing_management` | 8 | Ordenes de compra, proveedores | +| `sales_management` | 10 | Ventas, cotizaciones, equipos | +| `projects_management` | 10 | Proyectos, tareas, dependencias | +| `analytics_management` | 7 | Contabilidad analitica, centros de costo | +| `system_management` | 13 | Mensajes, notificaciones, logs, auditoria | +| `billing_management` | 11 | SaaS/Suscripciones | +| `crm_management` | 6 | Leads, oportunidades | +| `hr_management` | 6 | Empleados, contratos, ausencias | + +### Variable RLS (OBLIGATORIA) + +```sql +current_setting('app.current_tenant_id', true)::UUID +``` + +--- + +## Como Usar en products/ y saas/ + +### Imports de Modulos + +```typescript +// En apps/products/erp-basico/backend/src/app.module.ts + +// Imports desde erp-core (proyecto independiente) +import { AuthModule } from '@erp-core/auth'; +import { UsersModule } from '@erp-core/users'; +import { RolesModule } from '@erp-core/roles'; +import { TenantsModule } from '@erp-core/tenants'; +``` + +### Configuracion de tsconfig.json + +```json +{ + "compilerOptions": { + "paths": { + "@erp-core/*": ["../../../erp-core/backend/src/*"] + } + } +} +``` + +--- + +## Referencias + +- DDL de erp-core: `projects/erp-core/database/ddl/` +- Documentacion: `projects/erp-core/docs/` +- CONTEXTO-PROYECTO: `projects/erp-core/orchestration/00-guidelines/CONTEXTO-PROYECTO.md` + +--- + +**Nivel:** SUITE | **Sistema:** SIMCO v3.4 + CAPVED diff --git a/orchestration/00-guidelines/HERENCIA-SIMCO.md b/orchestration/00-guidelines/HERENCIA-SIMCO.md new file mode 100644 index 0000000..79e107e --- /dev/null +++ b/orchestration/00-guidelines/HERENCIA-SIMCO.md @@ -0,0 +1,312 @@ +# Herencia SIMCO - ERP Suite + +**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol +**Fecha:** 2025-12-08 + +--- + +## Configuración del Proyecto + +| Propiedad | Valor | +|-----------|-------| +| **Proyecto** | ERP Suite - Sistema ERP Multi-Vertical | +| **Nivel** | SUITE (Nivel 1) | +| **Padre** | core/orchestration | +| **SIMCO Version** | 2.2.0 | +| **CAPVED** | Habilitado | +| **CCA Protocol** | Habilitado | + +## Jerarquía de Herencia + +``` +Nivel 0: core/orchestration/ ← FUENTE PRINCIPAL (76 docs) + │ + └── Nivel 1: erp-suite/orchestration/ ← ESTE PROYECTO + │ + ├── Nivel 2: erp-core/orchestration/ + │ │ + │ └── Nivel 3: verticales/*/orchestration/ + │ ├── construccion + │ ├── vidrio-templado + │ ├── mecanicas-diesel + │ ├── retail + │ └── clinicas + │ + └── Nivel 2: products/*/orchestration/ + ├── erp-basico + └── pos-micro +``` + +**Regla:** Las directivas de nivel inferior pueden EXTENDER las superiores, nunca REDUCIRLAS. + +--- + +## Directivas Heredadas de CORE (OBLIGATORIAS) + +Ubicación: `core/orchestration/` + +### 1. Ciclo de Vida - USAR SIEMPRE + +| Alias | Archivo | Propósito | Cuándo Usar | +|-------|---------|-----------|-------------| +| `@TAREA` | `directivas/simco/SIMCO-TAREA.md` | Punto de entrada | **Toda HU/tarea que genera commit** | +| `@CAPVED` | `directivas/principios/PRINCIPIO-CAPVED.md` | Ciclo de 6 fases | Contexto→Análisis→Plan→Validación→Ejecución→Doc | +| `@INICIALIZACION` | `directivas/simco/SIMCO-INICIALIZACION.md` | Bootstrap de agentes | Al iniciar cualquier agente | + +### 2. Operaciones Universales + +| Alias | Archivo | Propósito | +|-------|---------|-----------| +| `@CREAR` | `directivas/simco/SIMCO-CREAR.md` | Crear cualquier archivo nuevo | +| `@MODIFICAR` | `directivas/simco/SIMCO-MODIFICAR.md` | Modificar archivos existentes | +| `@VALIDAR` | `directivas/simco/SIMCO-VALIDAR.md` | Validar código (build, lint, tests) | +| `@DOCUMENTAR` | `directivas/simco/SIMCO-DOCUMENTAR.md` | Documentar trabajo realizado | +| `@BUSCAR` | `directivas/simco/SIMCO-BUSCAR.md` | Buscar archivos e información | +| `@DELEGAR` | `directivas/simco/SIMCO-DELEGACION.md` | Delegar trabajo a subagentes | + +### 3. Catálogo de Funcionalidades + +| Alias | Archivo | Propósito | +|-------|---------|-----------| +| `@CATALOG` | `catalog/` | Directorio de funcionalidades reutilizables | +| `@CATALOG_INDEX` | `catalog/CATALOG-INDEX.yml` | Índice machine-readable | +| `@REUTILIZAR` | `directivas/simco/SIMCO-REUTILIZAR.md` | ANTES de implementar algo común | +| `@CONTRIBUIR` | `directivas/simco/SIMCO-CONTRIBUIR-CATALOGO.md` | DESPUÉS de crear algo reutilizable | + +**Funcionalidades del catálogo usadas por ERP Suite:** + +| Funcionalidad | Uso en la Suite | +|---------------|-----------------| +| `auth` | Autenticación JWT centralizada | +| `multi-tenancy` | Separación por empresa/sucursal (RLS) | +| `session-management` | Gestión de sesiones de usuario | +| `rate-limiting` | Protección de APIs | + +### 4. Principios Fundamentales (5) + +| Alias | Archivo | Resumen | +|-------|---------|---------| +| `@CAPVED` | `PRINCIPIO-CAPVED.md` | Toda tarea pasa por 6 fases | +| `@DOC_PRIMERO` | `PRINCIPIO-DOC-PRIMERO.md` | Consultar docs/ antes de implementar | +| `@ANTI_DUP` | `PRINCIPIO-ANTI-DUPLICACION.md` | Verificar que no existe antes de crear | +| `@VALIDACION` | `PRINCIPIO-VALIDACION-OBLIGATORIA.md` | Build y lint DEBEN pasar | +| `@TOKENS` | `PRINCIPIO-ECONOMIA-TOKENS.md` | Desglosar tareas grandes | + +--- + +## Directivas por Dominio Técnico + +| Alias | Archivo | Tecnologías | Aplica a ERP Suite | +|-------|---------|-------------|-------------------| +| `@OP_DDL` | `SIMCO-DDL.md` | PostgreSQL, SQL | **SÍ** - 7 schemas | +| `@OP_BACKEND` | `SIMCO-BACKEND.md` | Express, TypeORM | **SÍ** - erp-core/backend | +| `@OP_FRONTEND` | `SIMCO-FRONTEND.md` | React, TypeScript, Vite | **SÍ** - erp-core/frontend | +| `@OP_MOBILE` | `SIMCO-MOBILE.md` | React Native | **SÍ** - mobile app | +| `@OP_ML` | `SIMCO-ML.md` | Python, FastAPI, ML/AI | NO | + +--- + +## Directivas de Niveles y Propagación + +| Alias | Archivo | Propósito | +|-------|---------|-----------| +| `@NIVELES` | `SIMCO-NIVELES.md` | Identificar nivel jerárquico | +| `@PROPAGACION` | `SIMCO-PROPAGACION.md` | Propagar cambios a niveles superiores | +| `@ALINEACION` | `SIMCO-ALINEACION.md` | Validar alineación DDL↔Entity↔DTO | +| `@DECISION_MATRIZ` | `SIMCO-DECISION-MATRIZ.md` | Decidir qué directiva usar | + +--- + +## Patrones Heredados (RECOMENDADOS) + +Ubicación: `core/orchestration/patrones/` + +| Patrón | Uso en ERP Suite | +|--------|------------------| +| `MAPEO-TIPOS-DDL-TYPESCRIPT.md` | PostgreSQL ↔ TypeORM entities | +| `PATRON-VALIDACION.md` | Zod + class-validator | +| `PATRON-EXCEPTION-HANDLING.md` | HttpException + filtros globales | +| `PATRON-TESTING.md` | Jest + Supertest | +| `PATRON-LOGGING.md` | Winston estructurado | +| `PATRON-CONFIGURACION.md` | dotenv + validación | +| `PATRON-SEGURIDAD.md` | JWT, RBAC, RLS, Helmet | +| `PATRON-PERFORMANCE.md` | Query optimization, caching | +| `PATRON-TRANSACCIONES.md` | TypeORM QueryRunner | +| `ANTIPATRONES.md` | Lo que NUNCA hacer | +| `NOMENCLATURA-UNIFICADA.md` | snake_case BD, camelCase TS | + +--- + +## Impactos y Dependencias + +| Documento | Consultar Cuando | +|-----------|------------------| +| `IMPACTO-CAMBIOS-DDL.md` | Modificar schema de BD | +| `IMPACTO-CAMBIOS-BACKEND.md` | Modificar servicios/controllers | +| `IMPACTO-CAMBIOS-ENTITY.md` | Modificar entities TypeORM | +| `IMPACTO-CAMBIOS-API.md` | Modificar endpoints REST | +| `MATRIZ-DEPENDENCIAS.md` | Ver cascada completa | + +--- + +## Perfiles de Agentes para ERP Suite + +### Técnicos (más usados) +| Perfil | Especialización | Frecuencia | +|--------|-----------------|------------| +| `PERFIL-DATABASE.md` | PostgreSQL, DDL, RLS | Alta | +| `PERFIL-BACKEND.md` | Express, TypeORM | Alta | +| `PERFIL-FRONTEND.md` | React, TypeScript | Alta | +| `PERFIL-MOBILE-AGENT.md` | React Native | Media | + +### Coordinación +| Perfil | Especialización | +|--------|-----------------| +| `PERFIL-ORQUESTADOR.md` | Coordinación multi-vertical | +| `PERFIL-ARCHITECTURE-ANALYST.md` | Decisiones de arquitectura | + +### Calidad +| Perfil | Especialización | +|--------|-----------------| +| `PERFIL-CODE-REVIEWER.md` | Revisión de código | +| `PERFIL-BUG-FIXER.md` | Corrección de bugs | + +--- + +## Directivas Específicas de ERP Suite + +Ubicación: `./directivas/` (este proyecto) + +| Directiva Local | Extiende | Propósito Específico | +|-----------------|----------|---------------------| +| `DIRECTIVA-MULTI-TENANT.md` | `@OP_DDL`, `@PATRON-SEGURIDAD` | RLS por constructora_id | +| `DIRECTIVA-HERENCIA-VERTICALES.md` | `@NIVELES` | Cómo verticales extienden core | +| `DIRECTIVA-EXTENSION-MODULOS.md` | `@CREAR` | Patrones para extender módulos | + +--- + +## Variables de Contexto CCA + +```yaml +# Variables para resolver en ALIASES y templates +PROJECT_NAME: "erp-suite" +PROJECT_LEVEL: "SUITE" +PROJECT_ROOT: "./" + +# Rutas específicas +DB_DDL_PATH: "apps/erp-core/database/ddl" +BACKEND_ROOT: "apps/erp-core/backend" +FRONTEND_ROOT: "apps/erp-core/frontend" +DOCS_ROOT: "docs" + +# Inventarios +MASTER_INVENTORY: "orchestration/inventarios/MASTER_INVENTORY.yml" + +# Multi-tenant +TENANT_COLUMN: "constructora_id" +RLS_CONTEXT: "app.current_constructora_id" +``` + +--- + +## Mapeo: Directivas Antiguas → SIMCO + +| Directiva Antigua | Reemplazada Por | Alias | +|-------------------|-----------------|-------| +| `DIRECTIVA-FLUJO-5-FASES.md` | `SIMCO-TAREA.md` + `PRINCIPIO-CAPVED.md` | @TAREA, @CAPVED | +| `DIRECTIVA-VALIDACION-SUBAGENTES.md` | `SIMCO-VALIDAR.md` | @VALIDAR | +| `POLITICAS-USO-AGENTES.md` | `SIMCO-DELEGACION.md` | @DELEGAR | +| `DIRECTIVA-DOCUMENTACION-OBLIGATORIA.md` | `SIMCO-DOCUMENTAR.md` | @DOCUMENTAR | +| `DIRECTIVA-CALIDAD-CODIGO.md` | `patrones/ANTIPATRONES.md` | @PATRONES | +| `DIRECTIVA-DISENO-BASE-DATOS.md` | `SIMCO-DDL.md` | @OP_DDL | +| `ESTANDARES-API-REST-GENERICO.md` | `SIMCO-BACKEND.md` | @OP_BACKEND | + +--- + +## Flujo de Trabajo para Subagentes + +Al invocar un subagente para trabajar en ERP Suite: + +```yaml +CONTEXTO_CCA: + nivel: SUITE + proyecto: erp-suite + +DIRECTIVAS_A_CARGAR: + core: + - @TAREA # Punto de entrada + - @CAPVED # Ciclo de vida + - @INICIALIZACION # Bootstrap + operacion: + - @OP_DDL # Si trabaja con BD + - @OP_BACKEND # Si trabaja con API + - @OP_FRONTEND # Si trabaja con UI + patrones: + - @PATRON-SEGURIDAD # Multi-tenant obligatorio + - @PATRON-VALIDACION # Zod + class-validator + suite: + - ./directivas/DIRECTIVA-MULTI-TENANT.md + +INVENTARIO: + - orchestration/inventarios/MASTER_INVENTORY.yml + +DOCS_VALIDACION: + - docs/verticales/{vertical}/ +``` + +--- + +## Schemas de Base de Datos (7) + +| Schema | Descripción | Directiva Aplicable | +|--------|-------------|---------------------| +| `auth_management` | Autenticación, usuarios, roles | @OP_DDL + @CATALOG(auth) | +| `project_management` | Proyectos, desarrollos, fases | @OP_DDL | +| `financial_management` | Presupuestos, estimaciones | @OP_DDL | +| `purchasing_management` | Compras, proveedores | @OP_DDL | +| `construction_management` | Avances, recursos | @OP_DDL | +| `quality_management` | Inspecciones, calidad | @OP_DDL | +| `infonavit_management` | Integración INFONAVIT | @OP_DDL | + +--- + +## Verticales y Herencia + +| Vertical | Nivel | Hereda De | Estado | +|----------|-------|-----------|--------| +| **erp-core** | 2 | erp-suite | 60% | +| **construccion** | 3 | erp-core | 35% | +| **vidrio-templado** | 3 | erp-core | 0% | +| **mecanicas-diesel** | 3 | erp-core | 0% | +| **retail** | 3 | erp-core | 0% | +| **clinicas** | 3 | erp-core | 0% | + +Cada vertical DEBE tener su propio `HERENCIA-SIMCO.md` que extienda este. + +--- + +## Propagacion de Mejoras + +Este proyecto participa en el sistema de propagacion de mejoras de NEXUS. + +### Modulos Base Usados + +| Modulo | Version | Estado | +|--------|---------|--------| +| auth-session-based | 1.0.0 | Al dia | + +Ver estado completo: `shared/knowledge-base/TRAZABILIDAD-PROYECTOS.yml` + +### Recibir Propagaciones + +Como SUITE, las propagaciones se manejan a traves de: +1. erp-core (modulos compartidos) +2. Verticales individuales + +Ver directiva completa: @PROPAGACION + +--- + +**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol +**Nivel:** SUITE (1) +**Última actualización:** 2026-01-04 diff --git a/orchestration/00-guidelines/PROJECT-STATUS.md b/orchestration/00-guidelines/PROJECT-STATUS.md new file mode 100644 index 0000000..e2adaa7 --- /dev/null +++ b/orchestration/00-guidelines/PROJECT-STATUS.md @@ -0,0 +1,33 @@ +# PROJECT STATUS: erp-suite + +**Ultima actualizacion:** 2026-01-04 +**Estado general:** Activo + +--- + +## Metricas Rapidas + +| Metrica | Valor | +|---------|-------| +| Archivos docs/ | 15 | +| Archivos orchestration/ | 15 | +| Estado SIMCO | Adaptado | + +## Migracion EPIC-008 + +- [x] Migracion desde workspace-v1-bckp (EPIC-004/005) +- [x] Adaptacion SIMCO (EPIC-008) +- [x] docs/_MAP.md creado +- [x] PROJECT-STATUS.md creado +- [x] HERENCIA-SIMCO.md verificado +- [x] CONTEXTO-PROYECTO.md verificado + +## Historial de Cambios + +| Fecha | Cambio | EPIC | +|-------|--------|------| +| 2026-01-04 | Adaptacion SIMCO completada | EPIC-008 | + +--- + +**Generado por:** EPIC-008 adapt-simco.sh diff --git a/orchestration/PROXIMA-ACCION.md b/orchestration/PROXIMA-ACCION.md new file mode 100644 index 0000000..ecf5803 --- /dev/null +++ b/orchestration/PROXIMA-ACCION.md @@ -0,0 +1,112 @@ +# Proxima Accion - ERP Suite + +**Fecha:** 2025-12-08 +**Estado:** Gap Analysis Core COMPLETO - Listo para Implementacion +**Nivel:** 2B - Suite Multi-Vertical + +--- + +## RESUMEN DE ESTADO + +### ERP Core (2B.1) +- **Estado:** Gap Analysis 100% COMPLETO +- **Especificaciones transversales:** 30 documentos +- **Workflows:** 3 documentos +- **Cobertura gaps:** P0 18/18, P1 22/22, Patrones 2/2 +- **Proximo paso:** Implementacion modulos P0 + +### Verticales (2B.2) +- **construccion:** 35% (En Desarrollo) +- **vidrio-templado:** 0% (Planificacion) +- **mecanicas-diesel:** 0% (Planificacion) +- **retail:** 0% (Planificacion) +- **clinicas:** 0% (Planificacion) + +--- + +## TRABAJO COMPLETADO 2025-12-08 + +### Gap Analysis ERP Core +Se completo el analisis de gaps vs Odoo 18: + +1. **30 Especificaciones Transversales** + - 10 gaps P0 funcionales documentados + - 18 gaps P1 documentados + - 2 patrones tecnicos documentados + - 394 Story Points cubiertos + +2. **3 Workflows Documentados** + - Cierre de periodo contable + - 3-Way Match (compras) + - Pagos anticipados + +3. **Estructura de Propagacion SIMCO** + - SUITE_MASTER_INVENTORY.yml creado + - STATUS.yml creado + - REFERENCIAS.yml creado + - TRAZA-SUITE.md creado + +--- + +## PROXIMA TAREA SUGERIDA + +### Opcion A: Implementar Modulos P0 Core (Recomendado) + +**Prioridad:** ALTA +**Ubicacion:** apps/erp-core/ + +**Modulos a implementar:** +1. MGN-001 Auth (API Keys, 2FA, OAuth2) +2. MGN-002 Users +3. MGN-003 Roles (permisos granulares) +4. MGN-004 Tenants (multi-tenancy) + +**Specs disponibles:** 30 documentos en `docs/04-modelado/especificaciones-tecnicas/transversal/` + +### Opcion B: Documentar Herencia en Verticales + +**Prioridad:** MEDIA +**Descripcion:** Crear HERENCIA-ERP-CORE.md en cada vertical + +**Verticales:** +- construccion: 6 specs a heredar +- vidrio-templado: 3 specs a heredar +- mecanicas-diesel: 3 specs a heredar +- retail: 3 specs a heredar +- clinicas: 3 specs a heredar + +### Opcion C: Verificar Estructura Verticales + +**Prioridad:** MEDIA +**Descripcion:** Completar estructura orchestration de verticales menores + +--- + +## REFERENCIAS IMPORTANTES + +### Documentos Core +- **Analisis Gaps:** `apps/erp-core/orchestration/01-analisis/ANALISIS-GAPS-CONSOLIDADO.md` +- **Inventario:** `apps/erp-core/orchestration/inventarios/MASTER_INVENTORY.yml` +- **Specs Transversales:** `apps/erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/` + +### Inventarios Suite +- **Suite Master:** `orchestration/inventarios/SUITE_MASTER_INVENTORY.yml` +- **Referencias:** `orchestration/inventarios/REFERENCIAS.yml` +- **Status:** `orchestration/inventarios/STATUS.yml` + +--- + +## METRICAS SUITE + +| Componente | Documentacion | Implementacion | +|------------|---------------|----------------| +| erp-core | 100% | 0% | +| construccion | 35% | 0% | +| vidrio-templado | 0% | 0% | +| mecanicas-diesel | 0% | 0% | +| retail | 0% | 0% | +| clinicas | 0% | 0% | + +--- + +*Ultima actualizacion: 2025-12-08* diff --git a/orchestration/environment/PROJECT-ENV-CONFIG.yml b/orchestration/environment/PROJECT-ENV-CONFIG.yml new file mode 100644 index 0000000..a54d2d4 --- /dev/null +++ b/orchestration/environment/PROJECT-ENV-CONFIG.yml @@ -0,0 +1,186 @@ +# ============================================================================= +# PROJECT-ENV-CONFIG.yml - ERP-SUITE (CONTENEDOR) +# ============================================================================= +# erp-suite es un CONTENEDOR de proyectos, NO un proyecto individual +# Actualizado: 2025-12-08 +# Referencia: ~/workspace/core/devtools/environment/DEVENV-PORTS.md +# ============================================================================= + +container: + name: "ERP-SUITE" + description: "Contenedor de proyectos ERP verticales" + type: "monorepo" + +# ============================================================================= +# PROYECTOS CONTENIDOS +# ============================================================================= +# NOTA: Los puertos están alineados con DEVENV-PORTS.md (fuente autoritativa) +# ============================================================================= +projects: + + # --------------------------------------------------------------------------- + # ERP-CORE - Núcleo compartido (Nivel 2B.1) + # --------------------------------------------------------------------------- + erp-core: + name: "ERP-CORE" + code: "CORE" + description: "Núcleo compartido del sistema ERP" + status: "development" + level: "2B.1" + path: "apps/erp-core" + + ports: + backend: 3000 + frontend: 5173 + database: 5432 + redis: 6379 + + database: + host: "localhost" + port: 5432 + name: "erp_core" + user: "erp_admin" + + env_files: + backend: "apps/erp-core/backend/.env" + root: "apps/erp-core/.env" + + # --------------------------------------------------------------------------- + # VERTICALES (Nivel 2B.2) - Puertos según DEVENV-PORTS.md + # --------------------------------------------------------------------------- + + construccion: + name: "ERP-CONSTRUCCION" + code: "CON" + description: "Sistema de Administración de Obra" + status: "development" + level: "2B.2" + path: "apps/verticales/construccion" + + ports: + backend: 3100 + frontend: 5174 + database: 5433 + redis: 6380 + + database: + host: "localhost" + port: 5433 + name: "construccion_db" + user: "construccion_user" + + env_files: + backend: "apps/verticales/construccion/backend/.env" + + vidrio-templado: + name: "ERP-VIDRIO-TEMPLADO" + code: "VT" + description: "Sistema para industria de vidrio templado" + status: "planning" + level: "2B.2" + path: "apps/verticales/vidrio-templado" + + ports: + backend: 3200 + frontend: 5175 + database: 5434 + redis: 6381 + + database: + host: "localhost" + port: 5434 + name: "vidrio_templado_db" + user: "vidrio_user" + + mecanicas-diesel: + name: "ERP-MECANICAS-DIESEL" + code: "MMD" + description: "Sistema para talleres mecánicos diesel" + status: "development" + level: "2B.2" + path: "apps/verticales/mecanicas-diesel" + + ports: + backend: 3300 + frontend: 5176 + database: 5435 + redis: 6382 + + database: + host: "localhost" + port: 5435 + name: "mecanicas_diesel_db" + user: "mecanicas_user" + + retail: + name: "ERP-RETAIL" + code: "RT" + description: "Sistema de Punto de Venta y Comercio Minorista" + status: "planning" + level: "2B.2" + path: "apps/verticales/retail" + + ports: + backend: 3400 + frontend: 5177 + database: 5436 + redis: 6383 + + database: + host: "localhost" + port: 5436 + name: "retail_db" + user: "retail_user" + + special: + offline_first: true + pwa: true + + clinicas: + name: "ERP-CLINICAS" + code: "CL" + description: "Sistema para Clínicas con Cumplimiento NOM-024" + status: "planning" + level: "2B.2" + path: "apps/verticales/clinicas" + + ports: + backend: 3500 + frontend: 5178 + database: 5437 + redis: 6384 + + database: + host: "localhost" + port: 5437 + name: "clinicas_db" + user: "clinicas_user" + + special: + compliance: + - NOM-024-SSA3-2012 + - LFPDPPP + two_factor_auth: required + encryption: AES-256 + +# ============================================================================= +# SERVICIOS COMPARTIDOS +# ============================================================================= +shared_services: + postgresql: + description: "Instancias PostgreSQL separadas por vertical" + notes: "Cada vertical tiene su propia instancia en puerto diferente" + + redis: + description: "Instancias Redis separadas por vertical" + notes: "Puertos 6379-6384 asignados" + +# ============================================================================= +# NOTAS +# ============================================================================= +notes: | + - erp-suite es un monorepo que contiene múltiples proyectos + - Puertos asignados según DEVENV-PORTS.md (fuente autoritativa) + - Cada vertical tiene su propia database y puerto + - erp-core provee funcionalidad compartida (auth, tenants, etc.) + - Verticales con special requirements: retail (offline-first), clinicas (NOM-024) diff --git a/orchestration/estados/REGISTRO-SUBAGENTES.json b/orchestration/estados/REGISTRO-SUBAGENTES.json new file mode 100644 index 0000000..0f7891c --- /dev/null +++ b/orchestration/estados/REGISTRO-SUBAGENTES.json @@ -0,0 +1,92 @@ +{ + "version": "2.0", + "proyecto": "erp-suite", + "descripcion": "ERP Suite - Sistema ERP Multi-Vertical", + "limite_maximo": 15, + "slots_disponibles": 15, + "subagentes": { + "NEXUS-DATABASE": { + "id": "NEXUS-DATABASE", + "tipo": "Database-Agent", + "responsabilidades": [ + "Diseño y creación de schemas PostgreSQL", + "Implementación de RLS policies multi-tenant", + "Seeds de desarrollo y producción", + "Schemas core y verticales" + ], + "areas_trabajo": [ + "apps/erp-core/database/", + "apps/verticales/*/database/" + ], + "puede_delegar_a": ["NEXUS-BACKEND"], + "recibe_de": ["NEXUS-BACKEND", "NEXUS-FRONTEND"] + }, + "NEXUS-BACKEND": { + "id": "NEXUS-BACKEND", + "tipo": "Backend-Agent", + "responsabilidades": [ + "Módulos Express.js", + "Entities TypeORM", + "Services y Controllers", + "Middleware multi-tenant" + ], + "areas_trabajo": [ + "apps/erp-core/backend/src/", + "apps/verticales/*/backend/src/" + ], + "puede_delegar_a": ["NEXUS-DATABASE", "NEXUS-FRONTEND"], + "recibe_de": ["NEXUS-DATABASE", "NEXUS-FRONTEND"] + }, + "NEXUS-FRONTEND": { + "id": "NEXUS-FRONTEND", + "tipo": "Frontend-Agent", + "responsabilidades": [ + "Componentes React", + "Pages y routing", + "Stores Zustand", + "Integración API" + ], + "areas_trabajo": [ + "apps/erp-core/frontend/src/", + "apps/verticales/*/frontend/src/" + ], + "puede_delegar_a": ["NEXUS-BACKEND"], + "recibe_de": ["NEXUS-BACKEND"] + } + }, + "matriz_comunicacion": { + "DATABASE_to_BACKEND": { + "trigger": "Tabla creada, necesita Entity", + "contexto_requerido": ["DDL file path", "Columnas", "Relaciones", "RLS policies"] + }, + "BACKEND_to_DATABASE": { + "trigger": "Entity necesita tabla", + "contexto_requerido": ["Entity spec", "Columnas requeridas", "Tenant context"] + }, + "BACKEND_to_FRONTEND": { + "trigger": "API disponible", + "contexto_requerido": ["Endpoints", "DTOs", "Swagger URL"] + }, + "FRONTEND_to_BACKEND": { + "trigger": "Necesita endpoint", + "contexto_requerido": ["Tipo esperado", "Operaciones necesarias"] + } + }, + "activos": [], + "completados": [], + "fallidos": [], + "referencias": { + "prompts_base": "core/orchestration/agents/", + "prompts_proyecto": "orchestration/prompts/", + "directivas_globales": "core/orchestration/directivas/", + "directivas_proyecto": "orchestration/directivas/", + "contexto_proyecto": "orchestration/00-guidelines/CONTEXTO-PROYECTO.md", + "guia_invocacion": "core/orchestration/agents/GUIA-INVOCACION-SUBAGENTES.md" + }, + "politicas": { + "max_subagentes_simultaneos": 3, + "timeout_subagente_minutos": 30, + "requiere_validacion_agente_principal": true, + "auto_actualizar_inventarios": true + } +} diff --git a/orchestration/inventarios/MASTER_INVENTORY.yml b/orchestration/inventarios/MASTER_INVENTORY.yml new file mode 100644 index 0000000..73780fa --- /dev/null +++ b/orchestration/inventarios/MASTER_INVENTORY.yml @@ -0,0 +1,177 @@ +# ============================================================================== +# MASTER INVENTORY - ERP SUITE +# ============================================================================== +# Estado general del proyecto multi-vertical +# Mantenido por: Workspace-Agent +# Actualizado: 2025-12-18 +# ============================================================================== + +version: "1.0.0" +updated: "2025-12-18" + +# ------------------------------------------------------------------------------ +# INFORMACION DEL PROYECTO +# ------------------------------------------------------------------------------ +project: + name: "erp-suite" + display_name: "ERP Suite - Sistema Multi-Vertical" + description: "Sistema ERP modular con soporte para multiples verticales" + status: "development" + version: "0.1.0" + started_at: "2025-12-18" + +# ------------------------------------------------------------------------------ +# ARQUITECTURA +# ------------------------------------------------------------------------------ +architecture: + type: "multi-vertical" + core: + name: "erp-core" + description: "Funcionalidad compartida entre verticales" + verticales: + - name: "construccion" + industry: "Construccion residencial" + status: "development" + - name: "mecanicas-diesel" + industry: "Talleres mecanicos" + status: "development" + +# ------------------------------------------------------------------------------ +# COMPONENTES - ERP CORE +# ------------------------------------------------------------------------------ +components: + erp_core: + backend: + name: "erp-core-api" + path: "apps/erp-core/backend" + port: 3010 + status: "development" + completeness: 25 + service_descriptor: true + modules: + - { name: "auth", status: "partial" } + - { name: "users", status: "partial" } + - { name: "companies", status: "partial" } + - { name: "tenants", status: "partial" } + - { name: "core", status: "partial" } + + frontend: + name: "erp-core-web" + path: "apps/erp-core/frontend" + port: 3011 + status: "planned" + completeness: 0 + +# ------------------------------------------------------------------------------ +# COMPONENTES - VERTICAL CONSTRUCCION +# ------------------------------------------------------------------------------ + construccion: + backend: + name: "erp-construccion-api" + path: "apps/verticales/construccion/backend" + port: 3020 + status: "development" + completeness: 40 + service_descriptor: true + modules: + - { name: "construction", status: "partial", entities: ["fraccionamiento", "etapa", "manzana", "lote"] } + - { name: "budgets", status: "partial" } + - { name: "estimates", status: "partial" } + - { name: "progress", status: "partial" } + - { name: "hr", status: "planned" } + - { name: "hse", status: "planned" } + - { name: "inventory", status: "planned" } + - { name: "purchase", status: "planned" } + + frontend: + name: "erp-construccion-web" + path: "apps/verticales/construccion/frontend" + port: 3021 + status: "planned" + completeness: 0 + +# ------------------------------------------------------------------------------ +# COMPONENTES - VERTICAL MECANICAS +# ------------------------------------------------------------------------------ + mecanicas: + backend: + name: "erp-mecanicas-api" + path: "apps/verticales/mecanicas-diesel/backend" + port: 3030 + status: "development" + completeness: 35 + service_descriptor: true + modules: + - { name: "workshop", status: "partial", entities: ["service_order", "diagnostic", "vehicle"] } + - { name: "inventory", status: "partial" } + - { name: "quotes", status: "partial" } + - { name: "billing", status: "planned" } + + frontend: + name: "erp-mecanicas-web" + path: "apps/verticales/mecanicas-diesel/frontend" + port: 3031 + status: "partial" + completeness: 20 + +# ------------------------------------------------------------------------------ +# INFRAESTRUCTURA +# ------------------------------------------------------------------------------ +infrastructure: + docker: + networks: + - "erp_core_local" + - "erp_construccion_local" + - "erp_mecanicas_local" + - "infra_shared" + + databases: + - name: "erp_core" + schemas: ["auth", "core"] + - name: "erp_construccion" + schemas: ["construction", "budgets", "estimates", "progress", "hr", "hse"] + - name: "erp_mecanicas" + schemas: ["workshop", "inventory", "quotes"] + +# ------------------------------------------------------------------------------ +# REGISTROS +# ------------------------------------------------------------------------------ +registry_refs: + ports: + core_api: "projects.erp_suite.services.api" + core_web: "projects.erp_suite.services.web" + construccion_api: "projects.erp_suite.verticales.construccion.api" + mecanicas_api: "projects.erp_suite.verticales.mecanicas.api" + + domains: + core_api: "api.erp.localhost" + core_web: "erp.localhost" + construccion_api: "api.construccion.erp.localhost" + mecanicas_api: "api.mecanicas.erp.localhost" + +# ------------------------------------------------------------------------------ +# METRICAS +# ------------------------------------------------------------------------------ +metrics: + overall_completeness: 30 + core_completeness: 25 + construccion_completeness: 40 + mecanicas_completeness: 28 + documentation: 40 + +# ------------------------------------------------------------------------------ +# PROXIMOS PASOS +# ------------------------------------------------------------------------------ +next_steps: + - priority: "high" + task: "Completar modulo auth en erp-core" + agent: "NEXUS-BACKEND" + - priority: "high" + task: "Crear docker-compose para ERP Suite" + agent: "NEXUS-DEVOPS" + - priority: "medium" + task: "Implementar entidades de construccion" + agent: "NEXUS-BACKEND" + - priority: "medium" + task: "Crear frontend para mecanicas" + agent: "NEXUS-FRONTEND" diff --git a/orchestration/inventarios/REFERENCIAS.yml b/orchestration/inventarios/REFERENCIAS.yml new file mode 100644 index 0000000..ab7783b --- /dev/null +++ b/orchestration/inventarios/REFERENCIAS.yml @@ -0,0 +1,370 @@ +# Referencias Inventory - ERP Suite +# Ultima actualizacion: 2025-12-08 +# Punteros a artefactos en niveles inferiores (NO duplicar contenido) + +# ============================================================================ +# REFERENCIAS DESDE ERP-CORE (Nivel 2B.1) +# ============================================================================ +referencias_erp_core: + # Especificaciones Transversales + especificaciones_transversales: + ubicacion_base: apps/erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/ + fecha_propagacion: 2025-12-08 + total: 30 + + p0_funcionales: + - ref: SPEC-SISTEMA-SECUENCIAS.md + gap: "ir.sequence" + sp: 8 + - ref: SPEC-VALORACION-INVENTARIO.md + gap: "FIFO/AVCO" + sp: 21 + - ref: SPEC-SEGURIDAD-API-KEYS-PERMISOS.md + gap: "API Keys + ACL + RLS" + sp: 31 + - ref: SPEC-REPORTES-FINANCIEROS.md + gap: "Balance/P&L SAT" + sp: 13 + - ref: SPEC-PORTAL-PROVEEDORES.md + gap: "Portal RFQ" + sp: 13 + - ref: SPEC-NOMINA-BASICA.md + gap: "hr_payroll" + sp: 21 + - ref: SPEC-GASTOS-EMPLEADOS.md + gap: "hr_expense" + sp: 13 + - ref: SPEC-TAREAS-RECURRENTES.md + gap: "project.task.recurrence" + sp: 13 + - ref: SPEC-SCHEDULER-REPORTES.md + gap: "ir.cron + mail" + sp: 8 + - ref: SPEC-INTEGRACION-CALENDAR.md + gap: "calendar integration" + sp: 8 + + p1: + - ref: SPEC-CONTABILIDAD-ANALITICA-MULTIDIMENSIONAL.md + sp: 21 + - ref: SPEC-CONCILIACION-BANCARIA.md + sp: 21 + - ref: SPEC-FIRMA-ELECTRONICA-NOM151.md + sp: 13 + - ref: SPEC-TWO-FACTOR-AUTHENTICATION.md + sp: 13 + - ref: SPEC-TRAZABILIDAD-LOTES-SERIES.md + sp: 13 + - ref: SPEC-PRICING-RULES.md + sp: 8 + - ref: SPEC-BLANKET-ORDERS.md + sp: 13 + - ref: SPEC-OAUTH2-SOCIAL-LOGIN.md + sp: 8 + - ref: SPEC-INVENTARIOS-CICLICOS.md + sp: 13 + - ref: SPEC-IMPUESTOS-AVANZADOS.md + sp: 8 + - ref: SPEC-PLANTILLAS-CUENTAS.md + sp: 8 + - ref: SPEC-CONSOLIDACION-FINANCIERA.md + sp: 13 + - ref: SPEC-TASAS-CAMBIO-AUTOMATICAS.md + sp: 5 + - ref: SPEC-ALERTAS-PRESUPUESTO.md + sp: 8 + - ref: SPEC-PRESUPUESTOS-REVISIONES.md + sp: 8 + - ref: SPEC-RRHH-EVALUACIONES-SKILLS.md + sp: 26 + - ref: SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN.md + sp: 13 + - ref: SPEC-LOCALIZACION-PAISES.md + sp: 13 + + patrones_tecnicos: + - ref: SPEC-MAIL-THREAD-TRACKING.md + patron: "mail.thread mixin" + sp: 13 + - ref: SPEC-WIZARD-TRANSIENT-MODEL.md + patron: "TransientModel" + sp: 8 + + # Workflows + workflows: + ubicacion_base: apps/erp-core/docs/04-modelado/workflows/ + fecha_propagacion: 2025-12-08 + total: 3 + documentos: + - ref: WORKFLOW-CIERRE-PERIODO-CONTABLE.md + gap: "lock dates" + - ref: WORKFLOW-3-WAY-MATCH.md + gap: "3-way match" + - ref: WORKFLOW-PAGOS-ANTICIPADOS.md + gap: "down payments" + + # Analisis + analisis: + - ref: apps/erp-core/orchestration/01-analisis/ANALISIS-GAPS-CONSOLIDADO.md + version: "10.0" + descripcion: "Gap Analysis completo vs Odoo 18" + - ref: apps/erp-core/orchestration/01-analisis/ANALISIS-PROPAGACION-ALINEAMIENTO.md + version: "1.0" + descripcion: "Analisis de propagacion y alineamiento SIMCO" + + # Inventarios + inventarios: + - ref: apps/erp-core/orchestration/inventarios/MASTER_INVENTORY.yml + descripcion: "Inventario maestro de erp-core" + +# ============================================================================ +# REFERENCIAS DESDE VERTICALES (Nivel 2B.2) +# ============================================================================ +referencias_verticales: + construccion: + ubicacion_base: apps/verticales/construccion/ + nivel: 2B.2 + estado: EN_DESARROLLO + completitud: 40% + documentacion: docs/ (449 archivos) + orchestration: orchestration/ + inventarios: + ubicacion: orchestration/inventarios/ + archivos: 6 + readme: true + database: + ubicacion: database/ + herencia: database/HERENCIA-ERP-CORE.md + ddl_implementado: true + tablas_especificas: 33 + backend: + porcentaje: 15% + entities: 12 + services: 2 + controllers: 2 + directivas: + - directivas/DIRECTIVA-CONTROL-OBRA.md + - directivas/DIRECTIVA-ESTIMACIONES.md + - directivas/DIRECTIVA-INTEGRACION-INFONAVIT.md + + mecanicas_diesel: + ubicacion_base: apps/verticales/mecanicas-diesel/ + nivel: 2B.2 + estado: DDL_IMPLEMENTADO + completitud: 20% + documentacion: docs/ (75 archivos) + orchestration: orchestration/ + inventarios: + ubicacion: orchestration/inventarios/ + archivos: 6 + readme: true + database: + ubicacion: database/ + herencia: database/HERENCIA-ERP-CORE.md + ddl_implementado: true + lineas_sql: 1561 + directivas: + - directivas/DIRECTIVA-ORDENES-TRABAJO.md + - directivas/DIRECTIVA-INVENTARIO-REFACCIONES.md + + vidrio_templado: + ubicacion_base: apps/verticales/vidrio-templado/ + nivel: 2B.2 + estado: PLANIFICACION_COMPLETA + completitud: 15% + documentacion: docs/ + orchestration: orchestration/ + inventarios: + ubicacion: orchestration/inventarios/ + archivos: 6 + readme: true + database: + ubicacion: database/ + herencia: database/HERENCIA-ERP-CORE.md + ddl_implementado: false + directivas: + - directivas/DIRECTIVA-PRODUCCION-VIDRIO.md + - directivas/DIRECTIVA-CONTROL-CALIDAD.md + + retail: + ubicacion_base: apps/verticales/retail/ + nivel: 2B.2 + estado: PLANIFICACION_COMPLETA + completitud: 15% + documentacion: docs/ + orchestration: orchestration/ + inventarios: + ubicacion: orchestration/inventarios/ + archivos: 6 + readme: true + database: + ubicacion: database/ + herencia: database/HERENCIA-ERP-CORE.md + ddl_implementado: false + directivas: + - directivas/DIRECTIVA-PUNTO-VENTA.md + - directivas/DIRECTIVA-INVENTARIO-SUCURSALES.md + + clinicas: + ubicacion_base: apps/verticales/clinicas/ + nivel: 2B.2 + estado: PLANIFICACION_COMPLETA + completitud: 15% + documentacion: docs/ + orchestration: orchestration/ + inventarios: + ubicacion: orchestration/inventarios/ + archivos: 6 + readme: true + database: + ubicacion: database/ + herencia: database/HERENCIA-ERP-CORE.md + ddl_implementado: false + directivas: + - directivas/DIRECTIVA-EXPEDIENTE-CLINICO.md + - directivas/DIRECTIVA-GESTION-CITAS.md + +# ============================================================================ +# MATRIZ DE HERENCIA (Verticales -> Core) +# ============================================================================ +herencia_verticales: + descripcion: "Especificaciones del core que cada vertical debe heredar" + fecha_propagacion: 2025-12-08 + estado_propagacion: COMPLETO + mapeo_completo: apps/erp-core/docs/04-modelado/MAPEO-SPECS-VERTICALES.md + + construccion: + codigo: CONS + modulos: 18 + story_points: 450+ + specs_aplicables: 27 + specs_implementadas: 0 + specs_principales: + - SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN + - SPEC-MAIL-THREAD-TRACKING + - SPEC-WIZARD-TRANSIENT-MODEL + - SPEC-VALORACION-INVENTARIO + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-RRHH-EVALUACIONES-SKILLS + documentado: true + documento_herencia: apps/verticales/construccion/database/HERENCIA-ERP-CORE.md + documento_specs: apps/verticales/construccion/orchestration/00-guidelines/HERENCIA-SPECS-CORE.md + tablas_heredadas: 124 + tablas_especificas: 33 + + mecanicas_diesel: + codigo: MMD + modulos: 5 + story_points: 150+ + specs_aplicables: 25 + specs_implementadas: 0 + specs_principales: + - SPEC-VALORACION-INVENTARIO + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-INVENTARIOS-CICLICOS + - SPEC-PRICING-RULES + - SPEC-FACTURACION-CFDI + documentado: true + documento_herencia: apps/verticales/mecanicas-diesel/database/HERENCIA-ERP-CORE.md + documento_specs: apps/verticales/mecanicas-diesel/orchestration/00-guidelines/HERENCIA-SPECS-CORE.md + tablas_heredadas: 97 + tablas_especificas: 30+ + + vidrio_templado: + codigo: VT + modulos: 8 + story_points: 212 + specs_aplicables: 25 + specs_implementadas: 0 + specs_principales: + - SPEC-VALORACION-INVENTARIO + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-PRICING-RULES + - SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN + documentado: true + documento_herencia: apps/verticales/vidrio-templado/database/HERENCIA-ERP-CORE.md + documento_specs: apps/verticales/vidrio-templado/orchestration/00-guidelines/HERENCIA-SPECS-CORE.md + tablas_heredadas: 97 + tablas_planificadas: 25 + + retail: + codigo: RT + modulos: 10 + story_points: 322 + specs_aplicables: 26 + specs_implementadas: 0 + specs_principales: + - SPEC-PRICING-RULES + - SPEC-INVENTARIOS-CICLICOS + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-FACTURACION-CFDI + - SPEC-VALORACION-INVENTARIO + documentado: true + documento_herencia: apps/verticales/retail/database/HERENCIA-ERP-CORE.md + documento_specs: apps/verticales/retail/orchestration/00-guidelines/HERENCIA-SPECS-CORE.md + tablas_heredadas: 97 + tablas_planificadas: 35 + + clinicas: + codigo: CL + modulos: 12 + story_points: 395 + specs_aplicables: 22 + specs_implementadas: 0 + specs_principales: + - SPEC-INTEGRACION-CALENDAR + - SPEC-MAIL-THREAD-TRACKING + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-FACTURACION-CFDI + - SPEC-RRHH-EVALUACIONES-SKILLS + cumplimiento_normativo: + - NOM-024-SSA3-2012 + - LFPDPPP + documentado: true + documento_herencia: apps/verticales/clinicas/database/HERENCIA-ERP-CORE.md + documento_specs: apps/verticales/clinicas/orchestration/00-guidelines/HERENCIA-SPECS-CORE.md + tablas_heredadas: 97 + tablas_planificadas: 45 + +# ============================================================================ +# VALIDACION DE PROPAGACION SIMCO +# ============================================================================ +validacion_propagacion: + fecha: 2025-12-08 + sistema: SIMCO v2.2.0 + + niveles: + suite_master: + nivel: 2B + inventarios: [SUITE_MASTER_INVENTORY.yml, STATUS.yml, REFERENCIAS.yml] + estado: COMPLETO + + erp_core: + nivel: 2B.1 + inventarios: 6 + estado: COMPLETO + carga_limpia: EXITOSA + + verticales: + nivel: 2B.2 + total: 5 + inventarios_por_vertical: 6 + readme_por_vertical: 5/5 + herencia_documentada: 5/5 + directivas_por_vertical: 2-3 + + checklist: + - item: "SUITE_MASTER_INVENTORY actualizado" + estado: true + - item: "STATUS.yml sincronizado" + estado: true + - item: "REFERENCIAS.yml completo" + estado: true + - item: "README.md en todas las verticales" + estado: true + - item: "HERENCIA-ERP-CORE.md en todas las verticales" + estado: true + - item: "Directivas específicas por vertical" + estado: true + - item: "6 inventarios por proyecto" + estado: true diff --git a/orchestration/inventarios/STATUS.yml b/orchestration/inventarios/STATUS.yml new file mode 100644 index 0000000..3cb6f1c --- /dev/null +++ b/orchestration/inventarios/STATUS.yml @@ -0,0 +1,315 @@ +# Status Inventory - ERP Suite +# Ultima actualizacion: 2025-12-08 +# Estado de todos los componentes de la suite + +componentes: + # ======================================== + # ERP CORE + # ======================================== + erp_core: + nivel: "2B.1" + ultima_modificacion: "2025-12-08" + modificado_por: "Database-Agent" + estado: "DATABASE_COMPLETO" + + capas: + documentacion: + estado: "COMPLETA" + gap_analysis: "100% P0 + 100% P1" + especificaciones: 30 + workflows: 3 + + database: + estado: "COMPLETO_VALIDADO" + tablas_totales: 124 + schemas: 12 + ddl_archivos: 15 + validacion_carga_limpia: "EXITOSA" + fecha_validacion: "2025-12-08" + estadisticas: + auth: 26 + inventory: 15 + financial: 15 + core: 12 + billing: 11 + system: 10 + purchase: 8 + hr: 6 + sales: 6 + projects: 5 + analytics: 5 + crm: 5 + + backend: + estado: "PENDIENTE_IMPLEMENTACION" + endpoints_especificados: 148 + services_especificados: 45+ + + frontend: + estado: "PENDIENTE_IMPLEMENTACION" + componentes_especificados: 80+ + + artefactos_recientes: + - "CARGA LIMPIA EXITOSA (2025-12-08) - 124 tablas, 12 schemas" + - "01-auth-extensions.sql - 16 tablas, 6 funciones" + - "05-inventory-extensions.sql - 10 tablas, 7 funciones" + - "30 especificaciones transversales completadas" + + # ======================================== + # VERTICALES + # ======================================== + construccion: + nivel: "2B.2" + ultima_modificacion: "2025-12-08" + estado: "EN_DESARROLLO" + completitud: "40%" + capas: + documentacion: + estado: "AVANZADA" + archivos: 449 + database: + estado: "DDL_COMPLETO" + tablas_core_heredadas: 124 + tablas_especificas: 33 + schemas_especificos: ["construccion", "hr", "hse"] + backend: + estado: "EN_PROGRESO" + archivos_ts: 25 + entities: 12 + services: 2 + controllers: 2 + porcentaje: "15%" + modulos_funcionales: ["construction"] + frontend: + estado: "INICIAL" + archivos: 3 + porcentaje: "2%" + herencia_core: + documentado: true + archivo_herencia: "database/HERENCIA-ERP-CORE.md" + specs_heredadas: 6 + specs_lista: + - SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN.md + - SPEC-MAIL-THREAD-TRACKING.md + - SPEC-WIZARD-TRANSIENT-MODEL.md + - SPEC-VALORACION-INVENTARIO.md + - SPEC-TRAZABILIDAD-LOTES-SERIES.md + - SPEC-TAREAS-RECURRENTES.md + gap_analisis: + documentacion_vs_codigo: "449 MD vs 25 código" + ratio_implementacion: "5.6%" + nota: "Gap corregido - entities base implementadas" + + vidrio_templado: + nivel: "2B.2" + ultima_modificacion: "2025-12-08" + estado: "PLANIFICACION_COMPLETA" + completitud: "20%" + modulos: + total: 8 + codigos: [VT-001, VT-002, VT-003, VT-004, VT-005, VT-006, VT-007, VT-008] + story_points: 212 + orchestration: + inventarios: 6 # MASTER, DATABASE, BACKEND, FRONTEND, TRACEABILITY, DEPENDENCY + directivas: 2 # PRODUCCION-VIDRIO, CONTROL-CALIDAD + herencia: true + herencia_core: + documentado: true + archivo: "orchestration/00-guidelines/HERENCIA-SPECS-CORE.md" + specs_aplicables: 25 + specs_implementadas: 0 + specs_principales: + - SPEC-VALORACION-INVENTARIO + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-PRICING-RULES + - SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN + + mecanicas_diesel: + nivel: "2B.2" + ultima_modificacion: "2025-12-08" + estado: "DDL_IMPLEMENTADO" + completitud: "20%" + capas: + documentacion: + estado: "COMPLETA" + archivos: 75 + database: + estado: "DDL_DEFINIDO" + tablas_core_heredadas: 97 + tablas_especificas: 30+ + schemas_especificos: ["service_management", "parts_management", "vehicle_management"] + lineas_sql: 1561 + backend: + estado: "PENDIENTE" + porcentaje: "0%" + frontend: + estado: "PENDIENTE" + porcentaje: "0%" + orchestration: + inventarios: 6 + directivas: 2 + herencia: true + herencia_core: + documentado: true + archivo_herencia: "database/HERENCIA-ERP-CORE.md" + specs_heredadas: 5 + specs_lista: + - SPEC-VALORACION-INVENTARIO.md + - SPEC-TRAZABILIDAD-LOTES-SERIES.md + - SPEC-INVENTARIOS-CICLICOS.md + - SPEC-MAIL-THREAD-TRACKING.md + - SPEC-TAREAS-RECURRENTES.md + + retail: + nivel: "2B.2" + ultima_modificacion: "2025-12-08" + estado: "PLANIFICACION_COMPLETA" + completitud: "20%" + modulos: + total: 10 + codigos: [RT-001, RT-002, RT-003, RT-004, RT-005, RT-006, RT-007, RT-008, RT-009, RT-010] + story_points: 322 + orchestration: + inventarios: 6 + directivas: 2 # PUNTO-VENTA, INVENTARIO-SUCURSALES + herencia: true + herencia_core: + documentado: true + archivo: "orchestration/00-guidelines/HERENCIA-SPECS-CORE.md" + specs_aplicables: 26 + specs_implementadas: 0 + specs_principales: + - SPEC-PRICING-RULES + - SPEC-INVENTARIOS-CICLICOS + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-FACTURACION-CFDI + + clinicas: + nivel: "2B.2" + ultima_modificacion: "2025-12-08" + estado: "PLANIFICACION_COMPLETA" + completitud: "20%" + modulos: + total: 12 + codigos: [CL-001, CL-002, CL-003, CL-004, CL-005, CL-006, CL-007, CL-008, CL-009, CL-010, CL-011, CL-012] + story_points: 395 + orchestration: + inventarios: 6 + directivas: 2 # EXPEDIENTE-CLINICO, GESTION-CITAS + herencia: true + herencia_core: + documentado: true + archivo: "orchestration/00-guidelines/HERENCIA-SPECS-CORE.md" + specs_aplicables: 22 + specs_implementadas: 0 + specs_principales: + - SPEC-INTEGRACION-CALENDAR + - SPEC-MAIL-THREAD-TRACKING + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-FACTURACION-CFDI + cumplimiento_normativo: + - NOM-024-SSA3-2012 + - LFPDPPP + +# ======================================== +# RESUMEN DE ESTADOS +# ======================================== +resumen: + total_componentes: 6 + fecha_actualizacion: "2025-12-08" + + por_estado: + DATABASE_COMPLETO: + - erp_core # 124 tablas, carga limpia exitosa + EN_DESARROLLO: + - construccion # 35% - DDL completo, backend 5%, frontend 2% + DDL_IMPLEMENTADO: + - mecanicas_diesel # 20% - DDL definido, backend/frontend pendiente + PLANIFICACION_COMPLETA: + - vidrio_templado # 15% + - retail # 15% + - clinicas # 15% + + propagacion_completada: + inventarios: true # Todos tienen 6 archivos de inventario + directivas: true # Todos tienen directivas especificas + herencia_core: true # Todos tienen HERENCIA-ERP-CORE.md en database/ + homologacion: true # Inventarios actualizados con estado real + + estadisticas_globales: + tablas_core: 124 + verticales_con_ddl: 2 # construccion, mecanicas-diesel + verticales_en_planificacion: 3 # vidrio-templado, retail, clinicas + +# ======================================== +# ALERTAS +# ======================================== +alertas: + - componente: "erp_core" + tipo: "COMPLETADO" + mensaje: "Carga limpia ejecutada exitosamente - 124 tablas, 12 schemas" + fecha: "2025-12-08" + + - componente: "construccion" + tipo: "EN_PROGRESO" + mensaje: "Gap corregido: 12 entities, 2 services, 2 controllers implementados" + fecha: "2025-12-08" + + - componente: "mecanicas_diesel" + tipo: "PENDIENTE" + mensaje: "DDL definido, requiere carga y backend/frontend" + fecha: "2025-12-08" + +# ======================================== +# HISTORIAL DE CAMBIOS RECIENTES +# ======================================== +historial: + - fecha: "2025-12-08" + componente: "construccion" + cambio: "IMPLEMENTACION GAP FIX - 12 entities, 2 services, 2 controllers creados" + agente: "System" + detalles: + - "Entities: Proyecto, Fraccionamiento, Employee, Puesto, Incidente, Capacitacion" + - "Services: ProyectoService, FraccionamientoService" + - "Controllers: ProyectoController, FraccionamientoController" + - "Backend 15% implementado (25 archivos TS)" + + - fecha: "2025-12-08" + componente: "erp_core" + cambio: "CARGA LIMPIA EXITOSA - 124 tablas, 12 schemas, 6 seeds" + agente: "Database-Agent" + + - fecha: "2025-12-08" + componente: "verticales" + cambio: "Creados HERENCIA-ERP-CORE.md para construccion y mecanicas-diesel" + agente: "System" + + - fecha: "2025-12-08" + componente: "todas_verticales" + cambio: "Homologación de inventarios con estado real de implementación" + agente: "System" + + - fecha: "2025-12-08" + componente: "todas_verticales" + cambio: "Completados inventarios y directivas para vidrio-templado, mecanicas-diesel, retail, clinicas" + agente: "System" + + - fecha: "2025-12-08" + componente: "erp_core" + cambio: "DDL extensions auth + inventory implementados" + agente: "Database-Agent" + + - fecha: "2025-12-08" + componente: "erp_core" + cambio: "Gap Analysis completado - 30 specs + 3 workflows" + agente: "Requirements-Analyst" + + - fecha: "2025-12-05" + componente: "erp_core" + cambio: "Migracion desde workspace-erp-inmobiliaria" + agente: "Migration" + + - fecha: "2025-12-05" + componente: "construccion" + cambio: "Migracion de documentacion (403 archivos)" + agente: "Migration" diff --git a/orchestration/inventarios/SUITE_MASTER_INVENTORY.yml b/orchestration/inventarios/SUITE_MASTER_INVENTORY.yml new file mode 100644 index 0000000..11209bb --- /dev/null +++ b/orchestration/inventarios/SUITE_MASTER_INVENTORY.yml @@ -0,0 +1,506 @@ +# Suite Master Inventory - ERP Suite +# Ultima actualizacion: 2025-12-08 +# SSOT para metricas de toda la suite (core + verticales) +# Sistema: SIMCO v2.2.0 +# Nivel: 2B (Suite Master) + +suite: + nombre: ERP Suite + tipo: Multi-Vertical Suite + version: 0.6.0 + nivel: 2B + estado: En Desarrollo + ultima_modificacion: 2025-12-08 + + # Inventarios de este nivel + inventarios_suite: + - SUITE_MASTER_INVENTORY.yml # Este archivo + - STATUS.yml # Estado de componentes + - REFERENCIAS.yml # Referencias cruzadas + - BACKEND_CONSOLIDATED.yml # Consolidado backend (referencia) + - FRONTEND_CONSOLIDATED.yml # Consolidado frontend (referencia) + - DEPENDENCY_SUITE.yml # Dependencias inter-proyecto + +# ============================================================================ +# ERP CORE (Nivel 2B.1) - PROYECTO PADRE +# ============================================================================ +erp_core: + path: apps/erp-core/ + nivel: 2B.1 + estado: DATABASE_COMPLETO + version: 1.1.0 + ultima_modificacion: 2025-12-08 + + # Estado de capas + capas: + documentacion: + estado: COMPLETA + archivos: 680+ + especificaciones: 30 + workflows: 3 + + database: + estado: VALIDADO + tablas: 124 + schemas: 12 + ddl_archivos: 15 + carga_limpia: EXITOSA + fecha_validacion: 2025-12-08 + + backend: + estado: PENDIENTE + endpoints_especificados: 148 + services_especificados: 45+ + + frontend: + estado: PENDIENTE + componentes_especificados: 80+ + + # Inventarios del core (6 archivos estándar) + inventarios: + - MASTER_INVENTORY.yml + - DATABASE_INVENTORY.yml + - BACKEND_INVENTORY.yml + - FRONTEND_INVENTORY.yml + - DEPENDENCY_GRAPH.yml + - TRACEABILITY_MATRIX.yml + ubicacion: apps/erp-core/orchestration/inventarios/ + + # Métricas de documentación + metricas: + modulos_totales: 15 + modulos_p0: 4 + modulos_p1: 6 + modulos_p2: 5 + gap_analysis_cobertura: "100%" + story_points_cubiertos: 394 + + # Especificaciones que heredan las verticales + especificaciones_heredables: + ubicacion: docs/04-modelado/especificaciones-tecnicas/transversal/ + total: 30 + lista_principales: + - SPEC-VALORACION-INVENTARIO.md + - SPEC-TRAZABILIDAD-LOTES-SERIES.md + - SPEC-INVENTARIOS-CICLICOS.md + - SPEC-MAIL-THREAD-TRACKING.md + - SPEC-TAREAS-RECURRENTES.md + - SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN.md + - SPEC-INTEGRACION-CALENDAR.md + - SPEC-PRICING-RULES.md + - SPEC-RRHH-EVALUACIONES-SKILLS.md + + referencias: + inventario_local: apps/erp-core/orchestration/inventarios/MASTER_INVENTORY.yml + analisis_gaps: apps/erp-core/orchestration/01-analisis/ANALISIS-GAPS-CONSOLIDADO.md + database_readme: apps/erp-core/database/README.md + +# ============================================================================ +# VERTICALES (Nivel 2B.2) - PROYECTOS HIJOS +# ============================================================================ +verticales: + total: 5 + en_desarrollo: 1 + ddl_implementado: 1 + epicas_completas: 3 # VT, RT, CL tienen todas las épicas + + # Inventarios estándar que debe tener cada vertical + inventarios_requeridos: + - MASTER_INVENTORY.yml + - DATABASE_INVENTORY.yml + - BACKEND_INVENTORY.yml + - FRONTEND_INVENTORY.yml + - DEPENDENCY_GRAPH.yml + - TRACEABILITY_MATRIX.yml + + lista: + # ------------------------------------------------------------------------- + # CONSTRUCCION - Vertical más avanzada + # ------------------------------------------------------------------------- + - nombre: construccion + path: apps/verticales/construccion/ + nivel: 2B.2 + estado: EN_DESARROLLO + completitud: 40% + ultima_modificacion: 2025-12-08 + + capas: + documentacion: + estado: AVANZADA + archivos: 449 + database: + estado: DDL_COMPLETO + tablas_heredadas: 124 + tablas_especificas: 33 + schemas: [construccion, hr, hse] + backend: + estado: EN_PROGRESO + porcentaje: 15% + entities: 12 + services: 2 + controllers: 2 + frontend: + estado: INICIAL + porcentaje: 2% + + herencia_core: + specs_heredadas: 6 + documento: database/HERENCIA-ERP-CORE.md + lista: + - SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN.md + - SPEC-MAIL-THREAD-TRACKING.md + - SPEC-WIZARD-TRANSIENT-MODEL.md + - SPEC-VALORACION-INVENTARIO.md + - SPEC-TRAZABILIDAD-LOTES-SERIES.md + - SPEC-TAREAS-RECURRENTES.md + + directivas_especificas: + - DIRECTIVA-CONTROL-OBRA.md + - DIRECTIVA-ESTIMACIONES.md + - DIRECTIVA-INTEGRACION-INFONAVIT.md + + inventarios_ubicacion: orchestration/inventarios/ + + # ------------------------------------------------------------------------- + # MECANICAS-DIESEL + # ------------------------------------------------------------------------- + - nombre: mecanicas-diesel + path: apps/verticales/mecanicas-diesel/ + nivel: 2B.2 + estado: DDL_IMPLEMENTADO + completitud: 20% + ultima_modificacion: 2025-12-08 + + capas: + documentacion: + estado: COMPLETA + archivos: 75 + database: + estado: DDL_DEFINIDO + tablas_heredadas: 97 + tablas_especificas: 30+ + schemas: [service_management, parts_management, vehicle_management] + lineas_sql: 1561 + backend: + estado: PENDIENTE + porcentaje: 0% + frontend: + estado: PENDIENTE + porcentaje: 0% + + herencia_core: + specs_heredadas: 5 + documento: database/HERENCIA-ERP-CORE.md + lista: + - SPEC-VALORACION-INVENTARIO.md + - SPEC-TRAZABILIDAD-LOTES-SERIES.md + - SPEC-INVENTARIOS-CICLICOS.md + - SPEC-MAIL-THREAD-TRACKING.md + - SPEC-TAREAS-RECURRENTES.md + + directivas_especificas: + - DIRECTIVA-ORDENES-TRABAJO.md + - DIRECTIVA-INVENTARIO-REFACCIONES.md + + inventarios_ubicacion: orchestration/inventarios/ + + # ------------------------------------------------------------------------- + # VIDRIO-TEMPLADO + # ------------------------------------------------------------------------- + - nombre: vidrio-templado + path: apps/verticales/vidrio-templado/ + nivel: 2B.2 + estado: EPICAS_COMPLETAS + completitud: 25% + ultima_modificacion: 2025-12-08 + + modulos: + total: 8 + codigos: [VT-001, VT-002, VT-003, VT-004, VT-005, VT-006, VT-007, VT-008] + nombres: [Fundamentos, Cotizaciones, Produccion, Inventario, Corte, Templado, Calidad, Despacho] + story_points: 259 + epicas_completas: 8/8 + + capas: + documentacion: + estado: COMPLETA + vision: docs/00-vision-general/VISION-VIDRIO.md + modulos: docs/02-definicion-modulos/ + database: + estado: PLANIFICADO + schemas_planificados: [production, quality, glass] + tablas_planificadas: 25 + backend: + estado: PENDIENTE + frontend: + estado: PENDIENTE + + herencia_core: + specs_aplicables: 25 + specs_implementadas: 0 + documento: orchestration/00-guidelines/HERENCIA-SPECS-CORE.md + lista_principales: + - SPEC-VALORACION-INVENTARIO + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-PRICING-RULES + - SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN + + directivas_especificas: + - DIRECTIVA-PRODUCCION-VIDRIO.md + - DIRECTIVA-CONTROL-CALIDAD.md + + inventarios_ubicacion: orchestration/inventarios/ + + # ------------------------------------------------------------------------- + # RETAIL + # ------------------------------------------------------------------------- + - nombre: retail + path: apps/verticales/retail/ + nivel: 2B.2 + estado: EPICAS_COMPLETAS + completitud: 25% + ultima_modificacion: 2025-12-08 + + modulos: + total: 10 + codigos: [RT-001, RT-002, RT-003, RT-004, RT-005, RT-006, RT-007, RT-008, RT-009, RT-010] + nombres: [Fundamentos, POS, Inventario, Compras, Clientes, Precios, Caja, Reportes, E-commerce, Facturacion] + story_points: 353 + epicas_completas: 10/10 + + capas: + documentacion: + estado: COMPLETA + vision: docs/00-vision-general/VISION-RETAIL.md + modulos: docs/02-definicion-modulos/ + database: + estado: PLANIFICADO + schemas_planificados: [pos, loyalty, pricing] + tablas_planificadas: 35 + backend: + estado: PENDIENTE + frontend: + estado: PENDIENTE + + herencia_core: + specs_aplicables: 26 + specs_implementadas: 0 + documento: orchestration/00-guidelines/HERENCIA-SPECS-CORE.md + lista_principales: + - SPEC-PRICING-RULES + - SPEC-INVENTARIOS-CICLICOS + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-FACTURACION-CFDI + + directivas_especificas: + - DIRECTIVA-PUNTO-VENTA.md + - DIRECTIVA-INVENTARIO-SUCURSALES.md + + inventarios_ubicacion: orchestration/inventarios/ + + # ------------------------------------------------------------------------- + # CLINICAS + # ------------------------------------------------------------------------- + - nombre: clinicas + path: apps/verticales/clinicas/ + nivel: 2B.2 + estado: EPICAS_COMPLETAS + completitud: 25% + ultima_modificacion: 2025-12-08 + + modulos: + total: 12 + codigos: [CL-001, CL-002, CL-003, CL-004, CL-005, CL-006, CL-007, CL-008, CL-009, CL-010, CL-011, CL-012] + nombres: [Fundamentos, Pacientes, Citas, Consultas, Recetas, Laboratorio, Farmacia, Facturacion, Reportes, Telemedicina, Expediente, Imagenologia] + story_points: 451 + epicas_completas: 12/12 + + capas: + documentacion: + estado: COMPLETA + vision: docs/00-vision-general/VISION-CLINICAS.md + modulos: docs/02-definicion-modulos/ + database: + estado: PLANIFICADO + schemas_planificados: [clinical, pharmacy, laboratory, imaging] + tablas_planificadas: 45 + backend: + estado: PENDIENTE + frontend: + estado: PENDIENTE + + herencia_core: + specs_aplicables: 22 + specs_implementadas: 0 + documento: orchestration/00-guidelines/HERENCIA-SPECS-CORE.md + lista_principales: + - SPEC-INTEGRACION-CALENDAR + - SPEC-MAIL-THREAD-TRACKING + - SPEC-TRAZABILIDAD-LOTES-SERIES + - SPEC-FACTURACION-CFDI + + cumplimiento_normativo: + - NOM-024-SSA3-2012 (Expediente clínico) + - LFPDPPP (Datos personales) + + directivas_especificas: + - DIRECTIVA-EXPEDIENTE-CLINICO.md + - DIRECTIVA-GESTION-CITAS.md + + inventarios_ubicacion: orchestration/inventarios/ + +# ============================================================================ +# SHARED LIBS (Futuro) +# ============================================================================ +shared_libs: + path: apps/shared-libs/ + nivel: 2B.3 + estado: PLANIFICADO + documentacion: PENDIENTE + proposito: "Componentes compartidos entre verticales" + +# ============================================================================ +# SAAS LAYER (Futuro) +# ============================================================================ +saas: + path: apps/saas/ + nivel: 2B.4 + estado: PLANIFICADO + documentacion: PENDIENTE + proposito: "Capa de servicios multi-tenant cloud" + +# ============================================================================ +# METRICAS CONSOLIDADAS DE LA SUITE +# ============================================================================ +metricas_suite: + fecha_actualizacion: 2025-12-08 + + modulos_por_vertical: + construccion: 18 # MAI-001 a MAI-018 + mecanicas_diesel: 5 # MMD-001 a MMD-005 + vidrio_templado: 8 # VT-001 a VT-008 + retail: 10 # RT-001 a RT-010 + clinicas: 12 # CL-001 a CL-012 + total: 53 + + story_points_por_vertical: + construccion: 450+ + mecanicas_diesel: 150+ + vidrio_templado: 259 + retail: 353 + clinicas: 451 + total: 1663+ + + specs_por_vertical: + construccion: + aplicables: 27 + implementadas: 0 + mecanicas_diesel: + aplicables: 25 + implementadas: 0 + vidrio_templado: + aplicables: 25 + implementadas: 0 + retail: + aplicables: 26 + implementadas: 0 + clinicas: + aplicables: 22 + implementadas: 0 + total_aplicables: 125 # Con superposición entre verticales + + documentacion: + total_archivos: 1400+ + core: 868 + verticales: 600+ + modulos_definidos: 53 + + database: + tablas_core: 144 + schemas_core: 12 + verticales_con_ddl: 2 + tablas_especificas_total: 63+ # construccion(33) + mecanicas(30+) + tablas_planificadas: 105 # vidrio(25) + retail(35) + clinicas(45) + + backend: + core_implementado: 0% + construccion_implementado: 15% + entities_totales: 12 + services_totales: 2 + controllers_totales: 2 + + frontend: + core_implementado: 0% + construccion_implementado: 2% + + cobertura: + gap_analysis_core: "100%" + story_points_cubiertos: 1663+ + specs_transversales: 30 + specs_propagadas: 125 + workflows: 3 + epicas_completas: 30 # VT(8) + RT(10) + CL(12) + +# ============================================================================ +# PROPAGACION SIMCO +# ============================================================================ +propagacion: + sistema: SIMCO v2.2.0 + niveles: + - nivel: 2B + nombre: Suite Master + ubicacion: orchestration/inventarios/ + archivos: [SUITE_MASTER_INVENTORY.yml, STATUS.yml, REFERENCIAS.yml] + + - nivel: 2B.1 + nombre: ERP Core + ubicacion: apps/erp-core/orchestration/inventarios/ + archivos: 6 # Inventarios estándar + + - nivel: 2B.2 + nombre: Verticales + ubicacion: apps/verticales/*/orchestration/inventarios/ + archivos: 6 # Inventarios estándar por vertical + verticales: 5 + + herencia: + direccion: "Core -> Verticales" + documento_base: "HERENCIA-ERP-CORE.md" + specs_heredables: 30 + propagacion_completada: true + fecha_propagacion: 2025-12-08 + + validacion: + inventarios_completos: true + directivas_propagadas: true + herencia_documentada: true + status_sincronizado: true + +# ============================================================================ +# PROXIMAS ACCIONES SUITE +# ============================================================================ +proximas_acciones: + prioridad_1: + descripcion: "Completar backend construcción" + modulos: [MAI-001, MAI-002, MAI-003] + porcentaje_actual: 15% + porcentaje_objetivo: 50% + + prioridad_2: + descripcion: "Cargar DDL mecanicas-diesel" + prerequisito: "Validar DDL contra core" + estado: PENDIENTE + + prioridad_3: + descripcion: "Iniciar DDL para verticales restantes" + verticales: [vidrio-templado, retail, clinicas] + +# ============================================================================ +# REFERENCIAS CRUZADAS +# ============================================================================ +referencias: + status_global: orchestration/inventarios/STATUS.yml + referencias_herencia: orchestration/inventarios/REFERENCIAS.yml + core_master: apps/erp-core/orchestration/inventarios/MASTER_INVENTORY.yml + core_database: apps/erp-core/database/README.md + guidelines: orchestration/00-guidelines/ diff --git a/orchestration/prompts/PROMPT-BACKEND-AGENT.md b/orchestration/prompts/PROMPT-BACKEND-AGENT.md new file mode 100644 index 0000000..5068948 --- /dev/null +++ b/orchestration/prompts/PROMPT-BACKEND-AGENT.md @@ -0,0 +1,133 @@ +# PROMPT BACKEND-AGENT - EXTENSIÓN ERP-SUITE + +**Versión:** 1.0.0 +**Fecha:** 2025-12-05 +**Tipo:** Extensión de prompt global +**Proyecto:** ERP Suite - Sistema ERP Multi-Vertical + +--- + +## HERENCIA + +```yaml +EXTIENDE: core/orchestration/agents/PROMPT-BACKEND-AGENT.md +CONTEXTO: orchestration/00-guidelines/CONTEXTO-PROYECTO.md +``` + +**IMPORTANTE:** Este archivo NO duplica el prompt global. Solo contiene: +1. Resolución de variables para ERP-Suite +2. Extensiones específicas del proyecto (si las hay) + +--- + +## RESOLUCIÓN DE VARIABLES PARA ERP-SUITE + +Al leer el prompt global, resolver estos placeholders: + +```yaml +{PROJECT_NAME}: ERP-Suite +{BACKEND_ROOT}: apps/erp-core/backend +{BACKEND_SRC}: apps/erp-core/backend/src +{BACKEND_TESTS}: apps/erp-core/backend/tests +{DB_NAME}: erp_platform +{AUTH_SCHEMA}: auth_management +{FRONTEND_ROOT}: apps/erp-core/frontend +{DB_DDL_PATH}: apps/erp-core/database/ddl +``` + +--- + +## ARQUITECTURA MULTI-VERTICAL + +### Backend Core (Express.js) +| Módulo | Propósito | +|--------|-----------| +| `auth` | Autenticación JWT | +| `users` | Gestión de usuarios | +| `catalogs` | Catálogos compartidos | +| `audit` | Auditoría | + +### Backend Vertical Construcción +| Módulo | Path | Propósito | +|--------|------|-----------| +| `projects` | `apps/verticales/construccion/backend/` | Proyectos y desarrollos | +| `financial` | `apps/verticales/construccion/backend/` | Presupuestos | +| `purchasing` | `apps/verticales/construccion/backend/` | Compras | +| `quality` | `apps/verticales/construccion/backend/` | Inspecciones | + +--- + +## RUTAS DE TRABAJO + +### Core +```bash +apps/erp-core/backend/src/modules/{modulo}/ +apps/erp-core/backend/src/shared/ +``` + +### Vertical Construcción +```bash +apps/verticales/construccion/backend/src/modules/{modulo}/ +``` + +--- + +## EXTENSIONES ESPECÍFICAS + +### Stack Express.js (no NestJS) + +ERP-Suite usa **Express.js** en lugar de NestJS: + +```typescript +// Estructura típica de módulo +src/modules/{modulo}/ +├── {modulo}.routes.ts // Router Express +├── {modulo}.controller.ts // Handler de requests +├── {modulo}.service.ts // Lógica de negocio +├── {modulo}.entity.ts // TypeORM Entity +└── dto/ + ├── create-{modulo}.dto.ts + └── update-{modulo}.dto.ts +``` + +### Multi-tenant Middleware + +```typescript +// Middleware de tenant +export const tenantMiddleware = (req, res, next) => { + const constructoraId = req.user?.constructoraId; + if (constructoraId) { + // Set PostgreSQL context + await pool.query(`SET app.current_constructora_id = $1`, [constructoraId]); + } + next(); +}; +``` + +### Validación con Zod + +```typescript +// ERP-Suite usa Zod para validación +import { z } from 'zod'; + +export const CreateProjectSchema = z.object({ + code: z.string().min(1).max(50), + name: z.string().min(1).max(200), + // ... +}); +``` + +--- + +## FLUJO DE INICIO + +Cuando el usuario diga "lee el prompt de Backend Agent para ERP-Suite": + +1. **Leer prompt global:** `core/orchestration/agents/PROMPT-BACKEND-AGENT.md` +2. **Leer este archivo:** Para resolver variables y ver extensiones +3. **Leer contexto:** `orchestration/00-guidelines/CONTEXTO-PROYECTO.md` +4. **Listo para recibir tarea** + +--- + +**Nota:** Cualquier mejora a las directivas generales se hace en `core/orchestration/agents/PROMPT-BACKEND-AGENT.md` y se refleja automáticamente en todos los proyectos. diff --git a/orchestration/prompts/PROMPT-DATABASE-AGENT.md b/orchestration/prompts/PROMPT-DATABASE-AGENT.md new file mode 100644 index 0000000..57bdf9e --- /dev/null +++ b/orchestration/prompts/PROMPT-DATABASE-AGENT.md @@ -0,0 +1,123 @@ +# PROMPT DATABASE-AGENT - EXTENSIÓN ERP-SUITE + +**Versión:** 1.0.0 +**Fecha:** 2025-12-05 +**Tipo:** Extensión de prompt global +**Proyecto:** ERP Suite - Sistema ERP Multi-Vertical + +--- + +## HERENCIA + +```yaml +EXTIENDE: core/orchestration/agents/PROMPT-DATABASE-AGENT.md +CONTEXTO: orchestration/00-guidelines/CONTEXTO-PROYECTO.md +``` + +**IMPORTANTE:** Este archivo NO duplica el prompt global. Solo contiene: +1. Resolución de variables para ERP-Suite +2. Extensiones específicas del proyecto (si las hay) + +--- + +## RESOLUCIÓN DE VARIABLES PARA ERP-SUITE + +Al leer el prompt global, resolver estos placeholders: + +```yaml +{PROJECT_NAME}: ERP-Suite +{DB_NAME}: erp_platform +{DB_DDL_PATH}: apps/erp-core/database/ddl +{DB_SCRIPTS_PATH}: apps/erp-core/database +{DB_SEEDS_PATH}: apps/erp-core/database/seeds +{RECREATE_CMD}: drop-and-recreate-database.sh +{AUTH_SCHEMA}: auth_management +``` + +--- + +## ARQUITECTURA MULTI-VERTICAL + +ERP-Suite tiene una arquitectura de herencia: + +``` +erp-core (60-70% código base) + │ + ├── verticales/construccion (35% avanzado) + ├── verticales/vidrio-templado (0%) + ├── verticales/mecanicas-diesel (0%) + ├── verticales/retail (0%) + └── verticales/clinicas (0%) +``` + +### Schemas Core (erp-core) +| Schema | Propósito | +|--------|-----------| +| `auth_management` | Autenticación, usuarios, roles | +| `catalog_management` | Catálogos compartidos | +| `audit_management` | Logs de auditoría | + +### Schemas Vertical Construcción +| Schema | Propósito | +|--------|-----------| +| `project_management` | Proyectos, desarrollos, fases | +| `financial_management` | Presupuestos, estimaciones | +| `purchasing_management` | Compras, proveedores | +| `construction_management` | Avances, recursos | +| `quality_management` | Inspecciones, calidad | +| `infonavit_management` | Integración INFONAVIT | + +--- + +## RUTAS DE TRABAJO + +### Core +```bash +apps/erp-core/database/ddl/schemas/{schema}/tables/*.sql +apps/erp-core/database/seeds/dev/{schema}/*.sql +``` + +### Vertical Construcción +```bash +apps/verticales/construccion/database/ddl/schemas/{schema}/tables/*.sql +apps/verticales/construccion/database/seeds/dev/{schema}/*.sql +``` + +--- + +## EXTENSIONES ESPECÍFICAS + +### Multi-tenant con RLS + +ERP-Suite usa Row Level Security basado en `constructora_id`: + +```sql +-- Contexto de sesión +SET app.current_constructora_id = '{uuid}'; + +-- Policy RLS típica +CREATE POLICY tenant_isolation ON {schema}.{tabla} + USING (constructora_id = current_setting('app.current_constructora_id')::uuid); +``` + +### Documentación de Referencia + +Antes de crear schemas para vertical construcción, consultar: +``` +docs/verticales/construccion/02-modelado/database-design/schemas/ +``` + +--- + +## FLUJO DE INICIO + +Cuando el usuario diga "lee el prompt de Database Agent para ERP-Suite": + +1. **Leer prompt global:** `core/orchestration/agents/PROMPT-DATABASE-AGENT.md` +2. **Leer este archivo:** Para resolver variables y ver extensiones +3. **Leer contexto:** `orchestration/00-guidelines/CONTEXTO-PROYECTO.md` +4. **Listo para recibir tarea** + +--- + +**Nota:** Cualquier mejora a las directivas generales se hace en `core/orchestration/agents/PROMPT-DATABASE-AGENT.md` y se refleja automáticamente en todos los proyectos. diff --git a/orchestration/prompts/PROMPT-FRONTEND-AGENT.md b/orchestration/prompts/PROMPT-FRONTEND-AGENT.md new file mode 100644 index 0000000..8a11119 --- /dev/null +++ b/orchestration/prompts/PROMPT-FRONTEND-AGENT.md @@ -0,0 +1,134 @@ +# PROMPT FRONTEND-AGENT - EXTENSIÓN ERP-SUITE + +**Versión:** 1.0.0 +**Fecha:** 2025-12-05 +**Tipo:** Extensión de prompt global +**Proyecto:** ERP Suite - Sistema ERP Multi-Vertical + +--- + +## HERENCIA + +```yaml +EXTIENDE: core/orchestration/agents/PROMPT-FRONTEND-AGENT.md +CONTEXTO: orchestration/00-guidelines/CONTEXTO-PROYECTO.md +``` + +**IMPORTANTE:** Este archivo NO duplica el prompt global. Solo contiene: +1. Resolución de variables para ERP-Suite +2. Extensiones específicas del proyecto (si las hay) + +--- + +## RESOLUCIÓN DE VARIABLES PARA ERP-SUITE + +Al leer el prompt global, resolver estos placeholders: + +```yaml +{PROJECT_NAME}: ERP-Suite +{FRONTEND_ROOT}: apps/erp-core/frontend +{FRONTEND_SRC}: apps/erp-core/frontend/src +{FRONTEND_TESTS}: apps/erp-core/frontend/tests +{BACKEND_ROOT}: apps/erp-core/backend +{API_URL}: http://localhost:3000/api +``` + +--- + +## ARQUITECTURA MULTI-VERTICAL + +### Frontend Core (React + Vite) +```bash +apps/erp-core/frontend/src/ +├── shared/ # Componentes compartidos +├── modules/ # Módulos core +│ ├── auth/ +│ ├── users/ +│ └── catalogs/ +└── layouts/ # Layouts compartidos +``` + +### Frontend Vertical Construcción +```bash +apps/verticales/construccion/frontend/src/ +├── modules/ +│ ├── projects/ # Proyectos +│ ├── financial/ # Presupuestos +│ ├── purchasing/ # Compras +│ └── quality/ # Inspecciones +└── components/ # Componentes específicos +``` + +--- + +## RUTAS DE TRABAJO + +### Core +```bash +apps/erp-core/frontend/src/shared/components/ +apps/erp-core/frontend/src/shared/types/ +apps/erp-core/frontend/src/shared/stores/ +apps/erp-core/frontend/src/modules/{modulo}/ +``` + +### Vertical Construcción +```bash +apps/verticales/construccion/frontend/src/modules/{modulo}/ +apps/verticales/construccion/frontend/src/components/ +``` + +--- + +## EXTENSIONES ESPECÍFICAS + +### Stack Frontend + +ERP-Suite usa: +- React 18 + Vite +- TypeScript +- Zustand (state) +- Tailwind CSS +- Zod (validación) + +### Componentes Multi-tenant + +```typescript +// Context de tenant +const { constructoraId } = useTenantContext(); + +// Queries con tenant +const { data } = useQuery({ + queryKey: ['projects', constructoraId], + queryFn: () => projectsApi.list(constructoraId) +}); +``` + +### Estructura de Módulos + +```typescript +// Cada módulo tiene: +modules/{modulo}/ +├── pages/ +│ ├── {Modulo}ListPage.tsx +│ ├── {Modulo}DetailPage.tsx +│ └── {Modulo}FormPage.tsx +├── components/ +├── hooks/ +├── services/ +└── types/ +``` + +--- + +## FLUJO DE INICIO + +Cuando el usuario diga "lee el prompt de Frontend Agent para ERP-Suite": + +1. **Leer prompt global:** `core/orchestration/agents/PROMPT-FRONTEND-AGENT.md` +2. **Leer este archivo:** Para resolver variables y ver extensiones +3. **Leer contexto:** `orchestration/00-guidelines/CONTEXTO-PROYECTO.md` +4. **Listo para recibir tarea** + +--- + +**Nota:** Cualquier mejora a las directivas generales se hace en `core/orchestration/agents/PROMPT-FRONTEND-AGENT.md` y se refleja automáticamente en todos los proyectos. diff --git a/orchestration/trazas/TRAZA-SUITE.md b/orchestration/trazas/TRAZA-SUITE.md new file mode 100644 index 0000000..964c0ef --- /dev/null +++ b/orchestration/trazas/TRAZA-SUITE.md @@ -0,0 +1,322 @@ +# Traza de Suite - ERP Suite + +**Nivel:** 2B - Suite Multi-Vertical +**Ultima actualizacion:** 2025-12-08 + +--- + +## Historial de Actividades + +### 2025-12-08 - Limpieza y Auditoría del Workspace + +#### Acción de Mantenimiento (Nivel 0 → 2B) + +**Origen:** +- **Nivel:** 0 (Workspace Root) +- **Agente:** Claude Code + +**Cambio:** +- **Tipo:** LIMPIEZA Y AUDITORIA +- **Descripción:** Eliminación de carpeta legacy-reference deprecada y validación de estructura + +**Artefactos Eliminados:** +- `orchestration/legacy-reference/` (~816 KB) + - Contenía: directivas, prompts, templates, agentes, inventarios, trazas, estados, scripts duplicados + - Motivo: Todo el contenido existe en `core/orchestration/` (fuente única de verdad) + +**Validaciones Realizadas:** +- ✅ Estructura orchestration completa +- ✅ Inventarios (SUITE_MASTER_INVENTORY, STATUS, REFERENCIAS) +- ✅ Trazas activas +- ✅ CONTEXTO-PROYECTO.md presente +- ✅ PROXIMA-ACCION.md presente + +**Impacto:** +- Sin pérdida de información (contenido duplicado de core) +- Reducción de confusión para agentes +- Espacio liberado: ~816 KB + +--- + +### 2025-12-08 - DDL Inventory Extensions IMPLEMENTADO + +#### Implementación DDL desde ERP Core (Nivel 2B.1) + +**Origen:** +- **Nivel:** 2B.1 (Suite Core) +- **Ruta:** `apps/erp-core/database/ddl/` +- **Proyecto:** erp-core + +**Cambio:** +- **Tipo:** IMPLEMENTACION DDL +- **Descripcion:** Implementación de 05-inventory-extensions.sql con soporte para Valoración SVL, Lotes/Series, Conteos Cíclicos +- **Agente:** Database-Agent + +**Artefactos Creados:** + +1. **DDL Inventory Extensions (1 archivo)** + - Ubicación: `apps/erp-core/database/ddl/05-inventory-extensions.sql` + - Tablas nuevas: 10 + - Funciones nuevas: 7 + - Vistas nuevas: 3 (1 materializada) + - Columnas extendidas: 30+ + +**Tablas Implementadas:** +```yaml +valoracion_svl: + - inventory.stock_valuation_layers + - inventory.category_stock_accounts + - inventory.valuation_settings + +lotes_series: + - inventory.lots + - inventory.move_line_consume_rel + - inventory.removal_strategies + +conteos_ciclicos: + - inventory.inventory_count_sessions + - inventory.inventory_count_lines + - inventory.abc_classification_rules + - inventory.product_abc_classification +``` + +**Specs Cubiertas:** +- SPEC-VALORACION-INVENTARIO.md +- SPEC-TRAZABILIDAD-LOTES-SERIES.md +- SPEC-INVENTARIOS-CICLICOS.md + +**Impacto:** +- **Dependencias afectadas:** Backend services (InventoryService, ValuationService, CycleCountService) +- **Verticales beneficiadas:** construccion, vidrio-templado, mecanicas-diesel, retail (por herencia) + +--- + +### 2025-12-08 - DDL Auth Extensions IMPLEMENTADO + +#### Implementación DDL desde ERP Core (Nivel 2B.1) + +**Origen:** +- **Nivel:** 2B.1 (Suite Core) +- **Ruta:** `apps/erp-core/database/ddl/` +- **Proyecto:** erp-core + +**Cambio:** +- **Tipo:** IMPLEMENTACION DDL +- **Descripcion:** Implementación de 01-auth-extensions.sql con soporte para 2FA, API Keys, OAuth2, ACL +- **Agente:** Database-Agent + +**Artefactos Creados:** + +1. **DDL Auth Extensions (1 archivo)** + - Ubicación: `apps/erp-core/database/ddl/01-auth-extensions.sql` + - Tablas nuevas: 16 + - Funciones nuevas: 6 + - Vistas nuevas: 2 + - Columnas extendidas en auth.users: 9 + +**Tablas Implementadas:** +```yaml +groups_y_herencia: + - auth.groups + - auth.group_implied + - auth.user_groups + +acl_model_access: + - auth.models + - auth.model_access + - auth.record_rules + - auth.rule_groups + - auth.model_fields + - auth.field_permissions + +api_keys: + - auth.api_keys + +two_factor_auth: + - auth.trusted_devices + - auth.verification_codes + - auth.mfa_audit_log + +oauth2: + - auth.oauth_providers + - auth.oauth_user_links + - auth.oauth_states +``` + +**Specs Cubiertas:** +- SPEC-TWO-FACTOR-AUTHENTICATION.md +- SPEC-SEGURIDAD-API-KEYS-PERMISOS.md +- SPEC-OAUTH2-SOCIAL-LOGIN.md + +**Impacto:** +- **Dependencias afectadas:** Backend services (AuthService, OAuth2Service, MFAService) +- **Requiere acción en otros niveles:** SI - Implementar servicios backend correspondientes + +--- + +### 2025-12-08 - Gap Analysis ERP Core COMPLETADO + +#### Propagacion desde ERP Core (Nivel 2B.1) + +**Origen:** +- **Nivel:** 2B.1 (Suite Core) +- **Ruta:** `apps/erp-core/` +- **Proyecto:** erp-core + +**Cambio:** +- **Tipo:** CREACION MASIVA +- **Descripcion:** Gap Analysis vs Odoo 18 completado al 100% +- **Agente:** Requirements-Analyst + +**Artefactos Creados:** + +1. **Especificaciones Transversales (30 documentos)** + - Ubicacion: `apps/erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/` + - Gaps P0 funcionales: 10 specs + - Gaps P1: 18 specs + - Patrones tecnicos: 2 specs + - Total SP cubiertos: 394 + +2. **Workflows (3 documentos)** + - Ubicacion: `apps/erp-core/docs/04-modelado/workflows/` + - WORKFLOW-CIERRE-PERIODO-CONTABLE.md + - WORKFLOW-3-WAY-MATCH.md + - WORKFLOW-PAGOS-ANTICIPADOS.md + +3. **Analisis Actualizados** + - ANALISIS-GAPS-CONSOLIDADO.md v10.0 + - ANALISIS-PROPAGACION-ALINEAMIENTO.md v1.0 + +**Metricas:** +```yaml +gaps_p0_documentados: 18/18 (100%) +gaps_p1_documentados: 22/22 (100%) +patrones_tecnicos: 2/2 (100%) +cobertura_total: 100% +``` + +**Impacto:** +- **Dependencias afectadas:** Todas las verticales (construccion, vidrio-templado, mecanicas-diesel, retail, clinicas) +- **Requiere accion en otros niveles:** SI - Documentar herencia en verticales + +**Referencias:** +- Inventario local: `apps/erp-core/orchestration/inventarios/MASTER_INVENTORY.yml` +- Traza local: `apps/erp-core/orchestration/01-analisis/ANALISIS-GAPS-CONSOLIDADO.md` + +--- + +### 2025-12-08 - Herencia de Specs Documentada en Verticales + +#### Propagacion a Verticales (Nivel 2B.2) + +**Origen:** +- **Nivel:** 2B.1 (Suite Core) +- **Specs:** 30 especificaciones transversales + +**Cambio:** +- **Tipo:** DOCUMENTACION DE HERENCIA +- **Descripcion:** Creacion de HERENCIA-SPECS-ERP-CORE.md en cada vertical +- **Agente:** Requirements-Analyst + +**Artefactos Creados:** + +| Vertical | Archivo | Specs Heredadas | +|----------|---------|-----------------| +| construccion | HERENCIA-SPECS-ERP-CORE.md | 6 specs | +| vidrio-templado | HERENCIA-SPECS-ERP-CORE.md | 3 specs | +| mecanicas-diesel | HERENCIA-SPECS-ERP-CORE.md | 3 specs | +| retail | HERENCIA-SPECS-ERP-CORE.md | 3 specs | +| clinicas | HERENCIA-SPECS-ERP-CORE.md | 3 specs | + +**Detalle por Vertical:** + +1. **Construccion (6 specs)** + - SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN.md + - SPEC-MAIL-THREAD-TRACKING.md + - SPEC-WIZARD-TRANSIENT-MODEL.md + - SPEC-VALORACION-INVENTARIO.md + - SPEC-TRAZABILIDAD-LOTES-SERIES.md + - SPEC-TAREAS-RECURRENTES.md + +2. **Vidrio Templado (3 specs)** + - SPEC-VALORACION-INVENTARIO.md + - SPEC-TRAZABILIDAD-LOTES-SERIES.md + - SPEC-INVENTARIOS-CICLICOS.md + +3. **Mecanicas Diesel (3 specs)** + - SPEC-VALORACION-INVENTARIO.md + - SPEC-TRAZABILIDAD-LOTES-SERIES.md + - SPEC-INVENTARIOS-CICLICOS.md + +4. **Retail (3 specs)** + - SPEC-PRICING-RULES.md + - SPEC-INVENTARIOS-CICLICOS.md + - SPEC-TRAZABILIDAD-LOTES-SERIES.md + +5. **Clinicas (3 specs)** + - SPEC-RRHH-EVALUACIONES-SKILLS.md + - SPEC-INTEGRACION-CALENDAR.md + - SPEC-MAIL-THREAD-TRACKING.md + +**Impacto:** +- Las verticales ahora tienen documentada su dependencia del core +- Cada vertical sabe que specs debe implementar/adaptar +- La trazabilidad de herencia esta completa + +--- + +### 2025-12-08 - Estructura Propagacion Suite Creada + +**Origen:** +- **Nivel:** 2B (Suite) +- **Ruta:** `orchestration/` + +**Cambio:** +- **Tipo:** CREACION +- **Descripcion:** Creacion de estructura de propagacion segun SIMCO +- **Agente:** Requirements-Analyst + +**Artefactos Creados:** +- `orchestration/inventarios/SUITE_MASTER_INVENTORY.yml` +- `orchestration/inventarios/STATUS.yml` +- `orchestration/inventarios/REFERENCIAS.yml` +- `orchestration/trazas/TRAZA-SUITE.md` (este archivo) + +--- + +### 2025-12-05 - Migracion Inicial + +**Origen:** +- **Nivel:** Externo +- **Ruta:** workspace-erp-inmobiliaria + +**Cambio:** +- **Tipo:** MIGRACION +- **Descripcion:** Migracion de estructura desde workspace anterior + +**Artefactos:** +- erp-core (backend, frontend, database) +- verticales/construccion (403 archivos de documentacion) +- Estructura base de verticales menores + +--- + +## Proximas Propagaciones Esperadas + +| Origen | Tipo | Descripcion | Estado | +|--------|------|-------------|--------| +| erp-core | Implementacion | Modulos P0 (Auth, Users, Roles, Tenants) | PENDIENTE | +| construccion | Documentacion | Herencia de specs del core | PENDIENTE | +| verticales | Estructura | Verificacion de orchestration | PENDIENTE | + +--- + +## Alertas + +- [x] Verticales menores requieren verificacion de estructura ✅ (2025-12-08) +- [x] Documentar herencia de specs en cada vertical ✅ (2025-12-08) +- [x] Sistema legacy en `orchestration/legacy-reference/` **ELIMINADO** ✅ (2025-12-08) + +--- + +*Este archivo registra propagaciones de niveles inferiores (2B.1, 2B.2) hacia el nivel Suite (2B)* diff --git a/package.json b/package.json new file mode 100644 index 0000000..62e9603 --- /dev/null +++ b/package.json @@ -0,0 +1,19 @@ +{ + "name": "@isem-digital/erp-suite", + "version": "1.0.0", + "description": "ISEM Digital ERP Suite - Multi-tenant ERP Platform", + "private": true, + "scripts": { + "prepare": "husky install" + }, + "devDependencies": { + "@commitlint/cli": "^18.4.3", + "@commitlint/config-conventional": "^18.4.3", + "husky": "^8.0.3", + "lint-staged": "^15.2.0" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=9.0.0" + } +} diff --git a/scripts/deploy.sh b/scripts/deploy.sh new file mode 100755 index 0000000..35732e7 --- /dev/null +++ b/scripts/deploy.sh @@ -0,0 +1,220 @@ +#!/bin/bash +# ============================================================================= +# ERP-SUITE - Script de Despliegue Multi-Vertical +# ============================================================================= +# Uso: +# ./scripts/deploy.sh [vertical|all] [staging|production] +# ./scripts/deploy.sh erp-core production +# ./scripts/deploy.sh construccion staging +# ./scripts/deploy.sh all production +# ============================================================================= + +set -e + +# Colors +RED='\033[0;31m' +GREEN='\033[0;32m' +YELLOW='\033[1;33m' +BLUE='\033[0;34m' +NC='\033[0m' + +log_info() { echo -e "${GREEN}[INFO]${NC} $1"; } +log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; } +log_error() { echo -e "${RED}[ERROR]${NC} $1"; exit 1; } +log_step() { echo -e "${BLUE}[STEP]${NC} $1"; } + +# ============================================================================= +# CONFIGURACIÓN +# ============================================================================= +DOCKER_REGISTRY="${DOCKER_REGISTRY:-72.60.226.4:5000}" +DEPLOY_SERVER="${DEPLOY_SERVER:-72.60.226.4}" +DEPLOY_USER="${DEPLOY_USER:-deploy}" +DEPLOY_PATH="/opt/apps/erp-suite" +VERSION="${VERSION:-$(date +%Y%m%d%H%M%S)}" + +# Verticales disponibles +declare -A VERTICALS=( + ["erp-core"]="apps/erp-core:3010:3011" + ["construccion"]="apps/verticales/construccion:3020:3021" + ["vidrio-templado"]="apps/verticales/vidrio-templado:3030:3031" + ["mecanicas-diesel"]="apps/verticales/mecanicas-diesel:3040:3041" + ["retail"]="apps/verticales/retail:3050:3051" + ["clinicas"]="apps/verticales/clinicas:3060:3061" + ["pos-micro"]="apps/products/pos-micro:3070:3071" +) + +# Verticales activas (con código) +ACTIVE_VERTICALS=("erp-core" "construccion" "mecanicas-diesel") + +# ============================================================================= +# FUNCIONES +# ============================================================================= + +show_usage() { + echo "Uso: $0 [vertical|all] [staging|production]" + echo "" + echo "Verticales disponibles:" + for v in "${!VERTICALS[@]}"; do + if [[ " ${ACTIVE_VERTICALS[@]} " =~ " ${v} " ]]; then + echo " - ${v} (activo)" + else + echo " - ${v} (reservado)" + fi + done + echo " - all (todas las activas)" + echo "" + echo "Ejemplos:" + echo " $0 erp-core production" + echo " $0 construccion staging" + echo " $0 all production" +} + +get_vertical_config() { + local vertical=$1 + echo "${VERTICALS[$vertical]}" +} + +build_vertical() { + local vertical=$1 + local config=$(get_vertical_config "$vertical") + local path=$(echo "$config" | cut -d: -f1) + + log_step "Building ${vertical}..." + + # Build backend + if [ -d "${path}/backend" ]; then + log_info "Building backend..." + docker build -t ${DOCKER_REGISTRY}/erp-${vertical}-backend:${VERSION} \ + -t ${DOCKER_REGISTRY}/erp-${vertical}-backend:latest \ + ${path}/backend/ + fi + + # Build frontend + local frontend_path="${path}/frontend" + if [ -d "${path}/frontend/web" ]; then + frontend_path="${path}/frontend/web" + fi + + if [ -d "${frontend_path}" ] && [ -f "${frontend_path}/Dockerfile" ]; then + log_info "Building frontend..." + docker build -t ${DOCKER_REGISTRY}/erp-${vertical}-frontend:${VERSION} \ + -t ${DOCKER_REGISTRY}/erp-${vertical}-frontend:latest \ + ${frontend_path}/ + fi +} + +push_vertical() { + local vertical=$1 + + log_step "Pushing ${vertical} images..." + + docker push ${DOCKER_REGISTRY}/erp-${vertical}-backend:${VERSION} 2>/dev/null || true + docker push ${DOCKER_REGISTRY}/erp-${vertical}-backend:latest 2>/dev/null || true + docker push ${DOCKER_REGISTRY}/erp-${vertical}-frontend:${VERSION} 2>/dev/null || true + docker push ${DOCKER_REGISTRY}/erp-${vertical}-frontend:latest 2>/dev/null || true +} + +deploy_vertical() { + local vertical=$1 + local env=$2 + + log_step "Deploying ${vertical} to ${env}..." + + ssh -o StrictHostKeyChecking=no ${DEPLOY_USER}@${DEPLOY_SERVER} << EOF + set -e + cd ${DEPLOY_PATH}/${vertical} + + echo "📦 Pulling images..." + docker-compose -f docker-compose.prod.yml pull || true + + echo "🔄 Stopping containers..." + docker-compose -f docker-compose.prod.yml down --remove-orphans || true + + echo "🚀 Starting containers..." + docker-compose -f docker-compose.prod.yml up -d + + echo "🧹 Cleanup..." + docker system prune -f + + echo "✅ ${vertical} deployed!" +EOF +} + +health_check() { + local vertical=$1 + local config=$(get_vertical_config "$vertical") + local backend_port=$(echo "$config" | cut -d: -f3) + + log_info "Health check for ${vertical} (port ${backend_port})..." + + for i in {1..5}; do + if curl -sf "http://${DEPLOY_SERVER}:${backend_port}/health" > /dev/null; then + log_info "✅ ${vertical} is healthy" + return 0 + fi + log_warn "Attempt ${i}/5 failed, waiting..." + sleep 10 + done + + log_error "${vertical} health check failed!" +} + +# ============================================================================= +# MAIN +# ============================================================================= + +main() { + local vertical=${1:-help} + local env=${2:-staging} + + if [ "$vertical" == "help" ] || [ "$vertical" == "-h" ]; then + show_usage + exit 0 + fi + + echo "=============================================================================" + echo "ERP-SUITE - Deployment Script" + echo "=============================================================================" + echo "Vertical: ${vertical}" + echo "Environment: ${env}" + echo "Version: ${VERSION}" + echo "=============================================================================" + + # Determinar verticales a desplegar + local verticals_to_deploy=() + + if [ "$vertical" == "all" ]; then + verticals_to_deploy=("${ACTIVE_VERTICALS[@]}") + else + if [ -z "${VERTICALS[$vertical]}" ]; then + log_error "Vertical '${vertical}' no existe" + fi + verticals_to_deploy=("$vertical") + fi + + # Desplegar erp-core primero si está en la lista + if [[ " ${verticals_to_deploy[@]} " =~ " erp-core " ]]; then + build_vertical "erp-core" + push_vertical "erp-core" + deploy_vertical "erp-core" "$env" + health_check "erp-core" + + # Remover erp-core de la lista + verticals_to_deploy=(${verticals_to_deploy[@]/erp-core}) + fi + + # Desplegar resto de verticales + for v in "${verticals_to_deploy[@]}"; do + build_vertical "$v" + push_vertical "$v" + deploy_vertical "$v" "$env" + health_check "$v" + done + + echo "" + echo "=============================================================================" + echo -e "${GREEN}DESPLIEGUE COMPLETADO${NC}" + echo "=============================================================================" +} + +main "$@" diff --git a/scripts/deploy/Jenkinsfile.backend.example b/scripts/deploy/Jenkinsfile.backend.example new file mode 100644 index 0000000..63108d0 --- /dev/null +++ b/scripts/deploy/Jenkinsfile.backend.example @@ -0,0 +1,136 @@ +// ============================================================================= +// Jenkinsfile - Backend API +// ERP Suite - Node.js + Express + TypeScript +// ============================================================================= + +pipeline { + agent any + + environment { + // Configuración del proyecto + PROJECT_NAME = 'erp-construccion-backend' + DOCKER_REGISTRY = 'registry.isem.digital' + DOCKER_IMAGE = "${DOCKER_REGISTRY}/${PROJECT_NAME}" + DOCKER_TAG = "${BUILD_NUMBER}" + + // Configuración de Kubernetes + K8S_NAMESPACE = 'erp-production' + K8S_DEPLOYMENT = "${PROJECT_NAME}" + + // Node.js + NODE_ENV = 'production' + } + + options { + timeout(time: 30, unit: 'MINUTES') + disableConcurrentBuilds() + buildDiscarder(logRotator(numToKeepStr: '10')) + } + + stages { + stage('Checkout') { + steps { + checkout scm + script { + env.GIT_COMMIT_SHORT = sh( + script: 'git rev-parse --short HEAD', + returnStdout: true + ).trim() + } + } + } + + stage('Install Dependencies') { + steps { + sh 'npm ci --production=false' + } + } + + stage('Lint') { + steps { + sh 'npm run lint' + } + } + + stage('Test') { + steps { + sh 'npm test -- --coverage --ci' + } + post { + always { + junit 'coverage/junit.xml' + publishHTML([ + allowMissing: false, + alwaysLinkToLastBuild: true, + keepAll: true, + reportDir: 'coverage/lcov-report', + reportFiles: 'index.html', + reportName: 'Coverage Report' + ]) + } + } + } + + stage('Build') { + steps { + sh 'npm run build' + } + } + + stage('Docker Build') { + steps { + script { + docker.build("${DOCKER_IMAGE}:${DOCKER_TAG}", "--target production .") + docker.build("${DOCKER_IMAGE}:latest", "--target production .") + } + } + } + + stage('Docker Push') { + steps { + script { + docker.withRegistry("https://${DOCKER_REGISTRY}", 'docker-registry-credentials') { + docker.image("${DOCKER_IMAGE}:${DOCKER_TAG}").push() + docker.image("${DOCKER_IMAGE}:latest").push() + } + } + } + } + + stage('Deploy to Kubernetes') { + when { + branch 'main' + } + steps { + withKubeConfig([credentialsId: 'k8s-credentials', namespace: "${K8S_NAMESPACE}"]) { + sh """ + kubectl set image deployment/${K8S_DEPLOYMENT} \ + ${K8S_DEPLOYMENT}=${DOCKER_IMAGE}:${DOCKER_TAG} \ + -n ${K8S_NAMESPACE} + kubectl rollout status deployment/${K8S_DEPLOYMENT} \ + -n ${K8S_NAMESPACE} \ + --timeout=300s + """ + } + } + } + } + + post { + success { + slackSend( + color: 'good', + message: "✅ Build #${BUILD_NUMBER} successful: ${PROJECT_NAME} deployed to ${K8S_NAMESPACE}" + ) + } + failure { + slackSend( + color: 'danger', + message: "❌ Build #${BUILD_NUMBER} failed: ${PROJECT_NAME}" + ) + } + always { + cleanWs() + } + } +} diff --git a/scripts/deploy/Jenkinsfile.frontend.example b/scripts/deploy/Jenkinsfile.frontend.example new file mode 100644 index 0000000..8942c74 --- /dev/null +++ b/scripts/deploy/Jenkinsfile.frontend.example @@ -0,0 +1,142 @@ +// ============================================================================= +// Jenkinsfile - Frontend Web +// ERP Suite - React + Vite + TypeScript +// ============================================================================= + +pipeline { + agent any + + environment { + // Configuración del proyecto + PROJECT_NAME = 'erp-construccion-frontend-web' + DOCKER_REGISTRY = 'registry.isem.digital' + DOCKER_IMAGE = "${DOCKER_REGISTRY}/${PROJECT_NAME}" + DOCKER_TAG = "${BUILD_NUMBER}" + + // Configuración de Kubernetes + K8S_NAMESPACE = 'erp-production' + K8S_DEPLOYMENT = "${PROJECT_NAME}" + + // Node.js + NODE_ENV = 'production' + } + + options { + timeout(time: 20, unit: 'MINUTES') + disableConcurrentBuilds() + buildDiscarder(logRotator(numToKeepStr: '10')) + } + + stages { + stage('Checkout') { + steps { + checkout scm + } + } + + stage('Install Dependencies') { + steps { + sh 'npm ci' + } + } + + stage('Lint') { + steps { + sh 'npm run lint' + } + } + + stage('Type Check') { + steps { + sh 'npm run type-check' + } + } + + stage('Build') { + steps { + // Inyectar variables de entorno de producción + withCredentials([ + string(credentialsId: 'api-url-production', variable: 'VITE_API_URL') + ]) { + sh 'npm run build' + } + } + } + + stage('Docker Build') { + steps { + script { + docker.build("${DOCKER_IMAGE}:${DOCKER_TAG}", ".") + docker.build("${DOCKER_IMAGE}:latest", ".") + } + } + } + + stage('Docker Push') { + steps { + script { + docker.withRegistry("https://${DOCKER_REGISTRY}", 'docker-registry-credentials') { + docker.image("${DOCKER_IMAGE}:${DOCKER_TAG}").push() + docker.image("${DOCKER_IMAGE}:latest").push() + } + } + } + } + + stage('Deploy to Kubernetes') { + when { + branch 'main' + } + steps { + withKubeConfig([credentialsId: 'k8s-credentials', namespace: "${K8S_NAMESPACE}"]) { + sh """ + kubectl set image deployment/${K8S_DEPLOYMENT} \ + ${K8S_DEPLOYMENT}=${DOCKER_IMAGE}:${DOCKER_TAG} \ + -n ${K8S_NAMESPACE} + kubectl rollout status deployment/${K8S_DEPLOYMENT} \ + -n ${K8S_NAMESPACE} \ + --timeout=180s + """ + } + } + } + + stage('Invalidate CDN Cache') { + when { + branch 'main' + } + steps { + // Ejemplo con CloudFlare + withCredentials([ + string(credentialsId: 'cloudflare-api-token', variable: 'CF_TOKEN'), + string(credentialsId: 'cloudflare-zone-id', variable: 'CF_ZONE') + ]) { + sh """ + curl -X POST "https://api.cloudflare.com/client/v4/zones/${CF_ZONE}/purge_cache" \ + -H "Authorization: Bearer ${CF_TOKEN}" \ + -H "Content-Type: application/json" \ + --data '{"purge_everything":true}' + """ + } + } + } + } + + post { + success { + slackSend( + color: 'good', + message: "✅ Frontend deployed: ${PROJECT_NAME} v${BUILD_NUMBER}" + ) + } + failure { + slackSend( + color: 'danger', + message: "❌ Frontend build failed: ${PROJECT_NAME}" + ) + } + always { + cleanWs() + } + } +} diff --git a/scripts/deploy/README.md b/scripts/deploy/README.md new file mode 100644 index 0000000..470af6f --- /dev/null +++ b/scripts/deploy/README.md @@ -0,0 +1,193 @@ +# Deploy Scripts - ERP Suite + +## Arquitectura de Deploy + +``` +DESARROLLO (Workspace unificado) DEPLOY (Repos independientes) +================================ ============================== + +/home/isem/workspace/ /home/isem/deploy-repos/ +└── projects/erp-suite/ ├── erp-construccion-backend/ + └── apps/verticales/ │ ├── .git/ + └── construccion/ │ ├── Dockerfile + ├── backend/ ───────────────>│ ├── package.json + ├── frontend/ │ └── src/ + │ ├── web/ ───────────────>├── erp-construccion-frontend-web/ + │ └── mobile/ ─────────────>├── erp-construccion-frontend-mobile/ + └── database/ ───────────────>└── erp-construccion-database/ +``` + +## Scripts Disponibles + +### sync-to-deploy-repos.sh + +Sincroniza componentes del workspace a repositorios de deploy independientes. + +```bash +# Uso +./sync-to-deploy-repos.sh [vertical] [componente] + +# Ejemplos +./sync-to-deploy-repos.sh construccion backend # Solo backend +./sync-to-deploy-repos.sh construccion all # Toda la vertical +./sync-to-deploy-repos.sh all all # Todo el proyecto +``` + +## Flujo de Trabajo + +### 1. Desarrollo (Workspace) + +```bash +# Trabajar en el workspace unificado +cd /home/isem/workspace/projects/erp-suite/apps/verticales/construccion/backend +npm run dev + +# Hacer commits al workspace +cd /home/isem/workspace +git add . +git commit -m "feat: nueva funcionalidad" +git push origin main +``` + +### 2. Sincronización a Deploy Repos + +```bash +# Cuando esté listo para deploy +cd /home/isem/workspace/projects/erp-suite/scripts/deploy +./sync-to-deploy-repos.sh construccion backend +``` + +### 3. Push a Repos de Deploy + +```bash +# Configurar remoto (primera vez) +cd /home/isem/deploy-repos/erp-construccion-backend +git remote add origin git@github.com:isem-digital/erp-construccion-backend.git + +# Push para trigger de Jenkins +git add . +git commit -m "deploy: sync from workspace" +git push origin main +``` + +### 4. Jenkins Pipeline (Automático) + +Jenkins detecta el push y ejecuta: + +```groovy +pipeline { + agent any + + environment { + DOCKER_IMAGE = "erp-construccion-backend" + DOCKER_TAG = "${BUILD_NUMBER}" + } + + stages { + stage('Install') { + steps { + sh 'npm ci' + } + } + + stage('Lint') { + steps { + sh 'npm run lint' + } + } + + stage('Test') { + steps { + sh 'npm test' + } + } + + stage('Build') { + steps { + sh 'npm run build' + } + } + + stage('Docker Build') { + steps { + sh "docker build -t ${DOCKER_IMAGE}:${DOCKER_TAG} ." + } + } + + stage('Docker Push') { + steps { + sh "docker push registry.isem.digital/${DOCKER_IMAGE}:${DOCKER_TAG}" + } + } + + stage('Deploy') { + steps { + sh "kubectl set image deployment/${DOCKER_IMAGE} ${DOCKER_IMAGE}=registry.isem.digital/${DOCKER_IMAGE}:${DOCKER_TAG}" + } + } + } +} +``` + +## Configuración de Repositorios Remotos + +### GitHub/GitLab + +Para cada componente, crear un repositorio: + +| Componente | Repositorio | +|------------|-------------| +| Backend | `erp-construccion-backend` | +| Frontend Web | `erp-construccion-frontend-web` | +| Frontend Mobile | `erp-construccion-frontend-mobile` | +| Database | `erp-construccion-database` | + +### Configurar SSH Keys + +```bash +# Generar clave SSH para deploy +ssh-keygen -t ed25519 -C "deploy@isem.digital" -f ~/.ssh/id_ed25519_deploy + +# Agregar al agente SSH +eval "$(ssh-agent -s)" +ssh-add ~/.ssh/id_ed25519_deploy + +# Copiar clave pública a GitHub/GitLab +cat ~/.ssh/id_ed25519_deploy.pub +``` + +## Estructura de Cada Repo de Deploy + +Cada repositorio de deploy contiene: + +``` +erp-{vertical}-{component}/ +├── .git/ # Git independiente +├── .gitignore # Generado automáticamente +├── Dockerfile # Para containerización +├── package.json # Dependencias +├── package-lock.json # Lock file +├── tsconfig.json # Config TypeScript +├── src/ # Código fuente +└── scripts/ # Scripts de utilidad +``` + +## Exclusiones + +El script de sincronización excluye automáticamente: + +- `node_modules/` - Dependencias (se instalan en CI) +- `dist/` - Build output (se genera en CI) +- `.env` - Variables de entorno locales +- `coverage/` - Reportes de cobertura +- Logs y archivos temporales + +## Notas Importantes + +1. **No editar los repos de deploy directamente** - Siempre trabajar en el workspace +2. **Sincronizar antes de cada deploy** - Asegura que el código está actualizado +3. **Commits separados** - El workspace y los repos de deploy tienen historiales independientes +4. **Variables de entorno** - Cada ambiente tiene su propio `.env` (no sincronizado) + +--- +*Última actualización: 2025-12-12* diff --git a/scripts/deploy/sync-to-deploy-repos.sh b/scripts/deploy/sync-to-deploy-repos.sh new file mode 100755 index 0000000..25fdf12 --- /dev/null +++ b/scripts/deploy/sync-to-deploy-repos.sh @@ -0,0 +1,306 @@ +#!/bin/bash +# ============================================================================= +# sync-to-deploy-repos.sh +# +# Script para sincronizar componentes del workspace a repositorios de deploy +# independientes para CI/CD con Jenkins +# +# Uso: +# ./sync-to-deploy-repos.sh [vertical] [componente] +# ./sync-to-deploy-repos.sh construccion backend +# ./sync-to-deploy-repos.sh construccion all +# ./sync-to-deploy-repos.sh all all +# +# Autor: Architecture-Analyst +# Fecha: 2025-12-12 +# ============================================================================= + +set -e + +# ----------------------------------------------------------------------------- +# CONFIGURACION +# ----------------------------------------------------------------------------- + +WORKSPACE_ROOT="/home/isem/workspace/projects/erp-suite" +DEPLOY_REPOS_ROOT="/home/isem/deploy-repos" + +# Configuración de Gitea (usar token en lugar de password para evitar bloqueos) +GITEA_HOST="72.60.226.4:3000" +GITEA_USER="rckrdmrd" +GITEA_TOKEN="3fb69a2465f4c1d43c856e980236fbc9f79278b1" + +# Verticales disponibles +VERTICALES=("construccion" "mecanicas-diesel" "vidrio-templado" "retail" "clinicas") + +# Proyectos especiales (no en verticales/) +PROYECTOS_ESPECIALES=("erp-core") + +# Componentes por vertical +COMPONENTES=("backend" "frontend-web" "frontend-mobile" "database") + +# Colores para output +RED='\033[0;31m' +GREEN='\033[0;32m' +YELLOW='\033[1;33m' +BLUE='\033[0;34m' +NC='\033[0m' # No Color + +# ----------------------------------------------------------------------------- +# FUNCIONES +# ----------------------------------------------------------------------------- + +log_info() { + echo -e "${BLUE}[INFO]${NC} $1" +} + +log_success() { + echo -e "${GREEN}[OK]${NC} $1" +} + +log_warn() { + echo -e "${YELLOW}[WARN]${NC} $1" +} + +log_error() { + echo -e "${RED}[ERROR]${NC} $1" +} + +# Crear repo de deploy si no existe +ensure_deploy_repo() { + local repo_path="$1" + local repo_name="$2" + + if [ ! -d "$repo_path" ]; then + log_info "Creando repo de deploy: $repo_name" + mkdir -p "$repo_path" + cd "$repo_path" + git init -b main + echo "# $repo_name" > README.md + echo "Repositorio de deploy para CI/CD con Jenkins" >> README.md + git add README.md + git commit -m "Initial commit - Deploy repo for $repo_name" + + # Configurar remoto con token + git remote add origin "http://${GITEA_USER}:${GITEA_TOKEN}@${GITEA_HOST}/${GITEA_USER}/${repo_name}.git" + log_success "Repo creado: $repo_path" + else + # Asegurar que el remoto use token + cd "$repo_path" + git remote set-url origin "http://${GITEA_USER}:${GITEA_TOKEN}@${GITEA_HOST}/${GITEA_USER}/${repo_name}.git" 2>/dev/null || \ + git remote add origin "http://${GITEA_USER}:${GITEA_TOKEN}@${GITEA_HOST}/${GITEA_USER}/${repo_name}.git" 2>/dev/null + fi +} + +# Sincronizar un componente +sync_component() { + local vertical="$1" + local component="$2" + + local source_path="" + # Evitar duplicar prefijo "erp-" si el proyecto ya lo tiene + local repo_name="" + if [[ "$vertical" == erp-* ]]; then + repo_name="${vertical}-${component}" + else + repo_name="erp-${vertical}-${component}" + fi + local repo_path="${DEPLOY_REPOS_ROOT}/${repo_name}" + + # Determinar base path (verticales/ o directamente en apps/) + local base_path="" + if [[ " ${PROYECTOS_ESPECIALES[*]} " =~ " ${vertical} " ]]; then + base_path="${WORKSPACE_ROOT}/apps/${vertical}" + else + base_path="${WORKSPACE_ROOT}/apps/verticales/${vertical}" + fi + + # Determinar ruta fuente según componente + case "$component" in + "backend") + source_path="${base_path}/backend" + ;; + "frontend-web") + # Soportar ambas estructuras: frontend/web/ o frontend/ directo + if [ -d "${base_path}/frontend/web" ]; then + source_path="${base_path}/frontend/web" + elif [ -d "${base_path}/frontend" ] && [ -f "${base_path}/frontend/package.json" ]; then + source_path="${base_path}/frontend" + else + source_path="${base_path}/frontend/web" + fi + ;; + "frontend-mobile") + source_path="${base_path}/frontend/mobile" + ;; + "database") + source_path="${base_path}/database" + ;; + *) + log_error "Componente desconocido: $component" + return 1 + ;; + esac + + # Verificar que existe el source + if [ ! -d "$source_path" ]; then + log_warn "Source no existe: $source_path" + return 0 + fi + + # Crear repo si no existe + ensure_deploy_repo "$repo_path" "$repo_name" + + # Sincronizar usando rsync + log_info "Sincronizando: $source_path -> $repo_path" + + rsync -av --delete \ + --exclude 'node_modules' \ + --exclude 'dist' \ + --exclude '.env' \ + --exclude '.env.local' \ + --exclude '*.log' \ + --exclude '.DS_Store' \ + --exclude 'coverage' \ + --exclude '.nyc_output' \ + "$source_path/" "$repo_path/" + + # Crear .gitignore si no existe + if [ ! -f "$repo_path/.gitignore" ]; then + cat > "$repo_path/.gitignore" << 'EOF' +# Dependencies +node_modules/ + +# Build output +dist/ +build/ + +# Environment files (local) +.env +.env.local +.env.*.local + +# IDE +.idea/ +.vscode/ +*.swp +*.swo + +# Logs +*.log +npm-debug.log* + +# Coverage +coverage/ +.nyc_output/ + +# OS +.DS_Store +Thumbs.db + +# Cache +.cache/ +.parcel-cache/ +EOF + fi + + log_success "Sincronizado: $repo_name" +} + +# Sincronizar todos los componentes de una vertical +sync_vertical() { + local vertical="$1" + + log_info "==========================================" + log_info "Sincronizando vertical: $vertical" + log_info "==========================================" + + for component in "${COMPONENTES[@]}"; do + sync_component "$vertical" "$component" + done +} + +# Mostrar uso +show_usage() { + echo "Uso: $0 [proyecto] [componente]" + echo "" + echo "Proyectos disponibles:" + for v in "${VERTICALES[@]}"; do + echo " - $v" + done + for p in "${PROYECTOS_ESPECIALES[@]}"; do + echo " - $p" + done + echo " - all (todos los proyectos)" + echo "" + echo "Componentes disponibles:" + for c in "${COMPONENTES[@]}"; do + echo " - $c" + done + echo " - all (todos los componentes)" + echo "" + echo "Ejemplos:" + echo " $0 construccion backend # Solo backend de construccion" + echo " $0 construccion all # Todos los componentes de construccion" + echo " $0 erp-core backend # Solo backend de erp-core" + echo " $0 all all # Todo el proyecto" +} + +# ----------------------------------------------------------------------------- +# MAIN +# ----------------------------------------------------------------------------- + +main() { + local vertical="${1:-}" + local component="${2:-}" + + if [ -z "$vertical" ] || [ -z "$component" ]; then + show_usage + exit 1 + fi + + # Crear directorio base de repos si no existe + mkdir -p "$DEPLOY_REPOS_ROOT" + + log_info "Workspace: $WORKSPACE_ROOT" + log_info "Deploy repos: $DEPLOY_REPOS_ROOT" + echo "" + + # Procesar según parámetros + if [ "$vertical" == "all" ]; then + # Procesar verticales + for v in "${VERTICALES[@]}"; do + if [ "$component" == "all" ]; then + sync_vertical "$v" + else + sync_component "$v" "$component" + fi + done + # Procesar proyectos especiales + for p in "${PROYECTOS_ESPECIALES[@]}"; do + if [ "$component" == "all" ]; then + sync_vertical "$p" + else + sync_component "$p" "$component" + fi + done + else + if [ "$component" == "all" ]; then + sync_vertical "$vertical" + else + sync_component "$vertical" "$component" + fi + fi + + echo "" + log_success "==========================================" + log_success "Sincronizacion completada!" + log_success "==========================================" + echo "" + log_info "Repos de deploy en: $DEPLOY_REPOS_ROOT" + log_info "Para hacer push a remoto:" + echo " cd $DEPLOY_REPOS_ROOT/erp-{vertical}-{component}" + echo " git remote add origin git@github.com:isem-digital/erp-{vertical}-{component}.git" + echo " git push -u origin main" +} + +main "$@"