valtech-components 4.0.987 → 4.0.989

package/lib/components/organisms/attachment-uploader/attachment-uploader.component.d.ts

@@ -9,6 +9,7 @@ export declare class AttachmentUploaderComponent implements OnInit {
     attachmentsChange: import("@angular/core").OutputEmitterRef<AttachmentItem[]>;
     protected i18n: I18nService;
     private feedbackService;
+    private imageService;
     attachments: import("@angular/core").WritableSignal<AttachmentItem[]>;
     showCameraOverlay: import("@angular/core").WritableSignal<boolean>;
     private cameraStream;
@@ -26,6 +27,19 @@ export declare class AttachmentUploaderComponent implements OnInit {
     onFilesSelected(event: Event): Promise<void>;
     private processFiles;
     private compressImage;
+    /**
+     * Genera y sube la miniatura de una imagen ya comprimida.
+     *
+     * Recibe el archivo COMPRIMIDO a propósito: `compressorjs` ya normalizó la
+     * orientación EXIF, y `ImageService` trabaja sobre canvas sin leer EXIF — si
+     * se le pasara el original, las fotos verticales de teléfono saldrían
+     * rotadas. Ver la nota en `generateThumbnail` (types.ts).
+     *
+     * Nunca es fatal: si falla, el adjunto queda subido sin miniatura y las
+     * listas caen al archivo grande. Perder la miniatura no justifica perder la
+     * foto que el usuario acaba de subir.
+     */
+    private uploadThumbnail;
     private uploadFile;
     remove(id: string): void;
     thumbFailed(id: string): void;

package/lib/components/organisms/attachment-uploader/types.d.ts

@@ -3,6 +3,13 @@ export interface AttachmentItem {
     file?: File;
     status: 'uploading' | 'ready' | 'error';
     url?: string;
+    /**
+     * URL de la miniatura, presente solo si se pidió `generateThumbnail` y el
+     * archivo es una imagen. Es la que deben usar las LISTAS: `url` apunta al
+     * archivo de hasta 1920px, y pedirlo para pintar un recuadro de 84px es la
+     * diferencia entre 240KB y 15KB por fila. Ver `generateThumbnail`.
+     */
+    thumbnailUrl?: string;
     error?: string;
     isExternal?: boolean;
 }
@@ -16,6 +23,29 @@ export interface AttachmentUploaderMetadata {
     disabled?: boolean;
     /** Compress images before upload (default: true). PDFs are never compressed. */
     compressImages?: boolean;
+    /**
+     * Genera y sube además una miniatura cuadrada por cada imagen, y la expone en
+     * `AttachmentItem.thumbnailUrl` (default: false).
+     *
+     * Por qué es opt-in y no el default: sube DOS archivos por imagen en vez de
+     * uno, y no todo consumer quiere pagar ese costo (ni tener el archivo extra
+     * en su bucket). Actívalo cuando las fotos se muestren en una lista o grilla,
+     * que es donde el ahorro es real.
+     *
+     * La miniatura se genera a partir del archivo YA comprimido, no del original:
+     * `compressorjs` normaliza la orientación EXIF al comprimir, así que a esa
+     * altura la imagen ya está derecha. Generarla del original la sacaría rotada
+     * en las fotos verticales de teléfono (ImageService usa canvas y no lee EXIF).
+     */
+    generateThumbnail?: boolean;
+    /** Lado de la miniatura en píxeles (default: 320). Cuadrada, recorte centrado. */
+    thumbnailSize?: number;
+    /**
+     * Función de subida de la miniatura. Si se omite, se usa `uploadFn` con un
+     * File renombrado a `<nombre>-thumb.jpg` — así el consumer que deriva la ruta
+     * del nombre del archivo no necesita hacer nada.
+     */
+    thumbnailUploadFn?: (file: File) => Promise<string>;
     /** Upload function. If omitted, falls back to FeedbackService.uploadAttachment. */
     uploadFn?: (file: File) => Promise<string>;
     /** URLs de items ya subidos — se pre-seedean como items 'ready' al montar. */

package/lib/components/organisms/request-review-panel/request-review-panel.component.d.ts

@@ -1,83 +1,79 @@
-import { OnInit } from '@angular/core';
-import { AppRequest, RequestComment } from '../../../services/requests/types';
-import { EmptyStateMetadata } from '../../molecules/empty-state/types';
+import { EventEmitter, TemplateRef } from '@angular/core';
+import { ComponentState } from '../../types';
+import { RequestReviewDecision, RequestReviewItem, RequestReviewPanelMetadata } from './types';
 import * as i0 from "@angular/core";
-interface StatusStyle {
-    bg: string;
-    color: string;
-}
-/**
- * Config del "entity hero" (bloque opcional arriba del status: ej. animal en
- * Chesed, receta en Mealplan). Agnóstico al dominio — cada app declara de qué
- * campos de `metadata` sacar nombre/imagen y a dónde navegar.
- */
-export interface RequestReviewEntityHeroConfig {
-    labelKey: string;
-    nameField: string;
-    imageField?: string;
-    placeholderIcon?: string;
-    canNavigate: (metadata: Record<string, any>) => boolean;
-    navigate: (metadata: Record<string, any>) => void;
-}
-export interface RequestReviewPanelConfig {
-    /** Namespace i18n donde viven las keys (status_*, approve, reject, submitter, fields, commentsTitle, noComments, submittedAt, statusUpdated, statusError, errorTitle, offlineTitle, offlineHint, retry, viewAnimal). */
-    i18nNamespace: string;
-    entityHero?: RequestReviewEntityHeroConfig;
-    /** Si el usuario actual puede aprobar/rechazar (ej. persona.isPublisher()). */
-    canReview: () => boolean;
-    /** CTA post-aprobación para quien NO revisa (ej. "ver receta"/"ver animal"). */
-    viewEntityCtaLabelKey?: string;
-}
 /**
- * Panel de revisión de una Request genérica (ADR-061/062): status + acciones
- * approve/reject + fields del formulario + comentarios. Config-driven, sin
- * conocimiento del dominio (adoption, recipe_verification, etc.) — cada
- * consumer inyecta su `RequestReviewPanelConfig`.
+ * val-request-review-panel — cola de revisión del factory (ADR-062).
+ *
+ * Es **presentacional**: no carga datos, no conoce el backend ni el dominio. El
+ * consumer le pasa la cola ya normalizada y escucha `(decision)`.
+ *
+ * ## Por qué el cuerpo va proyectado y no configurado
+ *
+ * El ADR original proponía describir el cuerpo con arrays de nombres de campo
+ * (`fields.display: ['taxId', 'tagsRequested']`). Al implementarlo con los dos
+ * consumidores reales delante quedó claro que eso reinventa un motor de
+ * templating peor que Angular: Chesed necesita una lista de documentos con
+ * iconos y `target="_blank"`, Okhelia un enlace a la receta y un input de
+ * comentario. Ninguna lista de strings expresa eso sin agregarle un flag al
+ * componente por cada caso nuevo.
+ *
+ * Entonces el panel es dueño de lo que **de verdad** se repite — la cáscara, el
+ * chrome de la card, y la mecánica de decisión — y el cuerpo de cada ítem lo
+ * escribe cada vertical en un `ng-template` con su propio HTML.
+ *
+ * ```html
+ * <val-request-review-panel [props]="panelProps()" [itemBody]="body"
+ *                           (decision)="onDecision($event)" />
+ *
+ * <ng-template #body let-item>
+ *   <a [routerLink]="['/app/recetas', recipeIdOf(item)]">Ver receta</a>
+ * </ng-template>
+ * ```
+ *
+ * ## Rechazo con motivo
+ *
+ * El flujo de dos pasos (Rechazar → escribir motivo → Confirmar) es del panel,
+ * no del consumer, y está activo por defecto. Rechazar de un click deja al
+ * solicitante sin saber qué corregir; era el único de los dos paneles que lo
+ * tenía bien resuelto y ahora lo heredan los dos.
  */
-export declare class RequestReviewPanelComponent implements OnInit {
-    private requests;
+export declare class RequestReviewPanelComponent {
     private i18n;
-    private errors;
-    private toast;
-    private destroyRef;
-    readonly requestId: import("@angular/core").InputSignal<string>;
-    readonly config: import("@angular/core").InputSignal<RequestReviewPanelConfig>;
-    readonly loaded: import("@angular/core").OutputEmitterRef<AppRequest>;
-    private readonly _req;
-    private readonly _loading;
-    private readonly _loadError;
-    private readonly _comments;
-    private readonly _loadingComments;
-    private readonly _transitioning;
-    readonly req: import("@angular/core").Signal<AppRequest>;
-    readonly loading: import("@angular/core").Signal<boolean>;
-    readonly loadError: import("@angular/core").Signal<unknown>;
-    readonly comments: import("@angular/core").Signal<RequestComment[]>;
-    readonly loadingComments: import("@angular/core").Signal<boolean>;
-    readonly transitioning: import("@angular/core").Signal<boolean>;
-    readonly heroImgFailed: import("@angular/core").WritableSignal<boolean>;
-    readonly heroConfig: import("@angular/core").Signal<RequestReviewEntityHeroConfig>;
-    readonly statusStyle: import("@angular/core").Signal<StatusStyle>;
-    readonly heroName: import("@angular/core").Signal<string>;
-    readonly heroImage: import("@angular/core").Signal<string>;
-    readonly canNavigateHero: import("@angular/core").Signal<boolean>;
-    readonly submitterInitial: import("@angular/core").Signal<string>;
-    readonly fieldEntries: import("@angular/core").Signal<{
-        key: string;
-        value: string;
-    }[]>;
-    readonly errorState: import("@angular/core").Signal<EmptyStateMetadata>;
+    readonly props: import("@angular/core").InputSignal<RequestReviewPanelMetadata>;
+    /**
+     * Cuerpo de cada card. El contexto trae el ítem como `$implicit` y también
+     * como `item`, para que el consumer pueda usar `let-item` o `let-x="item"`.
+     */
+    itemBody?: TemplateRef<{
+        $implicit: RequestReviewItem;
+        item: RequestReviewItem;
+    }>;
+    decision: EventEmitter<RequestReviewDecision>;
+    /** ID del ítem cuyo formulario de rechazo está abierto. */
+    private readonly _rejectingId;
+    readonly rejectingId: import("@angular/core").Signal<string>;
+    private readonly _reason;
+    readonly reason: import("@angular/core").Signal<string>;
+    readonly cfg: import("@angular/core").Signal<RequestReviewPanelMetadata>;
+    readonly skeletonRows: import("@angular/core").Signal<number[]>;
+    /** Hay una decisión en vuelo: toda la cola se congela. */
+    readonly isBusy: import("@angular/core").Signal<boolean>;
     constructor();
-    ngOnInit(): void;
-    load(): Promise<void>;
-    private subscribeComments;
-    transition(status: 'approved' | 'rejected'): Promise<void>;
-    onHeroClick(): void;
-    formatDate(iso: string): string;
-    authorInitial(c: RequestComment): string;
-    relativeTime(iso: string): string;
-    t(key: string): string;
+    protected t(key: string): string;
+    /** El ítem en vuelo muestra WORKING; los demás quedan deshabilitados. */
+    private stateFor;
+    protected approveState(item: RequestReviewItem): ComponentState;
+    /**
+     * Confirmar el rechazo exige motivo cuando `requireRejectReason` está activo
+     * (el default). Es el freno que evita la notificación de rechazo vacía.
+     */
+    protected confirmRejectState(item: RequestReviewItem): ComponentState;
+    protected onReasonInput(event: Event): void;
+    protected startReject(item: RequestReviewItem): void;
+    protected cancelReject(): void;
+    protected confirmReject(item: RequestReviewItem): void;
+    protected approve(item: RequestReviewItem): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RequestReviewPanelComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RequestReviewPanelComponent, "val-request-review-panel", never, { "requestId": { "alias": "requestId"; "required": true; "isSignal": true; }; "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "loaded": "loaded"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RequestReviewPanelComponent, "val-request-review-panel", never, { "props": { "alias": "props"; "required": true; "isSignal": true; }; "itemBody": { "alias": "itemBody"; "required": false; }; }, { "decision": "decision"; }, never, never, true, never>;
 }
-export {};

package/lib/components/organisms/request-review-panel/request-review-panel.i18n.d.ts

@@ -0,0 +1,2 @@
+import { LanguagesContent } from '../../../services/i18n';
+export declare const REQUEST_REVIEW_PANEL_I18N: LanguagesContent;

package/lib/components/organisms/request-review-panel/types.d.ts

@@ -0,0 +1,73 @@
+import { EmptyStateMetadata } from '../../molecules/empty-state/types';
+/**
+ * Un ítem de la cola de revisión, ya normalizado por el consumer.
+ *
+ * Deliberadamente pobre: id, título y unas líneas de metadata. Todo lo que sea
+ * del dominio (el RUT del criadero, los tags de la receta, los documentos
+ * adjuntos) va en el cuerpo proyectado, no acá — la lib no aprende qué es una
+ * receta ni un criadero.
+ */
+export interface RequestReviewItem {
+    /** Identidad del ítem. Es lo que viaja en la decisión. */
+    id: string;
+    /** Encabezado de la card. */
+    title: string;
+    /**
+     * Líneas bajo el título (fecha de envío, identificador, estado). Texto ya
+     * resuelto y formateado por el consumer: la lib no traduce ni formatea fechas.
+     */
+    meta?: string[];
+}
+/** Lo que emite el panel cuando el revisor decide. */
+export interface RequestReviewDecision {
+    itemId: string;
+    approved: boolean;
+    /**
+     * Motivo del rechazo. Presente solo al rechazar con `requireRejectReason`
+     * activo (el default), donde el panel garantiza que no viene vacío.
+     */
+    reason?: string;
+}
+export interface RequestReviewPanelMetadata {
+    /** La cola. Vacía + `loading: false` muestra el estado vacío. */
+    items: RequestReviewItem[];
+    /** Muestra el skeleton en vez de la lista. */
+    loading?: boolean;
+    /** Filas del skeleton (default: 3). */
+    skeletonRows?: number;
+    /**
+     * Estado de error de la carga. Tiene prioridad sobre todo lo demás — un panel
+     * que no pudo cargar no debe mostrar "no hay nada pendiente", que es una
+     * afirmación distinta y falsa.
+     */
+    errorState?: EmptyStateMetadata | null;
+    /** Estado cuando la cola está vacía de verdad. */
+    emptyState?: EmptyStateMetadata;
+    /**
+     * Línea de conteo sobre la lista, ya compuesta por el consumer
+     * ("3 pendientes"). Sin ella no se muestra nada.
+     */
+    countLabel?: string;
+    /**
+     * ID del ítem con una decisión en vuelo. Ese ítem muestra su acción en
+     * `WORKING` y el resto queda deshabilitado: dos decisiones simultáneas sobre
+     * la misma cola es justo lo que no se quiere.
+     */
+    busyItemId?: string;
+    /**
+     * Exigir un motivo escrito para rechazar (default: **true**).
+     *
+     * Es el default a propósito. Rechazar sin explicación deja al solicitante sin
+     * saber qué corregir, y la notificación de decisión sale vacía. Ponerlo en
+     * `false` es una decisión explícita del consumer, no un olvido.
+     */
+    requireRejectReason?: boolean;
+    /** Etiquetas. Todas opcionales — la lib trae defaults es/en. */
+    approveLabel?: string;
+    rejectLabel?: string;
+    cancelLabel?: string;
+    confirmRejectLabel?: string;
+    rejectReasonLabel?: string;
+    rejectReasonPlaceholder?: string;
+    rejectReasonHint?: string;
+}

package/lib/components/organisms/survey-response/survey-response.component.d.ts

@@ -41,6 +41,7 @@ export declare class SurveyResponseComponent implements OnInit {
     readonly sending: import("@angular/core").WritableSignal<boolean>;
     readonly typeConfig: import("@angular/core").WritableSignal<RequestTypeConfig>;
     readonly multiSelectError: import("@angular/core").WritableSignal<boolean>;
+    readonly alreadyAnswered: import("@angular/core").WritableSignal<boolean>;
     readonly nameControl: FormControl<string>;
     readonly emailControl: FormControl<string>;
     private form;
@@ -106,6 +107,7 @@ export declare class SurveyResponseComponent implements OnInit {
     needsIdentity(): boolean;
     readonly submitState: import("@angular/core").Signal<"ENABLED" | "WORKING">;
     submit(): Promise<void>;
+    readonly alreadyAnsweredState: import("@angular/core").Signal<EmptyStateMetadata>;
     readonly sentState: import("@angular/core").Signal<EmptyStateMetadata>;
     readonly loadErrorState: import("@angular/core").Signal<EmptyStateMetadata>;
     readonly loginRequiredState: import("@angular/core").Signal<EmptyStateMetadata>;

package/lib/components/organisms/survey-response/types.d.ts

@@ -1,6 +1,12 @@
 export interface SurveyResponseMetadata {
     /** El `TypeID` del RequestTypeConfig (convención: `"survey:<slug>"`). */
     typeId: string;
+    /**
+     * Token de invitación (`?i=` del link del correo). Lo pasa el consumer desde
+     * la query de la ruta; el componente solo lo reenvía al backend, que decide
+     * si esa invitación sigue disponible.
+     */
+    inviteToken?: string;
 }
 export interface SurveyResponseSubmitEvent {
     requestId: string;

package/lib/services/requests/types.d.ts

@@ -95,6 +95,12 @@ export interface CreateRequestPayload {
     priority?: string;
     /** Para solicitudes anónimas */
     submitter?: RequestActor;
+    /**
+     * El `?i=` del link que le llegó por correo a quien responde. Con token, la
+     * invitación se consume y no admite una segunda respuesta; sin token (el QR
+     * abierto de un evento) se responde sin límite.
+     */
+    inviteToken?: string;
     dueAt?: string;
 }
 export interface UpdateRequestPayload {

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "4.0.987";
+export declare const VERSION = "4.0.989";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "4.0.987",
+  "version": "4.0.989",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -242,6 +242,8 @@ export * from './lib/components/organisms/survey-response/survey-response.compon
 export * from './lib/components/organisms/survey-response/types';
 export * from './lib/components/organisms/field-schema-editor/field-schema-editor.component';
 export * from './lib/components/organisms/field-schema-editor/types';
+export * from './lib/components/organisms/request-review-panel/request-review-panel.component';
+export * from './lib/components/organisms/request-review-panel/types';
 export * from './lib/components/organisms/survey-builder/survey-builder.component';
 export * from './lib/components/organisms/survey-builder/types';
 export * from './lib/components/molecules/empty-state/empty-state.component';
@@ -269,7 +271,6 @@ export * from './lib/components/organisms/share-profile-modal/share-profile-moda
 export * from './lib/components/organisms/share-profile-modal/types';
 export * from './lib/components/organisms/fun-modal/fun-modal.component';
 export * from './lib/components/organisms/request-modal/request-modal.component';
-export * from './lib/components/organisms/request-review-panel/request-review-panel.component';
 export * from './lib/components/organisms/fun-modal/types';
 export * from './lib/components/organisms/cookie-banner/cookie-banner.component';
 export * from './lib/components/organisms/cookie-banner/types';