valtech-components 2.0.1023 → 2.0.1025

package/lib/components/molecules/ticket-card/ticket-card.component.d.ts

@@ -0,0 +1,42 @@
+import { QrCodeMetadata } from '../../atoms/qr-code/types';
+import { QrResult } from '../../../services/qr-generator/types';
+import { TicketCardMetadata, TicketCardStatus } from './types';
+import * as i0 from "@angular/core";
+/**
+ * val-ticket-card
+ *
+ * Tarjeta presentacional de una entrada de bingo: muestra el QR escaneable
+ * (generado del `qrToken` opaco firmado vía `QrGeneratorService`), el folio, el
+ * nombre del comprador (si hay) y un badge de estado (vendida / canjeada).
+ *
+ * Es la pieza que el vendedor le entrega al comprador tras la venta y que la
+ * taquilla escanea para canjear. Object-first (`input()` signal), i18n
+ * auto-registrado (namespace `TicketCard`). Estados negativos/neutros en gris
+ * muted (convención del factory — sin rojo de alarma).
+ *
+ * @example
+ * ```html
+ * <val-ticket-card [props]="{ qrToken: ticket.qrToken, folio: ticket.folio,
+ *   buyerName: ticket.compradorNombre, status: 'sold', showShare: true }" />
+ * ```
+ */
+export declare class TicketCardComponent {
+    /** Props object-first del componente. */
+    readonly props: import("@angular/core").InputSignal<TicketCardMetadata>;
+    private qrService;
+    private i18n;
+    /** QR generado (null mientras carga o si falló). */
+    readonly qr: import("@angular/core").WritableSignal<QrResult>;
+    /** Falló la generación del QR → fallback al token corto. */
+    readonly failed: import("@angular/core").WritableSignal<boolean>;
+    constructor();
+    private generate;
+    t(key: string): string;
+    readonly status: import("@angular/core").Signal<TicketCardStatus>;
+    readonly tokenShort: import("@angular/core").Signal<string>;
+    readonly folioText: import("@angular/core").Signal<string>;
+    readonly statusLabel: import("@angular/core").Signal<string>;
+    qrProps(q: QrResult): QrCodeMetadata;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TicketCardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TicketCardComponent, "val-ticket-card", never, { "props": { "alias": "props"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/lib/components/molecules/ticket-card/ticket-card.i18n.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Defaults i18n (es/en) del `val-ticket-card`. Auto-registrados en el
+ * constructor del componente (namespace `TicketCard`) — el consumer NUNCA tiene
+ * que registrarlos. Override pasando los labels por props o registrando el
+ * namespace antes de montar el componente.
+ */
+export declare const TICKET_CARD_I18N: {
+    readonly es: {
+        readonly folio: "Folio";
+        readonly statusSold: "Vendida";
+        readonly statusCheckedIn: "Canjeada";
+        readonly download: "Descargar";
+        readonly share: "Compartir";
+    };
+    readonly en: {
+        readonly folio: "Folio";
+        readonly statusSold: "Sold";
+        readonly statusCheckedIn: "Checked in";
+        readonly download: "Download";
+        readonly share: "Share";
+    };
+};

package/lib/components/molecules/ticket-card/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Estado de canje/venta que el ticket-card refleja en su badge.
+ *
+ * - `sold` — entrada vendida, todavía no canjeada (QR válido para canjear).
+ * - `checkedIn` — entrada ya canjeada (QR ya usado en puerta).
+ * - `neutral` — sin estado destacado (p.ej. solo se muestra el QR).
+ */
+export type TicketCardStatus = 'sold' | 'checkedIn' | 'neutral';
+/**
+ * Metadata (object-first) del componente `val-ticket-card`.
+ *
+ * Tarjeta presentacional de una entrada: muestra el QR (generado a partir del
+ * `qrToken` opaco firmado), el folio, el nombre del comprador (si hay) y un
+ * badge de estado. NO trae texto propio fijo — el consumer pasa los labels ya
+ * resueltos (`statusSoldLabel` / `statusCheckedInLabel` / `folioLabel`). El
+ * único texto auto-i18n son los defaults de esos labels (namespace `TicketCard`).
+ */
+export interface TicketCardMetadata {
+    /**
+     * Token opaco firmado que va DENTRO del QR escaneable (formato
+     * `base64url.base64url`). Es exactamente el dato que la taquilla manda al
+     * endpoint de canje. El componente lo codifica en el QR tal cual.
+     */
+    qrToken: string;
+    /** Folio de la entrada (número visible junto al QR). */
+    folio?: number | string;
+    /** Nombre del comprador, si se capturó en la venta. */
+    buyerName?: string;
+    /** Estado de la entrada (controla el color/label del badge). */
+    status?: TicketCardStatus;
+    /** Título de la tarjeta (ej. nombre del evento). Opcional. */
+    title?: string;
+    /** Tamaño del QR en px (default 200). */
+    qrSize?: number;
+    /** Mostrar botón de descarga del QR. */
+    showDownload?: boolean;
+    /** Mostrar botón de compartir el QR. */
+    showShare?: boolean;
+    /** Label del prefijo de folio (default i18n: "Folio"). */
+    folioLabel?: string;
+    /** Label del badge cuando `status === 'sold'` (default: "Vendida"). */
+    statusSoldLabel?: string;
+    /** Label del badge cuando `status === 'checkedIn'` (default: "Canjeada"). */
+    statusCheckedInLabel?: string;
+}

package/lib/components/organisms/api-key-create-modal/api-key-create-modal.component.d.ts

@@ -0,0 +1,56 @@
+import { OnInit, EventEmitter } from '@angular/core';
+import { FormMetadata, FormSubmit } from '../../types';
+import { ClientApiKeyWithSecret } from '../../../services/apikeys/types';
+import { LocalizedLabel, PermissionResource } from '../../../services/org/permission-catalog.service';
+import * as i0 from "@angular/core";
+/**
+ * `val-api-key-create-modal` — modal SÓLO para crear una Client API Key.
+ *
+ * Extraído de `val-api-keys-modal` bajo el proceso de ADR-021: la gestión (lista +
+ * revoke) vive ahora en la vista `val-api-keys-view`, y la creación en este modal,
+ * que `api-keys-view` abre vía `ModalService`. Header canónico (Regla #5): título en
+ * el body, botón Cerrar en el toolbar.
+ *
+ * Flujo: selector de permisos (filtrado por org/app) + form (nombre + expiración) →
+ * crea → muestra el secreto UNA vez con copia. Emite `(created)` al terminar (para
+ * que la vista refresque la lista) y `(dismissed)` al cerrar.
+ */
+export declare class ApiKeyCreateModalComponent implements OnInit {
+    private i18n;
+    private apiKeys;
+    private catalog;
+    private auth;
+    /** Inyectado por `ModalService.open` — referencia para cerrar desde dentro. */
+    _modalRef?: {
+        dismiss: (data?: unknown, role?: string) => void;
+    };
+    /** Namespace i18n (comparte el de `val-api-keys-modal`). */
+    i18nNamespace: string;
+    /** Callback tras crear una key (pasado por `componentProps` — refresca la lista). */
+    onCreated?: () => void;
+    readonly catalogPermissions: import("@angular/core").WritableSignal<PermissionResource[]>;
+    readonly actionLabels: import("@angular/core").WritableSignal<Record<string, LocalizedLabel>>;
+    readonly selectedPerms: import("@angular/core").WritableSignal<string[]>;
+    readonly submitting: import("@angular/core").WritableSignal<boolean>;
+    readonly errorMsg: import("@angular/core").WritableSignal<string>;
+    readonly secret: import("@angular/core").WritableSignal<ClientApiKeyWithSecret>;
+    readonly copied: import("@angular/core").WritableSignal<boolean>;
+    /** Emite cuando se creó una key (además del callback `onCreated`). */
+    created: EventEmitter<void>;
+    readonly createForm: import("@angular/core").Signal<FormMetadata>;
+    constructor();
+    ngOnInit(): void;
+    /**
+     * Carga el catálogo y lo filtra a lo asignable a una API Key de la org: descarta
+     * `internal` (el backend ya los omite para no-staff) y los permisos de OTRAS apps.
+     */
+    private loadCatalog;
+    private activeOrgId;
+    onCreateSubmit(event: FormSubmit): void;
+    copy(secret: string): Promise<void>;
+    finishSecret(): void;
+    dismiss(): void;
+    t(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ApiKeyCreateModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ApiKeyCreateModalComponent, "val-api-key-create-modal", never, { "_modalRef": { "alias": "_modalRef"; "required": false; }; "i18nNamespace": { "alias": "i18nNamespace"; "required": false; }; "onCreated": { "alias": "onCreated"; "required": false; }; }, { "created": "created"; }, never, never, true, never>;
+}

package/lib/components/organisms/api-keys-view/api-keys-view.component.d.ts

@@ -0,0 +1,58 @@
+import { EmptyStateMetadata } from '../../molecules/empty-state/types';
+import { ButtonMetadata } from '../../types';
+import { ClientApiKey } from '../../../services/apikeys/types';
+import { ApiKeysViewConfig } from './types';
+import * as i0 from "@angular/core";
+/** Key enriquecida con el perfil público (handle/avatar/name) de su creador. */
+interface ApiKeyRow extends ClientApiKey {
+    creatorName?: string;
+    creatorHandle?: string;
+    creatorAvatar?: string;
+}
+/**
+ * `val-api-keys-view` — vista full-feature de gestión de Client API Keys (ADR-021).
+ *
+ * Reemplaza al `val-api-keys-modal` como pantalla propia: ofrece **crear** arriba
+ * (CTA que abre `val-api-key-create-modal`) y **lista** abajo, con quién la creó
+ * (avatar + handle, resuelto de `/profiles`) y la fecha de creación. Revocar con
+ * confirmación destructiva. Estados loading / error / empty (Capa 4).
+ *
+ * NO renderiza ion-content — vive dentro de `val-page-wrapper`. Header vía
+ * `NavigationService.setBackHeader`. i18n auto-registrado bajo `i18nNamespace`.
+ */
+export declare class ApiKeysViewComponent {
+    private i18n;
+    private auth;
+    private apiKeys;
+    private firestore;
+    private nav;
+    private modalService;
+    private toast;
+    private confirmDialog;
+    private errors;
+    private route;
+    /** Config vía @Input (object-first); fallback al route data `apiKeysConfig`. */
+    config?: ApiKeysViewConfig;
+    readonly resolvedConfig: import("@angular/core").Signal<Required<ApiKeysViewConfig>>;
+    private get ns();
+    readonly keys: import("@angular/core").WritableSignal<ApiKeyRow[]>;
+    readonly loading: import("@angular/core").WritableSignal<boolean>;
+    readonly loadError: import("@angular/core").WritableSignal<unknown>;
+    readonly activeOrgId: import("@angular/core").Signal<string>;
+    readonly newKeyButton: import("@angular/core").Signal<Partial<ButtonMetadata>>;
+    readonly errorState: import("@angular/core").Signal<EmptyStateMetadata>;
+    readonly emptyState: import("@angular/core").Signal<EmptyStateMetadata>;
+    constructor();
+    revokeButton(k: ApiKeyRow): Partial<ButtonMetadata>;
+    load(): void;
+    /** Resuelve handle/avatar/name del creador (`createdBy`) desde `/profiles`. */
+    private enrichWithCreators;
+    creatorLabel(k: ApiKeyRow): string;
+    formatDate(iso?: string): string;
+    openCreate(): void;
+    revoke(k: ApiKeyRow): Promise<void>;
+    protected tt(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ApiKeysViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ApiKeysViewComponent, "val-api-keys-view", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
+}
+export {};

package/lib/components/organisms/api-keys-view/api-keys-view.i18n.d.ts

@@ -0,0 +1,6 @@
+import { LanguagesContent } from '../../../services/i18n/types';
+/**
+ * Defaults i18n (es/en) de `val-api-keys-view`. Auto-registrados si el consumer no
+ * proveyó el namespace `Settings.ApiKeys`.
+ */
+export declare const API_KEYS_VIEW_I18N: LanguagesContent;

package/lib/components/organisms/api-keys-view/api-keys.routes.d.ts

@@ -0,0 +1,22 @@
+import { Routes } from '@angular/router';
+import { ApiKeysViewConfig } from './types';
+/**
+ * Helper para montar la vista de Client API Keys (`val-api-keys-view`) como ruta
+ * en una app del factory. El `config` se pasa por route `data` (`apiKeysConfig`) y
+ * el componente lo lee como fallback de su `@Input() config`.
+ *
+ * @example
+ * ```ts
+ * // settings.routes.ts
+ * import { provideValtechApiKeysRoutes } from 'valtech-components';
+ *
+ * export const settingsRoutes: Routes = [
+ *   ...provideValtechApiKeysRoutes(),                  // → /app/settings/api-keys
+ *   // ...provideValtechApiKeysRoutes({ path: 'integrations/keys' }),
+ * ];
+ * ```
+ */
+export declare function provideValtechApiKeysRoutes(opts?: {
+    path?: string;
+    config?: ApiKeysViewConfig;
+}): Routes;

package/lib/components/organisms/api-keys-view/types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Config acotada de `val-api-keys-view` (ADR-021: una vista full-feature no abre
+ * slots arbitrarios; si falta algo, se promueve un nuevo punto de extensión).
+ */
+export interface ApiKeysViewConfig {
+    /** Namespace i18n de los textos de la vista. Default `Settings.ApiKeys`. */
+    i18nNamespace?: string;
+}

package/lib/components/organisms/organization-view/types.d.ts

@@ -45,6 +45,12 @@ export interface OrganizationViewConfig {
      * "Ver roles y permisos"). Default `'/app/settings/permissions'`.
      */
     viewPermissionsRoute?: string;
+    /**
+     * Ruta a la que navegar al gestionar las API Keys (botón "Gestionar" de la
+     * sección Integraciones). Apunta a `val-api-keys-view`
+     * (`provideValtechApiKeysRoutes`). Default `'/app/settings/api-keys'`.
+     */
+    apiKeysRoute?: string;
     /**
      * Ruta a la que redirigir tras salir de la organización.
      * Default `'/app/settings/account'`.

package/lib/components/organisms/qr-scanner/qr-scanner.component.d.ts

@@ -0,0 +1,51 @@
+import { AfterViewInit, ElementRef, EventEmitter, OnDestroy } from '@angular/core';
+import { QrScannerMetadata, QrScannerState } from './types';
+import * as i0 from "@angular/core";
+/**
+ * val-qr-scanner
+ *
+ * Organism: scanner de códigos QR por cámara (`@zxing/browser` +
+ * `@zxing/library`). Emite el texto decodificado por `(scanned)`.
+ *
+ * Maneja: permiso de cámara denegado (`denied`), ausencia de cámara
+ * (`no-camera`), selector cuando hay varias cámaras, y botón start/stop. Hace
+ * cleanup del stream en `ngOnDestroy`. i18n auto-registrado (namespace
+ * `QrScanner`).
+ *
+ * Object-first (`@Input() props`) + un único `@Output() scanned`.
+ *
+ * @example
+ * ```html
+ * <val-qr-scanner [props]="{ continuous: true }" (scanned)="onScan($event)" />
+ * ```
+ */
+export declare class QrScannerComponent implements AfterViewInit, OnDestroy {
+    props: QrScannerMetadata;
+    /** Emite el texto decodificado del QR. */
+    scanned: EventEmitter<string>;
+    videoRef: ElementRef<HTMLVideoElement>;
+    private i18n;
+    readonly state: import("@angular/core").WritableSignal<QrScannerState>;
+    readonly devices: import("@angular/core").WritableSignal<MediaDeviceInfo[]>;
+    readonly activeDeviceId: import("@angular/core").WritableSignal<string>;
+    private reader;
+    private controls;
+    private lastValue;
+    private lastAt;
+    private viewReady;
+    constructor();
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    t(key: string): string;
+    stateMessage(): string;
+    deviceLabel(d: MediaDeviceInfo): string;
+    start(deviceId?: string): Promise<void>;
+    stop(): void;
+    onSelectDevice(deviceId: string): Promise<void>;
+    private handleResult;
+    private handleStartError;
+    /** Detiene el decode + libera el stream de la cámara. */
+    private teardown;
+    static ɵfac: i0.ɵɵFactoryDeclaration<QrScannerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<QrScannerComponent, "val-qr-scanner", never, { "props": { "alias": "props"; "required": false; }; }, { "scanned": "scanned"; }, never, never, true, never>;
+}

package/lib/components/organisms/qr-scanner/qr-scanner.i18n.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Defaults i18n (es/en) del `val-qr-scanner`. Auto-registrados en el
+ * constructor (namespace `QrScanner`) — el consumer NUNCA tiene que
+ * registrarlos. Override por props (start/stop) o registrando el namespace.
+ */
+export declare const QR_SCANNER_I18N: {
+    readonly es: {
+        readonly start: "Iniciar cámara";
+        readonly stop: "Detener";
+        readonly starting: "Iniciando cámara…";
+        readonly hint: "Apunta la cámara al código QR de la entrada.";
+        readonly cameraLabel: "Cámara";
+        readonly denied: "No se pudo acceder a la cámara. Revisa los permisos del navegador e inténtalo de nuevo.";
+        readonly noCamera: "No se encontró ninguna cámara en este dispositivo.";
+        readonly error: "Ocurrió un problema con la cámara. Inténtalo de nuevo.";
+    };
+    readonly en: {
+        readonly start: "Start camera";
+        readonly stop: "Stop";
+        readonly starting: "Starting camera…";
+        readonly hint: "Point the camera at the ticket QR code.";
+        readonly cameraLabel: "Camera";
+        readonly denied: "Could not access the camera. Check your browser permissions and try again.";
+        readonly noCamera: "No camera was found on this device.";
+        readonly error: "Something went wrong with the camera. Please try again.";
+    };
+};

package/lib/components/organisms/qr-scanner/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Metadata (object-first) del organism `val-qr-scanner`.
+ *
+ * Scanner de QR por cámara. Todos los campos son opcionales (la cámara
+ * funciona con defaults). El consumer pasa los labels ya resueltos por i18n;
+ * si no, el componente cae a sus defaults auto-registrados (namespace
+ * `QrScanner`).
+ */
+export interface QrScannerMetadata {
+    /** Arrancar la cámara automáticamente al montar (default false). */
+    autoStart?: boolean;
+    /** Label del botón de iniciar (override del auto-i18n). */
+    startLabel?: string;
+    /** Label del botón de detener (override del auto-i18n). */
+    stopLabel?: string;
+    /**
+     * Mantener la cámara encendida tras un escaneo exitoso (default true). Si es
+     * `false`, el scanner se detiene solo al primer match — útil para flujos de
+     * un solo canje. Si es `true`, sigue escaneando (la página decide cuándo
+     * parar / reanudar).
+     */
+    continuous?: boolean;
+    /**
+     * Anti-rebote entre lecturas del MISMO valor, en ms (default 1500). Evita
+     * que el mismo QR dispare `scanned` muchas veces por segundo mientras está
+     * frente a la cámara.
+     */
+    dedupeMs?: number;
+}
+/** Estado interno del scanner (expuesto para feedback de UI). */
+export type QrScannerState = 'idle' | 'starting' | 'scanning' | 'denied' | 'no-camera' | 'error';

package/lib/components/organisms/settings-hub/settings.routes.d.ts

@@ -5,6 +5,7 @@ import { SecurityViewConfig } from '../security-view/types';
 import { AccountViewConfig } from '../account-view/types';
 import { OrganizationViewConfig } from '../organization-view/types';
 import { NotificationPreferencesViewConfig } from '../notification-preferences-view/types';
+import { ApiKeysViewConfig } from '../api-keys-view/types';
 import { PermissionsViewConfig } from '../permissions-view/types';
 import { SettingsHubConfig } from './types';
 /**
@@ -58,6 +59,10 @@ export interface ValtechSettingsRoutesOptions {
     includeNotificationPreferences?: boolean;
     /** Monta la ruta `permissions`. Default `true`. */
     includePermissions?: boolean;
+    /** Monta la ruta `api-keys` (`val-api-keys-view`). Default `false` (opt-in). */
+    includeApiKeys?: boolean;
+    /** Config de la vista API Keys (pass-through a `provideValtechApiKeysRoutes`). */
+    apiKeysConfig?: ApiKeysViewConfig;
     /** Path de la vista Preferencias. Default `'preferences'`. */
     preferencesPath?: string;
     /** Path de la vista Preferencias de notificaciones push. Default `'notifications'`. */

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 = "2.0.1023";
+export declare const VERSION = "2.0.1025";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.1023",
+  "version": "2.0.1025",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"
@@ -36,6 +36,8 @@
   },
   "dependencies": {
     "@capacitor/browser": "^6.0.3",
+    "@zxing/browser": "^0.2.0",
+    "@zxing/library": "^0.22.0",
     "compressorjs": "^1.3.0",
     "ng-otp-input": "^1.9.3",
     "ngx-image-cropper": "^9.0.0",

package/public-api.d.ts

@@ -309,6 +309,10 @@ export * from './lib/components/organisms/member-detail-modal/member-detail-moda
 export * from './lib/components/organisms/member-detail-modal/types';
 export * from './lib/components/organisms/member-import-modal/member-import-modal.component';
 export * from './lib/components/organisms/api-keys-modal/api-keys-modal.component';
+export * from './lib/components/organisms/api-key-create-modal/api-key-create-modal.component';
+export * from './lib/components/organisms/api-keys-view/api-keys-view.component';
+export * from './lib/components/organisms/api-keys-view/types';
+export * from './lib/components/organisms/api-keys-view/api-keys.routes';
 export * from './lib/components/organisms/edit-org-modal/edit-org-modal.component';
 export * from './lib/components/organisms/transfer-ownership-modal/transfer-ownership-modal.component';
 export * from './lib/components/organisms/transfer-ownership-modal/types';
@@ -429,3 +433,7 @@ export * from './lib/components/molecules/content-card/content-card.component';
 export * from './lib/components/molecules/content-card/types';
 export * from './lib/components/organisms/auth-cta/auth-cta.component';
 export * from './lib/components/organisms/auth-cta/types';
+export * from './lib/components/molecules/ticket-card/ticket-card.component';
+export * from './lib/components/molecules/ticket-card/types';
+export * from './lib/components/organisms/qr-scanner/qr-scanner.component';
+export * from './lib/components/organisms/qr-scanner/types';