@dittowords/cli 2.5.0 → 2.5.2

package/bin/utils/getSelectedProjects.js

@@ -0,0 +1,76 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIsUsingComponents = exports.getSelectedProjects = void 0;
+const fs_1 = __importDefault(require("fs"));
+const js_yaml_1 = __importStar(require("js-yaml"));
+const consts_1 = require("../consts");
+function jsonIsConfigYAML(json) {
+    return typeof json === "object";
+}
+function yamlToJson(_yaml) {
+    try {
+        let configYaml = js_yaml_1.default.load(_yaml);
+        if (!jsonIsConfigYAML(configYaml)) {
+            return {};
+        }
+        return configYaml;
+    }
+    catch (e) {
+        if (e instanceof js_yaml_1.YAMLException) {
+            return null;
+        }
+        else {
+            throw e;
+        }
+    }
+}
+/**
+ * Returns an array containing all valid projects ({ id, name })
+ * currently contained in the project config file.
+ */
+const getSelectedProjects = (configFile = consts_1.PROJECT_CONFIG_FILE) => {
+    if (!fs_1.default.existsSync(configFile))
+        return [];
+    const contentYaml = fs_1.default.readFileSync(configFile, "utf8");
+    const contentJson = yamlToJson(contentYaml);
+    if (!(contentJson && contentJson.projects)) {
+        return [];
+    }
+    return contentJson.projects.filter(({ name, id }) => name && id);
+};
+exports.getSelectedProjects = getSelectedProjects;
+const getIsUsingComponents = (configFile = consts_1.PROJECT_CONFIG_FILE) => {
+    if (!fs_1.default.existsSync(configFile))
+        return false;
+    const contentYaml = fs_1.default.readFileSync(configFile, "utf8");
+    const contentJson = yamlToJson(contentYaml);
+    return !!contentJson && !!contentJson.components;
+};
+exports.getIsUsingComponents = getIsUsingComponents;
+//# sourceMappingURL=getSelectedProjects.js.map

package/bin/utils/getSelectedProjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSelectedProjects.js","sourceRoot":"","sources":["../../lib/utils/getSelectedProjects.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,mDAA8C;AAE9C,sCAAgD;AAGhD,SAAS,gBAAgB,CAAC,IAAa;IACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC;AAClC,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI;QACF,IAAI,UAAU,GAAG,iBAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE;YACjC,OAAO,EAAE,CAAC;SACX;QACD,OAAO,UAAU,CAAC;KACnB;IAAC,OAAO,CAAC,EAAE;QACV,IAAI,CAAC,YAAY,uBAAa,EAAE;YAC9B,OAAO,IAAI,CAAC;SACb;aAAM;YACL,MAAM,CAAC,CAAC;SACT;KACF;AACH,CAAC;AAED;;;GAGG;AACI,MAAM,mBAAmB,GAAG,CACjC,UAAU,GAAG,4BAAmB,EACrB,EAAE;IACb,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1C,MAAM,WAAW,GAAG,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAE5C,IAAI,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE;QAC1C,OAAO,EAAE,CAAC;KACX;IAED,OAAO,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC,CAAC;AAbW,QAAA,mBAAmB,uBAa9B;AAEK,MAAM,oBAAoB,GAAG,CAClC,UAAU,GAAG,4BAAmB,EACvB,EAAE;IACX,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7C,MAAM,WAAW,GAAG,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAE5C,OAAO,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC;AACnD,CAAC,CAAC;AATW,QAAA,oBAAoB,wBAS/B"}

package/bin/utils/processMetaOption.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const processMetaOption = (inputArr) => {
+    const res = {};
+    if (!Array.isArray(inputArr)) {
+        return res;
+    }
+    inputArr.forEach((element) => {
+        const [key, value] = element.split(":");
+        res[key] = value;
+    });
+    return res;
+};
+exports.default = processMetaOption;
+//# sourceMappingURL=processMetaOption.js.map

