@nest-omni/core 1.0.2 → 1.0.5

package/{dist → src}/providers/generator.provider.js

@@ -40,6 +40,10 @@ class GeneratorProvider {
         }
         return text;
     }
+    /**
+     * generate random string
+     * @param length
+     */
     static generateRandomString(length) {
         return Math.random()
             .toString(36)
@@ -48,4 +52,3 @@ class GeneratorProvider {
     }
 }
 exports.GeneratorProvider = GeneratorProvider;
-//# sourceMappingURL=generator.provider.js.map

package/src/providers/generator.provider.ts

@@ -0,0 +1,66 @@
+import { v1 as uuid } from 'uuid';
+
+export class GeneratorProvider {
+  static uuid(): string {
+    return uuid();
+  }
+
+  static fileName(ext: string): string {
+    return GeneratorProvider.uuid() + '.' + ext;
+  }
+
+  static getS3PublicUrl(key: string): string {
+    if (!key) {
+      throw new TypeError('key is required');
+    }
+
+    return `https://s3.${process.env.AWS_S3_BUCKET_NAME_REGION}.amazonaws.com/${process.env.AWS_S3_BUCKET_NAME}/${key}`;
+  }
+
+  static getS3Key(publicUrl: string): string {
+    if (!publicUrl) {
+      throw new TypeError('key is required');
+    }
+
+    const exec = new RegExp(
+      `(?<=https://s3.${process.env.AWS_S3_BUCKET_NAME_REGION}.amazonaws.com/${process.env.AWS_S3_BUCKET_NAME}/).*`,
+    ).exec(publicUrl);
+
+    if (!exec) {
+      throw new TypeError('publicUrl is invalid');
+    }
+
+    return exec[0];
+  }
+
+  static generateVerificationCode(): string {
+    return Math.floor(1000 + Math.random() * 9000).toString();
+  }
+
+  static generatePassword(): string {
+    const lowercase = 'abcdefghijklmnopqrstuvwxyz';
+    const uppercase = lowercase.toUpperCase();
+    const numbers = '0123456789';
+
+    let text = '';
+
+    for (let i = 0; i < 12; i++) {
+      text += uppercase.charAt(Math.floor(Math.random() * uppercase.length));
+      text += lowercase.charAt(Math.floor(Math.random() * lowercase.length));
+      text += numbers.charAt(Math.floor(Math.random() * numbers.length));
+    }
+
+    return text;
+  }
+
+  /**
+   * generate random string
+   * @param length
+   */
+  static generateRandomString(length: number): string {
+    return Math.random()
+      .toString(36)
+      .replace(/[^\dA-Za-z]+/g, '')
+      .slice(0, Math.max(0, length));
+  }
+}

package/{dist → src}/providers/index.js

@@ -16,4 +16,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./context.provider"), exports);
 __exportStar(require("./generator.provider"), exports);
-//# sourceMappingURL=index.js.map

package/src/providers/index.ts

@@ -0,0 +1,2 @@
+export * from './context.provider';
+export * from './generator.provider';

package/src/setup/bootstrap.setup.js

