@20syldev/api 3.0.0 → 3.2.0

package/README.md

@@ -2,7 +2,7 @@
   <a href="https://api.sylvain.pro"><img src="https://api.sylvain.pro/favicon.ico" alt="Logo" width="25%" height="auto"/></a>
 
   # API Personnelle
-  [![Version](https://custom-icon-badges.demolab.com/badge/Version%20:-v3.0.0-6479ee?logo=api.sylvain.pro&labelColor=23272A)](https://github.com/20syldev/api/releases/latest)
+  [![Version](https://custom-icon-badges.demolab.com/badge/Version%20:-v3.2.0-6479ee?logo=api.sylvain.pro&labelColor=23272A)](https://github.com/20syldev/api/releases/latest)
 </div>
 
 ---
@@ -44,7 +44,7 @@ Enfin, **exécutez** le script de build, qui installera les **dépendances** et
 $ npm run build
 ```
 ```console
-> @20syldev/api@3.0.0 build
+> @20syldev/api@3.2.0 build
 > npm install && node app.js
 
 [...]

package/app.js

@@ -2,6 +2,7 @@ import cors from 'cors';
 import dotenv from 'dotenv';
 import express from 'express';
 import fetch from 'node-fetch';
+import ical from 'ical.js';
 import { createCanvas } from 'canvas';
 import { randomBytes, getHashes, createHash } from 'crypto';
 import { urlencoded, json } from 'express';
@@ -20,10 +21,11 @@ const versions = ['v1', 'v2', 'v3'];
 const endpoints = {
     v1: ['algorithms', 'captcha', 'color', 'convert', 'domain', 'infos', 'personal', 'qrcode', 'token', 'username', 'website'],
     v2: ['algorithms', 'captcha', 'chat', 'color', 'convert', 'domain', 'hash', 'infos', 'personal', 'qrcode', 'tic-tac-toe', 'token', 'username', 'website'],
-    v3: ['algorithms', 'captcha', 'chat', 'color', 'convert', 'date', 'domain', 'hash', 'infos', 'levenshtein', 'personal', 'qrcode', 'tic-tac-toe', 'time', 'token', 'username', 'website']
+    v3: ['algorithms', 'captcha', 'chat', 'color', 'convert', 'date', 'domain', 'hash', 'hyperplanning', 'infos', 'levenshtein', 'personal', 'qrcode', 'tic-tac-toe', 'time', 'token', 'username', 'website']
 };
 
-// Arrowed functions (math & random)
+// Arrowed functions (formatting, math & random)
+const formatDate = d => new Date(d.getTime() - d.getTimezoneOffset() * 60000).toISOString().replace('Z', '');
 const gcd = (a, b) => b === 0 ? a : gcd(b, a % b);
 const genID = () => {
     const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
@@ -134,7 +136,7 @@ app.use((req, res, next) => {
 // Internal Server Error
 app.use((err, req, res, next) => {
     console.error(err.stack);
-    res.status(500).json({
+    res.status(500).jsonResponse({
         message: 'Internal Server Error',
         error: err.message,
         documentation: 'https://docs.sylvain.pro',
@@ -199,6 +201,7 @@ app.get('/', (req, res) => {
 app.get('/v1', (req, res) => {
     res.jsonResponse({
         version: 'v1',
+        documentation: 'https://docs.sylvain.pro/v1',
         endpoints: {
             get: {
                 algorithm: '/v1/algorithms?method={algorithm}&value={value}(&value2={value2})',
@@ -222,6 +225,7 @@ app.get('/v1', (req, res) => {
 app.get('/v2', (req, res) => {
     res.jsonResponse({
         version: 'v2',
+        documentation: 'https://docs.sylvain.pro/v2',
         endpoints: {
             get: {
                 algorithm: '/v2/algorithms?method={algorithm}&value={value}(&value2={value2})',
@@ -255,6 +259,7 @@ app.get('/v2', (req, res) => {
 app.get('/v3', (req, res) => {
     res.jsonResponse({
         version: 'v3',
+        documentation: 'https://docs.sylvain.pro/v3',
         endpoints: {
             get: {
                 algorithm: '/v3/algorithms?method={algorithm}&value={value}(&value2={value2})',
@@ -276,6 +281,7 @@ app.get('/v3', (req, res) => {
                     private: '/v3/chat/private'
                 },
                 hash: '/v3/hash',
+                hyperplanning: '/v3/hyperplanning',
                 tic_tac_toe: {
                     tic_tac_toe: '/v3/tic-tac-toe',
                     fetch: '/v3/tic-tac-toe/fetch'
@@ -527,6 +533,11 @@ app.get('/:version/domain', (req, res) => {
     });
 });
 
+// GET planning error
+app.get('/:version/hyperplanning', (req, res) => {
+    res.jsonResponse({ error: 'This endpoint only supports POST requests.' });
+});
+
 // GET hash error
 app.get('/:version/hash', (req, res) => {
     res.jsonResponse({ error: 'This endpoint only supports POST requests.' });
@@ -547,8 +558,11 @@ app.get('/:version/infos', (req, res) => {
 app.get('/:version/levenshtein', (req, res) => {
     const { str1, str2 } = req.query;
 
-    if (!str1) return res.jsonResponse({ error: 'Please provide a first string (?str1={string})' });
-    if (!str2) return res.jsonResponse({ error: 'Please provide a second string (&str2={string})' });
+    if (!str1 || typeof str1 !== 'string') return res.jsonResponse({ error: 'Please provide a first string (?str1={string})' });
+    if (!str2 || typeof str2 !== 'string') return res.jsonResponse({ error: 'Please provide a second string (&str2={string})' });
+
+    if (str1.length > 1000) return res.jsonResponse({ error: 'First string exceeds 1000 characters.' });
+    if (str2.length > 1000) return res.jsonResponse({ error: 'Second string exceeds 1000 characters.' });
 
     const lev = (a, b) => {
         const m = Array.from({ length: a.length + 1 }, (_, i) => [i]);
@@ -834,6 +848,7 @@ app.get('/:version/website', async (req, res) => {
     res.jsonResponse({
         versions: {
             api: process.env.API,
+            cdn: process.env.CDN,
             coop_api: process.env.COOP_API,
             coop_status: process.env.COOP_STATUS,
             chat: process.env.CHAT,
@@ -846,6 +861,7 @@ app.get('/:version/website', async (req, res) => {
             gemsync: process.env.GEMSYNC,
             gitsite: process.env.GITSITE,
             logs: process.env.LOGS,
+            minify: process.env.MINIFY,
             morpion: process.env.MORPION,
             nitrogen: process.env.NITROGEN,
             old_database: process.env.OLD_DATABASE,
@@ -935,6 +951,49 @@ app.post('/:version/chat/private', (req, res) => {
     return res.jsonResponse({ error: 'Invalid or expired token.' });
 });
 
+// Display a planning from an ICS file
+app.post('/:version/hyperplanning', async (req, res) => {
+    const { url, detail } = req.body;
+
+    if (!url) res.jsonResponse({ error: 'Please provide a valid ICS file URL.' });
+
+    try {
+        const response = await fetch(url);
+        if (!response.ok || !(response.headers.get('content-type') || '').includes('text/calendar')) return res.jsonResponse({ error: 'Invalid ICS file format.' });
+
+        const events = new ical.Component(ical.parse(await response.text()))
+            .getAllSubcomponents('vevent')
+            .map(e => {
+                const evt = new ical.Event(e);
+                const summary = evt.summary.split(' ').filter(part => part !== '-');
+                const start = formatDate(evt.startDate.toJSDate());
+                const end = formatDate(evt.endDate.toJSDate());
+
+                if (detail === 'full') {
+                    const desc = evt.description.split('\n').map(l => l.trim());
+                    const extract = (p) => (desc.find(l => l.startsWith(p)) || '').replace(p, '').trim();
+
+                    return {
+                        summary,
+                        subject: extract('Matière :'),
+                        teacher: extract('Enseignant :'),
+                        classes: extract('Promotions :').split(', ').map(c => c.trim()),
+                        type: extract('Salle :') || undefined,
+                        start,
+                        end
+                    };
+                }
+                if (detail === 'list') return { summary, start, end };
+
+                return { summary: evt.summary, start, end };
+            })
+            .sort((a, b) => new Date(a.start) - new Date(b.start))
+            .filter(e => new Date(e.start) >= new Date());
+
+        res.jsonResponse(events);
+    } catch { res.jsonResponse({ error: 'Failed to parse ICS file.' }); }
+});
+
 // Store tic tac toe games
 app.post('/:version/tic-tac-toe', (req, res) => {
     const { username, move, session, game } = req.body;
@@ -972,7 +1031,7 @@ app.post('/:version/tic-tac-toe', (req, res) => {
     if (result.winner || result.tie) {
         setTimeout(() => delete games[game], 600000);
         return res.jsonResponse({
-            message: `Move sent successfully. ${result.winner ? result.winner + " wins. " + result.loser + " loses." : "It's a tie."}`,
+            message: `Move sent successfully. ${result.winner ? result.winner + ' wins. ' + result.loser + ' loses.' : 'It\'s a tie.'}`,
             ...result
         });
     }

package/package.json

@@ -1,12 +1,14 @@
 {
-    "version": "3.0.0",
+    "version": "3.2.0",
     "name": "@20syldev/api",
     "description": "Node.js API with multiple features. Check the documentation at https://docs.sylvain.pro",
     "main": "app.js",
     "type": "module",
     "scripts": {
         "start": "node app.js",
+        "dev": "nodemon app.js",
         "build": "npm install && node app.js",
+        "lint": "prettier --write .",
         "upgrade:minor": "npm upgrade",
         "upgrade:major": "npx npm-check-updates -u && npm install",
         "upgrade:build": "npm upgrade && npm install && node app.js"
@@ -16,6 +18,7 @@
         "cors": "latest",
         "dotenv": "latest",
         "express": "latest",
+        "ical.js": "latest",
         "mathjs": "latest",
         "node-fetch": "latest",
         "prettier": "latest",