SDK Global Universitas 🌍

SDK oficial en TypeScript para interactuar con la API Global de Universitas. Proporciona acceso rápido, tipado y seguro a los indicadores económicos (BCV, UCAUU) y a la estructura territorial de Venezuela.

🚀 Características

• Cero dependencias: Construido con el fetch nativo para ser ultra ligero.
• Tipado estricto: 100% TypeScript con interfaces listas para usar.
• Soporte Universal: Funciona en Node.js, React, Next.js, Vue, Angular y Vanilla JS (CommonJS y ES Modules).
• Seguro por diseño: La URL del backend nunca queda expuesta en el código fuente del SDK.

📦 Instalación

npm install @universitas/sdk-global
# o
yarn add @universitas/sdk-global
# o
pnpm add @universitas/sdk-global

⚙️ Configuración requerida

El SDK requiere que le pases la URL del backend mediante una variable de entorno. Esto garantiza que la URL nunca quede expuesta en ningún código fuente.

Next.js

# .env.local
NEXT_PUBLIC_API_URL=https://tu-backend.com

// lib/api.ts
import { UniversitasAPI } from '@universitas/sdk-global';

export const api = new UniversitasAPI(process.env.NEXT_PUBLIC_API_URL!);

Vite / React

# .env
VITE_API_URL=https://tu-backend.com

import { UniversitasAPI } from '@universitas/sdk-global';

export const api = new UniversitasAPI(import.meta.env.VITE_API_URL);

Vue 3 (Vite)

# .env
VITE_API_URL=https://tu-backend.com

import { UniversitasAPI } from '@universitas/sdk-global';

export const api = new UniversitasAPI(import.meta.env.VITE_API_URL);

Node.js

# .env
API_URL=https://tu-backend.com

import { UniversitasAPI } from '@universitas/sdk-global';

const api = new UniversitasAPI(process.env.API_URL!);

⚠️ Importante: Si no pasas la URL, el SDK lanzará un error descriptivo indicando exactamente cómo configurarla.