@tgtone/auth-sdk 1.2.0 → 1.2.1

package/docs/NPM_PUBLISH.md

@@ -1,9 +1,14 @@
-# 📦 Publicar SDK a NPM
+# 📦 Publicar @tgtone/auth-sdk a NPM
+
+> Guía para publicar nuevas versiones del SDK de autenticación
+
+---
 
 ## ✅ Pre-requisitos
 
 1. **Cuenta en NPM**: https://www.npmjs.com/signup
-2. **Login en terminal**:
+2. **Permisos en organización @tgtone**
+3. **Login en terminal**:
 ```bash
 npm login
 # Ingresar: username, password, email, OTP (si tienes 2FA)
@@ -11,93 +16,87 @@ npm login
 
 ---
 
-## 🚀 Comandos para Publicar
+## 🚀 Proceso de Publicación
 
 ### 1. Ir a la carpeta del SDK
 ```bash
-cd /home/jam/develop/tgtone/tgtone-identity-auth/sdk
+cd /home/jam/develop/tgtone/tgtone-console/packages/auth-sdk
 ```
 
-### 2. Limpiar build anterior
-```bash
-npm run clean
-```
 
-### 3. Compilar TypeScript
+### 2. Actualizar versión (si aplica)
 ```bash
-npm run build
-```
+# Patch (1.2.0 → 1.2.1) - Bug fixes
+npm version patch
 
-### 4. Verificar qué archivos se publicarán
-```bash
-npm pack --dry-run
-```
+# Minor (1.2.0 → 1.3.0) - Nuevas features
+npm version minor
 
-Debería mostrar:
-```
-- README.md
-- package.json
-- dist/
-- docs/
+# Major (1.2.0 → 2.0.0) - Breaking changes
+npm version major
 ```
 
-### 5. Publicar
+### 3. Limpiar build anterior
 ```bash
-npm publish
+npm run clean
 ```
 
----
-
-## 🔄 Para Actualizar Versión
-
-### Patch (1.0.2 → 1.0.3) - Bug fixes
+### 4. Compilar TypeScript
 ```bash
-npm version patch
-npm publish
+npm run build
 ```
 
-### Minor (1.0.3 → 1.1.0) - Nuevas features
+### 5. Verificar archivos a publicar
 ```bash
-npm version minor
-npm publish
+npm pack --dry-run
 ```
 
-### Major (1.1.0 → 2.0.0) - Breaking changes
+Debe incluir:
+- ✅ `dist/` (código compilado)
+- ✅ `README.md`
+- ✅ `docs/` (documentación)
+- ✅ `package.json`
+
+### 6. Publicar a NPM
 ```bash
-npm version major
 npm publish
 ```
 
 ---
 
-## ✅ Verificar Publicación
+## 📦 Verificar Publicación
 
-Una vez publicado:
 ```bash
 # Ver en NPM
-https://www.npmjs.com/package/tgtone-auth-client
+open https://www.npmjs.com/package/@tgtone/auth-sdk
 
-# Instalar en otro proyecto
-npm install tgtone-auth-client
+# Probar instalación
+npm install @tgtone/auth-sdk@latest
 ```
 
 ---
 
-## 🔐 Configuración de Token NPM (CI/CD)
+## 🔐 Token NPM para CI/CD
 
-Para publicar desde GitHub Actions o CI/CD:
+Para publicar automáticamente desde GitHub Actions:
 
-```bash
-# 1. Crear token en NPM
+**1. Crear token en NPM:**
+```
 https://www.npmjs.com/settings/YOUR_USER/tokens
+→ Generate New Token → Automation
+```
 
-# 2. Configurar en GitHub Secrets
-Repo Settings > Secrets > New secret
+**2. Agregar a GitHub Secrets:**
+```
+Repo Settings → Secrets and variables → Actions → New secret
 Name: NPM_TOKEN
 Value: npm_xxx...
+```
 
-# 3. Usar en GitHub Actions
-- run: npm publish
+**3. Usar en workflow:**
+```yaml
+- name: Publish to NPM
+  run: npm publish
   env:
     NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 ```
@@ -106,26 +105,36 @@ Value: npm_xxx...
 
 ## 📋 Checklist Pre-publicación
 
