@p47h/vault-js 0.9.0 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p47h/vault-js",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Secure, local-first cryptographic storage for browser environments. Argon2id + XChaCha20Poly1305 + Ed25519 backed by WASM.",
   "keywords": [
     "security",
@@ -34,6 +34,7 @@
   "files": [
     "dist",
     "wasm",
+    "scripts/postinstall.js",
     "LICENSE",
     "README.md"
   ],

package/scripts/postinstall.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+
+/**
+ * P47H Vault JS - Postinstall Helper
+ * Este script ayuda al usuario a copiar los binarios WASM necesarios
+ * a su carpeta de assets públicos para que el navegador pueda cargarlos.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// Reconstruir __dirname para ESM
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Colores para la consola (DX amigable)
+const CYAN = '\x1b[36m';
+const RESET = '\x1b[0m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+
+// Rutas relativas dentro del paquete instalado
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const WASM_SOURCE_DIR = path.join(PACKAGE_ROOT, 'wasm');
+
+// Detectar directorio del proyecto del usuario
+const USER_PROJECT_ROOT = process.env.INIT_CWD || path.resolve(PACKAGE_ROOT, '../../..');
+
+console.log(`${CYAN}
+╔══════════════════════════════════════════════════════════════╗
+║                 P47H VAULT JS - SETUP                        ║
+╚══════════════════════════════════════════════════════════════╝
+${RESET}`);
+
+function main() {
+  // 1. Verificar que los binarios fuente existen
+  if (!fs.existsSync(WASM_SOURCE_DIR)) {
+    // Si estamos en desarrollo local, tal vez no se ha compilado aún el wasm
+    // No fallamos el install, solo avisamos.
+    console.warn(`${YELLOW}[Warn] Source wasm directory not found at: ${WASM_SOURCE_DIR}${RESET}`);
+    console.warn(`       If you are developing the library, run 'npm run build' first.`);
+    return;
+  }
+
+  // 2. Intentar detectar carpetas públicas comunes
+  const potentialDirs = [
+    'public',   // Vite, Next.js, Create React App
+    'static',   // Gatsby
+    'assets',   // Frameworks personalizados
+    'wwwroot'   // .NET
+  ];
+
+  let targetBaseDir = null;
+
+  for (const dir of potentialDirs) {
+    const attemptPath = path.join(USER_PROJECT_ROOT, dir);
+    if (fs.existsSync(attemptPath)) {
+      targetBaseDir = attemptPath;
+      break;
+    }
+  }
+
+  // 3. Ejecutar copia o mostrar instrucciones
+  if (targetBaseDir) {
+    const targetWasmDir = path.join(targetBaseDir, 'wasm');
+    console.log(`Detected public directory: ${GREEN}${targetBaseDir}${RESET}`);
+    copyFiles(WASM_SOURCE_DIR, targetWasmDir);
+  } else {
+    // No mostramos error rojo, solo instrucciones amarillas para no asustar
+    // si es un entorno donde no aplica (ej: CI/CD sin frontend)
+    printManualInstructions();
+  }
+}
+
+function copyFiles(srcDir, destDir) {
+  try {
+    if (!fs.existsSync(destDir)) {
+      fs.mkdirSync(destDir, { recursive: true });
+    }
+
+    let copiedCount = 0;
+    const files = fs.readdirSync(srcDir);
+
+    for (const file of files) {
+      const srcFile = path.join(srcDir, file);
+      const destFile = path.join(destDir, file);
+      
+      fs.copyFileSync(srcFile, destFile);
+      copiedCount++;
+    }
+
+    console.log(`${GREEN}✔ Successfully copied ${copiedCount} WASM files to:${RESET}`);
+    console.log(`  ${destDir}`);
+    console.log(`\n${CYAN}Ready to rock! 🚀${RESET}`);
+
+  } catch (err) {
+    console.error(`${RED}Failed to copy files automatically:${RESET}`, err.message);
+    printManualInstructions();
+  }
+}
+
+function printManualInstructions() {
+  console.log(`
+${YELLOW}ℹ️  MANUAL SETUP REQUIRED${RESET}
+
+To ensure P47H Vault works correctly, please copy the WASM binaries
+from the package to your application's public assets folder.
+
+${CYAN}Source:${RESET}      node_modules/@p47h/vault-js/wasm/
+${CYAN}Destination:${RESET} [Your Public Folder]/wasm/
+`);
+}
+
+main();