valtech-components 2.0.942 → 2.0.944

package/lib/config/index.d.ts

@@ -2,3 +2,4 @@
  * Shared configuration exports
  */
 export * from './company-footer.config';
+export * from './site-links.config';

package/lib/config/site-links.config.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Standard cross-app site links (env-aware)
+ *
+ * En el factory MyValtech cada producto satélite (showcase, sigify, …) enlaza a
+ * `web` —la landing de marca— para soporte, contacto y contenido legal. `web`
+ * es el dueño canónico de esas rutas. Este módulo centraliza:
+ *
+ *  1. El mapa ambiente → base URL de `web` (`VALTECH_WEB_BASE_URLS`).
+ *  2. El catálogo de paths estándar que viven en `web` (`VALTECH_SITE_PATHS`).
+ *
+ * El ambiente se decide en BUILD TIME (campo `valtechEnv` en el `environment*.ts`
+ * de cada app), igual que `apiUrl`. Es el mecanismo más confiable: detectar por
+ * hostname en runtime se rompe con dominios custom / `web.app` / variantes de
+ * localhost.
+ *
+ * La resolución real (join baseUrl + path, abrir en tab nueva, `?lang=`) la hace
+ * `LegalLinkService`; este módulo solo le entrega el `baseUrl` correcto por env.
+ *
+ * @see provideValtechSite — wiring de una sola línea para apps satélite.
+ */
+/** Ambientes del factory. Coincide con los `environment*.ts` de cada app. */
+export type ValtechEnv = 'local' | 'dev' | 'prod';
+/**
+ * Base URL de `web` (landing de marca) por ambiente.
+ *
+ * - `local` → `ng serve` de `web` (puerto 8100).
+ * - `dev`   → proyecto Firebase `myvaltech-dev`.
+ * - `prod`  → dominio custom de producción.
+ *
+ * Sin trailing slash (lo asume `LegalLinkService`).
+ */
+export declare const VALTECH_WEB_BASE_URLS: Record<ValtechEnv, string>;
+/**
+ * Resuelve la base URL de `web` para un ambiente.
+ *
+ * Fallback a `prod` cuando el env es desconocido o falta: ante la duda, apuntar
+ * a producción es lo seguro (nunca enlaza a un host local/dev inexistente).
+ */
+export declare function resolveWebBaseUrl(env?: ValtechEnv | string | null): string;
+/**
+ * Catálogo de paths estándar que viven en `web`. Las apps resuelven estos
+ * contra la base URL del ambiente vía `LegalLinkService.resolve(path)`.
+ *
+ * Mantener alineado con las rutas reales de `web/src/app/app.routes.ts` y con
+ * `VALTECH_COMPANY_LINKS` (footer).
+ */
+export declare const VALTECH_SITE_PATHS: {
+    readonly home: "/";
+    readonly support: "/contact";
+    readonly contact: "/contact";
+    readonly faq: "/faq";
+    readonly about: "/legal/about";
+    readonly terms: "/legal/terms";
+    readonly privacy: "/legal/privacy";
+    readonly cookies: "/legal/cookies";
+    readonly legalNotice: "/legal/legal-notice";
+};
+/** Clave de un link estándar del sitio (`'home' | 'support' | …`). */
+export type ValtechSitePathKey = keyof typeof VALTECH_SITE_PATHS;

package/lib/services/legal-link/legal-link.service.d.ts

@@ -1,4 +1,5 @@
 import { InjectionToken, Provider } from '@angular/core';
+import { ValtechEnv } from '../../config/site-links.config';
 import * as i0 from "@angular/core";
 /**
  * Config for cross-app legal/site link resolution.
@@ -71,3 +72,23 @@ export declare class LegalLinkService {
  * }),
  */
 export declare function provideValtechLegal(config: ValtechLegalConfig): Provider;
+/**
+ * Wiring de una sola línea para que una app satélite apunte sus links de sitio
+ * (legal, soporte, contacto, …) a `web` —la landing de marca— en el ambiente
+ * correcto. Resuelve el `baseUrl` desde `VALTECH_WEB_BASE_URLS` según el `env`
+ * baked en build-time (`environment.valtechEnv`) y delega en `provideValtechLegal`.
+ *
+ * Ambiente desconocido/ausente → fallback a `prod` (ver `resolveWebBaseUrl`).
+ * El main site (`web`) NO llama esto — sus links quedan relativos.
+ *
+ * @example
+ * // main.ts de showcase / sigify / …
+ * import { environment } from './environments/environment';
+ * provideValtechSite(environment.valtechEnv),  // 'local' | 'dev' | 'prod'
+ *
+ * @see resolveWebBaseUrl
+ * @see VALTECH_SITE_PATHS — catálogo de paths estándar que viven en `web`.
+ */
+export declare function provideValtechSite(env?: ValtechEnv | string | null, options?: {
+    openInNewTab?: boolean;
+}): Provider;

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

package/package.json

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