@dittowords/cli 3.0.0 → 3.2.2-alpha

package/bin/lib/utils/promptForProject.js

@@ -0,0 +1,43 @@
+"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"));
+const projectsToText_1 = require("./projectsToText");
+function formatProjectChoice(project) {
+    return (project.name + " " + output_1.default.subtle(project.url || (0, projectsToText_1.getSourceUrl)(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/lib/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;AAE/B,qDAAgD;AAEhD,SAAS,mBAAmB,CAAC,OAAgB;IAC3C,OAAO,CACL,OAAO,CAAC,IAAI,GAAG,GAAG,GAAG,gBAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,IAAA,6BAAY,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAC5E,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/lib/utils/quit.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quit = void 0;
+function quit(message, exitCode = 2) {
+    console.log(`\n${message}\n`);
+    process.exitCode = exitCode;
+    process.exit();
+}
+exports.quit = quit;
+//# sourceMappingURL=quit.js.map

package/bin/lib/utils/quit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quit.js","sourceRoot":"","sources":["../../../lib/utils/quit.ts"],"names":[],"mappings":";;;AAAA,SAAgB,IAAI,CAAC,OAAe,EAAE,QAAQ,GAAG,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC5B,OAAO,CAAC,IAAI,EAAE,CAAC;AACjB,CAAC;AAJD,oBAIC"}

package/bin/lib/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/lib/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/bin/package.json

@@ -0,0 +1,76 @@
+{
+    "name": "@dittowords/cli",
+    "version": "3.2.1-alpha",
+    "description": "Command Line Interface for Ditto (dittowords.com).",
+    "main": "bin/index.js",
+    "scripts": {
+        "prepublish": "tsc",
+        "prepare": "husky install",
+        "start": "tsc && node bin/ditto.js",
+        "sync": "tsc && node bin/ditto.js pull",
+        "dev": "tsc --watch"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/dittowords/cli.git"
+    },
+    "bugs": {
+        "url": "https://github.com/dittowords/cli/issues"
+    },
+    "author": "Ditto Tech Inc.",
+    "license": "MIT",
+    "keywords": [
+        "ditto",
+        "dittowords",
+        "copy",
+        "microcopy",
+        "product",
+        "cli",
+        "api"
+    ],
+    "types": "bin/ditto.d.ts",
+    "bin": {
+        "ditto-cli": "bin/ditto.js"
+    },
+    "devDependencies": {
+        "@babel/preset-env": "^7.20.2",
+        "@babel/preset-typescript": "^7.18.6",
+        "@tsconfig/node16": "^1.0.3",
+        "@types/jest": "^26.0.9",
+        "@types/js-yaml": "^4.0.5",
+        "@types/node": "^18.0.0",
+        "babel-jest": "^29.3.1",
+        "eslint": "^8.27.0",
+        "eslint-config-airbnb-base": "^14.2.0",
+        "husky": "^7.0.4",
+        "jest": "^29.3.1",
+        "lint-staged": "^11.2.4",
+        "prettier": "2.4.1",
+        "rewire": "^6.0.0",
+        "source-map": "^0.7.3",
+        "tempy": "^0.6.0",
+        "typescript": "^4.7.4"
+    },
+    "dependencies": {
+        "@babel/core": "^7.11.4",
+        "@babel/parser": "^7.21.4",
+        "@babel/traverse": "^7.21.4",
+        "@babel/types": "^7.21.4",
+        "@types/babel-traverse": "^6.25.7",
+        "@types/fs-extra": "^11.0.1",
+        "axios": "^0.27.2",
+        "boxen": "^5.1.2",
+        "chalk": "^4.1.0",
+        "commander": "^6.1.0",
+        "enquirer": "^2.3.6",
+        "faker": "^5.1.0",
+        "fs-extra": "^11.1.1",
+        "glob": "^9.3.4",
+        "js-yaml": "^4.1.0",
+        "ora": "^5.0.0",
+        "v8-compile-cache": "^2.1.1"
+    },
+    "lint-staged": {
+        "src/**/*.{js,jsx,ts,tsx,css,json}": "prettier --write"
+    }
+}

package/bin/replace.js

@@ -0,0 +1,107 @@
+"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.replaceJSXTextInFile = exports.parseOptions = exports.replace = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const parser_1 = require("@babel/parser");
+const traverse_1 = __importDefault(require("@babel/traverse"));
+const t = __importStar(require("@babel/types"));
+const core_1 = require("@babel/core");
+async function replaceJSXTextInFile(filePath, replacement) {
+    const code = await fs_extra_1.default.readFile(filePath, "utf-8");
+    const ast = (0, parser_1.parse)(code, {
+        sourceType: "module",
+        plugins: ["jsx", "typescript"],
+    });
+    (0, traverse_1.default)(ast, {
+        JSXText(path) {
+            const { searchString, replaceWith } = replacement;
+            const regex = new RegExp(searchString, "gi");
+            if (regex.test(path.node.value)) {
+                const splitValues = splitByCaseInsensitive(path.node.value, searchString);
+                const nodes = [];
+                splitValues.forEach((splitValue) => {
+                    if (splitValue.toLowerCase() === searchString.toLowerCase()) {
+                        const identifier = t.jsxIdentifier("DittoComponent");
+                        const componentId = t.jsxAttribute(t.jsxIdentifier("componentId"), t.stringLiteral(replaceWith));
+                        const o = t.jsxOpeningElement(identifier, [componentId], true);
+                        const jsxElement = t.jsxElement(o, undefined, [], true);
+                        nodes.push(jsxElement);
+                    }
+                    else {
+                        nodes.push(t.jsxText(splitValue));
+                    }
+                });
+                path.replaceWithMultiple(nodes);
+            }
+        },
+    });
+    // transfromFromAst types are wrong?
+    /* @ts-ignore */
+    const { code: transformedCode } = (0, core_1.transformFromAst)(ast, code, {
+        // Don't let this codebase's Babel config affect the code we're transforming.
+        configFile: false,
+    });
+    fs_extra_1.default.writeFile(filePath, transformedCode);
+}
+exports.replaceJSXTextInFile = replaceJSXTextInFile;
+function splitByCaseInsensitive(str, delimiter) {
+    return str.split(new RegExp(`(${delimiter})`, "gi")).filter((s) => s !== "");
+}
+function replace(options) {
+    let filePath;
+    let searchString;
+    let replaceWith;
+    try {
+        const parsedOptions = parseOptions(options);
+        filePath = parsedOptions.filePath;
+        searchString = parsedOptions.searchString;
+        replaceWith = parsedOptions.replaceWith;
+    }
+    catch (e) {
+        console.error(e);
+        console.error("Usage for replace: ditto-cli replace <file path> <search string> <replace with>");
+        return;
+    }
+    replaceJSXTextInFile(filePath, { searchString, replaceWith });
+}
+exports.replace = replace;
+function parseOptions(options) {
+    if (options.length !== 3) {
+        throw new Error("The options array must contain <file path> <search string> <replace with>.");
+    }
+    const filePath = options[0];
+    // Check if the file path exists and points to a regular file (not a directory or other file system object).
+    const isFilePathValid = fs_extra_1.default.existsSync(filePath) && fs_extra_1.default.lstatSync(filePath).isFile();
+    if (!isFilePathValid) {
+        throw new Error(`${filePath} is not a valid file path.`);
+    }
+    return { filePath, searchString: options[1], replaceWith: options[2] };
+}
+exports.parseOptions = parseOptions;
+//# sourceMappingURL=replace.js.map

package/bin/replace.js.map

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

package/lib/ditto.ts

@@ -3,16 +3,37 @@
 import { program } from "commander";
 // to use V8's code cache to speed up instantiation time
 import "v8-compile-cache";
+import fs from "fs";
+import path from "path";
 
 import { init, needsTokenOrSource } from "./init/init";
 import { pull } from "./pull";
 import { quit } from "./utils/quit";
 import addProject from "./add-project";
 import removeProject from "./remove-project";
+import { replace } from "./replace";
+import { generateSuggestions } from "./generate-suggestions";
 
 import processMetaOption from "./utils/processMetaOption";
 
-type Command = "pull" | "project" | "project add" | "project remove";
+function getVersion(): string {
+  const packageJsonPath = path.join(__dirname, "..", "package.json");
+  const packageJsonContent = fs.readFileSync(packageJsonPath, "utf8");
+  const packageJson = JSON.parse(packageJsonContent) as { version: string };
+  const version = packageJson.version;
+
+  return version;
+}
+
+const VERSION = getVersion();
+
+type Command =
+  | "pull"
+  | "project"
+  | "project add"
+  | "project remove"
+  | "generate-suggestions"
+  | "replace";
 
 const COMMANDS = [
   {
@@ -33,23 +54,36 @@ const COMMANDS = [
       },
     ],
   },
+  {
+    name: "generate-suggestions",
+    description: "Find text that can be potentially replaced with Ditto text",
+  },
+  {
+    name: "replace",
+    description: "Find and replace Ditto text with code",
+  },
 ] as const;
 
 const setupCommands = () => {
   program.name("ditto-cli");
 
-  COMMANDS.forEach((config) => {
+  COMMANDS.forEach((commandConfig) => {
     const cmd = program
-      .command(config.name)
-      .description(config.description)
-      .action(() => executeCommand(config.name));
+      .command(commandConfig.name)
+      .description(commandConfig.description)
+      .action((str, options) => executeCommand(commandConfig.name, options));
 
-    if ("commands" in config) {
-      config.commands.forEach((nestedCommand) => {
+    if ("commands" in commandConfig) {
+      commandConfig.commands.forEach((nestedCommand) => {
         cmd
           .command(nestedCommand.name)
           .description(nestedCommand.description)
-          .action(() => executeCommand(`${config.name} ${nestedCommand.name}`));
+          .action((str, options) =>
+            executeCommand(
+              `${commandConfig.name} ${nestedCommand.name}`,
+              options
+            )
+          );
       });
     }
   });
@@ -60,9 +94,13 @@ const setupOptions = () => {
     "-m, --meta <data...>",
     "Include arbitrary data in requests to the Ditto API. Ex: -m githubActionRequest:true trigger:manual"
   );
+  program.version(VERSION, "-v, --version", "Output the current version");
 };
 
-const executeCommand = async (command: Command | "none"): Promise<void> => {
+const executeCommand = async (
+  command: Command | "none",
+  options: string[]
+): Promise<void> => {
   const needsInitialization = needsTokenOrSource();
   if (needsInitialization) {
     try {
@@ -91,6 +129,12 @@ const executeCommand = async (command: Command | "none"): Promise<void> => {
     case "project remove": {
       return removeProject();
     }
+    case "generate-suggestions": {
+      return generateSuggestions();
+    }
+    case "replace": {
+      return replace(options);
+    }
     default: {
       quit("Exiting Ditto CLI...");
       return;
@@ -103,7 +147,7 @@ const main = async () => {
   setupOptions();
 
   if (process.argv.length <= 2 && process.argv[1].includes("ditto-cli")) {
-    await executeCommand("none");
+    await executeCommand("none", []);
     return;
   }
 

package/lib/generate-suggestions.test.ts

@@ -0,0 +1,65 @@
+import fs from "fs/promises";
+import path from "path";
+import { findTextInJSXFiles } from "./generate-suggestions";
+
+describe("findTextInJSXFiles", () => {
+  async function createTempFile(filename, content) {
+    const filePath = path.join(".", filename);
+    await fs.writeFile(filePath, content);
+    return filePath;
+  }
+
+  async function deleteTempFile(filename) {
+    const filePath = path.join(".", filename);
+    await fs.unlink(filePath);
+  }
+
+  it("should return an empty array when no files are found", async () => {
+    const result = await findTextInJSXFiles(".", "searchString");
+
+    expect(result).toEqual([]);
+  });
+
+  it("should return an empty array when searchString is not found in any file", async () => {
+    const file1 = await createTempFile("file1.jsx", "<div>No match</div>");
+    const file2 = await createTempFile("file2.tsx", "<div>No match</div>");
+
+    const result = await findTextInJSXFiles(".", "searchString");
+
+    expect(result).toEqual([]);
+
+    await deleteTempFile(file1);
+    await deleteTempFile(file2);
+  });
+
+  it("should return an array with correct occurrences when searchString is found", async () => {
+    const file1 = await createTempFile(
+      "file1.jsx",
+      `<div>Test searchString and another searchString</div>`
+    );
+
+    const expectedResult = [
+      {
+        file: file1,
+        occurrences: [
+          {
+            lineNumber: 1,
+            preview:
+              "<div>Test {{searchString}} and another searchString</div>",
+          },
+          {
+            lineNumber: 1,
+            preview:
+              "<div>Test searchString and another {{searchString}}</div>",
+          },
+        ],
+      },
+    ];
+
+    const result = await findTextInJSXFiles(".", "searchString");
+
+    expect(result).toEqual(expectedResult);
+
+    await deleteTempFile(file1);
+  });
+});

package/lib/generate-suggestions.ts

@@ -0,0 +1,107 @@
+import fs from "fs-extra";
+import glob from "glob";
+import { parse } from "@babel/parser";
+import traverse from "@babel/traverse";
+
+import { fetchComponents } from "./http/fetchComponents";
+
+async function generateSuggestions() {
+  const components = await fetchComponents();
+  const results: {
+    [compApiId: string]: FindResults;
+  } = {};
+
+  for (const [compApiId, component] of Object.entries(components)) {
+    if (!results[compApiId]) {
+      results[compApiId] = [];
+    }
+    const result = await findTextInJSXFiles(".", component.text);
+    results[compApiId] = [...results[compApiId], ...result];
+  }
+
+  // Display results to user
+  console.log(JSON.stringify(results, null, 2));
+}
+
+interface Occurence {
+  lineNumber: number;
+  preview: string;
+}
+
+type FindResults = { file: string; occurrences: Occurence[] }[];
+
+async function findTextInJSXFiles(
+  path: string,
+  searchString: string
+): Promise<FindResults> {
+  const result: { file: string; occurrences: Occurence[] }[] = [];
+  const files = glob.sync(`${path}/**/*.+(jsx|tsx)`, {
+    ignore: "**/node_modules/**",
+  });
+
+  const promises: Promise<any>[] = [];
+
+  for (const file of files) {
+    promises.push(
+      fs.readFile(file, "utf-8").then((code) => {
+        const ast = parse(code, {
+          sourceType: "module",
+          plugins: ["jsx", "typescript"],
+        });
+
+        const occurrences: Occurence[] = [];
+
+        traverse(ast, {
+          JSXText(path) {
+            if (path.node.value.includes(searchString)) {
+              const regex = new RegExp(searchString, "g");
+              let match;
+              while ((match = regex.exec(path.node.value)) !== null) {
+                const lines = path.node.value.slice(0, match.index).split("\n");
+
+                if (!path.node.loc) {
+                  continue;
+                }
+
+                const lineNumber = path.node.loc.start.line + lines.length - 1;
+
+                const codeLines = code.split("\n");
+                const line = codeLines[lineNumber - 1];
+                const preview = replaceAt(
+                  line,
+                  match.index,
+                  searchString,
+                  `{{${searchString}}}`
+                );
+
+                occurrences.push({ lineNumber, preview });
+              }
+            }
+          },
+        });
+
+        if (occurrences.length > 0) {
+          result.push({ file, occurrences });
+        }
+      })
+    );
+  }
+
+  await Promise.all(promises);
+
+  return result;
+}
+
+function replaceAt(
+  str: string,
+  index: number,
+  searchString: string,
+  replacement: string
+) {
+  return (
+    str.substring(0, index) +
+    str.substring(index, str.length).replace(searchString, replacement)
+  );
+}
+
+export { findTextInJSXFiles, generateSuggestions };

package/lib/http/fetchComponents.ts

@@ -0,0 +1,14 @@
+import api from "../api";
+
+export async function fetchComponents() {
+  const { data } = await api.get<{
+    [compApiId: string]: {
+      name: string;
+      text: string;
+      status: "NONE" | "WIP" | "REVIEW" | "FINAL";
+      folder: "string" | null;
+    };
+  }>("/components", {});
+
+  return data;
+}