@nest-omni/core 2.0.1-9 → 3.1.1-9

package/index.js

@@ -25,3 +25,7 @@ __exportStar(require("./middlewares"), exports);
 __exportStar(require("./validators"), exports);
 __exportStar(require("./common"), exports);
 __exportStar(require("./validator-json"), exports);
+__exportStar(require("./helpers"), exports);
+__exportStar(require("./providers"), exports);
+__exportStar(require("./setup"), exports);
+__exportStar(require("./health-checker"), exports);

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@nest-omni/core",
-  "version": "2.0.1-9",
-  "description": "framework",
+  "version": "3.1.1-9",
+  "description": "A comprehensive NestJS framework for building enterprise-grade applications with best practices",
   "main": "index.js",
   "types": "index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "test": "jest --passWithNoTests",
@@ -14,60 +19,159 @@
     "i18n": "i18n",
     "gen": "gen"
   },
+  "keywords": [
+    "nestjs",
+    "framework",
+    "typescript",
+    "decorators",
+    "validation",
+    "interceptors",
+    "filters",
+    "middleware",
+    "enterprise",
+    "omni",
+    "sentry",
+    "health-check",
+    "redis-lock",
+    "pm2"
+  ],
   "author": "Jinpy",
   "license": "Apache-2.0",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
   "devDependencies": {
-    "typescript": "^5.4.5",
-    "@types/compression": "^1.8.1"
+    "@types/compression": "^1.8.1",
+    "@types/express": "^5.0.3",
+    "@types/express-session": "^1.18.2",
+    "@types/lodash": "^4.17.20",
+    "@types/node": "^24.9.1",
+    "@types/sprintf-js": "^1.1.4",
+    "@types/uuid": "^10.0.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@nestjs-cls/transactional": "^3.1.0",
+    "@nestjs-cls/transactional-adapter-typeorm": "^1.3.0",
+    "@sentry/nestjs": "^10.21.0",
+    "@sentry/profiling-node": "^10.21.0",
+    "axios": "^1.12.2",
+    "axios-retry": "^4.5.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
+    "compression": "^1.8.1",
+    "hygen": "^6.2.11",
+    "libphonenumber-js": "^1.12.24",
+    "lodash": "^4.17.21",
+    "moment": "^2.30.1",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "sprintf-js": "^1.1.3",
+    "uuid": "^13.0.0"
   },
   "peerDependencies": {
     "@dataui/crud": "^5.3.0",
     "@dataui/crud-typeorm": "^5.3.0",
-    "@mvmdev/nestjs-redis-health": "^10.0.1",
-    "@nestjs/bull": "^10.0.1",
-    "@nestjs/cache-manager": "^2.1.0",
-    "@nestjs/common": "10.2.5",
+    "@keyv/redis": "^5.1.3",
+    "@songkeys/nestjs-redis": "^11.0.0",
+    "@songkeys/nestjs-redis-health": "^11.0.0",
+    "@nestjs/bull": "^11.0.0",
+    "@nestjs/cache-manager": "^3.0.0",
+    "@nestjs/common": "^11.0.0",
     "@nestjs/config": "^4.0.0",
-    "@nestjs/core": "10.2.5",
-    "@nestjs/microservices": "^10.2.5",
-    "@nestjs/platform-express": "^10.2.5",
-    "@nestjs/schedule": "^3.0.3",
-    "@nestjs/swagger": "^7.1.11",
-    "@nestjs/terminus": "^10.1.1",
-    "@nestjs/typeorm": "^10.0.0",
-    "axios": "^1.5.0",
-    "axios-retry": "^3.7.0",
-    "bcrypt": "5.1.0",
-    "bull": "^4.11.3",
-    "cache-manager-ioredis-yet": "^1.2.2",
-    "class-transformer": "~0.5.1",
-    "class-validator": "~0.14.0",
-    "connect-redis": "^7.1.0",
-    "express": "^4.18.2",
-    "express-session": "^1.17.3",
-    "libphonenumber-js": "^1.10.44",
-    "lodash": "^4.17.21",
-    "mime-types": "^2.1.35",
-    "moment": "^2.29.4",
-    "mysql2": "^3.6.1",
-    "nestjs-cls": "^4.3.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/platform-express": "^11.0.0",
+    "@nestjs/schedule": "^6.0.0",
+    "@nestjs/swagger": "^11.0.0",
+    "@nestjs/terminus": "^11.0.0",
+    "@nestjs/typeorm": "^11.0.0",
+    "bcrypt": "^6.0.0",
+    "bull": "^4.16.0",
+    "cache-manager": "^7.0.0",
+    "keyv": "^5.5.3",
+    "connect-redis": "^9.0.0",
+    "express": "^5.0.0",
+    "express-session": "^1.18.0",
+    "mime-types": "^3.0.0",
+    "mysql2": "^3.0.0",
+    "nestjs-cls": "^6.0.0",
     "nestjs-i18n": "^10.5.0",
-    "nestjs-pino": "^3.4.0",
-    "pino-http": "^8.5.0",
-    "pino-pretty": "^10.2.0",
-    "reflect-metadata": "^0.1.13",
-    "rxjs": "^7.8.1",
+    "nestjs-pino": "^4.0.0",
+    "pino-http": "^11.0.0",
+    "pino-pretty": "^13.0.0",
     "source-map-support": "^0.5.21",
-    "sprintf-js": "^1.1.3",
-    "typeorm": "^0.3.17",
-    "typeorm-transactional": "~0.4.1",
-    "uuid": "^9.0.1"
+    "typeorm": "^0.3.20"
   },