package/bin/utils/processMetaOption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processMetaOption.js","sourceRoot":"","sources":["../../lib/utils/processMetaOption.ts"],"names":[],"mappings":";;AAAA,MAAM,iBAAiB,GAAG,CAAC,QAAyB,EAAE,EAAE;IACtD,MAAM,GAAG,GAA2B,EAAE,CAAC;IAEvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAC5B,OAAO,GAAG,CAAC;KACZ;IAED,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,kBAAe,iBAAiB,CAAC"}

package/bin/utils/projectsToText.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const output_1 = __importDefault(require("../output"));
+const projectsToText = (projects) => {
+    return ((projects || []).reduce((outputString, { name, id }) => outputString +
+        ("\n" +
+            "- " +
+            output_1.default.info(name) +
+            " " +
+            output_1.default.subtle("https://app.dittowords.com/doc/" + id)), "") + "\n");
+};
+exports.default = projectsToText;
+//# sourceMappingURL=projectsToText.js.map

package/bin/utils/projectsToText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectsToText.js","sourceRoot":"","sources":["../../lib/utils/projectsToText.ts"],"names":[],"mappings":";;;;;AAAA,uDAA+B;AAG/B,MAAM,cAAc,GAAG,CAAC,QAAmB,EAAE,EAAE;IAC7C,OAAO,CACL,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CACrB,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAC7B,YAAY;QACZ,CAAC,IAAI;YACH,IAAI;YACJ,gBAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YACjB,GAAG;YACH,gBAAM,CAAC,MAAM,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC,EAC1D,EAAE,CACH,GAAG,IAAI,CACT,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,cAAc,CAAC"}

package/bin/utils/promptForProject.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const { AutoComplete } = require("enquirer");
+const output_1 = __importDefault(require("../output"));
+function formatProjectChoice(project) {
+    return (project.name +
+        " " +
+        output_1.default.subtle(project.url || `https://app.dittowords.com/doc/${project.id}`));
+}
+function parseResponse(response) {
+    if (!response) {
+        return null;
+    }
+    const [, name, id] = response.split(/^(.*)\s.*http.*\/(\w+).*$/);
+    if (id === "all") {
+        return { name, id: "ditto_component_library" };
+    }
+    return { name, id };
+}
+const promptForProject = async ({ message, projects, limit = 10, }) => {
+    output_1.default.nl();
+    const choices = projects.map(formatProjectChoice);
+    const prompt = new AutoComplete({
+        name: "project",
+        message,
+        limit,
+        choices,
+    });
+    let response;
+    try {
+        response = await prompt.run();
+    }
+    catch (e) {
+        // this catch handles the case where someone presses
+        // Ctrl + C to kill the AutoComplete process
+        response = null;
+    }
+    return parseResponse(response);
+};
+exports.default = promptForProject;
+//# sourceMappingURL=promptForProject.js.map

package/bin/utils/promptForProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptForProject.js","sourceRoot":"","sources":["../../lib/utils/promptForProject.ts"],"names":[],"mappings":";;;;;AAAA,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAE7C,uDAA+B;AAG/B,SAAS,mBAAmB,CAAC,OAAgB;IAC3C,OAAO,CACL,OAAO,CAAC,IAAI;QACZ,GAAG;QACH,gBAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,kCAAkC,OAAO,CAAC,EAAE,EAAE,CAAC,CAC7E,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,CAAC,QAAQ,EAAE;QACb,OAAO,IAAI,CAAC;KACb;IAED,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAEjE,IAAI,EAAE,KAAK,KAAK,EAAE;QAChB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,yBAAyB,EAAE,CAAC;KAChD;IAED,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACtB,CAAC;AAQD,MAAM,gBAAgB,GAAG,KAAK,EAAE,EAC9B,OAAO,EACP,QAAQ,EACR,KAAK,GAAG,EAAE,GACU,EAAE,EAAE;IACxB,gBAAM,CAAC,EAAE,EAAE,CAAC;IAEZ,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,IAAI,EAAE,SAAS;QACf,OAAO;QACP,KAAK;QACL,OAAO;KACR,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC;IAEb,IAAI;QACF,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;KAC/B;IAAC,OAAO,CAAC,EAAE;QACV,oDAAoD;QACpD,4CAA4C;QAC5C,QAAQ,GAAG,IAAI,CAAC;KACjB;IAED,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,kBAAe,gBAAgB,CAAC"}

