valtech-components 2.0.803 → 2.0.804

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

@@ -0,0 +1,33 @@
+import { EnvironmentProviders, InjectionToken } from '@angular/core';
+import { ValtechDonationConfig } from './types';
+/**
+ * Token de inyección para la configuración de Donation/Support.
+ */
+export declare const VALTECH_DONATION_CONFIG: InjectionToken<ValtechDonationConfig>;
+/** Configuración por defecto — sin métodos habilitados. */
+export declare const DEFAULT_DONATION_CONFIG: Partial<ValtechDonationConfig>;
+/**
+ * Provee el feature de aportes (Support) a la aplicación Angular.
+ *
+ * Cada app del factory declara qué métodos habilita. La vista de Support
+ * (heredada o local) renderiza solo los métodos configurados.
+ *
+ * @example
+ * ```typescript
+ * // main.ts
+ * provideValtechDonations({
+ *   appId: 'showcase',
+ *   methods: ['coffee', 'bank', 'ads'],
+ *   coffee: { provider: 'buymeacoffee', url: 'https://buymeacoffee.com/valtech' },
+ *   bank: {
+ *     accounts: [{
+ *       country: 'CL', bank: 'Banco X', accountType: 'Cuenta Corriente',
+ *       number: '000000000', taxId: '11.111.111-1', holder: 'Valtech SpA',
+ *       email: 'aportes@valtech.com', currency: 'CLP',
+ *     }],
+ *   },
+ *   ads: { provider: 'admob', rewardedUnitId: 'ca-app-pub-xxx' },
+ * }),
+ * ```
+ */
+export declare function provideValtechDonations(config: ValtechDonationConfig): EnvironmentProviders;

package/lib/services/donation/donation.service.d.ts

@@ -0,0 +1,54 @@
+import { BankAccount, DonationActionResult, DonationMethod } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `DonationService`
+ *
+ * Servicio cross-app para el feature de aportes voluntarios (Support).
+ * Patrón factory: cada app llama `provideValtechDonations(...)` y este
+ * servicio expone solo los métodos habilitados.
+ *
+ * **Fase 0 (placeholder)** — abre links externos + expone datos de config.
+ * Sin backend. Fases futuras: rewarded ads reales, webhook de café,
+ * registro de intents para una página de transparencia.
+ *
+ * @example
+ * ```typescript
+ * private donations = inject(DonationService);
+ *
+ * methods = this.donations.enabledMethods();  // ['coffee', 'bank']
+ * onCoffee() { this.donations.openCoffee(); }
+ * accounts = this.donations.bankAccounts();
+ * ```
+ */
+export declare class DonationService {
+    private readonly config;
+    /** Último intent registrado — útil para tests / debugging / UI feedback. */
+    private readonly _lastIntent;
+    readonly lastIntent: import("@angular/core").Signal<DonationMethod>;
+    /** Métodos habilitados por la app, en orden de config. */
+    readonly enabledMethods: import("@angular/core").Signal<DonationMethod[]>;
+    /** `true` si el método está habilitado en la config de la app. */
+    isEnabled(method: DonationMethod): boolean;
+    /** Cuentas bancarias configuradas (vacío si `bank` no está habilitado). */
+    bankAccounts(): BankAccount[];
+    /** Cuentas filtradas por país ISO — para apps multi-mercado. */
+    bankAccountsByCountry(country: string): BankAccount[];
+    /**
+     * Abre el checkout de "café" (Buy Me a Coffee / Ko-fi) en una pestaña nueva.
+     * El proveedor es el merchant of record — Valtech no procesa el pago.
+     */
+    openCoffee(): DonationActionResult;
+    /**
+     * Muestra un anuncio rewarded (opt-in). **Fase 0: no implementado** —
+     * placeholder hasta integrar el plugin de ads (AdMob/AdSense) + la
+     * categoría de consentimiento. Retorna `not-supported`.
+     */
+    showRewardedAd(): Promise<DonationActionResult>;
+    /**
+     * Registra la intención de aporte. **Fase 0: solo estado local.**
+     * Fase 4 — POST a un endpoint para una página de transparencia.
+     */
+    recordIntent(method: DonationMethod): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DonationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DonationService>;
+}

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

@@ -0,0 +1,25 @@
+/**
+ * Valtech Donation / Support Service
+ *
+ * Feature cross-app de aportes voluntarios. Patrón factory: cada app llama
+ * `provideValtechDonations(...)` y habilita los métodos que quiera
+ * (`ads` · `coffee` · `bank`).
+ *
+ * Importante (legal): el dinero recibido por una entidad con fines de lucro
+ * es ingreso afecto a impuesto, NO una donación deducible. La UI debe usar
+ * lenguaje de "aporte voluntario / apoyo", nunca "donación".
+ *
+ * @example
+ * ```typescript
+ * // main.ts
+ * provideValtechDonations({
+ *   appId: 'showcase',
+ *   methods: ['coffee', 'bank'],
+ *   coffee: { provider: 'buymeacoffee', url: 'https://buymeacoffee.com/valtech' },
+ *   bank: { accounts: [ ... ] },
+ * }),
+ * ```
+ */
+export { VALTECH_DONATION_CONFIG, provideValtechDonations, DEFAULT_DONATION_CONFIG, } from './config';
+export { DonationService } from './donation.service';
+export { DonationMethod, CoffeeProvider, AdsProvider, BankAccount, CoffeeConfig, AdsConfig, ValtechDonationConfig, DonationActionResult, } from './types';

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