-  "dependencies": {
-    "hygen": "^6.2.11",
-    "nestjs-cls": "^4.3.0",
-    "compression": "^1.8.0",
-    "@sentry/nestjs": "~9.17.0",
-    "@sentry/profiling-node": "~9.17.0"
+  "peerDependenciesMeta": {
+    "@dataui/crud": {
+      "optional": true
+    },
+    "@dataui/crud-typeorm": {
+      "optional": true
+    },
+    "@keyv/redis": {
+      "optional": true
+    },
+    "@songkeys/nestjs-redis": {
+      "optional": true
+    },
+    "@songkeys/nestjs-redis-health": {
+      "optional": true
+    },
+    "@nestjs/bull": {
+      "optional": true
+    },
+    "@nestjs/cache-manager": {
+      "optional": true
+    },
+    "@nestjs/microservices": {
+      "optional": true
+    },
+    "@nestjs/schedule": {
+      "optional": true
+    },
+    "@nestjs/swagger": {
+      "optional": true
+    },
+    "bcrypt": {
+      "optional": true
+    },
+    "bull": {
+      "optional": true
+    },
+    "cache-manager": {
+      "optional": true
+    },
+    "connect-redis": {
+      "optional": true
+    },
+    "express-session": {
+      "optional": true
+    },
+    "keyv": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "nestjs-cls": {
+      "optional": true
+    },
+    "nestjs-i18n": {
+      "optional": true
+    },
+    "nestjs-pino": {
+      "optional": true
+    },
+    "pino-http": {
+      "optional": true
+    },
+    "pino-pretty": {
+      "optional": true
+    },
+    "typeorm": {
+      "optional": true
+    }
   }
 }

package/.hygen/new/crud/controller.ejs.t

