@izara_project/izara-market-library-service-schemas 1.0.23 → 1.0.24

package/src/reStructure/TemplateData/flowSchema/components/upload/preSignUrl/getSignUrls/functionYaml/data.js

@@ -0,0 +1,102 @@
+/*
+Copyright (C) 2021 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/>.
+*/
+
+'use strict';
+
+const path = require('path');
+
+const templatePath = path.join(__dirname, "./template.ejs")
+
+const { firstLetterLowerCase: lowerCase, firstLetterUpperCase: upperCase } = require("../../../../../../../../MainLibs/src/Utils")
+const {
+  HANDLER,
+  defaultIamRolePerAction,
+  createIamRole,
+  RESOURCE_CLASSES,
+  SQS_RESOURCE,
+  SNS_RESOURCE,
+  resourceNames,
+  shortNameHandler,
+  SOURCE_PATH,
+  SAVE_FILE_NAME,
+  awaitingMultipleStepsRole,
+  externalResourceSns,
+  externalResourceName
+} = require('../../../../../../../../MainLibs/src/Consts');
+
+const {
+  TOPIC_NAME_GENERATE_CODE
+} = require('../../../../../../../../GenerateCodeLibs/src/Consts');
+
+/**
+ * receive objectSchema
+ *
+ * @param {Object} flowSchema
+ * @return {{ templatePath, templateData, setting } }
+ */
+
+function data(_izContext, srcPath) {
+  return [createSourceParams(_izContext, srcPath)]
+}
+
+function createSourceParams(_izContext, srcPath) {
+  let functionName = "GetPresignUrl";
+  let handlerType = upperCase(HANDLER.hdrSqs);
+  let additionalResourcePermission = defaultIamRolePerAction();
+
+  additionalResourcePermission.push(
+    createIamRole(
+      {
+        [RESOURCE_CLASSES.sqs]: [
+          SQS_RESOURCE.receiveMessage,
+          SQS_RESOURCE.sendMessage,
+          SQS_RESOURCE.deleteMessage,
+          SQS_RESOURCE.getQueueAttributes
+        ],
+        [RESOURCE_CLASSES.sns]: [
+          SNS_RESOURCE.publish,
+          SNS_RESOURCE.subscribe
+        ]
+      },
+      [
+        resourceNames(RESOURCE_CLASSES.sqs, "GetPresignUrl" + handlerType),
+        resourceNames(RESOURCE_CLASSES.sqs, "GetPresignUrl" + "DLQ"),
+        resourceNames(RESOURCE_CLASSES.sns, TOPIC_NAME_GENERATE_CODE.outCreateNodeComplete)
+      ]
+    )
+  )
+
+  return {
+    templatePath: templatePath,
+    templateData: {
+      functionName,
+      handlerType,
+      functionNameConfig: functionName + upperCase(handlerType),
+      resourceLocation: SOURCE_PATH.resourceLocationWebSocket,
+      additionalResourcePermission,
+      functionNameConfig: upperCase(functionName) + upperCase(shortNameHandler(handlerType)),
+    },
+    setting: {
+      saveFileName: upperCase(SAVE_FILE_NAME.flowSchema),
+      savePath: path.join(srcPath, SOURCE_PATH.appYaml),
+      fileExtension: ".yml",
+      isAppend: true
+    }
+  }
+}
+
+module.exports = data

package/src/reStructure/TemplateData/flowSchema/components/upload/preSignUrl/getSignUrls/functionYaml/template.ejs

