@izara_project/izara-core-generate-service-code 1.0.45 → 1.0.47

package/src/generators/fromObjectSchema/relationship/update/action/mainFunction/template.ejs

@@ -0,0 +1,406 @@
+/*
+Copyright (C) 2020 Sven Mason <http://izara.io>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+
+
+import { objectHash as hash, identifierUuid } from '@izara_project/izara-shared-core';
+
+import callingFlowSharedLib from '@izara_project/izara-core-library-calling-flow';
+import lambdaSharedLib from "@izara_project/izara-core-library-lambda";
+import snsSharedLib from "@izara_project/izara-core-library-sns";
+import asyncFlowSharedLib from "@izara_project/izara-core-library-asynchronous-flow";
+import dynamodbSharedLib from "@izara_project/izara-core-library-dynamodb";
+
+import { sns } from "@izara_project/izara-core-library-external-request";
+
+import { getObjectSchema, utils, serviceConfig, consts, identifiersObject } from '@izara_project/izara-core-library-service-schemas'
+
+const {
+  getRelationshipSchemaWithCache,
+  getObjSchemaS3WithHierarchy
+} = getObjectSchema
+
+const {
+  createLinkTypeId
+} = utils;
+
+const {
+  getGraphServiceTagWithCache
+} = serviceConfig;
+
+const {
+  PREFIX,
+  TOPIC_NAME_GENERATE_CODE,
+  TOPIC_NAME_GRAPH_HANDLER
+} = consts;
+
+
+//(<optionalRequire>)
+//(</optionalRequire>)
+
+/**
+ * update relationship endpoint
+ *
+ * @param {Object} _izContext
+ * @param {CorrelationIds} _izContext.correlationIds - property of _izContext
+ * @param {Logger} _izContext.logger                 - property of _izContext
+ * @param {Object} requestParams                     - request params
+ * @param {Object} callingFlowConfig
+ *
+ * @returns {object} description of return value
+ */
+export default async function updateRelationship(
+  _izContext,
+  requestParams,
+  callingFlowConfig = {},
+  //(<additionalParams>)
+  //(</additionalParams>)
+) {
+
+
+  try {
+    _izContext.logger.debug('updateRelationship _izContext: ', _izContext);
+    _izContext.logger.debug('updateRelationship requestParams: ', requestParams);
+    _izContext.logger.debug('updateRelationship callingFlowConfig: ', callingFlowConfig);
+
+
+    const {
+      firstObject,
+      secondObject,
+      relType,
+      relId,
+      relationshipProperties,
+      relationshipDirection
+      //(<requestParamUpdateRel>)
+      //(</requestParamUpdateRel>)
+    } = requestParams;
+
+    let errorsFound = [];
+    const parentFlowId = identifierUuid();
+
+    //(<beforeValidateUpdateRel>)
+    //(</beforeValidateUpdateRel>)
+    // validate object and identifiers
+    async function validateIdentifiersExists(_izContext, objType, identifiersObject) {
+
+      const objTypeString = `objType:{ serviceTag:${objType.serviceTag}, objectType:${objType.objectType} }`;
+      const objectSchema = await getObjSchemaS3WithHierarchy(_izContext, objType);
+
+      if (!objectSchema) {
+        errorsFound.push(`validateIdentifiers, not found schema of ${objTypeString}`);
+      }
+
+      for (const schemaIdentifier of objectSchema.identifiers) {
+        let identifierName = schemaIdentifier.fieldName || schemaIdentifier.name;
+
+        if (!identifiersObject.hasOwnProperty(identifierName)) {
+          errorsFound.push(`validateIdentifiers, ${objTypeString} property:${identifierName} not exists`);
+        } else {
+          if (
+            typeof (identifiersObject[identifierName]) !== "string" &&
+            typeof (identifiersObject[identifierName]) !== "number"
+          ) {
+            errorsFound.push(`validateIdentifiers, ${objTypeString} property:${identifierName} should be string or number`);
+          }
+        }
+      }
+    };
+
+    if (firstObject && Object.values(firstObject).length > 0) {
+      await validateIdentifiersExists(_izContext, firstObject.objType, firstObject.identifiers);
+    };
+
+    if (secondObject && Object.values(secondObject).length > 0) {
+      await validateIdentifiersExists(_izContext, secondObject.objType, secondObject.identifiers);
+    };
+    // finished validate object and identifiers
+
+    //(<afterValidateUpdateRel>)
+    //(</afterValidateUpdateRel>)
+
+    //(<beforeGetRelUpdateRel>)
+    //(</beforeGetRelUpdateRel>)
+    const relationshipSchema = await getRelationshipSchemaWithCache(_izContext, relType);
+    _izContext.logger.debug("relationshipSchema: ", relationshipSchema);
+
+    let targetStorageResources = [];
+
+    if (relationshipSchema) {
+      let firstObjectHie;
+      let secondObjectHie;
+
+      if (firstObject && Object.values(firstObject).length > 0) {
+        firstObjectHie = await getObjectSchema.getObjSchemaS3WithHierarchy(_izContext, firstObject.objType);
+      };
+
+      if (secondObject && Object.values(secondObject).length > 0) {
+        secondObjectHie = await getObjectSchema.getObjSchemaS3WithHierarchy(_izContext, secondObject.objType);
+      };
+
+      if (firstObjectHie || firstObject || secondObjectHie || secondObject) {
+        // find targetStorageResources and validate each storageResources
+        await Promise.all(
+          relationshipSchema.links.map(async ({ from, to, storageResourceTags }) => {
+            const { serviceTag: fromServiceTag, objectType: fromObjectType } = from.objType
+            const { serviceTag: toServiceTag, objectType: toObjectType } = to.objType
+
+            const { serviceTag: firstServiceTag, objectType: firstObjectType } = firstObjectHie.extendObjType || firstObject.objType;
+            const { serviceTag: secondServiceTag, objectType: secondObjectType } = secondObjectHie.extendObjType || secondObject.objType;
+
+            // find exists link
+            if (
+              (
+                (firstServiceTag === fromServiceTag && firstObjectType === fromObjectType) &&
+                (secondServiceTag === toServiceTag && secondObjectType === toObjectType)
+              ) ||
+              (
+                (firstServiceTag === toServiceTag && firstObjectType === toObjectType) &&
+                (secondServiceTag === fromServiceTag && secondObjectType === fromObjectType)
+              )
+            ) {
+
+              // check founded storageResource of link and collect used storageResources
+              await Promise.all(storageResourceTags.map(async storageResourceTag => {
+                const usedStorageResource = relationshipSchema.storageResources[storageResourceTag];
+
+                if (usedStorageResource.storageType === consts.STORAGE_TYPES.graph) {
+                  const graphServiceTag = await getGraphServiceTagWithCache(_izContext, usedStorageResource.graphServerTag);
+                  if (!graphServiceTag) {
+                    errorsFound.push(`storageResourceTag:${storageResourceTag} invalid, not found graph serviceTag from graphServerTag:${usedStorageResource.graphServerTag}`)
+                  }
+
+                  targetStorageResources.push({
+                    ...usedStorageResource,
+                    graphServiceTag: graphServiceTag
+                  });
+                } else {
+                  targetStorageResources.push(usedStorageResource);
+                }
+              }));
+            }
+          })
+        );
+      }
+      //(<afterGetRelUpdateRel>)
+      //(</afterGetRelUpdateRel>)
+      _izContext.logger.debug("targetStorageResources: ", targetStorageResources);
+
+      if (!targetStorageResources.length) {
+        errorsFound.push(`Not found link from relationship schema`);
+      }
+
+
+      // validate canUpdate properties relationship
+      for (const [propKey, propValue] of Object.entries(relationshipProperties)) {
+        _izContext.logger.debug("propKey: ", propKey);
+        _izContext.logger.debug("propValue: ", propValue);
+
+        if (relationshipSchema.fieldNames[propKey]) {
+          if (relationshipSchema.fieldNames[propKey].updateBy === "user") {
+            if (callingFlowConfig) {
+              if (callingFlowConfig.callingFlow !== "ImportDataTestExternalUpdateRelationshipHdrSqs") {
+                errorsFound.push(`property:${propKey} can update  user but it's not user process with importData`)
+              }
+            }
+          }
+        } else {
+          errorsFound.push(`property:${propKey} not exists in relationshipSchema`);
+        }
+      }
+
+
+      // if found errors will stop processing
+      if (errorsFound.length) {
+
+        let updateCompleteMsg = {
+          firstObject: firstObject,
+          secondObject: secondObject,
+          relId: relId,
+          relType: relType,
+          relationshipDirection,
+          status: 'error',
+          errorsFound: errorsFound,
+          parentFlowId: parentFlowId,
+          //(<inUpdateCompleteMsgUpdateRel>)
+          //(</inUpdateCompleteMsgUpdateRel>)
+        };
+
+        // if have callingFlow will send to message complete
+        if (callingFlowConfig[callingFlowSharedLib.consts.CALLINGFLOW_PROPERTYNAME]) {
+          _izContext.logger.debug("HAVE CallingFlow");
+
+          updateCompleteMsg = callingFlowSharedLib.addPassBackPropertiesToSnsResponseMessageObject(callingFlowConfig, updateCompleteMsg);
+          let messageAttributes = callingFlowSharedLib.addCallingFlowToSnsResponseMessageAttributes(callingFlowConfig, {});
+
+          let messageParams = {
+            Message: JSON.stringify(updateCompleteMsg),
+            MessageAttributes: sns.createStringMessageAttributes(_izContext, messageAttributes),
+            TopicArn: await snsSharedLib.snsTopicArnByFlowSchema(_izContext, TOPIC_NAME_GENERATE_CODE.outUpdateRelComplete),
+          };
+
+          _izContext.logger.debug("messageParams OutUpdateRelationshipComplete ::::::: ", messageParams);
+          await sns.publishAsync(_izContext, messageParams);
+        }
+
+        return updateCompleteMsg;
+      }
+
+
+      // before create awaitingStepId per graph storageResource
+      const linkTypeId = createLinkTypeId(_izContext, firstObject.objType, secondObject.objType, relType, relationshipDirection);
+
+      let usedGraphServiceTag = []; // collect used graph serviceName, use to check duplicate graph serviceName across graph serverTag
+      let targetGraphStorageResources = []; // collect used graph storageResources, filtered duplicate graphServiceTag from graphServerTag out
+      let awaitingStepIds = [];
+
+      for (const targetStorageResource of targetStorageResources) {
+        if (targetStorageResource.storageType === consts.STORAGE_TYPES.graph &&
+          !usedGraphServiceTag.includes(targetStorageResource.graphServiceTag)
+        ) {
+          usedGraphServiceTag.push(targetStorageResource.graphServiceTag);
+          targetGraphStorageResources.push(targetStorageResource);
+
+          // awaitingStepId per graphServiceTag
+          awaitingStepIds.push(
+            asyncFlowSharedLib.createAwaitingStepId(
+              parentFlowId, // hash id
+              PREFIX.updateRel // prefix, use constant further
+            )
+          );
+        } else if (storageResource.storageType === consts.STORAGE_TYPES.dynamoDB) {
+          let tableNameFrom = `${firstObject.objType.serviceTag}_${firstObject.objType.objectType}__${relType.relationshipTag}__${secondObject.objType.serviceTag}_${secondObject.objType.objectType}`;
+          let tableNameTo = `${secondObject.objType.serviceTag}_${secondObject.objType.objectType}__${relType.relationshipTag}__${firstObject.objType.serviceTag}_${firstObject.objType.objectType}`;
+
+          let identifiersConcatFirstObject = await identifiersObject.identifiersConcatFromIdentifiers(_izContext, firstObject.objType, firstObject.identifiers);
+          let identifiersConcatSecondObject = await identifiersObject.identifiersConcatFromIdentifiers(_izContext, secondObject.objType, secondObject.identifiers);
+          const firstObjectIdentifiersConcat = `${firstObject.objType.serviceTag}_${firstObject.objType.objectType}__identifiersConcat`;
+          const secondObjectIdentifiersConcat = `${secondObject.objType.serviceTag}_${secondObject.objType.objectType}__identifiersConcat`;
+
+          await dynamodbSharedLib.updateItem(_izContext,
+            await dynamodbSharedLib.tableName(_izContext, tableNameFrom),
+            {
+              [identifiersConcatFirstObject]: firstObjectIdentifiersConcat,
+              [identifiersConcatSecondObject]: secondObjectIdentifiersConcat
+            }
+          )
+
+          await dynamodbSharedLib.updateItem(_izContext,
+            await dynamodbSharedLib.tableName(_izContext, tableNameTo),
+            {
+              [identifiersConcatSecondObject]: secondObjectIdentifiersConcat,
+              [identifiersConcatFirstObject]: firstObjectIdentifiersConcat
+            }
+          )
+        }
+      }
+
+      if (awaitingStepIds.length) {
+        // save awaiting
+        await asyncFlowSharedLib.createAwaitingMultipleSteps(
+          _izContext,
+          awaitingStepIds, // awaitingStepIds
+          asyncFlowSharedLib.createPendingStepId( // pendingStepId
+            hash({ linkTypeId, relId, relationshipProperties, correlationId: _izContext.correlationIds.get("id") }), // hash id
+            PREFIX.updateRel // prefix, use constant further
+          )
+        );
+
+        // prepare message body
+        let updateRelMessageBody = {
+          firstObject,
+          secondObject,
+          relId,
+          relType: relType,
+          relationshipProperties,
+          relationshipDirection,
+          parentFlowId
+          //(<inUpdateRelMessageBodyUpdateRel>)
+          //(</inUpdateRelMessageBodyUpdateRel>)
+        }
+        _izContext.logger.debug('updateRelMessageBody: ', updateRelMessageBody);
+
+        await Promise.all(
+          targetGraphStorageResources.map(async (storageResource) => {
+            if (storageResource.storageType === consts.STORAGE_TYPES.graph) {
+
+              updateRelMessageBody = callingFlowSharedLib.addCallingFlowToSnsRequestMessageObject(
+                updateRelMessageBody,
+                callingFlowSharedLib.addParentCallingFlowConfig(
+                  callingFlowConfig, // receive parent callingFlowConfig.
+                  callingFlowSharedLib.createCallingFlowConfig( // callingFlow own service
+                    //(<callingFlowProperties>)
+                    await lambdaSharedLib.lambdaFunctionName(_izContext, TOPIC_NAME_GENERATE_CODE.updateRelComplete),
+                    //(</callingFlowProperties>)
+                    {
+                      graphServiceTag: storageResource.graphServiceTag
+                    }
+                  )
+                )
+              );
+              _izContext.logger.debug("messageObject before send message:", updateRelMessageBody)
+
+              let messageToInUpdateRelationship = {
+                Message: JSON.stringify(updateRelMessageBody),
+                TopicArn: await snsSharedLib.snsTopicArnByFlowSchema(_izContext, TOPIC_NAME_GRAPH_HANDLER.inUpdateRel, storageResource.graphServiceTag),
+              };
+              _izContext.logger.debug("RequestParams before send to sqs messageToInUpdateRelationship ::::::: ", messageToInUpdateRelationship);
+              await sns.publishAsync(_izContext, messageToInUpdateRelationship);
+            }
+          })
+        )
+
+      } else if (!awaitingStepIds.length) {
+        _izContext.logger.debug("dynamoDb storageResourceTag")
+        let messageObject = {
+          firstObject: firstObject,
+          secondObject: secondObject,
+          relType: relType,
+          relationshipDirection,
+          relationshipProperties,
+          parentFlowId
+        };
+
+        if (callingFlowConfig[callingFlowSharedLib.consts.CALLINGFLOW_PROPERTYNAME]) {
+          _izContext.logger.debug("have callingFlow");
+          messageObject = callingFlowSharedLib.addPassBackPropertiesToSnsResponseMessageObject(callingFlowConfig, messageObject);
+
+          let messageAttributes = callingFlowSharedLib.addCallingFlowToSnsResponseMessageAttributes(callingFlowConfig, {});
+          let sendMessageToOutCreateRelComplete = {
+            Message: JSON.stringify(messageObject),
+            MessageAttributes: sns.createStringMessageAttributes(_izContext, messageAttributes),
+            TopicArn: await snsSharedLib.snsTopicArnByFlowSchema(_izContext, TOPIC_NAME_GENERATE_CODE.outCreateRelComplete)
+          }
+          _izContext.logger.debug("send Message to outCreateRelationshipComplete :::", sendMessageToOutCreateRelComplete);
+          await sns.publishAsync(_izContext, sendMessageToOutCreateRelComplete);
+        }
+
+      }
+
+      return {
+        firstObject,
+        secondObject,
+        relId: relId,
+        relType: relType,
+        relationshipDirection,
+        errorsFound
+      };
+    }
+  } catch (err) {
+    _izContext.logger.error('error updateRelationship: ', err)
+    throw (err)
+  }
+}

