@izara_project/izara-core-generate-service-code 1.0.1 → 1.0.3

package/src/TemplateData/relationshipPerAction/get/action/handler/templateByHandler/invTemplate.ejs

@@ -0,0 +1,122 @@
+/*
+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 { middlewareHandler as middleware, validatorSchema } from "@izara_project/izara-middleware";
+import callingFlowSharedLib from '@izara_project/izara-core-library-calling-flow';
+
+//(<optionalRequire>)
+//(</optionalRequire>)
+
+import <%- functionName %> from './<%- firstLetterUpperCase(functionName) %>_Main.js'
+
+// validate event params in middlewware before into function.
+let validator = {
+  type: "object",
+  required: ["firstObject", "secondObject", "relType", 'relId'],
+  properties: {
+    firstObject: {
+      type: "object",
+      required: ["objType", "identifiers"],
+      properties: {
+        objType: {
+          type: "object",
+          required: ["serviceTag", "objectType"],
+          properties: {
+            serviceTag: validatorSchema.stringNotEmpty(),
+            objectType: validatorSchema.stringNotEmpty()
+          }
+        },
+        identifiers: {
+          type: "object",
+          minProperties: 1
+        }
+      }
+    },
+    secondObject: {
+      type: "object",
+      required: ["objType", "identifiers"],
+      properties: {
+        objType: {
+          type: "object",
+          required: ["serviceTag", "objectType"],
+          properties: {
+            serviceTag: validatorSchema.stringNotEmpty(),
+            objectType: validatorSchema.stringNotEmpty()
+          }
+        },
+        identifiers: {
+          type: "object",
+          minProperties: 1
+        }
+      }
+    },
+    relType: {
+      type: "object",
+      required: ["relationshipTag", "serviceTag"],
+      properties: {
+        relationshipTag: validatorSchema.stringNotEmpty(),
+        serviceTag: {
+          type: 'string',
+          pattern: "^[a-zA-Z0-9_-]+$",
+          enum: [process.env.iz_serviceTag]
+        },
+      }
+    },
+    relationshipDirection: {
+      type: "string",
+      default: ""
+    },
+    relId: {
+      type: 'string',
+    },
+  }
+};
+
+validator = callingFlowSharedLib.addOptionalCallingFlowToValidatorSchema(validator); // is Ok callinfFlow
+middleware.setValidatorSchema(validator)
+
+export const main = middleware.wrap(async (event, context) => {
+  event._izContext.logger.debug('Event:', event);
+  event._izContext.logger.debug('context:', context);
+
+  try {
+    // invoke LambdaFunction
+    return await <%- functionName %>(
+      event._izContext, // correlationId/logger/integrationTestDetail/uniqueRequestId
+      {
+        firstObject: event.firstObject,
+        secondObject: event.secondObject,
+        relType: event.relType,
+        relationshipDirection: event.relationshipDirection,
+        relationshipProperties: event.relationshipProperties,
+      },
+      callingFlowSharedLib.addCallingFlowToPassOnProperties(event)
+    );
+
+  } catch (err) {
+    event._izContext.logger.error('Error, <%- firstLetterUpperCase(functionName) %><%- firstLetterUpperCase(handler) %> : ', err);
+    throw (err);
+  }
+});
+<%_ function firstLetterUpperCase(text) {
+  return text.charAt(0).toUpperCase() + text.slice(1)
+} _%>
+<%_ function firstLetterLowerCase(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1)
+} _%>

package/src/TemplateData/relationshipPerAction/get/action/handler/templateByHandler/sqsTemplate.ejs

@@ -0,0 +1,163 @@
+/*
+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 { middlewareHandler as middleware, validatorSchema } from "@izara_project/izara-middleware";
+import callingFlowSharedLib from '@izara_project/izara-core-library-calling-flow';
+import Logger from '@izara_project/izara-core-library-logger';
+import { recordHandlerSharedLib } from '@izara_project/izara-core-library-record-handler';
+
+//(<optionalRequire>)
+//(</optionalRequire>)
+
+import <%- functionName %>  from './<%- firstLetterUpperCase(functionName) %>_Main.js';
+
+middlewareHandler.setValidatorSchema(recordHandlerSharedLib.baseValidatorSchema());
+
+// validate event params in middlewareHandler before into function
+let basicValidatorSchema = {
+  type: "object",
+  required: ["firstObject", "secondObject", "relType", 'relId'],
+  properties: {
+    firstObject: {
+      type: "object",
+      required: ["objType", "identifiers"],
+      properties: {
+        objType: {
+          type: "object",
+          required: ["serviceTag", "objectType"],
+          properties: {
+            serviceTag: validatorSchema.stringNotEmpty(),
+            objectType: validatorSchema.stringNotEmpty()
+          }
+        },
+        identifiers: {
+          type: "object",
+          minProperties: 1
+        }
+      }
+    },
+    secondObject: {
+      type: "object",
+      required: ["objType", "identifiers"],
+      properties: {
+        objType: {
+          type: "object",
+          required: ["serviceTag", "objectType"],
+          properties: {
+            serviceTag: validatorSchema.stringNotEmpty(),
+            objectType: validatorSchema.stringNotEmpty()
+          }
+        },
+        identifiers: {
+          type: "object",
+          minProperties: 1
+        }
+      }
+    },
+    relType: {
+      type: "object",
+      required: ["relationshipTag", "serviceTag"],
+      properties: {
+        relationshipTag: validatorSchema.stringNotEmpty(),
+        serviceTag: {
+          type: 'string',
+          pattern: "^[a-zA-Z0-9_-]+$",
+          enum: [process.env.iz_serviceTag]
+        },
+      }
+    },
+    relationshipDirection: {
+      type: "string",
+      default: ""
+    },
+    relId: {
+      type: 'string',
+    },
+  }
+};
+
+
+
+//(<globalVariable>
+  //</globalVariable>)
+
+  // validate event params in middlewareHandler before into main function
+  basicValidatorSchema = callingFlowSharedLib.addOptionalCallingFlowToValidatorSchema(basicValidatorSchema);
+  // if need to validate authorizer or additional params , add code to hook tag below
+
+  //(<afterValidateWith>)
+  //(</afterValidateWith>)
+
+  export const main = middlewareHandler.wrap(async (event, context) => {
+
+    try {
+
+      let recordPromises = []; // final return
+
+      // loop each record and send to mainFunction
+      await Promise.all(event.Records.map(async record => { // promise.all for map() function
+
+        let passOnProperties = []
+
+        // --- validate message (and MessageAttributes)
+        await recordHandlerSharedLib.validateRecord(
+          record, // one record will send to mainFunction
+          "<%-firstLetterUpperCase(queueName) %>",                       // queue name that need to retry or send to dlq
+          basicValidatorSchema, // 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)
+        passOnProperties.push(callingFlowSharedLib.addCallingFlowToPassOnProperties(record.body.Message));
+        //(<afterPutParamIntoMainFunction>)
+        //(</afterPutParamIntoMainFunction>)
+
+        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
+          <%- functionName %>.<%- functionName %>,     // mainFunction that need to invoke.
+          "<%-firstLetterUpperCase(queueName) %>",                          // 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
+        })) //end record
+
+        Logger.debug('before Promise.all(recordPromises) in handler');
+        try {
+          await Promise.all(recordPromises); // await all promises
+          return event.Records // return all for local test
+        } 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, updateRelationshipHdrDsq:', err);
+        throw (err);
+      }
+    });
+  <%_ function firstLetterUpperCase(text) {
+    return text.charAt(0).toUpperCase() + text.slice(1)
+  } _%>
+  <%_ function firstLetterLowerCase(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1)
+  } _%>

package/src/TemplateData/relationshipPerAction/get/action/mainFunction/data.js

@@ -0,0 +1,57 @@
+/*
+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, FUNCTION_NAME } = consts;
+
+const { firstLetterLowerCase: lowerCase, firstLetterUpperCase: upperCase } = utils;
+const templatePath = path.join(__dirname, 'template.ejs');
+
+/**
+ * receive objectSchema
+ * create data for hdrInv template
+ *
+ * @param {Object} objectSchema
+ * @return {{ templatePath, templateData, setting } }
+ */
+function data(_izContext, srcPath) {
+  const createSourceParams = createParamForCreateSource(srcPath);
+  return [createSourceParams];
+}
+
+function createParamForCreateSource(srcPath) {
+  let functionName = FUNCTION_NAME.getRel;
+  return {
+    templatePath: templatePath,
+    templateData: {
+      functionName
+    },
+    setting: {
+      savePath: path.join(srcPath, SOURCE_PATH.relationshipPerAction),
+      saveFileName: `${upperCase(FUNCTION_NAME.getRel)}_Main`,
+      fileExtension: '.js',
+      isAppend: false
+    }
+  };
+}
+
+export default data;

