import 'reflect-metadata'; import { NestFactory } from '@nestjs/core'; import { ValidationPipe } from '@nestjs/common'; import { NestExpressApplication } from '@nestjs/platform-express'; import { extname, join } from 'node:path'; import type { Response } from 'express'; import { AppModule } from './app.module'; import { prepareDatabase } from './prisma/bootstrap'; import { PrismaExceptionFilter } from './prisma/prisma-exception.filter'; import { assertSmsConfigured } from './modules/sms/sms.service'; import { envOr, envOrNull } from './common/env'; import { isValidOrigin, parseCorsOrigins, productionConfigProblems } from './common/production-checks'; import { ensureJwtSecrets } from './prisma/boot-secrets'; import { masterOtpCode, masterOtpEnabled } from './modules/customer-auth/customer-auth.service'; // serve-static's bundled `mime` version predates .avif, so it falls back to // application/octet-stream — browsers still render the image (they sniff // content), but a strict client or an under some CSPs would not. const EXTRA_MIME_TYPES: Record = { '.avif': 'image/avif', }; /** * REL-01, REL-03, SEC-04 — every production config problem is printed at once, * then the server starts with a safe fallback for each: random keys kept in * the database (boot-secrets.ts), the fixed test login disabled * (masterOtpCode), and all origins allowed. Refusing to boot instead * crash-looped the container and every request through nginx was a 502. * The rules live in common/production-checks.ts. */ function warnProductionConfig(problems: string[]) { if (!problems.length) return; // eslint-disable-next-line no-console console.warn( '\n' + '='.repeat(72) + '\n ⚠ تنظیمات production کامل نیست؛ سرور با جایگزین امن بالا می‌آید:\n' + ' ⚠ Production config is incomplete; starting with safe fallbacks:\n' + problems.map((p) => ' • ' + p).join('\n') + '\n (see docs/SERVER-SETUP-CHECKLIST.md)\n' + '='.repeat(72) + '\n', ); } /** * SEC-04 — which sites may call the API from a browser. CORS_ORIGINS is a * comma-separated list of exact origins (e.g. https://adm.example.ir,https://app.example.ir). * Invalid entries are dropped; an empty list allows every origin. */ function corsOrigins(): string[] | true { const list = parseCorsOrigins(envOrNull('CORS_ORIGINS') ?? '').filter(isValidOrigin); return list.length ? list : true; } async function bootstrap() { warnProductionConfig(productionConfigProblems(process.env)); // D20 — reports the SMS configuration and never throws. A missing credential // no longer stops the boot; messages are logged instead of sent. assertSmsConfigured(); await prepareDatabase(); await ensureJwtSecrets(); // A missing JWT_CUSTOMER_SECRET is not a cosmetic default: customerJwtSecret() // falls back to JWT_SECRET, so admin and app tokens end up signed with the // SAME key. The `typ` check in JwtStrategy is then the only thing keeping an // app token off the admin routes — one guard instead of two independent ones, // and a sales expert's app token carries their AdminUser id in `sub`. Warn as // loudly as the master-code banner rather than fail the boot, so a running // deployment that has not set it yet still starts. if (!envOrNull('JWT_CUSTOMER_SECRET')) { const sharedWithAdmin = Boolean(envOrNull('JWT_SECRET')); // eslint-disable-next-line no-console console.warn( '\n' + '='.repeat(72) + '\n ⚠ JWT_CUSTOMER_SECRET تنظیم نشده است\n' + ' ⚠ JWT_CUSTOMER_SECRET IS NOT SET.\n' + (sharedWithAdmin ? ' ⚠ Customer/expert app tokens are being signed with JWT_SECRET,\n' + ' ⚠ the SAME key as admin tokens. The two token realms are no\n' + ' ⚠ longer cryptographically separated.\n' : ' ⚠ Neither JWT_SECRET nor JWT_CUSTOMER_SECRET is set, so app\n' + ' ⚠ tokens are signed with a well-known development string.\n') + ' ⚠ Set JWT_CUSTOMER_SECRET to a distinct random value before release.\n' + '='.repeat(72) + '\n', ); } // D20 — a loud, unmissable banner whenever the delivery bypass is armed, so // it cannot reach the real release unnoticed. if (masterOtpEnabled()) { const code = masterOtpCode() ?? ''; // Both apps render the login OTP as FOUR single-character boxes and only // submit on @on-complete, i.e. at exactly 4 digits // (LoginView.vue:43 in each app, OtpInput.vue:43). The API itself accepts // any length, so a longer master code works over HTTP but can never be // typed into the apps. Warn rather than reject: an operator may be using it // for API testing only. const typable = /^\d{4}$/.test(code); // eslint-disable-next-line no-console console.warn( '\n' + '='.repeat(72) + '\n ⚠ OTP_MASTER_CODE فعال است — قبل از انتشار اصلی حذف شود\n' + ' ⚠ OTP_MASTER_CODE IS ACTIVE: any active customer can sign in with\n' + ' ⚠ this fixed code. Remove it from the environment before release.\n' + (typable ? '' : ' ⚠\n' + ' ⚠ NOTE: this code is not 4 digits, so it CANNOT be entered in the\n' + ' ⚠ customer apps — their OTP box has exactly 4 boxes. Use a\n' + ' ⚠ 4-digit code for the apps; this one works over the API only.\n') + '='.repeat(72) + '\n', ); } const app = await NestFactory.create(AppModule); app.setGlobalPrefix('api'); app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true })); app.useGlobalFilters(new PrismaExceptionFilter()); app.enableCors({ origin: corsOrigins() }); // Uploaded files, mounted OUTSIDE the /api prefix so the URLs stored on // UploadedFile.url ("/uploads/") resolve directly. app.useStaticAssets(envOr('UPLOAD_DIR', join(process.cwd(), 'storage', 'uploads')), { prefix: '/uploads/', index: false, dotfiles: 'deny', setHeaders: (res: Response, path: string) => { const mime = EXTRA_MIME_TYPES[extname(path).toLowerCase()]; if (mime) res.setHeader('Content-Type', mime); }, }); // envOr, not `??`: Number('') is 0, which would bind a random ephemeral port // and make the container unreachable at the port compose maps. See DEPLOY-02. const port = Number(envOr('PORT', '3000')); try { // Bind all interfaces explicitly so the container is reachable from nginx. await app.listen(port, '0.0.0.0'); } catch (err) { if ((err as NodeJS.ErrnoException).code === 'EADDRINUSE') { // eslint-disable-next-line no-console console.error( `\n[api] Port ${port} is already in use. Free it or change API_PORT ` + `in the repo-root .env (and PORT in apps/api/.env to match) — the ` + `API will not fall back to a different port.\n`, ); process.exit(1); } throw err; } } bootstrap();