@20syldev/api 4.1.0 → 4.3.0

package/docs/changelog.md

@@ -1,333 +0,0 @@
-# Changelog
-
-## Exemples curl
-
-```bash
-# dice
-curl -X GET "http://127.0.0.1:3000/v4/dice?roll=2d6%2B3"
-
-# encode
-curl -X GET "http://127.0.0.1:3000/v4/encode?method=base64encode&text=hello"
-curl -X GET "http://127.0.0.1:3000/v4/encode?method=morse&text=SOS"
-curl -X GET "http://127.0.0.1:3000/v4/encode?method=caesar&text=hello&shift=3"
-
-# geo
-curl -X GET "http://127.0.0.1:3000/v4/geo?lat1=48.8566&lon1=2.3522&lat2=43.2965&lon2=5.3698"
-
-# palette
-curl -X GET "http://127.0.0.1:3000/v4/palette?color=%23ff6600&type=triadic"
-
-# statistics
-curl -X GET "http://127.0.0.1:3000/v4/statistics?values=1,2,3,4,5"
-
-# text - stats
-curl -X GET "http://127.0.0.1:3000/v4/text?method=stats&value=Hello+world"
-
-# text - slug
-curl -X GET "http://127.0.0.1:3000/v4/text?method=slug&value=Héllo+Wörld%21"
-
-# text - lorem
-curl -X GET "http://127.0.0.1:3000/v4/text?method=lorem&type=sentences&count=3"
-
-# text - number
-curl -X GET "http://127.0.0.1:3000/v4/text?method=number&value=42&lang=fr"
-
-# validate - luhn
-curl -X GET "http://127.0.0.1:3000/v4/validate?type=luhn&value=4532015112830366"
-
-# validate - iban
-curl -X GET "http://127.0.0.1:3000/v4/validate?type=iban&value=FR7630006000011234567890189"
-
-# validate - email
-curl -X GET "http://127.0.0.1:3000/v4/validate?type=email&value=user%40example.com"
-
-# algorithms - roman
-curl -X GET "http://127.0.0.1:3000/v4/algorithms?method=roman&value=42"
-curl -X GET "http://127.0.0.1:3000/v4/algorithms?method=roman&value=XLII"
-
-# REST v4.2 - jouer un coup (PATCH)
-curl -X PATCH "http://127.0.0.1:3000/v4/tic-tac-toe/{gameId}" \
-  -H "Content-Type: application/json" \
-  -d '{"username":"alice","move":"A1","session":"abc123"}'
-
-# REST v4.2 - forfait (DELETE tic-tac-toe)
-curl -X DELETE "http://127.0.0.1:3000/v4/tic-tac-toe/{gameId}" \
-  -H "Content-Type: application/json" \
-  -d '{"username":"alice","session":"abc123"}'
-
-# REST v4.2 - vider un chat (DELETE chat)
-curl -X DELETE "http://127.0.0.1:3000/v4/chat/{token}" \
-  -H "Content-Type: application/json" \
-  -d '{"username":"alice","session":"abc123"}'
-```
-
-
-
-## v4.2.0
-
-### REST endpoints pour tic-tac-toe et chat
-
-Les endpoints existants ont été étendus avec des méthodes HTTP REST. Uniquement disponible en `v4+`.
-
-#### PATCH `/v4/tic-tac-toe/:game`
-
-Jouer un coup dans une partie.
-
-**Body (JSON) :**
-| Param | Type | Description |
-|-------|------|-------------|
-| `username` | string | Nom du joueur |
-| `move` | string | Case jouée (ex: `A1`) |
-| `session` | string | ID de session |
-
----
-
-#### DELETE `/v4/tic-tac-toe/:game`
-
-Abandonner une partie (forfeit).
-
-**Body (JSON) :**
-| Param | Type | Description |
-|-------|------|-------------|
-| `username` | string | Nom du joueur |
-| `session` | string | ID de session |
-
----
-
-#### DELETE `/v4/chat/:token`
-
-Effacer tous les messages d'un chat privé (clear).
-
-**Body (JSON) :**
-| Param | Type | Description |
-|-------|------|-------------|
-| `username` | string | Nom de l'utilisateur |
-| `session` | string | ID de session |
-
----
-
-### Autres changements v4.2.0
-
-- CORS : ajout de `PATCH`, `DELETE`, `OPTIONS` dans les headers autorisés
-- Nouveau helper `supportsRest()` dans `src/utils/version.ts`
-
----
-
-## v4.1.0
-
-### Nouveaux endpoints
-
-#### GET `/v4/dice`
-
-Lance des dés en notation RPG.
-
-**Query params :**
-| Param | Requis | Description | Exemple |
-|-------|--------|-------------|---------|
-| `roll` | oui | Notation NdX ou NdX+M | `2d6+3` |
-
-**Note :** le `+` dans l'URL peut être encodé en espace (`2d6 3`) — les deux sont acceptés.
-
-**Réponse :**
-```json
-{
-  "roll": "2d6+3",
-  "count": 2,
-  "sides": 6,
-  "modifier": 3,
-  "results": [4, 2],
-  "total": 9
-}
-```
-
-Limites : 1–100 dés, 2–1000 faces.
-
----
-
-#### GET `/v4/encode`
-
-Encode ou décode du texte dans différents formats.
-
-**Query params :**
-| Param | Requis | Description |
-|-------|--------|-------------|
-| `method` | oui | Voir liste ci-dessous |
-| `value` | oui | Texte à traiter |
-| `shift` | non | Décalage pour Caesar (défaut : 13) |
-
-**Méthodes disponibles :**
-| `method` | Description |
-|----------|-------------|
-| `base64encode` | Encode en Base64 |
-| `base64decode` | Décode du Base64 |
-| `urlencode` | Encode pour URL |
-| `urldecode` | Décode une URL |
-| `morse` | Texte → Morse |
-| `unmorse` | Morse → Texte |
-| `rot13` | ROT-13 |
-| `caesar` | Chiffre de César (nécessite `shift`) |
-| `binary` | Texte → binaire 8 bits |
-| `unbinary` | Binaire → texte |
-
----
-
-#### GET `/v4/geo`
-
-Calcule la distance et le cap entre deux coordonnées GPS (Haversine).
-
-**Query params :**
-| Param | Requis | Description |
-|-------|--------|-------------|
-| `lat1` | oui | Latitude point A (-90/+90) |
-| `lon1` | oui | Longitude point A (-180/+180) |
-| `lat2` | oui | Latitude point B |
-| `lon2` | oui | Longitude point B |
-
-**Réponse :**
-```json
-{
-  "distance": { "km": 1214.652, "miles": 754.801, "nauticalMiles": 655.879 },
-  "bearing": { "degrees": 157.34, "cardinal": "SSE" },
-  "from": { "lat": 48.8566, "lon": 2.3522 },
-  "to": { "lat": 43.2965, "lon": 5.3698 }
-}
-```
-
----
-
-#### GET `/v4/palette`
-
-Génère une palette de couleurs harmonieuse à partir d'une couleur HEX.
-
-**Query params :**
-| Param | Requis | Description |
-|-------|--------|-------------|
-| `color` | oui | Couleur base en HEX (`#RRGGBB`) |
-| `type` | oui | Type de palette |
-
-**Types disponibles :**
-| `type` | Couleurs générées |
-|--------|------------------|
-| `complementary` | 2 couleurs (opposées) |
-| `triadic` | 3 couleurs (120°) |
-| `analogous` | 5 couleurs (-60° à +60°) |
-| `tetradic` | 4 couleurs (90°) |
-| `split-complementary` | 3 couleurs |
-
-Chaque couleur retournée a `hex`, `rgb`, `hsl`.
-
----
-
-#### GET `/v4/statistics`
-
-Calcule des statistiques descriptives sur une liste de nombres.
-
-**Query params :**
-| Param | Requis | Description |
-|-------|--------|-------------|
-| `values` | oui | Nombres séparés par des virgules |
-
-**Réponse :**
-```json
-{
-  "count": 5,
-  "sum": 15,
-  "min": 1,
-  "max": 5,
-  "range": 4,
-  "mean": 3,
-  "median": 3,
-  "mode": [],
-  "variance": 2,
-  "stddev": 1.414214
-}
-```
-
----
-
-#### GET `/v4/text`
-
-Manipulation et génération de texte.
-
-**Query params :**
-| Param | Requis | Description |
-|-------|--------|-------------|
-| `action` | oui | Voir liste ci-dessous |
-| `value` | non | Texte source (selon action) |
-| `type` | non | `words`, `sentences`, `paragraphs` (pour `lorem`) |
-| `count` | non | Nombre d'éléments (pour `lorem`, défaut 5) |
-| `lang` | non | `fr` ou `en` (pour `number`) |
-
-**Actions disponibles :**
-| `action` | Description | Params requis |
-|----------|-------------|---------------|
-| `stats` | Statistiques du texte | `value` |
-| `slug` | Convertit en slug URL | `value` |
-| `lorem` | Génère du Lorem Ipsum | `type`, `count` |
-| `number` | Nombre en lettres | `value`, `lang` |
-
-**Réponse `stats` :**
-```json
-{
-  "characters": 42,
-  "charactersNoSpaces": 35,
-  "words": 8,
-  "sentences": 2,
-  "paragraphs": 1,
-  "readingTime": "3s",
-  "mostFrequentChar": "e"
-}
-```
-
----
-
-#### GET `/v4/validate`
-
-Valide différents formats de données.
-
-**Query params :**
-| Param | Requis | Description |
-|-------|--------|-------------|
-| `type` | oui | `luhn`, `iban`, `email` |
-| `value` | oui | Valeur à valider |
-
-**Réponse `luhn` (numéro de carte) :**
-```json
-{ "valid": true, "value": "4532015112830366" }
-```
-
-**Réponse `iban` :**
-```json
-{ "valid": true, "value": "FR7630006000011234567890189", "country": "FR" }
-```
-
-**Réponse `email` :**
-```json
-{ "valid": true, "value": "user@example.com" }
-```
-
----
-
-### Ajout à un endpoint existant
-
-#### GET `/v4/algorithms` — conversion de chiffres romains
-
-Nouvelle action `roman` sur l'endpoint algorithms.
-
-**Query params :**
-| Param | Requis | Description |
-|-------|--------|-------------|
-| `method` | oui | `roman` |
-| `value` | oui | Nombre entier (1–3999) ou chiffre romain |
-
-Bidirectionnel : `42` → `XLII`, `XLII` → `42`.
-
----
-
-### Infrastructure v4.1.0
-
-- **`src/app.ts`** : `export default app` + guard `NODE_ENV !== 'test'` pour les tests d'intégration
-- **`src/config/versions.ts`** : helper `merge()` pour dédoublonner les endpoints par `name`
-- **`tsconfig.test.json`** : étend le tsconfig principal, inclut `src/` et `tests/`
-- **`tests/tsconfig.json`** : pointe vers `tsconfig.test.json` pour la résolution IDE
-- **`package.json`** : script `npm test` avec `--test-force-exit` (requis car `setTimeout` dans chat/tic-tac-toe)

package/src/utils/version.ts

@@ -1,5 +0,0 @@
-import type { Request } from 'express';
-
-const REST_VERSIONS = new Set(['v4']);
-
-export const supportsRest = (req: Request): boolean => REST_VERSIONS.has(req.version);