@utilia-os/sdk-js 1.5.0 → 1.10.0

package/README.md

@@ -179,6 +179,64 @@ console.log(stats.bySeverity);   // { critical: 5, high: 10, ... }
 console.log(stats.byModule);     // { auth: 3, payments: 7, ... }
 ```
 
+### Configuración pública de la organización
+
+Desde la versión 1.10.0, puedes leer los datos públicos de la organización
+(branding, valores fiscales por defecto, contacto) sin necesidad de permisos
+de administración. Útil para auto-rellenar formularios de presupuestos,
+conocer el impuesto local del tenant o mostrar el logo en un portal externo:
+
+```typescript
+const settings = await sdk.organizationSettings.getPublicSettings();
+
+console.log(settings.companyName);        // "UTILIA"
+console.log(settings.defaultCurrency);    // "EUR"
+console.log(settings.defaultTaxName);     // "IVA"
+console.log(settings.defaultTaxRate);     // 21
+console.log(settings.country);            // "ES"
+console.log(settings.timezone);           // "Atlantic/Canary"
+console.log(settings.logoUrl);            // URL presignada fresca
+```
+
+Campos incluidos: identidad corporativa, domicilio social y operativo,
+canales de contacto dinámicos, datos bancarios, configuración fiscal por
+defecto (impuesto, tasa, país, moneda), timezone, branding (colores, logos)
+y la configuración visual personalizada para PDFs de presupuestos.
+
+Los metadatos internos (id, createdAt, updatedAt, updatedById) y los emails
+legacy (emailSupport, emailHr, etc.) no se exponen en esta respuesta; los
+emails legacy se transforman automáticamente a `contactChannels` por
+retrocompatibilidad.
+
+## OAuth y Sign In
+
+Desde la versión 1.6.0, el SDK incluye soporte nativo para OAuth 2.1 con PKCE. Esto permite implementar "Iniciar sesión con UTILIA" en tu aplicación:
+
+```typescript
+const sdk = new UtiliaSDK({
+  baseURL: 'https://os.utilia.ai/api',
+  oauth: {
+    clientId: 'client_xxxxxxxxxx',
+    redirectUri: 'http://localhost:3000/callback',
+    scopes: ['openid', 'profile', 'email'],
+  },
+});
+
+// Redirigir al usuario para autorizar
+const authUrl = await sdk.oauth.getAuthorizationUrl();
+window.location.href = authUrl;
+
+// Opcionalmente, solicitar un tema específico para la pantalla de consentimiento
+const darkUrl = await sdk.oauth.getAuthorizationUrl({ theme: 'dark' });
+window.location.href = darkUrl;
+
+// En la página de callback
+const tokens = await sdk.oauth.handleCallback(code);
+const userInfo = await sdk.oauth.getUserInfo();
+```
+
+Documentación completa: https://os.utilia.ai/dashboard/docs/integraciones-sdk/sdk-js-guia-oauth
+
 ## Manejo de Errores
 
 ```typescript