@robosophy/auth 1.0.0 → 1.2.0

package/README.md

@@ -1,141 +1,135 @@
-# @robosophy/auth
-
-Sesión de los fronts de Mi Cuenta contra el Landing: access token RS256 de 15 minutos en `localStorage["token"]`, refresh opaco en cookie HttpOnly y datos del usuario desde `GET /api/usuario/self`.
-
-No depende de ningún framework. Necesita `axios` (peer dependency) y `fetch`.
-
-## Instalación
-
-```sh
-npm install @robosophy/auth
-```
-
-## Configuración
-
-Se llama una sola vez, al arrancar la app:
-
-```js
-import { configureAuth } from "@robosophy/auth";
-
-configureAuth({
-  landingUrl: import.meta.env.VITE_LANDING_URL, // origin del Landing (front y back comparten origin)
-  devEmail: import.meta.env.VITE_DEV_EMAIL,     // solo DEV
-  isDev: import.meta.env.DEV,
-});
-```
-
-## API
-
-| Función | Qué hace |
-|---|---|
-| `configureAuth(opts)` | Guarda `landingUrl`, `devEmail` e `isDev`. |
-| `getToken()` | Devuelve `localStorage["token"]` o `null`. |
-| `attachAuthRefresh(api)` | Agrega el Bearer a cada request y ante un 401 renueva el token y reintenta una vez. |
-| `getCurrentUser()` | `GET {landingUrl}/api/usuario/self`, cacheado en memoria. Si falla, el cache se descarta. |
-| `setSession(token)` | Guarda el token nuevo e invalida el cache del usuario. |
-| `logout()` | `POST {landingUrl}/api/auth/logout`, limpia la sesión y va a `{landingUrl}/login`. |
-| `clearSession()` | Borra `token`, `user-id`, `originalToken` y `token-landing` de `localStorage`. |
-
-## Cómo se renueva el token
-
-Ante un 401 de un request que todavía no se reintentó:
-
-1. Se toma el lock `basf-auth-refresh` con `navigator.locks`, compartido entre pestañas. Si el navegador no lo soporta, se deduplica solo dentro de la pestaña.
-2. Si `localStorage["token"]` ya cambió, otra pestaña renovó primero y se usa ese token.
-3. Si no, se pide uno nuevo:
-   - En DEV con `devEmail`: `POST {landingUrl}/dev/token` con `{ email }`. El Landing back local lo expone solo en el perfil `local`.
-   - Si no: `POST {landingUrl}/api/auth/refresh` con `credentials: "include"`, que rota la cookie de refresh.
-4. Con token nuevo se reintenta el request original. Si no hay token:
-   - En DEV: `console.warn("[auth] sin sesión: definí VITE_DEV_EMAIL en .env.local")` y el error sigue. No redirige.
-   - En prod: `clearSession()` y redirect a `{landingUrl}/login`, salvo que ya esté en esa página.
-
-Los 401 de `/api/auth/login`, `/api/auth/verify-2fa`, `/api/auth/resend-2fa`, `/api/auth/refresh`, `/api/auth/logout` y `/dev/token` no disparan el refresh: ahí el 401 es la respuesta (credenciales, código 2FA, refresh vencido). El resto de `/api/auth/*`, como `request-2fa-challenge`, sí renueva y reintenta.
-
-## Uso en Vue
-
-```js
-// main.js
-import { configureAuth } from "@robosophy/auth";
-
-configureAuth({
-  landingUrl: import.meta.env.VITE_LANDING_URL,
-  devEmail: import.meta.env.VITE_DEV_EMAIL,
-  isDev: import.meta.env.DEV,
-});
-```
-
-```js
-// axiosClient.js
-import axios from "axios";
-import { attachAuthRefresh } from "@robosophy/auth";
-
-const api = axios.create({ baseURL: import.meta.env.VITE_URL });
-attachAuthRefresh(api);
-export default api;
-```
-
-```js
-// router/index.js
-import { getCurrentUser } from "@robosophy/auth";
-
-router.beforeEach(async (to) => {
-  if (!to.meta.requiresAuth) return true;
-  try {
-    const user = await getCurrentUser();
-    return Boolean(user?.rolCYO?.rol);
-  } catch {
-    return false; // attachAuthRefresh ya redirigió al login (prod) o avisó por consola (DEV)
-  }
-});
-```
-
-```vue
-<!-- Botón de salir -->
-<script setup>
-import { logout } from "@robosophy/auth";
-</script>
-
-<template>
-  <button @click="logout">Salir</button>
-</template>
-```
-
-## Uso en React
-
-```tsx
-// main.tsx
-import { configureAuth } from "@robosophy/auth";
-
-configureAuth({
-  landingUrl: import.meta.env.VITE_LANDING_URL,
-  devEmail: import.meta.env.VITE_DEV_EMAIL,
-  isDev: import.meta.env.DEV,
-});
-```
-
-```tsx
-// useCurrentUser.ts
-import { useEffect, useState } from "react";
-import { getCurrentUser } from "@robosophy/auth";
-
-export function useCurrentUser<T>() {
-  const [user, setUser] = useState<T | null>(null);
-  useEffect(() => {
-    getCurrentUser<T>().then(setUser).catch(() => setUser(null));
-  }, []);
-  return user;
-}
-```
-
-```tsx
-import { logout } from "@robosophy/auth";
-
-<button onClick={() => logout()}>Salir</button>;
-```
-
-## Desarrollo local
-
-- La variable con la URL del Landing (`landingUrl`) apunta al **Landing back** en `http://localhost:8184`, no al Vite del front de Landing: ahí están `/api/usuario/self` y `/dev/token`.
-- `VITE_DEV_EMAIL=usuario@basf.com` va en `.env.local`, que no se commitea.
-- Con el Landing back en perfil `local`, el front pide el token solo en el primer 401: no hace falta loguearse ni copiar tokens.
-- Para entrar con otro usuario se cambia el email y se recarga. `configureAuth` detecta el cambio (lo guarda en `localStorage["auth-dev-email"]`) y borra la sesión del usuario anterior.
+# @robosophy/auth
+
+Sesión de los fronts de Mi Cuenta contra el Landing: access token RS256 de 15 minutos en `localStorage["token"]`, refresh opaco en cookie HttpOnly y datos del usuario desde `GET /api/usuario/self`.
+
+No depende de ningún framework. Necesita `axios` (peer dependency) y `fetch`.
+
+## Instalación
+
+```sh
+npm install @robosophy/auth
+```
+
+## Configuración
+
+Se llama una sola vez, al arrancar la app:
+
+```js
+import { configureAuth } from "@robosophy/auth";
+
+configureAuth({
+  landingUrl: import.meta.env.VITE_LANDING_URL, // origin del Landing (front y back comparten origin)
+  isDev: import.meta.env.DEV,
+});
+```
+
+`hostsLogin: true` solo en Landing, que es el que tiene el login: redirige a su propio `/login` (`window.location.origin`) y lo hace también en DEV. Los módulos no lo pasan: van a `{landingUrl}/login` y en DEV no redirigen.
+
+## API
+
+| Función | Qué hace |
+|---|---|
+| `configureAuth(opts)` | Guarda `landingUrl`, `isDev` y `hostsLogin`. |
+| `getToken()` | Devuelve `localStorage["token"]` o `null`. |
+| `attachAuthRefresh(api)` | Agrega el Bearer a cada request y ante un 401 renueva el token y reintenta una vez. |
+| `getCurrentUser()` | `GET {landingUrl}/api/usuario/self`, cacheado en memoria. Si falla, el cache se descarta. |
+| `setSession(token)` | Guarda el token nuevo e invalida el cache del usuario. |
+| `logout()` | `POST {landingUrl}/api/auth/logout`, limpia la sesión y va al login (ver `hostsLogin`). |
+| `clearSession()` | Borra `token`, `user-id`, `originalToken` y `token-landing` de `localStorage`. |
+
+## Cómo se renueva el token
+
+Ante un 401 de un request que todavía no se reintentó:
+
+1. Se toma el lock `basf-auth-refresh` con `navigator.locks`, compartido entre pestañas. Si el navegador no lo soporta, se deduplica solo dentro de la pestaña.
+2. Si `localStorage["token"]` ya cambió, otra pestaña renovó primero y se usa ese token.
+3. Si no, se pide uno nuevo: `POST {landingUrl}/api/auth/refresh` con `credentials: "include"`, que rota la cookie de refresh.
+4. Con token nuevo se reintenta el request original. Si no hay token:
+   - En DEV: `console.warn('[auth] sin sesión: copiá el token de dev en localStorage (key "token") y recargá')` y el error sigue. No redirige (salvo con `hostsLogin`).
+   - En prod, o con `hostsLogin`: `clearSession()` y redirect al login, salvo que ya esté en esa página.
+
+Los 401 de `/api/auth/login`, `/api/auth/verify-2fa`, `/api/auth/resend-2fa`, `/api/auth/refresh` y `/api/auth/logout` no disparan el refresh: ahí el 401 es la respuesta (credenciales, código 2FA, refresh vencido). El resto de `/api/auth/*`, como `request-2fa-challenge`, sí renueva y reintenta.
+
+## Uso en Vue
+
+```js
+// main.js
+import { configureAuth } from "@robosophy/auth";
+
+configureAuth({
+  landingUrl: import.meta.env.VITE_LANDING_URL,
+  isDev: import.meta.env.DEV,
+});
+```
+
+```js
+// axiosClient.js
+import axios from "axios";
+import { attachAuthRefresh } from "@robosophy/auth";
+
+const api = axios.create({ baseURL: import.meta.env.VITE_URL });
+attachAuthRefresh(api);
+export default api;
+```
+
+```js
+// router/index.js
+import { getCurrentUser } from "@robosophy/auth";
+
+router.beforeEach(async (to) => {
+  if (!to.meta.requiresAuth) return true;
+  try {
+    const user = await getCurrentUser();
+    return Boolean(user?.rolCYO?.rol);
+  } catch {
+    return false; // attachAuthRefresh ya redirigió al login (prod) o avisó por consola (DEV)
+  }
+});
+```
+
+```vue
+<!-- Botón de salir -->
+<script setup>
+import { logout } from "@robosophy/auth";
+</script>
+
+<template>
+  <button @click="logout">Salir</button>
+</template>
+```
+
+## Uso en React
+
+```tsx
+// main.tsx
+import { configureAuth } from "@robosophy/auth";
+
+configureAuth({
+  landingUrl: import.meta.env.VITE_LANDING_URL,
+  isDev: import.meta.env.DEV,
+});
+```
+
+```tsx
+// useCurrentUser.ts
+import { useEffect, useState } from "react";
+import { getCurrentUser } from "@robosophy/auth";
+
+export function useCurrentUser<T>() {
+  const [user, setUser] = useState<T | null>(null);
+  useEffect(() => {
+    getCurrentUser<T>().then(setUser).catch(() => setUser(null));
+  }, []);
+  return user;
+}
+```
+
+```tsx
+import { logout } from "@robosophy/auth";
+
+<button onClick={() => logout()}>Salir</button>;
+```
+
+## Desarrollo local
+
+En dev el access token dura 24 h. Para trabajar con un front local: loguearse en `https://dev.micuenta.basf.com.ar`, copiar `token` del `localStorage` y pegarlo en el `localStorage` del front local (`localhost:<puerto>`), con la misma key. Con `isDev` el paquete no redirige al login: si el token vence, avisa en la consola y hay que pegar uno nuevo.

