ngx-dsxlibrary 2.21.71 → 2.21.73

package/README.md

@@ -45,6 +45,57 @@ Notas:
 - Si el archivo viene en `null` o `undefined`, ese campo se omite del `FormData`.
 - Es ideal para simplificar flujos de carga de archivos con metadata.
 
+### Guardado y subida con `SaveEntityPostFileService`
+
+La librería incluye un helper para flujos comunes donde se guarda una entidad
+y, opcionalmente, se sube un archivo después de obtener el ID generado: el
+servicio `SaveEntityPostFileService`.
+
+- Resetea el formulario automáticamente cuando TODO (guardado + subida)
+  finaliza con éxito.
+- Muestra diálogos amigables en errores controlados mediante `DsxMessagesService`.
+- Acepta un flag `viewLog` para imprimir respuestas en consola en entornos
+  no productivos.
+
+Uso básico:
+
+```ts
+import { SaveEntityPostFileService } from 'ngx-dsxlibrary';
+
+constructor(
+  private saveEntityPostFile: SaveEntityPostFileService,
+  private baseService: SomeEntityService,
+) {}
+
+// Guardar sin archivo
+this.saveEntityPostFile.saveOnly(
+  this.baseService.save(this.form.getRawValue()),
+  (response) => { /* éxito: response contiene ServiceResult<number> */ },
+  (error) => { /* manejar error */ },
+  () => this.form.reset(), // reset opcional
+);
+
+// Guardar y luego subir archivo
+const file = this.fileInput.files?.[0] ?? null;
+if (file) {
+  this.saveEntityPostFile.saveWithFile(
+    this.baseService.save(this.form.getRawValue()),
+    (id, f) => this.baseService.attachFile(id, f),
+    file,
+    (response) => { /* éxito: response de la subida */ },
+    (error) => { /* manejar error */ },
+    () => { this.form.reset(); this.clearFileInput(); },
+  );
+}
+```
+
+Consejos:
+
+- Si necesitas lógica personalizada al resetear el formulario, pasa una
+  función `resetForm` al servicio.
+- Para depuración local, activa `viewLog: true` en las llamadas para ver la
+  respuesta de `save` y `upload` en consola.
+
 ### Fuentes compartidas (@font-face)
 
 La librería expone un archivo CSS con `@font-face` para que cualquier proyecto consumidor lo importe una sola vez.