package/bin/utils/sourcesToText.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const output_1 = __importDefault(require("../output"));
+const projectsToText_1 = __importDefault(require("./projectsToText"));
+const sourcesToText = (projects, componentLibrary) => {
+    let message = "";
+    if (componentLibrary) {
+        message += `the ${output_1.default.info("Ditto Component Library")}`;
+        if ((projects || []).length) {
+            message += " and ";
+        }
+        else {
+            message += "..";
+        }
+    }
+    if ((projects || []).length) {
+        message += `the following projects: ${(0, projectsToText_1.default)(projects)}\n`;
+    }
+    return message;
+};
+exports.default = sourcesToText;
+//# sourceMappingURL=sourcesToText.js.map

package/bin/utils/sourcesToText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourcesToText.js","sourceRoot":"","sources":["../../lib/utils/sourcesToText.ts"],"names":[],"mappings":";;;;;AAAA,uDAA+B;AAC/B,sEAA8C;AAG9C,MAAM,aAAa,GAAG,CAAC,QAAmB,EAAE,gBAAyB,EAAE,EAAE;IACvE,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,IAAI,gBAAgB,EAAE;QACpB,OAAO,IAAI,OAAO,gBAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAE3D,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAC3B,OAAO,IAAI,OAAO,CAAC;SACpB;aAAM;YACL,OAAO,IAAI,IAAI,CAAC;SACjB;KACF;IAED,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,OAAO,IAAI,2BAA2B,IAAA,wBAAc,EAAC,QAAQ,CAAC,IAAI,CAAC;KACpE;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,kBAAe,aAAa,CAAC"}

package/jest.config.js

@@ -2,5 +2,5 @@ module.exports = {
   transformIgnorePatterns: [],
   maxWorkers: 1,
   verbose: true,
-  collectCoverageFrom: ["src/**/*.{js,jsx}"],
+  collectCoverageFrom: ["lib/**/*.{js,jsx,ts,tsx}"],
 };

package/lib/add-project.ts

@@ -0,0 +1,51 @@
+import { collectAndSaveProject } from "./init/project";
+import projectsToText from "./utils/projectsToText";
+import {
+  getSelectedProjects,
+  getIsUsingComponents,
+} from "./utils/getSelectedProjects";
+import output from "./output";
+
+function quit(exitCode = 2) {
+  console.log("Project selection was not updated.");
+  process.exitCode = exitCode;
+  process.exit();
+}
+
+const addProject = async () => {
+  const projects = getSelectedProjects();
+  const usingComponents = getIsUsingComponents();
+
+  try {
+    if (usingComponents) {
+      if (projects.length) {
+        console.log(
+          `\nYou're currently syncing text from the ${output.info(
+            "Component Library"
+          )} and from the following projects: ${projectsToText(projects)}`
+        );
+      } else {
+        console.log(
+          `\nYou're currently only syncing text from the ${output.info(
+            "Component Library"
+          )}`
+        );
+      }
+    } else if (projects.length) {
+      console.log(
+        `\nYou're currently set up to sync text from the following projects: ${projectsToText(
+          projects
+        )}`
+      );
+    }
+    await collectAndSaveProject(false);
+  } catch (error) {
+    console.log(
+      `\nSorry, there was an error adding a project to your workspace: `,
+      error
+    );
+    quit();
+  }
+};
+
+export default addProject;

package/lib/api.ts

