template-common 1.1.8 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,46 +1,46 @@
1
- # template-common
2
-
3
- Librería web, maqueta de configuración y componentes para proyectos sass.
4
-
5
- > **Antes se llamaba `sass-template-common`.** Ese paquete quedó deprecado en npm: sigue instalando, pero no recibe versiones nuevas.
6
- >
7
- > **Migrar un consumidor sin tocar código** (mantiene `node_modules/sass-template-common`, así que imports, `noExternal` y rutas a `dist/` siguen funcionando):
8
- > ```json
9
- > "sass-template-common": "npm:template-common@^1.1.0"
10
- > ```
11
- > Después, repo por repo, se puede reemplazar `sass-template-common` por `template-common` en el código y quitar el alias.
12
- >
13
- > Los archivos de `dist/` conservan el nombre `sass-template-common.*` hasta la 2.0.0.
14
-
15
- ## Publicar nueva versión
16
-
17
- Para que los cambios se reflejen al publicar:
18
-
19
- 1. **Subir versión** (obligatorio; si no, npm rechaza o se usa la misma versión):
20
- ```bash
21
- pnpm version:patch # 0.3.21 → 0.3.22
22
- # o
23
- pnpm version:minor # 0.3.21 → 0.4.0
24
- pnpm version:major # 0.3.21 → 1.0.0
25
- ```
26
-
27
- 2. **Build limpio + publicar**:
28
- ```bash
29
- pnpm run clean && pnpm run build && pnpm publish
30
- ```
31
- O en un solo paso (patch):
32
- ```bash
33
- pnpm release:patch
34
- ```
35
-
36
- 3. **`prepublishOnly`**: Antes de cada `pnpm publish` se ejecuta `clean` + `build`, así siempre se publica un build nuevo, y después `scripts/changelog.mjs`, que deja la entrada de la versión en `changelog/<major>.<minor>.x.md` (un archivo por minor). Esa entrada es un borrador armado desde los commits; `/changelog` en Claude Code lo cura y completa las versiones que hayan quedado sin entrada. `pnpm changelog:check` muestra qué falta.
37
-
38
- 4. **En proyectos que consumen la lib**: Actualizar la dependencia y reinstalar:
39
- ```bash
40
- pnpm update template-common
41
- # o cambiar la versión en package.json y luego
42
- pnpm install
43
- ```
44
- Si usan versión fija (`"0.3.21"`), hay que actualizarla a la nueva (p. ej. `"0.3.22"`).
45
-
46
- **Si no ves los cambios:** comprueba que subiste la versión (`version:patch` o similar), que hiciste `clean` + `build` antes de publicar, y que el proyecto consumidor tiene actualizada la dependencia (o `^0.3.21` y ha ejecutado `pnpm update`).
1
+ # template-common
2
+
3
+ Librería web, maqueta de configuración y componentes para proyectos sass.
4
+
5
+ > **Antes se llamaba `sass-template-common`.** Ese paquete quedó deprecado en npm: sigue instalando, pero no recibe versiones nuevas.
6
+ >
7
+ > **Migrar un consumidor sin tocar código** (mantiene `node_modules/sass-template-common`, así que imports, `noExternal` y rutas a `dist/` siguen funcionando):
8
+ > ```json
9
+ > "sass-template-common": "npm:template-common@^1.1.0"
10
+ > ```
11
+ > Después, repo por repo, se puede reemplazar `sass-template-common` por `template-common` en el código y quitar el alias.
12
+ >
13
+ > Los archivos de `dist/` conservan el nombre `sass-template-common.*` hasta la 2.0.0.
14
+
15
+ ## Publicar nueva versión
16
+
17
+ Para que los cambios se reflejen al publicar:
18
+
19
+ 1. **Subir versión** (obligatorio; si no, npm rechaza o se usa la misma versión):
20
+ ```bash
21
+ pnpm version:patch # 0.3.21 → 0.3.22
22
+ # o
23
+ pnpm version:minor # 0.3.21 → 0.4.0
24
+ pnpm version:major # 0.3.21 → 1.0.0
25
+ ```
26
+
27
+ 2. **Build limpio + publicar**:
28
+ ```bash
29
+ pnpm run clean && pnpm run build && pnpm publish
30
+ ```
31
+ O en un solo paso (patch):
32
+ ```bash
33
+ pnpm release:patch
34
+ ```
35
+
36
+ 3. **`prepublishOnly`**: Antes de cada `pnpm publish` se ejecuta `clean` + `build`, así siempre se publica un build nuevo, y después `scripts/changelog.mjs`, que deja la entrada de la versión en `changelog/<major>.<minor>.x.md` (un archivo por minor). Esa entrada es un borrador armado desde los commits; `/changelog` en Claude Code lo cura y completa las versiones que hayan quedado sin entrada. `pnpm changelog:check` muestra qué falta.
37
+
38
+ 4. **En proyectos que consumen la lib**: Actualizar la dependencia y reinstalar:
39
+ ```bash
40
+ pnpm update template-common
41
+ # o cambiar la versión en package.json y luego
42
+ pnpm install
43
+ ```
44
+ Si usan versión fija (`"0.3.21"`), hay que actualizarla a la nueva (p. ej. `"0.3.22"`).
45
+
46
+ **Si no ves los cambios:** comprueba que subiste la versión (`version:patch` o similar), que hiciste `clean` + `build` antes de publicar, y que el proyecto consumidor tiene actualizada la dependencia (o `^0.3.21` y ha ejecutado `pnpm update`).
@@ -272,6 +272,41 @@ export declare const AssetsPreconnect: () => false | "" | JSX.Element | undefine
272
272
 
