emilsoftware-utilities 2.0.0-dev.4 → 2.0.0-dev.40

package/dist/accessi-module/Dtos/index.d.ts

@@ -1,16 +1,29 @@
 export * from "./Abilitazione";
+export * from "./AdminBootstrapDtos";
 export * from "./AbilitazioneMenu";
 export * from "./AssignPermissionsToUserRequest";
 export * from "./AssignRolesToUserRequest";
+export * from "./AuthenticatedUserPayloadDto";
 export * from "./BaseResponse";
+export * from "./CatalogDtos";
+export * from "./ConfirmResetPasswordRequest";
 export * from "./UpdateEnabledStatusRequest";
 export * from "./FiltriUtente";
+export * from "./FederatedIdentityDtos";
+export * from "./GetUserByTokenRequest";
+export * from "./GetUserByTokenResponse";
 export * from "./LoginRequest";
 export * from "./LoginResponse";
 export * from "./Permission";
+export * from "./PublicRegisterRequest";
 export * from "./Role";
+export * from "./SchemaDtos";
+export * from "./SendResetPasswordEmailRequest";
 export * from "./StatoRegistrazione";
 export * from "./TipoAbilitazione";
 export * from "./TokenResult";
 export * from "./UserDto";
+export * from "./UserGrantsResponse";
 export * from "./RuoliMenu";
+export * from "./ServiceToken";
+export * from './TwoFactorDtos';

package/dist/accessi-module/Dtos/index.js

@@ -15,19 +15,32 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Abilitazione"), exports);
+__exportStar(require("./AdminBootstrapDtos"), exports);
 __exportStar(require("./AbilitazioneMenu"), exports);
 __exportStar(require("./AssignPermissionsToUserRequest"), exports);
 __exportStar(require("./AssignRolesToUserRequest"), exports);
+__exportStar(require("./AuthenticatedUserPayloadDto"), exports);
 __exportStar(require("./BaseResponse"), exports);
+__exportStar(require("./CatalogDtos"), exports);
+__exportStar(require("./ConfirmResetPasswordRequest"), exports);
 __exportStar(require("./UpdateEnabledStatusRequest"), exports);
 __exportStar(require("./FiltriUtente"), exports);
+__exportStar(require("./FederatedIdentityDtos"), exports);
+__exportStar(require("./GetUserByTokenRequest"), exports);
+__exportStar(require("./GetUserByTokenResponse"), exports);
 __exportStar(require("./LoginRequest"), exports);
 __exportStar(require("./LoginResponse"), exports);
 __exportStar(require("./Permission"), exports);
+__exportStar(require("./PublicRegisterRequest"), exports);
 __exportStar(require("./Role"), exports);
+__exportStar(require("./SchemaDtos"), exports);
+__exportStar(require("./SendResetPasswordEmailRequest"), exports);
 __exportStar(require("./StatoRegistrazione"), exports);
 __exportStar(require("./TipoAbilitazione"), exports);
 __exportStar(require("./TokenResult"), exports);
 __exportStar(require("./UserDto"), exports);
+__exportStar(require("./UserGrantsResponse"), exports);
 __exportStar(require("./RuoliMenu"), exports);
+__exportStar(require("./ServiceToken"), exports);
+__exportStar(require("./TwoFactorDtos"), exports);
 //# sourceMappingURL=index.js.map

