valtech-components 4.0.989 → 4.0.991

package/lib/components/organisms/survey-builder/survey-builder.component.d.ts

@@ -3,7 +3,7 @@ import { FormControl } from '@angular/forms';
 import { ButtonMetadata } from '../../types';
 import type { Color } from '@ionic/core';
 import { EditableFieldDef, FieldSchemaEditorMetadata } from '../field-schema-editor/types';
-import { SurveyBuilderMetadata, SurveyBuilderSaveEvent } from './types';
+import { SurveyBuilderMetadata, SurveyBuilderSaveEvent, SurveyDraftEvent } from './types';
 import * as i0 from "@angular/core";
 /**
  * val-survey-builder
@@ -25,6 +25,13 @@ import * as i0 from "@angular/core";
 export declare class SurveyBuilderComponent implements OnInit {
     props: SurveyBuilderMetadata;
     readonly saved: EventEmitter<SurveyBuilderSaveEvent>;
+    /**
+     * Emite lo escrito, ya validado, SIN guardarlo. Solo con `props.persist:
+     * false` — ver el comentario de ese campo: cuando la app tiene endpoint
+     * propio, guardar desde acá se salta la validación de la entidad dueña y el
+     * permiso de la vertical.
+     */
+    readonly draft: EventEmitter<SurveyDraftEvent>;
     private readonly i18n;
     private readonly requests;
     private readonly formBuilder;
@@ -61,5 +68,5 @@ export declare class SurveyBuilderComponent implements OnInit {
     save(): Promise<void>;
     private rowFromField;
     static ɵfac: i0.ɵɵFactoryDeclaration<SurveyBuilderComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SurveyBuilderComponent, "val-survey-builder", never, { "props": { "alias": "props"; "required": false; }; }, { "saved": "saved"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SurveyBuilderComponent, "val-survey-builder", never, { "props": { "alias": "props"; "required": false; }; }, { "saved": "saved"; "draft": "draft"; }, never, never, true, never>;
 }

package/lib/components/organisms/survey-builder/types.d.ts

@@ -1,4 +1,4 @@
-import { EntityRef, RequestTypeConfig, RequestVisibility } from '../../../services/requests/types';
+import { EntityRef, FieldSchemaDef, RequestTypeConfig, RequestVisibility } from '../../../services/requests/types';
 /**
  * Tipos de pregunta que ofrece una encuesta.
  *
@@ -46,7 +46,34 @@ export interface SurveyBuilderMetadata {
     allowAnonymous?: boolean;
     /** Acota el catálogo de `SURVEY_QUESTION_TYPES` si una app quiere ofrecer menos. */
     questionTypes?: string[];
+    /**
+     * Si el builder guarda por su cuenta contra `/v2/request-types`.
+     *
+     * Default `true` por compatibilidad, pero **una app con endpoint propio debe
+     * pasar `false`** y guardar ella: el endpoint de la vertical es el que valida
+     * la entidad dueña, evita que dos encuestas de distinto evento colisionen en
+     * el mismo `typeId`, y autoriza con SU permiso. Con `false`, `save()` valida
+     * y emite `draft` sin tocar la red.
+     */
+    persist?: boolean;
 }
 export interface SurveyBuilderSaveEvent {
     typeConfig: RequestTypeConfig;
 }
+/**
+ * Lo que se escribió, sin persistir.
+ *
+ * Existe porque **el builder no siempre debe guardar por su cuenta**. Cuando la
+ * app tiene su propio endpoint de dominio (el de bingo valida el evento, acota
+ * el `typeId` para que dos eventos no colisionen y autoriza con el permiso de
+ * la vertical en vez de `apps:manage`), guardar desde acá se salta todo eso.
+ *
+ * Los tres campos son exactamente los de `CreateEventSurveyRequest` en
+ * `services/bingo/survey.go` — no es casualidad: es el contrato que la app
+ * necesita reenviar.
+ */
+export interface SurveyDraftEvent {
+    label: string;
+    subtitle: string;
+    questions: FieldSchemaDef[];
+}

package/lib/services/errors/error-logging.interceptor.d.ts

@@ -16,7 +16,15 @@ export declare const EXPECTED_NOT_FOUND: HttpContextToken<boolean>;
  * Interceptor HTTP de observabilidad (Capa 1 del estándar de manejo de errores).
  *
  * Para CADA respuesta HTTP con error:
- * 1. Normaliza el error con `interpretError`.
+ * 0. Si es un GET (idempotente) que falló con 502/503/504, reintenta hasta 2
+ *    veces con un backoff corto (400ms/800ms) ANTES de pasar al resto del
+ *    pipeline — el caso típico es un cold-start de Lambda en dev: 3-4
+ *    requests en paralelo al bootstrap (auth/profile + runs + org/{id})
+ *    pegan contra lambdas frías al mismo tiempo, todas 504, y ~2s después ya
+ *    están tibias y funcionan. Detectado en Merotz dev 2026-08-17. Nunca
+ *    reintenta POST/PUT/DELETE/PATCH (no son idempotentes) ni 4xx (error de
+ *    negocio, reintentar no lo arregla).
+ * 1. Si sigue fallando tras los reintentos: normaliza el error con `interpretError`.
  * 2. Loguea un evento estructurado a consola con el prefijo `[HTTP]`.
  * 3. Reporta el error a Firebase Analytics (`source: 'http'`), si hay analytics.
  *

package/lib/services/payments/config.d.ts

