feat(user): add UTM parameters support in user creation and sign-up

Author: Dobrunia

src/models/usersFactory.ts

@@ -62,16 +62,23 @@ export default class UsersFactory extends AbstractModelFactory<UserDBScheme, Use
    * Creates new user in DB and returns it
    * @param email - user email
    * @param password - user password
+   * @param utm - UTM parameters
    */
-  public async create(email: string, password?: string): Promise<UserModel> {
-    const generatedPassword = password || await UserModel.generatePassword();
+  public async create(email: string, password?: string, utm?: any): Promise<UserModel> {
+    const generatedPassword = password || (await UserModel.generatePassword());
     const hashedPassword = await UserModel.hashPassword(generatedPassword);
 
-    const userData = {
+    const userData: any = {
       email,
       password: hashedPassword,
       notifications: UserModel.generateDefaultNotificationsSettings(email),
     };
+
+    // Add UTM data if provided
+    if (utm && Object.keys(utm).length > 0) {
+      userData.utm = utm;
+    }
+
     const userId = (await this.collection.insertOne(userData)).insertedId;
 
     const user = new UserModel({

src/resolvers/user.ts

@@ -37,17 +37,18 @@ export default {
      * Register user with provided email
      * @param _obj - parent object (undefined for this resolver)
      * @param email - user email
+     * @param utm - UTM parameters
      * @param factories - factories for working with models
      */
     async signUp(
       _obj: undefined,
-      { email }: {email: string},
+      { email, utm }: { email: string; utm?: any },
       { factories }: ResolverContextBase
     ): Promise<boolean | string> {
       let user;
 
       try {
-        user = await factories.usersFactory.create(email);
+        user = await factories.usersFactory.create(email, undefined, utm);
 
         const password = user.generatedPassword!;
 

src/typeDefs/user.ts

@@ -2,6 +2,36 @@ import { gql } from 'apollo-server-express';
 import isE2E from '../utils/isE2E';
 
 export default gql`
+  """
+  UTM parameters input type
+  """
+  input UtmInput {
+    """
+    UTM source
+    """
+    source: String
+
+    """
+    UTM medium
+    """
+    medium: String
+
+    """
+    UTM campaign
+    """
+    campaign: String
+
+    """
+    UTM content
+    """
+    content: String
+
+    """
+    UTM term
+    """
+    term: String
+  }
+
   """
   Authentication token
   """
@@ -72,6 +102,11 @@ export default gql`
       Registration email
       """
       email: String! @validate(isEmail: true)
+
+      """
+      UTM parameters
+      """
+      utm: UtmInput
     ): ${isE2E ? 'String!' : 'Boolean!'}
 
     """