feat(repo): init nest and typeorm generators

apps/ebitemp-api-e2e/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@insiemesalute-3p/ebitemp-api-e2e",
+  "name": "@repo/ebitemp-api-e2e",
   "version": "0.0.1",
   "private": true,
   "nx": {

apps/ebitemp-api/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@insiemesalute-3p/ebitemp-api",
+  "name": "@repo/ebitemp-api",
   "version": "0.0.1",
   "private": true,
   "nx": {

nx.json

@@ -56,6 +56,14 @@
   "targetDefaults": {
     "test": {
       "dependsOn": ["^build"]
+    },
+    "@nx/js:tsc": {
+      "cache": true,
+      "dependsOn": ["^build"],
+      "inputs": ["production", "^production"]
     }
+  },
+  "sync": {
+    "applyChanges": true
   }
 }

package.json

@@ -1,9 +1,9 @@
 {
-  "name": "@insiemesalute-3p/source",
+  "name": "@repo/source",
   "version": "0.0.0",
   "license": "MIT",
   "scripts": {
-    "start": "nx run-many --target serve",
+    "start": "nx run-many --target serve -c development",
     "build": "nx run-many --target build",
     "lint": "nx run-many --target lint"
   },
@@ -18,9 +18,11 @@
     "@nx/js": "20.4.0",
     "@nx/nest": "20.4.0",
     "@nx/node": "20.4.0",
+    "@nx/plugin": "20.4.0",
     "@nx/web": "20.4.0",
     "@nx/webpack": "20.4.0",
     "@swc-node/register": "~1.9.1",
+    "@swc/cli": "~0.3.12",
     "@swc/core": "~1.5.7",
     "@swc/helpers": "~0.5.11",
     "@swc/jest": "~0.2.36",
@@ -28,6 +30,7 @@
     "@types/node": "~18.16.9",
     "eslint": "^9.8.0",
     "eslint-config-prettier": "^9.0.0",
+    "execa": "5.1.1",
     "jest": "^29.7.0",
     "jest-environment-node": "^29.7.0",
     "nx": "20.4.0",
@@ -43,6 +46,7 @@
     "@nestjs/common": "^10.0.2",
     "@nestjs/core": "^10.0.2",
     "@nestjs/platform-express": "^10.0.2",
+    "@nx/devkit": "20.4.0",
     "axios": "^1.6.0",
     "reflect-metadata": "^0.1.13",
     "rxjs": "^7.8.0"

pnpm-workspace.yaml

@@ -1,2 +1,3 @@
-packages: 
-  - "apps/*"
+packages:
+  - 'apps/*'
+  - 'tools/*'

tools/nest/README.md

@@ -0,0 +1,7 @@
+# nest
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build nest` to build the library.

tools/nest/generators.json

@@ -0,0 +1,11 @@
+{
+  "generators": {
+    "library": {
+      "factory": "./src/generators/library/library",
+      "schema": "./src/generators/library/schema.json",
+      "aliases": ["lib"],
+      "x-type": "library",
+      "description": "Create a NestJS Library for Nx."
+    }
+  }
+}

tools/nest/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@repo/nest",
+  "version": "0.0.1",
+  "private": true,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "nx": {
+    "targets": {
+      "build": {
+        "executor": "@nx/js:tsc",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "tools/nest/dist",
+          "main": "tools/nest/src/index.ts",
+          "tsConfig": "tools/nest/tsconfig.lib.json",
+          "rootDir": "tools/nest/src",
+          "generatePackageJson": false,
+          "assets": [
+            {
+              "input": "./tools/nest/src",
+              "glob": "**/!(*.ts)",
+              "output": "."
+            },
+            {
+              "input": "./tools/nest/src",
+              "glob": "**/*.d.ts",
+              "output": "."
+            }
+          ]
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "@nx/devkit": "20.4.0",
+    "tslib": "^2.3.0"
+  },
+  "generators": "./generators.json",
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo",
+    "generators.json"
+  ]
+}

tools/nest/src/generators/library/files/common/src/index.ts.template

@@ -0,0 +1,3 @@
+export * from './lib/<%= fileName %>.module';<% if(controller) { %>
+export * from './lib/<%= fileName %>.controller';<% } %><% if(service) { %>
+export * from './lib/<%= fileName %>.service';<% } %>

tools/nest/src/generators/library/files/common/src/lib/__fileName__.controller.spec.ts.template

@@ -0,0 +1,20 @@
+import { Test } from '@nestjs/testing';
+import { <%= className %>Controller } from './<%= fileName %>.controller';<% if(service) { %>
+import { <%= className %>Service } from './<%= fileName %>.service';<% } %>
+
+describe('<%= className %>Controller', () => {
+	let controller: <%= className %>Controller;
+
+	beforeEach(async () => {
+		const module = await Test.createTestingModule({
+			providers: [<% if(service) { %><%= className %>Service<% } %>],
+			controllers: [<%= className %>Controller]
+		}).compile();
+
+		controller = module.get(<%= className %>Controller);
+	});
+
+	it('should be defined', () => {
+		expect(controller).toBeTruthy();
+	});
+})

tools/nest/src/generators/library/files/common/src/lib/__fileName__.controller.ts.template

@@ -0,0 +1,7 @@
+import { Controller } from '@nestjs/common';<% if(service) { %>
+import { <%= className %>Service } from './<%= fileName %>.service';<% } %>
+
+@Controller('<%= fileName %>')
+export class <%= className %>Controller {<% if(service) { %>
+  constructor(private <%= propertyName %>Service: <%= className %>Service) {}
+<% } %>}

tools/nest/src/generators/library/files/common/src/lib/__fileName__.module.ts.template

@@ -0,0 +1,11 @@
+import { Module<% if(global) { %>, Global<% } %> } from '@nestjs/common';<% if(controller) { %>
+import { <%= className %>Controller } from './<%= fileName %>.controller';<% } %><% if(service) { %>
+import { <%= className %>Service } from './<%= fileName %>.service';<% } %>
+<% if(global) { %>
+@Global()<% } %>
+@Module({
+	controllers: [<% if(controller) { %><%= className %>Controller<% } %>],
+	providers: [<% if(service) { %><%= className %>Service<% } %>],
+	exports: [<% if(service) { %><%= className %>Service<% } %>],
+})
+export class <%= className %>Module {}

tools/nest/src/generators/library/files/common/src/lib/__fileName__.service.spec.ts.template

@@ -0,0 +1,18 @@
+import { Test } from '@nestjs/testing';
+import { <%= className %>Service } from './<%= fileName %>.service';
+
+describe('<%= className %>Service', () => {
+  let service: <%= className %>Service;
+
+  beforeEach(async () => {
+    const module = await Test.createTestingModule({
+      providers: [<%= className %>Service]
+    }).compile();
+
+    service = module.get(<%= className %>Service);
+  });
+
+  it('should be defined', () => {
+    expect(service).toBeTruthy();
+  });
+})

tools/nest/src/generators/library/files/common/src/lib/__fileName__.service.ts.template

@@ -0,0 +1,6 @@
+import { Injectable, Logger } from '@nestjs/common';
+
+@Injectable()
+export class <%= className %>Service {
+    protected readonly logger = new Logger(<%= className %>Service.name);   
+}

tools/nest/src/generators/library/library.ts

@@ -0,0 +1,88 @@
+import {
+  addDependenciesToPackageJson,
+  formatFiles,
+  generateFiles,
+  joinPathFragments,
+  names,
+  OverwriteStrategy,
+  readJson,
+  readNxJson,
+  readProjectConfiguration,
+  Tree,
+  updateJson,
+} from '@nx/devkit';
+import { LibGeneratorSchema } from './schema';
+
+import { libraryGenerator } from '@nx/js';
+
+export async function libGenerator(tree: Tree, options: LibGeneratorSchema) {
+  const projectConfig = readProjectConfiguration(tree, options.project);
+
+  const typeDirectory = (() => {
+    switch (options.type) {
+      case 'module':
+        return 'modules';
+      case 'feature':
+        return 'features';
+    }
+  })();
+
+  const libraryName = `${projectConfig.name}-${options.name}`;
+  const libraryRoot = joinPathFragments(
+    projectConfig.root,
+    'src',
+    typeDirectory,
+    libraryName
+  );
+
+  const opts: Parameters<typeof libraryGenerator>[1] = {
+    directory: libraryRoot,
+    name: libraryName,
+    buildable: true,
+    linter: 'eslint',
+    setParserOptionsProject: true,
+    unitTestRunner: 'jest',
+    strict: true,
+    simpleName: false,
+  };
+  await libraryGenerator(tree, opts);
+
+  tree.delete(joinPathFragments(libraryRoot, 'src'));
+  convertToCommonJs(tree, libraryRoot);
+  generateFiles(
+    tree,
+    joinPathFragments(__dirname, './files/common'),
+    libraryRoot,
+    { ...opts, ...names(options.name), controller: true, service: true },
+    { overwriteStrategy: OverwriteStrategy.Overwrite }
+  );
+  await formatFiles(tree);
+
+  addDependenciesToPackageJson(
+    tree,
+    {},
+    { [`@${getNpmScope(tree)}/${libraryName}`]: 'workspace:' },
+    joinPathFragments(projectConfig.root, 'package.json')
+  );
+}
+
+function convertToCommonJs(tree: Tree, libraryRoot: string) {
+  updateJson(
+    tree,
+    joinPathFragments(libraryRoot, 'package.json'),
+    (pkgJson) => {
+      pkgJson.type = 'commonjs';
+      return pkgJson;
+    }
+  );
+}
+
+function getNpmScope(tree: Tree): string | undefined {
+  const { name } = tree.exists('package.json')
+    ? readJson<{ name?: string }>(tree, 'package.json')
+    : { name: null };
+
+  return name?.startsWith('@') ? name.split('/')[0].substring(1) : undefined;
+}
+
+export default libGenerator;

tools/nest/src/generators/library/schema.d.ts

@@ -0,0 +1,5 @@
+export interface LibGeneratorSchema {
+  project: string;
+  name: string;
+  type: 'module'|'feature';
+}

tools/nest/src/generators/library/schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "Library",
+  "title": "Create a NestJS Library for Nx",
+  "description": "Create a NestJS Library for Nx.",
+  "type": "object",
+  "properties": {
+    "project": {
+      "description": "The project in which to place the library.",
+      "type": "string",
+      "alias": "p",
+      "x-prompt": "Which project to scaffold?",
+      "x-dropdown": "projects"
+    },
+    "type": {
+      "description": "The library type that becomes directory where the library is placed.",
+      "type": "string",
+      "alias": "type",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": {
+        "message": "Which type of library would you like to generate?",
+        "type": "list",
+        "items": [
+          {
+            "value": "module",
+            "label": "Application module"
+          },
+          {
+            "value": "feature",
+            "label": "Feature module"
+          }
+        ]
+      }
+    },
+    "name": {
+      "description": "Library name.",
+      "pattern": "(?:^@[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*\\/[a-zA-Z0-9-~][a-zA-Z0-9-._~]*|^[a-zA-Z][^:]*)$",
+      "type": "string",
+      "$default": {
+        "$source": "argv",
+        "index": 1
+      },
+      "x-prompt": "What name would you like to use?"
+    }
+  },
+  "required": ["type", "name"]
+}

tools/nest/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    }
+  ]
+}

tools/nest/tsconfig.lib.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "rootDir": "src",
+    "outDir": "dist",
+    "tsBuildInfoFile": "dist/tsconfig.lib.tsbuildinfo",
+    "emitDeclarationOnly": false,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "references": []
+}

tools/typeorm/README.md

@@ -0,0 +1,7 @@
+# typeorm
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build typeorm` to build the library.

tools/typeorm/generators.json

@@ -0,0 +1,10 @@
+{
+  "generators": {
+    "typeorm-model-generator": {
+      "factory": "./src/generators/typeorm-model-generator/typeorm-model-generator",
+      "schema": "./src/generators/typeorm-model-generator/schema.json",
+      "aliases": ["tomg"],
+      "description": "Creates typeorm entities via typeorm-model-generator."
+    }
+  }
+}

tools/typeorm/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@repo/typeorm",
+  "version": "0.0.1",
+  "private": true,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "nx": {
+    "targets": {
+      "build": {
+        "executor": "@nx/js:tsc",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "tools/typeorm/dist",
+          "main": "tools/typeorm/src/index.ts",
+          "tsConfig": "tools/typeorm/tsconfig.lib.json",
+          "rootDir": "tools/typeorm/src",
+          "generatePackageJson": false,
+          "assets": [
+            {
+              "input": "./tools/typeorm/src",
+              "glob": "**/!(*.ts)",
+              "output": "."
+            },
+            {
+              "input": "./tools/typeorm/src",
+              "glob": "**/*.d.ts",
+              "output": "."
+            }
+          ]
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "@nx/devkit": "20.4.0",
+    "tslib": "^2.3.0"
+  },
+  "generators": "./generators.json",
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo",
+    "generators.json"
+  ]
+}

tools/typeorm/src/generators/typeorm-model-generator/files/.tomg-config.template

@@ -0,0 +1,22 @@
+[
+  {
+    "pluralizeNames": true,
+    "noConfigs": true,
+    "convertCaseFile": "none",
+    "convertCaseEntity": "pascal",
+    "convertCaseProperty": "camel",
+    "convertEol": "LF",
+    "propertyVisibility": "none",
+    "lazy": false,
+    "activeRecord": false,
+    "generateConstructor": true,
+    "customNamingStrategyPath": ".tomg-naming-strategy.js",
+    "relationIds": false,
+    "strictMode": "none",
+    "skipSchema": true,
+    "indexFile": false,
+    "exportType": "named",
+    "skipNonPrimaryKeyIndexes": true,
+    "removeColumnsInRelation": false
+  }
+]

tools/typeorm/src/generators/typeorm-model-generator/files/.tomg-naming-strategy.js.template

@@ -0,0 +1,39 @@
+/**
+ * @typedef {import('typeorm-model-generator').Column} Column
+ * @typedef {import('typeorm-model-generator').Entity} Entity
+ */
+
+/**
+ * Customizes the entity name.
+ * @param {string} oldEntityName - The default entity name.
+ * @param {Entity} entity - The entity.
+ * @returns {string} The new entity name.
+ */
+function entityName(oldEntityName, entity) {
+  return oldEntityName + 'Entity';
+}
+
+/**
+ * Customizes the column name.
+ * @param {string} oldColumnName - The default column name.
+ * @param {Column} column - The column.
+ * @returns {string} The new column name.
+ */
+function columnName(oldColumnName, column) {
+  return oldColumnName;
+}
+
+/**
+ * Customizes the file name.
+ * @param {string} oldFileName - The default file name.
+ * @returns {string} The new file name.
+ */
+function fileName(oldFileName) {
+  return oldFileName.replace('Entity', '.entity');
+}
+
+module.exports = {
+  entityName,
+  columnName,
+  fileName
+};

tools/typeorm/src/generators/typeorm-model-generator/schema.d.ts

@@ -0,0 +1,10 @@
+export interface TomgGeneratorSchema {
+  driver: string;
+  host: string;
+  username: string;
+  password: string;
+  database: string;
+  project: string;
+  directory: string;
+  quiet: boolean;
+}

tools/typeorm/src/generators/typeorm-model-generator/schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "typeorm-model-generator",
+  "title": "Creates typeorm entities via typeorm-model-generator.",
+  "description": "Creates typeorm entities via typeorm-model-generator.",
+  "type": "object",
+  "examples": [
+    {
+      "command": "nx g tomg --host 192.168.0.0 --database database -u sa -x pa$$w0rd -e mssql -q",
+      "description": "Generate typeorm entities for the database identified by the specified connection, in quiet mode"
+    }
+  ],
+  "properties": {
+    "project": {
+      "description": "The project in which to place the entities.",
+      "type": "string",
+      "alias": "p",
+      "x-prompt": "Which project to scaffold?",
+      "x-dropdown": "projects"
+    },
+    "directory": {
+      "description": "A directory where the entities are placed.",
+      "type": "string",
+      "alias": "dir",
+      "x-prompt": "Which directory do you want to create the entities in?",
+      "default": "typeorm-model-generator-output",
+      "x-priority": "important"    
+    },
+    "driver": {
+      "description": "The database driver that should be used by the generator.",
+      "type": "string",
+      "alias": "e",
+      "x-prompt": "Database driver?",
+      "default": "mssql"
+    },
+    "database": {
+      "description": "The name of the database whose tables should be scaffolded.",
+      "type": "string",
+      "x-prompt": "Database name?"
+    },
+    "host": {
+      "description": "The host of the database whose tables should be scaffolded.",
+      "type": "string",
+      "x-prompt": "Database host?"
+    },
+    "username": {
+      "description": "The username of database whose tables should be scaffolded.",
+      "type": "string",
+      "alias": "u",
+      "x-prompt": "Database username?"
+    },
+    "password": {
+      "description": "The password of database whose tables should be scaffolded.",
+      "type": "string",
+      "alias": "x",
+      "x-prompt": "Database password?"
+    },
+    "quiet": {
+      "description": "Enables verbose logging.",
+      "type": "boolean",
+      "alias": "q",
+      "default": "true",
+      "x-priority": "internal",
+      "x-prompt": "Hide typeorm stdout/stderr?"
+    }
+  },
+  "required": []
+}

tools/typeorm/src/generators/typeorm-model-generator/typeorm-model-generator.ts

@@ -0,0 +1,87 @@
+import {
+  FileChange,
+  formatFiles,
+  generateFiles,
+  joinPathFragments,
+  OverwriteStrategy,
+  readProjectConfiguration,
+  Tree,
+  workspaceRoot,
+} from '@nx/devkit';
+import execa from 'execa';
+import os from 'node:os';
+import { mkdirSync, writeFileSync, chmodSync, rmSync } from 'node:fs';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+
+import { TomgGeneratorSchema } from './schema';
+
+export async function tomgGenerator(tree: Tree, options: TomgGeneratorSchema) {
+  const libraryRoot = readProjectConfiguration(tree, options.project).root;
+
+  generateFiles(
+    tree,
+    joinPathFragments(__dirname, './files'),
+    libraryRoot,
+    options,
+    { overwriteStrategy: OverwriteStrategy.KeepExisting }
+  );
+  flushChanges(workspaceRoot, tree.listChanges());
+
+  const tmpDirPath = await mkdtemp(join(os.tmpdir(), 'tomg-'));
+  const { stdout, stderr } = await execa(
+    `typeorm-model-generator`,
+    [
+      '-o',
+      tmpDirPath,
+      '-e',
+      options.driver,
+      '-h',
+      options.host,
+      '-d',
+      options.database,
+      '-u',
+      options.username,
+      '-x',
+      options.password,
+    ],
+    { cwd: libraryRoot }
+  );
+  if (!options.quiet) {
+    console.log(stdout);
+    console.error(stderr);
+  }
+
+  generateFiles(
+    tree,
+    tmpDirPath,
+    joinPathFragments(libraryRoot, options.directory),
+    options,
+    { overwriteStrategy: OverwriteStrategy.Overwrite }
+  );
+
+  await formatFiles(tree);
+  await rm(tmpDirPath, { recursive: true, force: true });
+
+  console.log();
+  console.log('Generation complete.');
+  console.log();
+}
+
+export default tomgGenerator;
+
+function flushChanges(root: string, fileChanges: FileChange[]): void {
+  fileChanges.forEach((f) => {
+    const fpath = join(root, f.path);
+    if (f.type === 'CREATE') {
+      mkdirSync(dirname(fpath), { recursive: true });
+      writeFileSync(fpath, f.content!);
+      if (f.options?.mode) chmodSync(fpath, f.options.mode);
+    } else if (f.type === 'UPDATE') {
+      writeFileSync(fpath, f.content!);
+      if (f.options?.mode) chmodSync(fpath, f.options.mode);
+    } else if (f.type === 'DELETE') {
+      rmSync(fpath, { recursive: true, force: true });
+    }
+  });
+}

tools/typeorm/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    }
+  ]
+}

tools/typeorm/tsconfig.lib.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "rootDir": "src",
+    "outDir": "dist",
+    "tsBuildInfoFile": "dist/tsconfig.lib.tsbuildinfo",
+    "emitDeclarationOnly": false,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "references": []
+}

tsconfig.base.json

@@ -3,6 +3,7 @@
     "composite": true,
     "declarationMap": true,
     "emitDeclarationOnly": true,
+    "esModuleInterop": true,
     "importHelpers": true,
     "isolatedModules": true,
     "lib": ["es2022"],
@@ -12,7 +13,6 @@
     "noFallthroughCasesInSwitch": true,
     "noImplicitOverride": true,
     "noImplicitReturns": true,
-    "noUnusedLocals": true,
     "skipLibCheck": true,
     "strict": true,
     "target": "es2022"

tsconfig.json

@@ -8,6 +8,12 @@
     },
     {
       "path": "./apps/ebitemp-api"
+    },
+    {
+      "path": "./tools/nest"
+    },
+    {
+      "path": "./tools/typeorm"
     }
   ]
 }