Saltar al contenido
DaloyJS
Documentación en español

Traducción de la página original en inglés. Si algo no cuadra, prevalece la versión en inglés.

Instalación

DaloyJS está pensado para Node.js 24 LTS o Node.js 26 y posteriores (engines.node: ^24.0.0 || >=26.0.0) y se distribuye en el registro público de npm como @daloyjs/core. El paquete no tiene dependencias peer, así que npm, yarn, pnpm y bun pueden instalarlo directamente. Recomendamos pnpm junto con los valores reforzados de .npmrc que verás más abajo por motivos de cadena de suministro, pero no es obligatorio. La entrada engines.pnpm de package.json es metadato orientativo, mientras que engines.node indica el runtime compatible y puede mostrar un aviso o fallar según tu gestor de paquetes y su configuración de engine-strict.

Dos caminos
  1. 01lo más rápidoCrear el proyectopnpm create daloy@latest
  2. 02o bienInstalar en un proyectopnpm add @daloyjs/core zod
  3. 03reforzarAñadir los valores de .npmrcstrict-peer-dependencies, lockfile congelado
  4. 04comprobarVerificar la importaciónnode -e import('@daloyjs/core')
Crea un proyecto reforzado con un solo comando o añade el paquete sin dependencias a uno que ya tengas; después, pon el .npmrc reforzado y comprueba que la importación se resuelve.

Lo más rápido: crea un proyecto

Usa el generador oficial: configura un .npmrc reforzado, TypeScript estricto y una ruta que funciona, todo con un solo comando.

Enlaces a los paquetes: create-daloy en npm y @daloyjs/core en npm.

bash
# elige un gestor de paquetes
pnpm create daloy@latest my-api
npm  create daloy@latest my-api
yarn create daloy           my-api
bun  create daloy           my-api

Consulta Scaffold a project (en inglés) para ver las plantillas y las opciones.

O instálalo en un proyecto que ya tengas

Requisitos previos

  • Node.js 24 LTS, o 26.0.0 y posteriores (Node.js 25 no está soportado).
  • Un gestor de paquetes. Sirve cualquiera de estos; se recomienda pnpm 11.x o posterior por el refuerzo de la cadena de suministro, pero npm, yarn y bun instalan @daloyjs/core sin problemas porque el paquete no tiene dependencias peer.

Para activar pnpm mediante Corepack:

bash
corepack enable
corepack prepare pnpm@11.1.3 --activate
pnpm --version

Instala DaloyJS

bash
pnpm add @daloyjs/core zod

Opcional, solo si quieres generar un SDK tipado:

bash
pnpm add -D typescript @hey-api/openapi-ts prettier

El paquete del framework publicado en npm es @daloyjs/core.

Ajustes de instalación reforzados

Con pnpm 11+, pon los ajustes de cadena de suministro en pnpm-workspace.yaml, en la raíz del proyecto (claves en camelCase; pnpm 11 lee este archivo incluso en un proyecto de un solo paquete). pnpm 11 ignora estos ajustes en .npmrc, así que una configuración solo con .npmrc se queda sin el periodo de espera y sin la política de scripts.

pnpm-workspace.yamlyaml
minimumReleaseAge: 1440
blockExoticSubdeps: true
ignoreScripts: true
strictPeerDependencies: true
verifyStoreIntegrity: true
preferFrozenLockfile: true
autoInstallPeers: true

Para npm y versiones anteriores de pnpm, mantén también los mismos valores en .npmrc:

.npmrcini
auto-install-peers=true
strict-peer-dependencies=true
prefer-frozen-lockfile=true
verify-store-integrity=true
minimum-release-age=1440
ignore-scripts=true

El periodo de espera e ignoreScripts reducen el riesgo en la cadena de suministro para estas instalaciones; no detienen todos los ataques. ignoreScripts bloquea las cargas maliciosas en scripts de instalación, no el código que se ejecuta al importar un paquete, y el periodo de espera de 24 horas solo protege frente a compromisos que se detectan en menos de un día.

Lee los motivos en Seguridad y en la guía de motivación de pnpm.

Comprueba la instalación

Ejecuta esto desde la raíz del proyecto después de instalar; funciona igual con pnpm, npm, yarn o bun porque llama directamente a node:

bash
node -e "import('@daloyjs/core').then(m => console.log('DaloyJS ok ->', Object.keys(m).slice(0, 6)))"

Siguiente paso

Primeros pasosEscribe tu primera ruta, valídala y sirve la documentación OpenAPI.Scaffold a project (en inglés)Deja que create-daloy te prepare un proyecto reforzado.

Última actualización: