🧩 jtn-sdk

🗂️ SDK oficial para trabajar con el nuevo formato de imagen .JTN (Jeison Trackable Network).

📌 ¿Qué es .jtn?

.jtn es un nuevo formato de archivo que encapsula imágenes, videos u otros medios con metadatos invisibles, identificadores únicos y trazabilidad hacia un servidor de control.

Este SDK te permite:

• 📦 Convertir un archivo .jpg, .png, .mp4 o .pdf a .jtn
• 🔓 Extraer los archivos originales y metadatos desde un .jtn
• 📡 Enviar eventos de visualización a un servidor remoto

🚀 Instalación

Instálalo desde NPM:

npm install jtn-sdk

🔧 Uso básico

import { convertToJTN, extractFromJTN } from "jtn-sdk";

// Convertir archivo a .jtn
const archivoJTN = await convertToJTN({
  file: archivoOriginal,
  metadata: {
    creator: "Jeison Rojas",
    project: "ETV",
    trackingURL: "https://mi-servidor.com/report"
  }
});

// Extraer contenido
const resultado = await extractFromJTN(archivoJTN);
console.log(resultado.file, resultado.metadata);

📂 Métodos disponibles

convertToJTN({ file, metadata }): Promise<Blob>

Convierte un archivo a formato .jtn incluyendo metadatos y firma opcional.

extractFromJTN(file: Blob | File): Promise<{ file: Blob, metadata: any }>

Extrae el archivo original y los metadatos de un archivo .jtn.

⚙️ Uso desde la consola (jtn CLI)

Una vez instalado globalmente, puedes usar el comando jtn desde cualquier carpeta del sistema.

🚀 Comandos disponibles

| Comando | Descripción | |--------|-------------| | jtn compress <archivo> | Comprime un archivo e inserta metadatos invisibles compatibles con el formato .JTN. | | jtn decompress <archivo> | Extrae el contenido y los metadatos incrustados desde un archivo .JTN o compatible. | | jtn info <archivo> | Muestra información técnica y metadatos cifrados o visibles del archivo. |

📦 Ejemplo: Comprimir una imagen

jtn compress imagen.jpg

📌 Esto genera un nuevo archivo comprimido, por ejemplo: imagen.jtn.jpg, que contiene identificadores invisibles y trazabilidad incrustada.

📂 Ejemplo: Descomprimir

jtn decompress imagen.jtn.jpg

📌 Recupera el archivo original (sin marcas de rastreo) o los metadatos asociados.

🔍 Ver información de un archivo

jtn info imagen.jtn.jpg

📌 Muestra:

• Identificador único
• Hash de rastreo
• Timestamp de creación
• Dirección del servidor de rastreo
• Si el archivo ha sido modificado

🔧 Requisitos

• Node.js v18+
• Haber instalado el SDK:

npm install -g .

🐞 Errores comunes

| Error | Causa | Solución | |-------|--------|----------| | command not found: use strict | Falta la línea #!/usr/bin/env node | Asegúrate de que tu archivo cli.js la tenga al inicio | | Permission denied | El archivo no tiene permisos de ejecución | Corre chmod +x dist/cli.js | | jtn: command not found | No está instalado globalmente o no está en tu PATH | Corre npm install -g . dentro del proyecto |

🔗 Integración con ETV

Este SDK es compatible con la librería etv, que renderiza medios con soporte nativo para .jtn.

📄 Licencia

MIT © 2025 Jeison Rojas