-- [x] ✅ Version actualizada en package.json (1.0.2)
-- [x] ✅ Build exitoso (`npm run build`)
-- [x] ✅ Tests pasando (si los hay)
-- [x] ✅ README.md actualizado
-- [x] ✅ CHANGELOG.md actualizado
-- [x] ✅ Documentación organizada en docs/
-- [ ] ⬜ Login en NPM (`npm login`)
+- [ ] Código actualizado y funcional
+- [ ] Tests pasando (si los hay)
+- [ ] Versión incrementada en `package.json`
+- [ ] `README.md` actualizado con cambios
+- [ ] Documentación en `docs/` actualizada
+- [ ] Build exitoso (`npm run build`)
+- [ ] Login en NPM (`npm whoami`)
 
 ---
 
-## 🎯 Comandos Rápidos
+## ⚡ Comandos Rápidos
 
 ```bash
-# Todo en uno (desde carpeta sdk/)
-cd /home/jam/develop/tgtone/tgtone-identity-auth/sdk
-npm run clean
-npm run build
-npm publish
+# Todo en uno (publicación completa)
+npm run clean && npm run build && npm publish
+
+# Con bump de versión patch
+npm version patch && npm run clean && npm run build && npm publish
 ```
 
 ---
 
-**Última actualización:** 2025-10-16
+## 📌 Información del Package
+
+**Nombre:** `@tgtone/auth-sdk`  
+**Scope:** `@tgtone` (organización NPM)  
+**Versión actual:** 1.2.0  
+**Registry:** https://registry.npmjs.org  
+**Package URL:** https://www.npmjs.com/package/@tgtone/auth-sdk
+
+---
+
+**Última actualización:** 2025-11-03

package/docs/README.md

@@ -6,53 +6,28 @@
 
 ## 🚀 Quick Start
 
-**[⬆️ README principal](../README.md)** - Instalación y uso básico
+**[⬆️ README principal](../README.md)** - Instalación, API completa y ejemplos de uso
 
 ---
 
-## 📖 Guías de Integración
+## 📖 Guías Disponibles
 
 ### **[LOVABLE_QUICK_START.md](./LOVABLE_QUICK_START.md)** ⭐
-Guía para Lovable/React:
-- Setup en 5 minutos
-- Código completo listo para copiar
-- Testing sin pasar por login
-- Configuración recomendada
+Guía específica para Lovable/React:
+- Setup rápido con ejemplos
+- Uso de hooks
+- Gestión de sesión
+- Roles y permisos
 
 ### **[INTEGRATION_EXAMPLES.md](./INTEGRATION_EXAMPLES.md)**
 Ejemplos para otros frameworks:
-- Vue.js / Nuxt
+- Vue.js
 - Next.js (App Router)
-- Vanilla JavaScript
-
----
-
-## 🛠️ Configuración
+- Angular 17+
+- Configuración por app
 
 ### **[NPM_PUBLISH.md](./NPM_PUBLISH.md)**
-Guía para publicar actualizaciones en NPM
-
-### **[SDK_FINAL_STATUS.md](./SDK_FINAL_STATUS.md)**
-Estado actual del SDK y estructura de archivos
-
----
-
-## 🔧 Estructura del SDK
-
-```
-sdk/
-├── tgtone-auth-client.ts       # SDK principal (Bearer Token)
-├── react-hook.tsx              # Hook de React (opcional)
-├── index.ts                    # Exports
-├── package.json                # v1.0.2
-├── README.md                   # Guía principal
-└── docs/                       # Documentación completa
-    ├── README.md               # Este archivo
-    ├── LOVABLE_QUICK_START.md
-    ├── INTEGRATION_EXAMPLES.md
-    ├── NPM_PUBLISH.md
-    └── SDK_FINAL_STATUS.md
-```
+Guía para publicar actualizaciones del SDK a npm
 
 ---
 
@@ -60,24 +35,21 @@ sdk/
 
 | Quiero... | Ver |
 |-----------|-----|
-| Usarlo en Lovable ahora | [LOVABLE_QUICK_START.md](./LOVABLE_QUICK_START.md) |
-| Ver API completa | [README.md](../README.md) |
-| Ejemplos Vue/Next | [INTEGRATION_EXAMPLES.md](./INTEGRATION_EXAMPLES.md) |
-| Publicar actualización | [NPM_PUBLISH.md](./NPM_PUBLISH.md) |
+| Instalar y usar en cualquier app | [README.md](../README.md) |
+| Integrar en Lovable/React | [LOVABLE_QUICK_START.md](./LOVABLE_QUICK_START.md) |
+| Ejemplos Vue/Next/Angular | [INTEGRATION_EXAMPLES.md](./INTEGRATION_EXAMPLES.md) |
+| Publicar nueva versión | [NPM_PUBLISH.md](./NPM_PUBLISH.md) |
 
 ---
 
 ## 🔐 Información Clave
 
