neekuro 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [2.3.0] - 15-09-2026
+
+### Added
+- Nuevas subcategorías de `action`: `handhold`, `highfive`, `read` y `wave`.
+- Nuevas subcategorías de `reaction`: `disgust`, `facepalm`, `happy`, `love`, `nervous`, `shrug` y `surprised`.
+
+### Fixed
+- El timeout de 10 segundos de las imágenes remotas ahora también cubre la lectura del cuerpo, no solo las cabeceras.
+- Las respuestas descartadas (redirecciones, errores HTTP o formatos inválidos) liberan su conexión.
+- El User-Agent de descarga de imágenes refleja la versión real del paquete.
+- Declaraciones TypeScript: `APIError.determineMessage` es estático, se añade `APIError.fromNetworkError` y se corrige la resolución por defecto documentada (1140 × 520) y el ejemplo de `User.token()`.
+- `SFW` muestra `Desconocido` cuando el anime llega como `Unknown`, no solo cuando viene vacío.
+- `SFW` descarta las URL repetidas de una subcategoría: pesaban doble en el sorteo y podían salir dos veces seguidas.
+
+### Compatibility
+- Solo se añaden subcategorías; las existentes no cambian.
+
 ## [2.2.0] - 28-08-2026
 
 ### Added
@@ -34,18 +51,18 @@
 - Se conserva la API encadenable de `Welcome`.
 - `Error` continúa disponible como alias de `NekoError`.
 - Las URLs HTTP de imágenes dejan de aceptarse; deben utilizar HTTPS.
-
-## [2.0.3] - 07-04-2025
-
-### Fixed
-- **Error de Importaciones**
-  - Corregido el error de importaciones require('...')`
-  - Causaba que no se pudiera usar el paquete
-  - Se uso el mismo nombre para todas las importaciones respecto al archivo
-  - Afectaba a todos los usuarios que hacian uso de la api
-
-**Impacto**: 
-- La actualizacion prevee que resuelva el error
-- No requiere cambios en implementaciones existentes
-
+
+## [2.0.3] - 07-04-2025
+
+### Fixed
+- **Error de Importaciones**
+  - Corregido el error de importaciones require('...')`
+  - Causaba que no se pudiera usar el paquete
+  - Se uso el mismo nombre para todas las importaciones respecto al archivo
+  - Afectaba a todos los usuarios que hacian uso de la api
+
+**Impacto**: 
+- La actualizacion prevee que resuelva el error
+- No requiere cambios en implementaciones existentes
+
 Commit: (1e7380a)

package/README.md

