@kumologica/sdk 3.0.27 → 3.0.30

package/cli/KumologicaError.js

@@ -0,0 +1,17 @@
+'use strict';
+
+class KumologicaError extends Error {
+  constructor(message, code, options = {}) {
+    super(message);
+    this.code = code;
+    this.decoratedMessage = options.decoratedMessage;
+  }
+}
+
+Object.defineProperty(KumologicaError.prototype, 'name', {
+  value: KumologicaError.name,
+  configurable: true,
+  writable: true,
+});
+
+module.exports = KumologicaError;

package/cli/cli.js

@@ -1,6 +1,9 @@
+const chalk = require('chalk');
+
 require('yargs/yargs')(process.argv.slice(2))
   .commandDir('commands')
   .demandCommand()
-  .help()
+  .help('help', 'Show usage information & exit')
+  .alias('help', 'h')
  // .epilog("copyright 2021")
   .argv

package/cli/commands/create-commands/create-project-iteratively.js

@@ -0,0 +1,42 @@
+const pathlib = require('path');
+const { prompt, Select } = require('enquirer');
+const { logNotice, logError } = require('../../utils/logger');
+const { downloadTemplateFromRepo, listAvailableTemplates } = require('../../utils/download-template-from-repo');
+
+async function createProjectIteratively(){
+    const availableTemplates = await listAvailableTemplates();
+    // Project name
+    const projectNameResponse = await prompt({
+        type: 'input',
+        name: 'projectName',
+        message: 'Enter the name for the project'
+    });
+    let aProjectName = projectNameResponse.projectName;
+
+    // Target Path
+    const directoryResponse = await prompt({
+        type: 'input',
+        name: 'directory',
+        message: 'Enter the path where the project will be created '
+    });
+    let aProjectPath = directoryResponse.directory;
+
+    // Template name
+    const promptTemplate = new Select({
+        name: 'template',
+        message: 'Pick one of the available templates',
+        choices: availableTemplates
+      });
+
+    let aTemplateName = await promptTemplate.run();
+
+    try{
+        await downloadTemplateFromRepo(undefined, aTemplateName, aProjectPath, aProjectName);
+        logNotice(`Successfully created project: ${pathlib.join(aProjectPath, aProjectName)}`)
+    } catch (err){
+        logError(`Error found while creating project due to: ${err.message}`)
+    }
+}
+    
+
+module.exports = createProjectIteratively;

package/cli/commands/create-commands/index.js

@@ -0,0 +1,5 @@
+const createProjectIteratively  = require('./create-project-iteratively');
+
+module.exports = {
+    createProjectIteratively
+}

package/cli/commands/create.js

@@ -1,32 +1,61 @@
 const pathlib = require('path');
-const { logNotice, logError } = require('./utils');
 const { codegen } = require('@kumologica/builder');
 
-exports.command = "create"
+const { logNotice, logError } = require('../utils/logger');
+const { downloadTemplateFromRepo } = require('../utils/download-template-from-repo');
+const { createProjectIteratively } = require('./create-commands');
+
+exports.command = 'create [options]'
 exports.builder = (yargs) => {
     yargs.option(`path`, {
-        describe: "The path where project will be created.",
-        demandOption: "The path is required.",
-		type: 'string',
-		alias: 'p',
-		nargs: 1
-	});
+        describe: "The project path where the project will be created",
+        // demandOption: "The path is required.",
+        type: 'string',
+        alias: 'p',
+        nargs: 1
+    })
+    yargs.option(`template`, {
+        describe: `Template for the project`,
+        type: 'string',
+        alias: 't',
+        nargs: 1
+    })
 }
 