@@ -0,0 +1,14 @@
+import { EnvironmentProviders, InjectionToken } from '@angular/core';
+import { ValtechPaymentsConfig } from './types';
+/** Token de inyección de la configuración de pagos. */
+export declare const VALTECH_PAYMENTS_CONFIG: InjectionToken<ValtechPaymentsConfig>;
+export declare const DEFAULT_PAYMENTS_CONFIG: Partial<ValtechPaymentsConfig>;
+/**
+ * Provee el cliente de pasarelas de pago.
+ *
+ * @example
+ * ```typescript
+ * providePaymentsGateway({ apiUrl: environment.apiUrl }),
+ * ```
+ */
+export declare function providePaymentsGateway(config: ValtechPaymentsConfig): EnvironmentProviders;

package/lib/services/payments/index.d.ts

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

package/lib/services/payments/payments-gateway.service.d.ts

@@ -0,0 +1,53 @@
+import { Observable } from 'rxjs';
+import { ConnectionStatusResponse, OAuthAuthorizeURLResponse } from './types';
+import * as i0 from "@angular/core";
+/**
+ * Cliente del onboarding de pasarelas de pago (ADR-028).
+ *
+ * Conecta la cuenta de UNA ORGANIZACIÓN con una pasarela, para que el dinero
+ * le llegue directo. Ese es el punto: si el dinero pasara por una cuenta de
+ * Valtech, Valtech sería un PSP regulado por la CMF (ver ADR-028). Por eso
+ * todas las operaciones son por `orgId`, y no existe acá un modo "cuenta de la
+ * plataforma".
+ *
+ * Vive en la lib y no en una app porque el flujo es idéntico en todas: Bingo
+ * lo usa para que cada colegio cobre sus cartones, y Chesed para que cada
+ * refugio reciba aportes. Lo que cambia entre apps es qué se cobra, no cómo se
+ * conecta la cuenta.
+ *
+ * Autenticación: no agrega el Bearer a mano — lo pone el interceptor de
+ * `provideValtechAuth`. Errores: no se capturan acá; los maneja la pantalla.
+ */
+export declare class PaymentsGatewayService {
+    private http;
+    private config;
+    private get base();
+    /**
+     * Estado de conexión de la organización con una pasarela.
+     *
+     * Es lo que decide si la app puede ofrecer el cobro: `connected` habilita,
+     * `expired` y `revoked` NO. Mostrar un botón de pago con un token revocado
+     * lleva al usuario a un cobro que falla después de que ya decidió pagar.
+     */
+    getConnectionStatus(orgId: string, gateway: string): Observable<ConnectionStatusResponse>;
+    /**
+     * URL de autorización OAuth, con su `state` CSRF.
+     *
+     * El caller guarda el `state` antes de redirigir y lo compara al volver: sin
+     * eso, cualquiera podría completar la conexión de otra organización.
+     */
+    getOAuthAuthorizeURL(orgId: string, gateway: string): Observable<OAuthAuthorizeURLResponse>;
+    /** Desconecta la credencial de la organización para esa pasarela. */
+    disconnect(orgId: string, gateway: string): Observable<{
+        operationId: string;
+    }>;
+    /**
+     * Guarda una credencial de acceso directo (pasarelas sin OAuth, ej. Khipu).
+     * El token es el secreto del cobrador.
+     */
+    setCredential(orgId: string, gateway: string, accessToken: string): Observable<{
+        operationId: string;
+    }>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PaymentsGatewayService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PaymentsGatewayService>;
+}

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

@@ -0,0 +1,33 @@
+/**
+ * Contratos del onboarding de pasarelas de pago (ADR-028).
+ *
+ * Espejo reducido del backend: solo lo que una app necesita para conectar la
+ * cuenta de una organización y saber si puede cobrar.
+ */
+/** Estado del ciclo de vida de una credencial OAuth. */
+export type OAuthStatus = 'never' | 'connected' | 'expired' | 'revoked';
+/**
+ * Respuesta de `connection-status`. No expone el token: solo un enmascarado
+ * informativo, porque la UI nunca necesita el secreto.
+ */
+export interface ConnectionStatusResponse {
+    operationId: string;
+    connected: boolean;
+    oauthStatus: OAuthStatus;
+    connectedAt?: string;
+    maskedToken?: string;
+}
+/** Respuesta de `oauth/authorize-url`. */
+export interface OAuthAuthorizeURLResponse {
+    operationId: string;
+    authorizeUrl: string;
+    /** CSRF. El caller lo guarda antes de redirigir y lo compara al volver. */
+    state: string;
+}
+/** Configuración del cliente de pagos. */
+export interface ValtechPaymentsConfig {
+    /** Base del backend, sin barra final (ej. `https://api-dev.myvaltech.com`). */
+    apiUrl: string;
+    /** Prefijo de la API de pagos. Default `/v1/payments`. */
+    paymentsPrefix?: string;
+}

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

package/package.json

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

package/public-api.d.ts

@@ -500,6 +500,7 @@ export * from './lib/components/organisms/verify-view/verify-view.component';
 export * from './lib/components/organisms/verify-view/types';
 export * from './lib/services/content-platform';
 export * from './lib/services/feedback';
+export * from './lib/services/payments';
 export * from './lib/services/whatsapp';
 export * from './lib/components/organisms/whatsapp-fab/whatsapp-fab.component';
 export * from './lib/services/phone-format/phone-format.service';