@@ -0,0 +1,27 @@
+<%_ const join = require('path').join; _%>
+<%- firstLetterUpperCase(functionNameConfig) %>:
+  handler: <%- join(resourceLocation, `${functionName}_${firstLetterUpperCase(handlerType)}.main`)%>
+  name: ${self:custom.iz_resourcePrefix}<%- functionName %><%- firstLetterUpperCase(handlerType) %>
+  events:
+    - sqs:
+        arn: arn:aws:sqs:${self:custom.iz_region}:${self:custom.iz_accountId}:${self:custom.iz_resourcePrefix}<%- functionName %><%- firstLetterUpperCase(handlerType) %>
+        batchSize: 10
+  iamRoleStatements:
+    <%_ additionalResourcePermission.forEach(resourcePermission => { _%>
+    - Effect: <%- resourcePermission.effect %>
+      Action:
+        <%_ Object.keys(resourcePermission.action).forEach(resourcePerAction => { _%>
+        <%_ resourcePermission.action[resourcePerAction].forEach(permission => { _%>
+        - <%- resourcePerAction %>:<%- permission %>
+        <%_ }) _%>
+        <%_ }) _%>
+      Resource:
+        <%_ resourcePermission.resource.forEach(resource => { _%>
+        - "<%- resource %>"
+        <%_ }) _%>
+    <%_}) _%>
+    #<#<%- functionName %><%- handlerType %>IamRole#>
+    #<#/<%- functionName %><%- handlerType %>IamRole#>
+<%_ function firstLetterUpperCase(text){
+  return text.charAt(0).toUpperCase() + text.slice(1)
+} _%>

package/src/reStructure/TemplateData/flowSchema/components/upload/preSignUrl/getSignUrls/handler/data.js

@@ -0,0 +1,57 @@
+/*
+Copyright (C) 2021 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/>.
+*/
+
+'use strict';
+
+const path = require('path');
+
+const templatePath = path.join(__dirname, "./template.ejs")
+const { firstLetterLowerCase: lowerCase, firstLetterUpperCase: upperCase } = require("../../../../../../../../MainLibs/src/Utils")
+
+const { HANDLER, SOURCE_PATH } = require('../../../../../../../../MainLibs/src/Consts');
+
+/**
+ * receive objectSchema
+ *
+ * @param {Object} flowSchema
+ * @return {{ templatePath, templateData, setting } }
+ */
+
+function data(_izContext, srcPath) {
+  return [createSourceParams(_izContext, srcPath)]
+}
+
+function createSourceParams(_izContext, srcPath) {
+  let functionName = "GetPresignUrl";
+  let handlerType = upperCase(HANDLER.hdrSqs);
+
+  return {
+    templatePath: templatePath,
+    templateData: {
+      functionName,
+      handlerType,
+    },
+    setting: {
+      saveFileName: `${functionName}_${handlerType}`,
+      savePath: path.join(srcPath, SOURCE_PATH.webSocket),
+      fileExtension: ".js",
+      isAppend: true
+    }
+  }
+}
+
+module.exports = data

package/src/reStructure/TemplateData/flowSchema/components/upload/preSignUrl/getSignUrls/handler/template.ejs

