sass-cms-template-common 0.0.31 → 0.0.33

package/dist/index.d.ts

@@ -4615,6 +4615,33 @@ declare interface IRecipesServices {
     authentication: Authentication;
 }
 
+/**
+ * Traspaso del token al cambiar de gestor — NAA-5150.
+ *
+ * El access token vive en `sessionStorage`, que es **por origen**: el token de
+ * `usuarios.…` no es el mismo objeto que el de `noticias.…`. Cuando el usuario
+ * pasa de un gestor a otro por el menú lateral, el gestor destino arranca con lo
+ * que tenga guardado de la última vez — y si esa vez era otro usuario, lo muestra
+ * a él. No hace falta ni un logout de por medio: alcanza con haber entrado antes
+ * con otra cuenta en ese dominio.
+ *
+ * La solución es la misma que ya usa la login app para entregar la sesión: pasar
+ * el token en el **fragmento** de la URL destino (`#access_token=…`), que el
+ * gestor consume al arrancar y guarda pisando el viejo. El fragmento no viaja al
+ * servidor y el destino lo borra de la barra de direcciones apenas lo lee.
+ *
+ * Es lo mismo que hace `AppShell.navigateToModule` de `@bluestack-cms/ui` en la
+ * familia Vite; esta es la pieza equivalente para los gestores Next.
+ */
+/**
+ * ¿El destino es otro origen? Solo ahí hace falta el traspaso: dentro del mismo
+ * gestor el `sessionStorage` ya es el mismo.
+ *
+ * Las rutas relativas (`/users/1`), el `#` de los ítems sin destino y las URL
+ * absolutas al propio origen quedan afuera.
+ */
+export declare function isCrossOriginHref(href: string): boolean;
+
 declare interface ISectionsServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;
@@ -4767,6 +4794,28 @@ export declare type MultiSelectFieldConfig = BaseFieldConfig & {
 
 export declare type NavBlock = NavLinkItem;
 
+/**
+ * `onClick` para los ítems del menú que llevan a otro gestor: navega pasándole la
+ * sesión actual en el fragmento.
+ *
+ * No hace nada —y deja que el enlace navegue solo— cuando el destino es del mismo
+ * origen, cuando no hay token que pasar (login propio del gestor, sesión sin
+ * abrir) o cuando el usuario pidió abrir en otra pestaña (ctrl/cmd/click del
+ * medio): en ese último caso el navegador ya se encarga y no hay que interceptar.
+ *
+ * @param event Click del enlace.
+ * @param href Destino ya resuelto del ítem.
+ */
+export declare function navigateWithAuthHandoff(event: {
+    preventDefault: () => void;
+    defaultPrevented: boolean;
+    button?: number;
+    metaKey?: boolean;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}, href: string): void;
+
 export declare type NavigationModule = keyof CmsMessages['navigation'];
 
 export declare type NavItemPermissions = {