@@ -1,73 +1,73 @@
-<center> <h1>NeeKuro</h1> </center>
-<center>de <b>Kmz Kuro</b> en nombre de <b>NexaTDC</b></center>
-<center>creada apartir de <b>cacao_nekoapi</b> y <b>nekoapi.beta</b> en npm.js</center>
-<br>
-<center>
-<img alt="NPM Version" src="https://img.shields.io/npm/v/neekuro?logo=npm&style=flat&color=0d8973">
-<img alt="Downloads" src="https://img.shields.io/npm/dw/neekuro?style=flat&color=bf9308&label=Descargas">
-<img alt="Typescript" src="https://img.shields.io/badge/declaraciones-typescript-blue?logo=typescript">
-<img alt="NPM Version" src="https://img.shields.io/badge/node%20version-%3E=20.12.2-489248?logo=nodedotjs">
-</center>
-
-### ¿Qué es "NeeKuro"?
-
-NeeKuro es una biblioteca de imágenes con temática de anime para bots de Discord e imagenes de bienvenida.
-
-Principalmente se creo con el fin de ser unicamente para <b>Maple Bot</b>. Sin embargo, desde que se decidio hacer a Maple de codigo publico, tambien se decidio que tanto su API como paquete fuesen libres.
-
-> notas: el paquete puede contener errores ya que se encuentra en fase beta, la API se hostea de manera gratuita por lo que las solicitudes no siempre pueden estar disponibles.
-
-## Instalacion
-
-```sh
-npm install neekuro
-```
-
-## Ejemplos
-
-NeeKuro es un paquete que requiere de un token para llevar a cabo sus sollicitudes, por lo que requieres de ir a la [API Oficial](https://www.nexatdc.work.gd/api/) para poder generar un token.
-
-### primeros pasos
-1 - Instanciamiento de usuario y establecimiento del token.<br>Este paso se requiere ya que con ello se establece globalmente el token por el paquete
-<hr>
-
-```javascript
-require('dotenv').config();
-// importacion del paquete neekuro
-const neekuro = require('neekuro');
-
-// instanciamiento del usuario
-const user = new neekuro.User();
-
-// establecimiento del token
-user.token(process.env['ApiToken'])
-```
-<hr>
-
-#### Peticion de imagenes simple
-Una vez estableciste el token puedes comenzar a pedir imagenes
-
-```javascript
-
-const neekuro = require('neekuro');
-
-/**
- * Codigo de usuario
- */
-
-// es necesario escribir todo siempre dentro de una funcion asincrona
+<center> <h1>NeeKuro</h1> </center>
+<center>de <b>Kmz Kuro</b> en nombre de <b>NexaTDC</b></center>
+<center>creada apartir de <b>cacao_nekoapi</b> y <b>nekoapi.beta</b> en npm.js</center>
+<br>
+<center>
+<img alt="NPM Version" src="https://img.shields.io/npm/v/neekuro?logo=npm&style=flat&color=0d8973">
+<img alt="Downloads" src="https://img.shields.io/npm/dw/neekuro?style=flat&color=bf9308&label=Descargas">
+<img alt="Typescript" src="https://img.shields.io/badge/declaraciones-typescript-blue?logo=typescript">
+<img alt="NPM Version" src="https://img.shields.io/badge/node%20version-%3E=20.12.2-489248?logo=nodedotjs">
+</center>
+
+### ¿Qué es "NeeKuro"?
+
+NeeKuro es una biblioteca de imágenes con temática de anime para bots de Discord e imagenes de bienvenida.
+
+Principalmente se creo con el fin de ser unicamente para <b>Maple Bot</b>. Sin embargo, desde que se decidio hacer a Maple de codigo publico, tambien se decidio que tanto su API como paquete fuesen libres.
+
+> notas: el paquete puede contener errores ya que se encuentra en fase beta, la API se hostea de manera gratuita por lo que las solicitudes no siempre pueden estar disponibles.
+
+## Instalacion
+
+```sh
+npm install neekuro
+```
+
+## Ejemplos
+
+NeeKuro es un paquete que requiere de un token para llevar a cabo sus sollicitudes, por lo que requieres de ir a la [API Oficial](https://www.nexatdc.work.gd/api/) para poder generar un token.
+
+### primeros pasos
+1 - Instanciamiento de usuario y establecimiento del token.<br>Este paso se requiere ya que con ello se establece globalmente el token por el paquete
+<hr>
+
+```javascript
+require('dotenv').config();
+// importacion del paquete neekuro
+const neekuro = require('neekuro');
+
+// instanciamiento del usuario
+const user = new neekuro.User();
+
+// establecimiento del token
+user.token(process.env['ApiToken'])
+```
+<hr>
+
+#### Peticion de imagenes simple
+Una vez estableciste el token puedes comenzar a pedir imagenes
+
+```javascript
+
+const neekuro = require('neekuro');
+
+/**
+ * Codigo de usuario
+ */
+
+// es necesario escribir todo siempre dentro de una funcion asincrona
 async function ObtenerImagen() {
-    // obtenemos un gif con el metodo getGif de SFW
-    const cuddle = await neekuro.SFW.getGif('action', 'cuddle');
-    
-    // imprimimos la url y el anime del gif
-    console.log(cuddle.getUrl(), cuddle.getAnime())
-}
-
-// ejecutamos la funcion
+    // obtenemos un gif con el metodo getGif de SFW
+    const cuddle = await neekuro.SFW.getGif('action', 'cuddle');
+    
+    // imprimimos la url y el anime del gif
+    console.log(cuddle.getUrl(), cuddle.getAnime())
+}
+
+// ejecutamos la funcion
 ObtenerImagen();
