@dittowords/cli 3.7.0 → 3.9.0

package/.idea/prettier.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PrettierConfiguration">
+    <option name="myRunOnSave" value="true" />
+  </component>
+</project>

package/.idea/workspace.xml

@@ -1,13 +1,20 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ChangeListManager">
-    <list default="true" id="d2834f12-3435-41b5-8efa-c62f3f4baa0d" name="Changes" comment="Remove redundant variable" />
+    <list default="true" id="d2834f12-3435-41b5-8efa-c62f3f4baa0d" name="Changes" comment="Add remaining column mappings">
+      <change beforePath="$PROJECT_DIR$/lib/ditto.ts" beforeDir="false" afterPath="$PROJECT_DIR$/lib/ditto.ts" afterDir="false" />
+    </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
     <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
     <option name="LAST_RESOLUTION" value="IGNORE" />
   </component>
   <component name="Git.Settings">
+    <option name="RECENT_BRANCH_BY_REPOSITORY">
+      <map>
+        <entry key="$PROJECT_DIR$" value="master" />
+      </map>
+    </option>
     <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
   </component>
   <component name="GitSEFilterConfiguration">
@@ -28,15 +35,40 @@
     <property name="RunOnceActivity.OpenProjectViewOnStart" value="true" />
     <property name="RunOnceActivity.ShowReadmeOnStart" value="true" />
     <property name="WebServerToolWindowFactoryState" value="false" />
+    <property name="last_opened_file_path" value="$PROJECT_DIR$/lib/http" />
     <property name="node.js.detected.package.eslint" value="true" />
     <property name="node.js.detected.package.standard" value="true" />
     <property name="node.js.selected.package.eslint" value="(autodetect)" />
     <property name="node.js.selected.package.standard" value="" />
+    <property name="nodejs.jest.jest_package" value="$PROJECT_DIR$/node_modules/jest" />
     <property name="nodejs_package_manager_path" value="yarn" />
-    <property name="settings.editor.selected.configurable" value="web-ide.project.structure" />
+    <property name="prettierjs.PrettierConfiguration.Package" value="$PROJECT_DIR$/node_modules/prettier" />
+    <property name="settings.editor.selected.configurable" value="settings.javascript.prettier" />
     <property name="ts.external.directory.path" value="$PROJECT_DIR$/node_modules/typescript/lib" />
     <property name="vue.rearranger.settings.migration" value="true" />
   </component>
+  <component name="RecentsManager">
+    <key name="CopyFile.RECENT_KEYS">
+      <recent name="$PROJECT_DIR$/lib/http" />
+    </key>
+  </component>
+  <component name="RunManager">
+    <configuration name="generate-suggestions.test.ts" type="JavaScriptTestRunnerJest" temporary="true" nameIsGenerated="true">
+      <node-interpreter value="project" />
+      <node-options value="" />
+      <jest-package value="$PROJECT_DIR$/node_modules/jest" />
+      <working-dir value="$PROJECT_DIR$" />
+      <envs />
+      <scope-kind value="TEST_FILE" />
+      <test-file value="$PROJECT_DIR$/lib/generate-suggestions.test.ts" />
+      <method v="2" />
+    </configuration>
+    <recent_temporary>
+      <list>
+        <item itemvalue="Jest.generate-suggestions.test.ts" />
+      </list>
+    </recent_temporary>
+  </component>
   <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
   <component name="TaskManager">
     <task active="true" id="Default" summary="Default task">
@@ -52,6 +84,17 @@
       <workItem from="1685980367078" duration="303000" />
       <workItem from="1685980682884" duration="824000" />
       <workItem from="1685986712012" duration="5115000" />
+      <workItem from="1686000886228" duration="2633000" />
+      <workItem from="1686069506429" duration="76000" />
+      <workItem from="1686087849012" duration="140000" />
+      <workItem from="1686168915499" duration="2643000" />
+      <workItem from="1686172029566" duration="5629000" />
+      <workItem from="1686604031092" duration="6110000" />
+      <workItem from="1686665537695" duration="7000" />
+      <workItem from="1686666962638" duration="1318000" />
+      <workItem from="1686672751040" duration="103000" />
+      <workItem from="1686758001057" duration="1199000" />
+      <workItem from="1686764622070" duration="41000" />
     </task>
     <task id="LOCAL-00001" summary="Remove eslint">
       <created>1685986802039</created>
@@ -74,7 +117,70 @@
       <option name="project" value="LOCAL" />
       <updated>1685993770336</updated>
     </task>
