fazer-lang 3.3.1 → 3.5.0

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 All notable changes to this project will be documented in this file.
 
+## [3.4.0] - 2026-01-26
+
+### Added
+- **Native Database (`db`)**: Built-in JSON NoSQL database.
+    - `db.open(path)`: Load/create a database file.
+    - `db.set(key, val)`, `db.get(key)`, `db.push(key, item)`: Data manipulation.
+    - `db.save()`: Persist data to disk.
+- **Task Scheduler (`sched`)**: Native automation scheduler.
+    - `sched.every(ms, fn)`: Recurring tasks (intervals).
+    - `sched.after(ms, fn)`: Delayed tasks (timeouts).
+- **Network Sockets (`net`)**: Low-level TCP/UDP support.
+    - `net.tcp_client(host, port, callback)`: Raw TCP client.
+    - `net.udp_socket(port, callback)`: UDP Server (bind) or Client.
+- **Physics Helpers (`phys`)**: Game development math utilities.
+    - `phys.dist`, `phys.angle`, `phys.clamp`, `phys.lerp`, `phys.aabb`.
+- **Ecosystem**: Added `opensiren.fz` example (UDP Syslog Server).
+
+## [3.3.0] - 2026-01-25
+
+### Added
+- **GFX Image & Audio**:
+    - `gfx.load_image(key, path)`: Support for PNG/JPG/GIF.
+    - `gfx.image(key, x, y)`: Draw images/sprites.
+    - `gfx.load_sound(key, path)`: Support for WAV/MP3.
+    - `gfx.play_sound(key)`: Audio playback.
+- **GFX Optimization**:
+    - `gfx.batch(key, items)`: High-performance batch rendering for tilemaps.
+- **Isometric Math**: Added `lib/iso.fz` standard library.
+
 ## [3.2.1] - 2026-01-25
 
 ### Added

package/README.md

@@ -4,6 +4,34 @@
 
 Conçu pour l'automatisation, la sécurité et le traitement de données, Fazer combine une syntaxe concise avec une bibliothèque standard "batteries included".
 
