@20syldev/api 3.5.0 → 4.0.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":"AAAA,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;AAExB,sBAAsB;AACtB,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;IAC1D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,GAAI,GAAG,CAAC,IAA+B,IAAI,EAAE,CAAC;IAEpG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,kDAAkD,CAAC,CAAC;QACpE,OAAO;IACX,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,+CAA+C,CAAC,CAAC;QACjE,OAAO;IACX,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,mDAAmD,CAAC,CAAC;QACrE,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE;YACtC,QAAQ;YACR,OAAO;YACP,SAAS;YACT,OAAO;YACP,KAAK;YACL,OAAO,EAAE,WAAW;SACvB,CAAC,CAAC;QACH,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,sCAAsC;AACtC,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;IAClE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAI,GAAG,CAAC,IAA+B,IAAI,EAAE,CAAC;IAEvE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,kDAAkD,CAAC,CAAC;QACpE,OAAO;IACX,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,8CAA8C,CAAC,CAAC;QAChE,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE;YACxC,QAAQ;YACR,KAAK;YACL,OAAO,EAAE,WAAW;SACvB,CAAC,CAAC;QACH,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gBAAgB;AAChB,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;IAC1D,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAI,GAAG,CAAC,IAA+B,IAAI,EAAE,CAAC;IAEpE,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,sCAAsC,EAAE,GAAG,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC;QAC/E,OAAO;IACX,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,6DAA6D,EAAE,GAAG,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC;QACtG,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC;IACnE,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,sCAAsC;AACtC,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;IACzE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAI,GAAG,CAAC,IAA+B,IAAI,EAAE,CAAC;IAEnE,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,kDAAkD,EAAE,GAAG,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC;QACpG,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClE,GAAG,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAC5E,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,0BAA0B;AAC1B,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;IACjE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAI,GAAG,CAAC,IAA+B,IAAI,EAAE,CAAC;IAErF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,kDAAkD,CAAC,CAAC;QACpE,OAAO;IACX,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,4CAA4C,CAAC,CAAC;QAC9D,OAAO;IACX,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,mDAAmD,CAAC,CAAC;QACrE,OAAO;IACX,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,6CAA6C,CAAC,CAAC;QAC/D,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE;YAC1C,QAAQ;YACR,IAAI;YACJ,OAAO;YACP,IAAI;YACJ,OAAO,EAAE,gBAAgB;SAC5B,CAAC,CAAC;QACH,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,0CAA0C;AAC1C,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;IACvE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAI,GAAG,CAAC,IAA+B,IAAI,EAAE,CAAC;IACtE,MAAM,WAAW,GAAG,CAAE,GAAG,CAAC,IAAgC,IAAI,EAAE,CAAC,CAAC,OAA8B,CAAC;IAEjG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,kDAAkD,CAAC,CAAC;QACpE,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE;YAC3C,QAAQ;YACR,IAAI;YACJ,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,gBAAgB;SAC5B,CAAC,CAAC;QACH,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gCAAgC;AAChC,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;IACtE,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE;YAC1C,OAAO,EAAE,gBAAgB;SAC5B,CAAC,CAAC;QACH,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,iBAAiB;AACjB,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;IAC3D,MAAM,IAAI,GAAI,GAAG,CAAC,IAAgC,IAAI,EAAE,CAAC;IACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAEnE,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC;QAC3D,OAAO;IACX,CAAC;IACD,IAAI,GAAG,GAAG,gBAAgB,EAAE,CAAC;QACzB,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,4BAA4B,EAAE,GAAG,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC;QACtE,OAAO;IACX,CAAC;IACD,IAAI,GAAG,GAAG,gBAAgB,EAAE,CAAC;QACzB,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,gCAAgC,EAAE,GAAG,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC;QAC1E,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1C,GAAG,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC;IACpE,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC"}

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/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,52 @@
 {
-    "version": "3.5.0",
+    "version": "4.0.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 && eslint src/",
+        "format": "prettier --write src/ && eslint --fix src/",
         "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.0.0",
+        "@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 +59,8 @@
         "api",
         "express",
         "utility",
-        "math"
+        "math",
+        "typescript"
     ],
     "author": "Sylvain L.",
     "license": "BSD 3-Clause",