@@ -0,0 +1,120 @@
+/*
+Copyright (C) 2021 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/>.
+*/
+
+'use strict';
+
+const izara = require("@izara_project/izara-middleware");
+const middleware = izara.middlewareHandler;
+const izaraShared = require('@izara_project/izara-shared');
+const recordHandlerSharedLib = izaraShared.recordHandlerSharedLib
+const callingFlowSharedLib = izaraShared.callingFlowSharedLib;
+const Logger = require('@izara_project/izara-core-library-logger');
+
+const getPresignUrl = require('./GetPresignUrl_Main');
+
+middleware.setServiceSchema(recordHandlerSharedLib.baseValidatorSchema());
+
+let perRecordsValidatorSchema = {
+  type: "object",
+  required: ["objType", "objInstanceFull"],
+  properties: {
+    objType: {
+      type: "object",
+      required: ["objectType", "serviceTag"],
+      properties: {
+        objectType: {
+          type: "string",
+          pattern: "^[a-zA-Z0-9_-]+$"
+        },
+        serviceTag: {
+          type: "string",
+          pattern: "^[a-zA-Z0-9_-]+$"
+        }
+      },
+    },
+    objInstaceFull: {
+      type: "object",
+      properties: {
+        identifiers: {
+          type: "object",
+          minProperties: 1
+        },
+        fields: {
+          type: "object"
+        }
+      }
+    }
+  }
+};
+
+perRecordsValidatorSchema = callingFlowSharedLib.addOptionalPassBackPropertiesToValidatorSchema(perRecordsValidatorSchema);
+
+module.exports.main = middleware.wrap(async (event, context, callback) => {
+
+  try {
+
+    let recordPromises = [];
+
+    // loop each record and send to mainFunction
+    await Promise.all(event.Records.map(async record => { // promise.all for map() function
+
+      let passOnProperties = []
+      record._izContext.logger.debug('record ReceiveMsgOutHdrSqs', record);
+
+      //validate message (and MessageAttributes)
+      await recordHandlerSharedLib.validateRecord(
+        record, // one record will send to mainFunction
+        "GetPresignUrlHdrSqs", // queue name that need to retry or send to dlq
+        perRecordsValidatorSchema, // schema for record.Message
+        // messageAttributeValidatorSchema  // ----- for msgAttr default is null -> do not send this parameter if not want to validate msgAtt
+      );
+
+      // add argument (to invoke lambda) to passOnProperties[]
+      passOnProperties.push(record.body.Message.objType)
+      passOnProperties.push(record.body.Message.objInstanceFull)
+      passOnProperties.push(callingFlowSharedLib.addPassBackPropertiesToPassOnProperties(record.body.Message)) // is Ok PassBackProperties
+      // passOnProperties.push(callingFlowSharedLib.addCallingFlowToPassOnProperties(record.body.Message)) // is Ok callinfFlow
+      record._izContext.logger.debug('passOnProperties in handler', passOnProperties);
+
+      // call recordHandlerSharedLib.recordHandler with 3 parameters and return promise(resolve)
+      let recordPromise = recordHandlerSharedLib.recordHandler(
+        record, // one record will send to mainFunction
+        getPresignUrl.getSignedUrlAccountLimit, // mainFunction that need to invoke.
+        "GetPresignUrlHdrSqs", // queue name that need to retry or send to dlq
+        passOnProperties, // all parameters that mainFunction needed.
+      );
+      record._izContext.logger.debug('after recordPromise in handler');
+      recordPromises.push(recordPromise); // push promise to recordPromises
+    }))
+
+    Logger.debug('before Promise.all(recordPromises) in handler');
+    try {
+      // --- main await all promises
+      await Promise.all(recordPromises); // await all promises
+
+      return event.Records // return all for local testing
+
+    } catch {
+      Logger.debug('Promise.all(recordPromises) in handler threw error (at least one record did no resolve)');
+    }
+    Logger.debug('after Promise.all(recordPromises) in handler');
+
+  } catch (err) {
+    Logger.error('Unhandled Error, updateNodeCompleteHdrSqs: ', err);
+    throw (err);
+  }
+});

package/src/reStructure/TemplateData/flowSchema/components/upload/preSignUrl/getSignUrls/mainFunction/data.js

@@ -0,0 +1,51 @@
+/*
+Copyright (C) 2021 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/>.
+*/
+
+'use strict';
+
+const path = require('path');
+
+const templatePath = path.join(__dirname, "./template.ejs")
+
+const { SOURCE_PATH } = require('../../../../../../../../MainLibs/src/Consts');
+
+/**
+ * receive objectSchema
+ *
+ * @param {Object} flowSchema
+ * @return {{ templatePath, templateData, setting } }
+ */
+
+function data(_izContext, srcPath) {
+  return [createSourceParams(_izContext, srcPath)]
+}
+
+function createSourceParams(_izContext, srcPath) {
+  let functionName = "GetPresignUrl"
+  return {
+    templatePath: templatePath,
+    templateData: {},
+    setting: {
+      saveFileName: `${functionName}_Main`,
+      savePath: path.join(srcPath, SOURCE_PATH.webSocket),
+      fileExtension: ".js",
+      isAppend: false
+    }
+  }
+}
+
+module.exports = data

package/src/reStructure/TemplateData/flowSchema/components/upload/preSignUrl/getSignUrls/mainFunction/template.ejs

