valtech-components 4.0.248 → 4.0.250

package/lib/components/molecules/usage-meters/types.d.ts

@@ -0,0 +1,24 @@
+export interface UsageMetric {
+    /** Clave de la métrica (ej. "emails_month"). */
+    key: string;
+    /** Etiqueta visible ya resuelta por el consumer (ej. "Emails / mes"). */
+    label: string;
+    /** Consumo del período. */
+    used: number;
+    /** Tope; -1 = ilimitado. */
+    limit: number;
+    /** true si el tope es ilimitado (-1). */
+    unlimited: boolean;
+}
+export interface UsageMetersMetadata {
+    /** Título de la sección (opcional). */
+    title?: string;
+    /** Nombre de la app a la que pertenece este bloque (para vista multi-app). */
+    appName?: string;
+    /** Tier del plan, para mostrar como badge (ej. "Pro"). */
+    plan?: string;
+    /** Período (ej. "2026-06"). */
+    period?: string;
+    /** Métricas a mostrar. */
+    metrics: UsageMetric[];
+}

package/lib/components/molecules/usage-meters/usage-meters.component.d.ts

@@ -0,0 +1,26 @@
+import { UsageMetersMetadata } from './types';
+import * as i0 from "@angular/core";
+interface MeterRow {
+    key: string;
+    label: string;
+    usedLabel: string;
+    pct: number;
+    unlimited: boolean;
+    over: boolean;
+}
+/**
+ * val-usage-meters — bloque de consumo (uso vs tope por métrica) para el
+ * dashboard de monetización (ADR-046 D3). Presentacional: recibe los datos ya
+ * resueltos (UsageService los arma desde Firestore). Reutilizable single-app o
+ * por sección en multi-app (myvaltech account).
+ */
+export declare class UsageMetersComponent {
+    private i18n;
+    readonly props: import("@angular/core").InputSignal<UsageMetersMetadata>;
+    constructor();
+    readonly rows: import("@angular/core").Signal<MeterRow[]>;
+    t(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UsageMetersComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UsageMetersComponent, "val-usage-meters", never, { "props": { "alias": "props"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+export {};

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

@@ -0,0 +1,25 @@
+import { Observable } from 'rxjs';
+import { UsageMetersMetadata } from '../../components/molecules/usage-meters/types';
+import * as i0 from "@angular/core";
+/**
+ * UsageService — lee el resumen de consumo (uso + límites + plan) en vivo desde
+ * Firestore y lo mapea a `UsageMetersMetadata` para `<val-usage-meters>`.
+ * (ADR-046 D3). Firestore es la fuente única (el backend proyecta usage+limits).
+ * Granular por app: `watch(appId, orgId)`. Multi-app: una suscripción por app.
+ */
+export declare class UsageService {
+    private firestore;
+    private i18n;
+    constructor();
+    /** Período actual `YYYY-MM` (UTC), igual que el backend. */
+    currentPeriod(): string;
+    /**
+     * Observa el consumo de (org, app) en vivo. Lee el path absoluto
+     * `apps/{appId}/orgs/{orgId}/usage/{period}` (sin auto-prefix de la app actual,
+     * para soportar la vista multi-app desde account).
+     */
+    watch(appId: string, orgId: string, appName?: string, period?: string): Observable<UsageMetersMetadata>;
+    private toMetadata;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UsageService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UsageService>;
+}

package/lib/services/workflows/workflow.service.d.ts

@@ -25,6 +25,17 @@ export interface WorkflowExecution extends FirestoreDocument {
     startedAt?: string;
     stoppedAt?: string;
 }
+/** Estado por-paso de una ejecución (vista "en acción"). */
+export interface WorkflowStep {
+    name: string;
+    status: 'pending' | 'running' | 'succeeded' | 'failed';
+    retries: number;
+}
+/** Resumen del historial de una ejecución. */
+export interface WorkflowHistory {
+    status: WorkflowStatus;
+    steps: WorkflowStep[];
+}
 /**
  * WorkflowService (ADR-045) — arranca state machines de Step Functions registradas
  * y observa su ejecución en tiempo real (Firestore). Reusable por cualquier app.
@@ -41,6 +52,8 @@ export declare class WorkflowService {
     constructor(config: ValtechAuthConfig | null);
     private get appIdHeader();
     start(name: string, input?: Record<string, unknown>): Observable<WorkflowStartResult>;
+    /** Resumen por-paso del historial de una ejecución (para mostrar el progreso). */
+    history(executionArn: string): Observable<WorkflowHistory>;
     watch(executionName: string): Observable<WorkflowExecution | null>;
     static ɵfac: i0.ɵɵFactoryDeclaration<WorkflowService, [{ optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<WorkflowService>;

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

package/package.json

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

package/public-api.d.ts

@@ -182,6 +182,9 @@ export * from './lib/components/molecules/media-object/media-object.component';
 export * from './lib/components/molecules/media-object/types';
 export * from './lib/components/molecules/stats-bar/stats-bar.component';
 export * from './lib/components/molecules/stats-bar/types';
+export * from './lib/components/molecules/usage-meters/usage-meters.component';
+export * from './lib/components/molecules/usage-meters/types';
+export * from './lib/services/usage/usage.service';
 export * from './lib/components/molecules/article-card/article-card.component';
 export * from './lib/components/molecules/article-card/types';
 export * from './lib/components/molecules/cta-card/cta-card.component';