كيفية إدارة متغيرات البيئة بأمان في Node.js

# .gitignore
.env
.env.local
.env.production
.env.staging

# لا تُدمج ملفات env الحقيقية أبداً — فقط .env.example

# .env.example — مُدمج في git، لا قيم حقيقية
NODE_ENV=development
PORT=3000

DATABASE_URL=postgres://user:password@localhost:5432/myapp
REDIS_URL=redis://localhost:6379

JWT_SECRET=replace-with-a-long-random-string
STRIPE_SECRET_KEY=sk_test_replace_me

# احصل عليه من لوحة AWS IAM
AWS_ACCESS_KEY_ID=REPLACE_ME
AWS_SECRET_ACCESS_KEY=REPLACE_ME

# تشغيل التطبيق
node --env-file=.env server.js

# أو في package.json scripts:
# "start": "node --env-file=.env server.js"
# "dev":   "node --env-file=.env --watch server.js"

// في الكود — process.env مُعبّأ بالفعل
const port = process.env.PORT ?? 3000;
const db   = process.env.DATABASE_URL;

npm install dotenv

// server.js — يجب أن يكون أول شيء
require('dotenv').config();

// أو مع ES modules:
// import 'dotenv/config';

const port = process.env.PORT ?? 3000;

// الخيار أ: فحص يدوي (بدون مكتبات)
const required = ['DATABASE_URL', 'JWT_SECRET', 'PORT'];
for (const key of required) {
    if (!process.env[key]) {
        console.error(`متغير البيئة المطلوب مفقود: ${key}`);
        process.exit(1);
    }
}

// الخيار ب: zod (محدد النوع + قيم افتراضية)
// npm install zod
const { z } = require('zod');

const envSchema = z.object({
    NODE_ENV:     z.enum(['development', 'test', 'production']).default('development'),
    PORT:         z.string().transform(Number).default('3000'),
    DATABASE_URL: z.string().url(),
    JWT_SECRET:   z.string().min(32, 'JWT_SECRET يجب أن يكون 32 حرفاً على الأقل'),
});

const env = envSchema.parse(process.env); // يرمي خطأ عند قيم غير صحيحة
module.exports = env;

# .env              — قيم أساسية (في .gitignore)
# .env.production   — تجاوزات الإنتاج (في .gitignore)
# .env.staging      — تجاوزات الاختبار (في .gitignore)
# .env.example      — قالب placeholder آمن (مُدمج)

// ترتيب التحميل مع dotenv (الأساسي أولاً، ثم تجاوز البيئة):
require('dotenv').config({ path: '.env' });
require('dotenv').config({
    path: `.env.${process.env.NODE_ENV}`,
    override: true,
});