@@ -0,0 +1,15 @@
+import axios from "axios";
+
+import config from "./config";
+import consts from "./consts";
+
+export const create = (token?: string) => {
+  return axios.create({
+    baseURL: consts.API_HOST,
+    headers: {
+      Authorization: `token ${token}`,
+    },
+  });
+};
+
+export default create(config.getToken(consts.CONFIG_FILE, consts.API_HOST));

package/lib/{config.test.js → config.test.ts}

@@ -1,11 +1,9 @@
 /* eslint-disable no-underscore-dangle */
-const fs = require("fs");
-const path = require("path");
-
-const tempy = require("tempy");
-const yaml = require("js-yaml");
-
-const config = require("./config");
+import fs from "fs";
+import path from "path";
+import tempy from "tempy";
+import yaml from "js-yaml";
+import config from "./config";
 
 const fakeHomedir = fs.mkdtempSync(path.join(__dirname, "../testing/tmp"));
 
@@ -57,11 +55,15 @@ describe("Tokens in config files", () => {
   describe("saveToken", () => {
     it("creates a config file with config data", () => {
       const fileContents = fs.readFileSync(configFile, "utf8");
-      const configData = yaml.safeLoad(fileContents);
-      expect(configData["testing.dittowords.com"]).toBeDefined();
-      expect(configData["testing.dittowords.com"][0].token).toEqual(
-        "faketoken"
-      );
+      const configData = yaml.load(fileContents);
+      if (configData && typeof configData === "object") {
+        expect(configData["testing.dittowords.com"]).toBeDefined();
+        expect(configData["testing.dittowords.com"][0].token).toEqual(
+          "faketoken"
+        );
+      } else {
+        fail("Config Data should have been an object!");
+      }
     });
   });
 
@@ -73,16 +75,3 @@ describe("Tokens in config files", () => {
     });
   });
 });
-
-describe("save", () => {
-  let data;
-  beforeEach(() => {
-    const file = tempy.writeSync("");
-    config.save(file, "test.setting", true);
-    data = config.readData(file);
-  });
-
-  it("writes a setting correctly", () => {
-    expect(data.test.setting).toEqual(true);
-  });
-});

package/lib/config.ts

