template-common 1.2.0 → 1.2.2

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;
@@ -1397,7 +1432,7 @@ export declare const contractWarn: (component: string, field: string, extra?: un
1397
1432
  export declare const CORE_AUTH_CHANGED_EVENT = "core-auth:changed";
1398
1433
 
1399
1434
  /** Claves de config que usa el login del header y la página de cuenta. */
1400
- 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"];
1401
1436
 
1402
1437
  /** Largo máximo de nombre y apellido (mismo límite que `/api/auth/update-profile`). */
1403
1438
  export declare const CORE_AUTH_NAME_MAX_LENGTH = 60;
@@ -2095,7 +2130,7 @@ export declare interface FreeZoneResponse {
2095
2130
  };
2096
2131
  }
2097
2132
 
2098
- export declare const GA4: ({ id, dimensionValues, event_analytics, eventReplaces }: Props_2) => "" | JSX.Element | undefined;
2133
+ export declare const GA4: ({ id, dimensionValues, event_analytics, eventReplaces, }: Props_2) => "" | JSX.Element | undefined;
2099
2134
 
2100
2135
  export declare const GalleryHeader: ({ newsformated, internal, commonServices, }: {
2101
2136
  newsformated: NewListResponseData;
@@ -2317,7 +2352,10 @@ export declare interface Hascontent {
2317
2352
  hasembeddedbrid: boolean;
2318
2353
  }
2319
2354
 
2320
- /** `<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
+ */
2321
2359
  export declare const hasSessionCookie: (cfg?: CoreAuthConfig) => boolean;
2322
2360
 
2323
2361
  export declare type headConfig = {
@@ -2613,6 +2651,7 @@ export declare interface ImageSizesResolution {
2613
2651
 
2614
2652
  export declare interface Info {
2615
2653
  type?: string;
2654
+ creator?: string;
2616
2655
  /** Tipo de video cuando `type === 'video'`: flash, youtube o embedded. */
2617
2656
  videoOp?: 'vf' | 'vy' | 've';
2618
2657
  section?: {
@@ -3130,6 +3169,13 @@ export declare type LibraryConfig = {
3130
3169
  ANALYTICS_comscore?: string | undefined;
3131
3170
  /** `''` o `null` = cookies de login sin prefijo (ver `authPrefix` en `coreAuth.ts`). */
3132
3171
  COGNITO_AUTH_PREFIX?: string | null;
3172
+ /**
3173
+ * Prefijos anteriores de las cookies de login, SOLO para leer mientras dura un
3174
+ * renombre (`''` = sin prefijo). Primero se lee `COGNITO_AUTH_PREFIX` y, si
3175
+ * falta, cada uno de estos en orden. Sin definir: sin respaldo (como antes).
3176
+ * Ver `helpers/auth/authCookieNames.ts`.
3177
+ */
3178
+ COGNITO_AUTH_LEGACY_PREFIXES?: readonly (string | null)[] | null;
3133
3179
  COGNITO_CLIENT_ID?: string;
3134
3180
  COGNITO_DOMAIN?: string;
3135
3181
  COGNITO_REDIRECT_URI?: string;
@@ -4394,6 +4440,8 @@ declare type Props_15 = {
4394
4440
  API_ENV: {
4395
4441
  /** `''` o `null` = cookies de login sin prefijo. */
4396
4442
  COGNITO_AUTH_PREFIX: string | null;
4443
+ /** Prefijos viejos, solo lectura (ver `COGNITO_AUTH_LEGACY_PREFIXES` en config). */
4444
+ COGNITO_AUTH_LEGACY_PREFIXES?: readonly (string | null)[] | null;
4397
4445
  PUBLIC_ENV: string;
4398
4446
  CAPTCHA_KEY: string;
4399
4447
  /** Kill switch de reCAPTCHA. Sin definir: captcha activo (como hoy). */
@@ -5020,6 +5068,13 @@ declare type Props_9 = {
5020
5068
  };
5021
5069
  };
5022
5070
 
5071
+ /**
5072
+ * Valor crudo de la cookie `name` en un string tipo `document.cookie`, por
5073
+ * nombre EXACTO (sin prefijo, `IS_AUTH` no matchea `bs_IS_AUTH`). `null` si no
5074
+ * está. Sin decodificar.
5075
+ */
5076
+ export declare const readCookieFromString: (cookieString: string | null | undefined, name: string) => string | null;
5077
+
5023
5078
  /**
5024
5079
  * Lectura SINCRÓNICA, sin red: mock de dev, la cookie `<prefix>userInfo`, o
5025
5080
  * el usuario cacheado en esta pestaña. Sin cookie de sesión => deslogueado.
@@ -5028,6 +5083,15 @@ export declare const readCoreAuthUser: (cfg?: CoreAuthConfig) => CoreAuthUser |
5028
5083
 
5029
5084
  export declare const Readest: FC<Props_30>;
5030
5085
 
5086
+ /**
5087
+ * Primer nombre de `names` con valor no vacío. Si están el nuevo y el viejo,
5088
+ * gana el nuevo (es el primero de la lista). `null` si no hay ninguno con valor.
5089
+ */
5090
+ export declare const readFirstCookie: (cookieString: string | null | undefined, names: readonly string[]) => {
5091
+ name: string;
5092
+ value: string;
5093
+ } | null;
5094
+
5031
5095
  /**
5032
5096
  * Token que devuelve `getCaptchaToken` cuando reCAPTCHA está desactivado por
5033
5097
  * `CONFIG_blockRecaptcha`. Es un placeholder no vacío a propósito: los call
@@ -5333,6 +5397,13 @@ export declare interface ResilientFetchOptions {
5333
5397
  /** Ignora `undefined` del override: un `texts.comentarios` parcial no pisa defaults. */
5334
5398
  export declare const resolveAccountProfileTexts: (lng?: string, overrides?: Partial<Record<keyof AccountProfileTexts, unknown>>) => AccountProfileTexts;
5335
5399
 
5400
+ /**
5401
+ * `''` o `null` son validos y significan "sin prefijo": las cookies ya quedan atadas al
5402
+ * dominio del sitio, el prefijo no las hace mas unicas y solo complica la CDN. Solo
5403
+ * `undefined` (sin configurar) cae al `'ASTRO_'` historico.
5404
+ */
5405
+ export declare const resolveAuthPrefix: (cfg: AuthCookiePrefixConfig) => string;
5406
+
5336
5407
  export declare function resolveBucketMenuSubtype(path?: string): string;
5337
5408
 
5338
5409
  /**
@@ -5403,6 +5474,13 @@ export declare const resolveHeaderAuthTexts: (lng?: string, overrides?: Partial<
5403
5474
  */
5404
5475
  export declare function resolveImageSizes(input: ImageSizesContractInput | undefined): ImageSizesResolution;
5405
5476
 
5477
+ /**
5478
+ * Prefijos viejos válidos, sin repetidos y sin el actual. `null` cuenta como
5479
+ * `''` (sin prefijo), igual que en `COGNITO_AUTH_PREFIX`. Cualquier otra cosa
5480
+ * que no sea string se ignora.
5481
+ */
5482
+ export declare const resolveLegacyAuthPrefixes: (cfg: AuthCookiePrefixConfig, current?: string) => string[];
5483
+
5406
5484
  /**
5407
5485
  * El toggle del boton "Ver mas" con los defaults aplicados, o `null` si el
5408
5486
  * sitio no lo prendio. Fuente UNICA de la resolucion: la consumen el componente,
@@ -6038,10 +6116,14 @@ export declare function usePlayIcon(): ComponentType<SVGProps<SVGSVGElement>>;
6038
6116
  /**
6039
6117
  * Cookie NO httpOnly con los datos visibles del usuario (JSON, URL-encoded por
6040
6118
  * `cookies.set` de Astro). Forma: {@link CoreAuthUser}. Señal visual, igual que
6041
- * `IS_AUTH`: no es prueba de sesión.
6119
+ * `IS_AUTH`: no es prueba de sesión. Es el nombre que el sitio ESCRIBE; para
6120
+ * leer con respaldo ver {@link userInfoCookieNames}.
6042
6121
  */
6043
6122
  export declare const userInfoCookieName: (cfg: CoreAuthConfig) => string;
6044
6123
 
6124
+ /** `userInfoCookieName` + los nombres viejos, en orden de lectura. */
6125
+ export declare const userInfoCookieNames: (cfg: CoreAuthConfig) => string[];
6126
+
6045
6127
  export declare interface UserType {
6046
6128
  username: string;
6047
6129
  firstname: string;