@20syldev/api 3.5.0 → 4.1.0

package/dist/routes/post.js

@@ -0,0 +1,185 @@
+import { Router } from 'express';
+import { chatStorage, ticTacToeStorage } from '../storage/index.js';
+import { MIN_TOKEN_LENGTH, MAX_TOKEN_LENGTH } from '../constants.js';
+import { error } from '../utils/response.js';
+const router = Router();
+// Store chat messages
+router.post('/:version/chat', (req, res) => {
+    const { username, message, timestamp, session, token } = req.body || {};
+    if (!username) {
+        error(res, 400, 'Please provide a username (?username={username})');
+        return;
+    }
+    if (!message) {
+        error(res, 400, 'Please provide a message (&message={message})');
+        return;
+    }
+    if (!session) {
+        error(res, 400, 'Please provide a valid session ID (&session={ID})');
+        return;
+    }
+    try {
+        const result = req.module.chat('message', {
+            username,
+            message,
+            timestamp,
+            session,
+            token,
+            storage: chatStorage,
+        });
+        res.jsonResponse(result);
+    }
+    catch (err) {
+        error(res, 400, err.message);
+    }
+});
+// Display a private chat with a token
+router.post('/:version/chat/private', (req, res) => {
+    const { username, token } = req.body || {};
+    if (!username) {
+        error(res, 400, 'Please provide a username (?username={username})');
+        return;
+    }
+    if (!token) {
+        error(res, 400, 'Please provide a valid token (&token={key}).');
+        return;
+    }
+    try {
+        const messages = req.module.chat('private', {
+            username,
+            token,
+            storage: chatStorage,
+        });
+        res.jsonResponse(messages);
+    }
+    catch (err) {
+        error(res, 400, err.message);
+    }
+});
+// Generate hash
+router.post('/:version/hash', (req, res) => {
+    const { text, method } = req.body || {};
+    if (!text) {
+        error(res, 400, 'Please provide a text (?text={text})', `${req.version}/hash`);
+        return;
+    }
+    if (!method) {
+        error(res, 400, 'Please provide a valid hash algorithm (&method={algorithm})', `${req.version}/hash`);
+        return;
+    }
+    try {
+        const result = req.module.hash(text, method);
+        res.jsonResponse(result);
+    }
+    catch (err) {
+        error(res, 400, err.message, `${req.version}/hash`);
+    }
+});
+// Display a planning from an ICS file
+router.post('/:version/hyperplanning', async (req, res) => {
+    const { url, detail } = req.body || {};
+    if (!url) {
+        error(res, 400, 'Please provide a valid ICS file URL (?url={URL})', `${req.version}/hyperplanning`);
+        return;
+    }
+    try {
+        const hyperplanning = await req.module.hyperplanning(url, detail);
+        res.jsonResponse(hyperplanning);
+    }
+    catch (err) {
+        error(res, 400, err.message, `${req.version}/hyperplanning`);
+    }
+});
+// Store tic tac toe games
+router.post('/:version/tic-tac-toe', (req, res) => {
+    const { username, move, session, game } = req.body || {};
+    if (!username) {
+        error(res, 400, 'Please provide a username (?username={username})');
+        return;
+    }
+    if (!move) {
+        error(res, 400, 'Please provide a valid move (&move={move})');
+        return;
+    }
+    if (!session) {
+        error(res, 400, 'Please provide a valid session ID (&session={ID})');
+        return;
+    }
+    if (!game) {
+        error(res, 400, 'Please provide a valid game ID (&game={ID})');
+        return;
+    }
+    try {
+        const result = req.module.tic_tac_toe('play', {
+            username,
+            move,
+            session,
+            game,
+            storage: ticTacToeStorage,
+        });
+        res.jsonResponse(result);
+    }
+    catch (err) {
+        error(res, 400, err.message);
+    }
+});
+// Display a tic tac toe game with a token
+router.post('/:version/tic-tac-toe/fetch', (req, res) => {
+    const { username, game } = req.body || {};
+    const privateGame = (req.body || {}).private;
+    if (!username) {
+        error(res, 400, 'Please provide a username (?username={username})');
+        return;
+    }
+    try {
+        const result = req.module.tic_tac_toe('fetch', {
+            username,
+            game,
+            private: privateGame,
+            storage: ticTacToeStorage,
+        });
+        res.jsonResponse(result);
+    }
+    catch (err) {
+        error(res, 400, err.message);
+    }
+});
+// List public tic tac toe games
+router.post('/:version/tic-tac-toe/list', (req, res) => {
+    try {
+        const result = req.module.tic_tac_toe('list', {
+            storage: ticTacToeStorage,
+        });
+        res.jsonResponse(result);
+    }
+    catch (err) {
+        error(res, 400, err.message);
+    }
+});
+// Generate Token
+router.post('/:version/token', (req, res) => {
+    const body = req.body || {};
+    const len = parseInt(String(body.len || 24), 10);
+    const type = body.type ? String(body.type).toLowerCase() : 'alpha';
+    if (isNaN(len) || len < 0) {
+        error(res, 400, 'Invalid number.', `${req.version}/token`);
+        return;
+    }
+    if (len > MAX_TOKEN_LENGTH) {
+        error(res, 400, 'Length cannot exceed 4096.', `${req.version}/token`);
+        return;
+    }
+    if (len < MIN_TOKEN_LENGTH) {
+        error(res, 400, 'Length cannot be less than 12.', `${req.version}/token`);
+        return;
+    }
+    try {
+        const token = req.module.token(len, type);
+        res.jsonResponse({ token });
+    }
+    catch (err) {
+        error(res, 400, err.message, `${req.version}/token`);
+    }
+});
+export default router;
+//# sourceMappingURL=post.js.map