@@ -1,82 +0,0 @@
----
-to: "src/modules/<%= h.fileName(name) %>/<%= h.controllerFileName(name) %>.ts"
-unless_exists: true
-skip_if: <%= !blocks.includes('Controller') %>
----
-<%
-
- ClassName = h.ClassName(name);
- moduleName = h.moduleName(name);
- fileName = h.fileName(name);
- ControllerName = h.ControllerName(name);
- ServiceName = h.ServiceName(name);
- serviceName = h.changeCase.camel(ServiceName);
- createFunctionName = 'create' + ClassName;
- updateFunctionName = 'update' + ClassName;
- deleteFunctionName = 'delete' + ClassName;
- getAllFunctionName = 'getAll' + ClassName;
- getSingleFunctionName = 'getSingle' + ClassName;
- CreateDtoName = h.CreateDtoName(name);
- createDtoName = h.changeCase.camel(CreateDtoName);
- UpdateDtoName = h.UpdateDtoName(name);
- updateDtoName = h.changeCase.camel(UpdateDtoName);
- PageOptionsDtoName = h.PageOptionsDtoName(name);
- pageOptionsDtoName = h.changeCase.camel(PageOptionsDtoName);
- DtoName = h.DtoName(name);
- createDtoFileName = h.createDtoFileName(name);
- dtoFileName = h.dtoFileName(name);
- pageOptionsDtoFileName = h.pageOptionsDtoFileName(name);
- updateDtoFileName = h.updateDtoFileName(name);
- serviceFileName = h.serviceFileName(name);
- EntityName = h.EntityName(name);
- entityName = h.changeCase.camel(EntityName);
- entityFileName = h.entityFileName(name);
- GetDtoName = 'Get' + DtoName;
- getDtoFileName = 'get-' + dtoFileName;
-
-%>import { Body, Controller, Delete, Put, Post } from '@nestjs/common';
-import { ApiBody, ApiOperation, ApiTags } from '@nestjs/swagger';
-import { Crud } from '@dataui/crud';
-
-import { <%= EntityName %> } from './<%= entityFileName %>';
-import { <%= ServiceName %> } from './<%= serviceFileName %>';
-
-import { dto } from './requests';
-import { serialize } from './responses';
-import { targetConstructorToSchema } from '@nest-omni/core/validator-json';
-import { I18nService } from 'nestjs-i18n';
-import { BulkIdDto } from '@nest-omni/core/common/dto/bulk-id.dto';
-
-@Crud({
-  model: { type: <%= EntityName %> },
-  dto,
-  serialize,
-  query: {
-    alwaysPaginate: true,
-  },
-})
-@Controller('<%= h.inflection.pluralize(fileName).toLowerCase() %>')
-@ApiTags('<%= h.inflection.pluralize(fileName).toLowerCase() %>')
-export class <%= ControllerName %> {
-  constructor(
-    public service: <%= ServiceName %>,
-    public i18n: I18nService,
-  ) {}
-
-  @Post('validator')
-  async getCreateRules(): Promise<any> {
-    return targetConstructorToSchema(dto.create, this.i18n);
-  }
-
-  @Put('validator')
-  async getUpdateRules(): Promise<any> {
-    return targetConstructorToSchema(dto.update, this.i18n);
-  }
-
-  @Delete('/bulk')
-  @ApiBody({ type: BulkIdDto })
-  @ApiOperation({ summary: 'bulk deletion of records' })
-  async deleteBulk(@Body() bulkId: BulkIdDto) {
-    return await this.service.deleteBulk(bulkId);
-  }
-}

package/.hygen/new/crud/create.dto.ejs.t

@@ -1,12 +0,0 @@
----
-to: "src/modules/<%= h.fileName(name) %>/requests/<%= h.createDtoFileName(name) %>.ts"
-unless_exists: true
-skip_if: <%= !blocks.includes('CreateDTO') %>
----
-<%
-
- ClassName = h.ClassName(name);
- CreateDtoName = h.CreateDtoName(name);
-
-%>import { <%= EntityName %> } from '../<%= entityFileName %>';
-export class <%= CreateDtoName %> extends <%= EntityName %> {}

package/.hygen/new/crud/entity.ejs.t

@@ -1,26 +0,0 @@
----
-to: "src/modules/<%= h.fileName(name) %>/<%= h.entityFileName(name) %>.ts"
-unless_exists: true
-skip_if: <%= !blocks.includes('Entity') %>
----
-<%
- ClassName = h.ClassName(name);
- DtoName = h.DtoName(name);
- fieldName = h.changeCase.camel(ClassName);
- dtoFileName = h.dtoFileName(name);
- translationEntityFileName = h.translationEntityFileName(name);
- DtoOptionName = h.DtoOptionName(name);
- TableName = h.TableName(name);
- EntityName = h.EntityName(name);
- TranslationEntityName = h.TranslationEntityName(name);
- translationEntityName = h.changeCase.camel(TranslationEntityName);
-%>import { Entity, Column } from 'typeorm';
-import { StringField } from '@nest-omni/core';
-import { AbstractEntity } from '@nest-omni/core/common/abstract.entity';
-
-@Entity({ name: '<%= TableName %>' })
-export class <%= EntityName %> extends AbstractEntity {
-  @Column({ type: 'varchar', nullable: false })
-  @StringField()
-  name: string;
-}

package/.hygen/new/crud/get.dto.ejs.t

@@ -1,19 +0,0 @@
----
-to: "src/modules/<%= h.fileName(name) %>/responses/get-<%= h.dtoFileName(name) %>.ts"
-unless_exists: true
-skip_if: <%= !blocks.includes('DTO') %>
----
-<%
-
- DtoName = h.DtoName(name);
- DtoOptionName = h.DtoOptionName(name);
- EntityName = h.EntityName(name);
- entityName = h.changeCase.camel(EntityName);
- entityFileName = h.entityFileName(name);
-
-  GetDtoName = 'Get' + DtoName;
-  getDtoFileName = 'get-' + dtoFileName;
-
-%>import { <%= EntityName %> } from '../<%= entityFileName %>';
-
-export class <%= GetDtoName %> extends <%= EntityName %> {}