package/dist/accessi-module/Dtos/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/accessi-module/Dtos/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,qDAAmC;AACnC,mEAAiD;AACjD,6DAA2C;AAC3C,iDAA+B;AAC/B,+DAA4C;AAE5C,iDAA+B;AAC/B,iDAA+B;AAC/B,kDAAgC;AAChC,+CAA6B;AAC7B,yCAAuB;AACvB,uDAAqC;AACrC,qDAAmC;AACnC,gDAA8B;AAC9B,4CAA0B;AAE1B,8CAA2B","sourcesContent":["export * from \"./Abilitazione\";\r\nexport * from \"./AbilitazioneMenu\";\r\nexport * from \"./AssignPermissionsToUserRequest\";\r\nexport * from \"./AssignRolesToUserRequest\";\r\nexport * from \"./BaseResponse\";\r\nexport * from \"./UpdateEnabledStatusRequest\"\r\n\r\nexport * from \"./FiltriUtente\";\r\nexport * from \"./LoginRequest\";\r\nexport * from \"./LoginResponse\";\r\nexport * from \"./Permission\";\r\nexport * from \"./Role\";\r\nexport * from \"./StatoRegistrazione\";\r\nexport * from \"./TipoAbilitazione\";\r\nexport * from \"./TokenResult\";\r\nexport * from \"./UserDto\";\r\n\r\nexport * from \"./RuoliMenu\"\r\n\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/accessi-module/Dtos/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,uDAAqC;AACrC,qDAAmC;AACnC,mEAAiD;AACjD,6DAA2C;AAC3C,gEAA8C;AAC9C,iDAA+B;AAC/B,gDAA8B;AAC9B,gEAA8C;AAC9C,+DAA4C;AAE5C,iDAA+B;AAC/B,0DAAwC;AACxC,0DAAwC;AACxC,2DAAyC;AACzC,iDAA+B;AAC/B,kDAAgC;AAChC,+CAA6B;AAC7B,0DAAwC;AACxC,yCAAuB;AACvB,+CAA6B;AAC7B,kEAAgD;AAChD,uDAAqC;AACrC,qDAAmC;AACnC,gDAA8B;AAC9B,4CAA0B;AAC1B,uDAAqC;AAErC,8CAA2B;AAE3B,iDAA+B;AAE/B,kDAAgC","sourcesContent":["export * from \"./Abilitazione\";\nexport * from \"./AdminBootstrapDtos\";\nexport * from \"./AbilitazioneMenu\";\nexport * from \"./AssignPermissionsToUserRequest\";\nexport * from \"./AssignRolesToUserRequest\";\nexport * from \"./AuthenticatedUserPayloadDto\";\nexport * from \"./BaseResponse\";\nexport * from \"./CatalogDtos\";\nexport * from \"./ConfirmResetPasswordRequest\";\nexport * from \"./UpdateEnabledStatusRequest\"\n\nexport * from \"./FiltriUtente\";\nexport * from \"./FederatedIdentityDtos\";\nexport * from \"./GetUserByTokenRequest\";\nexport * from \"./GetUserByTokenResponse\";\nexport * from \"./LoginRequest\";\nexport * from \"./LoginResponse\";\nexport * from \"./Permission\";\nexport * from \"./PublicRegisterRequest\";\nexport * from \"./Role\";\nexport * from \"./SchemaDtos\";\nexport * from \"./SendResetPasswordEmailRequest\";\nexport * from \"./StatoRegistrazione\";\nexport * from \"./TipoAbilitazione\";\nexport * from \"./TokenResult\";\nexport * from \"./UserDto\";\nexport * from \"./UserGrantsResponse\";\n\nexport * from \"./RuoliMenu\"\n\nexport * from \"./ServiceToken\";\n\nexport * from './TwoFactorDtos';\n"]}

package/dist/accessi-module/Services/AdminBootstrapService/AdminBootstrapService.d.ts

@@ -0,0 +1,33 @@
+import type { AccessiOptions } from '../../AccessiModule';
+import { AuthService } from '../AuthService/AuthService';
+import { UserService } from '../UserService/UserService';
+export interface BootstrapAdminResult {
+    codiceUtente: number;
+    email: string;
+    /** Presente solo quando la password e stata generata dal server. */
+    password?: string;
+    passwordGenerated: boolean;
+}
+/**
+ * Crea il primo utente admin tramite il token casuale di avvio. Non invia email di conferma:
+ * l'utente nasce in stato CONF e con password impostata (fornita o generata). Il token e monouso
+ * e valido solo per il processo corrente.
+ */
+export declare class AdminBootstrapService {
+    private readonly options;
+    private readonly userService;
+    private readonly authService;
+    private readonly logger;
+    constructor(options: AccessiOptions, userService: UserService, authService: AuthService);
+    /** Indica se il backend ha abilitato l'area "crea utente admin". */
+    isEnabled(): boolean;
+    bootstrap(request: {
+        token?: string;
+        email?: string;
+        nome?: string;
+        cognome?: string;
+        password?: string;
+        superUser?: boolean;
+    }): Promise<BootstrapAdminResult>;
+    private generatePassword;
+}

package/dist/accessi-module/Services/AdminBootstrapService/AdminBootstrapService.js