@@ -0,0 +1,138 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+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 });
+exports.bootstrapSetup = void 0;
+const core_1 = require("@nestjs/core");
+const typeorm_transactional_1 = require("typeorm-transactional");
+const skywalking_backend_js_1 = __importDefault(require("skywalking-backend-js"));
+const nestjs_pino_1 = require("nestjs-pino");
+const session = __importStar(require("express-session"));
+const path_1 = require("path");
+const core_2 = require("@omni/core");
+const common_1 = require("@nestjs/common");
+const nestjs_sentry_1 = require("@ntegral/nestjs-sentry");
+const nestjs_i18n_1 = require("nestjs-i18n");
+const crud_1 = require("@dataui/crud");
+const auth_user_interceptor_1 = require("../interceptors/auth-user.interceptor");
+const nestjs_cls_1 = require("nestjs-cls");
+crud_1.CrudConfigService.load({
+    auth: {
+        property: 'user',
+    },
+    params: {
+        id: {
+            field: 'id',
+            type: 'string',
+            primary: true,
+        },
+    },
+    query: {
+        limit: 10,
+        alwaysPaginate: true,
+    },
+    routes: {
+        updateOneBase: {
+            allowParamsOverride: false,
+        },
+        deleteOneBase: {
+            returnDeleted: false,
+        },
+        createOneBase: {
+            returnShallow: false,
+        },
+    },
+});
+function bootstrapSetup(AppModule, SetupSwagger) {
+    return __awaiter(this, void 0, void 0, function* () {
+        (0, typeorm_transactional_1.initializeTransactionalContext)();
+        const app = yield core_1.NestFactory.create(AppModule, {
+            bufferLogs: true,
+        });
+        const configService = app.select(core_2.ServiceRegistryModule).get(core_2.ApiConfigService);
+        app.useLogger(app.get(nestjs_pino_1.Logger));
+        app.flushLogs();
+        app.enableShutdownHooks();
+        app.enableVersioning();
+        app.enable('trust proxy');
+        const reflector = app.get(core_1.Reflector);
+        app.useGlobalFilters(new core_2.HttpExceptionFilter(), new core_2.QueryFailedFilter(reflector));
+        app.use(new nestjs_cls_1.ClsMiddleware({}).use, (0, core_2.RequestIdMiddleware)(), (0, core_2.PowerByMiddleware)(), (0, core_2.OmniAuthMiddleware)());
+        app.useStaticAssets('public', { prefix: '/' });
+        app.useGlobalInterceptors(new auth_user_interceptor_1.AuthUserInterceptor(), new core_2.TranslationInterceptor(), new nestjs_pino_1.LoggerErrorInterceptor(), new nestjs_sentry_1.SentryInterceptor({
+            filters: [
+                {
+                    type: common_1.HttpException,
+                    filter: (exception) => {
+                        const status = exception.getStatus();
+                        if (status === 401 || status === 404) {
+                            return true;
+                        }
+                        return 200 > status;
+                    },
+                },
+            ],
+        }));
+        app.useGlobalPipes(new nestjs_i18n_1.I18nValidationPipe({
+            whitelist: true,
+            errorHttpStatusCode: common_1.HttpStatus.UNPROCESSABLE_ENTITY,
+            transform: true,
+            stopAtFirstError: true,
+            validationError: { target: false, value: false },
+        }));
+        if (configService.skywalkingEnabled) {
+            skywalking_backend_js_1.default.start();
+        }
+        if (configService.documentationEnabled && SetupSwagger) {
+            SetupSwagger(app, configService.documentationPath);
+        }
+        if (configService.viewsEnabled) {
+            app.setBaseViewsDir((0, path_1.join)(__dirname, 'views'));
+            app.setViewEngine('ejs');
+        }
+        if (configService.sessionEnabled) {
+            app.use(session(configService.sessionConfig));
+        }
+        if (configService.corsEnabled) {
+            app.enableCors(configService.corsConfig);
+        }
+        const port = configService.appConfig.port;
+        yield app.listen(port);
+        console.info(`server running on ${yield app.getUrl()}`);
+        return app;
+    });
+}
+exports.bootstrapSetup = bootstrapSetup;

package/src/setup/bootstrap.setup.ts