@@ -0,0 +1,214 @@
+import fs from "fs";
+import path from "path";
+import url from "url";
+import yaml from "js-yaml";
+
+import consts from "./consts";
+import { Project, ConfigYAML } from "./types";
+
+function createFileIfMissing(filename: string) {
+  const dir = path.dirname(filename);
+
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir);
+
+  if (!fs.existsSync(filename)) {
+    fs.closeSync(fs.openSync(filename, "w"));
+  }
+}
+
+function jsonIsConfigYAML(json: unknown): json is ConfigYAML {
+  return typeof json === "object";
+}
+
+function jsonIsGlobalYAML(
+  json: unknown
+): json is Record<string, { token: string }[]> {
+  return (
+    !!json &&
+    typeof json === "object" &&
+    Object.values(json).every((arr) =>
+      arr.every(
+        (val: any) =>
+          typeof val === "object" && Object.keys(val).includes("token")
+      )
+    )
+  );
+}
+
+/**
+ * Read data from a project config file
+ * @param {string} file defaults to `PROJECT_CONFIG_FILE` defined in `constants.js`
+ * @param {*} defaultData defaults to `{}`
+ * @returns { ConfigYAML }
+ */
+function readProjectConfigData(
+  file = consts.PROJECT_CONFIG_FILE,
+  defaultData = {}
+): ConfigYAML {
+  createFileIfMissing(file);
+  const fileContents = fs.readFileSync(file, "utf8");
+  const yamlData = yaml.load(fileContents);
+  if (jsonIsConfigYAML(yamlData)) {
+    return yamlData;
+  }
+  return defaultData;
+}
+
+/**
+ * Read data from a global config file
+ * @param {string} file defaults to `CONFIG_FILE` defined in `constants.js`
+ * @param {*} defaultData defaults to `{}`
+ * @returns { Record<string, { token: string }[]> }
+ */
+function readGlobalConfigData(
+  file = consts.CONFIG_FILE,
+  defaultData = {}
+): Record<string, { token: string }[]> {
+  createFileIfMissing(file);
+  const fileContents = fs.readFileSync(file, "utf8");
+  const yamlData = yaml.load(fileContents);
+  if (jsonIsGlobalYAML(yamlData)) {
+    return yamlData;
+  }
+  return defaultData;
+}
+
+function writeProjectConfigData(file: string, data: object) {
+  createFileIfMissing(file);
+  const existingData = readProjectConfigData(file);
+  const yamlStr = yaml.dump({ ...existingData, ...data });
+  fs.writeFileSync(file, yamlStr, "utf8");
+}
+
+function writeGlobalConfigData(file: string, data: object) {
+  createFileIfMissing(file);
+  const existingData = readGlobalConfigData(file);
+  const yamlStr = yaml.dump({ ...existingData, ...data });
+  fs.writeFileSync(file, yamlStr, "utf8");
+}
+
+function justTheHost(host: string) {
+  if (!host.includes("://")) return host;
+  return url.parse(host).hostname || "";
+}
+
+function deleteToken(file: string, host: string) {
+  const data = readGlobalConfigData(file);
+  const hostParsed = justTheHost(host);
+  data[hostParsed] = [];
+  data[hostParsed][0] = { token: "" };
+  writeGlobalConfigData(file, data);
+}
+
+function saveToken(file: string, host: string, token: string) {
+  const data = readGlobalConfigData(file);
+  const hostParsed = justTheHost(host);
+  data[hostParsed] = []; // only allow one token per host
+  data[hostParsed][0] = { token };
+  writeGlobalConfigData(file, data);
+}
+
+function getTokenFromEnv() {
+  return process.env.DITTO_API_KEY;
+}
+
+/**
+ *
+ * @param {string} file
+ * @param {string} host
+ * @returns {Token}
+ */
+function getToken(file: string, host: string) {
+  const tokenFromEnv = getTokenFromEnv();
+  if (tokenFromEnv) {
+    return tokenFromEnv;
+  }
+
+  const data = readGlobalConfigData(file);
+  const hostEntry = data[justTheHost(host)];
+  if (!hostEntry) return undefined;
+  const { length } = hostEntry;
+  return hostEntry[length - 1].token;
+}
+
+const IS_DUPLICATE = /-(\d+$)/;
+
+function dedupeProjectName(projectNames: Set<string>, projectName: string) {
+  let dedupedName = projectName;
+
+  if (projectNames.has(dedupedName)) {
+    while (projectNames.has(dedupedName)) {
+      const [_, numberStr] = dedupedName.match(IS_DUPLICATE) || [];
+      if (numberStr && !isNaN(parseInt(numberStr))) {
+        dedupedName = `${dedupedName.replace(IS_DUPLICATE, "")}-${
+          parseInt(numberStr) + 1
+        }`;
+      } else {
+        dedupedName = `${dedupedName}-1`;
+      }
+    }
+  }
+
+  return dedupedName;
+}
+
+/**
+ * Reads from the config file, filters out
+ * invalid projects, dedupes those remaining, and returns:
+ * - whether or not the data required to `pull` is present
+ * - whether or not the component library should be fetched
+ * - an array of valid, deduped projects
+ * - the `variants` and `format` config options
+ */
+function parseSourceInformation() {
+  const { projects, components, variants, format } = readProjectConfigData();
+
+  const projectNames = new Set<string>();
+  const validProjects: Project[] = [];
+
+  let componentLibraryInProjects = false;
+
+  (projects || []).forEach((project) => {
+    const isValid = project.id && project.name;
+    if (!isValid) {
+      return;
+    }
+
+    if (project.id === "ditto_component_library") {
+      componentLibraryInProjects = true;
+      return;
+    }
+
+    project.fileName = dedupeProjectName(projectNames, project.name);
+    projectNames.add(project.fileName);
+
+    validProjects.push(project);
+  });
+
+  const shouldFetchComponentLibrary =
+    !!components || componentLibraryInProjects;
+
+  const hasSourceData = !!validProjects.length || shouldFetchComponentLibrary;
+
+  return {
+    hasSourceData,
+    validProjects,
+    shouldFetchComponentLibrary,
+    variants: variants || false,
+    format,
+  };
+}
+
+export default {
+  createFileIfMissing,
+  readProjectConfigData,
+  readGlobalConfigData,
+  writeGlobalConfigData,
+  writeProjectConfigData,
+  justTheHost,
+  saveToken,
+  deleteToken,
+  getToken,
+  getTokenFromEnv,
+  parseSourceInformation,
+};