package/dist/index.d.ts

@@ -1,10 +1,13 @@
 interface AuthOptions {
     /** Origin del Landing (front y back comparten origin): ej. import.meta.env.VITE_LANDING_URL */
     landingUrl: string;
-    /** Solo DEV: email para pedir el token a POST /dev/token del Landing back local. */
-    devEmail?: string;
     /** import.meta.env.DEV */
     isDev?: boolean;
+    /**
+     * Solo Landing, que es el que tiene el login: redirige a su propio /login (window.location.origin,
+     * no landingUrl, que en local es el back) y lo hace también en DEV.
+     */
+    hostsLogin?: boolean;
 }
 /**
  * Lo único que se usa de la instancia. Estructural para no atar los tipos a la versión de axios

package/dist/index.js

@@ -4,17 +4,14 @@ var TOKEN_KEY = "token";
 var SESSION_KEYS = [TOKEN_KEY, "user-id", "originalToken", "token-landing"];
 var LOCK_NAME = "basf-auth-refresh";
 var REFRESH_PATH = "/api/auth/refresh";
-var DEV_TOKEN_PATH = "/dev/token";
 var LOGOUT_PATH = "/api/auth/logout";
 var SELF_PATH = "/api/usuario/self";
-var DEV_EMAIL_KEY = "auth-dev-email";
 var NO_RETRY_PATHS = [
   "/api/auth/login",
   "/api/auth/verify-2fa",
   "/api/auth/resend-2fa",
   REFRESH_PATH,
-  LOGOUT_PATH,
-  DEV_TOKEN_PATH
+  LOGOUT_PATH
 ];
 var options = null;
 var landingApi = null;
@@ -23,15 +20,11 @@ var inFlightRefresh = null;
 function configureAuth(opts) {
   options = {
     landingUrl: opts.landingUrl.replace(/\/+$/, ""),
-    devEmail: opts.devEmail ?? "",
-    isDev: opts.isDev ?? false
+    isDev: opts.isDev ?? false,
+    hostsLogin: opts.hostsLogin ?? false
   };
   landingApi = null;
   currentUser = null;
-  if (options.isDev && options.devEmail !== "" && localStorage.getItem(DEV_EMAIL_KEY) !== options.devEmail) {
-    clearSession();
-    localStorage.setItem(DEV_EMAIL_KEY, options.devEmail);
-  }
 }
 function getToken() {
   return localStorage.getItem(TOKEN_KEY);
@@ -91,7 +84,7 @@ async function logout() {
   } catch {
   }
   clearSession();
-  window.location.href = `${landingUrl}/login`;
+  window.location.href = loginUrl();
 }
 function requireOptions() {
   if (!options) {
@@ -99,6 +92,10 @@ function requireOptions() {
   }
   return options;
 }
+function loginUrl() {
+  const { landingUrl, hostsLogin } = requireOptions();
+  return `${hostsLogin ? window.location.origin : landingUrl}/login`;
+}
 function getLandingApi() {
   if (!landingApi) {
     landingApi = axios.create({ baseURL: requireOptions().landingUrl });
@@ -141,15 +138,9 @@ function withRefreshLock(task) {
   return locks ? locks.request(LOCK_NAME, task) : task();
 }
 async function requestNewToken() {
-  const { landingUrl, devEmail, isDev } = requireOptions();
-  const useDevToken = isDev && devEmail !== "";
+  const { landingUrl } = requireOptions();
   try {
-    const response = await fetch(landingUrl + (useDevToken ? DEV_TOKEN_PATH : REFRESH_PATH), {
-      method: "POST",
-      credentials: "include",
-      headers: useDevToken ? { "Content-Type": "application/json" } : void 0,
-      body: useDevToken ? JSON.stringify({ email: devEmail }) : void 0
-    });
+    const response = await fetch(landingUrl + REFRESH_PATH, { method: "POST", credentials: "include" });
     if (!response.ok) {
       return null;
     }
@@ -160,15 +151,15 @@ async function requestNewToken() {
   }
 }
 function onSessionLost() {
-  const { landingUrl, isDev } = requireOptions();
-  if (isDev) {
-    console.warn("[auth] sin sesi\xF3n: defin\xED VITE_DEV_EMAIL en .env.local");
+  const { isDev, hostsLogin } = requireOptions();
+  if (isDev && !hostsLogin) {
+    console.warn('[auth] sin sesi\xF3n: copi\xE1 el token de dev en localStorage (key "token") y recarg\xE1');
     return;
   }
   clearSession();
-  const loginUrl = `${landingUrl}/login`;
-  if (!window.location.href.startsWith(loginUrl)) {
-    window.location.href = loginUrl;
+  const target = loginUrl();
+  if (!window.location.href.startsWith(target)) {
+    window.location.href = target;
   }
 }
 export {

package/package.json

@@ -1,35 +1,35 @@
-{
-  "name": "@robosophy/auth",
-  "version": "1.0.0",
-  "private": false,
-  "license": "UNLICENSED",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "package.json"
-  ],
-  "sideEffects": false,
-  "scripts": {
-    "prepublishOnly": "npm run build",
-    "build": "tsup src/index.ts --format esm --dts --clean --external axios",
-    "test": "vitest run"
-  },
-  "peerDependencies": {
-    "axios": ">=0.19.0"
-  },
-  "devDependencies": {
-    "axios": "^1.7.0",
-    "tsup": "^8.5.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.0"
-  }
-}
+{
+  "name": "@robosophy/auth",
+  "version": "1.2.0",
+  "private": false,
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "build": "tsup src/index.ts --format esm --dts --clean --external axios",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "axios": ">=0.19.0"
+  },
+  "devDependencies": {
+    "axios": "^1.7.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.0"
+  }
+}