@@ -0,0 +1,139 @@
+import { NestFactory, Reflector } from '@nestjs/core';
+import type { NestExpressApplication } from '@nestjs/platform-express';
+import { initializeTransactionalContext } from 'typeorm-transactional';
+import agent from 'skywalking-backend-js';
+import { Logger, LoggerErrorInterceptor } from 'nestjs-pino';
+import * as session from 'express-session';
+import { join } from 'path';
+import {
+  ApiConfigService,
+  HttpExceptionFilter,
+  OmniAuthMiddleware,
+  PowerByMiddleware,
+  QueryFailedFilter,
+  RequestIdMiddleware,
+  ServiceRegistryModule,
+  TranslationInterceptor,
+} from '../';
+import { HttpException, HttpStatus } from '@nestjs/common';
+import { SentryInterceptor } from '@ntegral/nestjs-sentry';
+import { I18nValidationPipe } from 'nestjs-i18n';
+import { CrudConfigService } from '@dataui/crud';
+import { AuthUserInterceptor } from '../interceptors/auth-user.interceptor';
+import { ClsMiddleware } from 'nestjs-cls';
+
+CrudConfigService.load({
+  auth: {
+    property: 'user',
+  },
+  params: {
+    id: {
+      field: 'id',
+      type: 'string',
+      primary: true,
+    },
+  },
+  query: {
+    limit: 10,
+    alwaysPaginate: true,
+  },
+  routes: {
+    updateOneBase: {
+      allowParamsOverride: false,
+    },
+    deleteOneBase: {
+      returnDeleted: false,
+    },
+    createOneBase: {
+      returnShallow: false,
+    },
+  },
+});
+
+export async function bootstrapSetup(AppModule, SetupSwagger) {
+  initializeTransactionalContext();
+  const app = await NestFactory.create<NestExpressApplication>(AppModule, {
+    bufferLogs: true,
+  });
+  const configService = app.select(ServiceRegistryModule).get(ApiConfigService);
+
+  app.useLogger(app.get(Logger));
+  app.flushLogs();
+  app.enableShutdownHooks();
+  app.enableVersioning();
+  app.enable('trust proxy');
+
+  const reflector = app.get(Reflector);
+
+  app.useGlobalFilters(
+    new HttpExceptionFilter(),
+    new QueryFailedFilter(reflector),
+  );
+
+  app.use(
+    new ClsMiddleware({}).use,
+    RequestIdMiddleware(),
+    PowerByMiddleware(),
+    OmniAuthMiddleware(),
+  );
+
+  app.useStaticAssets('public', { prefix: '/' });
+
+  app.useGlobalInterceptors(
+    new AuthUserInterceptor(),
+    new TranslationInterceptor(),
+    new LoggerErrorInterceptor(),
+    new SentryInterceptor({
+      filters: [
+        {
+          type: HttpException,
+          filter: (exception: HttpException) => {
+            const status = exception.getStatus();
+            if (status === 401 || status === 404) {
+              return true;
+            }
+
+            return 200 > status;
+          },
+        },
+      ],
+    }),
+  );
+
+  app.useGlobalPipes(
+    new I18nValidationPipe({
+      whitelist: true,
+      errorHttpStatusCode: HttpStatus.UNPROCESSABLE_ENTITY,
+      transform: true,
+      stopAtFirstError: true,
+      validationError: { target: false, value: false },
+    }),
+  );
+
+  if (configService.skywalkingEnabled) {
+    agent.start();
+  }
+
+  if (configService.documentationEnabled && SetupSwagger) {
+    SetupSwagger(app, configService.documentationPath);
+  }
+
+  if (configService.viewsEnabled) {
+    app.setBaseViewsDir(join(__dirname, 'views'));
+    app.setViewEngine('ejs');
+  }
+
+  if (configService.sessionEnabled) {
+    app.use(session(configService.sessionConfig));
+  }
+
+  if (configService.corsEnabled) {
+    app.enableCors(configService.corsConfig);
+  }
+
+  const port = configService.appConfig.port;
+  await app.listen(port);
+
+  console.info(`server running on ${await app.getUrl()}`);
+  return app;
+}

package/{dist → src}/setup/index.js

@@ -15,4 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./bootstrap.setup"), exports);
-//# sourceMappingURL=index.js.map

package/src/setup/index.ts

@@ -0,0 +1 @@
+export * from './bootstrap.setup';

package/src/setup/microservices.setup.js

@@ -0,0 +1,55 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.microserviceSetup = void 0;
+const common_1 = require("@nestjs/common");
+const microservices_1 = require("@nestjs/microservices");
+const core_1 = require("@nestcloud/core");
+const path_1 = require("path");
+const common_2 = require("@omni/common");
+function microserviceSetup(app, protoPath, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { hostname = '0.0.0.0', enableMqtt, enableNats } = options;
+        common_2.AppUtils.killAppWithGrace(app);
+        app.connectMicroservice({
+            transport: microservices_1.Transport.GRPC,
+            options: {
+                url: `${hostname}:${core_1.NestCloud.global.boot.get('service.port')}`,
+                package: core_1.NestCloud.global.boot.get('service.name'),
+                protoPath: (0, path_1.join)(process.cwd(), `/dist/libs/proto-schema/${protoPath}`),
+            },
+        });
+        if (enableMqtt) {
+            app.connectMicroservice({
+                transport: microservices_1.Transport.MQTT,
+                options: {
+                    url: core_1.NestCloud.global.boot.get('mqtt.url'),
+                    clientId: core_1.NestCloud.global.boot.get('service.name') +
+                        Math.random().toString(16).substr(2, 8),
+                },
+            });
+        }
+        if (enableNats) {
+            app.connectMicroservice({
+                transport: microservices_1.Transport.NATS,
+                options: {
+                    url: core_1.NestCloud.global.boot.get('nats.url'),
+                    queue: 'd4_srv_queue',
+                },
+            });
+        }
+        yield app.startAllMicroservicesAsync();
+        common_1.Logger.log(`GRPC ${core_1.NestCloud.global.boot.get('service.name')} running on port: ${core_1.NestCloud.global.boot.get('service.port')}`, 'Bootstrap');
+        yield app.listen(null);
+        common_1.Logger.log(`REST ${core_1.NestCloud.global.boot.get('service.name')} running on: ${yield app.getUrl()}`, 'Bootstrap');
+    });
+}
+exports.microserviceSetup = microserviceSetup;