-    <option name="localTasksCounter" value="4" />
+    <task id="LOCAL-00004" summary="Add command to show component-folders">
+      <created>1686001523646</created>
+      <option name="number" value="00004" />
+      <option name="presentableId" value="LOCAL-00004" />
+      <option name="project" value="LOCAL" />
+      <updated>1686001523646</updated>
+    </task>
+    <task id="LOCAL-00005" summary="Command description">
+      <created>1686002294377</created>
+      <option name="number" value="00005" />
+      <option name="presentableId" value="LOCAL-00005" />
+      <option name="project" value="LOCAL" />
+      <updated>1686002294377</updated>
+    </task>
+    <task id="LOCAL-00006" summary="Stringify print">
+      <created>1686069574434</created>
+      <option name="number" value="00006" />
+      <option name="presentableId" value="LOCAL-00006" />
+      <option name="project" value="LOCAL" />
+      <updated>1686069574434</updated>
+    </task>
+    <task id="LOCAL-00007" summary="Add import-component function">
+      <created>1686238984111</created>
+      <option name="number" value="00007" />
+      <option name="presentableId" value="LOCAL-00007" />
+      <option name="project" value="LOCAL" />
+      <updated>1686238984111</updated>
+    </task>
+    <task id="LOCAL-00008" summary="simplify generate-suggestions flag passing">
+      <created>1686244114837</created>
+      <option name="number" value="00008" />
+      <option name="presentableId" value="LOCAL-00008" />
+      <option name="project" value="LOCAL" />
+      <updated>1686244114837</updated>
+    </task>
+    <task id="LOCAL-00009" summary="Add import-components command">
+      <created>1686611039840</created>
+      <option name="number" value="00009" />
+      <option name="presentableId" value="LOCAL-00009" />
+      <option name="project" value="LOCAL" />
+      <updated>1686611039840</updated>
+    </task>
+    <task id="LOCAL-00010" summary="Add flag check for csv files">
+      <created>1686667259055</created>
+      <option name="number" value="00010" />
+      <option name="presentableId" value="LOCAL-00010" />
+      <option name="project" value="LOCAL" />
+      <updated>1686667259055</updated>
+    </task>
+    <task id="LOCAL-00011" summary="Add (.csv format only)">
+      <created>1686758043695</created>
+      <option name="number" value="00011" />
+      <option name="presentableId" value="LOCAL-00011" />
+      <option name="project" value="LOCAL" />
+      <updated>1686758043695</updated>
+    </task>
+    <task id="LOCAL-00012" summary="Add remaining column mappings">
+      <created>1686758202293</created>
+      <option name="number" value="00012" />
+      <option name="presentableId" value="LOCAL-00012" />
+      <option name="project" value="LOCAL" />
+      <updated>1686758202293</updated>
+    </task>
+    <option name="localTasksCounter" value="13" />
     <servers />
   </component>
   <component name="TypeScriptGeneratedFilesManager">
@@ -96,6 +202,19 @@
     <MESSAGE value="Remove eslint" />
     <MESSAGE value="Add -cf flag to generate-suggestions" />
     <MESSAGE value="Remove redundant variable" />
-    <option name="LAST_COMMIT_MESSAGE" value="Remove redundant variable" />
+    <MESSAGE value="Add command to show component-folders" />
+    <MESSAGE value="Command description" />
+    <MESSAGE value="Stringify print" />
+    <MESSAGE value="Add import-component function" />
+    <MESSAGE value="simplify generate-suggestions flag passing" />
+    <MESSAGE value="Add import-components command" />
+    <MESSAGE value="Add flag check for csv files" />
+    <MESSAGE value="Add (.csv format only)" />
+    <MESSAGE value="Add remaining column mappings" />
+    <option name="LAST_COMMIT_MESSAGE" value="Add remaining column mappings" />
+  </component>
+  <component name="XSLT-Support.FileAssociations.UIState">
+    <expand />
+    <select />
   </component>
 </project>

package/README.md