-exports.desc = 'Create a kumologica project'
-exports.handler = ({ path }) => {
+
+exports.desc = 'Create a kumologica project. Do not pass any options to create iteratively.'
+exports.handler = async ({ path, template }) => {
     const { version } = require('../../package.json');
-    try{
-        codegen.generateBoilerplateProject({ 
-            basePath :process.cwd(), 
-            projectName: path,
-            runtimeVersion: version });
-       
-        logNotice(`Successfully created project: ${ pathlib.join(process.cwd(), path)}`);
-    } catch(e) {
-        logError(e.toString());
-        process.exit(1);
+
+    if (!path && !template) {
+        await createProjectIteratively();
+    } else if (!path && template) {
+        try{
+            await downloadTemplateFromRepo(undefined, template, process.cwd(), template);
+            logNotice(`Successfully created project: ${ pathlib.join(process.cwd(), template)}`);
+        }catch(e){
+            logError(e.message);
+        }
+    } else if (path && !template){
+        try{
+            codegen.generateBoilerplateProject({ 
+                basePath :process.cwd(), 
+                projectName: path,
+                runtimeVersion: version });
+            logNotice(`Successfully created project: ${ pathlib.join(process.cwd(), path)}`);
+        }catch(e){
+            logError(e.message);
+        }
+    } else if (path && template) {
+        path = pathlib.resolve(path);
+        let projectPath = pathlib.dirname(path);
+        let projectName = pathlib.basename(path);
+        try{
+            await downloadTemplateFromRepo(undefined, template, projectPath, projectName);
+            logNotice(`Successfully created project: ${path}`);
+        }catch(e){
+            logError(e.message);
+        }
     }
-   
-    
+        
 }

package/cli/commands/list-templates.js

@@ -0,0 +1,24 @@
+const { listAvailableTemplates } = require('../utils/download-template-from-repo');
+const { logNotice, logError, logInfo } = require('../utils/logger');
+
+exports.command = 'list-templates'
+exports.desc = 'List of available templates'
+exports.handler = async function (argv) {
+    try {
+        logInfo('List of available templates:');
+        let templates = await readerFriendly(listAvailableTemplates())
+        logNotice(templates);
+    }catch(e){
+        logError(e.message);
+    }
+}
+
+// Utils
+async function readerFriendly(templates) {
+    let result = [];
+    templates = await templates;
+    templates.forEach(t => {
+        result.push(`"${t}"`);
+    });
+    return result.join(',')
+}

package/cli/commands/open.js

@@ -1,5 +1,5 @@
 const path = require('path');
-const { logError } = require('./utils');
+const { logError } = require('../utils/logger');
 
 const rootPath = path.join(__dirname, '..', '..',);
 

package/cli/commands/test-utils/TestSuiteController.js

@@ -5,7 +5,6 @@ const path = require('path');
 const chalk = require('chalk');
 const { error } = require('./util/output');
 const got = require('got');
-const { logError } = require('../utils');
 const log = console.log;
 
 

package/cli/commands/test.js

@@ -1,14 +1,15 @@
 const chalk = require('chalk');
 const { Select } = require('enquirer');
 const fs = require('fs');
-const { logError } = require('./utils');
 const path = require('path');
 const wcmatch = require('wildcard-match');
 
 const { AppServer } = require('@kumologica/runtime');
-const { TestSuiteController } = require('./test-utils/TestSuiteController');
 const { codegen } = require('@kumologica/builder');
 
+const { TestSuiteController } = require('./test-utils/TestSuiteController');
+const { logError } = require('../utils/logger');
+
 const log = console.log;
 const APP_SERVER_PORT = 1990;
 		

package/cli/utils/download-template-from-repo.js

@@ -0,0 +1,338 @@
+'use strict';
+
+const path = require('path');
+const URL = require('url');
+const BbPromise = require('bluebird');
+const fse = require('fs-extra');
+const qs = require('querystring');
+const fetch = require('node-fetch');
+const spawn = require('child-process-ext/spawn');
+const renameService = require('./rename-service').renameService;
+const KumologicaError = require('../KumologicaError');
+const copyDirContentsSync = require('./fs/copy-dir-contents-sync');
+const dirExistsSync = require('./fs/dir-exists-sync');
+const walkDirSync = require('./fs/walk-dir-sync');
+const { getTmpDirPath, getBaseTmpDirPath } = require('./fs/get-tmp-dir-path');
+
+
+const OFFICAL_TEMPLATES_REPO = 'https://github.com/KumologicaHQ/kumologica-templates.git';
+/**
+ * Returns directory path
+ * @param {Number} length
+ * @param {Array} parts
+ * @returns {String} directory path
+ */
+function getPathDirectory(length, parts) {
+  if (!parts) {
+    return '';
+  }
+  return parts.slice(length).filter(Boolean).join(path.sep);
+}
+
+/**
+ * Validates URL
+ * @param {Object} url
+ * @param {String} hostname
+ * @param {String} service
+ * @param {String} owner
+ * @param {String} repo
+ */
+function validateUrl({ url, hostname, service, owner, repo }) {
+  // validate if given url is a valid url
+  if (url.hostname !== hostname || !owner || !repo) {
+    const errorMessage = `The URL must be a valid ${service} URL in the following format: https://${hostname}/serverless/serverless`;
+    throw new KumologicaError(errorMessage, 'INVALID_TEMPLATE_URL');
+  }
+}
+
+/**
+ * Check if the URL is pointing to a Git repository
+ * @param {String} url
+ */
+function isPlainGitURL(url) {
+  return (url.startsWith('https') || url.startsWith('git@')) && url.endsWith('.git');
+}
+
+/**
+ * @param {Object} url
+ * @returns {Object}
+ */
+function parseGitHubURL(url) {
+  const pathLength = 4;
+  const parts = url.pathname.split('/');
+  const isSubdirectory = parts.length > pathLength;
+  const owner = parts[1];
+  const repo = parts[2];
+  const branch = isSubdirectory ? parts[pathLength] : 'master';
+  const isGitHubEnterprise = url.hostname !== 'github.com';
+
+  if (!isGitHubEnterprise) {
+    // validate if given url is a valid GitHub url
+    validateUrl({ url, hostname: 'github.com', service: 'GitHub', owner, repo });
+  }
+
+  const downloadUrl = `https://${
+    isGitHubEnterprise ? url.hostname : 'github.com'
+  }/${owner}/${repo}/archive/${branch}.zip`;
+
+  return {
+    owner,
+    repo,
+    branch,
+    downloadUrl,
+    isSubdirectory,
+    pathToDirectory: getPathDirectory(pathLength + 1, parts),
+    username: url.username || '',
+    password: url.password || '',
+  };
+}
+
+/**
+ * @param {Object} url
+ * @returns {Object}
+ */
+function parseBitbucketURL(url) {
+  const pathLength = 4;
+  const parts = url.pathname.split('/');
+  const isSubdirectory = parts.length > pathLength;
+  const owner = parts[1];
+  const repo = parts[2];
+
+  const query = qs.parse(url.query);
+  const branch = 'at' in query ? query.at : 'master';
+
+  // validate if given url is a valid Bitbucket url
+  validateUrl({ url, hostname: 'bitbucket.org', service: 'Bitbucket', owner, repo });
+
+  const downloadUrl = `https://bitbucket.org/${owner}/${repo}/get/${branch}.zip`;
+
+  return {
+    owner,
+    repo,
+    branch,
+    downloadUrl,
+    isSubdirectory,
+    pathToDirectory: getPathDirectory(pathLength + 1, parts),
+    username: url.username || '',
+    password: url.password || '',
+  };
+}
+
+function parseBitbucketServerURL(url) {
+  const pathLength = 9;
+  const parts = url.pathname.split('/');
+  const isSubdirectory = parts.length > pathLength;
+  const owner = parts[5];
+  const repo = parts[7];
+
+  const query = qs.parse(url.query);
+  const branch = 'at' in query ? decodeURIComponent(query.at) : 'master';
+
+  const downloadUrl = `${url.protocol}//${url.hostname}/rest/api/latest/projects/${owner}/repos/${repo}/archive${url.search}&format=zip`;
+
+  return {
+    owner,
+    repo,
+    branch,
+    downloadUrl,
+    isSubdirectory,
+    pathToDirectory: getPathDirectory(pathLength + 1, parts),
+    username: url.username || '',
+    password: url.password || '',
+  };
+}
+
+/**
+ * Call `/rest/api/1.0/application-properties` to retrieve server info
+ * @param {Object} url
+ * @returns {Boolean}
+ */
+async function retrieveBitbucketServerInfo(url) {
+  const versionInfoPath = `${url.protocol}//${url.hostname}/rest/api/1.0/application-properties`;
+
+  return fetch(versionInfoPath)
+    .then((resp) => resp.json())
+    .then((body) => body.displayName === 'Bitbucket');
+}
+
+/**
+ * @param {Object} url
+ * @returns {Object}
+ */
+function parseGitlabURL(url) {
+  const pathLength = 4;
+  const parts = url.pathname.split('/');
+  const isSubdirectory = parts.length > pathLength;
+  const owner = parts[1];
+  const repo = parts[2];
+
+  const branch = isSubdirectory ? parts[pathLength] : 'master';
+
+  // validate if given url is a valid GitLab url
+  validateUrl({ url, hostname: 'gitlab.com', service: 'Bitbucket', owner, repo });
+
+  const downloadUrl = `https://gitlab.com/${owner}/${repo}/-/archive/${branch}/${repo}-${branch}.zip`;
+
+  return {
+    owner,
+    repo,
+    branch,
+    downloadUrl,
+    isSubdirectory,
+    pathToDirectory: getPathDirectory(pathLength + 1, parts),
+    username: url.username || '',
+    password: url.password || '',
+  };
+}
+
+/**
+ * Parses a URL which points to a plain Git repository
+ * such as https://example.com/jdoe/project.git
+ *
+ * @param {String} url
+ * @returns {Object}
+ */
+function parsePlainGitURL(url) {
+  const branch = 'master';
+  const downloadUrl = url;
+  const isSubdirectory = false;
+  const repo = url.match(/.+\/(.+)\.git/)[1];
+  return {
+    repo,
+    branch,
+    downloadUrl,
+    isSubdirectory,
+    username: url.username || '',
+    password: url.password || '',
+  };
+}
+
+/**
+ * Parse URL and call the appropriate adaptor
+ *
+ * @param {string} inputUrl
+ * @throws {KumologicaError}
+ * @returns {Promise}
+ */
+async function parseRepoURL(inputUrl) {
+  return new BbPromise((resolve, reject) => {
+    if (!inputUrl) {
+      return reject(new KumologicaError('URL is required', 'MISSING_TEMPLATE_URL'));
+    }
+
+    const url = URL.parse(inputUrl.replace(/\/$/, ''));
+    if (url.auth) {
+      const [username, password] = url.auth.split(':');
+      url.username = username;
+      url.password = password;
+    }
+
+    // check if url parameter is a valid url
+    if (!url.host && !url.href.startsWith('git@')) {
+      return reject(new KumologicaError('The URL you passed is not valid', 'INVALID_TEMPLATE_URL'));
+    }
+
+    if (isPlainGitURL(url.href)) {
+      return resolve(parsePlainGitURL(inputUrl));
+    } else if (url.hostname === 'github.com' || url.hostname.indexOf('github.') !== -1) {
+      return resolve(parseGitHubURL(url));
+    } else if (url.hostname === 'bitbucket.org') {
+      return resolve(parseBitbucketURL(url));
+    } else if (url.hostname === 'gitlab.com') {
+      return resolve(parseGitlabURL(url));
+    }
+
+    const msg =
+      'The URL you passed is not one of the valid providers: "GitHub", "GitHub Entreprise", "Bitbucket", "Bitbucket Server" or "GitLab".';
+    const err = new KumologicaError(msg, 'INVALID_TEMPLATE_PROVIDER');
+    // test if it's a private bitbucket server
+    return retrieveBitbucketServerInfo(url)
+      .then((isBitbucket) => {
+        if (!isBitbucket) {
+          return reject(err);
+        }
+
+        // build download URL
+        return resolve(parseBitbucketServerURL(url));
+      })
+      .catch(() => reject(err));
+  });
+}
+
+/**
+ * Downloads the content of the template into the projectName directory
+ * @param {string} [repoUrl] - the git repository
+ * @param {string} [templateName] - the name of the project (optional), in case we are only interested in a particular directory within the repo
+ * @param {string} projectName - the local project name / directory to be created
+ * @returns {Promise}
+ */
+async function downloadTemplateFromRepo(repoUrl, templateName, projectPath, projectName) {
+  try{
+    repoUrl = repoUrl || OFFICAL_TEMPLATES_REPO;
+    const repoInformation = await parseRepoURL(repoUrl);
+    
+    const tempBaseDirectory = getBaseTmpDirPath();
+    // clean up temp directory
+    fse.removeSync(tempBaseDirectory);
+    const tempRepoDirectory = getTmpDirPath();
+    // const { username, password } = repoInformation;
+
+    const renamed = templateName !== projectName;
+
+    // Source project directory
+    const srcProjectDir = templateName? path.join(tempRepoDirectory, templateName) : tempRepoDirectory;
+
+    // Target project directory
+    const targetProjectDir = path.join(projectPath, projectName);
+
+    if (dirExistsSync(targetProjectDir)) {
+      const errorMessage = `A project already exist in path: "${targetProjectDir}".`;
+      throw new KumologicaError(errorMessage, 'TARGET_FOLDER_ALREADY_EXISTS');
+    }
+
+    if (isPlainGitURL(repoUrl)) {
+      return spawn('git', ['clone', repoUrl, tempRepoDirectory]).then(() => {
+        try {
+          copyDirContentsSync(srcProjectDir, targetProjectDir);
+          fse.removeSync(tempBaseDirectory);
+          if (renamed) renameService(targetProjectDir, projectName);
+        }catch(err){
+          throw new KumologicaError(`Template name: "${templateName}" does not exist. Run "kl list-templates" to see list of available templates.`);
+        }
+        return "";
+      });
+    } else {
+      throw new KumologicaError(`Git repo URL is incorrect`);
+    }
+  }catch(err){
+    throw new KumologicaError(err.message);
+  }
+}
+
+async function listAvailableTemplates() {
+  try{
+    const tempBaseDirectory = getBaseTmpDirPath();
+    const tempRepoDirectory = getTmpDirPath();
+
+    await parseRepoURL(OFFICAL_TEMPLATES_REPO);
+
+    const listTemplates = spawn('git', ['clone', OFFICAL_TEMPLATES_REPO, tempRepoDirectory]).then(() => {
+        try {
+          const projects = walkDirSync(tempRepoDirectory);
+          fse.removeSync(tempBaseDirectory);
+          return projects;
+        }catch(err){
+          throw new KumologicaError(err.message);
+        }
+      });
+      // ListTemplates: ["t1", "t2"]
+      return listTemplates;
+  } catch(err){
+    throw new KumologicaError(err.message);
+  }
+}
+
+module.exports = {
+  downloadTemplateFromRepo,
+  listAvailableTemplates,
+};

package/cli/utils/download-test.js

@@ -0,0 +1,12 @@
+const { readerFriendly } = require('../commands/utils');
+const { downloadTemplateFromRepo, listAvailableTemplates } = require('./download-template-from-repo');
+
+(async()=> {
+    try{
+        // await downloadTemplateFromRepo(undefined, 'aws-api-helloworldWRONG', 'kk');
+        const result = await readerFriendly(listAvailableTemplates());
+        console.log(result);
+    } catch(err){
+        console.log('Error creating template due to: ', err.message);
+    }
+})();

package/cli/utils/download.js

@@ -0,0 +1,119 @@
+// This file is mostly adapted from https://github.com/kevva/download repository
+
+// License of the original module - https://github.com/kevva/download/blob/master/license
+
+// MIT License
+
+// Copyright (c) Kevin Mårtensson <kevinmartensson@gmail.com> (github.com/kevva)
+
+// Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+// The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+'use strict';
+
+const fsp = require('fs').promises;
+const path = require('path');
+const { URL } = require('url');
+const contentDisposition = require('content-disposition');
+const archiveType = require('archive-type');
+const decompress = require('decompress');
+const filenamify = require('filenamify');
+const getStream = require('get-stream');
+const got = require('got');
+const makeDir = require('make-dir');
+const pEvent = require('p-event');
+const FileType = require('file-type');
+const extName = require('ext-name');
+
+const filenameFromPath = (res) => path.basename(new URL(res.requestUrl).pathname);
+
+const getExtFromMime = (res) => {
+  const header = res.headers['content-type'];
+
+  if (!header) {
+    return null;
+  }
+
+  const exts = extName.mime(header);
+
+  if (exts.length !== 1) {
+    return null;
+  }
+
+  return exts[0].ext;
+};
+
+const getFilename = async (res, data) => {
+  const header = res.headers['content-disposition'];
+
+  if (header) {
+    const parsed = contentDisposition.parse(header);
+
+    if (parsed.parameters && parsed.parameters.filename) {
+      return parsed.parameters.filename;
+    }
+  }
+
+  let filename = filenameFromPath(res);
+
+  if (!path.extname(filename)) {
+    const ext = ((await FileType.fromBuffer(data)) || {}).ext || getExtFromMime(res);
+
+    if (ext) {
+      filename = `${filename}.${ext}`;
+    }
+  }
+
+  return filename;
+};
+
+module.exports = (uri, output, opts) => {
+  if (typeof output === 'object') {
+    opts = output;
+    output = null;
+  }
+
+  opts = Object.assign(
+    {
+      https: {
+        rejectUnauthorized: process.env.npm_config_strict_ssl !== 'false',
+      },
+      responseType: 'buffer',
+    },
+    opts
+  );
+
+  const stream = got.stream(uri, opts);
+
+  const promise = pEvent(stream, 'response')
+    .then((res) => {
+      const encoding = opts.responseType === 'buffer' ? 'buffer' : opts.encoding;
+      return Promise.all([getStream(stream, { encoding }), res]);
+    })
+    .then(async (result) => {
+      const [data, res] = result;
+
+      if (!output) {
+        return opts.extract && archiveType(data) ? decompress(data, opts) : data;
+      }
+
+      const filename = opts.filename || filenamify(await getFilename(res, data));
+      const outputFilepath = path.join(output, filename);
+
+      if (opts.extract && archiveType(data)) {
+        return decompress(data, path.dirname(outputFilepath), opts);
+      }
+
+      return makeDir(path.dirname(outputFilepath))
+        .then(() => fsp.writeFile(outputFilepath, data))
+        .then(() => data);
+    });
+
+  stream.then = promise.then.bind(promise);
+  stream.catch = promise.catch.bind(promise);
+
+  return stream;
+};

package/cli/utils/fs/copy-dir-contents-sync.js

@@ -0,0 +1,15 @@
+'use strict';
+
+const fse = require('fs-extra');
+
+const isNotSymbolicLink = (src) => !fse.lstatSync(src).isSymbolicLink();
+
+function copyDirContentsSync(srcDir, destDir, { noLinks = false } = {}) {
+  const copySyncOptions = {
+    dereference: true,
+    filter: noLinks ? isNotSymbolicLink : null,
+  };
+  fse.copySync(srcDir, destDir, copySyncOptions);
+}
+
+module.exports = copyDirContentsSync;

package/cli/utils/fs/create-zip-file.js

@@ -0,0 +1,39 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const archiver = require('archiver');
+const BbPromise = require('bluebird');
+const walkDirSync = require('./walk-dir-sync');
+
+async function createZipFile(srcDirPath, outputFilePath) {
+  const files = walkDirSync(srcDirPath).map((file) => ({
+    input: file,
+    output: file.replace(path.join(srcDirPath, path.sep), ''),
+  }));
+
+  return new BbPromise((resolve, reject) => {
+    const output = fs.createWriteStream(outputFilePath);
+    const archive = archiver('zip', {
+      zlib: { level: 9 },
+    });
+
+    output.on('open', () => {
+      archive.pipe(output);
+
+      files.forEach((file) => {
+        // TODO: update since this is REALLY slow
+        if (fs.lstatSync(file.input).isFile()) {
+          archive.append(fs.createReadStream(file.input), { name: file.output });
+        }
+      });
+
+      archive.finalize();
+    });
+
+    archive.on('error', (err) => reject(err));
+    output.on('close', () => resolve(outputFilePath));
+  });
+}
+
+module.exports = createZipFile;

package/cli/utils/fs/dir-exists-sync.js

@@ -0,0 +1,14 @@
+'use strict';
+
+const fse = require('fs-extra');
+
+function dirExistsSync(dirPath) {
+  try {
+    const stats = fse.statSync(dirPath);
+    return stats.isDirectory();
+  } catch (e) {
+    return false;
+  }
+}
+
+module.exports = dirExistsSync;

package/cli/utils/fs/dir-exists.js

@@ -0,0 +1,17 @@
+'use strict';
+
+const fsp = require('fs').promises;
+
+async function dirExists(path) {
+  return fsp.lstat(path).then(
+    (stats) => stats.isDirectory(),
+    (error) => {
+      if (error.code === 'ENOENT') {
+        return false;
+      }
+      throw error;
+    }
+  );
+}
+
+module.exports = dirExists;

package/cli/utils/fs/file-exists-sync.js

@@ -0,0 +1,14 @@
+'use strict';
+
+const fse = require('fs-extra');
+
+function fileExistsSync(filePath) {
+  try {
+    const stats = fse.statSync(filePath);
+    return stats.isFile();
+  } catch (e) {
+    return false;
+  }
+}
+
+module.exports = fileExistsSync;

package/cli/utils/fs/file-exists.js

@@ -0,0 +1,12 @@
+'use strict';
+
+const fsp = require('fs').promises;
+
+async function fileExists(filePath) {
+  return fsp
+    .lstat(filePath)
+    .then((stats) => stats.isFile())
+    .catch(() => false);
+}
+
+module.exports = fileExists;

package/cli/utils/fs/get-tmp-dir-path.js

@@ -0,0 +1,22 @@
+'use strict';
+
+const os = require('os');
+const path = require('path');
+const crypto = require('crypto');
+
+
+function getBaseTmpDirPath() {
+  return path.join(os.tmpdir(), 'tmp-templates-kumologica');
+}
+
+function getTmpDirPath() {
+  return path.join(
+    getBaseTmpDirPath(),
+    crypto.randomBytes(8).toString('hex')
+  );
+}
+
+module.exports = {
+  getBaseTmpDirPath,
+  getTmpDirPath
+}

package/cli/utils/fs/parse.js

@@ -0,0 +1,40 @@
+'use strict';
+
+const jc = require('json-cycle');
+const yaml = require('js-yaml');
+const _ = require('lodash');
+// const cloudformationSchema = require('@serverless/utils/cloudformation-schema');
+
+const loadYaml = (contents, options) => {
+  let data;
+  let error;
+  try {
+    data = yaml.load(contents.toString(), options || {});
+  } catch (exception) {
+    error = exception;
+  }
+  return { data, error };
+};
+
+function parse(filePath, contents) {
+  // Auto-parse JSON
+  if (filePath.endsWith('.json') || filePath.endsWith('.tfstate')) {
+    return jc.parse(contents);
+  } else if (filePath.endsWith('.yml') || filePath.endsWith('.yaml')) {
+    const options = {
+      filename: filePath,
+    };
+    let result = loadYaml(contents.toString(), options);
+    // if (result.error && result.error.name === 'YAMLException') {
+    //   _.merge(options, { schema: cloudformationSchema });
+    //   result = loadYaml(contents.toString(), options);
+    // }
+    if (result.error) {
+      throw result.error;
+    }
+    return result.data;
+  }
+  return contents.toString().trim();
+}
+
+module.exports = parse;

package/cli/utils/fs/read-file-sync.js

@@ -0,0 +1,11 @@
+'use strict';
+
+const fse = require('fs-extra');
+const parse = require('./parse');
+
+function readFileSync(filePath) {
+  const contents = fse.readFileSync(filePath);
+  return parse(filePath, contents);
+}
+
+module.exports = readFileSync;

package/cli/utils/fs/read-file.js

@@ -0,0 +1,10 @@
+'use strict';
+
+const fsp = require('fs').promises;
+const parse = require('./parse');
+
+async function readFile(filePath) {
+  return fsp.readFile(filePath, 'utf8').then((contents) => parse(filePath, contents));
+}
+
+module.exports = readFile;

package/cli/utils/fs/safe-move-file.js

@@ -0,0 +1,58 @@
+'use strict';
+
+const fsp = require('fs').promises;
+const fse = require('fs-extra');
+const crypto = require('crypto');
+const path = require('path');
+
+/**
+ * Given a path that designates a location of a file on another device,
+ * will return a path to file in the same folder, but with a unique name
+ * to avoid collisions.
+ *
+ * @param {*} destPath the path to the final location of the file being moved
+ * @returns a unique path to a file on the same device as the file being moved
+ */
+const generateTemporaryPathOnDestinationDevice = (destPath) => {
+  const dirName = path.dirname(destPath);
+  // Generate a unique destination file name to get the file onto the destination filesystem
+  const tempName = path.basename(destPath) + crypto.randomBytes(8).toString('hex');
+  return path.join(dirName, tempName);
+};
+
+/**
+ * Allows a file to be moved (renamed) even across filesystem boundaries.
+ *
+ * If the rename fails because the file is getting renamed across file system boundaries,
+ * the file is first copied to the destination file system under a temporary name,
+ * and then renamed from there.
+ *
+ * This is done because rename is atomic but copy is not, and can leave partially copied files.
+ *
+ * @param {*} oldPath the original file that should be moved
+ * @param {*} newPath the path to move the file to
+ */
+async function safeMoveFile(oldPath, newPath) {
+  try {
+    // Golden path, we simply rename the file in an atomic operation
+    await fsp.rename(oldPath, newPath);
+  } catch (err) {
+    // The EXDEV error indicates that the rename failed because the rename was across filesystem boundaries
+    // This might occur if a distro uses tmpfs for temporary directories
+    if (err.code === 'EXDEV') {
+      // Generate a unique destination file name to get the file onto the destination filesystem
+      const tempPath = generateTemporaryPathOnDestinationDevice(newPath);
+
+      // Copy onto the destination filesystem (not guaranteed to be atomic)
+      await fse.copy(oldPath, tempPath);
+      // Atomically move the file onto the destination path, overwriting it
+      await fsp.rename(tempPath, newPath);
+      // Delete the old file once both the above operations succeed
+      await fse.remove(oldPath);
+    } else {
+      throw err;
+    }
+  }
+}
+
+module.exports = safeMoveFile;

package/cli/utils/fs/walk-dir-sync.js

@@ -0,0 +1,34 @@
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+
+function walkDirSync(dirPath, opts) {
+  const options = Object.assign(
+    {
+      noLinks: false,
+      gitIgnore: true,
+      recursive: false
+    },
+    opts
+  );
+  let filePaths = [];
+  const list = fs.readdirSync(dirPath);
+  list.forEach((filePathParam) => {
+    let filePath = filePathParam;
+    filePath = path.join(dirPath, filePath);
+    const stat = options.noLinks ? fs.lstatSync(filePath) : fs.statSync(filePath);
+    // skipping symbolic links when noLinks option
+    if ((options.noLinks && stat && stat.isSymbolicLink()) || (options.gitIgnore && filePathParam === '.git')){
+      return;
+    } else if (stat && stat.isDirectory() && options.recursive) {
+      filePaths = filePaths.concat(walkDirSync(filePath, opts));
+    } else {
+      filePaths.push(filePathParam);
+    }
+  });
+
+  return filePaths;
+}
+
+module.exports = walkDirSync;

package/cli/utils/fs/write-file-sync.js

@@ -0,0 +1,31 @@
+'use strict';
+
+const fse = require('fs-extra');
+const path = require('path');
+const jc = require('json-cycle');
+const yaml = require('js-yaml');
+
+function writeFileSync(filePath, conts, cycles) {
+  let contents = conts || '';
+
+  fse.mkdirsSync(path.dirname(filePath));
+
+  if (filePath.indexOf('.json') !== -1 && typeof contents !== 'string') {
+    if (cycles) {
+      contents = jc.stringify(contents, null, 2);
+    } else {
+      contents = JSON.stringify(contents, null, 2);
+    }
+  }
+
+  const yamlFileExists = filePath.indexOf('.yaml') !== -1;
+  const ymlFileExists = filePath.indexOf('.yml') !== -1;
+
+  if ((yamlFileExists || ymlFileExists) && typeof contents !== 'string') {
+    contents = yaml.dump(contents);
+  }
+
+  return fse.writeFileSync(filePath, contents);
+}
+
+module.exports = writeFileSync;

package/cli/utils/fs/write-file.js

@@ -0,0 +1,32 @@
+'use strict';
+
+const fsp = require('fs').promises;
+const fse = require('fs-extra');
+const path = require('path');
+const jc = require('json-cycle');
+const yaml = require('js-yaml');
+
+async function writeFile(filePath, conts, cycles) {
+  let contents = conts || '';
+
+  return fse.mkdirs(path.dirname(filePath)).then(() => {
+    if (filePath.indexOf('.json') !== -1 && typeof contents !== 'string') {
+      if (cycles) {
+        contents = jc.stringify(contents, null, 2);
+      } else {
+        contents = JSON.stringify(contents, null, 2);
+      }
+    }
+
+    const yamlFileExists = filePath.indexOf('.yaml') !== -1;
+    const ymlFileExists = filePath.indexOf('.yml') !== -1;
+
+    if ((yamlFileExists || ymlFileExists) && typeof contents !== 'string') {
+      contents = yaml.dump(contents);
+    }
+
+    return fsp.writeFile(filePath, contents);
+  });
+}
+
+module.exports = writeFile;

package/cli/{commands/utils.js → utils/logger.js}

@@ -1,5 +1,6 @@
 const chalk = require('chalk');
 
+/* Loggers */
 function logError(message) {
     console.log(chalk.red(message));
 }
@@ -8,7 +9,12 @@ function logNotice(message) {
     console.log(chalk.yellow(message));
 }
 
+function logInfo(message) {
+    console.log(message);
+}
+
 module.exports = {
     logError,
-    logNotice
+    logNotice,
+    logInfo
 }

package/cli/utils/rename-service.js

@@ -0,0 +1,49 @@
+'use strict';
+
+const path = require('path');
+const fse = require('fs-extra');
+
+const fileExistsSync = require('./fs/file-exists-sync');
+const readFileSync = require('./fs/read-file-sync');
+const writeFileSync = require('./fs/write-file-sync');
+const KumologicaError = require('../KumologicaError');
+
+function renameYmlService(name, ymlServiceFile) {
+  const serverlessYml = fse
+    .readFileSync(ymlServiceFile, 'utf-8')
+    .replace(/(^|\s|#)service\s*:.+/, (ignore, prefix) => `${prefix}service: ${name}`)
+    .replace(
+      /(^|\s|#)service\s*:\s*\n(\s+)name:.+/,
+      (match, prefix, indent) => `${prefix}service:\n${indent}name: ${name}`
+    );
+
+  fse.writeFileSync(ymlServiceFile, serverlessYml);
+}
+
+function renameTsService(name, tsServicefile) {
+  const serverlessTs = fse
+    .readFileSync(tsServicefile, 'utf-8')
+    .replace(/(^|\s)service\s*:\s*('|").+('|")/, (ignore, prefix) => `${prefix}service: '${name}'`)
+    .replace(
+      /(^|\s)service\s*:\s*{\s*\n(\s+)name:\s*('|").+('|")/,
+      (match, prefix, indent) => `${prefix}service: {\n${indent}name: '${name}'`
+    );
+
+  fse.writeFileSync(tsServicefile, serverlessTs);
+}
+
+function renameService(targetProjectDir, projectName) {
+  const name = projectName;
+  const packageFile = path.join(targetProjectDir, 'package.json');
+  if (fileExistsSync(packageFile)) {
+    const json = readFileSync(packageFile);
+    writeFileSync(packageFile, Object.assign(json, { name }));
+  }
+  const packageLockFile = path.join(targetProjectDir, 'package-lock.json');
+  if (fileExistsSync(packageLockFile)) {
+    const json = readFileSync(packageLockFile);
+    writeFileSync(packageLockFile, Object.assign(json, { name }));
+  }
+}
+
+module.exports.renameService = renameService;

package/package.json

@@ -3,7 +3,7 @@
   "productName": "Kumologica Designer",
   "copyright": "Copyright 2020 Kumologica Pty Ltd, All Rights Reserved.",
   "author": "Kumologica Pty Ltd <contact@kumologica.com>",
-  "version": "3.0.27",
+  "version": "3.0.30",
   "description": "Kumologica Designer, harnessing Serverless for your cloud integration needs",
   "main": "src/app/main.js",
   "files": [
@@ -65,30 +65,41 @@
   "license": "Proprietary",
   "dependencies": {
     "@electron/remote": "^2.0.8",
-    "@kumologica/builder": "3.0.27",
-    "@kumologica/devkit": "3.0.27",
-    "@kumologica/runtime": "3.0.27",
+    "@kumologica/builder": "3.0.30",
+    "@kumologica/devkit": "3.0.30",
+    "@kumologica/runtime": "3.0.30",
     "adm-zip": "0.4.13",
     "ajv": "8.10.0",
+    "archive-type": "^4.0.0",
+    "archiver": "^1.3.0",
     "aws-sdk": "2.513.0",
     "basic-auth": "2.0.1",
     "bcryptjs": "2.4.3",
+    "bluebird": "^3.7.2",
     "body-parser": "1.19.0",
     "chalk": "2.4.2",
     "child_process": "1.0.2",
+    "child-process-ext": "^2.1.1",
     "clone": "2.1.2",
+    "content-disposition": "0.5.4",
     "cookie-parser": "1.4.4",
     "cors": "^2.8.5",
     "dagre": "^0.8.5",
-    "debounce": "^1.2.0",
+    "debounce": "1.2.1",
+    "decompress": "4.2.1",
     "electron": "19.0.0",
     "electron-tabs": "^1.0.1",
     "electron-updater": "4.3.9",
-    "enquirer": "^2.3.1",
+    "enquirer": "2.3.6",
     "express": "4.17.3",
     "express-session": "1.16.2",
+    "ext-name": "5.0.0",
     "extract-json-from-string": "1.0.1",
+    "file-type": "16.5.4",
+    "filenamify": "4.0.0",
+    "fs": "^0.0.1-security",
     "fs-extra": "10.1.0",
+    "get-stream": "^6.0.1",
     "glob": "7.1.6",
     "got": "11.8.2",
     "hash-sum": "2.0.0",
@@ -96,18 +107,24 @@
     "iconv-lite": "0.5.0",
     "ini": "^2.0.0",
     "js-yaml": "3.13.1",
+    "json-cycle": "^1.3.0",
     "jsonata": "1.7.0",
     "jsonpath": "1.0.2",
+    "lazystream": "^1.0.1",
+    "make-dir": "^3.1.0",
     "memorystore": "1.6.1",
     "mime": "2.4.4",
     "minimist": "^1.2.3",
     "multer": "1.4.1",
     "mustache": "3.0.1",
+    "node-fetch": "2.6.7",
     "oauth2orize": "1.11.0",
     "os": "0.1.1",
+    "p-event": "4.2.0",
     "passport": "0.4.0",
     "passport-http-bearer": "1.0.1",
     "passport-oauth2-client-password": "0.1.2",
+    "querystring": "^0.2.1",
     "request": "2.88.0",
     "rimraf": "3.0.0",
     "shell-path": "2.1.0",
@@ -117,6 +134,7 @@
     "socket.io": "2.3.0",
     "tcp-port-used": "1.0.2",
     "util": "0.12.1",
+    "whatwg-url": "^11.0.0",
     "when": "3.7.8",
     "wide-align": "^1.1.5",
     "wildcard-match": "^5.1.2",
@@ -160,5 +178,8 @@
   },
   "engines": {
     "node": ">=8"
+  },
+  "kumologica": {
+    "dev": false
   }
 }