package/src/TemplateData/relationshipPerAction/get/action/mainFunction/template.ejs

@@ -0,0 +1,320 @@
+/*
+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 } 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,lambda } from "@izara_project/izara-core-library-external-request";
+
+import { getObjectSchema, utils, serviceConfig, consts, relSchemaLib, identifiersObject } from '@izara_project/izara-core-library-service-schemas'
+const { findLinksByObjTypes } = relSchemaLib;
+
+const {
+  getRelationshipSchemaWithCache,
+  getObjSchemaS3WithHierarchy
+} = getObjectSchema
+
+const {
+  createLinkTypeId
+} = utils;
+
+const {
+  getGraphServiceTagWithCache
+} = serviceConfig;
+
+import { consts as generateCodeConsts } from '@izara_project/izara-core-generate-service-code';
+const {
+  PREFIX,
+  TOPIC_NAME_GENERATE_CODE,
+  TOPIC_NAME_GRAPH_HANDLER
+} = generateCodeConsts;
+
+import { consts as coreConsts } from '@izara_project/izara-core-library-core';
+
+//(<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 getRelationship(
+  _izContext,
+  requestParams,
+  callingFlowConfig = {},
+  //(<additionalParams>)
+  //(</additionalParams>)
+) {
+
+
+  try {
+    _izContext.logger.debug('createRelationship _izContext: ', _izContext);
+    _izContext.logger.debug('createRelationship requestParams: ', requestParams);
+    _izContext.logger.debug('createRelationship callingFlowConfig: ', callingFlowConfig);
+
+
+    const {
+      firstObject,
+      secondObject,
+      relType,
+      relId,
+      relationshipDirection,
+      //(<requestParamGetRel>)
+      //(</requestParamGetRel>)
+    } = requestParams;
+
+    let errorsFound = [];
+
+    //(<beforeValidateGetRel>)
+    //(</beforeValidateGetRel>).
+    // 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 identifierNames = schemaIdentifier.fieldNames || [schemaIdentifier.fieldName];
+        for (const identifierName of identifierNames) {
+          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`);
+            }
+          }
+        }
+      }
+    }
+
+    await validateIdentifiersExists(_izContext, firstObject.objType, firstObject.identifiers);
+    await validateIdentifiersExists(_izContext, secondObject.objType, secondObject.identifiers);
+    // finished validate object and identifiers
+
+    //(<afterValidateGetRel>)
+    //(</afterValidateGetRel>)
+
+    //(<beforeGetRel>)
+    //(</beforeGetRel>)
+
+    const relationshipSchema = await getRelationshipSchemaWithCache(_izContext, relType);
+    _izContext.logger.debug("relationshipSchema: ", relationshipSchema);
+
+    const links = await findLinksByObjTypes(_izContext, [firstObject.objType, secondObject.objType], relationshipSchema.links)
+    _izContext.logger.debug("links", links)
+    if (!links.length) {
+      errorsFound.push(`not found link between ${JSON.stringify({ firstObject: firstObject.objType })} ${JSON.stringify({ secondObject: secondObject.objType })}`)
+    };
+
+    let targetStorageResources = [];
+
+    if (relationshipSchema) {
+      // 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 } = firstObject.objType;
+          const { serviceTag: secondServiceTag, objectType: secondObjectType } = 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);
+              }
+            }));
+          }
+        })
+      );
+      //(<afterGetRelCreateRel>)
+      //(</afterGetRelCreateRel>)
+      _izContext.logger.debug("targetStorageResources: ", targetStorageResources);
+
+      if (!targetStorageResources.length) {
+        errorsFound.push(`Not found link from relationship schema`);
+      }
+    } else {
+      errorsFound.push(`relationshipSchema not exists`);
+    }
+
+
+    // if found errors will stop processing
+    if (errorsFound.length) {
+
+      let getRelCompleteMsg = {
+        firstObject: firstObject,
+        secondObject: secondObject,
+        relType: relType,
+        relationshipDirection,
+        //(<inGetRelCompleteMsgCrateRel>)
+        //(</inGetRelCompleteMsgCrateRel>)
+        status: 'error',
+        errorsFound: errorsFound
+      };
+
+      // if have callingFlow will send to message complete
+      if (callingFlowConfig[callingFlowSharedLib.consts.CALLINGFLOW_PROPERTYNAME]) {
+        _izContext.logger.debug("HAVE CallingFlow");
+
+        getRelCompleteMsg = callingFlowSharedLib.addPassBackPropertiesToSnsResponseMessageObject(callingFlowConfig, getRelCompleteMsg);
+        let messageAttributes = callingFlowSharedLib.addCallingFlowToSnsResponseMessageAttributes(callingFlowConfig, {});
+
+        let messageParams = {
+          Message: JSON.stringify(getRelCompleteMsg),
+          MessageAttributes: sns.createStringMessageAttributes(_izContext, messageAttributes),
+          TopicArn: await snsSharedLib.snsTopicArnByFlowSchema(_izContext, TOPIC_NAME_GENERATE_CODE.outGetRelComplete),
+        };
+
+        _izContext.logger.debug("messageParams OutCreateRelationshipComplete ::::::: ", messageParams);
+        await sns.publishAsync(_izContext, messageParams);
+      }
+
+      return getRelCompleteMsg;
+    }
+
+    let usedGraphServiceTag = []; // collect used graph serviceTag, use to check duplicate graph serviceTag across graph serverTag
+    let targetGraphStorageResources = []; // collect used graph storageResources, filtered duplicate graphServiceTag from graphServerTag out
+
+    for (const targetStorageResource of targetStorageResources) {
+      if (targetStorageResource.storageType === consts.STORAGE_TYPES.graph &&
+        !usedGraphServiceTag.includes(targetStorageResource.graphServiceTag)
+      ) {
+        usedGraphServiceTag.push(targetStorageResource.graphServiceTag);
+        targetGraphStorageResources.push(targetStorageResource);
+      }
+    }
+    let result;
+    await Promise.all(
+      targetGraphStorageResources.map(async (storageResource) => {
+        if (storageResource.storageType === consts.STORAGE_TYPES.graph) {
+          result = await graphSharedLib.getRelationshipV2(
+            _izContext,
+            storageResource.graphServiceTag,
+            firstObject,
+            secondObject,
+            relType,
+            relId,
+            relationshipDirection
+          )
+        } else if (storageResource.storageType === consts.STORAGE_TYPES.dynamoDB) {
+
+          // if have storageResource.storageType === "dynamoDB" will create relationship here
+          let tableNameFrom = `${firstObject.objType.serviceTag}_${firstObject.objType.objectType}__${relType.relationshipTag}__${secondObject.objType.serviceTag}_${secondObject.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`;
+          // putItem first Object DynamoDb
+          let getResultFromDynamo = await dynamodbSharedLib.getItem(_izContext,
+            await dynamodbSharedLib.tableName(_izContext, tableNameFrom),
+            {
+              [firstObjectIdentifiersConcat]: identifiersConcatFirstObject,
+              [secondObjectIdentifiersConcat]: identifiersConcatSecondObject
+            }
+          )
+          result = getResultFromDynamo;
+        }
+      })
+    )
+
+    let messageObject = {
+      firstObject: firstObject,
+      secondObject: secondObject,
+      relType: relType,
+      relId: relId,
+      relationshipDirection,
+      result: result
+    };
+
+    if (callingFlowConfig[callingFlowSharedLib.consts.CALLINGFLOW_PROPERTYNAME]) {
+      _izContext.logger.debug("have callingFlow");
+      messageObject = callingFlowSharedLib.addPassBackPropertiesToSnsResponseMessageObject(callingFlowConfig, messageObject);
+
+      let messageAttributes = callingFlowSharedLib.addCallingFlowToSnsResponseMessageAttributes(callingFlowConfig, {});
+      let sendMessageToOutGetRelComplete = {
+        Message: JSON.stringify(messageObject),
+        MessageAttributes: sns.createStringMessageAttributes(_izContext, messageAttributes),
+        TopicArn: await snsSharedLib.snsTopicArnByFlowSchema(_izContext, TOPIC_NAME_GENERATE_CODE.outGetRelComplete)
+      }
+      _izContext.logger.debug("send Message to outCreateRelationshipComplete :::", sendMessageToOutGetRelComplete);
+      await sns.publishAsync(_izContext, sendMessageToOutGetRelComplete);
+
+    }
+
+    return {
+      firstObject: firstObject,
+      secondObject: secondObject,
+      relType: relType,
+      relId: relId,
+      relationshipDirection,
+      result: result,
+      status: "complete"
+    };
+
+
+  } catch (err) {
+    _izContext.logger.error('error getRelationship: ', err)
+    throw (err)
+  }
+}