package/lib/consts.ts

@@ -0,0 +1,20 @@
+import { homedir } from "os";
+import path from "path";
+
+export const API_HOST =
+  process.env.DITTO_API_HOST || "https://api.dittowords.com";
+export const CONFIG_FILE =
+  process.env.DITTO_CONFIG_FILE || path.join(homedir(), ".config", "ditto");
+export const PROJECT_CONFIG_FILE = path.normalize(
+  path.join("ditto", "config.yml")
+);
+export const TEXT_DIR = process.env.DITTO_TEXT_DIR || "ditto";
+export const TEXT_FILE = path.normalize(path.join(TEXT_DIR, "text.json"));
+
+export default {
+  API_HOST,
+  CONFIG_FILE,
+  PROJECT_CONFIG_FILE,
+  TEXT_DIR,
+  TEXT_FILE,
+};

package/lib/ditto.ts

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+// This is the main entry point for the ditto-cli command.
+import { program } from "commander";
+// to use V8's code cache to speed up instantiation time
+import "v8-compile-cache";
+
+import { init, needsInit } from "./init/init";
+import { pull } from "./pull";
+
+import addProject from "./add-project";
+import removeProject from "./remove-project";
+import processMetaOption from "./utils/processMetaOption";
+
+/**
+ * Catch and report unexpected error.
+ * @param {any} error The thrown error object.
+ * @returns {void}
+ */
+function quit(exitCode = 2) {
+  console.log("\nExiting Ditto CLI...\n");
+  process.exitCode = exitCode;
+  process.exit();
+}
+
+const setupCommands = () => {
+  program.name("ditto-cli");
+  program
+    .command("pull")
+    .description("Sync copy from Ditto into working directory")
+    .action(() => checkInit("pull"));
+
+  const projectDescription = "Add a Ditto project to sync copy from";
+  const projectCommand = program
+    .command("project")
+    .description(projectDescription)
+    .action(() => checkInit("project"));
+
+  projectCommand
+    .command("add")
+    .description(projectDescription)
+    .action(() => checkInit("project"));
+
+  projectCommand
+    .command("remove")
+    .description("Stop syncing copy from a Ditto project")
+    .action(() => checkInit("project remove"));
+};
+
+const setupOptions = () => {
+  program.option(
+    "-m, --meta <data...>",
+    "Optional metadata for this command to send arbitrary data to the backend. Ex: -m githubActionRequest:true trigger:manual"
+  );
+};
+
+const checkInit = async (command: string) => {
+  if (needsInit() && command !== "project remove") {
+    try {
+      await init();
+      if (command === "pull") main(); // re-run to actually pull text now that init is finished
+    } catch (error) {
+      quit();
+    }
+  } else {
+    const { meta } = program.opts();
+    switch (command) {
+      case "pull":
+        pull({ meta: processMetaOption(meta) });
+        break;
+      case "project":
+      case "project add":
+        addProject();
+        break;
+      case "project remove":
+        removeProject();
+        break;
+      case "none":
+        setupCommands();
+        program.help();
+        break;
+      default:
+        quit();
+    }
+  }
+};
+
+const main = async () => {
+  if (process.argv.length <= 2 && process.argv[1].includes("ditto-cli")) {
+    await checkInit("none");
+  } else {
+    setupCommands();
+    setupOptions();
+  }
+  program.parse(process.argv);
+};
+
+main();