@edifice.io/edifice-nestjs-core 1.0.0 → 1.0.3-develop.20260513125613

package/README.md

@@ -1,3 +1,9 @@
+# About edifice-nestjs-core
+
+- Licence : Copyright Edifice
+- Funder(s) : Edifice
+- Developer(s) : Edifice
+
 # @edifice.io/edifice-nestjs-core
 
 Core NestJS modules and utilities for Edifice applications.
@@ -661,10 +667,10 @@ It provides decorators and guards for workflow-based and admin authorization, en
 
 **Features:**
 
-- `@RequirePermission('PERMISSION_NAME')`: Restricts access to endpoints based on user workflow rights.
+- `@RequirePermission('PERMISSION_NAME')`: Restricts access to endpoints based on user workflow rights. Mandatory decorator.
 - `@RequireAdmc()`: Restricts access to endpoints for super administrators (ADMC).
 - `@Public()`: Marks endpoints as public (no authentication required).
-- Guards (`PermissionGuard`, `AdmcGuard`) are applied globally by the core module.
+- `@BasicAuth()`: Adds Basic authorization method for an endpoint. The authorized user and password are set in configuration.
 
 **How it works:**
 
@@ -988,6 +994,7 @@ Each tool is available as a binary when you install `@edifice.io/edifice-nestjs-
 - **edifice-generate-entities**: Generate MikroORM entities from database schema
 - **edifice-generate-metadata**: Generate application metadata file
 - **edifice-k6-sync-dto**: Synchronize DTOs for K6 Testing
+- **generate-swagger-pdf**: Generate a PDF from your NestJS API Swagger documentation
 
 ---
 
@@ -1073,6 +1080,40 @@ pnpm edifice-k6-sync-dto
 
 ---
 
+#### generate-swagger-pdf
+
+**Purpose:**  
+Generate a PDF from the Swagger (OpenAPI) documentation exposed by your NestJS server.
+
+**Usage:**
+
+```bash
+npx generate-swagger-pdf --host <host> --port <port>
+```
+
+**Options:**
+
+- `--host`, `-h`: Swagger server host (default: `127.0.0.1`)
+- `--port`, `-p`: Swagger server port (default: `3002`)
+
+The PDF will be generated in the `documentation/api-docs.pdf` folder of your project.
+
+**Example:**
+
+```bash
+npx generate-swagger-pdf --host 127.0.0.1 --port 4000
+```
+
+This package provides several CLI tools to help you automate common backend tasks.  
+Each tool is available as a binary when you install `@edifice.io/edifice-nestjs-core`.
+
+- **edifice-generate-entities**: Generate MikroORM entities from database schema
+- **edifice-generate-metadata**: Generate application metadata file
+- **edifice-k6-sync-dto**: Synchronize DTOs for K6 Testing
+- **generate-swagger-pdf**: Generate a PDF from your NestJS API Swagger documentation
+
+---
+
 **Note:**  
 All CLI tools are available after installing the package.  
 You can run them with `pnpm` or `npx` from your project root.

package/dist/appregistry/appregistry.service.js

@@ -15,7 +15,7 @@ const edifice_ent_client_1 = require("@edifice.io/edifice-ent-client");
 const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
 const core_1 = require("@nestjs/core");
-const permission_decorator_1 = require("../permission/permission.decorator");
+const decorators_1 = require("../permission/decorators");
 let AppRegistryService = AppRegistryService_1 = class AppRegistryService {
     configService;
     entClient;
@@ -42,7 +42,7 @@ let AppRegistryService = AppRegistryService_1 = class AppRegistryService {
                 const controllerName = instance.constructor.name;
                 this.metadataScanner.scanFromPrototype(instance, prototype, (methodName) => {
                     const methodRef = prototype[methodName];
-                    const permission = Reflect.getMetadata(permission_decorator_1.PERMISSION_KEY, methodRef);
+                    const permission = Reflect.getMetadata(decorators_1.PERMISSION_KEY, methodRef);
                     if (permission) {
                         if (Array.isArray(permission)) {
                             permission.forEach((p) => permissionsSet.add(p));

package/dist/appregistry/appregistry.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"appregistry.service.js","sourceRoot":"","sources":["../../src/appregistry/appregistry.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"appregistry.service.js","sourceRoot":"","sources":["../../src/appregistry/appregistry.service.ts"],"names":[],"mappings":"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"}

package/dist/bin/generate-rest-clients.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/generate-rest-clients.js

@@ -0,0 +1,581 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const ts = __importStar(require("typescript"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const PRIMITIVE_TYPES = new Set([
+    'string',
+    'number',
+    'boolean',
+    'Date',
+    'any',
+    'void',
+    'object',
+    'never',
+    'unknown',
+    'null',
+    'undefined',
+]);
+function parseControllers(filePath) {
+    const program = ts.createProgram([filePath], {
+        target: ts.ScriptTarget.ES2020,
+        module: ts.ModuleKind.CommonJS,
+    });
+    const sourceFile = program.getSourceFile(filePath);
+    if (!sourceFile) {
+        throw new Error(`Could not load source file: ${filePath}`);
+    }
+    const controllers = [];
+    ts.forEachChild(sourceFile, (node) => {
+        if (ts.isClassDeclaration(node) && node.name) {
+            const controllerDecorator = getDecorator(node, 'Controller');
+            if (!controllerDecorator)
+                return;
+            const basePath = getDecoratorArgument(controllerDecorator) || '';
+            const apiTagDecorator = getDecorator(node, 'ApiTags');
+            const tag = apiTagDecorator
+                ? getDecoratorArgument(apiTagDecorator)
+                : undefined;
+            const controller = {
+                name: node.name.text,
+                basePath,
+                methods: [],
+                jsdoc: getJsDoc(node),
+                tag,
+            };
+            node.members.forEach((member) => {
+                if (ts.isMethodDeclaration(member) && member.name) {
+                    const methodMetadata = parseMethod(member);
+                    if (methodMetadata) {
+                        controller.methods.push(methodMetadata);
+                    }
+                }
+            });
+            controllers.push(controller);
+        }
+    });
+    return controllers;
+}
+function parseMethod(method) {
+    const httpMethods = ['Get', 'Post', 'Put', 'Patch', 'Delete'];
+    let httpMethod = null;
+    let routePath = '';
+    for (const httpMethodName of httpMethods) {
+        const decorator = getDecorator(method, httpMethodName);
+        if (decorator) {
+            httpMethod = httpMethodName.toUpperCase();
+            routePath = getDecoratorArgument(decorator) || '';
+            break;
+        }
+    }
+    if (!httpMethod)
+        return null;
+    const methodName = method.name.text;
+    const params = [];
+    const reservedNames = new Set(['options', 'queryParams']);
+    method.parameters.forEach((param) => {
+        let paramName = param.name.text;
+        if (getDecorator(param, 'Req'))
+            return;
+        const paramDecorator = getDecorator(param, 'Param');
+        const queryDecorator = getDecorator(param, 'Query');
+        const bodyDecorator = getDecorator(param, 'Body');
+        let paramType = getTypeName(param.type);
+        if (paramDecorator) {
+            const expression = paramDecorator.expression;
+            if (ts.isCallExpression(expression) && expression.arguments.length > 1) {
+                const pipeArg = expression.arguments[1];
+                let pipeName = '';
+                if (ts.isIdentifier(pipeArg)) {
+                    pipeName = pipeArg.text;
+                }
+                else if (ts.isNewExpression(pipeArg) &&
+                    ts.isIdentifier(pipeArg.expression)) {
+                    pipeName = pipeArg.expression.text;
+                }
+                const pipeTypeMap = {
+                    ParseIntPipe: 'number',
+                    ParseBoolPipe: 'boolean',
+                    ParseFloatPipe: 'number',
+                    ParseUUIDPipe: 'string',
+                    ParseEnumPipe: 'string',
+                };
+                for (const [pipe, type] of Object.entries(pipeTypeMap)) {
+                    if (pipeName.includes(pipe)) {
+                        paramType = type;
+                        break;
+                    }
+                }
+            }
+        }
+        if (bodyDecorator) {
+            const bodyFieldArg = getDecoratorArgument(bodyDecorator);
+            if (bodyFieldArg) {
+                paramName = bodyFieldArg;
+            }
+        }
+        if (queryDecorator) {
+            const queryFieldArg = getDecoratorArgument(queryDecorator);
+            if (queryFieldArg) {
+                paramName = queryFieldArg;
+            }
+        }
+        if (reservedNames.has(paramName)) {
+            paramName = `_${paramName}`;
+        }
+        if (paramDecorator) {
+            params.push({
+                name: paramName,
+                type: paramType,
+                decorator: 'Param',
+                isOptional: !!param.questionToken,
+            });
+        }
+        else if (queryDecorator) {
+            params.push({
+                name: paramName,
+                type: paramType,
+                decorator: 'Query',
+                isOptional: !!param.questionToken,
+            });
+        }
+        else if (bodyDecorator) {
+            params.push({
+                name: paramName,
+                type: paramType,
+                decorator: 'Body',
+                isOptional: !!param.questionToken,
+            });
+        }
+    });
+    const returnType = getReturnType(method);
+    const apiOperationDecorator = getDecorator(method, 'ApiOperation');
+    const operationSummary = apiOperationDecorator
+        ? getDecoratorObjectProperty(apiOperationDecorator, 'summary')
+        : undefined;
+    return {
+        name: methodName,
+        httpMethod,
+        path: routePath,
+        params,
+        returnType,
+        jsdoc: getJsDoc(method),
+        operationSummary,
+    };
+}
+function getDecorator(node, decoratorName) {
+    const decorators = ts.getDecorators(node);
+    if (!decorators)
+        return undefined;
+    return decorators.find((decorator) => {
+        try {
+            const expression = decorator.expression;
+            if (ts.isCallExpression(expression)) {
+                const callExpression = expression.expression;
+                if (ts.isIdentifier(callExpression)) {
+                    return callExpression.text === decoratorName;
+                }
+                if (ts.isPropertyAccessExpression(callExpression)) {
+                    const name = callExpression.name;
+                    if (ts.isIdentifier(name)) {
+                        return name.text === decoratorName;
+                    }
+                }
+                return false;
+            }
+            if (ts.isIdentifier(expression)) {
+                return expression.text === decoratorName;
+            }
+            if (ts.isPropertyAccessExpression(expression)) {
+                const name = expression.name;
+                if (ts.isIdentifier(name)) {
+                    return name.text === decoratorName;
+                }
+            }
+            return false;
+        }
+        catch (_) {
+            return false;
+        }
+    });
+}
+function getDecoratorArgument(decorator) {
+    const expression = decorator.expression;
+    if (ts.isCallExpression(expression) && expression.arguments.length > 0) {
+        const arg = expression.arguments[0];
+        if (ts.isStringLiteral(arg)) {
+            return arg.text;
+        }
+    }
+    return undefined;
+}
+function getDecoratorObjectProperty(decorator, propertyName) {
+    const expression = decorator.expression;
+    if (ts.isCallExpression(expression) && expression.arguments.length > 0) {
+        const arg = expression.arguments[0];
+        if (ts.isObjectLiteralExpression(arg)) {
+            const property = arg.properties.find((prop) => {
+                if (!ts.isPropertyAssignment(prop))
+                    return false;
+                let propName;
+                if (ts.isIdentifier(prop.name)) {
+                    propName = prop.name.text;
+                }
+                else if (ts.isStringLiteral(prop.name)) {
+                    propName = prop.name.text;
+                }
+                return propName === propertyName;
+            });
+            if (property && ts.isPropertyAssignment(property)) {
+                if (ts.isStringLiteral(property.initializer)) {
+                    return property.initializer.text;
+                }
+            }
+        }
+    }
+    return undefined;
+}
+function getReturnType(method) {
+    if (!method.type)
+        return 'void';
+    try {
+        const typeNode = method.type;
+        if (ts.isTypeReferenceNode(typeNode)) {
+            const typeName = ts.isIdentifier(typeNode.typeName)
+                ? typeNode.typeName.text
+                : 'any';
+            if (typeName === 'Promise' &&
+                typeNode.typeArguments &&
+                typeNode.typeArguments.length > 0) {
+                const innerType = getTypeName(typeNode.typeArguments[0]);
+                return innerType === 'void' ? 'void' : innerType;
+            }
+            return typeName;
+        }
+        if (ts.isIdentifier(typeNode)) {
+            return typeNode.text;
+        }
+        if (typeNode.kind === ts.SyntaxKind.VoidKeyword) {
+            return 'void';
+        }
+        return 'void';
+    }
+    catch (_) {
+        return 'void';
+    }
+}
+function getTypeName(typeNode) {
+    if (!typeNode)
+        return 'any';
+    try {
+        if (typeNode.kind === ts.SyntaxKind.VoidKeyword) {
+            return 'void';
+        }
+        if (typeNode.kind === ts.SyntaxKind.StringKeyword) {
+            return 'string';
+        }
+        if (typeNode.kind === ts.SyntaxKind.NumberKeyword) {
+            return 'number';
+        }
+        if (typeNode.kind === ts.SyntaxKind.BooleanKeyword) {
+            return 'boolean';
+        }
+        if (ts.isIdentifier(typeNode)) {
+            return typeNode.text;
+        }
+        if (ts.isArrayTypeNode(typeNode)) {
+            const elementType = getTypeName(typeNode.elementType);
+            return `${elementType}[]`;
+        }
+        if (ts.isTypeReferenceNode(typeNode)) {
+            const typeName = ts.isIdentifier(typeNode.typeName)
+                ? typeNode.typeName.text
+                : typeNode.typeName.getText?.();
+            if (typeNode.typeArguments && typeNode.typeArguments.length > 0) {
+                const args = typeNode.typeArguments
+                    .map((arg) => getTypeName(arg))
+                    .join(', ');
+                return `${typeName}<${args}>`;
+            }
+            return typeName || 'any';
+        }
+        if (ts.isUnionTypeNode(typeNode)) {
+            return typeNode.types.map((t) => getTypeName(t)).join(' | ');
+        }
+        if (ts.isTypeLiteralNode(typeNode)) {
+            const members = typeNode.members
+                .map((member) => {
+                if (ts.isPropertySignature(member) && member.name && member.type) {
+                    const propName = ts.isIdentifier(member.name)
+                        ? member.name.text
+                        : member.name.getText?.() || 'unknown';
+                    const propType = getTypeName(member.type);
+                    const optional = member.questionToken ? '?' : '';
+                    return `${propName}${optional}: ${propType}`;
+                }
+                return null;
+            })
+                .filter(Boolean)
+                .join('; ');
+            return `{ ${members} }`;
+        }
+        if (typeNode.getText && typeNode.getSourceFile?.()) {
+            return typeNode.getText();
+        }
+        return 'any';
+    }
+    catch (_) {
+        return 'any';
+    }
+}
+function getJsDoc(node) {
+    const jsDocTags = ts.getJSDocTags(node);
+    if (jsDocTags.length > 0) {
+        return jsDocTags.map((tag) => tag.comment).join('\n');
+    }
+    return undefined;
+}
+function generateClientClass(controller) {
+    const clientName = controller.name.replace('Controller', 'Client');
+    const methods = controller.methods.map((method) => generateClientMethod(controller.basePath, method));
+    const dtoImports = new Set();
+    const shouldImportType = (type) => {
+        if (PRIMITIVE_TYPES.has(type))
+            return false;
+        if (type.startsWith('{'))
+            return false;
+        if (type.includes('{') && type.includes('}'))
+            return false;
+        return true;
+    };
+    controller.methods.forEach((method) => {
+        method.params.forEach((param) => {
+            const baseType = param.type.replace('[]', '');
+            if (shouldImportType(baseType)) {
+                dtoImports.add(baseType);
+            }
+        });
+        const baseReturnType = method.returnType.replace('[]', '');
+        if (shouldImportType(baseReturnType)) {
+            dtoImports.add(baseReturnType);
+        }
+    });
+    const imports = Array.from(dtoImports).join(', ');
+    const importsSection = imports
+        ? `import {
+  ${imports}
+} from "../../../dtos";
+`
+        : '';
+    return `import {
+  BaseApiClient,
+  ApiClientOptions,
+  RequestOptions,
+} from "@edifice.io/rest-client-base";
+${importsSection}
+/**
+ * Client for interacting with the ${controller.tag || controller.name} API
+ * ${controller.jsdoc || ''}
+ *
+ * @example
+ * // Basic usage with fetch (default)
+ * const client = new ${clientName}();
+ *
+ * @example
+ * // With Edifice HttpService
+ * import { odeServices } from '@edifice.io/client';
+ *
+ * const httpService = odeServices.http();
+ * const client = new ${clientName}({
+ *   httpService: httpService
+ * });
+ */
+export class ${clientName} extends BaseApiClient {
+  /**
+   * Creates a new ${clientName}
+   * @param options Client configuration options
+   */
+  constructor(options: ApiClientOptions = {}) {
+    super(options);
+  }
+
+${methods.join('\n\n')}
+}
+`;
+}
+function generateClientMethod(basePath, method) {
+    const methodName = toCamelCase(method.name);
+    const params = [];
+    const queryParams = [];
+    const pathParams = new Map();
+    let bodyParam = null;
+    method.params.forEach((param) => {
+        const paramDeclaration = `${param.name}${param.isOptional ? '?' : ''}: ${param.type}`;
+        if (param.decorator === 'Param') {
+            params.push(paramDeclaration);
+            pathParams.set(param.name, param.type);
+        }
+        else if (param.decorator === 'Query') {
+            params.push(paramDeclaration);
+            queryParams.push(param.name);
+        }
+        else if (param.decorator === 'Body') {
+            params.push(paramDeclaration);
+            bodyParam = param.name;
+        }
+    });
+    params.push('options?: RequestOptions');
+    let url = basePath;
+    if (method.path) {
+        if (!basePath.endsWith('/') && !method.path.startsWith('/')) {
+            url += '/';
+        }
+        url += method.path;
+    }
+    pathParams.forEach((_, paramName) => {
+        url = url.replace(`:${paramName}`, `\${${paramName}}`);
+    });
+    const queryParamsCode = queryParams.length > 0
+        ? `
+    const queryParams = new URLSearchParams();
+${queryParams
+            .map((param) => {
+            const paramMeta = method.params.find((p) => p.name === param);
+            if (paramMeta?.isOptional) {
+                return `    if (${param}) queryParams.append("${param}", String(${param}));`;
+            }
+            return `    queryParams.append("${param}", String(${param}));`;
+        })
+            .join('\n')}
+`
+        : '';
+    const queryArg = queryParams.length > 0 ? 'queryParams' : 'undefined';
+    const httpMethodLower = method.httpMethod.toLowerCase();
+    const returnType = method.returnType === 'void'
+        ? 'Promise<void>'
+        : `Promise<${method.returnType}>`;
+    const jsdoc = method.operationSummary || method.jsdoc || '';
+    let methodCall;
+    if (httpMethodLower === 'get' || httpMethodLower === 'delete') {
+        const genericType = method.returnType === 'void' ? '' : `<${method.returnType}>`;
+        methodCall = `this.${httpMethodLower}${genericType}(
+      \`${url}\`,
+      ${queryArg},
+      options
+    )`;
+    }
+    else {
+        const bodyArg = bodyParam || 'undefined';
+        const genericType = method.returnType === 'void' ? '' : `<${method.returnType}>`;
+        methodCall = `this.${httpMethodLower}${genericType}(
+      \`${url}\`,
+      ${bodyArg},
+      ${queryArg},
+      options
+    )`;
+    }
+    return `  /**
+   * ${jsdoc}
+${method.params.map((p) => `   * @param ${p.name} ${p.type}`).join('\n')}
+   * @param options Additional request options
+   * @returns ${method.returnType === 'void' ? 'void' : method.returnType}
+   */
+  async ${methodName}(
+    ${params.join(',\n    ')}
+  ): ${returnType} {${queryParamsCode}
+    return ${methodCall};
+  }`;
+}
+function toCamelCase(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+function generateIndexFile(clientOutputDir, controllers) {
+    const clientNames = controllers.map((controller) => controller.name.replace('Controller', 'Client'));
+    const imports = clientNames
+        .map((name) => {
+        const fileName = toCamelCase(name.replace('Client', ''));
+        return `export { ${name} } from "./${fileName}.client";`;
+    })
+        .join('\n');
+    const indexFilePath = path.join(clientOutputDir, 'clients', 'index.ts');
+    const indexContent = `// This file is auto-generated by generate-rest-clients.ts
+// Do not edit manually
+
+${imports}
+`;
+    fs.writeFileSync(indexFilePath, indexContent, 'utf-8');
+    console.log(`✅ Generated ${indexFilePath}`);
+}
+const args = process.argv.slice(2);
+if (args.length < 2) {
+    console.warn('Usage: generate-rest-clients <backend-src-dir> <client-output-dir>');
+}
+const backendSrcDir = path.resolve(args[0] || './backend/src');
+const clientOutputDir = path.resolve(args[1] || './client/rest/src/clients/generated');
+const controllerFiles = [];
+function findControllerFiles(dir) {
+    const files = fs.readdirSync(dir);
+    files.forEach((file) => {
+        const fullPath = path.join(dir, file);
+        if (fs.statSync(fullPath).isDirectory()) {
+            findControllerFiles(fullPath);
+        }
+        else if (file.endsWith('.controller.ts')) {
+            controllerFiles.push(fullPath);
+        }
+    });
+}
+findControllerFiles(backendSrcDir);
+console.log(`Found ${controllerFiles.length} controller files`);
+const allControllers = [];
+controllerFiles.forEach((controllerFile) => {
+    console.log(`Processing ${controllerFile}...`);
+    const controllers = parseControllers(controllerFile);
+    allControllers.push(...controllers);
+    controllers.forEach((controller) => {
+        const clientName = controller.name.replace('Controller', 'Client');
+        const clientFileName = `${toCamelCase(clientName.replace('Client', ''))}.client.ts`;
+        const clientFilePath = path.join(clientOutputDir, 'clients', clientFileName);
+        const clientCode = generateClientClass(controller);
+        fs.mkdirSync(path.dirname(clientFilePath), { recursive: true });
+        fs.writeFileSync(clientFilePath, clientCode, 'utf-8');
+        console.log(`✅ Generated ${clientFilePath}`);
+    });
+});
+generateIndexFile(clientOutputDir, allControllers);
+console.log('✅ Client generation complete!');
+//# sourceMappingURL=generate-rest-clients.js.map