@@ -0,0 +1,106 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var AdminBootstrapService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminBootstrapService = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const Logger_1 = require("../../../Logger");
+const StatoRegistrazione_1 = require("../../Dtos/StatoRegistrazione");
+const AuthService_1 = require("../AuthService/AuthService");
+const UserService_1 = require("../UserService/UserService");
+const adminBootstrap_1 = require("../../security/adminBootstrap");
+/**
+ * Crea il primo utente admin tramite il token casuale di avvio. Non invia email di conferma:
+ * l'utente nasce in stato CONF e con password impostata (fornita o generata). Il token e monouso
+ * e valido solo per il processo corrente.
+ */
+let AdminBootstrapService = AdminBootstrapService_1 = class AdminBootstrapService {
+    constructor(options, userService, authService) {
+        this.options = options;
+        this.userService = userService;
+        this.authService = authService;
+        this.logger = new Logger_1.Logger(AdminBootstrapService_1.name);
+    }
+    /** Indica se il backend ha abilitato l'area "crea utente admin". */
+    isEnabled() {
+        var _a;
+        return ((_a = this.options.adminBootstrap) === null || _a === void 0 ? void 0 : _a.enabled) === true;
+    }
+    bootstrap(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            if (!this.isEnabled()) {
+                throw new common_1.ForbiddenException({
+                    code: 'ACCESSI_ADMIN_BOOTSTRAP_DISABLED',
+                    message: 'Il bootstrap admin non e abilitato in questa istanza Accessi.',
+                });
+            }
+            if (!(0, adminBootstrap_1.isValidAdminBootstrapToken)(request === null || request === void 0 ? void 0 : request.token)) {
+                throw new common_1.UnauthorizedException({
+                    code: 'ACCESSI_ADMIN_BOOTSTRAP_TOKEN_INVALID',
+                    message: 'Token di bootstrap non valido.',
+                });
+            }
+            const email = typeof (request === null || request === void 0 ? void 0 : request.email) === 'string' ? request.email.trim().toLowerCase() : '';
+            if (!email) {
+                throw new common_1.BadRequestException({
+                    code: 'ACCESSI_ADMIN_BOOTSTRAP_EMAIL_REQUIRED',
+                    message: "L'email e obbligatoria per creare l'utente admin.",
+                });
+            }
+            const superUser = (_a = request === null || request === void 0 ? void 0 : request.superUser) !== null && _a !== void 0 ? _a : ((_b = this.options.adminBootstrap) === null || _b === void 0 ? void 0 : _b.superUser) !== false;
+            const providedPassword = typeof (request === null || request === void 0 ? void 0 : request.password) === 'string' ? request.password : '';
+            const password = providedPassword.length > 0 ? providedPassword : this.generatePassword();
+            const passwordGenerated = providedPassword.length === 0;
+            const codiceUtente = yield this.userService.register({
+                email,
+                nome: request === null || request === void 0 ? void 0 : request.nome,
+                cognome: request === null || request === void 0 ? void 0 : request.cognome,
+                flagAdmin: true,
+                flagSuper: superUser,
+            }, { allowPrivilegedFields: true, initialState: StatoRegistrazione_1.StatoRegistrazione.CONF });
+            yield this.authService.setPassword(codiceUtente, password);
+            // Monouso: un bootstrap riuscito invalida il token fino al prossimo riavvio.
+            (0, adminBootstrap_1.clearAdminBootstrapToken)();
+            this.logger.info(`Utente admin di bootstrap creato: ${email} (codice ${codiceUtente}). Token invalidato.`);
+            return {
+                codiceUtente,
+                email,
+                password: passwordGenerated ? password : undefined,
+                passwordGenerated,
+            };
+        });
+    }
+    generatePassword() {
+        return `Aa1!${(0, crypto_1.randomBytes)(9).toString('base64url')}`;
+    }
+};
+exports.AdminBootstrapService = AdminBootstrapService;
+exports.AdminBootstrapService = AdminBootstrapService = AdminBootstrapService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)('ACCESSI_OPTIONS')),
+    __metadata("design:paramtypes", [Object, UserService_1.UserService,
+        AuthService_1.AuthService])
+], AdminBootstrapService);
+//# sourceMappingURL=AdminBootstrapService.js.map