+![Version](https://img.shields.io/badge/version-3.5.0-blue.svg) ![License](https://img.shields.io/badge/license-MIT-green.svg)
+
+## Nouveautés v3.5 (Security & Interactive Update)
+
+*   **Interactive (`read_line`)** : Entrée utilisateur native dans la console.
+*   **Sentinelle** : Outil de sécurité console complet inclus.
+*   **Base de Données (`db`)** : Stockage JSON natif et persistant.
+*   **Planificateur (`sched`)** : Automatisation de tâches (Cron-like).
+*   **Réseau (`net`)** : Support complet TCP/UDP Sockets.
+*   **Physique (`phys`)** : Outils mathématiques pour le jeu vidéo.
+*   **Sécurité (`security`)** : Chiffrement militaire, suppression sécurisée (shred), stéganographie et protection système.
+
+## 🛡️ Showcase : Sentinelle
+
+Fazer inclut désormais **Sentinelle**, un outil de sécurité console de référence écrit entièrement en Fazer.
+Il démontre les capacités de protection active :
+*   Surveillance de fichiers temps réel.
+*   Coffre-fort (dossiers invisibles).
+*   Anti-Forensique (suppression définitive).
+
+Retrouvez-le dans le dossier `Sentinelle/`.
+
+Lancer Sentinelle depuis la racine du projet :
+
+```bash
+fazer Sentinelle/sentinelle.fz
+```
+
 ## Installation
 
 ### Windows

package/docs/security.md

@@ -0,0 +1,125 @@
+# Module de Sécurité (security)
+
+Le module `security` fournit des outils avancés pour la protection des données, l'anti-forensique et la surveillance d'intrusions.
+
+## Suppression Sécurisée (Shredding)
+
+Supprime définitivement un fichier en écrasant son contenu plusieurs fois avant la suppression, rendant la récupération quasi-impossible.
+
+### `security.shred(path, [passes])`
+*   `path` : Chemin du fichier à détruire.
+*   `passes` : (Optionnel) Nombre de passes d'écrasement (défaut: 3).
+
+```fazer
+# Destruction standard (3 passes)
+security.shred("secrets.txt")
+
+# Destruction extrême (10 passes)
+security.shred("top_secret.db", 10)
+```
+
+## Chiffrement de Fichiers
+
+Chiffre et déchiffre des fichiers entiers en utilisant l'algorithme AES-256-CBC.
+
+### `security.encrypt_file(path, key)`
+Chiffre le fichier spécifié et crée un nouveau fichier avec l'extension `.enc`.
+*   Le fichier original n'est PAS supprimé automatiquement (utilisez `shred` si nécessaire).
+*   Utilise un sel aléatoire et un IV aléatoire (stocké dans le fichier de sortie).
+
+```fazer
+key := "MonMotDePasseSuperSecurise"
+if security.encrypt_file("data.json", key) ->
+    println("Fichier chiffré avec succès !")
+    security.shred("data.json") # Supprime l'original
+end
+```
+
+### `security.decrypt_file(path, key)`
+Déchiffre un fichier `.enc`. Si le fichier n'a pas l'extension `.enc`, ajoute `.dec` à la sortie.
+
+```fazer
+security.decrypt_file("data.json.enc", "MonMotDePasseSuperSecurise")
+```
+
+## Intégrité des Fichiers
+
+### `security.hash_file(path)`
+Calcule l'empreinte SHA-256 d'un fichier pour vérifier s'il a été modifié.
+
+```fazer
+hash := security.hash_file("system.dll")
+if hash != KNOWN_GOOD_HASH ->
+    println("ALERTE : Fichier système modifié !")
+end
+```
+
+## Protection des Dossiers (Windows)
+
+### `security.lock_folder(path)`
+Cache et verrouille un dossier en le marquant comme fichier système caché (Super Hidden).
+*   Le dossier ne sera pas visible même si "Afficher les fichiers cachés" est activé dans l'explorateur (sauf si "Masquer les fichiers protégés du système" est décoché).
+
+```fazer
+security.lock_folder("C:\\Users\\Moi\\CoffreFort")
+```
+
+### `security.unlock_folder(path)`
+Restaure la visibilité normale d'un dossier.
+
+```fazer
+security.unlock_folder("C:\\Users\\Moi\\CoffreFort")
+```
+
+## Surveillance (Sentry Mode)
+
+### `security.monitor(path, callback)`
+Surveille un fichier ou un dossier pour détecter tout changement (accès, modification, renommage).
+
+```fazer
+fn alerte(type, nom) ->
+    println("INTRUSION DÉTECTÉE : " + type + " sur " + nom)
+    # Action défensive : supprimer les clés de chiffrement, envoyer une alerte, etc.
+end
+
+security.monitor("C:\\SensitiveData", alerte)
+
+# Garder le script en vie
+while true -> end
+```
+
+## Stéganographie (Nouveau)
+
+Dissimulez des données sensibles à l'intérieur d'images anodines. Cette technique permet de contourner la censure ou de stocker des informations de manière invisible.
+
+### `security.steg_hide(img_path, file_path, out_path)`
+Fusionne un fichier secret dans une image (JPG, PNG, etc.). L'image résultante reste lisible par les visionneuses d'images.
+*   `img_path` : Image de couverture.
+*   `file_path` : Fichier secret à cacher.
+*   `out_path` : Nom de l'image de sortie (qui contiendra le secret).
+
+```fazer
+security.steg_hide("chat.jpg", "codes_nucleaires.txt", "chat_safe.jpg")
+```
+
+### `security.steg_reveal(img_path, out_path)`
+Extrait un fichier secret caché dans une image.
+```fazer
+security.steg_reveal("chat_safe.jpg", "codes_recuperes.txt")
+```
+
+## Pare-feu & Réseau (Windows Admin)
+
+Contrôle direct du pare-feu Windows pour bloquer les menaces.
+
+### `security.firewall_block(target)`
+Bloque tout le trafic entrant venant d'une IP ou sur un port spécifique.
+*   `target` : Chaîne (IP) ou Entier (Port).
+
+```fazer
+# Bloquer une IP malveillante
+security.firewall_block("192.168.1.66")
+
+# Bloquer le port Telnet
+security.firewall_block(23)
+```

package/docs/stdlib.md

@@ -32,6 +32,16 @@ if fs_exists("data") -> ... end
 
 ## Manipulation de Données
 
+### Entrée Utilisateur (Terminal)
+
+*   `read_line(prompt)` : Lit une ligne tapée au clavier dans le terminal.
+*   `menu(options)` : Affiche une liste numérotée et retourne le choix sélectionné.
+
+```fazer
+nom := read_line("Votre nom: ")
+choix := menu(["Scanner", "Chiffrer", "Quitter"])
+```
+
 ### JSON
 *   `json_parse(str)` : Convertit une chaîne JSON en objet/liste.
 *   `json_stringify(obj)` : Convertit un objet en chaîne JSON formatée.
@@ -52,17 +62,123 @@ if fs_exists("data") -> ... end
 *   `int(n)` : Conversion en entier.
 *   `float(n)` : Conversion en flottant.
 
+### `net.tcp_client(host, port, onData)`
+Crée un client TCP brut.
+```fazer
+net.tcp_client("127.0.0.1", 9000, fn(data, api) ->
+    print("Reçu: " + data)
+    api.write("Réponse")
+    api.close()
+end)
+```
+
+### `net.udp_socket(port, onMsg)`
+Crée un socket UDP (Serveur si port > 0, Client si port = 0).
+```fazer
+# Serveur UDP
+server := net.udp_socket(5140, fn(msg, info) ->
+    print("De " + info.address + ": " + msg)
+end)
+
+# Client UDP
+client := net.udp_socket(0, null)
+client.send("Log message", "127.0.0.1", 5140)
+```
+
 ## Base de Données (db)
 
-### `db(path)`
-Crée ou charge une base de données JSON persistante.
+Une base de données JSON NoSQL légère et intégrée.
+
+### `db.open(path)`
+Charge ou crée une base de données.
+```fazer
+db.open("users.json")
+```
+
+### Manipulation
+*   `db.set(key, value)` : Enregistre une valeur.
+*   `db.get(key)` : Récupère une valeur.
+*   `db.delete(key)` : Supprime une clé.
+*   `db.save()` : Sauvegarde les changements sur le disque.
+*   `db.push(key, item)` : Ajoute un élément à une liste.
+*   `db.keys()` : Liste toutes les clés.
+
+## Planificateur (sched)
+
+Pour l'automatisation et les tâches récurrentes.
+
+### `sched.every(ms, fn)`
+
+## Sécurité (security)
+
+Module dédié à la protection des données, à l'anonymat et à l'anti-forensique.
+
+### `security.shred(path, passes)`
+Supprime définitivement un fichier en l'écrasant plusieurs fois avec des données aléatoires avant suppression.
+*   `passes` (optionnel) : Nombre de passes (défaut : 3).
+```fazer
+security.shred("secret.txt", 7)
+```
+
+### `security.lock_folder(path)` / `security.unlock_folder(path)`
+(Windows uniquement) Rend un dossier "Super-Caché" (Attributs Système + Caché + Lecture Seule).
+Le dossier devient invisible dans l'explorateur par défaut.
 ```fazer
-store := db("data.json")
-store.set("key", "value")
-val := store.get("key")
-data := store.all()
+security.lock_folder("C:\\CoffreFort")
 ```
 
+### `security.encrypt_file(path, password)` / `security.decrypt_file(path, password)`
+Chiffre ou déchiffre un fichier en utilisant l'algorithme AES-256-CBC.
+Le fichier original est remplacé par sa version `.enc` (ou restauré).
+```fazer
+security.encrypt_file("passwords.txt", "MonSuperMotDePasse")
+```
+
+### `security.monitor(path, callback)`
+Surveille un dossier ou fichier en temps réel pour détecter les modifications (création, modification, suppression).
+```fazer
+security.monitor("C:\\Logs", fn(evt, file) ->
+    print("Alerte: " + evt + " sur " + file)
+end)
+```
+
+### `security.steg_hide(image_path, file_path, output_path)`
+(Nouveau) Cache un fichier à l'intérieur d'une image (Stéganographie LSB).
+```fazer
+security.steg_hide("vacances.png", "secret.txt", "vacances_safe.png")
+```
+
+### `security.firewall_block(ip_or_port)`
+(Nouveau) Ajoute une règle de pare-feu Windows pour bloquer une IP ou un Port (Nécessite Admin).
+```fazer
+security.firewall_block("192.168.1.50")
+security.firewall_block(8080)
+```
+
+Exécute une fonction en boucle.
+```fazer
+id := sched.every(1000, fn() -> print("Tick") end)
+```
+
+### `sched.after(ms, fn)`
+Exécute une fonction une fois après un délai.
+```fazer
+sched.after(5000, fn() -> print("Boom") end)
+```
+
+### `sched.cancel(id)`
+Annule une tâche planifiée.
+
+## Physique & Math (phys)
+
+Helpers pour le développement de jeux.
+
+*   `phys.dist(x1, y1, x2, y2)` : Distance entre deux points.
+*   `phys.angle(x1, y1, x2, y2)` : Angle en radians.
+*   `phys.clamp(val, min, max)` : Contraint une valeur.
+*   `phys.lerp(a, b, t)` : Interpolation linéaire.
+*   `phys.aabb(rect1, rect2)` : Collision AABB (x, y, w, h).
+
 ## Automation & Système
 
 ### Presse-papier
@@ -140,3 +256,12 @@ Fonctionnalités pour créer des interfaces en ligne de commande (TUI) riches et
     *   Exemple : `ui_bar(50, 100, 20)` -> `██████████          `
 *   `box(title, line1, line2, ...)` : Affiche une boîte encadrée.
 
+## Sécurité & Protection (security)
+
+Module dédié à la protection des données, destruction sécurisée et surveillance.
+Voir la documentation complète : [security.md](security.md)
+
+*   `security.shred(path)` : Suppression sécurisée (multi-pass overwrite).
+*   `security.encrypt_file(path, key)` : Chiffrement AES-256 de fichiers.
+*   `security.lock_folder(path)` : Verrouillage/Masquage de dossier (Windows).
+*   `security.monitor(path, callback)` : Détection d'intrusions sur fichiers/dossiers.