valtech-components 2.0.726 → 2.0.728

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

@@ -85,3 +85,5 @@ export { HandoffService, HANDOFF_TOKEN_PARAM, HANDOFF_ROUTE_PARAM } from './hand
 export type { HandoffCreateRequest, HandoffCreateResponse, HandoffExchangeResponse, DetectAndExchangeOptions, } from './handoff.service';
 export { OrgSwitchService } from './org-switch.service';
 export type { OrgChangedEvent, SwitchOrgOptions } from './org-switch.service';
+export { NotificationActionService } from './notification-action.service';
+export type { NotificationOpenResult } from './notification-action.service';

package/lib/services/auth/notification-action.service.d.ts

@@ -0,0 +1,34 @@
+import { Router } from '@angular/router';
+import { AuthService } from './auth.service';
+import { HandoffService } from './handoff.service';
+import { OrgSwitchService } from './org-switch.service';
+import { ValtechAuthConfig } from './types';
+import { NotificationDocument, NotificationsService } from '../firebase/notifications.service';
+import * as i0 from "@angular/core";
+/** Resultado descriptivo del open() — útil para tests y telemetría. */
+export type NotificationOpenResult = 'navigated' | 'navigated-after-switch-org' | 'redirected-cross-app' | 'no-action-route' | 'cross-app-unconfigured' | 'handoff-failed';
+export declare class NotificationActionService {
+    private config;
+    private auth;
+    private orgSwitch;
+    private handoff;
+    private notifications;
+    private router;
+    constructor(config: ValtechAuthConfig, auth: AuthService, orgSwitch: OrgSwitchService, handoff: HandoffService, notifications: NotificationsService, router: Router);
+    /**
+     * Abre la notificación: marca como leída, switch-org si toca, navegación local o
+     * redirect cross-app vía handoff.
+     *
+     * No lanza errores hacia la UI — devuelve un resultado descriptivo. Errores
+     * técnicos quedan en console.warn.
+     */
+    open(notif: NotificationDocument): Promise<NotificationOpenResult>;
+    private activeOrg;
+    /**
+     * Construye URL absoluta para handoff cross-app preservando pathname y otros
+     * params existentes de la baseUrl.
+     */
+    private buildHandoffUrl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotificationActionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NotificationActionService>;
+}

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

@@ -26,6 +26,18 @@ export interface ValtechAuthConfig {
     enableFirebaseIntegration?: boolean;
     /** Habilitar registro automático de device tokens para push notifications (default: false) */
     enableDeviceRegistration?: boolean;
+    /**
+     * AppID de esta app dentro del factory (ej: 'showcase', 'sigify', 'myvaltech').
+     * Usado por NotificationActionService para decidir si una notificación
+     * apunta a la app actual o requiere handoff cross-app.
+     */
+    appId?: string;
+    /**
+     * Mapa appId → baseUrl absoluta para handoff cross-app.
+     * Ej: { sigify: 'https://sigify.com', myvaltech: 'https://app.myvaltech.com' }
+     * NotificationActionService usa este map al disparar handoff a otra app.
+     */
+    appUrls?: Record<string, string>;
 }
 /**
  * Estado completo de autenticación.

package/lib/services/firebase/notifications.service.d.ts

@@ -23,12 +23,20 @@ export interface NotificationDocument extends FirestoreDocument {
     body?: string;
     /** URL de imagen */
     image?: string;
-    /** Datos personalizados (ej: route, actionType) */
+    /** Datos personalizados (ej: route, actionType). Legacy — preferir actionRoute + payload */
     data?: Record<string, string>;
     /** Tipo de notificación */
     type?: 'fcm' | 'system' | 'reminder' | string;
     /** Si la notificación fue leída */
     isRead: boolean;