package/src/generators/fromObjectSchema/relationship/update/action/sns-in-sqs/snsTemplate.ejs

@@ -0,0 +1,56 @@
+##===== [Create topic in]
+  In<%- queueName %>:
+    Type: AWS::SNS::Topic
+    Properties:
+      DisplayName: "SNS Message in"
+      TopicName: ${self:custom.iz_serviceTag}_${self:custom.iz_stage}_<%- queueName %>_In
+##===== SNS Subscription
+##===== [Topic In]
+  SubscriptionIn<%- queueName %>:
+    Type: AWS::SNS::Subscription
+    Properties:
+      TopicArn: !Ref In<%- queueName %>
+      Endpoint: "arn:aws:sqs:${self:custom.iz_region}:${self:custom.iz_accountId}:${self:custom.iz_resourcePrefix}<%- queueName %>HdrSqs"
+      Protocol: "sqs"
+##===== [Queue]
+  <%- queueName %>HdrSqs:
+    Type: "AWS::SQS::Queue"
+    Properties:
+      QueueName: ${self:custom.iz_resourcePrefix}<%- queueName %>HdrSqs
+      RedrivePolicy:
+        deadLetterTargetArn:
+        # !GetAtt
+          Fn::GetAtt:
+            - <%- queueName %>HdrSqsDLQ
+            - Arn
+        maxReceiveCount: 3
+      VisibilityTimeout: 120
+##==== [QueueDLQ]
+  <%- queueName %>HdrSqsDLQ:
+    Type: AWS::SQS::Queue
+    Properties:
+      QueueName: ${self:custom.iz_resourcePrefix}<%- queueName %>HdrSqsDLQ
+##==== [QueuePolicy]
+  <%- queueName %>HdrSqsPolicy:
+    Type: AWS::SQS::QueuePolicy
+    Properties:
+      PolicyDocument:
+        Version: "2012-10-17"
+        Statement:
+          - Sid: "allow-sns-messages"
+            Effect: Allow
+            Principal: "*"
+            Resource:
+            # !GetAtt
+              Fn::GetAtt:
+                - <%- queueName %>HdrSqs
+                - Arn
+            Action: "SQS:SendMessage"
+      Queues:
+        - Ref: <%- queueName %>HdrSqs
+  #<#<%- queueName %>QueueSetting#>
+  #<#/<%- queueName %>QueueSetting#>
+
+<%_ function firstLetterLowerCase(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1)
+} _%>