@@ -84,6 +84,28 @@ For more details on files generated by this command, see [Output Files](#output-
 
 **Action:** Lists projects in `config.yml` and permits selecting one to remove from `config.yml` via an interactive prompt.
 
+### Component folders
+
+**Usage:** `ditto-cli component-folders`
+
+**Action:** List component folders in your workspace. More information about component folders can be found here: https://www.dittowords.com/docs/component-folders.
+
+### Import components
+
+**Usage:** `ditto-cli import-components <file_path>`
+
+**Action:** Import components via a file. Please see https://www.dittowords.com/docs/importing-string-files for more information.
+When [importing CSV files](https://www.dittowords.com/docs/importing-csv-files), the follow parameters are applicable:
+```
+  -t, --text [value]            Text column index (Required)
+  -n, --component-name [value]  Name column indexes (comma separated) (Required)
+  -no, --notes [value]          Notes column index
+  -t, --tags [value]            Tags column index
+  -s, --status [value]          Status column index
+  -c, --component-id [value]    Component ID column index
+  -h, --help                    display help for command
+```
+
 ## Configuration
 
 The `config.yml` file is the source of truth for a given directory about how the CLI should fetch and store data from Ditto. It includes information about which Ditto projects the CLI should pull text from, whether or not the component library should be included, in what format the text should be stored, and more.

package/bin/component-folders.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showComponentFolders = void 0;
+const fetchComponentFolders_1 = require("./http/fetchComponentFolders");
+async function showComponentFolders() {
+    const folders = await (0, fetchComponentFolders_1.fetchComponentFolders)();
+    console.log(JSON.stringify(folders));
+}
+exports.showComponentFolders = showComponentFolders;
+//# sourceMappingURL=component-folders.js.map

package/bin/component-folders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-folders.js","sourceRoot":"","sources":["../lib/component-folders.ts"],"names":[],"mappings":";;;AAAA,wEAAqE;AAErE,KAAK,UAAU,oBAAoB;IACjC,MAAM,OAAO,GAAG,MAAM,IAAA,6CAAqB,GAAE,CAAC;IAE9C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AACvC,CAAC;AAEQ,oDAAoB"}

package/bin/ditto.js

@@ -18,6 +18,8 @@ const remove_project_1 = __importDefault(require("./remove-project"));
 const replace_1 = require("./replace");
 const generate_suggestions_1 = require("./generate-suggestions");
 const processMetaOption_1 = __importDefault(require("./utils/processMetaOption"));
+const importComponents_1 = require("./importComponents");
+const component_folders_1 = require("./component-folders");
 function getVersion() {
     const packageJsonPath = path_1.default.join(__dirname, "..", "package.json");
     const packageJsonContent = fs_1.default.readFileSync(packageJsonPath, "utf8");
@@ -44,6 +46,10 @@ const COMMANDS = [
             },
         ],
     },
+    {
+        name: "component-folders",
+        description: "List component folders in your workspace. More information about component folders can be found here: https://www.dittowords.com/docs/component-folders.",
+    },
     {
         name: "generate-suggestions",
         description: "Find text that can be potentially replaced with Ditto text",
@@ -70,6 +76,30 @@ const COMMANDS = [
             },
         },
     },
