// --- Modules integres (built-in) : pas d'installation necessaire ---
const fs = require("fs");                    // systeme de fichiers
const fsPromises = require("fs/promises");     // version basee sur des Promises
const path = require("path");
const http = require("http");
const os = require("os");
const crypto = require("crypto");

// --- Systeme de fichiers : version synchrone vs asynchrone (toujours preferer l'asynchrone) ---
// Synchrone : BLOQUE l'event loop entier -- a eviter en production sauf au demarrage du script
const contenuSync = fs.readFileSync("fichier.txt", "utf8");

// Asynchrone avec callback (API historique)
fs.readFile("fichier.txt", "utf8", (erreur, contenu) => {
    if (erreur) return console.error(erreur);
    console.log(contenu);
});

// Asynchrone avec Promises (API moderne recommandee)
async function lireFichier() {
    const contenu = await fsPromises.readFile("fichier.txt", "utf8");
    return contenu;
}

// --- path : manipulation de chemins portable entre OS ---
const cheminComplet = path.join(__dirname, "data", "fichier.txt");
console.log(path.extname("photo.jpg"));       // ".jpg"
console.log(path.basename("/dossier/fichier.txt"));   // "fichier.txt"
console.log(path.resolve("./relatif"));          // chemin absolu

// --- process : informations et controle du processus courant ---
console.log(process.env.NODE_ENV);              // variables d'environnement
console.log(process.argv);                         // arguments de la ligne de commande
console.log(process.platform, process.version);      // OS, version de Node
process.exit(0);                                       // termine le processus (a utiliser avec precaution)

process.on("uncaughtException", (erreur) => {
    console.error("Exception non capturee :", erreur);
    process.exit(1);          // recommande : redemarrer proprement apres une exception non geree
});

// --- Serveur HTTP natif (sans framework) ---
const serveur = http.createServer((requete, reponse) => {
    reponse.writeHead(200, { "Content-Type": "application/json" });
    reponse.end(JSON.stringify({ message: "Bonjour depuis Node.js" }));
});
serveur.listen(3000, () => console.log("Serveur demarre sur le port 3000"));

// --- Streams : traiter de gros volumes sans tout charger en memoire ---
const { createReadStream, createWriteStream } = require("fs");
const streamLecture = createReadStream("gros-fichier.log", "utf8");
const streamEcriture = createWriteStream("copie.log");
streamLecture.pipe(streamEcriture);      // traite le fichier morceau par morceau

streamLecture.on("data", (chunk) => console.log(`Chunk de ${chunk.length} caracteres`));
streamLecture.on("end", () => console.log("Lecture terminee"));
streamLecture.on("error", (erreur) => console.error("Erreur de stream :", erreur));

// --- EventEmitter : le pattern observer natif de Node ---
const { EventEmitter } = require("events");
class ServiceCommandes extends EventEmitter {
    creerCommande(donnees) {
        // ... logique metier
        this.emit("commande:creee", donnees);
    }
}
const service = new ServiceCommandes();
service.on("commande:creee", (cmd) => console.log("Nouvelle commande :", cmd));

// --- Variables globales specifiques a Node (absentes du navigateur) ---
console.log(__dirname);        // dossier du fichier courant
console.log(__filename);        // chemin complet du fichier courant
console.log(typeof module);      // "object" -- CommonJS, absent en environnement navigateur

// --- npm : gestionnaire de paquets et package.json ---
// npm init -y                 -- initialise un package.json
// npm install express          -- installe une dependance
// npm install --save-dev jest    -- dependance de developpement uniquement
// npm run start                    -- execute un script defini dans package.json

// --- Worker Threads : vrai parallelisme pour du CPU-bound (contourne le mono-thread) ---
const { Worker, isMainThread, parentPort } = require("worker_threads");
if (isMainThread) {
    const worker = new Worker(__filename);
    worker.on("message", (resultat) => console.log("Resultat du worker :", resultat));
} else {
    parentPort.postMessage(2 + 2);      // execute dans un thread separe
}