ngx-dsxlibrary 2.21.5 → 2.21.7

package/README.md

@@ -20,6 +20,31 @@ Si estas versiones no coinciden (o no son compatibles), pueden aparecer errores
 
 ## Guía para consumidores
 
+### Envío de archivos al backend (POST)
+
+Si tu endpoint del backend recibe datos por formulario multipart (por ejemplo `[FromForm]` en ASP.NET Core), puedes usar `HttpHelpersService`.
+
+Este servicio convierte automáticamente el objeto a `FormData`, así que permite enviar campos normales y archivos en una sola petición.
+
+```ts
+import { HttpHelpersService } from 'ngx-dsxlibrary';
+
+constructor(private httpHelpers: HttpHelpersService) {}
+
+subirArchivo(file: File | null) {
+  return this.httpHelpers.post<{ ok: boolean; mensaje: string }>('documentos/subir', {
+    documentoId: 10,
+    nombre: 'Contrato',
+    archivo: file,
+  });
+}
+```
+
+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.
+
 ### Fuentes compartidas (@font-face)
 
 La librería expone un archivo CSS con `@font-face` para que cualquier proyecto consumidor lo importe una sola vez.

package/fesm2022/ngx-dsxlibrary.mjs

@@ -3650,9 +3650,52 @@ function toFormData(data, formData = new FormData(), parentKey) {
  */
 class HttpHelpersService {
     http = inject(HttpClient);
-    post(url, data) {
+    /**
+     * POST orientado a endpoints `[FromForm]` en backend (ASP.NET Core u otros).
+     *
+     * Convierte automáticamente `data` a `FormData`, por lo que permite enviar
+     * campos simples y archivos (`File`, `Blob`, `FileList`) en una sola llamada.
+     *
+     * Casos de uso comunes:
+     * - Crear/actualizar recursos con adjuntos.
+     * - Subir archivos junto con metadata (id, nombre, observaciones, etc.).
+     * - Mantener un único método de POST para formularios multipart.
+     *
+     * @typeParam T Tipo de respuesta esperada del backend.
+     * @param url Endpoint relativo o absoluto.
+     * @param data Objeto plano que se transformará a `FormData`.
+     * @returns `Observable<T>` con la respuesta del backend.
+     *
+     * @example
+     * this.httpHelpers.postForm<{ ok: boolean }>('documentos/subir', {
+     *   documentoId: 15,
+     *   descripcion: 'Contrato firmado',
+     *   archivo: this.archivoSeleccionado // File | null
+     * });
+     */
+    postForm(url, data) {
         return this.http.post(url, toFormData(data));
     }
+    /**
+     * PUT orientado a endpoints `[FromForm]` en backend (ASP.NET Core u otros).
+     *
+     * Equivalente a `postForm`, pero usando el verbo HTTP PUT para actualizar recursos existentes.
+     *
+     * @typeParam T Tipo de respuesta esperada del backend.
+     * @param url Endpoint relativo o absoluto.
+     * @param data Objeto plano que se transformará a `FormData`.
+     * @returns `Observable<T>` con la respuesta del backend.
+     *
+     * @example
+     * this.httpHelpers.putForm<{ ok: boolean }>('documentos/actualizar/15', {
+     *   documentoId: 15,
+     *   descripcion: 'Contrato actualizado',
+     *   archivo: this.archivoSeleccionado // File | null
+     * });
+     */
+    putForm(url, data) {
+        return this.http.put(url, toFormData(data));
+    }
     /**
      * GET para descarga de archivos en formato Blob.
      * Útil cuando solo se necesita el contenido del archivo.