+    {
+        name: "import-components",
+        description: "Import components via a file. For more information please see: https://www.dittowords.com/docs/importing-string-files.",
+        flags: {
+            "-t, --text [value]": {
+                description: "Text column index (.csv format only)",
+            },
+            "-n, --component-name [value]": {
+                description: "Name column indexes (comma separated) (.csv format only)",
+            },
+            "-no, --notes [value]": {
+                description: "Notes column index (.csv format only)",
+            },
+            "-t, --tags [value]": {
+                description: "Tags column index (.csv format only)",
+            },
+            "-s, --status [value]": {
+                description: "Status column index (.csv format only)",
+            },
+            "-c, --component-id [value]": {
+                description: "Component ID column index (.csv format only)",
+            },
+        },
+    },
 ];
 const setupCommands = () => {
     commander_1.program.name("ditto-cli");
@@ -138,11 +168,14 @@ const executeCommand = async (command, options) => {
         case "project remove": {
             return (0, remove_project_1.default)();
         }
+        case "component-folders": {
+            return (0, component_folders_1.showComponentFolders)();
+        }
         case "generate-suggestions": {
             return (0, generate_suggestions_1.generateSuggestions)({
-                ...(options.directory ? { directory: options.directory } : {}),
-                ...(options.files ? { files: options.files } : {}),
-                ...(options.componentFolder ? { componentFolder: options.componentFolder } : {}),
+                directory: options.directory,
+                files: options.files,
+                componentFolder: options.componentFolder,
             });
         }
         case "replace": {
@@ -150,6 +183,22 @@ const executeCommand = async (command, options) => {
                 ...(options?.lineNumbers ? { lineNumbers: options.lineNumbers } : {}),
             });
         }
+        case "import-components": {
+            if (options.args.length === 0) {
+                console.info("Please provide a file path.");
+                return;
+            }
+            return (0, importComponents_1.importComponents)(options.args[0], {
+                csvColumnMapping: {
+                    name: options.componentName,
+                    text: options.text,
+                    notes: options.notes,
+                    tags: options.tags,
+                    status: options.status,
+                    componentId: options.componentId,
+                },
+            });
+        }
         default: {
             (0, quit_1.quit)("Exiting Ditto CLI...");
             return;

package/bin/ditto.js.map

@@ -1 +1 @@
-{"version":3,"file":"ditto.js","sourceRoot":"","sources":["../lib/ditto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ditto.js","sourceRoot":"","sources":["../lib/ditto.ts"],"names":[],"mappings":"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"}

package/bin/http/fetchComponentFolders.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchComponentFolders = void 0;
+const api_1 = require("../api");
+async function fetchComponentFolders() {
+    const api = (0, api_1.createApiClient)();
+    const { data } = await api.get("/component-folders", {});
+    return data;
+}
+exports.fetchComponentFolders = fetchComponentFolders;
+//# sourceMappingURL=fetchComponentFolders.js.map

package/bin/http/fetchComponentFolders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchComponentFolders.js","sourceRoot":"","sources":["../../lib/http/fetchComponentFolders.ts"],"names":[],"mappings":";;;AAAA,gCAAyC;AAMlC,KAAK,UAAU,qBAAqB;IACzC,MAAM,GAAG,GAAG,IAAA,qBAAe,GAAE,CAAC;IAE9B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,GAAG,CAC5B,oBAAoB,EACpB,EAAE,CACH,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC;AATD,sDASC"}

package/bin/http/importComponents.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importComponents = void 0;
+const api_1 = require("../api");
+const form_data_1 = __importDefault(require("form-data"));
+const fs_1 = __importDefault(require("fs"));
+async function importComponents(path, options) {
+    const api = (0, api_1.createApiClient)();
+    const form = new form_data_1.default();
+    form.append("import", fs_1.default.createReadStream(path));
+    const requestOptions = {
+        method: "POST",
+        url: "/v1/components/file",
+        params: {
+            ...(options.csvColumnMapping?.name
+                ? { name: `[${options.csvColumnMapping.name}]` }
+                : {}),
+            ...(options.csvColumnMapping?.text
+                ? { text: options.csvColumnMapping.text }
+                : {}),
+            ...(options.csvColumnMapping?.notes
+                ? { notes: options.csvColumnMapping.notes }
+                : {}),
+            ...(options.csvColumnMapping?.status
+                ? { status: options.csvColumnMapping.status }
+                : {}),
+            ...(options.csvColumnMapping?.tags
+                ? { tags: options.csvColumnMapping.tags }
+                : {}),
+            ...(options.csvColumnMapping?.componentId
+                ? { componentId: options.csvColumnMapping.componentId }
+                : {}),
+        },
+        headers: {
+            "content-type": "multipart/form-data",
+        },
+        data: form,
+    };
+    try {
+        const { data } = await api(requestOptions);
+        return data;
+    }
+    catch (e) {
+        console.error("Failed to import file.");
+        console.error(e.response?.data?.message || e.message);
+        return {
+            componentsInserted: 0,
+            firstImportedId: "null",
+        };
+    }
+}
+exports.importComponents = importComponents;
+//# sourceMappingURL=importComponents.js.map

package/bin/http/importComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importComponents.js","sourceRoot":"","sources":["../../lib/http/importComponents.ts"],"names":[],"mappings":";;;;;;AAAA,gCAAyC;AACzC,0DAAiC;AACjC,4CAAoB;AAgBb,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,OAEC;IAED,MAAM,GAAG,GAAG,IAAA,qBAAe,GAAE,CAAC;IAE9B,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IAEjD,MAAM,cAAc,GAAG;QACrB,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,qBAAqB;QAC1B,MAAM,EAAE;YACN,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI;gBAChC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,gBAAgB,CAAC,IAAI,GAAG,EAAE;gBAChD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI;gBAChC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE;gBACzC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK;gBACjC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE;gBAC3C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM;gBAClC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE;gBAC7C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI;gBAChC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE;gBACzC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,WAAW;gBACvC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE;gBACvD,CAAC,CAAC,EAAE,CAAC;SACR;QACD,OAAO,EAAE;YACP,cAAc,EAAE,qBAAqB;SACtC;QACD,IAAI,EAAE,IAAI;KACX,CAAC;IAEF,IAAI;QACF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,CAAC;QAE3C,OAAO,IAAI,CAAC;KACb;IAAC,OAAO,CAAM,EAAE;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;QACtD,OAAO;YACL,kBAAkB,EAAE,CAAC;YACrB,eAAe,EAAE,MAAM;SACxB,CAAC;KACH;AACH,CAAC;AApDD,4CAoDC"}

package/bin/importComponents.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importComponents = void 0;
+const importComponents_1 = require("./http/importComponents");
+async function importComponents(filePath, options) {
+    if (filePath.endsWith(".csv") &&
+        (!options.csvColumnMapping?.name || !options.csvColumnMapping?.text)) {
+        throw new Error(".csv files require the --component-name and --text flags.");
+    }
+    const importResult = await (0, importComponents_1.importComponents)(filePath, options);
+    console.log(JSON.stringify(importResult));
+}
+exports.importComponents = importComponents;
+//# sourceMappingURL=importComponents.js.map

package/bin/importComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importComponents.js","sourceRoot":"","sources":["../lib/importComponents.ts"],"names":[],"mappings":";;;AAAA,8DAGiC;AAEjC,KAAK,UAAU,gBAAgB,CAC7B,QAAgB,EAChB,OAEC;IAED,IACE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QACzB,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,EACpE;QACA,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;KACH;IACD,MAAM,YAAY,GAAG,MAAM,IAAA,mCAAoB,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;AAC5C,CAAC;AAEQ,4CAAgB"}

package/lib/component-folders.ts

@@ -0,0 +1,9 @@
+import { fetchComponentFolders } from "./http/fetchComponentFolders";
+
+async function showComponentFolders() {
+  const folders = await fetchComponentFolders();
+
+  console.log(JSON.stringify(folders));
+}
+
+export { showComponentFolders };

package/lib/ditto.ts

@@ -15,6 +15,8 @@ import { replace } from "./replace";
 import { generateSuggestions } from "./generate-suggestions";
 
 import processMetaOption from "./utils/processMetaOption";
+import { importComponents } from "./importComponents";
+import { showComponentFolders } from "./component-folders";
 
 function getVersion(): string {
   const packageJsonPath = path.join(__dirname, "..", "package.json");
@@ -30,8 +32,10 @@ type Command =
   | "project"
   | "project add"
   | "project remove"
+  | "component-folders"
   | "generate-suggestions"
-  | "replace";
+  | "replace"
+  | "import-components";
 
 interface CommandConfig<T extends Command | "add" | "remove"> {
   name: T;
@@ -61,6 +65,11 @@ const COMMANDS: CommandConfig<Command>[] = [
       },
     ],
   },
+  {
+    name: "component-folders",
+    description:
+      "List component folders in your workspace. More information about component folders can be found here: https://www.dittowords.com/docs/component-folders.",
+  },
   {
     name: "generate-suggestions",
     description: "Find text that can be potentially replaced with Ditto text",
@@ -87,6 +96,31 @@ const COMMANDS: CommandConfig<Command>[] = [
       },
     },
   },
+  {
+    name: "import-components",
+    description:
+      "Import components via a file. For more information please see: https://www.dittowords.com/docs/importing-string-files.",
+    flags: {
+      "-t, --text [value]": {
+        description: "Text column index (.csv format only)",
+      },
+      "-n, --component-name [value]": {
+        description: "Name column indexes (comma separated) (.csv format only)",
+      },
+      "-no, --notes [value]": {
+        description: "Notes column index (.csv format only)",
+      },
+      "-t, --tags [value]": {
+        description: "Tags column index (.csv format only)",
+      },
+      "-s, --status [value]": {
+        description: "Status column index (.csv format only)",
+      },
+      "-c, --component-id [value]": {
+        description: "Component ID column index (.csv format only)",
+      },
+    },
+  },
 ];
 
 const setupCommands = () => {
@@ -169,11 +203,14 @@ const executeCommand = async (
     case "project remove": {
       return removeProject();
     }
+    case "component-folders": {
+      return showComponentFolders();
+    }
     case "generate-suggestions": {
       return generateSuggestions({
-        ...(options.directory ? { directory: options.directory } : {}),
-        ...(options.files ? { files: options.files } : {}),
-        ...(options.componentFolder ? { componentFolder: options.componentFolder } : {}),
+        directory: options.directory,
+        files: options.files,
+        componentFolder: options.componentFolder,
       });
     }
     case "replace": {
@@ -181,6 +218,22 @@ const executeCommand = async (
         ...(options?.lineNumbers ? { lineNumbers: options.lineNumbers } : {}),
       });
     }
+    case "import-components": {
+      if (options.args.length === 0) {
+        console.info("Please provide a file path.");
+        return;
+      }
+      return importComponents(options.args[0], {
+        csvColumnMapping: {
+          name: options.componentName,
+          text: options.text,
+          notes: options.notes,
+          tags: options.tags,
+          status: options.status,
+          componentId: options.componentId,
+        },
+      });
+    }
     default: {
       quit("Exiting Ditto CLI...");
       return;

package/lib/http/fetchComponentFolders.ts

@@ -0,0 +1,16 @@
+import { createApiClient } from "../api";
+
+interface FetchComponentFoldersResponse {
+  [id: string]: string;
+}
+
+export async function fetchComponentFolders(): Promise<FetchComponentFoldersResponse> {
+  const api = createApiClient();
+
+  const { data } = await api.get<FetchComponentFoldersResponse>(
+    "/component-folders",
+    {}
+  );
+
+  return data;
+}

package/lib/http/importComponents.ts

@@ -0,0 +1,71 @@
+import { createApiClient } from "../api";
+import FormData from "form-data";
+import fs from "fs";
+
+export interface ImportComponentResponse {
+  componentsInserted: number;
+  firstImportedId: string;
+}
+
+export interface CsvColumnMapping {
+  text: number;
+  name: string;
+  notes?: number;
+  tags?: number;
+  status?: number;
+  componentId?: number;
+}
+
+export async function importComponents(
+  path: string,
+  options: {
+    csvColumnMapping?: CsvColumnMapping;
+  }
+): Promise<ImportComponentResponse> {
+  const api = createApiClient();
+
+  const form = new FormData();
+  form.append("import", fs.createReadStream(path));
+
+  const requestOptions = {
+    method: "POST",
+    url: "/v1/components/file",
+    params: {
+      ...(options.csvColumnMapping?.name
+        ? { name: `[${options.csvColumnMapping.name}]` }
+        : {}),
+      ...(options.csvColumnMapping?.text
+        ? { text: options.csvColumnMapping.text }
+        : {}),
+      ...(options.csvColumnMapping?.notes
+        ? { notes: options.csvColumnMapping.notes }
+        : {}),
+      ...(options.csvColumnMapping?.status
+        ? { status: options.csvColumnMapping.status }
+        : {}),
+      ...(options.csvColumnMapping?.tags
+        ? { tags: options.csvColumnMapping.tags }
+        : {}),
+      ...(options.csvColumnMapping?.componentId
+        ? { componentId: options.csvColumnMapping.componentId }
+        : {}),
+    },
+    headers: {
+      "content-type": "multipart/form-data",
+    },
+    data: form,
+  };
+
+  try {
+    const { data } = await api(requestOptions);
+
+    return data;
+  } catch (e: any) {
+    console.error("Failed to import file.");
+    console.error(e.response?.data?.message || e.message);
+    return {
+      componentsInserted: 0,
+      firstImportedId: "null",
+    };
+  }
+}

package/lib/importComponents.ts

@@ -0,0 +1,24 @@
+import {
+  CsvColumnMapping,
+  importComponents as importComponentsHttp,
+} from "./http/importComponents";
+
+async function importComponents(
+  filePath: string,
+  options: {
+    csvColumnMapping?: CsvColumnMapping;
+  }
+) {
+  if (
+    filePath.endsWith(".csv") &&
+    (!options.csvColumnMapping?.name || !options.csvColumnMapping?.text)
+  ) {
+    throw new Error(
+      ".csv files require the --component-name and --text flags."
+    );
+  }
+  const importResult = await importComponentsHttp(filePath, options);
+  console.log(JSON.stringify(importResult));
+}
+
+export { importComponents };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dittowords/cli",
-  "version": "3.7.0",
+  "version": "3.9.0",
   "description": "Command Line Interface for Ditto (dittowords.com).",
   "main": "bin/index.js",
   "scripts": {
@@ -62,6 +62,7 @@
     "commander": "^6.1.0",
     "enquirer": "^2.3.6",
     "faker": "^5.1.0",
+    "form-data": "^4.0.0",
     "fs-extra": "^11.1.1",
     "glob": "^9.3.4",
     "js-yaml": "^4.1.0",