@lenne.tech/nest-server 11.0.0 → 11.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenne.tech/nest-server",
-  "version": "11.0.0",
+  "version": "11.0.1",
   "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",

package/src/core/common/decorators/graphql-service-options.decorator.ts

@@ -1,4 +1,5 @@
 import { createParamDecorator, ExecutionContext } from '@nestjs/common';
+import { GqlExecutionContext } from '@nestjs/graphql';
 
 import { currentUserDec, graphqlPopulateDec } from '../helpers/decorator.helper';
 import { ServiceOptions } from '../interfaces/service-options.interface';
@@ -8,6 +9,7 @@ import { ServiceOptions } from '../interfaces/service-options.interface';
  *
  * Includes following properties of ServiceOptions:
  *  - currentUser
+ *  - language
  *  - populate
  *
  * Configuration via Decorator data:
@@ -22,8 +24,14 @@ import { ServiceOptions } from '../interfaces/service-options.interface';
  */
 export const GraphQLServiceOptions = createParamDecorator(
   (data: { gqlPath?: string; ignoreSelections?: boolean }, ctx: ExecutionContext): ServiceOptions => {
+    const gqlContext = GqlExecutionContext.create(ctx);
+    const request = gqlContext.getContext().req;
+
+    const language = request?.headers?.['accept-language'];
+
     return {
       currentUser: currentUserDec(null, ctx),
+      language,
       populate: graphqlPopulateDec(data, ctx),
     };
   },

package/src/core/common/decorators/rest-service-options.decorator.ts

@@ -0,0 +1,22 @@
+import { createParamDecorator, ExecutionContext } from '@nestjs/common';
+
+import { currentUserDec } from '../helpers/decorator.helper';
+import { ServiceOptions } from '../interfaces/service-options.interface';
+
+/**
+ * Get standard ServiceOptions for REST-Requests
+ *
+ * Includes following properties of ServiceOptions:
+ *  - currentUser
+ *  - language
+ */
+export const RESTServiceOptions = createParamDecorator((ctx: ExecutionContext): ServiceOptions => {
+  const request = ctx.switchToHttp().getRequest();
+
+  const language = request?.headers?.['accept-language'];
+
+  return {
+    currentUser: currentUserDec(null, ctx),
+    language,
+  };
+});

package/src/core/common/decorators/translatable.decorator.ts

@@ -0,0 +1,24 @@
+import 'reflect-metadata';
+
+const TRANSLATABLE_KEY = 'custom:translatable';
+
+export function getTranslatablePropertyKeys(target: unknown): string[] {
+  // for classes
+  if (typeof target === 'function') {
+    return Reflect.getMetadata(TRANSLATABLE_KEY, target) || [];
+  }
+
+  // for instances
+  if (typeof target === 'object' && target.constructor) {
+    return Reflect.getMetadata(TRANSLATABLE_KEY, target.constructor) || [];
+  }
+
+  return [];
+}
+
+export function Translatable(): PropertyDecorator {
+  return (target: object, propertyKey: string | symbol) => {
+    const existingProperties: string[] = Reflect.getMetadata(TRANSLATABLE_KEY, target.constructor) || [];
+    Reflect.defineMetadata(TRANSLATABLE_KEY, [...existingProperties, propertyKey], target.constructor);
+  };
+}

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

@@ -3,6 +3,7 @@ import { plainToInstance } from 'class-transformer';
 import { sha256 } from 'js-sha256';
 import { Types } from 'mongoose';
 
+import { getTranslatablePropertyKeys } from '../decorators/translatable.decorator';
 import { RoleEnum } from '../enums/role.enum';
 import { PrepareInputOptions } from '../interfaces/prepare-input-options.interface';
 import { PrepareOutputOptions } from '../interfaces/prepare-output-options.interface';
@@ -187,6 +188,7 @@ export async function prepareOutput<T = { [key: string]: any; map: (...args: any
     circles?: boolean;
     clone?: boolean;
     getNewArray?: boolean;
+    language?: string;
     objectIdsToStrings?: boolean;
     proto?: boolean;
     removeSecrets?: boolean;
@@ -273,6 +275,20 @@ export async function prepareOutput<T = { [key: string]: any; map: (...args: any
     }
   }
 
+  // Add translated values of current selected language if _translations object exists
+  if (config.targetModel && config.language && typeof output === 'object' && '_translations' in output) {
+    const translation = output._translations?.[options.language];
+
+    if (typeof translation === 'object') {
+      const keys = getTranslatablePropertyKeys(config.targetModel);
+      for (const key of keys) {
+        if (translation[key] != null) {
+          output[key] = translation[key];
+        }
+      }
+    }
+  }
+
   // Return prepared output
   return output;
 }

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

@@ -258,6 +258,7 @@ export abstract class ModuleService<T extends CoreModel = any> {
    */
   async prepareOutput(output: any, options: ServiceOptions = {}) {
     const config = {
+      language: options?.language,
       targetModel: this.mainModelConstructor,
       ...options?.prepareOutput,
     };

package/src/index.ts

@@ -14,9 +14,11 @@ export * from './core/common/decorators/current-user.decorator';
 export * from './core/common/decorators/graphql-populate.decorator';
 export * from './core/common/decorators/graphql-service-options.decorator';
 export * from './core/common/decorators/graphql-user.decorator';
+export * from './core/common/decorators/rest-service-options.decorator';
 export * from './core/common/decorators/rest-user.decorator';
 export * from './core/common/decorators/restricted.decorator';
 export * from './core/common/decorators/roles.decorator';
+export * from './core/common/decorators/translatable.decorator';
 export * from './core/common/enums/comparison-operator.enum';
 export * from './core/common/enums/logical-operator.enum';
 export * from './core/common/enums/process-type.enum';