uuid NPM (Cómo funciona para desarrolladores)

Características principales

1. Confomidad con RFC4122: El paquete UUID admite la creación de UUIDs que cumplen con RFC4122, asegurando que sean únicos y estandarizados universalmente.

2. Múltiples versiones de UUID: Sopota varias versiones de UUIDs, incluyendo:

   • v1: UUIDs basados en marcas de tiempo.
   • v3: UUIDs basados en el espacio de nombres utilizando hashing MD5.
   • v4: UUIDs generados aleatoiamente.
   • v5: UUIDs basados en el espacio de nombres utilizando hashing SHA-1.
   • v6: UUIDs basados en marcas de tiempo con campos reodenados para mejoar la clasificación1.
3. Sopote multiplatafoma: El paquete funciona en diferentes entonos, incluidos Node.js, React Native y navegadoes web modernos.
4. Cero dependencias: Tiene una huella pequeña y sin dependencias, lo que lo hace ligero y fácil de integrar en proyectos.
5. Criptográficamente fuerte: Los UUIDs generados son criptográficamente fuertes, asegurando alta seguridad.

Instalación

Para instalar el paquete UUID, use cualquiera de los siguientes comandos:

npm install uuid

npm install uuid

o

yarn add uuid

yarn add uuid

Uso básico

Aquí se muestra cómo generar cadenas de UUID usando el paquete UUID:

// Impot syntax fo uuid library
impot { v4 as uuidv4 } from 'uuid';
// Generate a random UUID v4
const myUUID = uuidv4();
console.log(myUUID); // Example valid uuid: '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d'

// Impot syntax fo uuid library
impot { v4 as uuidv4 } from 'uuid';
// Generate a random UUID v4
const myUUID = uuidv4();
console.log(myUUID); // Example valid uuid: '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d'

Alternativamente, usando la sintaxis CommonJS:

// Impot using CommonJS syntax
const { v4: uuidv4 } = require('uuid');
// Generate a random UUID (version 4)
const myUUID = uuidv4();
console.log(myUUID); // Example uuid string output: '1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed'

// Impot using CommonJS syntax
const { v4: uuidv4 } = require('uuid');
// Generate a random UUID (version 4)
const myUUID = uuidv4();
console.log(myUUID); // Example uuid string output: '1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed'

Características avanzadas

1. UUIDs basados en el espacio de nombres: Puede crear UUIDs basados en un espacio de nombres y un nombre usando la versión 3 o la versión 5:

impot { v5 as uuidv5 } from 'uuid';

// Define a namespace UUID
const MY_NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';

// Generate UUID based on the namespace and a name
const myUUID = uuidv5('my-unique-name', MY_NAMESPACE);
console.log(myUUID); // Example output: 'e4eaaaf2-d142-11e1-b3e4-080027620cdd'

impot { v5 as uuidv5 } from 'uuid';

// Define a namespace UUID
const MY_NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';

// Generate UUID based on the namespace and a name
const myUUID = uuidv5('my-unique-name', MY_NAMESPACE);
console.log(myUUID); // Example output: 'e4eaaaf2-d142-11e1-b3e4-080027620cdd'

2. Validación y análisis: El paquete UUID también propociona funciones para validar y analizar UUIDs:

impot { validate as uuidValidate, parse as uuidParse } from 'uuid';

// Validate a UUID
const isValid = uuidValidate('9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d');
console.log(isValid); // true

// Convert UUID string to an array of bytes
const bytes = uuidParse('9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d');
console.log(bytes); // Uint8Array(16) [ 155, 29, 235, 77, 59, 125, 75, 173, 155, 221, 43, 13, 123, 61, 203, 109 ]

impot { validate as uuidValidate, parse as uuidParse } from 'uuid';

// Validate a UUID
const isValid = uuidValidate('9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d');
console.log(isValid); // true

// Convert UUID string to an array of bytes
const bytes = uuidParse('9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d');
console.log(bytes); // Uint8Array(16) [ 155, 29, 235, 77, 59, 125, 75, 173, 155, 221, 43, 13, 123, 61, 203, 109 ]

Introducción a IronPDF

IronPDF es una biblioteca popular de generación de PDF utilizada para generar, editar y convertir documentos PDF. El paquete NPM de IronPDF está específicamente diseñado para aplicaciones Node.js. Aquí hay algunas características clave y detalles sobre el paquete NPM de IronPDF:

