valtech-components 4.0.939 → 4.0.941

package/lib/components/organisms/form/form.component.d.ts

@@ -51,6 +51,30 @@ export declare class FormComponent implements OnInit, OnChanges, DoCheck {
     private previousUploadingCount;
     private uploadingFields;
     constructor(fb: FormBuilder, elementRef: ElementRef);
+    /** Arma la definición de controles (valor inicial + validadores) desde `props`. */
+    private buildFormControlsDef;
+    /**
+     * Reconstruye el `FormGroup` desde cero, con los valores iniciales de `props`
+     * actuales (no los que el usuario haya tecleado desde entonces).
+     *
+     * Existe para el caso en que Angular NO destruye el componente entre dos usos
+     * — típicamente `IonicRouteStrategy`, que cachea la página ruteada al navegar
+     * afuera y la reutiliza al volver sin correr `ngOnInit` de nuevo. Sin esto,
+     * un form de login mantiene lo que el usuario anterior tecleó después de
+     * cerrar sesión y volver a `/login`: el `FormGroup` se construyó UNA vez y
+     * nadie lo tocó desde entonces.
+     *
+     * Reconstruye el `FormGroup` entero (no `.reset(values)`) porque la
+     * definición trae `[valor, validators]` por control, no valores planos —
+     * reusar `buildFormControlsDef()` tal cual evita mantener dos formas de
+     * calcular "cuál es el valor inicial" que puedan desincronizarse.
+     *
+     * El caller (típicamente `val-login`, vía `ionViewWillEnter`) decide CUÁNDO
+     * llamarlo — acá no hay heurística de "cuándo resetear", porque un form de
+     * varios pasos sí podría querer conservar lo tecleado al volver a una
+     * pestaña.
+     */
+    resetForm(): void;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     private patchInitialValuesFromProps;

package/lib/components/organisms/login/login.component.d.ts

@@ -5,6 +5,7 @@ import { ImageMetadata } from '../../atoms/image/types';
 import { LoginMetadata, LoginSuccessEvent, LoginErrorEvent, MFARequiredEvent } from './types';
 import * as i0 from "@angular/core";
 export declare class LoginComponent implements OnInit, OnDestroy {
+    private forms;
     props: LoginMetadata;
     onSuccess: EventEmitter<LoginSuccessEvent>;
     onError: EventEmitter<LoginErrorEvent>;
@@ -125,6 +126,21 @@ export declare class LoginComponent implements OnInit, OnDestroy {
     private listenForOAuthReturn;
     private stopListeningForOAuthReturn;
     ngOnInit(): void;
+    /**
+     * Ionic (`IonicRouteStrategy`) no destruye la página de login al navegar
+     * afuera — la "detach"-ea y la reutiliza si el usuario vuelve a la misma
+     * ruta, así que `ngOnInit` no vuelve a correr. `val-form` arma su
+     * `FormGroup` UNA sola vez en su propio `ngOnInit`; sin este hook, cerrar
+     * sesión y volver a `/login` mostraba el email y la contraseña que la
+     * sesión anterior había tecleado.
+     *
+     * `ionViewWillEnter` es el gancho de Ionic pensado exactamente para esto:
+     * corre en CADA entrada a la vista, sea la primera vez o una reutilización
+     * desde caché. Ionic lo invoca por duck-typing sobre cualquier componente
+     * de la jerarquía que lo declare, sin necesidad de implementar la interfaz
+     * `ViewWillEnter` (mismo patrón que `SelectSearchComponent` en esta lib).
+     */
+    ionViewWillEnter(): void;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<LoginComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LoginComponent, "val-login", never, { "props": { "alias": "props"; "required": false; }; }, { "onSuccess": "onSuccess"; "onError": "onError"; "onMFARequired": "onMFARequired"; }, never, never, true, never>;

package/lib/directives/feature-guard.directive.d.ts

@@ -0,0 +1,21 @@
+import { TemplateRef, ViewContainerRef, OnInit } from '@angular/core';
+import { FeatureControlService } from '../services/feature-control.service';
+import * as i0 from "@angular/core";
+/**
+ * Structural directive to hide elements when a feature is disabled.
+ *
+ * Usage: <button *valFeatureGuard="'oauth_facebook'">Sign in with Facebook</button>
+ * If oauth_facebook is disabled, the button is not rendered.
+ */
+export declare class FeatureGuardDirective implements OnInit {
+    private templateRef;
+    private viewContainer;
+    private featureControl;
+    set valFeatureGuard(featureKey: string);
+    private featureKey;
+    constructor(templateRef: TemplateRef<any>, viewContainer: ViewContainerRef, featureControl: FeatureControlService);
+    ngOnInit(): void;
+    private updateVisibility;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FeatureGuardDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<FeatureGuardDirective, "[valFeatureGuard]", never, { "valFeatureGuard": { "alias": "valFeatureGuard"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/services/feature-control.service.d.ts

@@ -0,0 +1,50 @@
+import { HttpClient } from '@angular/common/http';
+import { AnalyticsService } from './firebase/analytics.service';
+import * as i0 from "@angular/core";
+export interface UserFeature {
+    key: string;
+    enabled: boolean;
+    rolloutPercentage?: number;
+    rolloutHash?: string;
+}
+export declare class FeatureControlService {
+    private http;
+    private analytics?;
+    private features;
+    private isLoaded;
+    private previousState;
+    constructor(http: HttpClient, analytics?: AnalyticsService);
+    private logFeatureEvent;
+    /**
+     * Load user features from backend.
+     * Call this during app initialization (AppComponent ctor or effect).
+     * Logs feature state changes to Firebase Analytics.
+     */
+    loadUserFeatures(): Promise<void>;
+    /**
+     * Check if a feature is enabled for the current user.
+     * Returns true if feature is not found (optimistic default).
+     * If rollout percentage is set, uses consistent hashing for canary rollouts.
+     */
+    isEnabled(featureKey: string): boolean;
+    /**
+     * Get a computed signal for a feature.
+     * Use in templates: *ngIf="featureEnabled('oauth_facebook')()"
+     * Or in component: featureEnabled('payment_settings').
+     */
+    featureEnabled(featureKey: string): () => boolean;
+    /**
+     * Get all features for debugging (admin only).
+     */
+    getAllFeatures(): Map<string, boolean>;
+    /**
+     * Check if features have been loaded.
+     */
+    isReady(): boolean;
+    /**
+     * Watch for feature changes (for testing/demo purposes).
+     */
+    watchFeatures(): import("@angular/core").WritableSignal<Map<string, boolean>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FeatureControlService, [null, { optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FeatureControlService>;
+}

package/lib/services/qr-generator/qrbrand.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Contrato de marca de un QR, compartido entre backend y frontend (ADR-078).
+ *
+ * Espejo TypeScript de `backend/go/services/pkg/qrbrand/qrbrand.go`. Los tests
+ * de contraste de este archivo usan LOS MISMOS casos que el lado Go
+ * (`qrbrand_test.go`) — si un lado cambia el número esperado sin el otro,
+ * dejan de coincidir.
+ *
+ * No dibuja nada: valida que una combinación de colores sea escaneable y
+ * decide cuánta corrección de errores necesita un QR que lleva logo encima.
+ * El renderizado real sigue siendo QrGeneratorService (cliente) y qrpng.go
+ * (backend, correo) — cada uno dibuja a su manera; lo que comparten es esta
+ * validación.
+ */
+export type QrBrandDotStyle = 'square' | 'rounded' | 'dots';
+export type QrBrandErrorCorrection = 'L' | 'M' | 'Q' | 'H';
+export interface QrBrandLogo {
+    assetId: string;
+    /** Fracción del QR (0–1) que el logo tapa en el centro. */
+    clearArea?: number;
+}
+export interface QrBrand {
+    orgId: string;
+    appId: string;
+    ink: string;
+    bg: string;
+    dotStyle?: QrBrandDotStyle;
+    logo?: QrBrandLogo;
+}
+/** Sin marca configurada: tinta sobre blanco. Nunca se persiste. */
+export declare function defaultQrBrand(orgId: string, appId: string): QrBrand;
+export declare class QrBrandValidationError extends Error {
+    readonly field: string;
+    constructor(field: string, message: string);
+}
+/** Contraste WCAG entre dos colores hex (#RRGGBB). Fórmula estándar (L1+0.05)/(L2+0.05). */
+export declare function qrContrastRatio(hexA: string, hexB: string): number;
+/**
+ * Rechaza una combinación de colores que un lector real no va a poder leer.
+ * Escaneabilidad sobre estética: esta función no negocia (ADR-078 regla 1).
+ * Lanza QrBrandValidationError; no retorna un booleano — el caller casi
+ * siempre necesita el mensaje para mostrarlo en el formulario.
+ */
+export declare function validateQrBrand(b: QrBrand): void;
+/**
+ * El logo obliga a subir la corrección de errores, no se le pregunta al
+ * usuario (ADR-078 regla 2). Sin logo, M alcanza. Con logo, sube a Q; con
+ * logo grande (>15% del área), sube al máximo H.
+ */
+export declare function qrErrorCorrectionFor(b: QrBrand): QrBrandErrorCorrection;

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.939";
+export declare const VERSION = "4.0.941";

package/package.json

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

package/public-api.d.ts

@@ -2,6 +2,7 @@ export * from './lib/version';
 export * from './lib/services/access-control';
 export * from './lib/directives/has-permission.directive';
 export * from './lib/directives/light-ripple.directive';
+export * from './lib/directives/feature-guard.directive';
 export * from './lib/components/atoms/avatar/avatar.component';
 export * from './lib/components/atoms/avatar/types';
 export * from './lib/components/atoms/box/box.component';
@@ -434,6 +435,7 @@ export * from './lib/services/confirmation-dialog/confirmation-dialog.service';
 export * from './lib/services/confirmation-dialog/types';
 export * from './lib/services/qr-generator/qr-generator.service';
 export * from './lib/services/qr-generator/types';
+export * from './lib/services/qr-generator/qrbrand';
 export * from './lib/services/ticket-card-image/ticket-card-image.service';
 export * from './lib/services/ticket-card-image/types';
 export * from './lib/services/modal/modal.service';
@@ -447,8 +449,9 @@ export * from './lib/services/markdown-article/beautify-legal-article';
 export * from './lib/services/legal-link/legal-link.service';
 export * from './lib/services/firebase';
 export * from './lib/services/auth';
+export * from './lib/services/feature-control.service';
 export { OrgService } from './lib/services/org/org.service';
-export { GroupPickerComponent, } from './lib/components/molecules/group-picker/group-picker.component';
+export { GroupPickerComponent } from './lib/components/molecules/group-picker/group-picker.component';
 export { GroupMembersComponent, GroupMemberCandidate, } from './lib/components/organisms/group-members/group-members.component';
 export { GroupsService } from './lib/services/groups/groups.service';
 export { ValGroup, ValGroupMember, CreateGroupRequest as CreateValGroupRequest, UpdateGroupRequest as UpdateValGroupRequest, AddGroupMemberRequest, GroupResponse as ValGroupResponse, ListGroupsResponse as ListValGroupsResponse, ListGroupMembersResponse as ListValGroupMembersResponse, MyGroupsResponse, } from './lib/services/groups/types';