@@ -0,0 +1,85 @@
+/**
+ * Valtech Donation / Support — tipos.
+ *
+ * Nota legal importante: el dinero recibido por una entidad con fines de lucro
+ * NO es una "donación" deducible de impuestos — es ingreso afecto. Por eso la
+ * UI debe usar lenguaje de "aporte voluntario / apoyo", nunca "donación" en su
+ * sentido jurídico. Ver `docs/` (pendiente) y la vista Support del consumer.
+ */
+/**
+ * Métodos de aporte soportados.
+ * - `ads`    — el usuario ve publicidad rewarded (opt-in) para apoyar.
+ * - `coffee` — pago único vía proveedor externo (Buy Me a Coffee / Ko-fi).
+ * - `bank`   — transferencia bancaria directa (se muestran los datos).
+ */
+export type DonationMethod = 'ads' | 'coffee' | 'bank';
+/** Proveedor del método "café". El merchant of record es el proveedor. */
+export type CoffeeProvider = 'buymeacoffee' | 'kofi' | 'custom';
+/** Proveedor de publicidad rewarded. */
+export type AdsProvider = 'admob' | 'adsense' | 'custom';
+/**
+ * Datos de una cuenta bancaria para transferencia. Pensado para ser
+ * por-país (el modelo factory es 1 producto = 1 dominio, con datos
+ * fiscales/bancarios distintos por mercado).
+ */
+export interface BankAccount {
+    /** ISO country code — ej. 'CL', 'AR', 'MX'. */
+    country: string;
+    /** Nombre del banco. */
+    bank: string;
+    /** Tipo de cuenta — ej. 'Cuenta Corriente', 'Vista', 'Checking'. */
+    accountType: string;
+    /** Número de cuenta / IBAN / CBU. */
+    number: string;
+    /** Identificador fiscal del titular — RUT, CUIT, RFC, etc. */
+    taxId: string;
+    /** Nombre del titular de la cuenta. */
+    holder: string;
+    /** Email para enviar comprobante de transferencia. */
+    email?: string;
+    /** Moneda — ej. 'CLP', 'USD'. */
+    currency?: string;
+}
+/** Config del método "café". */
+export interface CoffeeConfig {
+    provider: CoffeeProvider;
+    /** URL pública del perfil (BMC/Ko-fi) o checkout custom. */
+    url: string;
+}
+/** Config del método "ads" (rewarded, opt-in). */
+export interface AdsConfig {
+    provider: AdsProvider;
+    /** ID de la unidad de anuncio rewarded. */
+    rewardedUnitId?: string;
+}
+/**
+ * Configuración del feature Donation/Support.
+ *
+ * Cada app del factory declara qué métodos habilita. Una vista heredada
+ * (`val-*` page) renderiza solo los métodos en `methods`.
+ */
+export interface ValtechDonationConfig {
+    /** AppID — para tracking de intents (ej. analytics). */
+    appId?: string;
+    /** Métodos habilitados, en orden de aparición en la UI. */
+    methods: DonationMethod[];
+    /** Config del método café — requerido si `methods` incluye `'coffee'`. */
+    coffee?: CoffeeConfig;
+    /** Cuentas bancarias — requerido si `methods` incluye `'bank'`. */
+    bank?: {
+        accounts: BankAccount[];
+    };
+    /** Config de ads — requerido si `methods` incluye `'ads'`. */
+    ads?: AdsConfig;
+}
+/**
+ * Resultado de un intento de aporte. Devuelto por los métodos del servicio
+ * de forma descriptiva (no se lanzan excepciones para flujos esperables).
+ */
+export interface DonationActionResult {
+    method: DonationMethod;
+    /** `true` si la acción se inició correctamente. */
+    ok: boolean;
+    /** Motivo cuando `ok` es `false` — ej. 'not-configured', 'not-supported'. */
+    reason?: 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 = "2.0.803";
+export declare const VERSION = "2.0.804";

package/package.json

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

package/public-api.d.ts

@@ -272,6 +272,7 @@ export * from './lib/services/ads';
 export * from './lib/components/molecules/ad-slot/ad-slot.component';
 export * from './lib/services/content';
 export * from './lib/services/feedback';
+export * from './lib/services/donation';
 export * from './lib/components/molecules/feedback-form/feedback-form.component';
 export * from './lib/components/molecules/feedback-form/types';
 export * from './lib/components/molecules/content-reaction/content-reaction.component';