valtech-components 4.0.969 → 4.0.971

package/lib/components/organisms/comms-preferences-settings/comms-preferences-settings.component.d.ts

@@ -0,0 +1,29 @@
+import { ToggleInputMetadata } from '../../molecules/toggle-input/types';
+import { CommunicationSetting } from '../../../services/comms-preferences/types';
+import { CommsPreferencesSettingsConfig } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-comms-preferences-settings` (ADR-089) — la organización enciende o
+ * apaga comunicaciones transaccionales configurables (hoy: bingo-transfer-
+ * pending; el catálogo crece sin tocar este componente). Un toggle por
+ * comunicación, guardado inmediato (sin botón "Guardar" aparte) con
+ * rollback optimista si falla.
+ */
+export declare class CommsPreferencesSettingsComponent {
+    private i18n;
+    private nav;
+    private toast;
+    private svc;
+    config?: CommsPreferencesSettingsConfig;
+    private get ns();
+    readonly settings: import("@angular/core").WritableSignal<CommunicationSetting[]>;
+    private readonly controls;
+    readonly page: import("../../../services/page-state/page-state").PageState;
+    constructor();
+    private controlFor;
+    toggleProps(templateId: string): ToggleInputMetadata;
+    private onToggle;
+    protected tt(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CommsPreferencesSettingsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CommsPreferencesSettingsComponent, "val-comms-preferences-settings", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/organisms/comms-preferences-settings/comms-preferences-settings.i18n.d.ts

@@ -0,0 +1,24 @@
+export declare const COMMS_PREFERENCES_SETTINGS_I18N: {
+    es: {
+        pageTitle: string;
+        pageDescription: string;
+        empty: string;
+        savedOk: string;
+        saveError: string;
+        errorTitle: string;
+        offlineTitle: string;
+        offlineHint: string;
+        retry: string;
+    };
+    en: {
+        pageTitle: string;
+        pageDescription: string;
+        empty: string;
+        savedOk: string;
+        saveError: string;
+        errorTitle: string;
+        offlineTitle: string;
+        offlineHint: string;
+        retry: string;
+    };
+};

package/lib/components/organisms/comms-preferences-settings/types.d.ts

@@ -0,0 +1,4 @@
+export interface CommsPreferencesSettingsConfig {
+    /** Namespace i18n de textos propios (pageTitle/pageDescription/etc). Default `Settings.Comms`. */
+    i18nNamespace?: string;
+}

package/lib/components/organisms/page-block/page-block.component.d.ts

@@ -0,0 +1,65 @@
+import { EventEmitter } from '@angular/core';
+import { FaqCategory } from '../faq/types';
+import { PageBlock, PageCTABlockProps, PageCTAIntent, PageFAQBlockProps, PageGalleryBlockProps, PageHeroBlockProps, PageTextBlockProps } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-page-block`
+ *
+ * Organism que renderiza UN bloque del constructor de páginas de plataforma
+ * (ADR-077, `services/page` en el backend). Es el punto de la lib donde el
+ * catálogo de bloques (`hero`, `text`, `gallery`, `cta`, `faq`) mapea 1:1 a
+ * componentes reales — la razón de ser del ADR: "un rediseño de la lib
+ * mejora todas las páginas publicadas sin tocar sus datos".
+ *
+ * Presentacional puro: recibe `props` ya tipados (espejo exacto del `Block`
+ * del backend), sin llamadas HTTP propias ni conocimiento de a qué app
+ * pertenece la página. El bloque `cta` NO navega — emite `(ctaAction)` con
+ * la intención cruda (`{ action }`) para que el consumidor (la app) la
+ * resuelva contra su propio routing (ADR-077: "el CTA guarda una intención,
+ * nunca una URL").
+ *
+ * El caller típico itera `Page.Blocks` y renderiza uno de estos por bloque:
+ *
+ * @example
+ * ```html
+ * @for (block of page().blocks; track $index) {
+ *   <val-page-block [props]="block" (ctaAction)="onCtaAction($event)" />
+ * }
+ * ```
+ */
+export declare class PageBlockComponent {
+    /** El bloque a renderizar — espejo de `page.Block` (backend). */
+    props: PageBlock;
+    /**
+     * Emite la intención cruda del CTA al hacer click (`{ action }`, nunca una
+     * URL — ver comentario de clase). El consumidor decide qué hacer con
+     * `action`; este componente no la interpreta.
+     */
+    ctaAction: EventEmitter<PageCTAIntent>;
+    /** Fallback de imagen rota (convención de la lib) — un slot, una signal. */
+    readonly heroImageFailed: import("@angular/core").WritableSignal<boolean>;
+    /** Índices de `gallery.images` cuya carga falló (`error` del `<img>`). */
+    readonly failedGalleryImages: import("@angular/core").WritableSignal<Set<number>>;
+    get hero(): PageHeroBlockProps;
+    get text(): PageTextBlockProps;
+    get gallery(): PageGalleryBlockProps;
+    get cta(): PageCTABlockProps;
+    get faq(): PageFAQBlockProps;
+    /**
+     * `text.body` es texto plano (no markdown — a diferencia de
+     * `val-article`/`val-faq`, `blocks_validate.go` solo exige un string no
+     * vacío). Partido por línea para que `val-text` (un `<p>` por línea)
+     * respete los saltos que el autor escribió, sin interpretar sintaxis.
+     */
+    textParagraphs(): string[];
+    /**
+     * `val-faq` agrupa por categoría; el bloque `faq` de `services/page` no
+     * tiene categorías (solo `items` planos) — se envuelve en una única
+     * categoría sin label (`hideSingleCategoryLabel` default `true` la oculta).
+     */
+    faqCategories(): FaqCategory[];
+    onCtaClick(): void;
+    onGalleryImageError(index: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PageBlockComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PageBlockComponent, "val-page-block", never, { "props": { "alias": "props"; "required": false; }; }, { "ctaAction": "ctaAction"; }, never, never, true, never>;
+}

package/lib/components/organisms/page-block/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Tipos del organism `val-page-block` — constructor de páginas de plataforma
+ * (ADR-077: `docs/adr/077-constructor-de-paginas-de-plataforma.md`, primera
+ * aplicación real en Eklesee, Bloque 4:
+ * `docs/eklesee/03-roadmap-y-abiertos.md`).
+ *
+ * Espejo 1:1 de `Block`/`Props` en `backend/go/services/page/types.go` +
+ * `backend/go/services/page/blocks_validate.go` — la forma de cada `props`
+ * sale de ahí, no se inventa acá. El catálogo de esta primera pasada son 5
+ * tipos (`hero`, `text`, `gallery`, `cta`, `faq`); `countdown`/`sponsors`/
+ * `progress` (catálogo completo del ADR) quedan fuera hasta que Bingo migre.
+ *
+ * El componente es i18n-agnóstico y agnóstico al dominio a propósito (mismo
+ * criterio que `val-faq`/`val-article`): recibe `props` ya resueltos, sin
+ * llamadas HTTP propias ni conocimiento de rutas de ninguna app. La app que
+ * lo consume (Eklesee) resuelve `PageCTAIntent.action` a una ruta real —
+ * este organism solo la emite via `(ctaAction)`.
+ */
+/** hero — props: `title` (requerido), `subtitle`/`image`/`align` (opcionales). */
+export interface PageHeroBlockProps {
+    title: string;
+    subtitle?: string;
+    /** URL de la imagen de fondo/acompañante. */
+    image?: string;
+    align?: 'left' | 'center' | 'right';
+}
+/** text — props: `body` (requerido), `heading` (opcional). */
+export interface PageTextBlockProps {
+    body: string;
+    heading?: string;
+}
+/** gallery — props: `images` (requerido, 1..20 URLs, validado en backend). */
+export interface PageGalleryBlockProps {
+    images: string[];
+}
+/**
+ * Intención del CTA, NUNCA una URL (ADR-077: "el link del vendedor puede
+ * regenerarse... sin dejar páginas publicadas apuntando a un token muerto").
+ * El catálogo de `action` es del backend (`page.CTAAction`, hoy solo
+ * `apply_membership` — ver `services/page/types.go`). Este componente NO
+ * resuelve la intención a una ruta: solo la recibe y la reemite tal cual via
+ * `(ctaAction)` para que la app la resuelva contra su propio routing.
+ */
+export interface PageCTAIntent {
+    action: string;
+}
+/** cta — props: `label` (requerido), `intent.action` (requerido). */
+export interface PageCTABlockProps {
+    label: string;
+    intent: PageCTAIntent;
+}
+/** Un ítem de FAQ (pregunta + respuesta en texto plano). */
+export interface PageFAQItemProps {
+    question: string;
+    answer: string;
+}
+/** faq — props: `items` (requerido, 1..50, validado en backend). */
+export interface PageFAQBlockProps {
+    items: PageFAQItemProps[];
+}
+/** Discriminador de bloque — espejo de `page.BlockType` (backend). */
+export type PageBlockType = 'hero' | 'text' | 'gallery' | 'cta' | 'faq';
+interface PageBlockBase {
+    /**
+     * Orden de renderizado dentro de `Page.Blocks`. El backend lo re-estampa
+     * SIEMPRE a partir de la posición del array al guardar (`SetBlocks` —
+     * regla #7 backend/go/CLAUDE.md: nunca confiar en un `order` que venga del
+     * cliente). Opcional acá: el consumidor típico ya itera el array en el
+     * orden real, este campo es informativo.
+     */
+    order?: number;
+}
+export interface PageHeroBlock extends PageBlockBase {
+    type: 'hero';
+    props: PageHeroBlockProps;
+}
+export interface PageTextBlock extends PageBlockBase {
+    type: 'text';
+    props: PageTextBlockProps;
+}
+export interface PageGalleryBlock extends PageBlockBase {
+    type: 'gallery';
+    props: PageGalleryBlockProps;
+}
+export interface PageCTABlock extends PageBlockBase {
+    type: 'cta';
+    props: PageCTABlockProps;
+}
+export interface PageFAQBlock extends PageBlockBase {
+    type: 'faq';
+    props: PageFAQBlockProps;
+}
+/** Unión discriminada — espejo de `page.Block` (backend, `Props map[string]any` tipado por `Type`). */
+export type PageBlock = PageHeroBlock | PageTextBlock | PageGalleryBlock | PageCTABlock | PageFAQBlock;
+/**
+ * Props de `<val-page-block>`. Alias de `PageBlock` con el nombre
+ * `*Metadata` que sigue el resto de la lib (`convención: Props interface
+ * → *Metadata`) — mismo tipo, dos nombres para dos contextos de uso (el
+ * array de la página vs. el `@Input` de un componente puntual).
+ */
+export type PageBlockMetadata = PageBlock;
+export {};

package/lib/components/organisms/video-player/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Tipos de `val-video-player` (ADR-087 — video como servicio de plataforma).
+ *
+ * Espejo agnóstico al dominio de `content.VideoAsset` (backend Go,
+ * `backend/go/services/content/video.go`) — mismos nombres de campo en
+ * camelCase. Cualquier app pasa acá el `VideoAsset` que le devuelve SU propio
+ * backend (sermón en Eklesee, receta en Okhelia, animal en Chesed, artículo de
+ * ayuda) con un mapeo trivial; el componente no conoce ni le importa de qué
+ * dominio viene.
+ */
+export type VideoPlayerSource = 'upload' | 'link';
+/** Solo aplica a `source: 'upload'`. Un link normalizado con éxito nace en 'ready'. */
+export type VideoPlayerStatus = 'uploading' | 'processing' | 'ready' | 'failed' | 'rejected';
+export interface VideoPlayerCaption {
+    locale: string;
+    url: string;
+}
+export interface VideoPlayerAsset {
+    source: VideoPlayerSource;
+    /**
+     * `source:'upload'` → URL de reproducción ya presignada por el backend
+     * (TTL corto, ~15 min — ADR-087 §6). Úsala directo, no la cachees ni la
+     * persistas: se recalcula en cada lectura del documento.
+     * `source:'link'` → URL normalizada del proveedor (no se usa para el
+     * embed, ver `externalId`).
+     */
+    url?: string;
+    /** `'youtube' | 'vimeo'` — solo si `source: 'link'`. */
+    provider?: string;
+    /**
+     * ID ya normalizado por el backend — el ÚNICO dato que arma el iframe de
+     * embed. El componente NUNCA arma un `src` con datos crudos del usuario.
+     */
+    externalId?: string;
+    durationSec?: number;
+    /** Portada — se muestra mientras el video no está `ready` (mejor percepción de carga). */
+    thumbnail?: string;
+    captions?: VideoPlayerCaption[];
+    status?: VideoPlayerStatus;
+    /**
+     * Motivo legible de `failed`/`rejected`, ya en el idioma que decidió el
+     * backend (es-CL) — se muestra tal cual, no es un código a traducir.
+     */
+    failReason?: string;
+}

package/lib/components/organisms/video-player/video-player.component.d.ts

@@ -0,0 +1,42 @@
+import { SafeResourceUrl } from '@angular/platform-browser';
+import { VideoPlayerAsset } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-video-player` — reproductor de video de plataforma (ADR-087, "Fase 1 —
+ * Reproducción"). Presentacional/dumb: recibe un `VideoPlayerAsset` YA
+ * RESUELTO por el backend de turno y decide el render, sin fetch propio.
+ *
+ * - `source:'upload'` + `status:'ready'` → `<video>` nativo (`preload="none"`
+ *   + portada — ADR-087 §8, cero bytes de video hasta que alguien le da play).
+ * - `source:'upload'` + `uploading|processing` → portada (si hay) + mensaje.
+ * - `source:'upload'` + `failed|rejected` → mensaje legible con `failReason`
+ *   (texto ya resuelto por el backend, se muestra tal cual).
+ * - `source:'link'` → iframe **siempre** contra un patrón fijo por proveedor
+ *   conocido (`youtube-nocookie.com/embed/{id}` · `player.vimeo.com/video/{id}`),
+ *   nunca un `src` armado con datos crudos del usuario. Proveedor no
+ *   reconocido → mensaje, nunca un iframe "por si acaso".
+ *
+ * @example
+ * <val-video-player [video]="doc.video" />
+ */
+export declare class VideoPlayerComponent {
+    private readonly i18n;
+    private readonly sanitizer;
+    /** El `VideoAsset` ya resuelto por el backend. `null`/`undefined` → no renderiza nada. */
+    readonly video: import("@angular/core").InputSignal<VideoPlayerAsset>;
+    readonly asset: import("@angular/core").Signal<VideoPlayerAsset>;
+    readonly thumbFailed: import("@angular/core").WritableSignal<boolean>;
+    /**
+     * Arma el embed SIEMPRE contra un patrón fijo por proveedor conocido — el
+     * `externalId` es el único dato del backend que entra en el `src`. Un
+     * proveedor no reconocido devuelve `null` (el template cae al mensaje, no a
+     * un iframe "por si acaso"). `bypassSecurityTrustResourceUrl` es seguro acá
+     * porque el string completo lo arma este componente, nunca el usuario.
+     */
+    readonly embedUrl: import("@angular/core").Signal<SafeResourceUrl>;
+    constructor();
+    private buildEmbedUrl;
+    t(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VideoPlayerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<VideoPlayerComponent, "val-video-player", never, { "video": { "alias": "video"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/lib/services/comms-preferences/comms-preferences.service.d.ts

@@ -0,0 +1,15 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { ListCommsSettingsResponse, SetCommsEnabledResponse, ValtechCommsPreferencesConfig } from './types';
+import * as i0 from "@angular/core";
+export declare class CommsPreferencesService {
+    private readonly http;
+    private readonly config;
+    private readonly baseUrl;
+    private readonly appId;
+    constructor(http: HttpClient, config: ValtechCommsPreferencesConfig | null);
+    list(): Observable<ListCommsSettingsResponse>;
+    setEnabled(templateId: string, enabled: boolean): Observable<SetCommsEnabledResponse>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CommsPreferencesService, [null, { optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CommsPreferencesService>;
+}

package/lib/services/comms-preferences/config.d.ts

@@ -0,0 +1,14 @@
+import { EnvironmentProviders, InjectionToken } from '@angular/core';
+import { ValtechCommsPreferencesConfig } from './types';
+export declare const VALTECH_COMMS_PREFERENCES_CONFIG: InjectionToken<ValtechCommsPreferencesConfig>;
+/**
+ * Provee el servicio de comms-preferences (ADR-089) a la aplicacion Angular.
+ *
+ * @example
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideValtechCommsPreferences({ apiUrl: environment.apiUrl, appId: 'bingo' }),
+ *   ],
+ * });
+ */
+export declare function provideValtechCommsPreferences(config: ValtechCommsPreferencesConfig): EnvironmentProviders;

package/lib/services/comms-preferences/index.d.ts

@@ -0,0 +1,3 @@
+export * from './comms-preferences.service';
+export * from './config';
+export * from './types';

package/lib/services/comms-preferences/types.d.ts

@@ -0,0 +1,21 @@
+export interface ValtechCommsPreferencesConfig {
+    apiUrl: string;
+    appId: string;
+}
+export interface CommunicationSetting {
+    templateId: string;
+    label: string;
+    labelEn: string;
+    audience: string;
+    enabled: boolean;
+    isDefault: boolean;
+}
+export interface ListCommsSettingsResponse {
+    operationId: string;
+    settings: CommunicationSetting[];
+}
+export interface SetCommsEnabledResponse {
+    operationId: string;
+    templateId: string;
+    enabled: boolean;
+}

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

package/package.json

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

package/public-api.d.ts

@@ -498,6 +498,9 @@ export * from './lib/components/molecules/content-reaction/content-reaction-moda
 export * from './lib/components/molecules/content-reaction/types';
 export * from './lib/services/reactions/index';
 export * from './lib/services/collections';
+export * from './lib/services/comms-preferences';
+export * from './lib/components/organisms/comms-preferences-settings/comms-preferences-settings.component';
+export * from './lib/components/organisms/comms-preferences-settings/types';
 export * from './lib/services/entity-feed/index';
 export * from './lib/components/molecules/reaction-bar/reaction-bar.component';
 export * from './lib/components/molecules/reaction-bar/types';
@@ -577,3 +580,7 @@ export { ThreadPanelComponent } from './lib/components/organisms/thread-panel/th
 export * from './lib/services/forms';
 export * from './lib/services/metering.service';
 export { ValQuotaWarningComponent } from './lib/components/val-quota-warning/val-quota-warning.component';
+export * from './lib/components/organisms/page-block/page-block.component';
+export * from './lib/components/organisms/page-block/types';
+export * from './lib/components/organisms/video-player/video-player.component';
+export * from './lib/components/organisms/video-player/types';