@contrail/cli 1.0.51 → 1.0.54

package/lib/cli.js

@@ -4,7 +4,8 @@ import { getTypes } from './types/types-extractor';
 import { uploadTypes } from './types/types-uploader';
 import { UploadOptionSets } from './types/option-set-uploader';
 import { ParseOptionSetsLocalFiles } from './types/option-set-parser';
-import { ParseOptionSetsHierarchyLocalFiles, UploadOptionSetsHierarchyLocalFiles } from './types/option-set-hierarchy-parser';
+import { ParseOptionSetsHierarchyLocalFile, UploadOptionSetsHierarchyLocalFile } from './types/option-set-hierarchy-parser';
+import { ExportOptionSetsHierarchies } from './types/option-set-hierarchy-exporter';
 import { MergeOptionSets } from './types/option-set-merger';
 import { MergeTypeProperties } from './types/types-properties-merger';
 import { ParseTypesFromFiles, ParseTypesFromLocalFiles, ParseTypesFromTemplateFromLocalFiles, ParseTypesFromTemplateAndDataFromLocalFiles } from './types/parse-types';
@@ -15,6 +16,7 @@ import { installApp, uninstallApp } from './apps/install-app/app-installer';
 import { upgradeApp } from './apps/upgrade-app/app-upgrader';
 import { cliInstallWorkflowTemplateDefinitions, listWorkflowTemplateDefinitions } from './workflow-template-definitions/workflow-template-definition-commands';
 import { configureProject } from './projects/project-uploader';