package/dist/routes/post.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.js","sourceRoot":"","sources":["../../src/routes/post.ts"],"names":[],"mappings":"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"}

package/dist/storage/index.js

@@ -0,0 +1,13 @@
+export const ipLimits = {};
+export const chatStorage = {
+    messages: [],
+    privateChats: {},
+    sessions: {},
+    rateLimits: {},
+};
+export const ticTacToeStorage = {
+    games: {},
+    sessions: {},
+    rateLimits: {},
+};
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAa,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,WAAW,GAAgB;IACpC,QAAQ,EAAE,EAAE;IACZ,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,EAAE;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAC9C,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,EAAE;CACjB,CAAC"}

package/dist/types/storage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage.js.map

package/dist/types/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/types/storage.ts"],"names":[],"mappings":""}

package/dist/utils/response.js

@@ -0,0 +1,10 @@
+import { DOCS_URL, STATUS_MESSAGES } from '../constants.js';
+export function error(res, status, message, docPath) {
+    res.status(status).jsonResponse({
+        message: STATUS_MESSAGES[status] ?? 'Error',
+        error: message,
+        documentation: docPath ? `${DOCS_URL}/${docPath}` : DOCS_URL,
+        status: String(status),
+    });
+}
+//# sourceMappingURL=response.js.map

package/dist/utils/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/utils/response.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,UAAU,KAAK,CAAC,GAAa,EAAE,MAAc,EAAE,OAAe,EAAE,OAAgB;IAClF,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC;QAC5B,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI,OAAO;QAC3C,KAAK,EAAE,OAAO;QACd,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ;QAC5D,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;KACzB,CAAC,CAAC;AACP,CAAC"}

package/dist/utils/version.js

@@ -0,0 +1,3 @@
+const REST_VERSIONS = new Set(['v4']);
+export const supportsRest = (req) => REST_VERSIONS.has(req.version);
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAEtC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAY,EAAW,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC"}

package/docs/changelog.md

@@ -0,0 +1,333 @@
+# 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/eslint.config.js

@@ -0,0 +1,20 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import eslintConfigPrettier from 'eslint-config-prettier';
+
+export default tseslint.config(
+    eslint.configs.recommended,
+    ...tseslint.configs.strict,
+    eslintConfigPrettier,
+    {
+        rules: {
+            '@typescript-eslint/no-explicit-any': 'warn',
+            '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+            '@typescript-eslint/no-non-null-assertion': 'off',
+            '@typescript-eslint/no-dynamic-delete': 'off',
+        },
+    },
+    {
+        ignores: ['dist/', 'node_modules/', 'src/modules/v3/'],
+    },
+);

package/package.json

@@ -1,38 +1,53 @@
 {
-    "version": "3.5.0",
+    "version": "4.1.0",
     "name": "@20syldev/api",
     "description": "Node.js API with multiple features. Check the documentation at https://docs.sylvain.sh",
-    "main": "app.js",
+    "main": "dist/app.js",
     "type": "module",
     "scripts": {
-        "start": "node app.js",
-        "dev": "nodemon app.js",
-        "build": "npm install && node app.js",
-        "lint": "prettier --write .",
+        "dev": "tsx watch src/app.ts",
+        "start": "node dist/app.js",
+        "build": "tsc",
+        "check": "tsc --noEmit -p tsconfig.test.json && eslint src/ tests/",
+        "format": "prettier --write src/ tests/ && eslint --fix src/ tests/",
+        "test": "NODE_ENV=test node --import tsx --test --test-force-exit tests/unit/*.test.ts tests/integration/*.test.ts",
         "upgrade:minor": "npm upgrade",
-        "upgrade:major": "npx npm-check-updates -u && npm install",
-        "upgrade:build": "npm upgrade && npm install && node app.js"
+        "upgrade:major": "npx npm-check-updates -u && npm install"
+    },
+    "engines": {
+        "node": ">=22.0.0"
     },
     "exports": {
-        "./v1": "./modules/v1.js",
-        "./v2": "./modules/v2.js",
-        "./v3": "./modules/v3.js"
+        "./v1": "./dist/modules/v1.js",
+        "./v2": "./dist/modules/v2.js",
+        "./v3": "./dist/modules/v3.js",
+        "./v4": "./dist/modules/v4.js"
     },
     "dependencies": {
+        "@20syldev/logger.ts": "^1.0.1",
         "canvas": "^3.1.0",
         "cors": "^2.8.5",
         "dotenv": "^16.4.7",
         "express": "^5.1.0",
         "ical.js": "^2.1.0",
-        "node-fetch": "^3.3.2",
         "qrcode": "^1.5.4",
         "random": "^5.3.0",
         "uuid": "^11.1.0"
     },
     "devDependencies": {
-        "nodemon": "^3.1.10",
+        "@eslint/js": "^9.24.0",
+        "@types/cors": "^2.8.17",
+        "@types/express": "^5.0.0",
+        "@types/node": "^22.19.17",
+        "@types/qrcode": "^1.5.6",
+        "@types/uuid": "^10.0.0",
+        "eslint": "^9.24.0",
+        "eslint-config-prettier": "^10.1.1",
         "npm-check-updates": "^18.0.1",
-        "prettier": "^3.5.3"
+        "prettier": "^3.5.3",
+        "tsx": "^4.19.0",
+        "typescript": "^5.7.0",
+        "typescript-eslint": "^8.29.0"
     },
     "publishConfig": {
         "access": "public"
@@ -45,7 +60,8 @@
         "api",
         "express",
         "utility",
-        "math"
+        "math",
+        "typescript"
     ],
     "author": "Sylvain L.",
     "license": "BSD 3-Clause",