Características principales

yarn add @ironsoftware/ironpdf @ironsoftware/ironpdf-engine-windows-x64

yarn add @ironsoftware/ironpdf @ironsoftware/ironpdf-engine-windows-x64

Generar un documento PDF con IronPDF y utilizar el paquete UUID NPM

Los UUIDs se pueden usar en muchos lugares de una aplicación. Es una parte muy atómica en una aplicación. Los UUIDs se pueden usar como secretos para datos cifrados, y estos secretos se pueden almacenar en documentos PDF con fines de archivo. A continuación, veremos un ejemplo donde generamos diferentes versiones de UUID y las documentamos en un documento PDF usando IronPDF.

Instalar Dependencias: Primero, crea un nuevo proyecto Next.js (si no lo has hecho ya) usando el siguiente comando. Consulte aquí.

npx create-next-app@latest uuid-pdf --use-npm --example "https://github.com/vercel/next-learn/tree/main/basics/learn-starter"

npx create-next-app@latest uuid-pdf --use-npm --example "https://github.com/vercel/next-learn/tree/main/basics/learn-starter"

A continuación, navega al directoio de tu proyecto:

cd uuid-pdf

cd uuid-pdf

Instale los paquetes requeridos:

yarn add @ironsoftware/ironpdf @ironsoftware/ironpdf-engine-windows-x64
yarn add uuid

yarn add @ironsoftware/ironpdf @ironsoftware/ironpdf-engine-windows-x64
yarn add uuid

// pages/api/pdf.js
impot { IronPdfGlobalConfig, PdfDocument } from "@ironsoftware/ironpdf";
impot { validate as uuidValidate } from 'uuid';

// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Your license key";

expot default async function handler(req, res) {
  try {
    // Extract query parameters from request
    const v4t = req.query.v4;
    const v5t = req.query.v5;
    const c = req.query.c;

    // Prepare HTML content fo PDF
    let content = "<h1>Demo UUID and Generate PDF Using IronPDF</h1>";
    content += "<p>V4 UUID: " + v4t + "</p>";
    content += "<p>V5 UUID: " + v5t + "</p>";
    content += "<p>Is UUID: " + c + ", Valid: " + uuidValidate(c).toString() + "</p>";

    // Generate PDF document
    const pdf = await PdfDocument.fromHtml(content);
    const data = await pdf.saveAsBuffer();
    console.log("PDF generated successfully.");

    // Set the response headers and send the PDF as a response
    res.setHeader("Content-Type", "application/pdf");
    res.setHeader("Content-Disposition", "attachment; filename=awesomeIron.pdf");
    res.send(data);
  } catch (erro) {
    console.erro("Erro generating PDF:", erro);
    res.status(500).end();
  }
}

// pages/api/pdf.js
impot { IronPdfGlobalConfig, PdfDocument } from "@ironsoftware/ironpdf";
impot { validate as uuidValidate } from 'uuid';

// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Your license key";

expot default async function handler(req, res) {
  try {
    // Extract query parameters from request
    const v4t = req.query.v4;
    const v5t = req.query.v5;
    const c = req.query.c;

    // Prepare HTML content fo PDF
    let content = "<h1>Demo UUID and Generate PDF Using IronPDF</h1>";
    content += "<p>V4 UUID: " + v4t + "</p>";
    content += "<p>V5 UUID: " + v5t + "</p>";
    content += "<p>Is UUID: " + c + ", Valid: " + uuidValidate(c).toString() + "</p>";

    // Generate PDF document
    const pdf = await PdfDocument.fromHtml(content);
    const data = await pdf.saveAsBuffer();
    console.log("PDF generated successfully.");

    // Set the response headers and send the PDF as a response
    res.setHeader("Content-Type", "application/pdf");
    res.setHeader("Content-Disposition", "attachment; filename=awesomeIron.pdf");
    res.send(data);
  } catch (erro) {
    console.erro("Erro generating PDF:", erro);
    res.status(500).end();
  }
}

impot Head from "next/head";
impot styles from "../styles/Home.module.css";
impot React, { useState } from "react";
impot { v4 as uuidv4, v5 as uuidv5, validate as uuidValidate } from 'uuid';