-**Autenticación:** JWT + Bearer Token en Authorization header  
+**Versión Actual:** 1.2.0  
+**Autenticación:** JWT + Bearer Token (Authorization header)  
 **Storage:** localStorage (`tgtone_auth_token`)  
-**Redirect:** Automático con parámetro `?token=` en URL  
-**CORS:** Backend tiene CORS abierto en staging  
-
-**Versión Actual:** 1.0.2  
-**Backend Staging:** https://tgtone-identity-backend-1086175589490.us-central1.run.app  
-**Backend Producción:** (Pendiente configurar identity.tgtone.cl)
+**Backend:** https://tgtone-console-backend.run.app/api  
+**Identity:** https://identity.tgtone.cl  
 
 ---
 
-**Última actualización:** 2025-10-16
+**Última actualización:** 2025-11-03

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tgtone/auth-sdk",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "SDK de autenticación JWT + Bearer Token para el ecosistema TGT One",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/docs/SDK_FINAL_STATUS.md

@@ -1,88 +0,0 @@
-# ✅ SDK Organizado - Resumen Final
-
-## 📁 Estructura Actual
-
-```
-sdk/
-├── README.md                   # ✅ Guía principal (simplificado, 70 líneas)
-├── package.json                # ✅ Actualizado (v1.0.2, incluye docs/)
-├── tsconfig.json
-├── index.ts                    # Entry point
-├── tgtone-auth-client.ts       # ✅ SDK (limpio, sin cookies)
-├── react-hook.tsx              # Hook React
-├── .npmignore
-├── dist/                       # Archivos compilados
-└── docs/
-    ├── README.md               # ✅ Índice de documentación
-    ├── LOVABLE_QUICK_START.md  # ✅ Guía para Lovable
-    ├── INTEGRATION_EXAMPLES.md # Ejemplos otros frameworks
-    ├── CHANGELOG.md            # Historial versiones
-    ├── ORGANIZATION_SUMMARY.md # Este resumen
-    └── README_OLD.md           # Archivo (referencia)
-```
-
----
-
-## ✅ Cambios Completados
-
-### 1. Código SDK
-- ✅ Eliminado `credentials: 'include'` (ya no usamos cookies)
-- ✅ Solo Bearer Token en Authorization header
-- ✅ localStorage para guardar tokens
-
-### 2. Documentación
-- ✅ README.md simplificado (70 líneas vs 391)
-- ✅ Creada carpeta `docs/` con toda la doc organizada
-- ✅ `LOVABLE_QUICK_START.md` - Guía específica para Lovable
-- ✅ `docs/README.md` - Índice completo
-- ✅ README antiguo archivado como referencia
-
-### 3. Package.json
-- ✅ Versión actualizada: `1.0.1` → `1.0.2`
-- ✅ Descripción actualizada: "JWT + Bearer Token"
-- ✅ Files incluye carpeta `docs/`
-
----
-
-## 📖 Guía de Uso
-
-### Para desarrollar en Lovable
-1. Leer: `docs/LOVABLE_QUICK_START.md`
-2. Copiar: `tgtone-auth-client.ts` a tu proyecto
-3. Usar código de ejemplo
-
-### Para instalar vía NPM
-```bash
-npm install tgtone-auth-client
-```
-
-Ver: `README.md`
-
-### Para otros frameworks
-Ver: `docs/INTEGRATION_EXAMPLES.md`
-
----
-
-## 🎯 Documentación por Necesidad
-
-| Necesitas... | Archivo |
-|--------------|---------|
-| Setup rápido | `README.md` |
-| Lovable/React | `docs/LOVABLE_QUICK_START.md` |
-| Vue/Next/Angular | `docs/INTEGRATION_EXAMPLES.md` |
-| API completa | `README.md` + `docs/README_OLD.md` |
-| Ver cambios | `docs/CHANGELOG.md` |
-
----
-
-## 🚀 Listo para Usar
-
-El SDK está completamente organizado y listo para:
-- ✅ Copiar archivo directamente a Lovable
-- ✅ Instalar vía NPM (si está publicado)
-- ✅ Integrar en cualquier framework
-- ✅ Testing con tokens manuales
-
----
-
-**Última actualización:** 2025-10-16