infodocviewdoc 2.0.4 → 3.0.0

package/README.md

@@ -1,6 +1,6 @@
 # MFE Document Viewer Integration Guide
 
-`infodocviewdoc` es una librería Angular para previsualizar documentos en microfrontends SGDEA.
+`infodocviewdoc` es una librería Angular para previsualizar documentos en microfrontends.
 
 ## 1) Instalacion del paquete (ultima version)
 
@@ -15,7 +15,7 @@ Si tu MFE ya existe (con Angular y dependencias base), **solo debes agregar esta
 ```json
 {
   "dependencies": {
-    "infodocviewdoc": "2.0.4",
+    "infodocviewdoc": "3.0.0",
     "@handsontable/angular": "^16.2.0",
     "handsontable": "^16.2.0",
     "jspdf": "^4.1.0",
@@ -50,7 +50,7 @@ Si creas un microfront desde cero, ademas de Angular/base, tu bloque de `depende
     "rxjs": "~7.8.0",
     "tslib": "2.3.0",
     "zone.js": "~0.15.0",
-    "infodocviewdoc": "^2.0.4",
+    "infodocviewdoc": "^3.0.0",
     "@handsontable/angular": "^16.2.0",
     "handsontable": "^16.2.0",
     "jspdf": "^4.1.0",
@@ -140,31 +140,43 @@ export class PdfPreviewModalComponent {}
 
 ```html
 <sgdea-document-viewer
+  [fileBlob]="blob"
+  [fileBlobName]="fileName"
   [url]="apiUrl"
-  [nameFile]="objectName"
-  [nameBucket]="bucketName"
-  [nameSpaceBucket]="''"
-  [token]="token">
+  [token]="token"
+  [pdfAssetsBaseUrl]="'https://mi-dominio.com/assets'">
 </sgdea-document-viewer>
 ```
 
 ## 5) Inputs del componente
 
-- `url`: base URL del microservicio de archivos (ej: `https://host-backend`)
-- `nameFile`: ruta/nombre del archivo en bucket (`objectName`)
-- `nameBucket`: nombre del bucket (ej: `attachments`)
-- `nameSpaceBucket`: namespace (si aplica; puede ir vacio)
-- `token`: JWT para `Authorization: Bearer <token>`
-- `pdfAssetsBaseUrl` (opcional): URL base donde el host publica los assets de `ngx-extended-pdf-viewer` (p. ej. `https://mi-app.com/assets`). Si no se define, se usa CDN o, si estan copiados en el build, la ruta por defecto del viewer.
+- `fileBlob`: `File | Blob` del documento ya resuelto por el microfront (requerido).
+- `fileBlobName` (opcional): nombre del archivo para inferir la extensión (p. ej. `documento.pdf`).
+- `url` (requerido solo para Office->PDF): base URL del microservicio de conversión (ej: `https://host-backend`).
+- `token` (requerido solo para Office->PDF): JWT para `Authorization: Bearer <token>`.
+- `pdfAssetsBaseUrl` (opcional): URL base donde el host publica los assets de `ngx-extended-pdf-viewer` (p. ej. `https://mi-app.com/assets`).
 
-## 6) Consideraciones de integracion en MFE
+Notas:
+- Para PDFs/imágenes/texto/Excel el visor renderiza el `fileBlob` directamente.
+- Para Word/PowerPoint el visor llama al microservicio de conversión y requiere `url` y `token`.
 
-- El componente prioriza `@Input()`; si no llegan valores por inputs, usa `queryParams` como fallback.
+## 6) Checklist de integración (microfront)
+
+1. **Tu microfront descarga/prepara el archivo** y le pasa el contenido al componente con `[fileBlob]`.
+2. **Opcional pero recomendado:** pasa `[fileBlobName]` para que el visor detecte la extensión con precisión (especialmente en blobs cuyo `type` es vacío o genérico).
+3. Si el documento es **Office (doc/docx/ppt/pptx)**, el microfront debe pasar `[url]` y `[token]` para que el visor ejecute la conversión a PDF.
+4. Verifica en red que el visor carga `viewer-*.mjs` y workers:
+   - recomendado: copiar `node_modules/ngx-extended-pdf-viewer/assets` al build vía `angular.json` (ver sección 3).
+   - alternativa: usar fallback CDN o definir `[pdfAssetsBaseUrl]`.
+
+## 7) Consideraciones de integracion en MFE
+
+- El componente requiere `[fileBlob]` para renderizar.
 - En modales, usa contenedor con `height` definido y `overflow` para Excel grandes.
 - Para obtener token en host, puedes usar `localStorage` o tu servicio de autenticacion central.
-- Mantener contrato estable: ruta y forma de datos enviados al visor via inputs.
+- Mantener contrato estable: forma de datos enviados al visor via inputs (`[fileBlob]`, `[fileBlobName]`, y `[url]`/`[token]` solo para Office->PDF).
 
-## 7) Formatos soportados por el visor
+## 8) Formatos soportados por el visor
 
 - Procesamiento de texto: `.docx`, `.doc`
 - Hojas de calculo: `.xlsx`, `.xls`
@@ -173,7 +185,7 @@ export class PdfPreviewModalComponent {}
 - Texto plano: `.txt`
 - Imagenes: `.jpg`, `.png`, `.tiff`, `.gif`
 
-## 8) Ejemplo rapido de instalacion local (desarrollo)
+## 9) Ejemplo rapido de instalacion local (desarrollo)
 
 Desde el repositorio de la libreria:
 
@@ -189,7 +201,7 @@ En el MFE host:
 npm install "C:/ruta/a/infodocviewdoc-<version>.tgz"
 ```
 
-## 9) Public API exportada
+## 10) Public API exportada
 
 `public-api.ts` exporta:
 
@@ -200,4 +212,4 @@ npm install "C:/ruta/a/infodocviewdoc-<version>.tgz"
 Si integras este paquete en otro microfront, valida primero:
 1. dependencias del host,
 2. assets de `ngx-extended-pdf-viewer` en `angular.json` del target de build (recomendado) o, si no, que el entorno permita el fallback CDN / `pdfAssetsBaseUrl`,
-3. envio correcto de `url`, `nameFile`, `nameBucket` y `token`.
+3. envio correcto de `fileBlob`/`fileBlobName`; y `url`/`token` **solo** si el archivo es Office (para conversión).