@pzeta/utils

Helpers

Funzioni di supporto per validazione manifest, costruzione menu, RBAC, gestione stili, routing e utilities pure.

Cosa contengono

Gli helpers in @pzeta/mfe-contracts/helpers (e /utils) sono funzioni pure usate principalmente dalla shell per:

  • validare manifest ricevuti da fonti non trusted
  • costruire menu di navigazione dai manifest dei MFE registrati
  • verificare permessi UI dell'utente (gate UI, non sicurezza)
  • generare documentazione dei componenti esposti dai MFE
  • gestire stili Tailwind condivisi e CSS custom con sanitizzazione
  • normalizzare path di routing tra modalità app e settings

Le utilities pure (extractErrorMessage, debounce) sono usate sia dalla shell sia dai MFE.

Pagine helper per area

PaginaCosa contiene
Manifest validationvalidateManifest, isValidManifest
Menu buildersbuildMenuFromManifest, buildSettingsMenuFromManifests
Component docsgroupComponentsByCategory, generateComponentDocs
PermissionscheckPermissions, checkRouteAccess, createCanDirective (direttiva v-can)
RoutingsortRoutes, stripShellPrefix, buildSettingsFullPath
StylesmergeTailwindConfig, sanitizeCss, injectCustomStyles, removeCustomStyles
UtilitiesextractErrorMessage, debounce

Import paths

// Tutti gli helpers
import {
  validateManifest,
  buildMenuFromManifest,
  checkPermissions,
  /* ... */
} from '@pzeta/mfe-contracts/helpers'

// Direttiva v-can
import { createCanDirective } from '@pzeta/mfe-contracts' // export root

// Utilities pure (subpath dedicato)
import { extractErrorMessage, debounce, stripShellPrefix } from '@pzeta/mfe-contracts/utils'

Sotto-pagine

Component docs

Helpers per documentazione runtime di MFEComponent. groupComponentsByCategory e generateComponentDocs.

Manifest validation

Funzioni validateManifest e isValidManifest per validare a runtime payload non trusted come MFEManifest.

Menu builders

buildMenuFromManifest e buildSettingsMenuFromManifests aggregano i manifest dei MFE in strutture pronte per il menu della shell.

Permissions

RBAC client-side per UI. checkPermissions, checkRouteAccess, direttiva v-can via createCanDirective.

Routing

sortRoutes (ordinamento), stripShellPrefix (normalizzazione path nel MFE), buildSettingsFullPath (path completo settings nella shell).

Styles

Merge config Tailwind cross-MFE, sanitizzazione CSS, iniezione/rimozione di stili custom nel DOM.

Utilities

Funzioni utility pure — extractErrorMessage (errori leggibili) e debounce (anti-chiamate eccessive).

mfeLoader (deprecato)

Istanza singleton legacy del MFELoader. Deprecato — preferire new MFELoader() per controllo del ciclo di vita.

Component docs

Helpers per documentazione runtime di MFEComponent. groupComponentsByCategory e generateComponentDocs.