sass-cms-template-common 0.0.3 → 0.0.5

package/dist/index.d.ts

@@ -14,7 +14,7 @@ import { Theme } from '@mui/material/styles';
  */
 export declare const ACCOUNT_NAV_BLOCKS: NavBlock[];
 
-export declare function AppShell({ pathname, sites, children, notificationUnreadCount, notifications, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, LinkComponent, permissions, locale, language, messages, }: AppShellProps): JSX.Element;
+export declare function AppShell({ pathname, sites, children, notificationUnreadCount, notifications, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, LinkComponent, permissions, locale, language, messages, baseUrl, }: AppShellProps): JSX.Element;
 
 export declare type AppShellProps = {
     pathname: string;
@@ -25,7 +25,7 @@ export declare type AppShellProps = {
     profile: ProfileGetResponse;
     primaryLogo: ReactNode;
     brandLogo?: ReactNode;
-    selectedPublicationId?: string;
+    selectedPublicationId: string;
     getPublicationHref: (publication: Publication) => string;
     resolvePublicationImageUrl?: (imagePath: string) => string;
     profileAvatarOptions?: ProfileAvatarOptions;
@@ -35,6 +35,7 @@ export declare type AppShellProps = {
     /** Alias de `locale`. */
     language?: Locale | string;
     messages?: CmsMessagesOverride;
+    baseUrl: string;
 };
 
 /** Credenciales de sesión CMS usadas por los servicios HTTP. */
@@ -90,6 +91,13 @@ export declare type CmsMuiProviderProps = {
     children: ReactNode;
 };
 
+/** Envelope común de respuesta de los webservices de OpenCms. */
+export declare interface CmsResponse {
+    status: 'ok' | 'fail' | 'error';
+    errorCode?: string;
+    error?: string;
+}
+
 export declare type CmsTranslator = {
     messages: CmsMessages;
     navigation: (module: NavigationModule | string) => string;
@@ -101,6 +109,47 @@ export declare type CmsTranslator = {
     }) => string;
 };
 
+/** Usuario del CMS. Los campos presentes dependen del formato `fields`. */
+export declare interface CmsUser {
+    username?: string;
+    firstname?: string;
+    lastname?: string;
+    fullName?: string;
+    email?: string;
+    datecreated?: string;
+    status?: string;
+    [key: string]: unknown;
+}
+
+/**
+ * Servicios HTTP del módulo `users` del CMS.
+ *
+ * Se construye igual que `CmsCommonServices`, con `{ axiosApi, authentication }`.
+ */
+export declare class CmsUsersServices {
+    protected props: IUsersServices;
+    protected authentication: Authentication;
+    constructor(props: IUsersServices);
+    /** POST /users/get — lista paginada de usuarios con filtros. */
+    getUsers: (filters?: UsersGetFilters) => Promise<UsersGetResponse>;
+    /** POST /users/publication — usuarios asociados a la publicación. */
+    getPublicationUsers: (filters?: UsersPublicationFilters) => Promise<UsersPublicationResponse>;
+    /** POST /users/groups/get — grupos disponibles del sistema. */
+    getGroups: (ou?: string) => Promise<UserGroupsResponse>;
+    /** POST /users/pin/get — pins del usuario autenticado. */
+    getPins: () => Promise<UserPinsGetResponse>;
+    /** POST /users/pin/add — agrega un pin de recurso. */
+    addPin: (pin: string) => Promise<UserPinAddResponse>;
+    /** POST /users/pin/delete — elimina uno o más pins por ID. */
+    deletePins: (ids: number[]) => Promise<CmsResponse>;
+    /** POST /users/action/setStatus — activa o desactiva un usuario. */
+    setUserStatus: (username: string, action: UserStatusAction) => Promise<CmsResponse>;
+    /** POST /users/action/resetPass — restablece la contraseña de un usuario. */
+    resetPassword: (username: string) => Promise<CmsResponse>;
+    /** POST /users/action/resetMfa — resetea la configuración MFA de un usuario. */
+    resetMfa: (username: string, reason: string) => Promise<CmsResponse>;
+}
+
 /** POST /dashboard/countNotificatio */
 export declare interface CountNotificationsResponse {
     status: string;
@@ -153,7 +202,7 @@ export declare const enMessages: {
         readonly ANALYTICS: "Analytics";
         readonly TAGS: "Tags";
         readonly TRIVIAS: "Trivia";
-        readonly OTHER: "Other";
+        readonly OTHERS: "Other";
         readonly NEWSWIRES: "News Wires";
         readonly EVENTS: "Events";
         readonly PAGES: "Pages";
@@ -221,7 +270,7 @@ export declare const esMessages: {
         ANALYTICS: string;
         TAGS: string;
         TRIVIAS: string;
-        OTHER: string;
+        OTHERS: string;
         NEWSWIRES: string;
         EVENTS: string;
         PAGES: string;
@@ -299,6 +348,11 @@ export declare const ITEM_DEFAULT_BG = "#FFFFFF";
 
 export declare const ITEM_HOVER_BG = "#D8E2FF";
 
+declare interface IUsersServices {
+    axiosApi: AxiosInstance;
+    authentication: Authentication;
+}
+
 export declare const LIB_VERSION: "0.0.0";
 
 export declare type Locale = (typeof SUPPORTED_LOCALES)[number];
@@ -424,7 +478,7 @@ export declare const ptMessages: {
         ANALYTICS: string;
         TAGS: string;
         TRIVIAS: string;
-        OTHER: string;
+        OTHERS: string;
         NEWSWIRES: string;
         EVENTS: string;
         PAGES: string;
@@ -520,6 +574,12 @@ export declare interface PublicationPermissions {
     [key: string]: boolean;
 }
 
+/**
+ * Ámbito de publicación: `"pub"` (solo publicación), `"admin"` (solo admins
+ * globales) o cualquier otro valor (ambos).
+ */
+export declare type PublicationScope = 'pub' | 'admin' | (string & {});
+
 /** Cuerpo de la respuesta de POST /publications/get */
 export declare interface PublicationsGetResponse {
     status: string;
@@ -549,15 +609,17 @@ export declare function resolveCmsAssetUrl(path: string, cmsOrigin?: string): st
 
 export declare function resolveCmsOrigin(cmsOrigin?: string): string;
 
-export declare function Sidebar({ open, pathname, permissions, LinkComponent, }: SidebarProps): JSX.Element;
+export declare function Sidebar({ open, pathname, permissions, LinkComponent, baseUrl, selectedPublicationId, }: SidebarProps): JSX.Element;
 
 export declare type SidebarMessageKey = keyof CmsMessages['sidebar'];
 
 export declare type SidebarProps = {
-    open: boolean;
+    open?: boolean;
     pathname: string;
     LinkComponent?: CmsLinkComponent;
     permissions: Array<NavItemPermissions>;
+    baseUrl: string;
+    selectedPublicationId: string;
 };
 
 /** Entrada de sitio devuelta por POST /sites/get */
@@ -631,4 +693,110 @@ export declare type UseCmsTranslationOptions = {
     catalog?: LocaleCatalog;
 };
 
+/** Grupo del sistema devuelto por POST /users/groups/get. */
+export declare interface UserGroup {
+    id: string;
+    name: string;
+}
+
+/** Cuerpo de la respuesta de POST /users/groups/get. */
+export declare interface UserGroupsResponse extends CmsResponse {
+    groups: UserGroup[];
+}
+
+/** Pin (recurso fijado) de un usuario. */
+export declare interface UserPin {
+    id: number;
+    [key: string]: unknown;
+}
+
+/** Cuerpo de la respuesta de POST /users/pin/add. */
+export declare interface UserPinAddResponse extends CmsResponse {
+    /** ID del pin creado. */
+    id?: number;
+}
+
+/** Pin a eliminar en POST /users/pin/delete. */
+export declare interface UserPinDeleteInput {
+    id: number;
+}
+
+/** Cuerpo de la respuesta de POST /users/pin/get. */
+export declare interface UserPinsGetResponse extends CmsResponse {
+    pins: UserPin[];
+    total?: number;
+}
+
+/** Filtro sobre campos adicionales del usuario (`filters.advance`). */
+export declare interface UsersAdvanceFilter {
+    name: string;
+    value: string;
+}
+
+/** Formato de respuesta soportado por POST /users/get. */
+export declare type UsersFieldsFormat = 'all' | 'FullName' | 'detail' | '';
+
+/** Filtros de POST /users/get. */
+export declare interface UsersGetFilters {
+    /** Cantidad de resultados por página (default: 100). */
+    size?: number;
+    /** Número de página (default: 1). */
+    page?: number;
+    /** Fuerza búsqueda global (default: false). */
+    searchGlobal?: boolean;
+    /**
+     * Campo + dirección. Campos válidos: `username`, `firstname`, `lastname`,
+     * `email`, `datecreated`. Ej: `"datecreated desc"`.
+     */
+    order?: string;
+    /** Nombre del grupo para filtrar usuarios. */
+    grupo?: string;
+    /** Organizational Unit (default: "/"). */
+    ou?: string;
+    /** Estado del usuario. */
+    status?: UserStatus;
+    /** Timestamp en milisegundos (inicio del rango de fecha de creación). */
+    fromDate?: string;
+    /** Timestamp en milisegundos (fin del rango de fecha de creación). */
+    toDate?: string;
+    /** Filtra por ámbito de publicación. */
+    publicationScope?: PublicationScope;
+    /** Formato de respuesta. */
+    fields?: UsersFieldsFormat;
+    /** Búsqueda libre por email, username, apellido o nombre (LIKE). */
+    text?: string;
+    /** Filtros sobre campos adicionales del usuario. */
+    advance?: UsersAdvanceFilter[];
+}
+
+/** Cuerpo de la respuesta de POST /users/get. */
+export declare interface UsersGetResponse extends CmsResponse {
+    users: CmsUser[];
+    total?: number;
+    page?: number;
+    size?: number;
+}
+
+/** Formato de respuesta soportado por POST /users/publication. */
+export declare type UsersPublicationFieldsFormat = 'all' | 'summary' | 'FullName' | '';
+
+/** Filtros de POST /users/publication. */
+export declare interface UsersPublicationFilters {
+    /** Texto libre para búsqueda de usuario. */
+    text?: string;
+    /** Formato de respuesta. */
+    fields?: UsersPublicationFieldsFormat;
+}
+
+/** Cuerpo de la respuesta de POST /users/publication. */
+export declare interface UsersPublicationResponse extends CmsResponse {
+    users: CmsUser[];
+}
+
+/** Estado posible de un usuario del sistema. */
+export declare type UserStatus = 'active' | 'block' | 'pending';
+
+/** Acción soportada por POST /users/action/setStatus. */
+export declare type UserStatusAction = 'activate' | 'deactivate';
+
 export { }