+    /** AppID origen (ej: 'showcase', 'sigify'). Permite cross-app routing */
+    appId?: string;
+    /** OrgID asociado (si la notif es org-scoped). Habilita switch-org al abrir */
+    orgId?: string;
+    /** Route destino al click (ej: '/app/docs/123') */
+    actionRoute?: string;
+    /** Payload estructurado para acciones (reemplazo tipado de `data`) */
+    payload?: Record<string, unknown>;
 }
 /**
  * Servicio para leer notificaciones desde Firestore.

package/lib/services/markdown-article/legal-content.service.d.ts

@@ -0,0 +1,31 @@
+import { Observable } from 'rxjs';
+import { ArticleMetadata } from '../../components/organisms/article/types';
+import * as i0 from "@angular/core";
+export type LegalSlug = 'terms' | 'privacy' | 'cookies' | 'data-usage' | 'legal-notice' | string;
+export interface LegalLoadOptions {
+    /** Two-letter locale code (es, en, pt). Falls back to `es` on 404. */
+    locale?: string;
+    /** Override base path (default `/assets/legal`). */
+    basePath?: string;
+    /** Fallback locale tried when the requested one is missing. Set null to disable. */
+    fallbackLocale?: string | null;
+}
+/**
+ * Loads Markdown legal documents from `/assets/legal/{locale}/{slug}.md` and parses them
+ * into ArticleMetadata ready for `<val-article>`. Caches parsed results by `locale:slug`
+ * so multiple views consuming the same doc share one HTTP request.
+ */
+export declare class LegalContentService {
+    private readonly http;
+    private readonly parser;
+    private readonly DEFAULT_BASE;
+    private readonly cache;
+    load(slug: LegalSlug, options?: LegalLoadOptions): Observable<ArticleMetadata>;
+    /** Returns the raw Markdown string without parsing. Useful for debugging. */
+    raw(slug: LegalSlug, options?: LegalLoadOptions): Observable<string>;
+    /** Clears the in-memory cache. Call when the user changes locale at runtime. */
+    invalidate(): void;
+    private fetchAndParse;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LegalContentService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LegalContentService>;
+}

package/lib/services/markdown-article/markdown-article-parser.service.d.ts

@@ -0,0 +1,31 @@
+import { ArticleMetadata } from '../../components/organisms/article/types';
+import * as i0 from "@angular/core";
+/**
+ * Converts Markdown documents into ArticleMetadata for the val-article organism.
+ *
+ * Supported syntax:
+ * - Headings (#, ##, ### …) → title / subtitle
+ * - Paragraphs → paragraph (with `processLinks` + `allowPartialBold`)
+ * - Lists (-, *, 1.) → unordered / ordered list (- [ ] / - [x] for checklist)
+ * - Blockquotes (>) → quote, with GitHub callouts `> [!NOTE|TIP|INFO|WARNING|CAUTION|IMPORTANT]` mapped to notes
+ * - Code fences (```lang) → code
+ * - Box-drawing ASCII art (┌┐└┘│─) auto-wrapped as code
+ * - Tables → flattened into paragraphs with bold keys
+ * - Horizontal rules (---, ***, ___) → separator
+ */
+export declare class MarkdownArticleParserService {
+    parse(markdown: string, config?: Partial<ArticleMetadata>): ArticleMetadata;
+    private normalize;
+    private startsNewBlock;
+    private makeHeading;
+    private makeQuoteOrCallout;
+    private makeNote;
+    /**
+     * Tables are flattened into a header subtitle (if present) followed by one paragraph per
+     * data row using `**col[0]:** col[1] · **col[2]:** col[3] …` format. val-article has no
+     * native table element so this preserves the information without breaking the layout.
+     */
+    private makeTable;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MarkdownArticleParserService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MarkdownArticleParserService>;
+}

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

package/package.json

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

package/public-api.d.ts

@@ -239,6 +239,8 @@ export * from './lib/services/qr-generator/types';
 export * from './lib/services/modal/modal.service';
 export * from './lib/services/modal/types';
 export * from './lib/services/meta';
+export * from './lib/services/markdown-article/markdown-article-parser.service';
+export * from './lib/services/markdown-article/legal-content.service';
 export * from './lib/services/firebase';
 export * from './lib/services/auth';
 export * from './lib/services/i18n';