Instalación

El paquete se publica en GitHub Packages bajo el scope @dikaia-io. El consumidor necesita Node.js 18 o superior, npm y acceso de lectura al paquete.

Configurar el registro

Creá un .npmrc en la aplicación consumidora:

@dikaia-io:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
always-auth=true

Definí NODE_AUTH_TOKEN fuera del repositorio. El token necesita el permiso read:packages y acceso Read al package de la organización dikaia-io.

No publiques credenciales

Nunca reemplaces ${NODE_AUTH_TOKEN} por un token real dentro de .npmrc, un archivo Markdown, una imagen, un log o el historial de Git.

Instalar

Para fijar la versión documentada:

npm install @dikaia-io/honorarios@0.3.0

Para aceptar actualizaciones compatibles según SemVer:

npm install @dikaia-io/honorarios@^0.3.0

Mientras el paquete esté en la serie 0.x, conviene revisar el changelog antes de cada actualización, porque una versión menor puede requerir ajustes del consumidor.

Entry points

Importación	Uso recomendado
@dikaia-io/honorarios	API pública completa
@dikaia-io/honorarios/types	Tipos de dominio
@dikaia-io/honorarios/calculations	Funciones de cálculo
@dikaia-io/honorarios/mappers	Normalización de servicios extrajudiciales
@dikaia-io/honorarios/data	Catálogo consolidado y helpers
@dikaia-io/honorarios/data/extrajudiciales	Catálogo extrajudicial aislado

import { calculateHonorarios } from '@dikaia-io/honorarios/calculations';
import type { HonorarioInputs } from '@dikaia-io/honorarios/types';
import { buscarActuaciones } from '@dikaia-io/honorarios/data';

El paquete publica módulos ESM, CommonJS y declaraciones .d.ts; no requiere configuración especial para un proyecto TypeScript moderno con resolución de módulos Bundler o NodeNext.

GitHub Actions

Guardá un token de solo lectura como secreto del repositorio consumidor y exponelo únicamente durante la instalación:

- name: Configurar Node
  uses: actions/setup-node@v4
  with:
    node-version: 22
    registry-url: https://npm.pkg.github.com
    scope: '@dikaia-io'

- name: Instalar dependencias
  run: npm ci
  env:
    NODE_AUTH_TOKEN: ${{ secrets.PACKAGES_READ_TOKEN }}

Si ambos repositorios pertenecen a la misma organización, también debe concederse al repositorio consumidor acceso Read desde la configuración del package.

Problemas frecuentes

Síntoma	Comprobación
404 Not Found	Scope, nombre, versión publicada y acceso al package
401 Unauthorized	Presencia y vigencia de NODE_AUTH_TOKEN
npm consulta npmjs.org	Línea @dikaia-io:registry del .npmrc
Funciona localmente, falla en CI	Secreto, permisos del workflow y acceso del repositorio
TypeScript no encuentra tipos	Versión instalada y resolución de módulos

Continuá con el inicio rápido.