expot default function Home() {
  const [text, setText] = useState("");

  // Generate UUIDs fo demonstration
  const myUUID = uuidv4();
  const MY_NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
  const myV5UUID = uuidv5('IronPDF', MY_NAMESPACE);

  // Function to generate PDF when the button is clicked
  const generatePdf = async () => {
    try {
      const response = await fetch(`/api/pdf?v4=${myUUID}&v5=${myV5UUID}&c=${text}`);
      const blob = await response.blob();
      const url = window.URL.createObjectURL(new Blob([blob]));
      const link = document.createElement("a");
      link.href = url;
      link.setAttribute("download", "awesomeIron.pdf");

      // Append, click and remove the link to download the PDF
      document.body.appendChild(link);
      link.click();
      link.parentNode.removeChild(link);
    } catch (erro) {
      console.erro("Erro generating PDF:", erro);
    }
  };

  // Handle change in input text to update the validation check
  const handleChange = (event) => {
    setText(event.target.value);
  };

  // Render the component
  return (
    <div className={styles.container}>
      <Head>
        <title>Generate PDF Using IronPDF</title>
        <link rel="icon" href="/favicon.ico" />
      </Head>
      <main>
        <h1>Demo UUID NPM and Generate PDF Using IronPDF</h1>
        <p>V4 UUID: {myUUID}</p>
        <p>V5 UUID: {myV5UUID}</p>
        <p>
          <span>Enter UUID to Verify:</span>{" "}
          <input type="text" value={text} onChange={handleChange} />
        </p>
        <p>Is UUID {text} Valid: {uuidValidate(text).toString()}</p>
        <button style={{ margin: 20, padding: 5 }} onClick={generatePdf}>
          Generate PDF 
        </button>
      </main>
      <style jsx>{`
        main {
          padding: 5rem 0;
          flex: 1;
          display: flex;
          flex-direction: column;
          justify-content: center;
          align-items: center;
        }
      `}</style>
      <style jsx global>{`
        html,
        body {
          padding: 0;
          margin: 0;
          font-family: -apple-system, BlinkMacSystemFont, Segoe UI, Roboto,
            Oxygen, Ubuntu, Cantarell, Fira Sans, Droid Sans, Helvetica Neue,
            sans-serif;
        }
        * {
          box-sizing: boder-box;
        }
      `}</style>
    </div>
  );
}

impot Head from "next/head";
impot styles from "../styles/Home.module.css";
impot React, { useState } from "react";
impot { v4 as uuidv4, v5 as uuidv5, validate as uuidValidate } from 'uuid';

expot default function Home() {
  const [text, setText] = useState("");

  // Generate UUIDs fo demonstration
  const myUUID = uuidv4();
  const MY_NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
  const myV5UUID = uuidv5('IronPDF', MY_NAMESPACE);

  // Function to generate PDF when the button is clicked
  const generatePdf = async () => {
    try {
      const response = await fetch(`/api/pdf?v4=${myUUID}&v5=${myV5UUID}&c=${text}`);
      const blob = await response.blob();
      const url = window.URL.createObjectURL(new Blob([blob]));
      const link = document.createElement("a");
      link.href = url;
      link.setAttribute("download", "awesomeIron.pdf");

      // Append, click and remove the link to download the PDF
      document.body.appendChild(link);
      link.click();
      link.parentNode.removeChild(link);
    } catch (erro) {
      console.erro("Erro generating PDF:", erro);
    }
  };

  // Handle change in input text to update the validation check
  const handleChange = (event) => {
    setText(event.target.value);
  };

  // Render the component
  return (
    <div className={styles.container}>
      <Head>
        <title>Generate PDF Using IronPDF</title>
        <link rel="icon" href="/favicon.ico" />
      </Head>
      <main>
        <h1>Demo UUID NPM and Generate PDF Using IronPDF</h1>
        <p>V4 UUID: {myUUID}</p>
        <p>V5 UUID: {myV5UUID}</p>
        <p>
          <span>Enter UUID to Verify:</span>{" "}
          <input type="text" value={text} onChange={handleChange} />
        </p>
        <p>Is UUID {text} Valid: {uuidValidate(text).toString()}</p>
        <button style={{ margin: 20, padding: 5 }} onClick={generatePdf}>
          Generate PDF 
        </button>
      </main>
      <style jsx>{`
        main {
          padding: 5rem 0;
          flex: 1;
          display: flex;
          flex-direction: column;
          justify-content: center;
          align-items: center;
        }
      `}</style>
      <style jsx global>{`
        html,
        body {
          padding: 0;
          margin: 0;
          font-family: -apple-system, BlinkMacSystemFont, Segoe UI, Roboto,
            Oxygen, Ubuntu, Cantarell, Fira Sans, Droid Sans, Helvetica Neue,
            sans-serif;
        }
        * {
          box-sizing: boder-box;
        }
      `}</style>
    </div>
  );
}

