valtech-components 4.0.239 → 4.0.241

package/lib/services/events/meta.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Contrato de metadatos de eventos de dominio (ADR-043) — espejo TS del
+ * registro Go `services/events/routes.go`. Mantener ambos en sync.
+ *
+ * El sobre `meta` viaja con una operación async para que el ruteo a flujos
+ * downstream (mailer, archiver...) se resuelva declarativamente en EventBridge.
+ */
+export declare const META_SCHEMA_VERSION = 1;
+/** Intención de ruteo: QUÉ hacer con la salida, no qué servicio lo hace. */
+export type RouteIntent = 'email' | 'archive' | 'webhook';
+/** Set de intents válidos. Sumar uno nuevo aquí y en el registro Go. */
+export declare const KNOWN_ROUTES: readonly RouteIntent[];
+export declare function isKnownRoute(r: string): r is RouteIntent;
+/** Valida que todos los tags de `routes` estén registrados. Lanza si no. */
+export declare function validateRoutes(routes: string[] | undefined): void;
+/**
+ * Sobre opaco que el caller declara al encolar. El productor no lo interpreta:
+ * lo persiste y lo echa en el evento de completado. `params` chico e inline si
+ * no es sensible; grande/PII por puntero ({ ref: "directives/<id>" }).
+ */
+export interface EventMeta {
+    schemaVersion?: number;
+    correlationId?: string;
+    origin?: string;
+    routes?: RouteIntent[];
+    params?: Record<string, unknown>;
+}

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

@@ -1,6 +1,7 @@
 import { Observable } from 'rxjs';
 import { ValtechAuthConfig } from '../auth/types';
 import type { PdfGenerateRequest, PdfResult, PdfJob, PdfJobEnqueued } from './types';
+import { EventMeta } from '../events/meta';
 import * as i0 from "@angular/core";
 /**
  * Servicio de PDF de plataforma (ADR-042). Reutilizable por cualquier app.
@@ -35,7 +36,7 @@ export declare class PdfService {
      * Lambda lo genera fuera de banda y, al completar, proyecta el estado a
      * Firestore. Usar watchJob(jobId) para observar el resultado en tiempo real.
      */
-    createJob(req: PdfGenerateRequest): Observable<PdfJobEnqueued>;
+    createJob(req: PdfGenerateRequest, meta?: EventMeta): Observable<PdfJobEnqueued>;
     /**
      * Observa el estado de un job PDF async en tiempo real (onSnapshot del doc
      * `apps/{appId}/orgs/{orgId}/pdf-jobs/{jobId}`). Emite null si no hay org

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

package/package.json

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

package/public-api.d.ts

@@ -354,6 +354,7 @@ export * from './lib/components/templates/auth-background/types';
 export * from './lib/services/download.service';
 export * from './lib/services/pdf/pdf.service';
 export * from './lib/services/pdf/types';
+export * from './lib/services/events/meta';
 export * from './lib/services/icons.service';
 export * from './lib/services/in-app-browser.service';
 export * from './lib/services/link-processor.service';