-
-// nota: no te aguites por el gif y subcategoria, todo viene en documentado con typescript, solo tienes que completar los pasos :)
+
+// nota: no te aguites por el gif y subcategoria, todo viene en documentado con typescript, solo tienes que completar los pasos :)
 ```
 
 `getGif()` selecciona una imagen nuevamente en cada llamada. Internamente, NeeKuro
@@ -104,25 +104,25 @@ neekuro.SFW.setBaseURL('https://api.example.com/api/sfw');
 ```
 
 #### Ejemplo de imagenes de bienvenida
-Las imagenes de bienvenida son otra de las alternativas que otorga NeeKuro, puedes hacer una imagen de la siguiente manera:
-```javascript
-// obtenemos directamente la clase del paquete
-const { Welcome } = require('neekuro');
-const fs = require('fs');
-
-// Configuración básica, añade un avatar titulo y descripción
-const welcome = new Welcome()
-  .setAvatar('https://ejemplo.com/avatar.jpg')
-  .setTitle('¡Bienvenido!')
-  .setDescription('Al servidor de Discord');
-
-// Genera y guarda la imagen
+Las imagenes de bienvenida son otra de las alternativas que otorga NeeKuro, puedes hacer una imagen de la siguiente manera:
+```javascript
+// obtenemos directamente la clase del paquete
+const { Welcome } = require('neekuro');
+const fs = require('fs');
+
+// Configuración básica, añade un avatar titulo y descripción
+const welcome = new Welcome()
+  .setAvatar('https://ejemplo.com/avatar.jpg')
+  .setTitle('¡Bienvenido!')
+  .setDescription('Al servidor de Discord');
+
+// Genera y guarda la imagen
 welcome.build()