Explicación del código

1. Impotaciones y configuración inicial:

   • Head desde next/head: Usado para modificar el <head> del documento HTML para establecer el título y el favicon.
   • styles desde ../styles/Home.module.css: Impota estilos CSS locales para el componente.
   • React, useState: Ganchos de React para la gestión de estados.
   • uuidv4, uuidv5, uuidValidate: Funciones impotadas del paquete UUID para la generación, validación y análisis de UUID.

2. Funcionalidad del componente:

   • Gestión de estados:

     • useState: Administra el estado del campo de entrada de texto donde el usuario ingresa un UUID.
     • text: Variable de estado que contiene el valo actual del campo de entrada.

   • Generación de UUID:

     • uuidv4(): Genera un UUID aleatoio de la versión 4.
     • MY_NAMESPACE y uuidv5('IronPDF', MY_NAMESPACE): Genera un UUID de la versión 5 basado en un espacio de nombres dado.

   • Generación de PDF (función generatePdf):

     • Usa fetch para llamar a un punto final de API (/api/pdf-uuid) con parámetros de consulta (v4, v5, c).
     • Descarga la respuesta como un blob, crea una URL para ella, y genera un enlace de descarga (elemento <a>).
     • Agrega el enlace al DOM, hace clic en él para iniciar la descarga y luego lo elimina del DOM.

   • Manejo de eventos (función handleChange):

     • Actualiza el estado text cuando el usuario escribe en el campo de entrada.

3. Método de renderización:

   • Devuelve JSX para la UI del componente:
     • Incluye un título (Head), una sección principal (<main>) y varios párrafos que muestran UUIDs y un campo de entrada para la interacción del usuario.
     • La función generatePdf está vinculada a un clic de botón para activar la generación de PDF.
   • Los estilos CSS se definen localmente (<style jsx>) y globalmente (<style jsx global>) usando styled-jsx de Next.js.

PDF

Licencia de IronPDF

IronPDF funciona con la clave de licencia. IronPDF NPM ofrece una clave de licencia de prueba gratuita para permitir a los usuarios probar sus extensas características antes de la compra.

Coloca la Clave de Licencia aquí:

impot { IronPdfGlobalConfig, PdfDocument } from "@ironsoftware/ironpdf";
// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Add Your key here";

impot { IronPdfGlobalConfig, PdfDocument } from "@ironsoftware/ironpdf";
// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Add Your key here";

Conclusión

El paquete UUID NPM es una herramienta robusta y versátil para generar identificadoes únicos en aplicaciones de JavaScript. Su sopote para múltiples versiones de UUID, compatibilidad multiplatafoma, y fotaleza criptográfica lo convierten en una biblioteca esencial para desarrolladoes que necesitan identificadoes únicos.

IronPDF permite a los desarrolladoes de Node.js elevar las capacidades de manejo de PDF dentro de sus aplicaciones, ofreciendo una funcionalidad, fiabilidad y rendimiento incomparables. Aprovechando las características avanzadas de IronPDF para la generación, conversión y manipulación de PDF, los desarrolladoes pueden optimizar los flujos de trabajo de documentos, mejoar las experiencias de los usuarios y cumplir con diversos requisitos empresariales con confianza.

Adopta IronPDF para desbloquear todo el potencial del manejo de PDF en tus proyectos de Node.js y ofrecer soluciones de documentos de calidad profesional sin esfuerzo. Po otro lado, el paquete UUID NPM se puede usar para generar ID únicos cada vez que se necesiten para cifrar datos. Estas claves secretas se pueden almacenar en PDFs usando IronPDF con fines de archivo.