package/dist/accessi-module/Services/AdminBootstrapService/AdminBootstrapService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminBootstrapService.js","sourceRoot":"","sources":["../../../../src/accessi-module/Services/AdminBootstrapService/AdminBootstrapService.ts"],"names":[],"mappings":"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","sourcesContent":["import { BadRequestException, ForbiddenException, Inject, Injectable, UnauthorizedException } from '@nestjs/common';\nimport { randomBytes } from 'crypto';\nimport { Logger } from '../../../Logger';\nimport type { AccessiOptions } from '../../AccessiModule';\nimport { StatoRegistrazione } from '../../Dtos/StatoRegistrazione';\nimport { AuthService } from '../AuthService/AuthService';\nimport { UserService } from '../UserService/UserService';\nimport { clearAdminBootstrapToken, isValidAdminBootstrapToken } from '../../security/adminBootstrap';\n\nexport interface BootstrapAdminResult {\n  codiceUtente: number;\n  email: string;\n  /** Presente solo quando la password e stata generata dal server. */\n  password?: string;\n  passwordGenerated: boolean;\n}\n\n/**\n * Crea il primo utente admin tramite il token casuale di avvio. Non invia email di conferma:\n * l'utente nasce in stato CONF e con password impostata (fornita o generata). Il token e monouso\n * e valido solo per il processo corrente.\n */\n@Injectable()\nexport class AdminBootstrapService {\n  private readonly logger = new Logger(AdminBootstrapService.name);\n\n  constructor(\n    @Inject('ACCESSI_OPTIONS') private readonly options: AccessiOptions,\n    private readonly userService: UserService,\n    private readonly authService: AuthService,\n  ) {}\n\n  /** Indica se il backend ha abilitato l'area \"crea utente admin\". */\n  isEnabled(): boolean {\n    return this.options.adminBootstrap?.enabled === true;\n  }\n\n  async bootstrap(request: { token?: string; email?: string; nome?: string; cognome?: string; password?: string; superUser?: boolean }): Promise<BootstrapAdminResult> {\n    if (!this.isEnabled()) {\n      throw new ForbiddenException({\n        code: 'ACCESSI_ADMIN_BOOTSTRAP_DISABLED',\n        message: 'Il bootstrap admin non e abilitato in questa istanza Accessi.',\n      });\n    }\n\n    if (!isValidAdminBootstrapToken(request?.token)) {\n      throw new UnauthorizedException({\n        code: 'ACCESSI_ADMIN_BOOTSTRAP_TOKEN_INVALID',\n        message: 'Token di bootstrap non valido.',\n      });\n    }\n\n    const email = typeof request?.email === 'string' ? request.email.trim().toLowerCase() : '';\n    if (!email) {\n      throw new BadRequestException({\n        code: 'ACCESSI_ADMIN_BOOTSTRAP_EMAIL_REQUIRED',\n        message: \"L'email e obbligatoria per creare l'utente admin.\",\n      });\n    }\n\n    const superUser = request?.superUser ?? this.options.adminBootstrap?.superUser !== false;\n    const providedPassword = typeof request?.password === 'string' ? request.password : '';\n    const password = providedPassword.length > 0 ? providedPassword : this.generatePassword();\n    const passwordGenerated = providedPassword.length === 0;\n\n    const codiceUtente = await this.userService.register(\n      {\n        email,\n        nome: request?.nome,\n        cognome: request?.cognome,\n        flagAdmin: true,\n        flagSuper: superUser,\n      },\n      { allowPrivilegedFields: true, initialState: StatoRegistrazione.CONF },\n    );\n\n    await this.authService.setPassword(codiceUtente, password);\n\n    // Monouso: un bootstrap riuscito invalida il token fino al prossimo riavvio.\n    clearAdminBootstrapToken();\n    this.logger.info(`Utente admin di bootstrap creato: ${email} (codice ${codiceUtente}). Token invalidato.`);\n\n    return {\n      codiceUtente,\n      email,\n      password: passwordGenerated ? password : undefined,\n      passwordGenerated,\n    };\n  }\n\n  private generatePassword(): string {\n    return `Aa1!${randomBytes(9).toString('base64url')}`;\n  }\n}\n"]}

package/dist/accessi-module/Services/AuthService/AuthService.d.ts

@@ -1,24 +1,59 @@
-import { AccessiOptions } from "../../AccessiModule";
+import { TwoFactorService } from '../TwoFactorService/TwoFactorService';
+import type { AccessiOptions } from "../../AccessiModule";
 import { LoginRequest } from "../../Dtos/LoginRequest";
 import { LoginResult } from "../../Dtos/LoginResponse";
 import { UserService } from "../UserService/UserService";
-import { PermissionService } from "../PermissionService/PermissionService";
 import { FiltriService } from "../FiltriService/FiltriService";
+import { TokenResult } from '../../Dtos/TokenResult';
+/** Error code deliberately returned when a user is configured as SSO-only. */
+export declare const PASSWORD_LOGIN_DISABLED = "PASSWORD_LOGIN_DISABLED";
 export declare class AuthService {
     private userService;
-    private permissionService;
     private filtriService;
     private readonly accessiOptions;
+    private readonly twoFactorService;
     private readonly logger;
-    constructor(userService: UserService, permissionService: PermissionService, filtriService: FiltriService, accessiOptions: AccessiOptions);
+    constructor(userService: UserService, filtriService: FiltriService, accessiOptions: AccessiOptions, twoFactorService: TwoFactorService);
     private refreshPasswordExpiration;
     private isMockDemoUserEnabled;
+    /** Creates the normal internal JWT consumed by all existing Accessi guards. */
+    createAccessiToken(utente: LoginResult['utente'], methods?: string[]): TokenResult;
+    /** Builds the standard login response for a user authenticated by a supported method. */
+    getLoginResultForUser(codiceUtente: number): Promise<LoginResult>;
+    /** Users without a row retain the historic password-login enabled default. */
+    private isPasswordLoginEnabled;
+    /**
+     * Autentica con credenziali locali e restituisce profilo, filtri e grant effettivi.
+     * Non crea il JWT: il controller o il flusso SSO deve chiamare `createAccessiToken` sul risultato.
+     * Per utenti SSO-only genera `PASSWORD_LOGIN_DISABLED`, da trattare come istruzione a usare l'SSO.
+     */
     login(request: LoginRequest): Promise<LoginResult>;
+    /**
+     * Verifica un JWT Accessi e ricostruisce il profilo corrente dal database.
+     * Questo evita che privilegi, stato utente o flag amministrativi presenti in un token vecchio restino validi.
+     */
     getAuthenticatedTokenPayload(token: string): Promise<Record<string, unknown>>;
-    setPassword(codiceUtente: number, nuovaPassword: string): Promise<any>;
+    /** Starts a second-factor challenge after the hosting backend has verified an SSO identity. */
+    beginFederatedTwoFactor(codiceUtente: number, identityKey: string): Promise<LoginResult>;
+    private validateTwoFactorProof;
+    verifyTwoFactor(challengeId: string, code: string): Promise<LoginResult>;
+    resendTwoFactor(challengeId: string): Promise<LoginResult>;
+    /** Persiste una password hashata e aggiorna la scadenza, se la policy password e attiva. Non invia email. */
+    setPassword(codiceUtente: number, nuovaPassword: string): Promise<Record<string, unknown>[]>;
+    /**
+     * Converte le password legacy cifrate nel formato hash compatibile, senza conoscere le password in chiaro.
+     * E idempotente: hash moderni e gia migrati vengono ignorati.
+     */
     migrateLegacyEncryptedPasswords(): Promise<void>;
+    /** Verifica una password locale e migra automaticamente il formato legacy dopo una verifica positiva. */
     verifyPassword(codiceUtente: number, plainPassword: string): Promise<boolean>;
+    /** Restituisce l'utente fittizio amministratore; usabile solo con `mockDemoUser` esplicitamente abilitato. */
     getAdminUser(): Promise<LoginResult>;
+    /** Restituisce l'utente demo fittizio; non contiene dati o grant reali. */
     getDemoUser(): LoginResult;
+    /**
+     * Consuma un token monouso di reset, riporta l'utente allo stato confermato e salva la nuova password.
+     * Il nonce in `UTENTI.KEYREG` viene annullato prima di impostare la password, impedendo il riuso del token.
+     */
     confirmResetPassword(token: string, newPassword: string): Promise<void>;
 }