package/.hygen/new/crud/index-dto.ejs.t

@@ -1,29 +0,0 @@
----
-to: "src/modules/<%= h.fileName(name) %>/requests/index.ts"
-unless_exists: true
-skip_if: <%= !blocks.includes('DTO') %>
----
-<%
-
- DtoName = h.DtoName(name);
- DtoOptionName = h.DtoOptionName(name);
-
- CreateDtoName = h.CreateDtoName(name);
- createDtoName = h.changeCase.camel(CreateDtoName);
- UpdateDtoName = h.UpdateDtoName(name);
- updateDtoName = h.changeCase.camel(UpdateDtoName);
-
- createDtoFileName = h.createDtoFileName(name);
- updateDtoFileName = h.updateDtoFileName(name);
-
- EntityName = h.EntityName(name);
- entityName = h.changeCase.camel(EntityName);
- entityFileName = h.entityFileName(name);
-
-%>import { <%= CreateDtoName %> } from './<%= createDtoFileName %>';
-import { <%= UpdateDtoName %> } from './<%= updateDtoFileName %>';
-
-export const dto = {
-  create: <%= CreateDtoName %>,
-  update: <%= UpdateDtoName %>,
-};

package/.hygen/new/crud/index-response.dto.ejs.t

@@ -1,18 +0,0 @@
----
-to: "src/modules/<%= h.fileName(name) %>/responses/index.ts"
-unless_exists: true
-skip_if: <%= !blocks.includes('DTO') %>
----
-<%
-
- DtoName = h.DtoName(name);
- dtoFileName = h.dtoFileName(name);
-
- GetDtoName = 'Get' + DtoName;
- getDtoFileName = 'get-' + dtoFileName;
-
-%>import { <%= GetDtoName %> } from './<%= getDtoFileName %>';
-
-export const serialize = {
-  get: <%= GetDtoName %>,
-};

package/.hygen/new/crud/module.ejs.t

@@ -1,32 +0,0 @@
----
-to: "src/modules/<%= h.fileName(name) %>/<%= h.moduleFileName(name) %>.ts"
-unless_exists: true
----
-<%
-
- ModuleName = h.ModuleName(name);
- fileName = h.inflection.dasherize(name);
-
- ControllerName = h.ControllerName(name);
- controllerFileName = h.controllerFileName(name);
-
- ServiceName = h.ServiceName(name);
- serviceFileName = h.serviceFileName(name);
-
-  EntityName = h.EntityName(name);
-  entityName = h.changeCase.camel(EntityName);
-  entityFileName = h.entityFileName(name);
-
-%>import { Module } from '@nestjs/common';
-import { TypeOrmModule } from '@nestjs/typeorm';
-
-import { <%= ControllerName %> } from './<%= controllerFileName %>';
-import { <%= EntityName %> } from './<%= entityFileName %>';
-import { <%= ServiceName %> } from './<%= serviceFileName %>';
-
-@Module({
-  imports: [TypeOrmModule.forFeature([<%= EntityName %>])],
-  providers: [<%= ServiceName %>],
-  controllers: [<%= ControllerName %>],
-})
-export class <%= ModuleName %> {}

package/.hygen/new/crud/prompt.js

@@ -1,89 +0,0 @@
-'use strict'
-
-module.exports = {
-  prompt: ({ prompter, args }) => {
-    return prompter.prompt([
-      {
-        type: 'input',
-        name: 'name',
-        message: 'Name:',
-        validate(value) {
-          if (!value.length) {
-            return 'Module must have a name.';
-          }
-          return true;
-        },
-      },
-      {
-        type: 'MultiSelect',
-        name: 'blocks',
-        message: 'Blocks:',
-        initial: [
-          'Controller',
-          'CreateCommand',
-          'CreateDTO',
-          'DTO',
-          'Entity',
-          'GetQuery',
-          //'Module',
-          // 'NotFoundException',
-          'PageOptionsDTO',
-          'Repository',
-          'Service',
-          'UpdateDTO'
-        ],
-        choices: [
-          {
-            name: 'Controller',
-            value: 'controller',
-          },
-          {
-            name: 'CreateCommand',
-            value: 'create-command',
-          },
-          {
-            name: 'CreateDTO',
-            value: 'create-dto',
-          },
-          {
-            name: 'DTO',
-            value: 'dto',
-          },
-          {
-            name: 'Entity',
-            value: 'entity',
-          },
-          {
-            name: 'GetQuery',
-            value: 'get-query',
-          },
-          {
-            name: 'NotFoundException',
-            value: 'not-found-exception',
-          },
-          {
-            name: 'PageOptionsDTO',
-            value: 'page-options-dto',
-          },
-          {
-            name: 'Repository',
-            value: 'repository',
-          },
-          {
-            name: 'Service',
-            value: 'service',
-          },
-          {
-            name: 'UpdateDTO',
-            value: 'update-dto',
-          },
-        ],
-      }
-    ])
-    .then(answer => {
-      //// For debugging
-      // console.log(answer)
-      return answer;
-    })
-  }
-}