package/src/generators/fromObjectSchema/relationship/update/action/sns-in-sqs/sqsTemplate.ejs

@@ -0,0 +1,40 @@
+#------- queue ---------
+  <%- queueName %>:
+    Type: "AWS::SQS::Queue"
+    Properties:
+      QueueName: ${self:custom.iz_resourcePrefix}<%- queueName %>
+      RedrivePolicy:
+        deadLetterTargetArn: #!GetAtt
+          Fn::GetAtt:
+            - <%- queueName %>DLQ
+            - Arn
+        maxReceiveCount: 3
+      VisibilityTimeout: 120
+
+  <%- queueName %>DLQ:
+    Type: AWS::SQS::Queue
+    Properties:
+      QueueName: ${self:custom.iz_resourcePrefix}<%- queueName %>DLQ
+
+  <%- queueName %>Policy:
+    Type: AWS::SQS::QueuePolicy
+    Properties:
+      PolicyDocument:
+        Version: "2012-10-17"
+        Statement:
+          - Sid: "allow-sns-messages"
+            Effect: Allow
+            Principal: "*"
+            Resource: #!GetAtt
+              Fn::GetAtt:
+                - <%- queueName %>
+                - Arn
+            Action: "SQS:SendMessage"
+      Queues:
+        - Ref: <%- queueName %>
+  #<#<%- queueName %>QueueSetting#>
+  #<#/<%- queueName %>QueueSetting#>
+
+<%_ function firstLetterLowerCase(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1)
+} _%>