+import { ListProjects, ExportProject } from './projects/project-exporter';
 import { Load, UploadAndLoad } from './loader-process/loader-process';
 const cliUsage = require('command-line-usage');
 /**
@@ -92,12 +94,16 @@ export async function cli(args) {
                     ParseOptionSetsLocalFiles(args);
                     break;
                 }
-                case 'parseOptionSetsHierarchyLocalFiles': {
-                    ParseOptionSetsHierarchyLocalFiles(args);
+                case 'parseOptionSetsHierarchyLocalFile': {
+                    ParseOptionSetsHierarchyLocalFile(args);
                     break;
                 }
-                case 'uploadOptionSetsHierarchyLocalFiles': {
-                    UploadOptionSetsHierarchyLocalFiles(args);
+                case 'uploadOptionSetsHierarchyLocalFile': {
+                    UploadOptionSetsHierarchyLocalFile(args);
+                    break;
+                }
+                case 'exportOptionSetsHierarchies': {
+                    ExportOptionSetsHierarchies();
                     break;
                 }
                 case 'parseTypesFromLocalFiles': {
@@ -164,10 +170,18 @@ export async function cli(args) {
         }
         case 'projects': {
             switch (command) {
-                case 'configure': {
+                case 'load': {
                     await configureProject(args);
                     break;
                 }
+                case 'list': {
+                    await ListProjects();
+                    break;
+                }
+                case 'export': {
+                    await ExportProject(args);
+                    break;
+                }
                 default: {
                     printIllegalCommand();
                 }
@@ -316,8 +330,16 @@ const helpSections = [
     {
         header: 'Project Commands - Domain: projects',
         content: [{
-                name: 'configure',
+                name: 'load <File Path>',
                 summary: 'Configure a project from a yml file.'
+            },
+            {
+                name: 'list',
+                summary: 'Get a list of all projects.'
+            },
+            {
+                name: 'export <Project Name>',
+                summary: 'Export a project.'
             }
         ],
     },
@@ -367,15 +389,19 @@ const helpSections = [
             },
             {
                 name: 'parseOptionSetsLocalFiles <File Paths>',
-                summary: 'Parse CSV files into OptionSets.'
+                summary: 'Parse CSV files into OptionSets.\n'
+            },
+            {
+                name: 'parseOptionSetsHierarchyLocalFile <File Path>',
+                summary: 'Parse CSV file into OptionSetHierarchy.'
             },
             {
-                name: 'parseOptionSetsHierarchyLocalFiles <File Paths>',
-                summary: 'Parse CSV files into OptionSetHierarchies.'
+                name: 'uploadOptionSetsHierarchyLocalFile <File Path> <name>',
+                summary: 'upload CSV file into OptionSetHierarchy.'
             },
             {
-                name: 'uploadOptionSetsHierarchyLocalFiles <File Paths> <name>',
-                summary: 'upload CSV files into OptionSetHierarchies.'
+                name: 'exportOptionSetsHierarchies',
+                summary: 'export OptionSetHierarchies into CSVs.\n'
             },
             {
                 name: 'parseTypesFromLocalFiles <File Paths>',

package/lib/projects/project-exporter.d.ts

@@ -0,0 +1,2 @@
+export declare function ListProjects(): Promise<void>;
+export declare function ExportProject(args: any): Promise<void>;

package/lib/projects/project-exporter.js

@@ -0,0 +1,163 @@
+import { Entities } from '@contrail/sdk';
+import { ObjectUtil } from '@contrail/util';
+import chalk from 'chalk';
+import fs from 'fs';
+import { authUser } from '../auth/login';
+import { getSeparatorByPlatform } from '../common';
+import yaml from 'js-yaml';
+export async function ListProjects() {
+    try {
+        await authUser();
+        console.log('%s Getting Projects.', chalk.blue.bold('START'));
+        await listProjects();
+        console.log('%s Done', chalk.yellow.bold('PROJECTS'));
+    }
+    catch (e) {
+        console.log(`%s Project download Failed. ${e}`, chalk.red.bold('FAIL'));
+        return;
+    }
+    console.log('%s Project download Complete.', chalk.green.bold('COMPLETE'));
+}
+export async function ExportProject(args) {
+    try {
+        await authUser();
+        console.log('%s Exporting Project.', chalk.blue.bold('START'));
+        console.log('%s Exporting', chalk.yellow.bold('PROJECT'));
+        const projectName = args[3];
+        await exportProject(projectName);
+        console.log('%s Exported', chalk.yellow.bold('PROJECT'));
+    }
+    catch (e) {
+        console.log(`%s Project Export Failed. ${e}`, chalk.red.bold('FAIL'));
+        return;
+    }
+    console.log('%s Project Export Complete.', chalk.green.bold('COMPLETE'));
+}
+async function listProjects() {
+    const allWorkspaces = await new Entities().get({
+        entityName: 'workspace',
+        criteria: { isArchived: false }
+    });
+    console.log('%s', chalk.green.bold('PROJECTS:'));
+    //console.log(allWorkspaces.map(w => Object.assign({}, {name: w.name, id: w.id}))); // if we want ids
+    console.log(allWorkspaces.map(w => w.name));
+}
+async function exportProject(name) {
+    const allWorkspaces = await new Entities().get({
+        entityName: 'workspace',
+        useSearch: false,
+    });
+    const workspace = allWorkspaces.find(w => w.name === name);
+    if (!workspace) {
+        throw new Error('Project was not found.');
+    }
+    const projectConfiguration = {
+        projectName: workspace.name,
+        identifier: workspace.identifier,
+        commonConfig: {},
+        assortments: [],
+        subFolders: []
+    };
+    const allAssortments = [];
+    await getAssortmentsAndSubFolders(workspace.id, projectConfiguration.assortments, projectConfiguration.subFolders, allAssortments);
+    await convertRelationshipsInFolders(projectConfiguration, allAssortments);
+    saveData({ projectConfiguration: projectConfiguration }, name);
+}
+async function getAssortmentsAndSubFolders(parentId, assortments, subFolders, allAssortments) {
+    const workspaceAssortments = await new Entities().get({
+        entityName: 'assortment',
+        criteria: {
+            workspaceId: parentId,
+        }
+    });
+    const integrationAssortments = workspaceAssortments === null || workspaceAssortments === void 0 ? void 0 : workspaceAssortments.filter(a => a.assortmentType === 'INTEGRATION');
+    if ((integrationAssortments === null || integrationAssortments === void 0 ? void 0 : integrationAssortments.length) > 0) {
+        allAssortments.push(...integrationAssortments);
+        for (const a of integrationAssortments) {
+            const integrationAssortmentsCopy = ObjectUtil.cloneDeep(a);
+            deleteNonUserKeys(integrationAssortmentsCopy);
+            const converted = {
+                identifier: a.identifier,
+                name: a.name,
+                type: 'ASSORTMENT',
+                sourceAssortmentIdentifier: [],
+                sourceAssortmentIds: a.sourceAssortmentIds,
+                composedFromAssortmentIdentifiers: [],
+                composedFromAssortmentIds: a.composedFromAssortmentIds,
+                assortmentAtts: Object.assign({}, integrationAssortmentsCopy),
+            };
+            assortments.push(converted);
+        }
+    }
+    console.log('workspaceFolderLinks call');
+    const workspaceFolderLinks = await new Entities().get({
+        entityName: 'workspace-entity',
+        criteria: {
+            workspaceId: parentId,
+            entityType: 'workspace'
+        },
+        relations: ['entity']
+    });
+    const workspaceFolders = workspaceFolderLinks === null || workspaceFolderLinks === void 0 ? void 0 : workspaceFolderLinks.map(wfl => wfl.entity);
+    if ((workspaceFolders === null || workspaceFolders === void 0 ? void 0 : workspaceFolders.length) > 0) {
+        for (const folder of workspaceFolders) {
+            const converted = {
+                identifier: folder.identifier,
+                name: folder.name,
+                assortments: [],
+                subFolders: [],
+            };
+            await getAssortmentsAndSubFolders(folder.id, converted.assortments, converted.subFolders, allAssortments);
+            subFolders.push(converted);
+        }
+    }
+}
+async function convertRelationshipsInFolders(folder, allAssortments) {
+    if (!(allAssortments.length > 0)) {
+        return;
+    }
+    convertRelationshipsToIdentifiers(folder.assortments, allAssortments);
+    for (const f of folder.subFolders) {
+        convertRelationshipsInFolders(f, allAssortments);
+    }
+}
+function convertRelationshipsToIdentifiers(assortments, allAssortments) {
+    if (!(allAssortments.length > 0)) {
+        return;
+    }
+    for (const assortment of assortments) {
+        if (assortment.sourceAssortmentIds) {
+            assortment.sourceAssortmentIdentifier = assortment.sourceAssortmentIds.map(id => { var _a; return (_a = allAssortments.find(a => a.id === id)) === null || _a === void 0 ? void 0 : _a.identifier; });
+        }
+        delete assortment.sourceAssortmentIds;
+        if (assortment.composedFromAssortmentIds) {
+            assortment.composedFromAssortmentIdentifiers = assortment.composedFromAssortmentIds.map(id => { var _a; return (_a = allAssortments.find(a => a.id === id)) === null || _a === void 0 ? void 0 : _a.identifier; });
+        }
+        delete assortment.composedFromAssortmentIds;
+    }
+}
+function deleteNonUserKeys(assortment) {
+    delete assortment.name;
+    delete assortment.identifier;
+    delete assortment.assortmentType;
+    delete assortment.createdById;
+    delete assortment.createdForReference;
+    delete assortment.createdOn;
+    delete assortment.entityType;
+    delete assortment.id;
+    delete assortment.orgId;
+    delete assortment.rootWorkspaceId;
+    delete assortment.composedFromAssortmentIds;
+    delete assortment.sourceAssortmentIds;
+    delete assortment.typeId;
+    delete assortment.typePath;
+    delete assortment.updatedById;
+    delete assortment.updatedOn;
+    delete assortment.workspaceId;
+}
+function saveData(data, name) {
+    const yamlStr = yaml.dump(data);
+    const CURRENT_DIR = process.cwd();
+    const separator = getSeparatorByPlatform();
+    fs.writeFileSync(CURRENT_DIR + separator + name + '-export.yml', yamlStr, 'utf8');
+}

package/lib/types/option-set-hierarchy-exporter.d.ts

@@ -0,0 +1 @@
+export declare function ExportOptionSetsHierarchies(): Promise<void>;

package/lib/types/option-set-hierarchy-exporter.js

@@ -0,0 +1,113 @@
+import fs from 'fs';
+import { getSeparatorByPlatform } from '../common';
+import chalk from 'chalk';
+import { Entities } from '@contrail/sdk';
+import { authUser } from '../auth/login';
+import { ObjectUtil, StringUtil } from '@contrail/util';
+const { Parser } = require('json2csv');
+export async function ExportOptionSetsHierarchies() {
+    try {
+        await authUser();
+        console.log('%s Exporting local file', chalk.yellow.bold('OPTION SET HIERARCHY EXPORT'));
+        await exportOptionSetHierarchies();
+        console.log('%s Exported', chalk.yellow.bold('OPTION SET HIERARCHY EXPORT'));
+    }
+    catch (e) {
+        console.log(`%s EXPORT Failed. ${e}`, chalk.red.bold('FAIL'));
+        return;
+    }
+    console.log('%s EXPORT Complete.', chalk.green.bold('COMPLETE'));
+}
+async function exportOptionSetHierarchies() {
+    const allOptionSetHierarchies = await new Entities().get({
+        entityName: 'option-set-hierarchy',
+    });
+    const currentOptionSets = await new Entities().get({
+        entityName: 'type-property-option-set',
+    });
+    for (const optionSetHierarchy of allOptionSetHierarchies) {
+        const levelNameInOrder = [];
+        for (const optionSetId of optionSetHierarchy.hierarchy) {
+            const os = currentOptionSets.find(os => os.id === optionSetId);
+            levelNameInOrder.push(StringUtil.convertToCamelCase(os.name));
+        }
+        transformAndSave(optionSetHierarchy, levelNameInOrder);
+    }
+}
+function transformAndSave(optionSetHierarchy, levelNameInOrder) {
+    const finalObjects = [];
+    transform(optionSetHierarchy.options, levelNameInOrder, [], finalObjects);
+    saveData(optionSetHierarchy.name, finalObjects, levelNameInOrder);
+}
+/*
+  Transform will take in a set if options, the names left to process, the partly completed objects, and the list to place the final objects.
+  On the first pass the list of names will be full and the list of partial objects will be empty. On this pass we create objects
+  with one field, the name of the field is the first name in levelNameInOrder. These objects are added to the workingObjects list
+  for the next run. On the following (recursive) runs there will be one less name in the levelNameInOrder (we remove the name we just processed)
+  and there will be objects to clone and add to in the workingObjects list. When all the objects have been created (There are no names
+  left in the levelNameInOrder list), all the objects are added to the finalObjects list.
+
+  Initial Input:
+  options: {value: "BTP", options: [{value: "The Great"}, {value: "The Best"}]}
+  levelNameInOrder: ["name", "title"]
+  workingObjects: []
+  finalObjects: []
+
+  Level 2 Input 1:
+  options: [{value: "The Great"}]
+  levelNameInOrder: ["title"]
+  workingObjects: [{name: "BTP"}]
+  finalObjects: []
+
+  Level 2 Input 2:
+  options: [{value: "The Best"}]
+  levelNameInOrder: ["title"]
+  workingObjects: [{name: "BTP"}]
+  finalObjects: []
+
+  Final Objects:
+  [{name: "BTP", title: "The Great"}, {name: "BTP", title: "The Best"}]
+*/
+function transform(options, levelNameInOrder, workingObjects, finalObjects) {
+    for (const option of options) {
+        const localObjects = [];
+        if (workingObjects.length === 0) {
+            localObjects.push({ [levelNameInOrder[0]]: option.value });
+            if (levelNameInOrder.length <= 1) {
+                finalObjects.push(...localObjects);
+            }
+            else {
+                transform(option.options, levelNameInOrder.slice(1), localObjects, finalObjects);
+            }
+        }
+        else {
+            for (const workingObject of workingObjects) {
+                const clone = ObjectUtil.cloneDeep(workingObject);
+                clone[levelNameInOrder[0]] = option.value;
+                localObjects.push(clone);
+            }
+            if (levelNameInOrder.length <= 1) {
+                finalObjects.push(...localObjects);
+            }
+            else {
+                transform(option.options, levelNameInOrder.slice(1), localObjects, finalObjects);
+            }
+        }
+    }
+}
+function saveData(name, data, fieldNames) {
+    const CURRENT_DIR = process.cwd();
+    const separator = getSeparatorByPlatform();
+    const opts = { fieldNames };
+    try {
+        const parser = new Parser(opts);
+        const csv = parser.parse(data);
+        fs.mkdirSync(CURRENT_DIR + separator + 'option-set-hierarchies', { recursive: true });
+        fs.writeFileSync(CURRENT_DIR + separator + 'option-set-hierarchies' + separator + name + '.csv', csv, {
+            flag: 'w',
+        });
+    }
+    catch (err) {
+        console.error(err);
+    }
+}

