emilsoftware-utilities 2.0.0-dev.84 → 2.0.0-dev.85

package/dist/accessi-service/services/user-service/UserService.d.ts

@@ -0,0 +1,112 @@
+import type { AccessiOptions } from '../../AccessiModule';
+import { GetUsersResult } from '../../dtos/GetUsersResponse';
+import { RegisterRequest } from '../../dtos/RegisterRequest';
+import { StatoRegistrazione } from '../../dtos/StatoRegistrazione';
+import { UserDto } from '../../dtos/UserDto';
+import { AccessiAuthenticatedUserSnapshot } from '../../security/authenticatedToken';
+import { EmailService } from '../email-service/EmailService';
+import { FiltriService } from '../filtri-service/FiltriService';
+import { PermissionService } from '../permission-service/PermissionService';
+export declare class UserService {
+    private readonly accessiOptions;
+    private readonly emailService;
+    private readonly permissionService;
+    private readonly filtriService;
+    constructor(accessiOptions: AccessiOptions, emailService: EmailService, permissionService: PermissionService, filtriService: FiltriService);
+    private normalizeDatabaseBoolean;
+    /**
+     * Revoca best effort delle sessioni dopo un evento che deve invalidare i
+     * token gia emessi. Lo store e opzionale: se non configurato (o non
+     * raggiungibile) l'operazione principale non deve fallire.
+     */
+    private revokeSessionsBestEffort;
+    private normalizeUserFlags;
+    private normalizeEmail;
+    private ensureEmailIsAvailable;
+    /**
+     * Legge il minimo profilo autorevole usato da JWT e middleware. Restituisce `null` per utenti inesistenti.
+     * Non usare `UserDto` dal token per decisioni di sicurezza: i flag vengono sempre riletti qui.
+     */
+    getAuthenticatedUserSnapshot(codiceUtente: number): Promise<AccessiAuthenticatedUserSnapshot | null>;
+    /**
+     * True se l'utente indicato e' un admin attivo e nessun altro admin attivo
+     * esiste: rimuovergli il flag admin, bloccarlo o eliminarlo lascerebbe la
+     * console senza amministratori.
+     */
+    isLastActiveAdmin(codiceUtente: number): Promise<boolean>;
+    /** Impedisce di disattivare/eliminare l'ultimo admin attivo (lockout della console). */
+    assertNotLastActiveAdmin(codiceUtente: number): Promise<void>;
+    /**
+     * Elenca gli utenti con filtri opzionali. Grant e campi estesi sono costosi e vengono caricati soltanto
+     * quando richiesti esplicitamente nelle opzioni; usare filtri puntuali nei flussi di autenticazione.
+     */
+    getUsers(filters?: {
+        email?: string;
+        codiceUtente?: number | number[];
+        numRep?: number | number[];
+        codDipendente?: number;
+        cellulare?: string;
+        tipFil?: number;
+        flagSuper?: boolean;
+        limit?: number;
+        offset?: number;
+    }, options?: {
+        includeExtensionFields: boolean;
+        includeGrants: boolean;
+        scope?: string;
+    }): Promise<GetUsersResult[]>;
+    /** Conteggio utenti con gli stessi filtri di `getUsers`, per la paginazione (header X-Total-Count). */
+    countUsers(filters?: {
+        email?: string;
+        codiceUtente?: number;
+    }): Promise<number>;
+    private loadExtensionFieldsForUsers;
+    private chunkArray;
+    /** Cerca il codice interno per email normalizzata. Il chiamante deve gestire il caso senza righe. */
+    getCodiceUtenteByEmail(email: string): Promise<{
+        codiceUtente: number;
+    }>;
+    /** Recupera il profilo locale usato dal login, compresi filtri Accessi eventualmente presenti. */
+    getUserByEmail(email: string): Promise<UserDto | null>;
+    insertUserFilters(codiceUtente: number, filterData: RegisterRequest): Promise<void>;
+    /**
+     * Crea utente, configurazione e filtri. La registrazione pubblica resta in stato `INVIO` e non puo
+     * impostare privilegi, ruoli o grant; soltanto flussi backend fidati possono usare `allowPrivilegedFields`.
+     */
+    register(registrationData: RegisterRequest, options?: {
+        allowPrivilegedFields?: boolean;
+        initialState?: StatoRegistrazione;
+    }): Promise<number>;
+    /**
+     * Aggiorna il profilo utente e i filtri. Le modifiche a stato, ruoli, grant e flag amministrativi richiedono
+     * `allowPrivilegedChanges`; gli array ruolo/grant passati in un flusso fidato sostituiscono le assegnazioni.
+     */
+    updateUser(codiceUtente: number, user: UserDto, options?: {
+        allowPrivilegedChanges?: boolean;
+    }): Promise<void>;
+    updateUserFilters(codiceUtente: number, user: UserDto): Promise<void>;
+    /** Eliminazione logica: imposta lo stato `DELETE` senza cancellare lo storico o i collegamenti SSO. */
+    deleteUser(codiceCliente: number): Promise<void>;
+    /**
+     * Eliminazione definitiva: rimuove l'utente e tutti i record collegati in un'unica
+     * transazione. Operazione distruttiva riservata agli admin (il superutente usa il soft delete).
+     */
+    deleteUserPermanently(codiceUtente: number): Promise<void>;
+    /** Riconosce una violazione di chiave esterna Firebird (SQLCODE -530/-531 o messaggio) senza esporre SQL. */
+    private isForeignKeyViolation;
+    /** Cambia esplicitamente lo stato di registrazione; usare questa API per blocco, conferma o eliminazione logica. */
+    setStato(codiceCliente: number, statoRegistrazione: StatoRegistrazione): Promise<void>;
+    setGdpr(codiceUtente: number): Promise<string>;
+    /**
+     * Forza l'invio dell'email di reset password per un utente. Operazione amministrativa.
+     * Richiede un servizio email configurato: altrimenti solleva ACCESSI_EMAIL_NOT_CONFIGURED.
+     */
+    forcePasswordReset(codiceUtente: number): Promise<void>;
+    /**
+     * Forza l'invio dell'email di reset a tutti gli utenti la cui password non e ancora nel formato
+     * moderno (`scrypt$...`), cioe' legacy grezza o `scrypt-legacy` non piu verificabile. Utile quando
+     * la `encryptionKey` storica e perduta. Richiede email configurata. Ritorna quanti utenti hanno
+     * ricevuto l'email.
+     */
+    forcePasswordResetForLegacyPasswords(): Promise<number>;
+}