package/src/generators/fromObjectSchema/relationship/update/action/sns-out/snsOut.js

@@ -0,0 +1,69 @@
+/*
+Copyright (C) 2020 Sven Mason <http://izara.io>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+import consts from '#libs/Consts.js';
+import utils from '#libs/Utils.js';
+
+const { SOURCE_PATH, SAVE_FILE_NAME, FUNCTION_NAME } = consts;
+
+const { firstLetterLowerCase: lowerCase, firstLetterUpperCase: upperCase } =
+  utils;
+
+const templatePath = path.join(
+  __dirname,
+  '../../../../resourceYamlComponent/sns-out/template.ejs'
+);
+
+/**
+ * create data for dynamoDbYaml tempalte from objectSchema
+ * return array of dynamoDb data
+ * because one objectSchema can create multiple dynamoDb table
+ *
+ * @param {Object} _izContext
+ * @param {String} saveFilePath
+ * @returns {Object[]}              - data of multiple dynamoDb template
+ */
+
+function createDefaultSnsOut(_izContext, srcPath) {
+  const createSourceParams = createParamsForCreateSource(_izContext, srcPath);
+  return [createSourceParams];
+}
+
+function createParamsForCreateSource(_izContext, srcPath) {
+  let queueName = FUNCTION_NAME.updateRel;
+  return {
+    templatePath: templatePath,
+    templateData: {
+      queueName: upperCase(queueName)
+    },
+    setting: {
+      initialData: 'Resources:\n',
+      savePath: path.join(srcPath, SOURCE_PATH.resourceYaml),
+      saveFileName: SAVE_FILE_NAME.snsOutYaml,
+      fileExtension: '.yml',
+      isAppend: true,
+      fromFile: 'relationShip/update/sns-out/snsOut.js'
+    }
+  };
+}
+
+module.exports = createDefaultSnsOut;

package/src/generators/fromObjectSchema/relationship/update/complete/functionYaml/template.ejs

@@ -0,0 +1,17 @@
+<%- functionNameConfig %>:
+  handler: <%- handlerPathUpperFunctionName %>
+  name: ${self:custom.iz_resourcePrefix}<%- upperFunctionName %>
+  role: <%- roleName %>Role
+  #<#<%- functionName %><%- upperHandlerType %>FunctionSetting#>
+  #<#/<%- functionName %><%- upperHandlerType %>FunctionSetting#>
+  events:
+    - sqs:
+        arn: arn:aws:sqs:${self:custom.iz_region}:${self:custom.iz_accountId}:${self:custom.iz_resourcePrefix}<%- upperFunctionName %>
+        batchSize: 10
+        filterPatterns: #**** need to update serverless framework upper v.2.69.1
+          - body: {"MessageAttributes":{"callingFlow":{"Value":["${self:custom.iz_resourcePrefix}<%- upperFunctionName %>"]}}} # functionName of callingFlow
+          - body: {"MessageAttributes":{"callingFlow":{"Value":[{"exists":false}]}}}
+
+<%_ function firstLetterLowerCase(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1)
+} _%>