package/src/app.ts

@@ -0,0 +1,44 @@
+import express from 'express';
+import { env } from './config/env.js';
+import { setupCors } from './middleware/cors.js';
+import { jsonResponseMiddleware } from './middleware/json.js';
+import { rateLimitMiddleware } from './middleware/ratelimit.js';
+import { loggerMiddleware } from './middleware/logger.js';
+import { errorHandler } from './middleware/error.js';
+import { versionCheckMiddleware, endpointCheckMiddleware } from './middleware/version.js';
+import indexRoutes from './routes/index.js';
+import getRoutes from './routes/get.js';
+import postRoutes from './routes/post.js';
+
+const app = express();
+
+// Setup CORS, body parsing, static files
+setupCors(app);
+
+// Custom JSON response
+app.use(jsonResponseMiddleware);
+
+// Rate limiting
+app.use(rateLimitMiddleware);
+
+// Request logging
+app.use(loggerMiddleware);
+
+// Error handling
+app.use(errorHandler);
+
+// Root routes (before version check)
+app.use(indexRoutes);
+
+// Version & endpoint validation
+app.use('/:version', versionCheckMiddleware);
+app.use('/:version/:endpoint', endpointCheckMiddleware);
+
+// Versioned routes
+app.use(getRoutes);
+app.use(postRoutes);
+
+// Start server
+app.listen(env.PORT, () =>
+    console.log(`API is running on\n    - http://127.0.0.1:${env.PORT}\n    - http://localhost:${env.PORT}`),
+);

package/src/config/env.ts

@@ -0,0 +1,81 @@
+import dotenv from 'dotenv';
+import { DEFAULT_PORT } from '../constants.js';
+
+dotenv.config();
+
+function envList(key: string): string[] | null {
+    const v = process.env[key];
+    return v && v !== 'undefined' ? v.split(' ') : null;
+}
+
+function envNumber(key: string, fallback: number): number {
+    const v = parseInt(process.env[key] ?? '', 10);
+    return isNaN(v) ? fallback : v;
+}
+
+export const env = {
+    PORT: envNumber('PORT', DEFAULT_PORT),
+    GITHUB_TOKEN: process.env.GITHUB_TOKEN ?? '',
+
+    DEFAULT_LIMIT: envNumber('DEFAULT_LIMIT', 2000),
+    PRO_LIMIT: envNumber('PRO_LIMIT', 6000),
+    ADVANCED_LIMIT: envNumber('ADVANCED_LIMIT', 4000),
+    BUSINESS_LIMIT: envNumber('BUSINESS_LIMIT', 10000),
+    GLOBAL_LIMIT: envNumber('GLOBAL_LIMIT', 50000),
+
+    BUSINESS_TOKEN_LIST: envList('BUSINESS_TOKEN_LIST') ?? [],
+    PRO_TOKEN_LIST: envList('PRO_TOKEN_LIST') ?? [],
+    ADVANCED_TOKEN_LIST: envList('ADVANCED_TOKEN_LIST') ?? [],
+
+    // Website endpoint env vars
+    G_2048: process.env.G_2048,
+    API: process.env.API,
+    CDN: process.env.CDN,
+    COOP_API: process.env.COOP_API,
+    COOP_STATUS: process.env.COOP_STATUS,
+    CHAT: process.env.CHAT,
+    DIGIT: process.env.DIGIT,
+    DOC_COOPBOT: process.env.DOC_COOPBOT,
+    DOCS: process.env.DOCS,
+    DONUT: process.env.DONUT,
+    DRAWIO_PLUGIN: process.env.DRAWIO_PLUGIN,
+    FLOWERS: process.env.FLOWERS,
+    GEMSYNC: process.env.GEMSYNC,
+    GFT: process.env.GFT,
+    GITSITE: process.env.GITSITE,
+    LEBONCHAR: process.env.LEBONCHAR,
+    LOGGER: process.env.LOGGER,
+    LOGS: process.env.LOGS,
+    LOGVAULT: process.env.LOGVAULT,
+    LYAH: process.env.LYAH,
+    MINIFY: process.env.MINIFY,
+    MN: process.env.MN,
+    MONITORING: process.env.MONITORING,
+    MORPION: process.env.MORPION,
+    NITROGEN: process.env.NITROGEN,
+    OLD_DATABASE: process.env.OLD_DATABASE,
+    PASSWORD: process.env.PASSWORD,
+    PHP: process.env.PHP,
+    PLANNING: process.env.PLANNING,
+    PING: process.env.PING,
+    PORTFOLIO: process.env.PORTFOLIO,
+    PYTHON_API: process.env.PYTHON_API,
+    README: process.env.README,
+    TIMESTAMP: process.env.TIMESTAMP,
+    TERMINAL: process.env.TERMINAL,
+    VALENTINE: process.env.VALENTINE,
+    WRKIT: process.env.WRKIT,
+    ZPKI: process.env.ZPKI,
+
+    PATCH: envList('PATCH'),
+    RECENT: envList('RECENT'),
+    NEW: envList('NEW'),
+    DOMAINS: envList('DOMAINS'),
+
+    STATS1: process.env.STATS1,
+    STATS2: process.env.STATS2,
+    STATS3: process.env.STATS3,
+    STATS4: process.env.STATS4,
+    TAG: process.env.TAG,
+    ACTIVE: process.env.ACTIVE === 'true',
+};