package/{dist → src}/setup-swagger.js

@@ -60,4 +60,3 @@ Routes is following REST standard (Richardson level 3)
     console.info(`Documentation: http://localhost:${process.env.PORT}/documentation`);
 }
 exports.setupSwagger = setupSwagger;
-//# sourceMappingURL=setup-swagger.js.map

package/src/setup-swagger.ts

@@ -0,0 +1,67 @@
+import type { INestApplication } from '@nestjs/common';
+import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
+
+export function setupSwagger(app: INestApplication): void {
+  const documentBuilder = new DocumentBuilder()
+    .setTitle('API')
+    .setDescription(
+      `### REST
+
+Routes is following REST standard (Richardson level 3)
+
+<details><summary>Detailed specification</summary>
+<p>
+
+**List:**
+  - \`GET /<resource>/\`
+    - Get the list of **<resource>** as admin
+  - \`GET /user/<user_id>/<resource>/\`
+    - Get the list of **<resource>** for a given **<user_id>**
+    - Output a **403** if logged user is not **<user_id>**
+
+**Detail:**
+  - \`GET /<resource>/<resource_id>\`
+    - Get the detail for **<resource>** of id **<resource_id>**
+    - Output a **404** if not found
+  - \`GET /user/<user_id>/<resource>/<resource_id>\`
+    - Get the list of **<resource>** for a given **user_id**
+    - Output a **404** if not found
+    - Output a **403** if:
+      - Logged user is not **<user_id>**
+      - The **<user_id>** have no access to **<resource_id>**
+
+**Creation / Edition / Replacement / Suppression:**
+  - \`<METHOD>\` is:
+    - **POST** for creation
+    - **PATCH** for update (one or more fields)
+    - **PUT** for replacement (all fields, not used)
+    - **DELETE** for suppression (all fields, not used)
+  - \`<METHOD> /<resource>/<resource_id>\`
+    - Create **<resource>** with id **<resource_id>** as admin
+    - Output a **400** if **<resource_id>** conflicts with existing **<resource>**
+  - \`<METHOD> /user/<user_id>/<resource>/<resource_id>\`
+    - Create **<resource>** with id **<resource_id>** as a given **user_id**
+    - Output a **409** if **<resource_id>** conflicts with existing **<resource>**
+    - Output a **403** if:
+      - Logged user is not **<user_id>**
+      - The **<user_id>** have no access to **<resource_id>**
+</p>
+</details>`,
+    )
+    .addBearerAuth();
+
+  if (process.env.API_VERSION) {
+    documentBuilder.setVersion(process.env.API_VERSION);
+  }
+
+  const document = SwaggerModule.createDocument(app, documentBuilder.build());
+  SwaggerModule.setup('documentation', app, document, {
+    swaggerOptions: {
+      persistAuthorization: true,
+    },
+  });
+
+  console.info(
+    `Documentation: http://localhost:${process.env.PORT}/documentation`,
+  );
+}

package/{dist → src}/shared/index.js

@@ -16,4 +16,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./serviceRegistryModule"), exports);
 __exportStar(require("./services"), exports);
-//# sourceMappingURL=index.js.map

package/src/shared/index.ts

@@ -0,0 +1,2 @@
+export * from './serviceRegistryModule';
+export * from './services';