package/lib/types/option-set-hierarchy-parser.d.ts

@@ -1,2 +1,2 @@
-export declare function ParseOptionSetsHierarchyLocalFiles(args: any): Promise<void>;
-export declare function UploadOptionSetsHierarchyLocalFiles(args: any): Promise<void>;
+export declare function ParseOptionSetsHierarchyLocalFile(args: any): Promise<void>;
+export declare function UploadOptionSetsHierarchyLocalFile(args: any): Promise<void>;

package/lib/types/option-set-hierarchy-parser.js

@@ -5,7 +5,7 @@ const csv = require('csvtojson');
 import { Entities } from '@contrail/sdk';
 import { StringUtil } from '@contrail/util';
 import { authUser } from '../auth/login';
-export async function ParseOptionSetsHierarchyLocalFiles(args) {
+export async function ParseOptionSetsHierarchyLocalFile(args) {
     try {
         await authUser();
         if ((args === null || args === void 0 ? void 0 : args.length) < 4) {
@@ -14,7 +14,7 @@ export async function ParseOptionSetsHierarchyLocalFiles(args) {
         console.log('%s Importing local file', chalk.yellow.bold('OPTION SET HIERARCHY PARSE'));
         const fileLocation = args[3];
         console.log('Using File: ', fileLocation);
-        await parseAndSaveOptionSetHierarchiesLocalFiles(fileLocation);
+        await parseAndSaveOptionSetHierarchiesLocalFile(fileLocation);
         console.log('%s Parsed', chalk.yellow.bold('OPTION SET HIERARCHY PARSE'));
     }
     catch (e) {
@@ -23,7 +23,7 @@ export async function ParseOptionSetsHierarchyLocalFiles(args) {
     }
     console.log('%s PARSE Complete.', chalk.green.bold('COMPLETE'));
 }
-export async function UploadOptionSetsHierarchyLocalFiles(args) {
+export async function UploadOptionSetsHierarchyLocalFile(args) {
     try {
         await authUser();
         if ((args === null || args === void 0 ? void 0 : args.length) < 4) {
@@ -34,7 +34,7 @@ export async function UploadOptionSetsHierarchyLocalFiles(args) {
         const name = args[4];
         console.log('Using File: ', fileLocation);
         console.log('Using Name: ', name);
-        await uploadOptionSetHierarchiesLocalFiles(fileLocation, name);
+        await uploadOptionSetHierarchiesLocalFile(fileLocation, name);
         console.log('%s Uploaded', chalk.yellow.bold('OPTION SET HIERARCHY UPLOAD'));
     }
     catch (e) {
@@ -55,7 +55,7 @@ async function loadOptionSetHierarchyCSV(fileLocation) {
         throw new Error(`ERROR PARSING CSV: ${e}`);
     }
 }
-async function parseOptionSetHierarchiesLocalFiles(fileLocation) {
+async function parseOptionSetHierarchiesLocalFile(fileLocation) {
     const uploadedOptionHierarchyData = await loadOptionSetHierarchyCSV(fileLocation);
     const optionSetHierarchy = {
         hierarchy: [],
@@ -90,12 +90,12 @@ async function parseOptionSetHierarchiesLocalFiles(fileLocation) {
     }
     return optionSetHierarchy;
 }
-async function parseAndSaveOptionSetHierarchiesLocalFiles(fileLocation) {
-    const optionSetHierarchy = await parseOptionSetHierarchiesLocalFiles(fileLocation);
+async function parseAndSaveOptionSetHierarchiesLocalFile(fileLocation) {
+    const optionSetHierarchy = await parseOptionSetHierarchiesLocalFile(fileLocation);
     saveData(optionSetHierarchy.options);
 }
-async function uploadOptionSetHierarchiesLocalFiles(fileLocation, name) {
-    const optionSetHierarchy = await parseOptionSetHierarchiesLocalFiles(fileLocation);
+async function uploadOptionSetHierarchiesLocalFile(fileLocation, name) {
+    const optionSetHierarchy = await parseOptionSetHierarchiesLocalFile(fileLocation);
     optionSetHierarchy.name = name;
     const currentOptionSetHierarchies = await new Entities().get({
         entityName: 'option-set-hierarchy',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/cli",
-  "version": "1.0.51",
+  "version": "1.0.54",
   "description": "VibeIQ's Contrail Platform CLI.",
   "main": "lib/index.js",
   "bin": {
@@ -23,7 +23,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@contrail/sdk": "^1.1.43",
+    "@contrail/sdk": "^1.1.52",
     "@contrail/types": "^3.0.20",
     "@contrail/util": "^1.0.17",
     "amazon-cognito-identity-js": "^5.2.3",
@@ -37,6 +37,7 @@
     "execa": "^5.0.0",
     "inquirer": "^8.2.0",
     "js-yaml": "^4.1.0",
+    "json2csv": "^5.0.7",
     "listr": "^0.14.3",
     "lodash": "^4.17.21",
     "ncp": "^2.0.0",

package/src/cli.ts

@@ -5,7 +5,8 @@ import { getTypes } from './types/types-extractor';
 import { uploadTypes } from './types/types-uploader';
 import { UploadOptionSets } from './types/option-set-uploader';
 import { ParseOptionSetsLocalFiles } from './types/option-set-parser';
-import { ParseOptionSetsHierarchyLocalFiles, UploadOptionSetsHierarchyLocalFiles } from './types/option-set-hierarchy-parser';
+import { ParseOptionSetsHierarchyLocalFile, UploadOptionSetsHierarchyLocalFile } from './types/option-set-hierarchy-parser';
+import { ExportOptionSetsHierarchies } from './types/option-set-hierarchy-exporter';
 import { MergeOptionSets } from './types/option-set-merger';
 import { MergeTypeProperties } from './types/types-properties-merger';
 import { ParseTypesFromFiles, ParseTypesFromLocalFiles, ParseTypesFromTemplateFromLocalFiles, ParseTypesFromTemplateAndDataFromLocalFiles } from './types/parse-types';
@@ -16,6 +17,7 @@ import { installApp, uninstallApp } from './apps/install-app/app-installer';
 import { upgradeApp } from './apps/upgrade-app/app-upgrader';
 import { cliInstallWorkflowTemplateDefinitions, listWorkflowTemplateDefinitions } from './workflow-template-definitions/workflow-template-definition-commands';
 import { configureProject } from './projects/project-uploader';
+import { ListProjects, ExportProject } from './projects/project-exporter';
 import { Load, UploadAndLoad } from './loader-process/loader-process';
 
 const cliUsage = require('command-line-usage');
@@ -102,12 +104,16 @@ export async function cli(args) {
       ParseOptionSetsLocalFiles(args);
       break;
     }
-    case 'parseOptionSetsHierarchyLocalFiles': {
-      ParseOptionSetsHierarchyLocalFiles(args);
+    case 'parseOptionSetsHierarchyLocalFile': {
+      ParseOptionSetsHierarchyLocalFile(args);
       break;
     }
-    case 'uploadOptionSetsHierarchyLocalFiles': {
-      UploadOptionSetsHierarchyLocalFiles(args);
+    case 'uploadOptionSetsHierarchyLocalFile': {
+      UploadOptionSetsHierarchyLocalFile(args);
+      break;
+    }
+    case 'exportOptionSetsHierarchies': {
+      ExportOptionSetsHierarchies();
       break;
     }
     case 'parseTypesFromLocalFiles': {
@@ -174,10 +180,18 @@ export async function cli(args) {
   }
   case 'projects': {
     switch (command) {
-    case 'configure': {
+    case 'load': {
       await configureProject(args);
       break;
     }
+    case 'list': {
+      await ListProjects();
+      break;
+    }
+    case 'export': {
+      await ExportProject(args);
+      break;
+    }
     default: {
       printIllegalCommand();
     }
@@ -331,8 +345,16 @@ const helpSections = [
   {
     header: 'Project Commands - Domain: projects',
     content: [{
-      name: 'configure',
+      name: 'load <File Path>',
       summary: 'Configure a project from a yml file.'
+    },
+    {
+      name: 'list',
+      summary: 'Get a list of all projects.'
+    },
+    {
+      name: 'export <Project Name>',
+      summary: 'Export a project.'
     }
     ],
   },
@@ -382,15 +404,19 @@ const helpSections = [
       },
       {
         name: 'parseOptionSetsLocalFiles <File Paths>',
-        summary: 'Parse CSV files into OptionSets.'
+        summary: 'Parse CSV files into OptionSets.\n'
+      },
+      {
+        name: 'parseOptionSetsHierarchyLocalFile <File Path>',
+        summary: 'Parse CSV file into OptionSetHierarchy.'
       },
       {
-        name: 'parseOptionSetsHierarchyLocalFiles <File Paths>',
-        summary: 'Parse CSV files into OptionSetHierarchies.'
+        name: 'uploadOptionSetsHierarchyLocalFile <File Path> <name>',
+        summary: 'upload CSV file into OptionSetHierarchy.'
       },
       {
-        name: 'uploadOptionSetsHierarchyLocalFiles <File Paths> <name>',
-        summary: 'upload CSV files into OptionSetHierarchies.'
+        name: 'exportOptionSetsHierarchies',
+        summary: 'export OptionSetHierarchies into CSVs.\n'
       },
       {
         name: 'parseTypesFromLocalFiles <File Paths>',

package/src/projects/project-exporter.ts

@@ -0,0 +1,194 @@
+import { Entities } from '@contrail/sdk';
+import { ObjectUtil } from '@contrail/util';
+import chalk from 'chalk';
+import fs from 'fs';
+import { authUser } from '../auth/login';
+import { getSeparatorByPlatform } from '../common';
+import yaml from 'js-yaml';
+
+export async function ListProjects() {
+  try {
+    await authUser();
+    console.log('%s Getting Projects.', chalk.blue.bold('START'));
+
+    await listProjects();
+    console.log('%s Done', chalk.yellow.bold('PROJECTS'));
+
+  }
+  catch (e) {
+    console.log(`%s Project download Failed. ${e}`, chalk.red.bold('FAIL'));
+    return;
+  }
+
+  console.log('%s Project download Complete.', chalk.green.bold('COMPLETE'));
+}
+
+export async function ExportProject(args) {
+  try {
+    await authUser();
+    console.log('%s Exporting Project.', chalk.blue.bold('START'));
+
+    console.log('%s Exporting', chalk.yellow.bold('PROJECT'));
+    const projectName = args[3];
+    await exportProject(projectName);
+    console.log('%s Exported', chalk.yellow.bold('PROJECT'));
+
+  }
+  catch (e) {
+    console.log(`%s Project Export Failed. ${e}`, chalk.red.bold('FAIL'));
+    return;
+  }
+
+  console.log('%s Project Export Complete.', chalk.green.bold('COMPLETE'));
+}
+
+async function listProjects() {
+  const allWorkspaces = await new Entities().get({
+    entityName: 'workspace',
+    criteria: {isArchived: false}
+  });
+
+  console.log('%s', chalk.green.bold('PROJECTS:'));
+  //console.log(allWorkspaces.map(w => Object.assign({}, {name: w.name, id: w.id}))); // if we want ids
+  console.log(allWorkspaces.map(w => w.name));
+}
+
+async function exportProject(name) {
+  const allWorkspaces = await new Entities().get({
+    entityName: 'workspace',
+    useSearch: false,
+  });
+
+  const workspace = allWorkspaces.find(w => w.name === name);
+  if (!workspace) {
+    throw new Error('Project was not found.');
+  }
+
+  const projectConfiguration = {
+    projectName: workspace.name,
+    identifier: workspace.identifier,
+    commonConfig: {},
+    assortments: [],
+    subFolders: []
+  };
+
+  const allAssortments = [];
+  await getAssortmentsAndSubFolders(workspace.id, projectConfiguration.assortments, projectConfiguration.subFolders, allAssortments);
+  await convertRelationshipsInFolders(projectConfiguration, allAssortments);
+  saveData({projectConfiguration: projectConfiguration}, name);
+}
+
+async function getAssortmentsAndSubFolders(parentId, assortments, subFolders, allAssortments) {
+  const workspaceAssortments = await new Entities().get({
+    entityName: 'assortment',
+    criteria: {
+      workspaceId: parentId,
+    }
+  });
+
+  const integrationAssortments = workspaceAssortments?.filter(a => a.assortmentType === 'INTEGRATION');
+
+  if (integrationAssortments?.length > 0) {
+    allAssortments.push(...integrationAssortments);
+    for (const a of integrationAssortments) {
+      const integrationAssortmentsCopy = ObjectUtil.cloneDeep(a);
+      deleteNonUserKeys(integrationAssortmentsCopy);
+      const converted =  {
+        identifier: a.identifier,
+        name: a.name,
+        type: 'ASSORTMENT',
+        sourceAssortmentIdentifier: [],
+        sourceAssortmentIds: a.sourceAssortmentIds,
+        composedFromAssortmentIdentifiers: [],
+        composedFromAssortmentIds: a.composedFromAssortmentIds,
+        assortmentAtts: Object.assign({}, integrationAssortmentsCopy),
+      };
+      assortments.push(converted);
+    }
+  }
+
+  console.log('workspaceFolderLinks call');
+
+  const workspaceFolderLinks = await new Entities().get({
+    entityName: 'workspace-entity',
+    criteria: {
+      workspaceId: parentId,
+      entityType: 'workspace'
+    },
+    relations: ['entity']
+  });
+
+  const workspaceFolders = workspaceFolderLinks?.map(wfl => wfl.entity);
+
+  if (workspaceFolders?.length > 0) {
+    for (const folder of workspaceFolders) {
+      const converted =  {
+        identifier: folder.identifier,
+        name: folder.name,
+        assortments: [],
+        subFolders: [],
+      };
+      await getAssortmentsAndSubFolders(folder.id, converted.assortments, converted.subFolders, allAssortments);
+      subFolders.push(converted);
+    }
+  }
+
+}
+
+async function convertRelationshipsInFolders(folder, allAssortments) {
+  if (!(allAssortments.length > 0)) {
+    return;
+  }
+
+  convertRelationshipsToIdentifiers(folder.assortments, allAssortments);
+
+  for (const f of folder.subFolders) {
+    convertRelationshipsInFolders(f, allAssortments);
+  }
+
+}
+
+function convertRelationshipsToIdentifiers(assortments, allAssortments) {
+  if (!(allAssortments.length > 0)) {
+    return;
+  }
+
+  for (const assortment of assortments) {
+    if (assortment.sourceAssortmentIds) {
+      assortment.sourceAssortmentIdentifier = assortment.sourceAssortmentIds.map(id => allAssortments.find(a => a.id === id)?.identifier);
+    }
+    delete assortment.sourceAssortmentIds;
+
+    if (assortment.composedFromAssortmentIds) {
+      assortment.composedFromAssortmentIdentifiers = assortment.composedFromAssortmentIds.map(id => allAssortments.find(a => a.id === id)?.identifier);
+    }
+    delete assortment.composedFromAssortmentIds;
+  }
+}
+
+function deleteNonUserKeys(assortment) {
+  delete assortment.name;
+  delete assortment.identifier;
+  delete assortment.assortmentType;
+  delete assortment.createdById;
+  delete assortment.createdForReference;
+  delete assortment.createdOn;
+  delete assortment.entityType;
+  delete assortment.id;
+  delete assortment.orgId;
+  delete assortment.rootWorkspaceId;
+  delete assortment.composedFromAssortmentIds;
+  delete assortment.sourceAssortmentIds;
+  delete assortment.typeId;
+  delete assortment.typePath;
+  delete assortment.updatedById;
+  delete assortment.updatedOn;
+  delete assortment.workspaceId;
+}
+
+function saveData(data, name) {
+  const yamlStr = yaml.dump(data);
+  const CURRENT_DIR = process.cwd();
+  const separator = getSeparatorByPlatform();
+  fs.writeFileSync(CURRENT_DIR + separator + name + '-export.yml', yamlStr, 'utf8');
+}

package/src/types/option-set-hierarchy-exporter.ts

@@ -0,0 +1,125 @@
+import fs from 'fs';
+import { getSeparatorByPlatform } from '../common';
+import chalk from 'chalk';
+import { Entities } from '@contrail/sdk';
+import { authUser } from '../auth/login';
+import { ObjectUtil, StringUtil } from '@contrail/util';
+const { Parser } = require('json2csv');
+
+export async function ExportOptionSetsHierarchies() {
+  try {
+    await authUser();
+
+    console.log('%s Exporting local file', chalk.yellow.bold('OPTION SET HIERARCHY EXPORT'));
+    await exportOptionSetHierarchies();
+    console.log('%s Exported', chalk.yellow.bold('OPTION SET HIERARCHY EXPORT'));
+
+  }
+  catch (e) {
+    console.log(`%s EXPORT Failed. ${e}`, chalk.red.bold('FAIL'));
+    return;
+  }
+
+  console.log('%s EXPORT Complete.', chalk.green.bold('COMPLETE'));
+}
+
+async function exportOptionSetHierarchies() {
+  const allOptionSetHierarchies = await new Entities().get({
+    entityName: 'option-set-hierarchy',
+  });
+
+  const currentOptionSets = await new Entities().get({
+    entityName: 'type-property-option-set',
+  });
+
+  for (const optionSetHierarchy of allOptionSetHierarchies) {
+    const levelNameInOrder = [];
+    for (const optionSetId of optionSetHierarchy.hierarchy) {
+      const os = currentOptionSets.find(os => os.id === optionSetId);
+      levelNameInOrder.push(StringUtil.convertToCamelCase(os.name));
+    }
+    transformAndSave(optionSetHierarchy, levelNameInOrder);
+  }
+}
+
+function transformAndSave(optionSetHierarchy, levelNameInOrder) {
+  const finalObjects = [];
+  transform(optionSetHierarchy.options, levelNameInOrder, [], finalObjects);
+  saveData(optionSetHierarchy.name, finalObjects, levelNameInOrder);
+}
+
+/*
+  Transform will take in a set if options, the names left to process, the partly completed objects, and the list to place the final objects.
+  On the first pass the list of names will be full and the list of partial objects will be empty. On this pass we create objects
+  with one field, the name of the field is the first name in levelNameInOrder. These objects are added to the workingObjects list
+  for the next run. On the following (recursive) runs there will be one less name in the levelNameInOrder (we remove the name we just processed)
+  and there will be objects to clone and add to in the workingObjects list. When all the objects have been created (There are no names
+  left in the levelNameInOrder list), all the objects are added to the finalObjects list.
+
+  Initial Input:
+  options: {value: "BTP", options: [{value: "The Great"}, {value: "The Best"}]}
+  levelNameInOrder: ["name", "title"]
+  workingObjects: []
+  finalObjects: []
+
+  Level 2 Input 1:
+  options: [{value: "The Great"}]
+  levelNameInOrder: ["title"]
+  workingObjects: [{name: "BTP"}]
+  finalObjects: []
+
+  Level 2 Input 2:
+  options: [{value: "The Best"}]
+  levelNameInOrder: ["title"]
+  workingObjects: [{name: "BTP"}]
+  finalObjects: []
+
+  Final Objects:
+  [{name: "BTP", title: "The Great"}, {name: "BTP", title: "The Best"}]
+*/
+function transform(options, levelNameInOrder, workingObjects, finalObjects) {
+  for (const option of options) {
+    const localObjects = [];
+    if (workingObjects.length === 0) {
+      localObjects.push({[levelNameInOrder[0]]: option.value});
+      if (levelNameInOrder.length <= 1) {
+        finalObjects.push(...localObjects);
+      }
+      else {
+        transform(option.options, levelNameInOrder.slice(1,), localObjects, finalObjects);
+      }
+    }
+    else {
+      for (const workingObject of workingObjects) {
+        const clone = ObjectUtil.cloneDeep(workingObject);
+        clone[levelNameInOrder[0]] = option.value;
+        localObjects.push(clone);
+      }
+
+      if (levelNameInOrder.length <= 1) {
+        finalObjects.push(...localObjects);
+      }
+      else {
+        transform(option.options, levelNameInOrder.slice(1,), localObjects, finalObjects);
+      }
+    }
+  }
+
+}
+
+function saveData(name, data, fieldNames) {
+  const CURRENT_DIR = process.cwd();
+  const separator = getSeparatorByPlatform();
+  const opts = { fieldNames };
+
+  try {
+    const parser = new Parser(opts);
+    const csv = parser.parse(data);
+    fs.mkdirSync(CURRENT_DIR + separator + 'option-set-hierarchies', { recursive: true });
+    fs.writeFileSync(CURRENT_DIR + separator + 'option-set-hierarchies' + separator + name + '.csv', csv, {
+      flag: 'w',
+    });
+  } catch (err) {
+    console.error(err);
+  }
+}

package/src/types/option-set-hierarchy-parser.ts

@@ -6,7 +6,7 @@ import { Entities } from '@contrail/sdk';
 import { StringUtil } from '@contrail/util';
 import { authUser } from '../auth/login';
 
-export async function ParseOptionSetsHierarchyLocalFiles(args) {
+export async function ParseOptionSetsHierarchyLocalFile(args) {
   try {
     await authUser();
 
@@ -17,7 +17,7 @@ export async function ParseOptionSetsHierarchyLocalFiles(args) {
     const fileLocation = args[3];
     console.log('Using File: ', fileLocation);
 
-    await parseAndSaveOptionSetHierarchiesLocalFiles(fileLocation);
+    await parseAndSaveOptionSetHierarchiesLocalFile(fileLocation);
     console.log('%s Parsed', chalk.yellow.bold('OPTION SET HIERARCHY PARSE'));
 
   }
@@ -29,7 +29,7 @@ export async function ParseOptionSetsHierarchyLocalFiles(args) {
   console.log('%s PARSE Complete.', chalk.green.bold('COMPLETE'));
 }
 
-export async function UploadOptionSetsHierarchyLocalFiles(args) {
+export async function UploadOptionSetsHierarchyLocalFile(args) {
   try {
     await authUser();
 
@@ -42,7 +42,7 @@ export async function UploadOptionSetsHierarchyLocalFiles(args) {
     console.log('Using File: ', fileLocation);
     console.log('Using Name: ', name);
 
-    await uploadOptionSetHierarchiesLocalFiles(fileLocation, name);
+    await uploadOptionSetHierarchiesLocalFile(fileLocation, name);
     console.log('%s Uploaded', chalk.yellow.bold('OPTION SET HIERARCHY UPLOAD'));
 
   }
@@ -68,7 +68,7 @@ async function loadOptionSetHierarchyCSV(fileLocation) {
   }
 }
 
-async function parseOptionSetHierarchiesLocalFiles(fileLocation) {
+async function parseOptionSetHierarchiesLocalFile(fileLocation) {
   const uploadedOptionHierarchyData = await loadOptionSetHierarchyCSV(fileLocation);
 
   const optionSetHierarchy = {
@@ -112,13 +112,13 @@ async function parseOptionSetHierarchiesLocalFiles(fileLocation) {
   return optionSetHierarchy;
 }
 
-async function parseAndSaveOptionSetHierarchiesLocalFiles(fileLocation) {
-  const optionSetHierarchy = await parseOptionSetHierarchiesLocalFiles(fileLocation);
+async function parseAndSaveOptionSetHierarchiesLocalFile(fileLocation) {
+  const optionSetHierarchy = await parseOptionSetHierarchiesLocalFile(fileLocation);
   saveData(optionSetHierarchy.options);
 }
 
-async function uploadOptionSetHierarchiesLocalFiles(fileLocation, name) {
-  const optionSetHierarchy = await parseOptionSetHierarchiesLocalFiles(fileLocation);
+async function uploadOptionSetHierarchiesLocalFile(fileLocation, name) {
+  const optionSetHierarchy = await parseOptionSetHierarchiesLocalFile(fileLocation);
   optionSetHierarchy.name = name;
 
   const currentOptionSetHierarchies = await new Entities().get({