@contrail/cli 1.0.50 → 1.0.53

package/lib/cli.js

@@ -4,6 +4,7 @@ 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 { MergeOptionSets } from './types/option-set-merger';
 import { MergeTypeProperties } from './types/types-properties-merger';
 import { ParseTypesFromFiles, ParseTypesFromLocalFiles, ParseTypesFromTemplateFromLocalFiles, ParseTypesFromTemplateAndDataFromLocalFiles } from './types/parse-types';
@@ -14,6 +15,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');
 /**
@@ -91,6 +93,14 @@ export async function cli(args) {
                     ParseOptionSetsLocalFiles(args);
                     break;
                 }
+                case 'parseOptionSetsHierarchyLocalFiles': {
+                    ParseOptionSetsHierarchyLocalFiles(args);
+                    break;
+                }
+                case 'uploadOptionSetsHierarchyLocalFiles': {
+                    UploadOptionSetsHierarchyLocalFiles(args);
+                    break;
+                }
                 case 'parseTypesFromLocalFiles': {
                     ParseTypesFromLocalFiles(args);
                     break;
@@ -155,10 +165,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();
                 }
@@ -307,8 +325,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.'
             }
         ],
     },
@@ -358,7 +384,15 @@ const helpSections = [
             },
             {
                 name: 'parseOptionSetsLocalFiles <File Paths>',
-                summary: 'Parse CSV files into OptionSets'
+                summary: 'Parse CSV files into OptionSets.'
+            },
+            {
+                name: 'parseOptionSetsHierarchyLocalFiles <File Paths>',
+                summary: 'Parse CSV files into OptionSetHierarchies.'
+            },
+            {
+                name: 'uploadOptionSetsHierarchyLocalFiles <File Paths> <name>',
+                summary: 'upload CSV files into OptionSetHierarchies.'
             },
             {
                 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-parser.d.ts

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

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

@@ -0,0 +1,140 @@
+import fs from 'fs';
+import { getSeparatorByPlatform } from '../common';
+import chalk from 'chalk';
+const csv = require('csvtojson');
+import { Entities } from '@contrail/sdk';
+import { StringUtil } from '@contrail/util';
+import { authUser } from '../auth/login';
+export async function ParseOptionSetsHierarchyLocalFiles(args) {
+    try {
+        await authUser();
+        if ((args === null || args === void 0 ? void 0 : args.length) < 4) {
+            throw new Error('File name must be included.');
+        }
+        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);
+        console.log('%s Parsed', chalk.yellow.bold('OPTION SET HIERARCHY PARSE'));
+    }
+    catch (e) {
+        console.log(`%s PARSE Failed. ${e}`, chalk.red.bold('FAIL'));
+        return;
+    }
+    console.log('%s PARSE Complete.', chalk.green.bold('COMPLETE'));
+}
+export async function UploadOptionSetsHierarchyLocalFiles(args) {
+    try {
+        await authUser();
+        if ((args === null || args === void 0 ? void 0 : args.length) < 4) {
+            throw new Error('File name must be included.');
+        }
+        console.log('%s Importing local file', chalk.yellow.bold('OPTION SET HIERARCHY UPLOAD'));
+        const fileLocation = args[3];
+        const name = args[4];
+        console.log('Using File: ', fileLocation);
+        console.log('Using Name: ', name);
+        await uploadOptionSetHierarchiesLocalFiles(fileLocation, name);
+        console.log('%s Uploaded', chalk.yellow.bold('OPTION SET HIERARCHY UPLOAD'));
+    }
+    catch (e) {
+        console.log(`%s UPLOAD Failed. ${e}`, chalk.red.bold('FAIL'));
+        return;
+    }
+    console.log('%s UPLOAD Complete.', chalk.green.bold('COMPLETE'));
+}
+async function loadOptionSetHierarchyCSV(fileLocation) {
+    const TARGET_DIR = process.cwd();
+    try {
+        const separator = getSeparatorByPlatform();
+        const fullPath = TARGET_DIR + separator + fileLocation;
+        console.log('Getting file from path: ', fullPath);
+        return await csv().fromFile(fullPath);
+    }
+    catch (e) {
+        throw new Error(`ERROR PARSING CSV: ${e}`);
+    }
+}
+async function parseOptionSetHierarchiesLocalFiles(fileLocation) {
+    const uploadedOptionHierarchyData = await loadOptionSetHierarchyCSV(fileLocation);
+    const optionSetHierarchy = {
+        hierarchy: [],
+        maxDepth: 0,
+        name: 'No Name',
+        options: []
+    };
+    if (!((uploadedOptionHierarchyData === null || uploadedOptionHierarchyData === void 0 ? void 0 : uploadedOptionHierarchyData.length) > 0)) {
+        return optionSetHierarchy;
+    }
+    const keysInOrder = Object.keys(uploadedOptionHierarchyData[0]);
+    const currentOptionSets = await new Entities().get({
+        entityName: 'type-property-option-set',
+    });
+    const currentOptionSetsByName = {};
+    for (const currentOptionSet of currentOptionSets) {
+        currentOptionSetsByName[StringUtil.convertToCamelCase(currentOptionSet.name)] = currentOptionSet;
+    }
+    const optionSetIds = [];
+    for (const key of keysInOrder) {
+        if (currentOptionSetsByName[key]) {
+            optionSetIds.push(currentOptionSetsByName[key].id);
+        }
+        else {
+            throw new Error(`No OptionSet found for ${key}`);
+        }
+    }
+    optionSetHierarchy.maxDepth = keysInOrder.length;
+    optionSetHierarchy.hierarchy = optionSetIds;
+    for (const row of uploadedOptionHierarchyData) {
+        addRowToOptions(optionSetHierarchy, keysInOrder, row);
+    }
+    return optionSetHierarchy;
+}
+async function parseAndSaveOptionSetHierarchiesLocalFiles(fileLocation) {
+    const optionSetHierarchy = await parseOptionSetHierarchiesLocalFiles(fileLocation);
+    saveData(optionSetHierarchy.options);
+}
+async function uploadOptionSetHierarchiesLocalFiles(fileLocation, name) {
+    const optionSetHierarchy = await parseOptionSetHierarchiesLocalFiles(fileLocation);
+    optionSetHierarchy.name = name;
+    const currentOptionSetHierarchies = await new Entities().get({
+        entityName: 'option-set-hierarchy',
+    });
+    const existing = currentOptionSetHierarchies.find(osh => osh.name === name);
+    if (existing) {
+        console.log('Updating: ', optionSetHierarchy.name);
+        await new Entities().update({
+            entityName: 'option-set-hierarchy',
+            id: existing.id,
+            object: optionSetHierarchy,
+        });
+    }
+    else {
+        console.log('Creating: ', optionSetHierarchy.name);
+        await new Entities().create({
+            entityName: 'option-set-hierarchy',
+            object: optionSetHierarchy,
+        });
+    }
+}
+function addRowToOptions(optionSetHierarchy, keysInOrder, row) {
+    let options = optionSetHierarchy.options;
+    for (let i = 0; i < keysInOrder.length; i++) {
+        const optionValues = options.map(op => op.value);
+        const value = row[keysInOrder[i]];
+        if (!optionValues.includes(value)) {
+            const obj = i === (keysInOrder.length - 1) ? { value: value } : { value: value, options: [] };
+            options.push(obj);
+            options = obj.options;
+        }
+        else {
+            const optionObj = options.find(op => op.value === value);
+            options = optionObj.options;
+        }
+    }
+}
+function saveData(data) {
+    const CURRENT_DIR = process.cwd();
+    const separator = getSeparatorByPlatform();
+    fs.writeFileSync(CURRENT_DIR + separator + 'parsed_local_optionSetHierarchy.json', JSON.stringify(data), 'utf8');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/cli",
-  "version": "1.0.50",
+  "version": "1.0.53",
   "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",

package/src/cli.ts

@@ -5,6 +5,7 @@ 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 { 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');
@@ -101,6 +103,14 @@ export async function cli(args) {
       ParseOptionSetsLocalFiles(args);
       break;
     }
+    case 'parseOptionSetsHierarchyLocalFiles': {
+      ParseOptionSetsHierarchyLocalFiles(args);
+      break;
+    }
+    case 'uploadOptionSetsHierarchyLocalFiles': {
+      UploadOptionSetsHierarchyLocalFiles(args);
+      break;
+    }
     case 'parseTypesFromLocalFiles': {
       ParseTypesFromLocalFiles(args);
       break;
@@ -165,10 +175,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();
     }
@@ -322,8 +340,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.'
     }
     ],
   },
@@ -373,7 +399,15 @@ const helpSections = [
       },
       {
         name: 'parseOptionSetsLocalFiles <File Paths>',
-        summary: 'Parse CSV files into OptionSets'
+        summary: 'Parse CSV files into OptionSets.'
+      },
+      {
+        name: 'parseOptionSetsHierarchyLocalFiles <File Paths>',
+        summary: 'Parse CSV files into OptionSetHierarchies.'
+      },
+      {
+        name: 'uploadOptionSetsHierarchyLocalFiles <File Paths> <name>',
+        summary: 'upload CSV files into OptionSetHierarchies.'
       },
       {
         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-parser.ts

@@ -0,0 +1,169 @@
+import fs from 'fs';
+import { getSeparatorByPlatform } from '../common';
+import chalk from 'chalk';
+const csv = require('csvtojson');
+import { Entities } from '@contrail/sdk';
+import { StringUtil } from '@contrail/util';
+import { authUser } from '../auth/login';
+
+export async function ParseOptionSetsHierarchyLocalFiles(args) {
+  try {
+    await authUser();
+
+    if (args?.length < 4) {
+      throw new Error('File name must be included.');
+    }
+    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);
+    console.log('%s Parsed', chalk.yellow.bold('OPTION SET HIERARCHY PARSE'));
+
+  }
+  catch (e) {
+    console.log(`%s PARSE Failed. ${e}`, chalk.red.bold('FAIL'));
+    return;
+  }
+
+  console.log('%s PARSE Complete.', chalk.green.bold('COMPLETE'));
+}
+
+export async function UploadOptionSetsHierarchyLocalFiles(args) {
+  try {
+    await authUser();
+
+    if (args?.length < 4) {
+      throw new Error('File name must be included.');
+    }
+    console.log('%s Importing local file', chalk.yellow.bold('OPTION SET HIERARCHY UPLOAD'));
+    const fileLocation = args[3];
+    const name = args[4];
+    console.log('Using File: ', fileLocation);
+    console.log('Using Name: ', name);
+
+    await uploadOptionSetHierarchiesLocalFiles(fileLocation, name);
+    console.log('%s Uploaded', chalk.yellow.bold('OPTION SET HIERARCHY UPLOAD'));
+
+  }
+  catch (e) {
+    console.log(`%s UPLOAD Failed. ${e}`, chalk.red.bold('FAIL'));
+    return;
+  }
+
+  console.log('%s UPLOAD Complete.', chalk.green.bold('COMPLETE'));
+}
+
+async function loadOptionSetHierarchyCSV(fileLocation) {
+  const TARGET_DIR = process.cwd();
+  try {
+    const separator = getSeparatorByPlatform();
+
+    const fullPath = TARGET_DIR + separator + fileLocation;
+    console.log('Getting file from path: ', fullPath);
+
+    return await csv().fromFile(fullPath);
+  } catch (e) {
+    throw new Error(`ERROR PARSING CSV: ${e}`);
+  }
+}
+
+async function parseOptionSetHierarchiesLocalFiles(fileLocation) {
+  const uploadedOptionHierarchyData = await loadOptionSetHierarchyCSV(fileLocation);
+
+  const optionSetHierarchy = {
+    hierarchy:[],
+    maxDepth: 0,
+    name: 'No Name',
+    options: []
+  };
+
+  if (!(uploadedOptionHierarchyData?.length > 0)) {
+    return optionSetHierarchy;
+  }
+
+  const keysInOrder = Object.keys(uploadedOptionHierarchyData[0]);
+  const currentOptionSets = await new Entities().get({
+    entityName: 'type-property-option-set',
+  });
+
+  const currentOptionSetsByName = {};
+  for (const currentOptionSet of currentOptionSets) {
+    currentOptionSetsByName[StringUtil.convertToCamelCase(currentOptionSet.name)] = currentOptionSet;
+  }
+
+  const optionSetIds = [];
+  for(const key of keysInOrder) {
+    if (currentOptionSetsByName[key]) {
+      optionSetIds.push(currentOptionSetsByName[key].id);
+    }
+    else {
+      throw new Error(`No OptionSet found for ${key}`);
+    }
+  }
+
+  optionSetHierarchy.maxDepth = keysInOrder.length;
+  optionSetHierarchy.hierarchy = optionSetIds;
+
+  for (const row of uploadedOptionHierarchyData) {
+    addRowToOptions(optionSetHierarchy, keysInOrder, row);
+  }
+
+  return optionSetHierarchy;
+}
+
+async function parseAndSaveOptionSetHierarchiesLocalFiles(fileLocation) {
+  const optionSetHierarchy = await parseOptionSetHierarchiesLocalFiles(fileLocation);
+  saveData(optionSetHierarchy.options);
+}
+
+async function uploadOptionSetHierarchiesLocalFiles(fileLocation, name) {
+  const optionSetHierarchy = await parseOptionSetHierarchiesLocalFiles(fileLocation);
+  optionSetHierarchy.name = name;
+
+  const currentOptionSetHierarchies = await new Entities().get({
+    entityName: 'option-set-hierarchy',
+  });
+
+  const existing = currentOptionSetHierarchies.find(osh => osh.name === name);
+
+  if (existing) {
+    console.log('Updating: ', optionSetHierarchy.name);
+    await new Entities().update({
+      entityName: 'option-set-hierarchy',
+      id: existing.id,
+      object: optionSetHierarchy,
+    });
+  }
+  else {
+    console.log('Creating: ', optionSetHierarchy.name);
+    await new Entities().create({
+      entityName: 'option-set-hierarchy',
+      object: optionSetHierarchy,
+    });
+  }
+}
+
+function addRowToOptions(optionSetHierarchy, keysInOrder, row) {
+  let options: any[] = optionSetHierarchy.options;
+
+  for (let i = 0; i < keysInOrder.length; i++) {
+    const optionValues = options.map(op => op.value);
+    const value = row[keysInOrder[i]];
+    if (!optionValues.includes(value)) {
+      const obj = i === (keysInOrder.length - 1) ? {value: value} : {value: value, options: []};
+      options.push(obj);
+      options = obj.options;
+    }
+    else {
+      const optionObj = options.find(op => op.value === value);
+      options = optionObj.options;
+    }
+  }
+}
+
+function saveData(data) {
+  const CURRENT_DIR = process.cwd();
+  const separator = getSeparatorByPlatform();
+  fs.writeFileSync(CURRENT_DIR + separator + 'parsed_local_optionSetHierarchy.json', JSON.stringify(data), 'utf8');
+}