@@ -0,0 +1,164 @@
+/*
+Copyright (C) 2021 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/>.
+*/
+
+'use strict';
+
+const izaraShared = require('@izara_project/izara-shared');
+const callingFlowSharedLib = izaraShared.callingFlowSharedLib;
+const lambdaSharedLib = izaraShared.lambdaSharedLib;
+const snsSharedLib = izaraShared.snsSharedLib
+
+const externalRequest = require('@izara_project/izara-core-library-external-request')
+const sns = externalRequest.sns;
+const lambda = externalRequest.lambda
+const consts = require('@izara_project/izara-market-library-service-schemas/src/GenerateCodeLibs/src/Consts')
+const coreConsts = require('@izara_project/izara-middleware/src/MiddlewareCore/Consts')
+const hash = require('object-hash');
+const importDataLibs = require('../../libs/source/ImportDataLib')
+/**
+ * description of function.
+ * @param {Object} _izContext
+ * @param {CorrelationIds} _izContext.correlationIds - property of _izContext
+ * @param {Logger} _izContext.logger - property of _izContext
+ * @param {string} userId - from client
+ * @param {string} imageImportConfigId - from client
+ * @param {string} fileName - name of image
+ * @param {string} imageType - type of image
+ * @param {numeric} imageSize - size of image
+ *
+ * @returns {object} return imageImportId
+ */
+module.exports.getSignedUrlAccountLimit = async (
+  _izContext,
+  objType,
+  objInstaceFull,
+  callingFlowConfig = {}
+) => {
+
+  try {
+
+    _izContext.logger.debug('----- getSignedUrlAccountLimit event params ----- ', {
+      objType,
+      objInstaceFull,
+      callingFlowConfig
+    });
+    const {
+      userId,
+      submittedByUserId,
+      importConfigId,
+      importBatchStatus,
+      importType,
+      fileName,
+      fileSize,
+      startTime
+    } = objInstaceFull.fields
+    const {
+      importBatchId
+    } = objInstaceFull.identifiers
+
+    let connectionId = _izContext.correlationIds.get(coreConsts.CONNECTION_ID)
+    //* hard code
+    // _izContext['userId'] = 'this-is-uuid-for-user-superUserA'
+
+    // get static
+    let payloadBeforeInvokeStaticLimit = {
+      userId: userId,
+      limitTag: consts.LIMIT_TAG.uploadData,
+      value: fileSize,
+      rbacType: consts.RBAC_TYPE.appLevel,
+      targetUserId: submittedByUserId,
+      callingFlow: "BasDev",
+      callingFlowProperties: {}
+    }
+
+    let res = await importDataLibs.getDataFromInvokeFunctionWithCache(_izContext,
+      await lambdaSharedLib.lambdaFunctionName(_izContext, "StaticLimitProcessHdrInv", consts.EXTERNAL_SERVICE_NAME.accountLimits),
+      payloadBeforeInvokeStaticLimit
+    )
+    // let res = await lambda.invokeSync(_izContext,
+    //   await lambdaSharedLib.lambdaFunctionName(_izContext, "StaticLimitProcessHdrInv", consts.EXTERNAL_SERVICE_NAME.accountLimits),
+    //   payloadBeforeInvokeStaticLimit
+    // )
+
+    _izContext.logger.debug("res::", res);
+
+    if (res.passStatus === false) {
+      importDataLibs.postToConnection({ message: "static limit over" }, connectionId)
+    }
+
+
+    // reservedDynamic
+
+    let sendMsgReservedDynamic = {
+      userId: userId,
+      limitTag: consts.LIMIT_TAG.uploadData,
+      value: fileSize,
+      rbacType: consts.RBAC_TYPE.appLevel,
+      usedTimestamp: startTime,
+      targetUserId: submittedByUserId
+    }
+
+    const reservedDataId = `${consts.ACCOUNTLIMIT_TAG.reservedDynamic}_${userId}_${consts.LIMIT_TAG.uploadData}`
+
+    let callingFlowProperties = {
+      identifier: {
+        servicePendingId: importBatchId,
+        reservedDataId: reservedDataId
+      },
+      importConfigId: importConfigId,
+      objType: objType
+    }
+
+    _izContext.logger.debug("callingFlowProperties", callingFlowProperties);
+
+    if (callingFlowConfig) {
+      sendMsgReservedDynamic = callingFlowSharedLib.addCallingFlowToSnsRequestMessageObject(
+        sendMsgReservedDynamic,
+        callingFlowSharedLib.addParentCallingFlowConfig(
+          callingFlowConfig,
+          callingFlowSharedLib.createCallingFlowConfig(
+            await lambdaSharedLib.lambdaFunctionName(_izContext, "ReservedLimitCompleteHdrSqs"),
+            callingFlowProperties
+          )
+        )
+      )
+    } else {
+      sendMsgReservedDynamic = callingFlowSharedLib.addCallingFlowToSnsRequestMessageObject(
+        sendMsgReservedDynamic,
+        callingFlowSharedLib.createCallingFlowConfig(
+          await lambdaSharedLib.lambdaFunctionName(_izContext, "ReservedLimitCompleteHdrSqs"),
+          callingFlowProperties
+        )
+      );
+    }
+
+    let sendMessageToReservedDynamic = {
+      Message: JSON.stringify(sendMsgReservedDynamic),
+      TopicArn: await snsSharedLib.snsTopicArn(_izContext, "InReservedDynamicUsage", consts.EXTERNAL_SERVICE_NAME.accountLimits)
+    };
+    _izContext.logger.debug("sendMessageToReservedDynamic", sendMessageToReservedDynamic);
+    await sns.publishAsync(_izContext, sendMessageToReservedDynamic);
+
+    return {
+      objType,
+      objInstaceFull,
+    }
+  } catch (err) {
+    _izContext.logger.error('error GetSignedUrlAccountLimit: ', err);
+    throw (err)
+  }
+}