package/.hygen/new/crud/service.ejs.t

@@ -1,76 +0,0 @@
----
-to: "src/modules/<%= h.fileName(name) %>/<%= h.serviceFileName(name) %>.ts"
-unless_exists: true
-skip_if: <%= !blocks.includes('Service') %>
----
-<%
-
- ClassName = h.ClassName(name);
- fieldName = h.changeCase.camel(ClassName);
-
- DtoName = h.DtoName(name);
- dtoFileName = h.dtoFileName(name);
-
-
- CreateCommandName = h.CreateCommandName(name);
- createCommandFileName = h.createCommandFileName(name);
-
-
- EntityName = h.EntityName(name);
- entityName = h.changeCase.camel(EntityName);
- entityFileName = h.entityFileName(name);
-
- ServiceName = h.ServiceName(name);
-
- UpdateDtoName = h.UpdateDtoName(name);
- updateDtoFileName = h.updateDtoFileName(name);
- updateDtoName = h.changeCase.camel(UpdateDtoName);
-
- fileName = h.fileName(name);
-
- RepositoryName = h.RepositoryName(name);
- repositoryName = h.changeCase.camel(RepositoryName);
- repositoryFileName = h.repositoryFileName(name);
-
- NotFoundExceptionName = h.NotFoundExceptionName(name);
- notFoundExceptionFileName = h.notFoundExceptionFileName(name);
-
- createFunctionName = 'create' + ClassName;
- updateFunctionName = 'update' + ClassName;
- deleteFunctionName = 'delete' + ClassName;
- getAllFunctionName = 'getAll' + ClassName;
- getSingleFunctionName = 'getSingle' + ClassName;
- controllerName = moduleName + 'Controller';
- serviceName = moduleName + 'Service';
- CreateDtoName = h.CreateDtoName(name);
- createDtoFileName = h.createDtoFileName(name);
-
- PageOptionsDtoName = h.PageOptionsDtoName(name);
- pageOptionsDtoName = h.changeCase.camel(PageOptionsDtoName);
- pageOptionsDtoFileName = h.pageOptionsDtoFileName(name);
-
-%>import { Injectable } from '@nestjs/common';
-import { InjectRepository } from '@nestjs/typeorm';
-import { TypeOrmCrudService } from '@dataui/crud-typeorm';
-import { I18nService } from 'nestjs-i18n';
-import { BulkIdDto } from '@nest-omni/core/common/dto/bulk-id.dto';
-import { Repository } from 'typeorm';
-import { <%= EntityName %> } from './<%= entityFileName %>';
-
-@Injectable()
-export class <%= ServiceName %> extends TypeOrmCrudService<<%= EntityName %>> {
-  constructor(
-    @InjectRepository(<%= EntityName %>) repo: Repository<<%= EntityName %>>,
-    public i18n: I18nService,
-  ) {
-    super(repo);
-  }
-
-  async deleteBulk(bulkIdDto: BulkIdDto) {
-    return this.repo
-      .createQueryBuilder()
-      .delete()
-      .andWhereInIds(bulkIdDto.id)
-      .execute();
-  }
-}

package/.hygen/new/crud/update.dto.ejs.t

@@ -1,11 +0,0 @@
----
-to: "src/modules/<%= h.fileName(name) %>/requests/<%= h.updateDtoFileName(name) %>.ts"
-unless_exists: true
-skip_if: <%= !blocks.includes('UpdateDTO') %>
----
-<%
-
-UpdateDtoName = h.UpdateDtoName(name);
-
-%>import { <%= EntityName %> } from '../<%= entityFileName %>';
-export class <%= UpdateDtoName %> extends <%= EntityName %> {}