273
273
  export declare function auditConfigOrigin(entry: ConfigOriginAuditEntry): void;
274
274
 
275
+ /**
276
+ * `[<prefijo actual><base>, <viejo 1><base>, ...]`. El primero es el único que
277
+ * se escribe; el resto solo se lee.
278
+ */
279
+ export declare const authCookieNames: (cfg: AuthCookiePrefixConfig, base: string, prefix?: string) => string[];
280
+
281
+ /**
282
+ * Nombres de las cookies del login propio del sitio (`<prefix>IS_AUTH`,
283
+ * `<prefix>userInfo`, ...) y su lectura con prefijos viejos de respaldo.
284
+ *
285
+ * Módulo puro, sin imports: lo cargan `coreAuth.ts`, el LoginForm y los tests
286
+ * de `scripts/test-auth-cookie-names.mjs` desde node.
287
+ *
288
+ * Renombrar el prefijo sin cortar sesiones: el sitio pasa el prefijo nuevo en
289
+ * `COGNITO_AUTH_PREFIX` y los anteriores en `COGNITO_AUTH_LEGACY_PREFIXES`.
290
+ * Se lee primero el nombre nuevo y, si falta o está vacío, cada nombre viejo en
291
+ * orden. Los viejos son SOLO de lectura: la librería no escribe cookies de
292
+ * sesión; renombrarlas (escribir la nueva y borrar la vieja) es trabajo de las
293
+ * rutas `/api/auth/*` del sitio, que son las que conocen sus atributos.
294
+ *
295
+ * Sin `COGNITO_AUTH_LEGACY_PREFIXES` (todos los sitios salvo el que lo active)
296
+ * la lista de nombres tiene un solo elemento y el comportamiento es idéntico al
297
+ * anterior.
298
+ */
299
+ /** Las claves de config que este módulo necesita. */
300
+ export declare type AuthCookiePrefixConfig = {
301
+ /** `''` o `null` = sin prefijo. `undefined` = `'ASTRO_'` histórico. */
302
+ COGNITO_AUTH_PREFIX?: string | null;
303
+ /**
304
+ * Prefijos anteriores que se aceptan SOLO para leer, en orden de prioridad
305
+ * (`''` = sin prefijo). Opt-in: sin la clave no hay respaldo.
306
+ */
307
+ COGNITO_AUTH_LEGACY_PREFIXES?: readonly (string | null)[] | null;
308
+ };
309
+
275
310
  export declare interface Author {
276
311
  firstname: string;
277
312
  lastname: string;
@@ -654,7 +689,10 @@ export { BuscarClient as BuscarClientComponent }
654
689
  export declare type BuscarClientConfig = {
655
690
  /** Kill switch. `false` apaga la feature aunque el objeto este presente. */
656
691
  enabled?: boolean;
657
- /** Tamano del lote de `/news-list-search` (submit y cada "Ver mas"). Default 20. */
692
+ /**
693
+ * Tamano del lote de `/news-list-search` (submit y cada "Ver mas"). Default 21:
694
+ * multiplo de 3, completa 7 filas exactas de la grilla de 3 columnas por tanda.
695
+ */
658
696
  size?: number;
659
697
  /**
660
698
  * Tamano de "Ultimas Noticias" (sin resultados o con error). Default 21: la
@@ -665,7 +703,7 @@ export declare type BuscarClientConfig = {
665
703
  loadMore?: boolean;
666
704
  /**
667
705
  * Ultima pagina que alcanza "Ver mas", contando la 1 del submit: 5 => 4
668
- * clicks (100 resultados con `size` 20). Default 5, igual que `CONFIG_listLoadMore`.
706
+ * clicks (105 resultados con `size` 21). Default 5, igual que `CONFIG_listLoadMore`.
669
707
  */
670
708
  maxPages?: number;
671
709
  /**
@@ -1394,7 +1432,7 @@ export declare const contractWarn: (component: string, field: string, extra?: un
1394
1432
  export declare const CORE_AUTH_CHANGED_EVENT = "core-auth:changed";
1395
1433
 
1396
1434
  /** Claves de config que usa el login del header y la página de cuenta. */
1397
- export declare const CORE_AUTH_CONFIG_KEYS: readonly ["CONFIG_headerAuth", "CONFIG_authUserImage", "CONFIG_accountPath", "CONFIG_authAvatarBase", "CONFIG_authMockUser", "CONFIG_profilePreferences", "CONFIG_profileNewsletters", "COGNITO_AUTH_PREFIX", "PUBLIC_ENV", "PUBLIC_LNG", "PUBLIC_SERVICE_PREFIX", "PUBLIC_IS_SUB_PUBLICATION", "FORCE_SUB_PUBLICATION_PREFIX"];
1435
+ export declare const CORE_AUTH_CONFIG_KEYS: readonly ["CONFIG_headerAuth", "CONFIG_authUserImage", "CONFIG_accountPath", "CONFIG_authAvatarBase", "CONFIG_authMockUser", "CONFIG_profilePreferences", "CONFIG_profileNewsletters", "COGNITO_AUTH_PREFIX", "COGNITO_AUTH_LEGACY_PREFIXES", "PUBLIC_ENV", "PUBLIC_LNG", "PUBLIC_SERVICE_PREFIX", "PUBLIC_IS_SUB_PUBLICATION", "FORCE_SUB_PUBLICATION_PREFIX"];
1398
1436
 
1399
1437
  /** Largo máximo de nombre y apellido (mismo límite que `/api/auth/update-profile`). */
1400
1438
  export declare const CORE_AUTH_NAME_MAX_LENGTH = 60;
@@ -2244,13 +2282,13 @@ data: Array<ItemList>;
2244
2282
  }, any, {}>>;
2245
2283
 
2246
2284
  export declare const getScriptReplaces: {
2247
- [key in MetadataDefaultsKeys]: (props: Props_7) => replaces | undefined;
2285
+ [key in MetadataRouteKeys]: (props: Props_7) => replaces | undefined;
2248
2286
  };
2249
2287
 
2250
2288
  export declare function getServicePrefix(cfg?: PrefixConfig): string;
2251
2289
 
2252
2290
  export declare const getSlugs: {
2253
- [key in MetadataDefaultsKeys]: any;
2291
+ [key in MetadataRouteKeys]: any;
2254
2292
  };
2255
2293
 
2256
2294
  /** String (o undefined) para una clave dinámica; nunca devuelve el objeto `comentarios`. */
@@ -2314,7 +2352,10 @@ export declare interface Hascontent {
2314
2352
  hasembeddedbrid: boolean;
2315
2353
  }
2316
2354
 
2317
- /** `<prefix>IS_AUTH=true`: la setea el login (password o Google) y la borra el logout. */
2355
+ /**
2356
+ * `<prefix>IS_AUTH=true`: la setea el login (password o Google) y la borra el logout.
2357
+ * Con `COGNITO_AUTH_LEGACY_PREFIXES` también vale el nombre viejo (gana el nuevo).
2358
+ */
2318
2359
  export declare const hasSessionCookie: (cfg?: CoreAuthConfig) => boolean;
2319
2360
 
2320
2361
  export declare type headConfig = {
@@ -2786,7 +2827,7 @@ declare interface ItemListSchemaProps {
2786
2827
  config: Config;
2787
2828
  pathname: string;
2788
2829
  axiosApi: AxiosInstance;
2789
- ROUTE: MetadataDefaultsKeys;
2830
+ ROUTE: MetadataRouteKeys;
2790
2831
  }
2791
2832
 
2792
2833
  /**
@@ -3080,8 +3121,8 @@ export declare type LibraryConfig = {
3080
3121
  * completo: `[]`. Aditivo/retro-compatible: solo afecta buscar-sin-query, que
3081
3122
  * en esta familia de templates nunca renderiza banners (el render del
3082
3123
  * `LandingTemplate` ya está gateado por `amount > 0`). Se tipa como `string[]`
3083
- * (no `MetadataDefaultsKeys[]`) para evitar el import circular config ↔
3084
- * metadata_defaults; las claves válidas son las de `MetadataDefaultsKeys`.
3124
+ * (no `MetadataRouteKeys[]`) para evitar el import circular config ↔
3125
+ * metadata_defaults; las claves válidas son las de `MetadataRouteKeys`.
3085
3126
  */
3086
3127
  CONFIG_bannersRequireQuery?: string[];
3087
3128
  /**
@@ -3127,6 +3168,13 @@ export declare type LibraryConfig = {
3127
3168
  ANALYTICS_comscore?: string | undefined;
3128
3169
  /** `''` o `null` = cookies de login sin prefijo (ver `authPrefix` en `coreAuth.ts`). */
3129
3170
  COGNITO_AUTH_PREFIX?: string | null;
3171
+ /**
3172
+ * Prefijos anteriores de las cookies de login, SOLO para leer mientras dura un
3173
+ * renombre (`''` = sin prefijo). Primero se lee `COGNITO_AUTH_PREFIX` y, si
3174
+ * falta, cada uno de estos en orden. Sin definir: sin respaldo (como antes).
3175
+ * Ver `helpers/auth/authCookieNames.ts`.
3176
+ */
3177
+ COGNITO_AUTH_LEGACY_PREFIXES?: readonly (string | null)[] | null;
3130
3178
  COGNITO_CLIENT_ID?: string;
3131
3179
  COGNITO_DOMAIN?: string;
3132
3180
  COGNITO_REDIRECT_URI?: string;
@@ -3491,10 +3539,26 @@ export declare type Metadata = {
3491
3539
  };
3492
3540
  };
3493
3541
 
3494
- export declare const metadata_defaults: { [key in MetadataDefaultsKeys]: any; };
3542
+ export declare const metadata_defaults: { [key in MetadataRouteKeys]: any; };
3495
3543
 
3496
3544
  export declare type MetadataDefaultsKeys = '404' | 'home' | 'slug' | 'news' | 'anuncia' | 'autor' | 'buscar' | 'contacto' | 'pages' | 'seccion' | 'tema' | 'ultimas-noticias' | 'video' | 'videos' | 'auth';
3497
3545
 
3546
+ /**
3547
+ * Keys OPT-IN: la librería las soporta, pero NO entran en `MetadataDefaultsKeys`
3548
+ * para no romper a los sitios que tipan sus mapas como
3549
+ * `{ [key in MetadataDefaultsKeys]: ... }` (exhaustivos). Un sitio que las use
3550
+ * tipa sus mapas con `MetadataRouteKeys`.
3551
+ *
3552
+ * `custom`: ruta propia del sitio (ej. podcast, en vivo). Calcada de `buscar`
3553
+ * pero sin el gate de query: banners siempre prendidos, sin schemas por default
3554
+ * (ver `ROUTE_HEAD_DEFAULTS` en Head.tsx). La ruta mete su propia
3555
+ * `custom_metadata`; el handler es solo el fallback.
3556
+ */
3557
+ export declare type MetadataOptionalKeys = 'custom';
3558
+
3559
+ /** Todo lo que acepta la librería como ruta: las de siempre + las opt-in. */
3560
+ export declare type MetadataRouteKeys = MetadataDefaultsKeys | MetadataOptionalKeys;
3561
+
3498
3562
  export declare const metadataToJSX: (metadata: any) => JSX_2.Element[];
3499
3563
 
3500
3564
  export declare const MiddleSection: FC<Props_27>;
@@ -4375,6 +4439,8 @@ declare type Props_15 = {
4375
4439
  API_ENV: {
4376
4440
  /** `''` o `null` = cookies de login sin prefijo. */
4377
4441
  COGNITO_AUTH_PREFIX: string | null;
4442
+ /** Prefijos viejos, solo lectura (ver `COGNITO_AUTH_LEGACY_PREFIXES` en config). */
4443
+ COGNITO_AUTH_LEGACY_PREFIXES?: readonly (string | null)[] | null;
4378
4444
  PUBLIC_ENV: string;
4379
4445
  CAPTCHA_KEY: string;
4380
4446
  /** Kill switch de reCAPTCHA. Sin definir: captcha activo (como hoy). */
@@ -4756,7 +4822,7 @@ declare type Props_5 = {
4756
4822
  banners: BannerResponse[];
4757
4823
  config: Config;
4758
4824
  socials: Socials;
4759
- defaultMetadataName: MetadataDefaultsKeys;
4825
+ defaultMetadataName: MetadataRouteKeys;
4760
4826
  meta: any;
4761
4827
  imgSizes?: any;
4762
4828
  texts?: textsType;
@@ -4928,7 +4994,7 @@ declare type Props_59 = {
4928
4994
 
4929
4995
  declare type Props_6 = {
4930
4996
  children: ReactNode;
4931
- defaultRouteName: MetadataDefaultsKeys;
4997
+ defaultRouteName: MetadataRouteKeys;
4932
4998
  banners: BannerResponse[];
4933
4999
  pathname: string;
4934
5000
  config: Config;
@@ -5001,6 +5067,13 @@ declare type Props_9 = {
5001
5067
  };
5002
5068
  };
5003
5069
 
5070
+ /**
5071
+ * Valor crudo de la cookie `name` en un string tipo `document.cookie`, por
5072
+ * nombre EXACTO (sin prefijo, `IS_AUTH` no matchea `bs_IS_AUTH`). `null` si no
5073
+ * está. Sin decodificar.
5074
+ */
5075
+ export declare const readCookieFromString: (cookieString: string | null | undefined, name: string) => string | null;
5076
+
5004
5077
  /**
5005
5078
  * Lectura SINCRÓNICA, sin red: mock de dev, la cookie `<prefix>userInfo`, o
5006
5079
  * el usuario cacheado en esta pestaña. Sin cookie de sesión => deslogueado.
@@ -5009,6 +5082,15 @@ export declare const readCoreAuthUser: (cfg?: CoreAuthConfig) => CoreAuthUser |
5009
5082
 
5010
5083
  export declare const Readest: FC<Props_30>;
5011
5084
 
5085
+ /**
5086
+ * Primer nombre de `names` con valor no vacío. Si están el nuevo y el viejo,
5087
+ * gana el nuevo (es el primero de la lista). `null` si no hay ninguno con valor.
5088
+ */
5089
+ export declare const readFirstCookie: (cookieString: string | null | undefined, names: readonly string[]) => {
5090
+ name: string;
5091
+ value: string;
5092
+ } | null;
5093
+
5012
5094
  /**
5013
5095
  * Token que devuelve `getCaptchaToken` cuando reCAPTCHA está desactivado por
5014
5096
  * `CONFIG_blockRecaptcha`. Es un placeholder no vacío a propósito: los call
@@ -5314,6 +5396,13 @@ export declare interface ResilientFetchOptions {
5314
5396
  /** Ignora `undefined` del override: un `texts.comentarios` parcial no pisa defaults. */
5315
5397
  export declare const resolveAccountProfileTexts: (lng?: string, overrides?: Partial<Record<keyof AccountProfileTexts, unknown>>) => AccountProfileTexts;
5316
5398
 
5399
+ /**
5400
+ * `''` o `null` son validos y significan "sin prefijo": las cookies ya quedan atadas al
5401
+ * dominio del sitio, el prefijo no las hace mas unicas y solo complica la CDN. Solo
5402
+ * `undefined` (sin configurar) cae al `'ASTRO_'` historico.
5403
+ */
5404
+ export declare const resolveAuthPrefix: (cfg: AuthCookiePrefixConfig) => string;
5405
+
5317
5406
  export declare function resolveBucketMenuSubtype(path?: string): string;
5318
5407
 
5319
5408
  /**
@@ -5384,6 +5473,13 @@ export declare const resolveHeaderAuthTexts: (lng?: string, overrides?: Partial<
5384
5473
  */
5385
5474
  export declare function resolveImageSizes(input: ImageSizesContractInput | undefined): ImageSizesResolution;
5386
5475
 
5476
+ /**
5477
+ * Prefijos viejos válidos, sin repetidos y sin el actual. `null` cuenta como
5478
+ * `''` (sin prefijo), igual que en `COGNITO_AUTH_PREFIX`. Cualquier otra cosa
5479
+ * que no sea string se ignora.
5480
+ */
5481
+ export declare const resolveLegacyAuthPrefixes: (cfg: AuthCookiePrefixConfig, current?: string) => string[];
5482
+
5387
5483
  /**
5388
5484
  * El toggle del boton "Ver mas" con los defaults aplicados, o `null` si el
5389
5485
  * sitio no lo prendio. Fuente UNICA de la resolucion: la consumen el componente,
@@ -6019,10 +6115,14 @@ export declare function usePlayIcon(): ComponentType<SVGProps<SVGSVGElement>>;
6019
6115
  /**
6020
6116
  * Cookie NO httpOnly con los datos visibles del usuario (JSON, URL-encoded por
6021
6117
  * `cookies.set` de Astro). Forma: {@link CoreAuthUser}. Señal visual, igual que
6022
- * `IS_AUTH`: no es prueba de sesión.
6118
+ * `IS_AUTH`: no es prueba de sesión. Es el nombre que el sitio ESCRIBE; para
6119
+ * leer con respaldo ver {@link userInfoCookieNames}.
6023
6120
  */
6024
6121
  export declare const userInfoCookieName: (cfg: CoreAuthConfig) => string;
6025
6122
 
6123
+ /** `userInfoCookieName` + los nombres viejos, en orden de lectura. */
6124
+ export declare const userInfoCookieNames: (cfg: CoreAuthConfig) => string[];
6125
+
6026
6126
  export declare interface UserType {
6027
6127
  username: string;
6028
6128
  firstname: string;