-  .then(image => fs.writeFileSync('bienvenida.png', image))
-  .then(() => console.log('Imagen creada correctamente!'))
-  .catch(err => console.error('Error:', err.message));
-
-// nota: como antes, todo viene bien documentado en el paquete, solo sigue los pasos y explora por ti ;3
+  .then(image => fs.writeFileSync('bienvenida.png', image))
+  .then(() => console.log('Imagen creada correctamente!'))
+  .catch(err => console.error('Error:', err.message));
+
+// nota: como antes, todo viene bien documentado en el paquete, solo sigue los pasos y explora por ti ;3
 ```
 
 Las imágenes remotas deben usar HTTPS. El paquete limita cada descarga a 10 MB,
@@ -158,34 +158,34 @@ pnpm run pack:check
 
 `pnpm run check` ejecuta las pruebas funcionales locales y comprueba las
 declaraciones TypeScript. Ninguna de estas pruebas consulta la API remota.
-<hr>
-<center>
-<p>Resultado esperado</p>
-<img src="./sources/assets/example.png" style="width: 60%; max-width: 500px;" alt="Texto alternativo">
-</center>
-
-## Contenido
-
-Lo siguente es lo que contiene (o contendra) el paquete
-
-| Categoria | Descripción | |
-|-|-|-|
-| Sfw | Contenido de roleplay no nsfw | en desarrollo
-| Nsfw | Contenido +18 general y roleplay | no comenzada
-
-## Finalmente....
-
-Tanto la API, paquete y bot se encuentran en desarrollo, ante todo te pedimos la mayor de las paciencias, te aseguraremos que el resultado te gustará! :'3
-
-Finalmente te agradecemos tu preferencia y esperamos haber cumplido tus espectativas ;)
-<br><br><hr>
-
-### que se tiene planeado?
-
-Principalmente terminaremos la categoria acción y reacción para tener la primer subida a NPM de este paquete y asi finalmente tener terminada la categoria SFW. <br> Sin embargo una de las problematicas que se nos presentan son buscar los gifs para la API asi como sus animes <b>es un proceso lento...</b> y agobiante...
-<br>Por eso ahora mas que nunca queremos que nos apoyes en <b>NexaTDC</b>! Con el fin de poder dar al publico lo mas pronto posible los servicios que Maple Bot ofrece.
-
-<b><i>No es para mi, es para la comunidad... Si no es para la comunidad, no es para nadie...</i></b>
-<i>- NexaTDC</i>
-<br><br><br><br>
-CC. Creative Commons 2025 - @CacaoNk0027
+<hr>
+<center>
+<p>Resultado esperado</p>
+<img src="./sources/assets/example.png" style="width: 60%; max-width: 500px;" alt="Texto alternativo">
+</center>
+
+## Contenido
+
+Lo siguente es lo que contiene (o contendra) el paquete
+
+| Categoria | Descripción | |
+|-|-|-|
+| Sfw | Contenido de roleplay no nsfw | en desarrollo
+| Nsfw | Contenido +18 general y roleplay | no comenzada
+
+## Finalmente....
+
+Tanto la API, paquete y bot se encuentran en desarrollo, ante todo te pedimos la mayor de las paciencias, te aseguraremos que el resultado te gustará! :'3
+
+Finalmente te agradecemos tu preferencia y esperamos haber cumplido tus espectativas ;)
+<br><br><hr>
+
+### que se tiene planeado?
+
+Principalmente terminaremos la categoria acción y reacción para tener la primer subida a NPM de este paquete y asi finalmente tener terminada la categoria SFW. <br> Sin embargo una de las problematicas que se nos presentan son buscar los gifs para la API asi como sus animes <b>es un proceso lento...</b> y agobiante...
+<br>Por eso ahora mas que nunca queremos que nos apoyes en <b>NexaTDC</b>! Con el fin de poder dar al publico lo mas pronto posible los servicios que Maple Bot ofrece.
+
+<b><i>No es para mi, es para la comunidad... Si no es para la comunidad, no es para nadie...</i></b>
+<i>- NexaTDC</i>
+<br><br><br><br>
+CC. Creative Commons 2025 - @CacaoNk0027

package/package.json

@@ -1,69 +1,69 @@
-{
-  "$schema": "https://json.schemastore.org/package.json",
-  "name": "neekuro",
-  "version": "2.2.0",
-  "description": "Una biblioteca de imágenes con temática de anime para bots de Discord.",
-  "main": "sources/main/index.js",
-  "types": "sources/typings/index.d.ts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./sources/typings/index.d.ts",
-        "default": "./sources/main/index.js"
-      },
-      "require": {
-        "types": "./sources/typings/index.d.ts",
-        "default": "./sources/main/index.js"
-      }
-    }
-  },
-  "directories": {
-    "test": "test"
-  },
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "neekuro",
+  "version": "2.3.0",
+  "description": "Una biblioteca de imágenes con temática de anime para bots de Discord.",
+  "main": "sources/main/index.js",
+  "types": "sources/typings/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./sources/typings/index.d.ts",
+        "default": "./sources/main/index.js"
+      },
+      "require": {
+        "types": "./sources/typings/index.d.ts",
+        "default": "./sources/main/index.js"
+      }
+    }
+  },
+  "directories": {
+    "test": "test"
+  },
   "files": [
     "sources",
     "README.md",
     "CHANGELOG.md"
   ],
-  "contributors": [
-    "cacao0027 <kmzkuro@gmail.com>"
-  ],
-  "author": "cacao0027 <kmzkuro@gmail.com>",
-  "keywords": [
-    "anime",
-    "acción",
-    "gifs",
-    "imagenes",
-    "nsfw",
-    "sfw",
-    "discord",
-    "action",
-    "images"
-  ],
-  "license": "ISC",
-  "packageManager": "pnpm@11.23.0",
-  "scripts": {
-    "test": "node --test test/*.test.js",
-    "check": "node --check sources/main/index.js && node --test test/*.test.js && tsc -p test/tsconfig.json",
-    "pack:check": "npm pack --dry-run"
-  },
-  "engines": {
-    "node": ">=20.12.2"
-  },
-  "dependencies": {
-    "canvas": "^3.1.0",
-    "hex-color-regex": "^1.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^24.0.0",
-    "typescript": "^5.9.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/CacaoNk0027/neekuro_package.git"
-  },
-  "bugs": {
-    "url": "https://github.com/CacaoNk0027/neekuro_package/issues"
-  },
-  "homepage": "https://github.com/CacaoNk0027/neekuro_package#readme"
-}
+  "contributors": [
+    "cacao0027 <kmzkuro@gmail.com>"
+  ],
+  "author": "cacao0027 <kmzkuro@gmail.com>",
+  "keywords": [
+    "anime",
+    "acción",
+    "gifs",
+    "imagenes",
+    "nsfw",
+    "sfw",
+    "discord",
+    "action",
+    "images"
+  ],
+  "license": "ISC",
+  "packageManager": "pnpm@11.23.0",
+  "scripts": {
+    "test": "node --test test/*.test.js",
+    "check": "node --check sources/main/index.js && node --test test/*.test.js && tsc -p test/tsconfig.json",
+    "pack:check": "npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=20.12.2"
+  },
+  "dependencies": {
+    "canvas": "^3.1.0",
+    "hex-color-regex": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CacaoNk0027/neekuro_package.git"
+  },
+  "bugs": {
+    "url": "https://github.com/CacaoNk0027/neekuro_package/issues"
+  },
+  "homepage": "https://github.com/CacaoNk0027/neekuro_package#readme"
+}

package/sources/classes/SFW.js

@@ -174,9 +174,15 @@ async function requestGifList(category, gif, token) {
         throw new NekoError('EmptyResponse', `La API no devolvió GIF para ${category}/${gif}`);
     }
 
-    return response.data.map((item, index) => normalizeGif(item, category, gif, index));
+    const items = response.data.map((item, index) => normalizeGif(item, category, gif, index));
+    return removeDuplicateURLs(items);
 }
 
+const UNKNOWN_ANIME = 'Desconocido';
+// Valores que la base de datos usa para "sin dato". Se tratan igual que un
+// campo vacío para no mostrar, por ejemplo, "Unknown" en un embed en español.
+const PLACEHOLDER_ANIME = new Set(['unknown', 'desconocido']);
+
 /**
  * @param {unknown} item
  * @param {string} category
@@ -189,11 +195,26 @@ function normalizeGif(item, category, gif, index) {
         throw new NekoError('InvalidResponse', `El GIF ${index} de ${category}/${gif} no contiene una URL válida`);
     }
 
+    const anime = typeof item.anime === 'string' ? item.anime.trim() : '';
     return Object.freeze({
         url: item.url.trim(),
-        anime: typeof item.anime === 'string' && item.anime.trim()
-            ? item.anime.trim()
-            : 'Desconocido'
+        anime: anime && !PLACEHOLDER_ANIME.has(anime.toLowerCase()) ? anime : UNKNOWN_ANIME
+    });
+}
+
+/**
+ * Conserva la primera aparición de cada URL. Una URL repetida pesa doble en el
+ * sorteo y puede salir dos veces seguidas, porque la selección evita repetir
+ * posiciones, no URLs.
+ * @param {GifData[]} items
+ * @returns {GifData[]}
+ */
+function removeDuplicateURLs(items) {
+    const seen = new Set();
+    return items.filter(item => {
+        if (seen.has(item.url)) return false;
+        seen.add(item.url);
+        return true;
     });
 }
 

package/sources/classes/errors/APIError.js

@@ -1,62 +1,62 @@
-'use strict';
-
-/**
- * @typedef {import('../../typings').ApiResponse} ApiResponse
+'use strict';
+
+/**
+ * @typedef {import('../../typings').ApiResponse} ApiResponse
  * @typedef {{url?: string, status?: number}} ResponseLike
- */
-
-/**
- * Clase APIError
- * Errores personalizados respecto a la api rest
- * @extends Error
- */
-class APIError extends Error {
-    /**
-     * Crea la instancia del error
-     * @param {string} endpoint la ruta a la que se realizo la peticion
+ */
+
+/**
+ * Clase APIError
+ * Errores personalizados respecto a la api rest
+ * @extends Error
+ */
+class APIError extends Error {
+    /**
+     * Crea la instancia del error
+     * @param {string} endpoint la ruta a la que se realizo la peticion
      * @param {ResponseLike} response respuesta HTTP o representación de un error de red
-     * @param {ApiResponse} data respuesta de la api
-     */
+     * @param {ApiResponse} data respuesta de la api
+     */
     constructor(endpoint, response, data) {
         super(APIError.determineMessage(data));
-        
-        this.name = `NekoREST Error [${endpoint}]`
-        /**
-         * @type {string}
-         */
-        this.url = response?.url ?? 'unknown';
-
-        /**
-         * @type {number}
-         */
+        
+        this.name = `NekoREST Error [${endpoint}]`
+        /**
+         * @type {string}
+         */
+        this.url = response?.url ?? 'unknown';
+
+        /**
+         * @type {number}
+         */
         this.statusCode = Number.parseInt(response?.status ?? 500, 10);
-
-        /**
-         * @type {ApiResponse}
-         */
-        this.data = data
-
-    }
-
-    /**
-     * Determina el mensaje del error basado en el codigo de la api
-     * @param {ApiResponse} response respuesta de la api
-     * @returns {string} mensaje de error
-     */
+
+        /**
+         * @type {ApiResponse}
+         */
+        this.data = data
+
+    }
+
+    /**
+     * Determina el mensaje del error basado en el codigo de la api
+     * @param {ApiResponse} response respuesta de la api
+     * @returns {string} mensaje de error
+     */
     static determineMessage(response = {}) {
-        if(response.code === 403) {
-            return 'TOKEN ERROR: el token que haz proporcionado es invalido'
-        } else 
-        if(response.code === 401) {
-            return 'TOKEN ERROR: no se proporciono un token'
-        } else {
-            return response.message ?? 'descripcion no dada'
-        }
+        if(response.code === 403) {
+            return 'TOKEN ERROR: el token que haz proporcionado es invalido'
+        } else 
+        if(response.code === 401) {
+            return 'TOKEN ERROR: no se proporciono un token'
+        } else {
+            return response.message ?? 'descripcion no dada'
+        }
     }
 
     static fromNetworkError(endpoint, url, message) {
         return new APIError(endpoint, { url, status: 503 }, { code: 503, message });
     }
 }
-
+
 module.exports = APIError

package/sources/classes/errors/Error.js

@@ -1,26 +1,26 @@
-'use strict';
-
-/**
- * Clase de erorres para la API
- * @extends Error
- */
-class NekoError extends Error {
-    /**
-     * Crea una instancia para errores del paquete
-     * @param {string} name Corresponde al nombre del error
-     * @param {string} message Mensaje de error
-     */
+'use strict';
+
+/**
+ * Clase de erorres para la API
+ * @extends Error
+ */
+class NekoError extends Error {
+    /**
+     * Crea una instancia para errores del paquete
+     * @param {string} name Corresponde al nombre del error
+     * @param {string} message Mensaje de error
+     */
     constructor(name, message) {
         super(message);
-        
-        this.name = `NeeKuro Error [${name}]`
-        
-        /**
-         * @type {string}
-         */
+        
+        this.name = `NeeKuro Error [${name}]`
+        
+        /**
+         * @type {string}
+         */
         this.message = message
         Error.captureStackTrace?.(this, NekoError);
-    }
-}
-
+    }
+}
+
 module.exports = NekoError