valtech-components 4.0.939 → 4.0.940

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.940";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "4.0.939",
+  "version": "4.0.940",
   "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';