package/src/config/versions.ts

@@ -0,0 +1,80 @@
+import * as apiv3 from '../modules/v3.js';
+import * as apiv4 from '../modules/v4.js';
+
+export interface Endpoint {
+    name: string;
+    path?: string;
+    children?: Record<string, string>;
+}
+
+export interface VersionConfig {
+    endpoints: {
+        get: Endpoint[];
+        post: Endpoint[];
+    };
+    modules: typeof apiv3 | typeof apiv4;
+}
+
+const v1 = {
+    get: [
+        { name: 'algorithms', path: '/algorithms?method={algorithm}&value={value}(&value2={value2})' },
+        { name: 'captcha', path: '/captcha?text={text}' },
+        { name: 'color', path: '/color' },
+        { name: 'convert', path: '/convert?value={value}&from={unit}&to={unit}' },
+        { name: 'domain', path: '/domain' },
+        { name: 'infos', path: '/infos' },
+        { name: 'personal', path: '/personal' },
+        { name: 'qrcode', path: '/qrcode?url={URL}' },
+        { name: 'username', path: '/username' },
+        { name: 'website', path: '/website' },
+    ],
+    post: [{ name: 'token', path: '/token' }],
+};
+
+const v2 = {
+    get: [...v1.get, { name: 'chat', path: '/chat' }],
+    post: [
+        ...v1.post,
+        {
+            name: 'chat',
+            children: {
+                chat: '/chat',
+                private: '/chat/private',
+            } as Record<string, string>,
+        },
+        { name: 'hash', path: '/hash' },
+        {
+            name: 'tic_tac_toe',
+            children: {
+                tic_tac_toe: '/tic-tac-toe',
+                fetch: '/tic-tac-toe/fetch',
+                list: '/tic-tac-toe/list',
+            } as Record<string, string>,
+        },
+        { name: 'token', path: '/token' },
+    ],
+};
+
+const v3 = {
+    get: [
+        ...v2.get,
+        { name: 'levenshtein', path: '/levenshtein?str1={string}&str2={string}' },
+        {
+            name: 'time',
+            path: '/time(?type={type}&start={timestamp}&end={timestamp}&format={format}&timezone={timezone})',
+        },
+    ],
+    post: [...v2.post, { name: 'hyperplanning', path: '/hyperplanning' }],
+};
+
+const v4 = {
+    get: [...v3.get],
+    post: [...v3.post],
+};
+
+export const versions: Record<string, VersionConfig> = {
+    v1: { endpoints: v1, modules: apiv3 },
+    v2: { endpoints: v2, modules: apiv3 },
+    v3: { endpoints: v3, modules: apiv3 },
+    v4: { endpoints: v4, modules: apiv4 },
+};

