emilsoftware-utilities 2.0.0-dev.5 → 2.0.0-dev.51

package/dist/index.js

@@ -41,7 +41,7 @@ const DatabaseUpdater_1 = require("./DatabaseUpdater");
 Object.defineProperty(exports, "DatabaseUpdater", { enumerable: true, get: function () { return DatabaseUpdater_1.DatabaseUpdater; } });
 const ExecutionTimeLogger_1 = require("./ExecutionTimeLogger");
 Object.defineProperty(exports, "ExecutionTimeLogger", { enumerable: true, get: function () { return ExecutionTimeLogger_1.ExecutionTimeLogger; } });
-const Firebird = __importStar(require("es-node-firebird"));
+const Firebird = __importStar(require("node-firebird"));
 exports.Firebird = Firebird;
 const Logger_1 = require("./Logger");
 Object.defineProperty(exports, "LogLevels", { enumerable: true, get: function () { return Logger_1.LogLevels; } });
@@ -69,7 +69,7 @@ __exportStar(require("./DatabaseUpdater"), exports);
 __exportStar(require("./firebird-compat"), exports);
 __exportStar(require("./accessi-module"), exports);
 __exportStar(require("./allegati-module"), exports);
-__exportStar(require("es-node-firebird"), exports);
+__exportStar(require("node-firebird"), exports);
 // Unified module exports
 __exportStar(require("./swagger/SwaggerConfig"), exports);
 __exportStar(require("./initEmilsoftwareModule"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uDAAoD;AAuB6D,gGAvBxG,iCAAe,OAuBwG;AAtBhI,+DAA2D;AAsBxC,oGAtBV,yCAAmB,OAsBU;AArBtC,2DAA6C;AAqBoH,4BAAQ;AApBzK,qCAA6C;AAoBG,0FApBvC,kBAAS,OAoBuC;AAAjB,uFApBpB,eAAM,OAoBoB;AAnB9C,+BAA4B;AAmB+B,oFAnBlD,SAAG,OAmBkD;AAlB9D,2CAA0F;AAkB1B,8FAlBvD,yBAAa,OAkBuD;AAAE,8FAlBvD,yBAAa,OAkBuD;AAAE,kGAlBvD,6BAAiB,OAkBuD;AAAmB,2FAlBxE,sBAAU,OAkBwE;AAjB5I,yCAAsC;AAiB7B,yFAjBA,mBAAQ,OAiBA;AAhBjB,2DAAwD;AAgBsF,kGAhBrI,qCAAiB,OAgBqI;AAf/J,6BAA2B;AAE3B,wCAAsB;AACtB,8CAA4B;AAC5B,2CAAyB;AACzB,6CAA2B;AAC3B,wDAAsC;AACtC,2DAAyC;AACzC,sDAAoC;AACpC,oDAAkC;AAClC,oDAAkC;AAElC,mDAAiC;AACjC,oDAAkC;AAClC,mDAAiC;AAEjC,yBAAyB;AACzB,0DAAwC;AACxC,2DAAyC","sourcesContent":["import { DatabaseUpdater } from \"./DatabaseUpdater\";\nimport { ExecutionTimeLogger } from \"./ExecutionTimeLogger\"\nimport * as Firebird from \"es-node-firebird\";\nimport { LogLevels, Logger } from \"./Logger\";\nimport { Orm } from \"./Orm\";\nimport { DateUtilities, RestUtilities, DatabaseUtilities, StatusCode } from \"./Utilities\";\nimport { autobind } from \"./autobind\";\nimport { DocumentGenerator } from \"./ContractGenerator\";\nimport \"./firebird-compat\";\n\r\nexport * from \"./Orm\";\r\nexport * from \"./Utilities\";\r\nexport * from \"./Logger\";\r\nexport * from \"./autobind\";\r\nexport * from \"./ExecutionTimeLogger\";\r\nexport * from \"./RoutesLoggerMiddleware\";\r\nexport * from \"./ContractGenerator\";\r\nexport * from \"./DatabaseUpdater\";\nexport * from \"./firebird-compat\";\n\nexport * from \"./accessi-module\";\nexport * from \"./allegati-module\";\nexport * from \"es-node-firebird\";\nexport { autobind, ExecutionTimeLogger, Logger, LogLevels, Orm, DateUtilities, RestUtilities, DatabaseUtilities, DatabaseUpdater, StatusCode, DocumentGenerator, Firebird };\n// Unified module exports\r\nexport * from \"./swagger/SwaggerConfig\";\r\nexport * from \"./initEmilsoftwareModule\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uDAAoD;AAuB6D,gGAvBxG,iCAAe,OAuBwG;AAtBhI,+DAA2D;AAsBxC,oGAtBV,yCAAmB,OAsBU;AArBtC,wDAA0C;AAqBuH,4BAAQ;AApBzK,qCAA6C;AAoBG,0FApBvC,kBAAS,OAoBuC;AAAjB,uFApBpB,eAAM,OAoBoB;AAnB9C,+BAA4B;AAmB+B,oFAnBlD,SAAG,OAmBkD;AAlB9D,2CAA0F;AAkB1B,8FAlBvD,yBAAa,OAkBuD;AAAE,8FAlBvD,yBAAa,OAkBuD;AAAE,kGAlBvD,6BAAiB,OAkBuD;AAAmB,2FAlBxE,sBAAU,OAkBwE;AAjB5I,yCAAsC;AAiB7B,yFAjBA,mBAAQ,OAiBA;AAhBjB,2DAAwD;AAgBsF,kGAhBrI,qCAAiB,OAgBqI;AAf/J,6BAA2B;AAE3B,wCAAsB;AACtB,8CAA4B;AAC5B,2CAAyB;AACzB,6CAA2B;AAC3B,wDAAsC;AACtC,2DAAyC;AACzC,sDAAoC;AACpC,oDAAkC;AAClC,oDAAkC;AAElC,mDAAiC;AACjC,oDAAkC;AAClC,gDAA8B;AAE9B,yBAAyB;AACzB,0DAAwC;AACxC,2DAAyC","sourcesContent":["import { DatabaseUpdater } from \"./DatabaseUpdater\";\nimport { ExecutionTimeLogger } from \"./ExecutionTimeLogger\"\nimport * as Firebird from \"node-firebird\";\nimport { LogLevels, Logger } from \"./Logger\";\nimport { Orm } from \"./Orm\";\nimport { DateUtilities, RestUtilities, DatabaseUtilities, StatusCode } from \"./Utilities\";\nimport { autobind } from \"./autobind\";\nimport { DocumentGenerator } from \"./ContractGenerator\";\nimport \"./firebird-compat\";\n\nexport * from \"./Orm\";\nexport * from \"./Utilities\";\nexport * from \"./Logger\";\nexport * from \"./autobind\";\nexport * from \"./ExecutionTimeLogger\";\nexport * from \"./RoutesLoggerMiddleware\";\nexport * from \"./ContractGenerator\";\nexport * from \"./DatabaseUpdater\";\nexport * from \"./firebird-compat\";\n\nexport * from \"./accessi-module\";\nexport * from \"./allegati-module\";\nexport * from \"node-firebird\";\nexport { autobind, ExecutionTimeLogger, Logger, LogLevels, Orm, DateUtilities, RestUtilities, DatabaseUtilities, DatabaseUpdater, StatusCode, DocumentGenerator, Firebird };\n// Unified module exports\nexport * from \"./swagger/SwaggerConfig\";\nexport * from \"./initEmilsoftwareModule\";\n"]}

package/dist/initEmilsoftwareModule.js

@@ -20,6 +20,10 @@ const SwaggerConfig_1 = require("./swagger/SwaggerConfig");
 const Logger_1 = require("./Logger");
 const EmilsoftwareModule_1 = require("./EmilsoftwareModule");
 const authenticateGen_1 = require("./accessi-module/middleware/authenticateGen");
+const accessiRuntime_1 = require("./accessi-module/accessiRuntime");
+const startupLog_1 = require("./accessi-module/startupLog");
+const accessiValidation_1 = require("./accessi-module/security/accessiValidation");
+const AccessiHttpExceptionFilter_1 = require("./accessi-module/security/AccessiHttpExceptionFilter");
 /**
  * Initializes the unified module that combines Accessi and Allegati functionality
  * @param app Express application instance
@@ -27,6 +31,7 @@ const authenticateGen_1 = require("./accessi-module/middleware/authenticateGen")
  */
 function initEmilsoftwareModule(app, options) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
         const logger = new Logger_1.Logger(initEmilsoftwareModule.name);
         if (options === null || options === void 0 ? void 0 : options.accessiOptions) {
             (0, authenticateGen_1.beginAccessiAuthInitialization)();
@@ -34,12 +39,22 @@ function initEmilsoftwareModule(app, options) {
         try {
             // Isolate Nest on a dedicated Express instance and dispatch only module routes.
             // This keeps pre-existing routes/middlewares on the host app untouched.
+            // Prefisso OpenAPI configurabile (default `accessi/openapi`), cosi' piu'
+            // documentazioni possono convivere (backend su `/openapi`, moduli sotto
+            // `/<modulo>/openapi`).
+            const swaggerPath = ((_b = (_a = options === null || options === void 0 ? void 0 : options.swagger) === null || _a === void 0 ? void 0 : _a.swaggerPath) !== null && _b !== void 0 ? _b : "accessi/openapi").replace(/^\/+|\/+$/g, "");
+            const swaggerJsonPath = ((_d = (_c = options === null || options === void 0 ? void 0 : options.swagger) === null || _c === void 0 ? void 0 : _c.swaggerJsonPath) !== null && _d !== void 0 ? _d : `${swaggerPath}.json`).replace(/^\/+/, "");
+            const legacySwaggerJsonPath = `${swaggerPath}-json`;
+            const swaggerRoutePaths = [
+                `/${swaggerPath}`,
+                `/${swaggerPath}/`,
+                `/${swaggerJsonPath}`,
+                `/${legacySwaggerJsonPath}`,
+            ];
             const nestHostApp = (0, express_1.default)();
             const isNestRoute = (path) => path === "/api" ||
                 path.startsWith("/api/") ||
-                path === "/swagger" ||
-                path.startsWith("/swagger/") ||
-                path === "/swagger-json";
+                swaggerRoutePaths.some((routePath) => path === routePath || path.startsWith(`${routePath.replace(/\/$/, "")}/`));
             app.use((req, res, next) => {
                 if (!isNestRoute(req.path)) {
                     return next();
@@ -51,16 +66,27 @@ function initEmilsoftwareModule(app, options) {
                 bufferLogs: true
             });
             nestApp.enableCors();
+            if (options === null || options === void 0 ? void 0 : options.accessiOptions) {
+                // Keep the Accessi API contract identical for standalone and unified bootstraps.
+                nestApp.useGlobalPipes((0, accessiValidation_1.createAccessiValidationPipe)());
+                nestApp.useGlobalFilters(new AccessiHttpExceptionFilter_1.AccessiHttpExceptionFilter());
+            }
             nestApp.setGlobalPrefix('api', {
-                exclude: ['/swagger', '/swagger/(.*)']
+                exclude: [`/${swaggerPath}`, `/${swaggerPath}/(.*)`]
+            });
+            // Documentazione OpenAPI del modulo unificato (Accessi + Allegati).
+            (0, SwaggerConfig_1.setupSwagger)(nestApp, {
+                swaggerPath,
+                swaggerJsonPath,
+                title: (_e = options === null || options === void 0 ? void 0 : options.swagger) === null || _e === void 0 ? void 0 : _e.title,
+                description: (_f = options === null || options === void 0 ? void 0 : options.swagger) === null || _f === void 0 ? void 0 : _f.description,
             });
-            // Setup unified Swagger documentation for all modules
-            (0, SwaggerConfig_1.setupSwagger)(nestApp);
             yield nestApp.init();
             if (options === null || options === void 0 ? void 0 : options.accessiOptions) {
-                const authService = nestApp.get(authenticateGen_1.AuthenticateGenService);
-                app.locals.accessiAuthService = authService;
-                (0, authenticateGen_1.setAccessiAuthService)(authService);
+                const accessiServices = (0, accessiRuntime_1.registerAccessiModuleServices)(app, nestApp);
+                app.locals.accessiAuthService = accessiServices.authenticateGenService;
+                (0, authenticateGen_1.setAccessiAuthService)(accessiServices.authenticateGenService);
+                (0, startupLog_1.logAccessiStartup)(options.accessiOptions);
             }
             logger.info("Emilsoftware module initialized successfully");
         }

package/dist/initEmilsoftwareModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"initEmilsoftwareModule.js","sourceRoot":"","sources":["../src/initEmilsoftwareModule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAkBA,wDAsDC;AAxED,sDAAwD;AACxD,uCAA2C;AAC3C,+DAA0D;AAC1D,2DAAuD;AACvD,qCAAkC;AAClC,6DAA+E;AAC/E,iFAKqD;AAErD;;;;GAIG;AACH,SAAsB,sBAAsB,CAAC,GAAgB,EAAE,OAA4B;;QACvF,MAAM,MAAM,GAAW,IAAI,eAAM,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,EAAE,CAAC;YAC1B,IAAA,gDAA8B,GAAE,CAAC;QACrC,CAAC;QAED,IAAI,CAAC;YACD,gFAAgF;YAChF,wEAAwE;YACxE,MAAM,WAAW,GAAG,IAAA,iBAAO,GAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CACjC,IAAI,KAAK,MAAM;gBACf,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBACxB,IAAI,KAAK,UAAU;gBACnB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;gBAC5B,IAAI,KAAK,eAAe,CAAC;YAE7B,GAAG,CAAC,GAAG,CAAC,CAAC,GAAY,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;gBAChC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,OAAO,IAAI,EAAE,CAAC;gBAClB,CAAC;gBACD,OAAO,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;YAEH,MAAM,mBAAmB,GAAG,IAAI,iCAAc,CAAC,WAAW,CAAC,CAAC;YAC5D,MAAM,OAAO,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,uCAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,mBAAmB,EAAE;gBAC/F,UAAU,EAAE,IAAI;aACnB,CAAC,CAAC;YAEH,OAAO,CAAC,UAAU,EAAE,CAAC;YAErB,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE;gBAC3B,OAAO,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC;aACzC,CAAC,CAAC;YAEH,sDAAsD;YACtD,IAAA,4BAAY,EAAC,OAAO,CAAC,CAAC;YAEtB,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,EAAE,CAAC;gBAC1B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,wCAAsB,CAAC,CAAC;gBACxD,GAAG,CAAC,MAAM,CAAC,kBAAkB,GAAG,WAAW,CAAC;gBAC5C,IAAA,uCAAqB,EAAC,WAAW,CAAC,CAAC;YACvC,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAEhE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,EAAE,CAAC;gBAC1B,IAAA,+CAA6B,EAAC,KAAK,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;YAC/D,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;CAAA","sourcesContent":["import express, { Application, Request } from \"express\";\r\nimport { NestFactory } from \"@nestjs/core\";\r\nimport { ExpressAdapter } from \"@nestjs/platform-express\";\r\nimport { setupSwagger } from \"./swagger/SwaggerConfig\";\r\nimport { Logger } from \"./Logger\";\r\nimport { EmilsoftwareModule, EmilsoftwareOptions } from \"./EmilsoftwareModule\";\r\nimport {\r\n    beginAccessiAuthInitialization,\r\n    failAccessiAuthInitialization,\r\n    AuthenticateGenService,\r\n    setAccessiAuthService\r\n} from \"./accessi-module/middleware/authenticateGen\";\r\n\r\n/**\r\n * Initializes the unified module that combines Accessi and Allegati functionality\r\n * @param app Express application instance\r\n * @param options Configuration options for both modules\r\n */\r\nexport async function initEmilsoftwareModule(app: Application, options: EmilsoftwareOptions) {\r\n    const logger: Logger = new Logger(initEmilsoftwareModule.name);\r\n    if (options?.accessiOptions) {\r\n        beginAccessiAuthInitialization();\r\n    }\r\n\r\n    try {\r\n        // Isolate Nest on a dedicated Express instance and dispatch only module routes.\r\n        // This keeps pre-existing routes/middlewares on the host app untouched.\r\n        const nestHostApp = express();\r\n        const isNestRoute = (path: string) =>\r\n            path === \"/api\" ||\r\n            path.startsWith(\"/api/\") ||\r\n            path === \"/swagger\" ||\r\n            path.startsWith(\"/swagger/\") ||\r\n            path === \"/swagger-json\";\r\n\r\n        app.use((req: Request, res, next) => {\r\n            if (!isNestRoute(req.path)) {\r\n                return next();\r\n            }\r\n            return nestHostApp(req, res, next);\r\n        });\r\n\r\n        const nestExpressInstance = new ExpressAdapter(nestHostApp);\r\n        const nestApp = await NestFactory.create(EmilsoftwareModule.forRoot(options), nestExpressInstance, {\r\n            bufferLogs: true\r\n        });\r\n\r\n        nestApp.enableCors();\r\n\r\n        nestApp.setGlobalPrefix('api', {\r\n            exclude: ['/swagger', '/swagger/(.*)']\r\n        });\r\n\r\n        // Setup unified Swagger documentation for all modules\r\n        setupSwagger(nestApp);\r\n\r\n        await nestApp.init();\r\n        if (options?.accessiOptions) {\r\n            const authService = nestApp.get(AuthenticateGenService);\r\n            app.locals.accessiAuthService = authService;\r\n            setAccessiAuthService(authService);\r\n        }\r\n\r\n        logger.info(\"Emilsoftware module initialized successfully\");\r\n\r\n    } catch (error) {\r\n        if (options?.accessiOptions) {\r\n            failAccessiAuthInitialization(error);\r\n        }\r\n        logger.error(\"Error initializing Emilsoftware Module:\", error);\r\n        throw error;\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"initEmilsoftwareModule.js","sourceRoot":"","sources":["../src/initEmilsoftwareModule.ts"],"names":[],"mappings":"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","sourcesContent":["import express, { Application, Request } from \"express\";\nimport { NestFactory } from \"@nestjs/core\";\nimport { ExpressAdapter } from \"@nestjs/platform-express\";\nimport { setupSwagger } from \"./swagger/SwaggerConfig\";\nimport { Logger } from \"./Logger\";\nimport { EmilsoftwareModule, EmilsoftwareOptions } from \"./EmilsoftwareModule\";\nimport {\n    beginAccessiAuthInitialization,\n    failAccessiAuthInitialization,\n    setAccessiAuthService\n} from \"./accessi-module/middleware/authenticateGen\";\nimport { registerAccessiModuleServices } from \"./accessi-module/accessiRuntime\";\nimport { logAccessiStartup } from \"./accessi-module/startupLog\";\nimport { createAccessiValidationPipe } from './accessi-module/security/accessiValidation';\nimport { AccessiHttpExceptionFilter } from './accessi-module/security/AccessiHttpExceptionFilter';\n\n/**\n * Initializes the unified module that combines Accessi and Allegati functionality\n * @param app Express application instance\n * @param options Configuration options for both modules\n */\nexport async function initEmilsoftwareModule(app: Application, options: EmilsoftwareOptions) {\n    const logger: Logger = new Logger(initEmilsoftwareModule.name);\n    if (options?.accessiOptions) {\n        beginAccessiAuthInitialization();\n    }\n\n    try {\n        // Isolate Nest on a dedicated Express instance and dispatch only module routes.\n        // This keeps pre-existing routes/middlewares on the host app untouched.\n        // Prefisso OpenAPI configurabile (default `accessi/openapi`), cosi' piu'\n        // documentazioni possono convivere (backend su `/openapi`, moduli sotto\n        // `/<modulo>/openapi`).\n        const swaggerPath = (options?.swagger?.swaggerPath ?? \"accessi/openapi\").replace(/^\\/+|\\/+$/g, \"\");\n        const swaggerJsonPath = (options?.swagger?.swaggerJsonPath ?? `${swaggerPath}.json`).replace(/^\\/+/, \"\");\n        const legacySwaggerJsonPath = `${swaggerPath}-json`;\n        const swaggerRoutePaths = [\n            `/${swaggerPath}`,\n            `/${swaggerPath}/`,\n            `/${swaggerJsonPath}`,\n            `/${legacySwaggerJsonPath}`,\n        ];\n\n        const nestHostApp = express();\n        const isNestRoute = (path: string) =>\n            path === \"/api\" ||\n            path.startsWith(\"/api/\") ||\n            swaggerRoutePaths.some(\n                (routePath) => path === routePath || path.startsWith(`${routePath.replace(/\\/$/, \"\")}/`)\n            );\n\n        app.use((req: Request, res, next) => {\n            if (!isNestRoute(req.path)) {\n                return next();\n            }\n            return nestHostApp(req, res, next);\n        });\n\n        const nestExpressInstance = new ExpressAdapter(nestHostApp);\n        const nestApp = await NestFactory.create(EmilsoftwareModule.forRoot(options), nestExpressInstance, {\n            bufferLogs: true\n        });\n\n        nestApp.enableCors();\n        if (options?.accessiOptions) {\n            // Keep the Accessi API contract identical for standalone and unified bootstraps.\n            nestApp.useGlobalPipes(createAccessiValidationPipe());\n            nestApp.useGlobalFilters(new AccessiHttpExceptionFilter());\n        }\n\n        nestApp.setGlobalPrefix('api', {\n            exclude: [`/${swaggerPath}`, `/${swaggerPath}/(.*)`]\n        });\n\n        // Documentazione OpenAPI del modulo unificato (Accessi + Allegati).\n        setupSwagger(nestApp, {\n            swaggerPath,\n            swaggerJsonPath,\n            title: options?.swagger?.title,\n            description: options?.swagger?.description,\n        });\n\n        await nestApp.init();\n        if (options?.accessiOptions) {\n            const accessiServices = registerAccessiModuleServices(app, nestApp);\n            app.locals.accessiAuthService = accessiServices.authenticateGenService;\n            setAccessiAuthService(accessiServices.authenticateGenService);\n            logAccessiStartup(options.accessiOptions);\n        }\n\n        logger.info(\"Emilsoftware module initialized successfully\");\n\n    } catch (error) {\n        if (options?.accessiOptions) {\n            failAccessiAuthInitialization(error);\n        }\n        logger.error(\"Error initializing Emilsoftware Module:\", error);\n        throw error;\n    }\n}\n"]}

package/dist/scripts/generateAccessiOpenApi.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/generateAccessiOpenApi.js

@@ -0,0 +1,57 @@
+"use strict";
+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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const swagger_1 = require("@nestjs/swagger");
+const core_1 = require("@nestjs/core");
+const platform_express_1 = require("@nestjs/platform-express");
+const express_1 = __importDefault(require("express"));
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const AccessiModule_1 = require("../accessi-module/AccessiModule");
+/**
+ * Esporta il contratto OpenAPI dai decorator Nest senza avviare il database.
+ * Il file risultante e l'unica sorgente per il client Orval della console.
+ */
+function generateAccessiOpenApi() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const options = {
+            databaseOptions: { host: 'openapi-generation', database: 'not-used', user: 'not-used' },
+            confirmationEmailUrl: 'https://invalid.local',
+            confirmationEmailReturnUrl: 'https://invalid.local',
+            encryptionKey: 'openapi-generation-only',
+            mockDemoUser: false,
+            autoUpdateDatabase: false,
+            legacyPasswordMigrationOnStartup: false,
+            jwtOptions: { secret: 'openapi-generation-only', expiresIn: '1h' },
+            emailOptions: {
+                host: 'localhost', port: 25, secure: false, requireTLS: false,
+                tls: { rejectUnauthorized: true }, from: 'openapi@invalid.local', auth: { user: '', pass: '' },
+            },
+            federatedAuthentication: { enabled: false },
+        };
+        const app = yield core_1.NestFactory.create(AccessiModule_1.AccessiModule.forRoot(options), new platform_express_1.ExpressAdapter((0, express_1.default)()), { logger: false });
+        app.setGlobalPrefix('api');
+        // Decorator inspection requires no lifecycle hooks or database connection.
+        const document = swagger_1.SwaggerModule.createDocument(app, new swagger_1.DocumentBuilder().setTitle('Accessi API').setVersion('1.0').addBearerAuth().build());
+        const outputDirectory = (0, path_1.join)(process.cwd(), 'src', 'accessi-module', 'openapi');
+        yield (0, promises_1.mkdir)(outputDirectory, { recursive: true });
+        yield (0, promises_1.writeFile)((0, path_1.join)(outputDirectory, 'accessi.openapi.json'), `${JSON.stringify(document, null, 2)}\n`);
+        yield app.close();
+    });
+}
+generateAccessiOpenApi().catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=generateAccessiOpenApi.js.map

package/dist/scripts/generateAccessiOpenApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateAccessiOpenApi.js","sourceRoot":"","sources":["../../src/scripts/generateAccessiOpenApi.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,6CAAiE;AACjE,uCAA2C;AAC3C,+DAA0D;AAC1D,sDAA8B;AAC9B,0CAA+C;AAC/C,+BAA4B;AAC5B,mEAAgF;AAEhF;;;GAGG;AACH,SAAe,sBAAsB;;QACnC,MAAM,OAAO,GAAmB;YAC9B,eAAe,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;YACvF,oBAAoB,EAAE,uBAAuB;YAC7C,0BAA0B,EAAE,uBAAuB;YACnD,aAAa,EAAE,yBAAyB;YACxC,YAAY,EAAE,KAAK;YACnB,kBAAkB,EAAE,KAAK;YACzB,gCAAgC,EAAE,KAAK;YACvC,UAAU,EAAE,EAAE,MAAM,EAAE,yBAAyB,EAAE,SAAS,EAAE,IAAI,EAAE;YAClE,YAAY,EAAE;gBACZ,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK;gBAC7D,GAAG,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;aAC/F;YACD,uBAAuB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;SAC5C,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAClC,6BAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAC9B,IAAI,iCAAc,CAAC,IAAA,iBAAO,GAAE,CAAC,EAC7B,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;QACF,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC3B,2EAA2E;QAE3E,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAC3C,GAAG,EACH,IAAI,yBAAe,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,CACxF,CAAC;QACF,MAAM,eAAe,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC;QAChF,MAAM,IAAA,gBAAK,EAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,IAAA,oBAAS,EAAC,IAAA,WAAI,EAAC,eAAe,EAAE,sBAAsB,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACzG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CAAA;AAED,sBAAsB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACvC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC","sourcesContent":["import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';\nimport { NestFactory } from '@nestjs/core';\nimport { ExpressAdapter } from '@nestjs/platform-express';\nimport express from 'express';\nimport { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { AccessiModule, AccessiOptions } from '../accessi-module/AccessiModule';\n\n/**\n * Esporta il contratto OpenAPI dai decorator Nest senza avviare il database.\n * Il file risultante e l'unica sorgente per il client Orval della console.\n */\nasync function generateAccessiOpenApi(): Promise<void> {\n  const options: AccessiOptions = {\n    databaseOptions: { host: 'openapi-generation', database: 'not-used', user: 'not-used' },\n    confirmationEmailUrl: 'https://invalid.local',\n    confirmationEmailReturnUrl: 'https://invalid.local',\n    encryptionKey: 'openapi-generation-only',\n    mockDemoUser: false,\n    autoUpdateDatabase: false,\n    legacyPasswordMigrationOnStartup: false,\n    jwtOptions: { secret: 'openapi-generation-only', expiresIn: '1h' },\n    emailOptions: {\n      host: 'localhost', port: 25, secure: false, requireTLS: false,\n      tls: { rejectUnauthorized: true }, from: 'openapi@invalid.local', auth: { user: '', pass: '' },\n    },\n    federatedAuthentication: { enabled: false },\n  };\n\n  const app = await NestFactory.create(\n    AccessiModule.forRoot(options),\n    new ExpressAdapter(express()),\n    { logger: false },\n  );\n  app.setGlobalPrefix('api');\n  // Decorator inspection requires no lifecycle hooks or database connection.\n\n  const document = SwaggerModule.createDocument(\n    app,\n    new DocumentBuilder().setTitle('Accessi API').setVersion('1.0').addBearerAuth().build(),\n  );\n  const outputDirectory = join(process.cwd(), 'src', 'accessi-module', 'openapi');\n  await mkdir(outputDirectory, { recursive: true });\n  await writeFile(join(outputDirectory, 'accessi.openapi.json'), `${JSON.stringify(document, null, 2)}\\n`);\n  await app.close();\n}\n\ngenerateAccessiOpenApi().catch((error) => {\n  console.error(error);\n  process.exitCode = 1;\n});\n"]}

package/dist/scripts/generateAccessiWiki.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/generateAccessiWiki.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Genera la Wiki in Markdown per GitHub a partire dalla stessa fonte usata
+ * dalla console: `src/accessi-module/Console/wiki.ts`.
+ *
+ * Output:
+ * - WIKI.md      documentazione completa con indice
+ * - WIKI.ai.md   digest compatto pensato per l'IA
+ *
+ * La wiki della console e questi file non possono divergere: entrambi derivano
+ * dagli stessi dati. Non modificare WIKI.md a mano, esegui `npm run generate:accessi-wiki`.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const wiki_1 = require("../accessi-module/Console/wiki");
+const REPO_ROOT = (0, node_path_1.join)(__dirname, '..', '..');
+/** Riproduce la slug dei titoli usata da GitHub per generare gli anchor. */
+function githubSlug(title) {
+    return title
+        .toLowerCase()
+        .trim()
+        .replace(/[^\p{L}\p{N}\s_-]/gu, '')
+        .replace(/\s+/g, '-');
+}
+/**
+ * Escapa i caratteri che Markdown interpreterebbe come formattazione.
+ * Serve per token come `/api/accessi/*`, `ACCESSI_*` o `<jwt>`: senza escaping
+ * gli asterischi diventano corsivo e `<...>` viene scambiato per un tag HTML.
+ */
+function escapeMd(text) {
+    return text.replace(/([\\`*_{}[\]<>#])/g, '\\$1');
+}
+const ALERT = {
+    info: 'NOTE',
+    ok: 'TIP',
+    warn: 'WARNING',
+    danger: 'CAUTION',
+};
+function renderCode(block) {
+    const label = block.variant === 'good'
+        ? `**Esempio corretto${block.title ? ` — ${block.title}` : ''}**`
+        : block.variant === 'bad'
+            ? `**Esempio da evitare${block.title ? ` — ${block.title}` : ''}**`
+            : block.title
+                ? `**${block.title}**`
+                : '';
+    const fence = '```' + block.language;
+    return [...(label ? [label, ''] : []), fence, block.code, '```'].join('\n');
+}
+function renderBlock(block) {
+    switch (block.kind) {
+        case 'p':
+            return escapeMd(block.text);
+        case 'h':
+            return `### ${escapeMd(block.text)}`;
+        case 'list':
+            return block.items
+                .map((item, index) => `${block.ordered ? `${index + 1}.` : '-'} ${escapeMd(item)}`)
+                .join('\n');
+        case 'code':
+            return renderCode(block);
+        case 'callout':
+            return [
+                `> [!${ALERT[block.tone]}]`,
+                ...(block.title ? [`> **${escapeMd(block.title)}**`] : []),
+                `> ${escapeMd(block.text)}`,
+            ].join('\n');
+        case 'table': {
+            const head = `| ${block.head.map(escapeMd).join(' | ')} |`;
+            const separator = `| ${block.head.map(() => '---').join(' | ')} |`;
+            const rows = block.rows.map((row) => `| ${row.map((cell) => escapeMd(cell).replace(/\|/g, '\\|')).join(' | ')} |`);
+            return [head, separator, ...rows].join('\n');
+        }
+        default:
+            return '';
+    }
+}
+function buildMarkdown() {
+    const groups = (0, wiki_1.wikiGroups)();
+    const toc = groups
+        .map(({ group, sections }) => [
+        `**${group}**`,
+        '',
+        ...sections.map((section) => `- [${escapeMd(section.title)}](#${githubSlug(section.title)})`),
+        '',
+    ].join('\n'))
+        .join('\n');
+    const body = wiki_1.WIKI_SECTIONS
+        .map((section) => [
+        `## ${escapeMd(section.title)}`,
+        '',
+        `_${escapeMd(section.summary)}_`,
+        '',
+        section.blocks.map(renderBlock).join('\n\n'),
+        '',
+    ].join('\n'))
+        .join('\n---\n\n');
+    return [
+        '# Wiki del modulo Accessi',
+        '',
+        '> Documento generato automaticamente da `src/accessi-module/Console/wiki.ts` (la stessa fonte della Wiki nella console).',
+        '> Non modificarlo a mano: esegui `npm run generate:accessi-wiki`.',
+        '',
+        'La stessa documentazione è disponibile, resa in modo interattivo, nella console Accessi su `/api/accessi/console/wiki`.',
+        'Per una versione compatta da fornire a un\'IA che costruisce il backend integratore, vedi [`WIKI.ai.md`](WIKI.ai.md).',
+        '',
+        '## Indice',
+        '',
+        toc,
+        '---',
+        '',
+        body,
+    ].join('\n').replace(/\n{3,}/g, '\n\n');
+}
+const aiHeader = [
+    '<!-- Documento generato automaticamente da src/accessi-module/Console/wiki.ts. Non modificare a mano: npm run generate:accessi-wiki. -->',
+    '',
+    '# Guida compatta per l\'IA',
+    '',
+    'Versione sintetica della wiki, pensata per essere incollata a un\'IA che costruisce il backend integratore.',
+    'Disponibile anche nella console con il pulsante "Copia per AI" (`/api/accessi/console/wiki`).',
+    '',
+    'Il contenuto è racchiuso in un blocco di codice per essere copiato verbatim, senza interpretazione Markdown.',
+    '',
+].join('\n');
+// Fence a quattro backtick: il digest contiene fence a tre backtick che restano letterali.
+(0, node_fs_1.writeFileSync)((0, node_path_1.join)(REPO_ROOT, 'WIKI.md'), buildMarkdown(), 'utf8');
+(0, node_fs_1.writeFileSync)((0, node_path_1.join)(REPO_ROOT, 'WIKI.ai.md'), `${aiHeader}\n\`\`\`\`text\n${(0, wiki_1.buildAiDigest)()}\n\`\`\`\`\n`, 'utf8');
+process.stdout.write('Wiki generata: WIKI.md e WIKI.ai.md\n');
+//# sourceMappingURL=generateAccessiWiki.js.map

package/dist/scripts/generateAccessiWiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateAccessiWiki.js","sourceRoot":"","sources":["../../src/scripts/generateAccessiWiki.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Genera la Wiki in Markdown per GitHub a partire dalla stessa fonte usata\n * dalla console: `src/accessi-module/Console/wiki.ts`.\n *\n * Output:\n * - WIKI.md      documentazione completa con indice\n * - WIKI.ai.md   digest compatto pensato per l'IA\n *\n * La wiki della console e questi file non possono divergere: entrambi derivano\n * dagli stessi dati. Non modificare WIKI.md a mano, esegui `npm run generate:accessi-wiki`.\n */\nimport { writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { WIKI_SECTIONS, wikiGroups, buildAiDigest } from '../accessi-module/Console/wiki';\nimport type { WikiBlock, WikiTone } from '../accessi-module/Console/wiki';\n\nconst REPO_ROOT = join(__dirname, '..', '..');\n\n/** Riproduce la slug dei titoli usata da GitHub per generare gli anchor. */\nfunction githubSlug(title: string): string {\n  return title\n    .toLowerCase()\n    .trim()\n    .replace(/[^\\p{L}\\p{N}\\s_-]/gu, '')\n    .replace(/\\s+/g, '-');\n}\n\n/**\n * Escapa i caratteri che Markdown interpreterebbe come formattazione.\n * Serve per token come `/api/accessi/*`, `ACCESSI_*` o `<jwt>`: senza escaping\n * gli asterischi diventano corsivo e `<...>` viene scambiato per un tag HTML.\n */\nfunction escapeMd(text: string): string {\n  return text.replace(/([\\\\`*_{}[\\]<>#])/g, '\\\\$1');\n}\n\nconst ALERT: Record<WikiTone, string> = {\n  info: 'NOTE',\n  ok: 'TIP',\n  warn: 'WARNING',\n  danger: 'CAUTION',\n};\n\nfunction renderCode(block: Extract<WikiBlock, { kind: 'code' }>): string {\n  const label = block.variant === 'good'\n    ? `**Esempio corretto${block.title ? ` — ${block.title}` : ''}**`\n    : block.variant === 'bad'\n      ? `**Esempio da evitare${block.title ? ` — ${block.title}` : ''}**`\n      : block.title\n        ? `**${block.title}**`\n        : '';\n  const fence = '```' + block.language;\n  return [...(label ? [label, ''] : []), fence, block.code, '```'].join('\\n');\n}\n\nfunction renderBlock(block: WikiBlock): string {\n  switch (block.kind) {\n    case 'p':\n      return escapeMd(block.text);\n    case 'h':\n      return `### ${escapeMd(block.text)}`;\n    case 'list':\n      return block.items\n        .map((item, index) => `${block.ordered ? `${index + 1}.` : '-'} ${escapeMd(item)}`)\n        .join('\\n');\n    case 'code':\n      return renderCode(block);\n    case 'callout':\n      return [\n        `> [!${ALERT[block.tone]}]`,\n        ...(block.title ? [`> **${escapeMd(block.title)}**`] : []),\n        `> ${escapeMd(block.text)}`,\n      ].join('\\n');\n    case 'table': {\n      const head = `| ${block.head.map(escapeMd).join(' | ')} |`;\n      const separator = `| ${block.head.map(() => '---').join(' | ')} |`;\n      const rows = block.rows.map((row) => `| ${row.map((cell) => escapeMd(cell).replace(/\\|/g, '\\\\|')).join(' | ')} |`);\n      return [head, separator, ...rows].join('\\n');\n    }\n    default:\n      return '';\n  }\n}\n\nfunction buildMarkdown(): string {\n  const groups = wikiGroups();\n  const toc = groups\n    .map(({ group, sections }) => [\n      `**${group}**`,\n      '',\n      ...sections.map((section) => `- [${escapeMd(section.title)}](#${githubSlug(section.title)})`),\n      '',\n    ].join('\\n'))\n    .join('\\n');\n\n  const body = WIKI_SECTIONS\n    .map((section) => [\n      `## ${escapeMd(section.title)}`,\n      '',\n      `_${escapeMd(section.summary)}_`,\n      '',\n      section.blocks.map(renderBlock).join('\\n\\n'),\n      '',\n    ].join('\\n'))\n    .join('\\n---\\n\\n');\n\n  return [\n    '# Wiki del modulo Accessi',\n    '',\n    '> Documento generato automaticamente da `src/accessi-module/Console/wiki.ts` (la stessa fonte della Wiki nella console).',\n    '> Non modificarlo a mano: esegui `npm run generate:accessi-wiki`.',\n    '',\n    'La stessa documentazione è disponibile, resa in modo interattivo, nella console Accessi su `/api/accessi/console/wiki`.',\n    'Per una versione compatta da fornire a un\\'IA che costruisce il backend integratore, vedi [`WIKI.ai.md`](WIKI.ai.md).',\n    '',\n    '## Indice',\n    '',\n    toc,\n    '---',\n    '',\n    body,\n  ].join('\\n').replace(/\\n{3,}/g, '\\n\\n');\n}\n\nconst aiHeader = [\n  '<!-- Documento generato automaticamente da src/accessi-module/Console/wiki.ts. Non modificare a mano: npm run generate:accessi-wiki. -->',\n  '',\n  '# Guida compatta per l\\'IA',\n  '',\n  'Versione sintetica della wiki, pensata per essere incollata a un\\'IA che costruisce il backend integratore.',\n  'Disponibile anche nella console con il pulsante \"Copia per AI\" (`/api/accessi/console/wiki`).',\n  '',\n  'Il contenuto è racchiuso in un blocco di codice per essere copiato verbatim, senza interpretazione Markdown.',\n  '',\n].join('\\n');\n\n// Fence a quattro backtick: il digest contiene fence a tre backtick che restano letterali.\nwriteFileSync(join(REPO_ROOT, 'WIKI.md'), buildMarkdown(), 'utf8');\nwriteFileSync(join(REPO_ROOT, 'WIKI.ai.md'), `${aiHeader}\\n\\`\\`\\`\\`text\\n${buildAiDigest()}\\n\\`\\`\\`\\`\\n`, 'utf8');\nprocess.stdout.write('Wiki generata: WIKI.md e WIKI.ai.md\\n');\n"]}

package/dist/swagger/SwaggerConfig.d.ts

@@ -1,2 +1,8 @@
 import { INestApplication } from "@nestjs/common";
-export declare function setupSwagger(app: INestApplication): void;
+export type SwaggerSetupOptions = {
+    swaggerPath?: string;
+    swaggerJsonPath?: string;
+    title?: string;
+    description?: string;
+};
+export declare function setupSwagger(app: INestApplication, options?: SwaggerSetupOptions): void;

package/dist/swagger/SwaggerConfig.js

@@ -3,24 +3,39 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupSwagger = setupSwagger;
 const swagger_1 = require("@nestjs/swagger");
 const Logger_1 = require("../Logger");
-function setupSwagger(app) {
-    var _a, _b;
+function setupSwagger(app, options) {
+    var _a, _b, _c, _d, _e, _f;
     const logger = new Logger_1.Logger("SwaggerConfig");
-    const swaggerPath = "swagger";
-    const swaggerJsonPath = `${swaggerPath}-json`;
+    // Naming industriale OpenAPI: `/openapi` (UI) e `/openapi.json` (spec).
+    // Il path e' configurabile per consentire piu' documentazioni sotto prefissi
+    // dedicati (es. `accessi/openapi`).
+    const swaggerPath = ((_a = options === null || options === void 0 ? void 0 : options.swaggerPath) !== null && _a !== void 0 ? _a : "openapi").replace(/^\/+|\/+$/g, "");
+    const swaggerJsonPath = ((_b = options === null || options === void 0 ? void 0 : options.swaggerJsonPath) !== null && _b !== void 0 ? _b : `${swaggerPath}.json`).replace(/^\/+/, "");
+    // Manteniamo l'alias storico `<path>-json` per non rompere i consumer esistenti.
+    const legacySwaggerJsonPath = `${swaggerPath}-json`;
     const config = new swagger_1.DocumentBuilder()
-        .setTitle("API Documentation")
-        .setDescription("API per la gestione di accessi utenti e allegati")
+        .setTitle((_c = options === null || options === void 0 ? void 0 : options.title) !== null && _c !== void 0 ? _c : "API Documentation")
+        .setDescription((_d = options === null || options === void 0 ? void 0 : options.description) !== null && _d !== void 0 ? _d : "API per la gestione di accessi utenti e allegati")
         .setVersion("1.0")
         .addBearerAuth() // Per abilitare l'autenticazione JWT
         .build();
     const document = swagger_1.SwaggerModule.createDocument(app, config);
     swagger_1.SwaggerModule.setup(swaggerPath, app, document);
-    app.use(`/${swaggerJsonPath}`, (_, res) => {
+    app.use(`/${swaggerJsonPath}`, (_req, res) => {
         res.setHeader("Content-Type", "application/json");
         res.send(document);
     });
-    let port = ((_b = (_a = app.getHttpServer()) === null || _a === void 0 ? void 0 : _a.address) === null || _b === void 0 ? void 0 : _b.port) || 3000;
+    if (legacySwaggerJsonPath !== swaggerJsonPath) {
+        app.use(`/${legacySwaggerJsonPath}`, (_req, res) => {
+            res.setHeader("Content-Type", "application/json");
+            res.send(document);
+        });
+    }
+    const serverAddress = (_f = (_e = app.getHttpServer()) === null || _e === void 0 ? void 0 : _e.address) === null || _f === void 0 ? void 0 : _f.call(_e);
+    const port = serverAddress && typeof serverAddress === "object"
+        ? serverAddress.port
+        : 3000;
     logger.info(`Swagger documentation available at: http://localhost:${port}/${swaggerPath}`);
+    logger.info(`Swagger OpenAPI JSON available at: http://localhost:${port}/${swaggerJsonPath}`);
 }
 //# sourceMappingURL=SwaggerConfig.js.map

package/dist/swagger/SwaggerConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"SwaggerConfig.js","sourceRoot":"","sources":["../../src/swagger/SwaggerConfig.ts"],"names":[],"mappings":";;AAIA,oCAyBC;AA5BD,6CAAiE;AACjE,sCAAmC;AAEnC,SAAgB,YAAY,CAAC,GAAqB;;IAC9C,MAAM,MAAM,GAAW,IAAI,eAAM,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,SAAS,CAAC;IAC9B,MAAM,eAAe,GAAG,GAAG,WAAW,OAAO,CAAC;IAE9C,MAAM,MAAM,GAAG,IAAI,yBAAe,EAAE;SAC/B,QAAQ,CAAC,mBAAmB,CAAC;SAC7B,cAAc,CAAC,kDAAkD,CAAC;SAClE,UAAU,CAAC,KAAK,CAAC;SACjB,aAAa,EAAE,CAAC,qCAAqC;SACrD,KAAK,EAAE,CAAC;IAEb,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,uBAAa,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEhD,GAAG,CAAC,GAAG,CAAC,IAAI,eAAe,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACtC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,IAAI,IAAI,GAAG,CAAA,MAAA,MAAA,GAAG,CAAC,aAAa,EAAE,0CAAE,OAAO,0CAAE,IAAI,KAAI,IAAI,CAAC;IAEtD,MAAM,CAAC,IAAI,CACP,wDAAwD,IAAI,IAAI,WAAW,EAAE,CAChF,CAAC;AACN,CAAC","sourcesContent":["import { INestApplication } from \"@nestjs/common\";\r\nimport { DocumentBuilder, SwaggerModule } from \"@nestjs/swagger\";\r\nimport { Logger } from \"../Logger\";\r\n\r\nexport function setupSwagger(app: INestApplication) {\r\n    const logger: Logger = new Logger(\"SwaggerConfig\");\r\n    const swaggerPath = \"swagger\";\r\n    const swaggerJsonPath = `${swaggerPath}-json`;\r\n\r\n    const config = new DocumentBuilder()\r\n        .setTitle(\"API Documentation\")\r\n        .setDescription(\"API per la gestione di accessi utenti e allegati\")\r\n        .setVersion(\"1.0\")\r\n        .addBearerAuth() // Per abilitare l'autenticazione JWT\r\n        .build();\r\n\r\n    const document = SwaggerModule.createDocument(app, config);\r\n    SwaggerModule.setup(swaggerPath, app, document);\r\n\r\n    app.use(`/${swaggerJsonPath}`, (_, res) => {\r\n        res.setHeader(\"Content-Type\", \"application/json\");\r\n        res.send(document);\r\n    });\r\n\r\n    let port = app.getHttpServer()?.address?.port || 3000;\r\n\r\n    logger.info(\r\n        `Swagger documentation available at: http://localhost:${port}/${swaggerPath}`\r\n    );\r\n} "]}
+{"version":3,"file":"SwaggerConfig.js","sourceRoot":"","sources":["../../src/swagger/SwaggerConfig.ts"],"names":[],"mappings":";;AAaA,oCA2CC;AAvDD,6CAAiE;AAGjE,sCAAmC;AASnC,SAAgB,YAAY,CAAC,GAAqB,EAAE,OAA6B;;IAC7E,MAAM,MAAM,GAAW,IAAI,eAAM,CAAC,eAAe,CAAC,CAAC;IACnD,wEAAwE;IACxE,6EAA6E;IAC7E,oCAAoC;IACpC,MAAM,WAAW,GAAG,CAAC,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,SAAS,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAClF,MAAM,eAAe,GAAG,CAAC,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,mCAAI,GAAG,WAAW,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChG,iFAAiF;IACjF,MAAM,qBAAqB,GAAG,GAAG,WAAW,OAAO,CAAC;IAEpD,MAAM,MAAM,GAAG,IAAI,yBAAe,EAAE;SAC/B,QAAQ,CAAC,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,mBAAmB,CAAC;SAC/C,cAAc,CAAC,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,kDAAkD,CAAC;SAC1F,UAAU,CAAC,KAAK,CAAC;SACjB,aAAa,EAAE,CAAC,qCAAqC;SACrD,KAAK,EAAE,CAAC;IAEb,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,uBAAa,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEhD,GAAG,CAAC,GAAG,CAAC,IAAI,eAAe,EAAE,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QAC5D,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,IAAI,qBAAqB,KAAK,eAAe,EAAE,CAAC;QAC5C,GAAG,CAAC,GAAG,CAAC,IAAI,qBAAqB,EAAE,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;YAClE,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,aAAa,GAAG,MAAA,MAAA,GAAG,CAAC,aAAa,EAAE,0CAAE,OAAO,kDAAI,CAAC;IACvD,MAAM,IAAI,GAAG,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ;QAC3D,CAAC,CAAE,aAA6B,CAAC,IAAI;QACrC,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,CAAC,IAAI,CACP,wDAAwD,IAAI,IAAI,WAAW,EAAE,CAChF,CAAC;IACF,MAAM,CAAC,IAAI,CACP,uDAAuD,IAAI,IAAI,eAAe,EAAE,CACnF,CAAC;AACN,CAAC","sourcesContent":["import { INestApplication } from \"@nestjs/common\";\nimport { DocumentBuilder, SwaggerModule } from \"@nestjs/swagger\";\nimport { Request, Response } from \"express\";\nimport { AddressInfo } from \"net\";\nimport { Logger } from \"../Logger\";\n\nexport type SwaggerSetupOptions = {\n    swaggerPath?: string;\n    swaggerJsonPath?: string;\n    title?: string;\n    description?: string;\n};\n\nexport function setupSwagger(app: INestApplication, options?: SwaggerSetupOptions) {\n    const logger: Logger = new Logger(\"SwaggerConfig\");\n    // Naming industriale OpenAPI: `/openapi` (UI) e `/openapi.json` (spec).\n    // Il path e' configurabile per consentire piu' documentazioni sotto prefissi\n    // dedicati (es. `accessi/openapi`).\n    const swaggerPath = (options?.swaggerPath ?? \"openapi\").replace(/^\\/+|\\/+$/g, \"\");\n    const swaggerJsonPath = (options?.swaggerJsonPath ?? `${swaggerPath}.json`).replace(/^\\/+/, \"\");\n    // Manteniamo l'alias storico `<path>-json` per non rompere i consumer esistenti.\n    const legacySwaggerJsonPath = `${swaggerPath}-json`;\n\n    const config = new DocumentBuilder()\n        .setTitle(options?.title ?? \"API Documentation\")\n        .setDescription(options?.description ?? \"API per la gestione di accessi utenti e allegati\")\n        .setVersion(\"1.0\")\n        .addBearerAuth() // Per abilitare l'autenticazione JWT\n        .build();\n\n    const document = SwaggerModule.createDocument(app, config);\n    SwaggerModule.setup(swaggerPath, app, document);\n\n    app.use(`/${swaggerJsonPath}`, (_req: Request, res: Response) => {\n        res.setHeader(\"Content-Type\", \"application/json\");\n        res.send(document);\n    });\n\n    if (legacySwaggerJsonPath !== swaggerJsonPath) {\n        app.use(`/${legacySwaggerJsonPath}`, (_req: Request, res: Response) => {\n            res.setHeader(\"Content-Type\", \"application/json\");\n            res.send(document);\n        });\n    }\n\n    const serverAddress = app.getHttpServer()?.address?.();\n    const port = serverAddress && typeof serverAddress === \"object\"\n        ? (serverAddress as AddressInfo).port\n        : 3000;\n\n    logger.info(\n        `Swagger documentation available at: http://localhost:${port}/${swaggerPath}`\n    );\n    logger.info(\n        `Swagger OpenAPI JSON available at: http://localhost:${port}/${swaggerJsonPath}`\n    );\n}\n"]}