package/src/reStructure/TemplateData/flowSchema/components/upload/preSignUrl/getSignUrls/sqs/data.js

@@ -0,0 +1,65 @@
+/*
+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/>.
+*/
+
+'use strict';
+
+const path = require("path")
+
+const { SOURCE_PATH, SAVE_FILE_NAME } = require('../../../../../../../../MainLibs/src/Consts');
+const { TOPIC_NAME_GENERATE_CODE } = require("../../../../../../../../GenerateCodeLibs/src/Consts");
+
+const templatePath = path.join(__dirname, './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 {Object} objectSchema
+ * @returns {Object[]}              - data of multiple dynamoDb template
+ */
+
+function data(_izContext, srcPath) {
+  let resultForCreateSqs = [];
+  const WebSocketSqsQueueNames = [];
+  const setting = {
+    initialData: "Resources:\n",
+    savePath: path.join(srcPath, SOURCE_PATH.resourceYaml),
+    saveFileName: SAVE_FILE_NAME.snsInSqsYaml,
+    fileExtension: ".yml",
+    isAppend: true
+  }
+
+  WebSocketSqsQueueNames.push(
+    {
+      queueName: "GetPresignUrl",
+      subscription: TOPIC_NAME_GENERATE_CODE.createNodeComplete
+    }
+  )
+
+  for (let WebSocketSqsQueueName of WebSocketSqsQueueNames) {
+    resultForCreateSqs.push(({
+      templatePath: templatePath,
+      templateData: WebSocketSqsQueueName,
+      setting: setting
+    }))
+  }
+  return resultForCreateSqs
+}
+module.exports = data;

package/src/reStructure/TemplateData/flowSchema/components/upload/preSignUrl/getSignUrls/sqs/template.ejs

@@ -0,0 +1,53 @@
+##===== SNS Subscription
+##===== [Topic In]
+  Subscription<%- subscription %>:
+    Type: AWS::SNS::Subscription
+    Properties:
+      TopicArn: !Ref Out<%- subscription %>
+      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
+  #<#<%- firstLetterUpperCase(queueName) %>QueueSetting#>
+  #<#/<%- firstLetterUpperCase(queueName) %>QueueSetting#>
+
+<%_ function firstLetterUpperCase(text){
+  return text.charAt(0).toUpperCase() + text.slice(1)
+} _%>
+<%_ function firstLetterLowerCase(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1)
+} _%>