package/src/constants.ts

@@ -0,0 +1,28 @@
+export const MAX_LOG_ENTRIES = 1000;
+export const RATE_LIMIT_WINDOW = 10_000;
+export const RATE_LIMIT_MAX = 50;
+export const SESSION_TTL = 3_600_000;
+export const GAME_CLEANUP_TTL = 600_000;
+export const GITHUB_CACHE_TTL = 600_000;
+export const MIN_TOKEN_LENGTH = 12;
+export const MAX_TOKEN_LENGTH = 4096;
+export const MAX_FACTORIAL = 170;
+export const MAX_GCD_VALUE = 100_000;
+export const MAX_PRIME_LIST = 10_000;
+export const MAX_LEVENSHTEIN_LENGTH = 1000;
+export const MAX_STRING_LENGTH = 1000;
+export const MIN_TEMPERATURE = -273.15;
+export const MAX_TEMPERATURE = 1_000_000;
+export const DOCS_URL = 'https://docs.sylvain.sh';
+export const DEFAULT_PORT = 3000;
+
+export const STATUS_MESSAGES: Record<number, string> = {
+    400: 'Bad Request',
+    401: 'Unauthorized',
+    404: 'Not Found',
+    405: 'Method Not Allowed',
+    429: 'Too Many Requests',
+    500: 'Internal Server Error',
+};
+
+export const START_TIME = Date.now();

package/src/middleware/cors.ts

@@ -0,0 +1,17 @@
+import cors from 'cors';
+import express, { type Express } from 'express';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+export function setupCors(app: Express): void {
+    app.set('trust proxy', 1);
+    app.use(cors({ methods: ['GET', 'POST'] }));
+    app.use(express.urlencoded({ extended: true }));
+    app.use(express.json());
+
+    app.use('/favicon.ico', express.static(join(__dirname, '..', '..', 'src', 'favicon.ico')));
+    app.use('/robots.txt', express.static(join(__dirname, '..', '..', 'robots.txt')));
+}

package/src/middleware/error.ts

@@ -0,0 +1,7 @@
+import type { Request, Response, NextFunction } from 'express';
+import { error } from '../utils/response.js';
+
+export function errorHandler(err: Error, _req: Request, res: Response, _next: NextFunction): void {
+    console.error(err.stack);
+    error(res, 500, err.message);
+}

package/src/middleware/json.ts

@@ -0,0 +1,9 @@
+import type { Request, Response, NextFunction } from 'express';
+
+export function jsonResponseMiddleware(_req: Request, res: Response, next: NextFunction): void {
+    res.setHeader('Content-Type', 'application/json');
+    res.jsonResponse = (data: unknown) => {
+        res.send(JSON.stringify(data, null, 2));
+    };
+    next();
+}

package/src/middleware/logger.ts

@@ -0,0 +1,31 @@
+import { createLogger } from '@20syldev/logger.ts';
+import type { Request, Response, NextFunction } from 'express';
+import { MAX_LOG_ENTRIES } from '../constants.js';
+
+export const logger = createLogger({
+    maxEntries: MAX_LOG_ENTRIES,
+    console: true,
+    theme: 'colored',
+});
+
+export function loggerMiddleware(req: Request, res: Response, next: NextFunction): void {
+    if (req.method === 'HEAD') {
+        next();
+        return;
+    }
+    if (req.originalUrl === '/logs') {
+        next();
+        return;
+    }
+
+    const startTime = Date.now();
+    const platform = (req.headers['sec-ch-ua-platform'] as string)?.replace(/"/g, '');
+
+    res.on('finish', () => {
+        const status = res.statusCode === 304 ? 200 : res.statusCode;
+        const duration = `${Date.now() - startTime}ms`;
+
+        logger.log({ method: req.method, url: req.originalUrl, status, duration, platform });
+    });
+    next();
+}