valtech-components 4.0.938 → 4.0.940

package/lib/components/molecules/group-picker/group-picker.component.d.ts

@@ -0,0 +1,28 @@
+import { EventEmitter, OnInit } from '@angular/core';
+import { ValGroup } from '../../../services/groups/types';
+import * as i0 from "@angular/core";
+/**
+ * val-group-picker — elegir el grupo dueño de un recurso (ADR-083).
+ *
+ * Se auto-carga: pide sus propios grupos a `GroupsService` en vez de esperar
+ * que el consumer se los pase. Es la razón por la que existe como componente y
+ * no como un `<select>` armado a mano en cada app — "una línea, una etiqueta
+ * i18n" (ver ADR-083 §"Qué se construye una sola vez").
+ *
+ * Sin texto hardcodeado: los labels llegan por `@Input` (lib i18n-agnostic).
+ * Cada app pone su palabra ("Equipo", "Sucursal", "Refugio").
+ */
+export declare class GroupPickerComponent implements OnInit {
+    label: string;
+    placeholder: string;
+    noGroupLabel: string;
+    value: string | null;
+    disabled: boolean;
+    valueChange: EventEmitter<string>;
+    private readonly groupsSvc;
+    groups: ValGroup[];
+    ngOnInit(): void;
+    onChange(v: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GroupPickerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GroupPickerComponent, "val-group-picker", never, { "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "noGroupLabel": { "alias": "noGroupLabel"; "required": false; }; "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}

package/lib/components/organisms/group-members/group-members.component.d.ts

@@ -0,0 +1,43 @@
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { ButtonMetadata } from '../../types';
+import { ValGroupMember } from '../../../services/groups/types';
+import * as i0 from "@angular/core";
+/** Persona elegible para agregar al grupo (típicamente un `OrgMember`). */
+export interface GroupMemberCandidate {
+    userId: string;
+    name?: string;
+    email?: string;
+}
+/**
+ * val-group-members — administrar la membresía de UN grupo (ADR-083).
+ *
+ * Deliberadamente NO trae su propio selector de personas: la fuente de
+ * "quiénes son los miembros elegibles de la organización" varía por app (org
+ * members, invitados, etc.), así que se recibe por `@Input candidates` en vez
+ * de que este organismo importe un servicio de organización que no le
+ * corresponde. Sin candidatos, igual funciona: solo lista y quita.
+ *
+ * Sin texto hardcodeado (lib i18n-agnostic): los labels llegan por `@Input`.
+ */
+export declare class GroupMembersComponent implements OnChanges {
+    groupId: string;
+    /** Personas elegibles para agregar. Vacío = el organismo solo lista/quita. */
+    candidates: GroupMemberCandidate[];
+    addPlaceholder: string;
+    emptyLabel: string;
+    removeLabel: string;
+    membersChange: EventEmitter<ValGroupMember[]>;
+    private readonly groupsSvc;
+    members: ValGroupMember[];
+    busy: boolean;
+    get removeButtonProps(): ButtonMetadata;
+    ngOnChanges(changes: SimpleChanges): void;
+    private reload;
+    /** Candidatos que todavía no están en el grupo — evita ofrecer un alta duplicada. */
+    eligible(): GroupMemberCandidate[];
+    nameFor(userId: string): string;
+    add(userId: string): void;
+    remove(userId: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GroupMembersComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GroupMembersComponent, "val-group-members", never, { "groupId": { "alias": "groupId"; "required": true; }; "candidates": { "alias": "candidates"; "required": false; }; "addPlaceholder": { "alias": "addPlaceholder"; "required": false; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; }; "removeLabel": { "alias": "removeLabel"; "required": false; }; }, { "membersChange": "membersChange"; }, 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/groups/groups.service.d.ts

@@ -0,0 +1,39 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { ValtechAuthConfig } from '../auth/types';
+import { ValGroup, ValGroupMember, CreateGroupRequest, UpdateGroupRequest, AddGroupMemberRequest, MyGroupsResponse } from './types';
+import * as i0 from "@angular/core";
+/**
+ * Cliente de `/v2/groups/*` (ADR-083). Servicio de PLATAFORMA: no sabe qué es
+ * un blueprint ni un refugio, solo agrupa recursos y personas. Cada app lo
+ * consume igual — es lo que evita reescribir esta capa por producto.
+ */
+export declare class GroupsService {
+    private config;
+    private http;
+    constructor(config: ValtechAuthConfig, http: HttpClient);
+    private get baseUrl();
+    /** Grupos activos de la organización (filtrados por app en el backend). */
+    listGroups(): Observable<ValGroup[]>;
+    /** Incluye archivados: para la pantalla de administración. */
+    listAllGroups(): Observable<ValGroup[]>;
+    getGroup(id: string): Observable<ValGroup>;
+    createGroup(req: CreateGroupRequest): Observable<ValGroup>;
+    updateGroup(id: string, req: UpdateGroupRequest): Observable<ValGroup>;
+    /**
+     * No hay `deleteGroup`: el ADR-083 decidió que un servicio de plataforma no
+     * puede saber si un vertical todavía apunta al grupo, y como "sin grupo"
+     * significa visible para toda la organización, borrarlo publicaría sus
+     * recursos a la planta entera. `archiveGroup`/`restoreGroup` cubren la
+     * necesidad real sin ese riesgo.
+     */
+    archiveGroup(id: string): Observable<ValGroup>;
+    restoreGroup(id: string): Observable<ValGroup>;
+    listMembers(groupId: string): Observable<ValGroupMember[]>;
+    addMember(groupId: string, req: AddGroupMemberRequest): Observable<ValGroupMember[]>;
+    removeMember(groupId: string, userId: string): Observable<ValGroupMember[]>;
+    /** Los grupos del usuario actual. Referencial: el filtrado real corre en el backend. */
+    myGroups(): Observable<MyGroupsResponse>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GroupsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<GroupsService>;
+}

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

@@ -0,0 +1,69 @@
+/**
+ * Grupos (ADR-083) — subdivisión de una organización que agrupa RECURSOS y
+ * PERSONAS a la vez. Servicio de plataforma, agnóstico de dominio: el mismo
+ * contrato sirve a la línea de producción de Merotz, al refugio de Chesed o al
+ * evento de Bingo. Cada app le pone su etiqueta ("Equipo", "Sucursal") vía i18n
+ * — el modelo no la sabe.
+ */
+export interface ValGroup {
+    id: string;
+    orgId: string;
+    appId: string;
+    /** Etiqueta de dominio que declara la app: "machine", "shelter", "event". */
+    kind?: string;
+    /** Texto del CLIENTE ("Línea 3"): no se traduce. */
+    name: string;
+    parentId?: string;
+    archived: boolean;
+    createdAt: string;
+    createdBy?: string;
+    updatedAt: string;
+}
+export interface ValGroupMember {
+    groupId: string;
+    orgId: string;
+    userId: string;
+    groupName?: string;
+    addedAt: string;
+    addedBy?: string;
+}
+export interface CreateGroupRequest {
+    name: string;
+    kind?: string;
+}
+export interface UpdateGroupRequest {
+    name: string;
+}
+export interface AddGroupMemberRequest {
+    userId: string;
+}
+export interface GroupResponse {
+    operationId: string;
+    group: ValGroup;
+}
+export interface ListGroupsResponse {
+    operationId: string;
+    groups: ValGroup[];
+    count: number;
+}
+export interface ListGroupMembersResponse {
+    operationId: string;
+    members: ValGroupMember[];
+    count: number;
+}
+/**
+ * Respuesta de "mis grupos": lo que alimenta el filtrado del lado del cliente
+ * cuando hace falta mostrar contexto (p.ej. qué grupo eligió el usuario por
+ * default), aunque el filtrado real siempre corre en el backend.
+ */
+export interface MyGroupsResponse {
+    operationId: string;
+    groupIds: string[];
+    /**
+     * El usuario ve TODOS los grupos sin importar membresía (permiso
+     * `groups:all`). Sin `omitempty` del lado del backend a propósito: un
+     * `false` ausente sería indistinguible de una respuesta vieja.
+     */
+    allGroups: boolean;
+    groups: ValGroupMember[];
+}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "4.0.938",
+  "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,7 +449,12 @@ 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 { 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';
 export { PersonaService, PersonaConfig, PERSONA_CONFIG, providePersona, } from './lib/services/persona/persona.service';
 export { HandleService } from './lib/services/handles/handles.service';
 export type { HandleOwnerType, HandleResolveResult, HandleSearchResult, ResolveHandleResponse, SearchHandlesResponse, } from './lib/services/handles/handles.service';