@lenne.tech/nest-server 8.6.6 → 8.6.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenne.tech/nest-server",
-  "version": "8.6.6",
+  "version": "8.6.9",
   "description": "Modern, fast, powerful Node.js web framework in TypeScript based on Nest with a GraphQL API and a connection to MongoDB (or other databases).",
   "keywords": [
     "node",
@@ -26,8 +26,9 @@
     "reinit": "rimraf package-lock.json && rimraf node_modules && npm cache clean --force && npm i && npm run test:e2e && npm run build",
     "reinit:force": "rimraf package-lock.json && rimraf node_modules && npm cache clean --force && npm i --force && npm run test:e2e",
     "reinit:legacy": "rimraf package-lock.json && rimraf node_modules && npm cache clean --force && npm i --legacy-peer-deps && npm run test:e2e",
-    "start": "./node_modules/.bin/grunt",
+    "start": "npm run start:dev",
     "stop": "./node_modules/.bin/pm2 delete nest",
+    "start:pm2": "./node_modules/.bin/grunt",
     "start:prod": "./node_modules/.bin/grunt productive",
     "start:nodemon": "ts-node -r tsconfig-paths/register src/main.ts",
     "start:debug": "nodemon --config nodemon-debug.json",
@@ -56,54 +57,55 @@
     "node": ">= 16.13.0"
   },
   "dependencies": {
-    "@apollo/gateway": "0.50.2",
-    "@nestjs/apollo": "10.0.12",
-    "@nestjs/common": "8.4.5",
-    "@nestjs/core": "8.4.5",
-    "@nestjs/graphql": "10.0.12",
+    "@apollo/gateway": "2.0.5",
+    "@nestjs/apollo": "10.0.16",
+    "@nestjs/common": "8.4.7",
+    "@nestjs/core": "8.4.7",
+    "@nestjs/graphql": "10.0.16",
     "@nestjs/jwt": "8.0.1",
-    "@nestjs/mongoose": "9.1.0",
-    "@nestjs/passport": "8.2.1",
-    "@nestjs/platform-express": "8.4.5",
-    "apollo-server-core": "3.7.0",
-    "apollo-server-express": "3.7.0",
+    "@nestjs/mongoose": "9.1.1",
+    "@nestjs/passport": "8.2.2",
+    "@nestjs/platform-express": "8.4.7",
+    "apollo-server-core": "3.9.0",
+    "apollo-server-express": "3.9.0",
     "bcrypt": "5.0.1",
     "class-transformer": "0.5.1",
     "class-validator": "0.13.2",
     "ejs": "3.1.8",
     "graphql": "16.5.0",
     "graphql-subscriptions": "2.0.0",
-    "graphql-upload": "13.0.0",
+    "graphql-upload": "15.0.1",
     "json-to-graphql-query": "2.2.4",
     "light-my-request": "5.0.0",
     "lodash": "4.17.21",
-    "mongodb": "4.6.0",
-    "mongoose": "6.3.4",
+    "mongodb": "4.7.0",
+    "mongoose": "6.3.9",
+    "mongoose-gridfs": "1.3.0",
     "multer": "1.4.4",
     "node-mailjet": "3.4.1",
     "nodemailer": "6.7.5",
     "nodemon": "2.0.16",
-    "passport": "0.5.3",
+    "passport": "0.6.0",
     "passport-jwt": "4.0.0",
     "reflect-metadata": "0.1.13",
     "rimraf": "3.0.2",
     "rxjs": "7.5.5"
   },
   "devDependencies": {
-    "@nestjs/testing": "8.4.5",
+    "@nestjs/testing": "8.4.7",
     "@types/ejs": "3.1.1",
-    "@types/jest": "27.5.1",
+    "@types/jest": "28.1.3",
     "@types/lodash": "4.14.182",
     "@types/multer": "1.4.7",
-    "@types/node": "16.11.36",
+    "@types/node": "18.0.0",
     "@types/node-mailjet": "3.3.9",
     "@types/nodemailer": "6.4.4",
-    "@types/passport": "1.0.7",
+    "@types/passport": "1.0.9",
     "@types/supertest": "2.0.12",
-    "@typescript-eslint/eslint-plugin": "5.25.0",
-    "@typescript-eslint/parser": "5.25.0",
+    "@typescript-eslint/eslint-plugin": "5.29.0",
+    "@typescript-eslint/parser": "5.29.0",
     "coffeescript": "2.7.0",
-    "eslint": "8.16.0",
+    "eslint": "8.18.0",
     "eslint-config-prettier": "8.5.0",
     "find-file-up": "2.0.1",
     "grunt": "1.5.3",
@@ -112,16 +114,16 @@
     "grunt-contrib-watch": "1.1.0",
     "grunt-sync": "0.8.2",
     "husky": "8.0.1",
-    "jest": "28.1.0",
+    "jest": "28.1.1",
     "pm2": "5.2.0",
-    "prettier": "2.6.2",
+    "prettier": "2.7.1",
     "pretty-quick": "3.1.3",
     "supertest": "6.2.3",
-    "ts-jest": "28.0.2",
-    "ts-morph": "14.0.0",
-    "ts-node": "10.8.0",
+    "ts-jest": "28.0.5",
+    "ts-morph": "15.1.0",
+    "ts-node": "10.8.1",
     "tsconfig-paths": "4.0.0",
-    "typescript": "4.6.4"
+    "typescript": "4.7.4"
   },
   "jest": {
     "collectCoverage": true,

package/src/core/common/helpers/db.helper.ts

@@ -423,7 +423,9 @@ export function removeUnresolvedReferences<T = any>(
   if (typeof populated === 'object') {
     // populatedOptions is an array
     if (Array.isArray(populatedOptions)) {
-      populatedOptions.forEach((po) => removeUnresolvedReferences(populated, ignoreFirst ? po.populate : po, false));
+      populatedOptions.forEach((po) =>
+        removeUnresolvedReferences(populated, ignoreFirst && typeof po === 'object' ? po.populate : po, false)
+      );
       return populated;
     }
 
@@ -462,12 +464,17 @@ export async function popAndMap<T extends CoreModel>(
   let result;
   let populateOptions: PopulateOptions[] = [];
   if (populate) {
-    if (Array.isArray(populate) && typeof (populate as PopulateOptions[])[0]?.path === 'string') {
+    if (
+      Array.isArray(populate) &&
+      (typeof (populate as string[])[0] === 'string' || typeof (populate as PopulateOptions[])[0]?.path === 'string')
+    ) {
       populateOptions = populate as PopulateOptions[];
     } else if (Array.isArray(populate) && typeof (populate as SelectionNode[])[0]?.kind === 'string') {
       populateOptions = getPopulatOptionsFromSelections(populate as SelectionNode[]);
     } else if ((populate as ResolveSelector).info) {
       populateOptions = getPopulateOptions((populate as ResolveSelector).info, (populate as ResolveSelector).select);
+    } else if (typeof populate === 'string' || (populate as PopulateOptions).path) {
+      populateOptions = [populate as PopulateOptions];
     }
   }
   if (queryOrDocument instanceof Query) {

package/src/core/common/helpers/filter.helper.ts

@@ -139,7 +139,13 @@ export function generateFilterQuery<T = any>(filter?: Partial<FilterInput>): Fil
   // Process single filter
   if (filter.singleFilter) {
     // Init variables
-    const { not, options, field, value } = filter.singleFilter;
+    const { not, options, field, convertToObjectId } = filter.singleFilter;
+    let value = filter.singleFilter.value;
+
+    // Convert value to object ID(s)
+    if (convertToObjectId) {
+      value = getObjectIds(value);
+    }
 
     // Convert filter
     switch (filter.singleFilter.operator) {

package/src/core/common/helpers/model.helper.ts

@@ -1,4 +1,6 @@
+import { plainToInstance } from 'class-transformer';
 import * as _ from 'lodash';
+import { Types } from 'mongoose';
 
 /**
  * Helper class for models
@@ -150,3 +152,153 @@ export function maps<T = Record<string, any>>(
     return (targetClass as any).map(item, { cloneDeep });
   });
 }
+
+/**
+ * It takes an object, a mapping of properties to classes, and returns a new object with the properties mapped to instances
+ * of the classes
+ * @param input - The input object to map
+ * @param mapping - A mapping of property names to classes
+ * @param [target] - The object to map the input to. If not provided, a new object will be created
+ * @returns Record with mapped objects
+ */
+export function mapClasses<T = Record<string, any>>(
+  input: Record<string, any>,
+  mapping: Record<string, new (...args: any[]) => any>,
+  target?: T
+): T {
+  // Check params
+  if (!target) {
+    target = {} as T;
+  }
+  if (!input || !mapping) {
+    return target;
+  }
+
+  // Process input
+  for (const [prop, value] of Object.entries(input)) {
+    if (prop in mapping) {
+      const targetClass = mapping[prop] as any;
+
+      // Process array
+      if (Array.isArray(value)) {
+        const arr = [];
+        for (const item of value) {
+          if (value instanceof targetClass) {
+            arr.push(value);
+          }
+          if (value instanceof Types.ObjectId) {
+            arr.push(value);
+          } else if (typeof value === 'object') {
+            if (targetClass.map) {
+              arr.push(targetClass.map(item));
+            } else if (typeof value === 'object') {
+              arr.push(plainToInstance(targetClass, item));
+            }
+          } else {
+            arr.push(value);
+          }
+        }
+        target[prop] = arr as any;
+      }
+
+      // Process ObjectId
+      else if (value instanceof Types.ObjectId) {
+        target[prop] = value as any;
+      }
+
+      // Process object
+      else if (typeof value === 'object') {
+        if (value instanceof targetClass) {
+          target[prop] = value as any;
+        }
+        if (targetClass.map) {
+          target[prop] = targetClass.map(value);
+        } else {
+          target[prop] = plainToInstance(targetClass, value) as any;
+        }
+      }
+
+      // Others
+      else {
+        target[prop] = value;
+      }
+    }
+  }
+
+  return target;
+}
+
+/**
+ * It takes an object, a mapping of properties to classes, and returns a new object with the properties mapped to instances
+ * of the classes async
+ * @param input - The input object to map
+ * @param mapping - A mapping of property names to classes
+ * @param [target] - The object to map the input to. If not provided, a new object will be created
+ * @returns Record with mapped objects
+ */
+export async function mapClassesAsync<T = Record<string, any>>(
+  input: Record<string, any>,
+  mapping: Record<string, new (...args: any[]) => any>,
+  target?: T
+): Promise<T> {
+  // Check params
+  if (!target) {
+    target = {} as T;
+  }
+  if (!input || !mapping) {
+    return target;
+  }
+
+  // Process input
+  for (const [prop, value] of Object.entries(input)) {
+    if (prop in mapping) {
+      const targetClass = mapping[prop] as any;
+
+      // Process array
+      if (Array.isArray(value)) {
+        const arr = [];
+        for (const item of value) {
+          if (value instanceof targetClass) {
+            arr.push(value);
+          }
+          if (value instanceof Types.ObjectId) {
+            arr.push(value);
+          } else if (typeof value === 'object') {
+            if (targetClass.map) {
+              arr.push(await targetClass.map(item));
+            } else if (typeof value === 'object') {
+              arr.push(plainToInstance(targetClass, item));
+            }
+          } else {
+            arr.push(value);
+          }
+        }
+        target[prop] = arr as any;
+      }
+
+      // Process ObjectId
+      else if (value instanceof Types.ObjectId) {
+        target[prop] = value as any;
+      }
+
+      // Process object
+      else if (typeof value === 'object') {
+        if (value instanceof targetClass) {
+          target[prop] = value as any;
+        }
+        if (targetClass.map) {
+          target[prop] = await targetClass.map(value);
+        } else {
+          target[prop] = plainToInstance(targetClass, value) as any;
+        }
+      }
+
+      // Others
+      else {
+        target[prop] = value;
+      }
+    }
+  }
+
+  return target;
+}

package/src/core/common/helpers/service.helper.ts

@@ -55,6 +55,7 @@ export async function prepareInput<T = any>(
   currentUser: { [key: string]: any; id: string },
   options: {
     [key: string]: any;
+    checkRoles?: boolean;
     create?: boolean;
     clone?: boolean;
     getNewArray?: boolean;
@@ -148,6 +149,7 @@ export async function prepareOutput<T = { [key: string]: any; map: (...args: any
     [key: string]: any;
     clone?: boolean;
     getNewArray?: boolean;
+    removeSecrets?: boolean;
     removeUndefined?: boolean;
     targetModel?: new (...args: any[]) => T;
   } = {}
@@ -156,6 +158,7 @@ export async function prepareOutput<T = { [key: string]: any; map: (...args: any
   const config = {
     clone: false,
     getNewArray: false,
+    removeSecrets: true,
     removeUndefined: false,
     targetModel: undefined,
     ...options,
@@ -191,17 +194,17 @@ export async function prepareOutput<T = { [key: string]: any; map: (...args: any
   }
 
   // Remove password if exists
-  if (output.password) {
+  if (config.removeSecrets && output.password) {
     output.password = undefined;
   }
 
   // Remove verification token if exists
-  if (output.verificationToken) {
+  if (config.removeSecrets && output.verificationToken) {
     output.verificationToken = undefined;
   }
 
   // Remove password reset token if exists
-  if (output.passwordResetToken) {
+  if (config.removeSecrets && output.passwordResetToken) {
     output.passwordResetToken = undefined;
   }
 

package/src/core/common/inputs/single-filter.input.ts

@@ -9,7 +9,16 @@ import { CoreInput } from './core-input.input';
 @InputType({ description: 'Input for a configuration of a filter' })
 export class SingleFilterInput extends CoreInput {
   /**
-   * Name of the property to be used for the filter'
+   * Convert value to ObjectId
+   */
+  @Field({
+    description: 'Convert value to ObjectId',
+    nullable: true,
+  })
+  convertToObjectId?: boolean = undefined;
+
+  /**
+   * Name of the property to be used for the filter
    */
   @Field({ description: 'Name of the property to be used for the filter' })
   field: string = undefined;

package/src/core/common/interfaces/prepare-input-options.interface.ts

@@ -3,6 +3,7 @@
  */
 export interface PrepareInputOptions {
   [key: string]: any;
+  checkRoles?: boolean;
   create?: boolean;
   clone?: boolean;
   getNewArray?: boolean;

package/src/core/common/interfaces/prepare-output-options.interface.ts

@@ -5,6 +5,7 @@ export interface PrepareOutputOptions {
   [key: string]: any;
   clone?: boolean;
   getNewArray?: boolean;
+  removeSecrets?: boolean;
   removeUndefined?: boolean;
   targetModel?: new (...args: any[]) => any;
 }

package/src/core/common/interfaces/service-options.interface.ts

@@ -1,4 +1,4 @@
-import { Model } from 'mongoose';
+import { Model, PopulateOptions } from 'mongoose';
 import { FieldSelection } from '../types/field-selection.type';
 import { PrepareInputOptions } from './prepare-input-options.interface';
 import { PrepareOutputOptions } from './prepare-output-options.interface';
@@ -22,15 +22,21 @@ export interface ServiceOptions {
     roles?: string[];
   };
 
-  // Field selection for results
+  // Field selection for results (will be overwritten by populate if populate was set)
   fieldSelection?: FieldSelection;
 
+  // Determines whether all restrictions are ignored
+  force?: boolean;
+
   // Overwrites type of input (array items)
   inputType?: new (...params: any[]) => any;
 
   // Overwrites type of output (array items)
   outputType?: new (...params: any[]) => any;
 
+  // Alias for fieldSelection (if both are set fieldSelection is overwritten by populate)
+  populate?: PopulateOptions | (PopulateOptions | string)[];
+
   // Process field selection
   // If {} or not set, then the field selection runs with defaults
   // If falsy, then the field selection will not be automatically executed

package/src/core/common/services/mailjet.service.ts

@@ -1,6 +1,6 @@
 import { Injectable } from '@nestjs/common';
 import { ConfigService } from './config.service';
-import * as mailjet from 'node-mailjet';
+import mailjet from 'node-mailjet';
 
 /**
  * Mailjet service

package/src/core/common/services/module.service.ts

@@ -71,9 +71,10 @@ export abstract class ModuleService<T extends CoreModel = any> {
     }
   ) {
     // Configuration with default values
-    const config = {
+    const config: { dbObject: string | Types.ObjectId | any; input: any } & ServiceOptions = {
       checkRights: true,
       dbObject: options?.dbObject,
+      force: false,
       input: options?.input,
       processFieldSelection: {},
       prepareInput: {},
@@ -82,6 +83,22 @@ export abstract class ModuleService<T extends CoreModel = any> {
       ...options?.serviceOptions,
     };
 
+    // Note force configuration
+    if (config.force) {
+      config.checkRights = false;
+      if (typeof config.prepareInput === 'object') {
+        config.prepareInput.checkRoles = false;
+      }
+      if (typeof config.prepareOutput === 'object') {
+        config.prepareOutput.removeSecrets = false;
+      }
+    }
+
+    // Note populate
+    if (config.populate) {
+      config.fieldSelection = config.populate;
+    }
+
     // Prepare input
     if (config.prepareInput && this.prepareInput) {
       const opts = config.prepareInput;

package/src/core/common/types/field-selection.type.ts

@@ -5,4 +5,4 @@ import { ResolveSelector } from '../interfaces/resolve-selector.interface';
 /**
  * Field selection to set fields of (populated) result
  */
-export type FieldSelection = PopulateOptions[] | SelectionNode[] | ResolveSelector;
+export type FieldSelection = PopulateOptions | (PopulateOptions | string)[] | SelectionNode[] | ResolveSelector;

package/src/core/modules/file/core-file.service.ts

@@ -0,0 +1,179 @@
+import { NotFoundException } from '@nestjs/common';
+import { GridFSBucket, GridFSBucketReadStreamOptions } from 'mongodb';
+import { Connection, Types } from 'mongoose';
+import { createBucket, MongoGridFSOptions, MongooseGridFS } from 'mongoose-gridfs';
+import { FilterArgs } from '../../common/args/filter.args';
+import { getObjectIds, getStringIds } from '../../common/helpers/db.helper';
+import { convertFilterArgsToQuery } from '../../common/helpers/filter.helper';
+import { check } from '../../common/helpers/input.helper';
+import { prepareOutput } from '../../common/helpers/service.helper';
+import { FileInfo } from './file-info.output';
+import { FileServiceOptions } from './interfaces/file-service-options.interface';
+import { FileUpload } from './interfaces/file-upload.interface';
+
+/**
+ * Abstract core file service
+ */
+export abstract class CoreFileService {
+  files: GridFSBucket & MongooseGridFS;
+
+  /**
+   * Include MongoDB connection and create File bucket
+   */
+  protected constructor(protected readonly connection: Connection, modelName = 'File') {
+    this.files = createBucket({ modelName, connection });
+  }
+
+  /**
+   * Save file in DB
+   */
+  createFile(file: FileUpload, serviceOptions?: FileServiceOptions): Promise<FileInfo> {
+    return new Promise(async (resolve, reject) => {
+      const { filename, mimetype, encoding, createReadStream } = file;
+      const readStream = createReadStream();
+      const options: MongoGridFSOptions = { filename, contentType: mimetype };
+      this.files.writeFile(options, readStream, (error, fileInfo) => {
+        error ? reject(error) : resolve(this.prepareOutput(fileInfo, serviceOptions));
+      });
+    });
+  }
+
+  /**
+   * Save files in DB
+   */
+  async createFiles(files: FileUpload[], serviceOptions?: FileServiceOptions): Promise<FileInfo[]> {
+    const promises: Promise<FileInfo>[] = [];
+    for (const file of files) {
+      promises.push(this.createFile(file, serviceOptions));
+    }
+    return await Promise.all(promises);
+  }
+
+  /**
+   * Get file infos via filter
+   */
+  findFileInfo(filterArgs?: FilterArgs, serviceOptions?: FileServiceOptions): Promise<FileInfo[]> {
+    return new Promise((resolve, reject) => {
+      const filterQuery = convertFilterArgsToQuery(filterArgs);
+      const cursor = this.files.find(filterQuery[0], filterQuery[1]);
+      if (!cursor) {
+        throw new Error('File collection not found');
+      }
+      cursor.toArray((error, docs) => {
+        error ? reject(error) : resolve(this.prepareOutput(docs, serviceOptions));
+      });
+    });
+  }
+
+  /**
+   * Get info about file via file ID
+   */
+  getFileInfo(id: string | Types.ObjectId, serviceOptions?: FileServiceOptions): Promise<FileInfo> {
+    return new Promise((resolve, reject) => {
+      this.files.findById(getObjectIds(id), (error, fileInfo) => {
+        error ? reject(error) : resolve(this.prepareOutput(fileInfo, serviceOptions));
+      });
+    });
+  }
+
+  /**
+   * Get info about file via filename
+   */
+  getFileInfoByName(filename: string, serviceOptions?: FileServiceOptions): Promise<FileInfo> {
+    return new Promise((resolve, reject) => {
+      this.files.findOne({ filename }, (error, fileInfo) => {
+        error ? reject(error) : resolve(this.prepareOutput(fileInfo, serviceOptions));
+      });
+    });
+  }
+
+  /**
+   * Get file stream (for big files) via file ID
+   */
+  getFileStream(id: string | Types.ObjectId, options?: GridFSBucketReadStreamOptions) {
+    return this.files.openDownloadStream(getObjectIds(id), options);
+  }
+
+  /**
+   * Get file stream (for big files) via filename
+   */
+  getFileStreamByName(filename: string): GridFSBucketReadStreamOptions {
+    return this.files.readFile({ filename });
+  }
+
+  /**
+   * Get file buffer (for small files) via file ID
+   */
+  getBuffer(id: string | Types.ObjectId): Promise<Buffer> {
+    return new Promise((resolve, reject) => {
+      this.files.readFile({ _id: getObjectIds(id) }, (error, buffer) => {
+        error ? reject(error) : resolve(buffer);
+      });
+    });
+  }
+
+  /**
+   * Get file buffer (for small files) via file ID
+   */
+  getBufferByName(filename: string): Promise<Buffer> {
+    return new Promise((resolve, reject) => {
+      this.files.readFile({ filename }, (error, buffer) => {
+        error ? reject(error) : resolve(buffer);
+      });
+    });
+  }
+
+  /**
+   * Delete file reference of avatar
+   */
+  deleteFile(id: string | Types.ObjectId, serviceOptions?: FileServiceOptions): Promise<FileInfo> {
+    return new Promise((resolve, reject) => {
+      return this.files.unlink(getObjectIds(id), (error, fileInfo) => {
+        error ? reject(error) : resolve(this.prepareOutput(fileInfo, serviceOptions));
+      });
+    });
+  }
+
+  /**
+   * Delete file reference of avatar
+   */
+  async deleteFileByName(filename: string, serviceOptions?: FileServiceOptions): Promise<FileInfo> {
+    const fileInfo = await this.getFileInfoByName(filename);
+    if (!fileInfo) {
+      throw new NotFoundException('File not found with filename ' + filename);
+    }
+    return await this.deleteFile(fileInfo.id, serviceOptions);
+  }
+
+  // ===================================================================================================================
+  //  Helper methods
+  // ===================================================================================================================
+
+  /**
+   * Prepare output before return
+   */
+  protected async prepareOutput(fileInfo: FileInfo | FileInfo[], options?: FileServiceOptions) {
+    if (!fileInfo) {
+      return fileInfo;
+    }
+    this.setId(fileInfo);
+    fileInfo = await prepareOutput(fileInfo, { targetModel: FileInfo });
+    return check(fileInfo, options?.currentUser, { roles: options?.roles });
+  }
+
+  /**
+   * Set file info ID via _id
+   */
+  protected setId(fileInfo: FileInfo | FileInfo[]) {
+    if (Array.isArray(fileInfo)) {
+      fileInfo.forEach((item) => {
+        if (typeof item === 'object') {
+          item.id = getStringIds(item._id);
+        }
+      });
+    } else if (typeof fileInfo === 'object') {
+      fileInfo.id = getStringIds(fileInfo._id);
+    }
+    return fileInfo;
+  }
+}