@dittowords/cli 1.1.1-beta.0

package/.eslintrc.js

@@ -0,0 +1,19 @@
+module.exports = {
+  env: {
+    browser: true,
+    commonjs: true,
+    es2020: true,
+    'jest/globals': true,
+  },
+  extends: [
+    'airbnb-base',
+  ],
+  parserOptions: {
+    ecmaVersion: 11,
+  },
+  plugins: ['jest'],
+  rules: {
+    'no-console': 'off',
+    'no-underscore-dangle': ['error', { allow: ['_id', '__get__'] }],
+  },
+};

package/README.md

@@ -0,0 +1,67 @@
+# Ditto CLI
+
+The Ditto CLI helps teams integrate [Ditto](https://dittowords.com/) into their build processes. You can use it to pull copy  into your codebase using the Ditto API right from the terminal.
+
+Ditto allows for end-to-end syncing of text from mockups (Figma) all the way to production. For more information, visit [dittowords.com](http://dittowords.com).
+
+## Getting Started
+
+Install the Ditto CLI globally by doing the following:
+
+```json
+npm install -g @dittowords/cli
+```
+
+Then, run `ditto-cli` to finish setting up. You’ll be prompted to:
+
+1. Provide your API key (found at [https://beta.dittowords.com/account/user](https://beta.dittowords.com/account/user) under **API Keys**).
+2. Choose a Ditto project in your workspace to pull copy from. Only projects with **developer mode** enabled are accessible via the API.
+
+Once you successfully provide that information, you’re ready to start fetching copy! You can set up the CLI in multiple directories by running the `ditto-cli` command and choosing a project to sync from.
+
+## Commands
+
+### `pull`
+
+**Usage:** `ditto-cli pull`
+**Action:** To pull the latest text from the linked project into `ditto/text.json`.
+
+The text will be pulled down as a structured JSON with IDs, and will locally overwrite what was previously in the file.
+
+### `project`
+
+**Usage:** `ditto-cli project`
+
+**Action:** To change the Ditto project you want to pull copy from in the current directory. Running this will allow you to select a project from a list of projects in your workspace that have developer mode enabled.
+
+The Ditto project that the directory is synced with is defined in  `ditto/config.yml`, and you can also manually change the linked project there.
+
+## Files
+
+### `ditto/`
+
+This folder is associated with your current working directory, so if you switch directories, we'll create a new folder there.
+
+- `config.yml`
+
+    This stores the information on which Ditto project you've selected to pull copy from in this directory.
+
+    You can change which project is defined here using the `project` command, or by manually replacing the contents of this file. If you switch directories, you'll automatically be prompted to choose a project to pull from.
+
+- `text.json`
+
+    The copy pulled from your Ditto project is saved to this file. Learn more about how this content is structured and how the IDs are generated by reading our guide here [LINK].
+
+### `.config/ditto`
+
+Your API key is saved to this file in your **root directory**. To change your API key, you'll need to open this file and replace the key manually.
+
+## SDKs
+
+Our SDKs make it easy to integrate the copy pulled from the Ditto CLI into your applications.
+
+- [Ditto React SDK](https://www.npmjs.com/package/ditto-react) for React applications. Allows for easy querying of text, blocks, frames, and more.
+
+## Feedback
+
+Have feedback? We’d love to hear it! Message us at [support@dittowords.com](mailto:support@dittowords.com).

package/babel.config.js

@@ -0,0 +1,12 @@
+module.exports = {
+  presets: [
+    [
+      '@babel/preset-env',
+      {
+        targets: {
+          node: 'current',
+        },
+      },
+    ],
+  ],
+};

package/bin/ditto.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+// This is the main entry point for the ditto-cli command.
+const { program } = require('commander');
+// to use V8's code cache to speed up instantiation time
+require('v8-compile-cache');
+
+const { init, needsInit } = require('../lib/init/init');
+const pull = require('../lib/pull');
+
+const addProject = require('../lib/add-project');
+const removeProject = require('../lib/remove-project');
+
+/**
+ * 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 checkInit = async (command) => {
+  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 {
+    switch (command) {
+      case 'pull':
+        pull();
+        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();
+  }
+  program.parse(process.argv);
+};
+
+main();

package/jest.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  transformIgnorePatterns: [],
+};

package/jsconfig.json

@@ -0,0 +1,7 @@
+{
+  "typeAcquisition": {
+      "include": [
+          "jest"
+      ]
+  }
+}

package/lib/add-project.js

@@ -0,0 +1,23 @@
+const { collectAndSaveProject } = require('./init/project');
+const projectsToText = require('./utils/projectsToText');
+const getSelectedProjects = require('./utils/getSelectedProjects');
+
+function quit(exitCode = 2) {
+  console.log('Project selection was not updated.');
+  process.exitCode = exitCode;
+  process.exit();
+}
+
+const addProject = async () => {
+  const projects = getSelectedProjects();
+
+  try {
+    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();
+  }
+};
+
+module.exports = addProject;

package/lib/api.js

@@ -0,0 +1,16 @@
+const axios = require('axios').default;
+
+const config = require('./config');
+const consts = require('./consts');
+
+function create(token) {
+  return axios.create({
+    baseURL: consts.API_HOST,
+    headers: {
+      Authorization: `token ${token}`,
+    },
+  });
+}
+
+module.exports = { create };
+module.exports.default = create(config.getToken(consts.CONFIG_FILE, consts.API_HOST));

package/lib/config.js

@@ -0,0 +1,84 @@
+const fs = require('fs');
+const path = require('path');
+const url = require('url');
+
+const yaml = require('js-yaml');
+
+function createFileIfMissing(filename) {
+  const dir = path.dirname(filename);
+
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir);
+
+  if (!fs.existsSync(filename)) {
+    fs.closeSync(fs.openSync(filename, 'w'));
+  }
+}
+
+function readData(file, defaultData = {}) {
+  createFileIfMissing(file);
+  const fileContents = fs.readFileSync(file, 'utf8');
+  return yaml.safeLoad(fileContents) || defaultData;
+}
+
+function writeData(file, data) {
+  createFileIfMissing(file);
+  const existingData = readData(file);
+  const yamlStr = yaml.safeDump({...existingData, ...data });
+  fs.writeFileSync(file, yamlStr, 'utf8');
+}
+
+function justTheHost(host) {
+  if (!host.includes('://')) return host;
+  return url.parse(host).hostname;
+}
+
+function deleteToken(file, host) {
+  const data = readData(file);
+  const hostParsed = justTheHost(host);
+  data[hostParsed] = [];
+  data[hostParsed][0] = {};
+  data[hostParsed][0].token = '';
+  writeData(file, data);
+}
+
+function saveToken(file, host, token) {
+  const data = readData(file);
+  const hostParsed = justTheHost(host);
+  data[hostParsed] = []; // only allow one token per host
+  data[hostParsed][0] = {};
+  data[hostParsed][0].token = token;
+  writeData(file, data);
+}
+
+function getToken(file, host) {
+  const data = readData(file);
+  const hostEntry = data[justTheHost(host)];
+  if (!hostEntry) return undefined;
+  const { length } = hostEntry;
+  return hostEntry[length - 1].token;
+}
+
+function save(file, key, value) {
+  const data = readData(file);
+  let current = data;
+  const parts = key.split('.');
+  parts.slice(0, -1).forEach((part) => {
+    if (!(part in current)) {
+      current[part] = {};
+      current = current[part];
+    }
+  });
+  current[parts.slice(-1)] = value;
+  writeData(file, data);
+}
+
+module.exports = {
+  createFileIfMissing,
+  readData,
+  writeData,
+  justTheHost,
+  saveToken,
+  deleteToken,
+  getToken,
+  save,
+};

package/lib/config.test.js

@@ -0,0 +1,90 @@
+/* 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');
+
+const fakeHomedir = fs.mkdtempSync(path.join(__dirname, '../testing/tmp'));
+
+describe('Config File', () => {
+  const expectedConfigDir = path.join(fakeHomedir, '.config');
+
+  beforeEach(() => {
+    if (!fs.existsSync(fakeHomedir)) fs.mkdirSync(fakeHomedir);
+  });
+
+  afterEach(() => {
+    fs.rmdirSync(fakeHomedir, { recursive: true });
+  });
+
+  describe('createFileIfMissing', () => {
+    const expectedConfigFile = path.join(expectedConfigDir, 'ditto');
+
+    it('creates a config file if the config dir is missing', () => {
+      config.createFileIfMissing(expectedConfigFile);
+      expect(fs.existsSync(expectedConfigFile)).toBeTruthy();
+    });
+    it("creates a config file if it's missing", () => {
+      fs.mkdirSync(expectedConfigDir);
+      config.createFileIfMissing(expectedConfigFile);
+      expect(fs.existsSync(expectedConfigFile)).toBeTruthy();
+    });
+
+    it('does nothing if it already exists', () => {
+      fs.mkdirSync(expectedConfigDir);
+      fs.closeSync(fs.openSync(expectedConfigFile, 'w'));
+      config.createFileIfMissing(expectedConfigFile);
+      expect(fs.existsSync(expectedConfigFile)).toBeTruthy();
+    });
+  });
+
+  describe('getToken', () => {
+    beforeEach(() => {
+
+    });
+  });
+});
+
+describe('Tokens in config files', () => {
+  const configFile = path.join(fakeHomedir, 'ditto');
+
+  beforeEach(() => {
+    config.createFileIfMissing(configFile);
+    config.saveToken(configFile, 'testing.dittowords.com', 'faketoken');
+  });
+
+  afterEach(() => {
+    fs.rmdirSync(fakeHomedir, { recursive: true });
+  });
+
+  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');
+    });
+  });
+
+  describe('getToken', () => {
+    it('can retrieve the saved token value', () => {
+      expect(config.getToken(configFile, 'testing.dittowords.com')).toEqual('faketoken');
+    });
+  });
+});
+
+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/consts.js

@@ -0,0 +1,9 @@
+const homedir = require('os').homedir();
+
+const path = require('path');
+
+module.exports.API_HOST = process.env.DITTO_API_HOST || 'https://api.dittowords.com';
+module.exports.CONFIG_FILE = process.env.DITTO_CONFIG_FILE || path.join(homedir, '.config', 'ditto');
+module.exports.PROJECT_CONFIG_FILE = path.normalize(path.join('ditto', 'config.yml'));
+module.exports.TEXT_FILE = path.normalize(path.join('ditto', 'text.json'));
+module.exports.TEXT_DIR = path.normalize('ditto');

package/lib/init/init.js

@@ -0,0 +1,34 @@
+// Related to initializing a user/environment to ditto.
+// expected to be run once per project.
+const boxen = require('boxen');
+const chalk = require('chalk');
+const getSelectedProjects = require('../utils/getSelectedProjects');
+const projectsToText = require('../utils/projectsToText');
+
+const { needsProjects, collectAndSaveProject } = require('./project');
+const { needsToken, collectAndSaveToken } = require('./token');
+
+const needsInit = () => needsToken() || needsProjects();
+
+function welcome() {
+  const msg = chalk.white(`${chalk.bold('Welcome to the',
+    chalk.magentaBright('Ditto CLI'))}.
+
+We're glad to have you here.`);
+  console.log(boxen(msg, { padding: 1 }));
+}
+
+async function init() {
+  welcome();
+  if (needsToken()) {
+    await collectAndSaveToken();
+  }
+  const selectedProjects = getSelectedProjects();
+  if (selectedProjects.length) {
+    console.log(`You're currently set up to sync text from the following projects: ${projectsToText(selectedProjects)}\n`);
+  } else {
+    await collectAndSaveProject(true);
+  }
+}
+
+module.exports = { needsInit, init };

package/lib/init/project.js

@@ -0,0 +1,116 @@
+const ora = require("ora");
+
+const api = require("../api").default;
+const config = require("../config");
+const consts = require("../consts");
+const output = require("../output");
+const { collectAndSaveToken } = require("../init/token");
+const getSelectedProjects = require("../utils/getSelectedProjects");
+const promptForProject = require("../utils/promptForProject");
+
+function quit(exitCode = 2) {
+  console.log("\nExiting Ditto CLI...\n");
+  process.exitCode = exitCode;
+  process.exit();
+}
+
+function saveProject(file, name, id) {
+  const projects = [...getSelectedProjects(), { name, id }];
+
+  config.writeData(file, { projects });
+}
+
+function needsProjects(configFile) {
+  const projects = getSelectedProjects(configFile);
+  return !(projects && projects.length);
+}
+
+async function askForAnotherToken() {
+  config.deleteToken(consts.CONFIG_FILE, consts.API_HOST);
+  const message =
+    "Looks like the API key you have saved no longer works. Please enter another one.";
+  await collectAndSaveToken(message);
+}
+
+async function listProjects(token, projectsAlreadySelected) {
+  const spinner = ora("Fetching projects in your workspace...");
+  spinner.start();
+
+  let projects = [];
+
+  try {
+    projects = await api.get("/project-names", {
+      headers: {
+        Authorization: `token ${token}`,
+      },
+    });
+  } catch (e) {
+    spinner.stop();
+    throw e;
+  }
+
+  spinner.stop();
+
+  return projects.data.filter(
+    ({ id }) => !projectsAlreadySelected.some((project) => project.id === id)
+  );
+}
+
+async function collectProject(token, initialize) {
+  const path = process.cwd();
+  if (initialize) {
+    console.log(
+      `Looks like are no Ditto projects selected for your current directory: ${output.info(
+        path
+      )}.`
+    );
+  }
+
+  const projectsAlreadySelected = getSelectedProjects();
+  const projects = await listProjects(token, projectsAlreadySelected);
+
+  if (!(projects && projects.length)) {
+    console.log("You're currently syncing all projects in your workspace.");
+    return null;
+  }
+
+  return promptForProject({
+    projects,
+    message: initialize
+      ? "Choose the project you'd like to sync text from"
+      : "Add a project",
+  });
+}
+
+async function collectAndSaveProject(initialize = false) {
+  try {
+    const token = config.getToken(consts.CONFIG_FILE, consts.API_HOST);
+    const project = await collectProject(token, initialize);
+    if (!project) {
+      quit(0);
+      return;
+    }
+
+    console.log(
+      "\n" +
+        `Thanks for adding ${output.info(
+          project.name
+        )} to your selected projects.\n` +
+        `We saved your updated configuration to: ${output.info(
+          consts.PROJECT_CONFIG_FILE
+        )}\n`
+    );
+
+    saveProject(consts.PROJECT_CONFIG_FILE, project.name, project.id);
+  } catch (e) {
+    console.log(e);
+    if (e.response && e.response.status === 404) {
+      await askForAnotherToken();
+      await collectAndSaveProject();
+    } else {
+      quit();
+    }
+  }
+}
+
+module.exports = { needsProjects, collectAndSaveProject };

package/lib/init/project.test.js

@@ -0,0 +1,83 @@
+const fs = require('fs');
+const path = require('path');
+
+const rewire = require('rewire');
+const yaml = require('js-yaml');
+const { createFileIfMissing } = require('../config');
+
+const project = rewire('./project');
+
+const { needsProject } = project;
+
+const saveProject = project.__get__('saveProject');
+const parseResponse = project.__get__('parseResponse');
+
+const fakeProjectDir = path.join(__dirname, '../../testing/tmp');
+const badYaml = path.join(__dirname, '../../testing/fixtures/bad-yaml.yml');
+const configEmptyProjects = path.join(__dirname, '../../testing/fixtures/bad-yaml.yml');
+const configMissingName = path.join(__dirname, '../../testing/fixtures/project-config-no-name.yml');
+const configMissingId = path.join(__dirname, '../../testing/fixtures/project-config-no-id.yml');
+const configLegit = path.join(__dirname, '../../testing/fixtures/project-config-working.yml');
+
+describe('saveProject', () => {
+  const configFile = path.join(fakeProjectDir, 'ditto/config.yml');
+  const projectName = 'My Amazing Project';
+  const projectId = '5f284259ce1d451b2eb2e23c';
+
+  beforeEach(() => {
+    if (!fs.existsSync(fakeProjectDir)) fs.mkdirSync(fakeProjectDir);
+    saveProject(configFile, projectName, projectId);
+  });
+
+  afterEach(() => {
+    fs.rmdirSync(fakeProjectDir, { recursive: true });
+  });
+
+  it('creates a config file with config data', () => {
+    const fileContents = fs.readFileSync(configFile, 'utf8');
+    const data = yaml.safeLoad(fileContents);
+    expect(data.projects).toBeDefined();
+    expect(data.projects[0].name).toEqual(projectName);
+    expect(data.projects[0].id).toEqual(projectId);
+  });
+});
+
+describe('needsProject()', () => {
+  const configFile = path.join(fakeProjectDir, 'ditto/config.yml');
+  it('is true if there is no existing config file', () => {
+    expect(needsProject(configFile)).toBeTruthy();
+  });
+
+  describe('with a file that exists', () => {
+    beforeEach(() => {
+      if (!fs.existsSync(fakeProjectDir)) fs.mkdirSync(fakeProjectDir);
+      createFileIfMissing(configFile);
+    });
+
+    it('is true if the file has no projects', () => {
+      expect(needsProject(configFile)).toBeTruthy();
+    });
+
+    it.each([
+      ['the file is bad yaml', badYaml],
+      ['no entries exist under projects', configEmptyProjects],
+      ['an entry exists without a name', configMissingName],
+      ['an entry exists without an id', configMissingId],
+    ])('is true if %s', (_msg, file) => {
+      expect(fs.existsSync(file)).toBeTruthy();
+      expect(needsProject(file)).toBeTruthy();
+    });
+
+    it('is false if a file exists with a propper project', () => {
+      expect(fs.existsSync(configLegit)).toBeTruthy();
+      expect(needsProject(configLegit)).toBeFalsy();
+    });
+  });
+});
+
+describe('parseResponse', () => {
+  const result = 'Large file test http://localhost:3000/doc/5ea120d8b56b315ffddb0ef8';
+  it('returns the id, name for a project result', () => {
+    expect(parseResponse(result)).toEqual({ id: '5ea120d8b56b315ffddb0ef8', name: 'Large file test' });
+  });
+});

package/lib/init/token.js

@@ -0,0 +1,77 @@
+const fs = require('fs');
+
+const chalk = require('chalk');
+
+const { prompt } = require('enquirer');
+
+const api = require('../api');
+const consts = require('../consts');
+const output = require('../output');
+const config = require('../config');
+
+function needsToken(configFile, host = consts.API_HOST) {
+  const file = configFile || consts.CONFIG_FILE;
+  if (!fs.existsSync(file)) return true;
+  const configData = config.readData(file);
+  if (!configData[config.justTheHost(host)] || configData[config.justTheHost(host)][0].token === '') return true;
+  return false;
+}
+
+// Returns true if valid, otherwise an error message.
+async function checkToken(token) {
+  const axios = api.create(token);
+  const endpoint = '/token-check';
+
+  const resOrError = await axios.get(endpoint).catch((error) => {
+    if (error.code === 'ENOTFOUND') {
+      return output.errorText(`Can't connect to API: ${output.url(error.hostname)}`);
+    }
+    if (error.response.status === 401 || error.response.status === 404) {
+      return output.errorText("This API key isn't valid. Please try another.");
+    }
+    return output.warnText("We're having trouble reaching the Ditto API.");
+  }).catch(() => output.errorText("Sorry! We're having trouble reaching the Ditto API."));
+
+  if (typeof resOrError === 'string') return resOrError;
+
+  if (resOrError.status === 200) return true;
+
+  return output.errorText("This API key isn't valid. Please try another.");
+}
+
+async function collectToken(message) {
+  const blue = output.info;
+  const apiUrl = output.url('https://beta.dittowords.com/account/user');
+  const breadcrumbs = `${blue('User')}`;
+  const tokenDescription = message || `To get started, you'll need your Ditto API key. You can find this at: ${apiUrl} > ${breadcrumbs} under "${chalk.bold('API Keys')}".`;
+  console.log(tokenDescription);
+
+  const response = await prompt({
+    type: 'input',
+    name: 'token',
+    message: 'What is your API key?',
+    validate: (token) => (checkToken(token)),
+  });
+  return response.token;
+}
+
+function quit(exitCode = 2) {
+  console.log('API key was not saved.');
+  process.exitCode = exitCode;
+  process.exit();
+}
+
+async function collectAndSaveToken(message = null) {
+  try {
+    const token = await collectToken(message);
+    console.log(`Thanks for authenticating.  We'll save the key to: ${output.info(consts.CONFIG_FILE)}`);
+    output.nl();
+
+    config.saveToken(consts.CONFIG_FILE, consts.API_HOST, token);
+    return token;
+  } catch (error) {
+    quit();
+  }
+}
+
+module.exports = { needsToken, collectAndSaveToken };

package/lib/init/token.test.js

@@ -0,0 +1,47 @@
+const tempy = require('tempy');
+
+const config = require('../config');
+const { needsToken } = require('./token');
+
+describe('needsToken()', () => {
+  it('is true if there is no config file', () => {
+    expect(needsToken(tempy.file())).toBeTruthy();
+  });
+
+  describe('with a config file', () => {
+    let configFile;
+
+    beforeEach(() => {
+      configFile = tempy.writeSync('');
+    });
+
+    it('returns true if empty', () => {
+      expect(needsToken(configFile, 'testing.dittowrods.com')).toBeTruthy();
+    });
+
+    describe('with some data', () => {
+      beforeEach(() => {
+        config.saveToken(configFile, 'badtesting.dittowords.com', 'faketoken');
+      });
+
+      it('is true if there is no entries for our API host', () => {
+        expect(needsToken(configFile, 'testing.dittowords.com')).toBeTruthy();
+      });
+
+      it('is false if we have a token listed', () => {
+        config.saveToken(configFile, 'testing.dittowords.com', 'faketoken');
+        expect(needsToken(configFile, 'testing.dittowords.com')).toBeFalsy();
+      });
+    });
+
+    it('is true if there is no token listed', () => {
+      const configNoToken = '../../testing/fixtures/ditto-config-no-token';
+      expect(needsToken(configNoToken, 'testing.dittowords.com')).toBeTruthy();
+    });
+
+    it('is strips the protocol when writing an entry', () => {
+      config.saveToken(configFile, 'https://testing.dittowords.com', 'faketoken');
+      expect(needsToken(configFile, 'testing.dittowords.com')).toBeFalsy();
+    });
+  });
+});

package/lib/output.js

@@ -0,0 +1,14 @@
+const chalk = require('chalk');
+
+const errorText = (msg) => chalk.magenta(msg);
+const warnText = (msg) => chalk.yellow(msg);
+const info = (msg) => chalk.blueBright(msg);
+const success = (msg) => chalk.green(msg);
+const url = (msg) => chalk.blueBright.underline(msg);
+const subtle = (msg) => chalk.grey(msg);
+const write = (msg) => chalk.white(msg);
+const nl = () => console.log('\n');
+
+module.exports = {
+  errorText, warnText, url, info, write, subtle, nl, success,
+};

package/lib/pull.js

@@ -0,0 +1,193 @@
+const fs = require("fs");
+const path = require("path");
+
+const ora = require("ora");
+
+const api = require("./api").default;
+const config = require("./config");
+const consts = require("./consts");
+const output = require("./output");
+const { collectAndSaveToken } = require("./init/token");
+const projectsToText = require("./utils/projectsToText");
+
+async function askForAnotherToken() {
+  config.deleteToken(consts.CONFIG_FILE, consts.API_HOST);
+  const message =
+    "Looks like the API key you have saved no longer works. Please enter another one.";
+  await collectAndSaveToken(message);
+}
+
+async function downloadAndSaveVariant(variantApiId, projectIds, format) {
+  const params = { projectIds };
+  if (variantApiId) {
+    params.variant = variantApiId;
+  }
+  if (format) {
+    params.format = format;
+  }
+
+  const { data } = await api.get("/projects", { params });
+
+  const filename = `${variantApiId || "base"}.json`;
+  const filepath = path.join(consts.TEXT_DIR, filename);
+
+  const dataString = JSON.stringify(data, null, 2);
+
+  fs.writeFileSync(filepath, dataString);
+
+  return getSavedMessage(filename);
+}
+
+async function downloadAndSaveVariants(projectIds, format) {
+  const { data: variants } = await api.get("/variants");
+
+  const messages = await Promise.all([
+    downloadAndSaveVariant(null, projectIds, format),
+    ...variants.map(({ apiID }) =>
+      downloadAndSaveVariant(apiID, projectIds, format)
+    ),
+  ]);
+
+  return messages.join("");
+}
+
+async function downloadAndSaveBase(projectIds, format) {
+  const params = { projectIds };
+  if (format) {
+    params.format = format;
+  }
+
+  const { data } = await api.get(`/projects`, { params });
+  const dataString = JSON.stringify(data, null, 2);
+
+  fs.writeFileSync(consts.TEXT_FILE, dataString);
+
+  return getSavedMessage("text.json");
+}
+
+function getSavedMessage(file) {
+  return `Successfully saved to ${output.info(file)}.\n`;
+}
+
+function cleanOutputFiles() {
+  if (!fs.existsSync(consts.TEXT_DIR)) {
+    fs.mkdirSync(consts.TEXT_DIR);
+  }
+
+  const fileNames = fs.readdirSync(consts.TEXT_DIR);
+  fileNames.forEach((fileName) => {
+    if (/\.js(on)?$/.test(fileName)) {
+      fs.unlinkSync(path.resolve(consts.TEXT_DIR, fileName));
+    }
+  });
+
+  return "Cleaning old output files..\n";
+}
+
+/**
+ * Generates an index.js file that can be consumed
+ * by an SDK - this is a big DX improvement because
+ * it provides a single entry point to get all data
+ * (including variants) instead of having to import
+ * each generated file individually.
+ */
+function generateJsDriver() {
+  const fileNames = fs.readdirSync(consts.TEXT_DIR);
+
+  const driverExport = fileNames.reduce((obj, fileName) => {
+    const [name, extension] = fileName.split(".");
+
+    if (extension === "json") {
+      return {
+        ...obj,
+        [name]: `require('./${fileName}')`,
+      };
+    }
+
+    return obj;
+  }, {});
+
+  let dataString = `module.exports = ${JSON.stringify(driverExport, null, 2)}`
+    // remove quotes around require statements
+    .replace(/"require\((.*)\)"/g, "require($1)");
+
+  fs.writeFileSync(path.resolve(consts.TEXT_DIR, "index.js"), dataString, {
+    encoding: "utf8",
+  });
+}
+
+async function downloadAndSave(projectConfig) {
+  const { projects, variants, format } = projectConfig;
+
+  const projectNames = [];
+  const projectIds = [];
+
+  projects.forEach(({ name, id }) => {
+    projectNames.push(name);
+    projectIds.push(id);
+  });
+
+  let msg = `\nFetching the latest text from your selected projects: ${projectsToText(
+    projects
+  )}\n`;
+
+  const spinner = ora(msg);
+  spinner.start();
+
+  try {
+    msg += cleanOutputFiles();
+
+    msg += variants
+      ? await downloadAndSaveVariants(projectIds, format)
+      : await downloadAndSaveBase(projectIds, format);
+
+    msg += generateJsDriver();
+
+    msg += `\n${output.success("Done")}!`;
+
+    spinner.stop();
+    return console.log(msg);
+  } catch (e) {
+    spinner.stop();
+    let error = e.message;
+    if (e.response && e.response.status === 404) {
+      await askForAnotherToken();
+      pull();
+      return;
+    }
+    if (e.response && e.response.status === 401) {
+      error = "You don't have access to the selected projects";
+      msg = `${output.errorText(error)}.\nChoose others using the ${output.info(
+        "project"
+      )} command, or update your API key.`;
+      return console.log(msg);
+    }
+    if (e.response && e.response.status === 403) {
+      error =
+        "One or more of the requested projects don't have Developer Mode enabled";
+      msg = `${output.errorText(
+        error
+      )}.\nPlease choose different projects using the ${output.info(
+        "project"
+      )} command, or turn on Developer Mode for all selected projects. Learn more here: ${output.subtle(
+        "https://www.dittowords.com/docs/ditto-developer-mode"
+      )}.`;
+      return console.log(msg);
+    }
+    if (e.response && e.response.status === 400) {
+      error = "projects not found";
+    }
+    msg = `We hit an error fetching text from the projects: ${output.errorText(
+      error
+    )}.\nChoose others using the ${output.info("project")} command.`;
+    return console.log(msg);
+  }
+}
+
+function pull() {
+  const token = config.getToken(consts.CONFIG_FILE, consts.API_HOST);
+  const pConfig = config.readData(consts.PROJECT_CONFIG_FILE);
+  return downloadAndSave(pConfig, token);
+}
+
+module.exports = pull;

package/lib/pull.test.js

@@ -0,0 +1,40 @@
+const tempy = require('tempy');
+const rewire = require('rewire');
+
+const pull = rewire('./pull');
+
+const shouldOverwrite = pull.__get__('shouldOverwrite');
+
+describe('shouldOverwrite', () => {
+  let config;
+  let configOverwrite;
+  let configNever;
+
+  beforeEach(() => {
+    config = { settings: { } };
+    configOverwrite = { settings: { overwrite: true } };
+    configNever = { settings: { overwrite: false } };
+  });
+
+  it("returns true if there's no file", () => {
+    expect(shouldOverwrite(config, '.doesnotexist')).toBeTruthy();
+  });
+
+  describe('when the file exists', () => {
+    let existingFile;
+    beforeAll(() => {
+      existingFile = tempy.writeSync('');
+    });
+    it("returns 'ask' if there is no config setting", () => {
+      expect(shouldOverwrite(config, existingFile)).toEqual('ASK');
+    });
+
+    it('returns true if config says overwrite', () => {
+      expect(shouldOverwrite(configOverwrite, existingFile)).toEqual(true);
+    });
+
+    it("returns false if config says don't overwrite", () => {
+      expect(shouldOverwrite(configNever, existingFile)).toEqual(false);
+    });
+  });
+});

package/lib/remove-project.js

@@ -0,0 +1,37 @@
+const config = require('./config');
+const consts = require('./consts');
+const output = require('./output');
+const getSelectedProjects = require("./utils/getSelectedProjects");
+const promptForProject = require("./utils/promptForProject");
+
+async function removeProject() {
+  const projects = getSelectedProjects();
+  if (!projects.length) {
+    console.log(
+      "\n" + 
+      "No projects found in your workspace.\n" +
+      `Try adding one with: ${output.info("ditto-cli project add")}\n`);
+    return;
+  }
+
+  const projectToRemove = await promptForProject({ 
+    projects,
+    message: "Select a project to remove"
+  });
+  if (!projectToRemove) 
+    return;
+  
+
+  config.writeData(
+    consts.PROJECT_CONFIG_FILE,
+    { projects: projects.filter(({ id }) => id !== projectToRemove.id)}
+  );
+
+  console.log(
+    `\n${output.info(projectToRemove.name)} has been removed from your selected projects. ` + 
+    `\nWe saved your updated configuration to: ${output.info(consts.PROJECT_CONFIG_FILE)}` +
+    "\n"
+  );
+}
+
+module.exports = removeProject;

package/lib/utils/getSelectedProjects.js

@@ -0,0 +1,41 @@
+const fs = require('fs');
+const yaml = require('js-yaml');
+
+const { PROJECT_CONFIG_FILE } = require('../consts');
+
+function yamlToJson(_yaml) {
+  try {
+    return yaml.safeLoad(_yaml);
+  }
+  catch (e) {
+    if (e instanceof YAMLException) {
+      return "";
+    }
+    else {
+      throw e;
+    }
+  }
+}
+
+/**
+ * Returns an array containing all valid projects ({ id, name })
+ * currently contained in the project config file.
+ */
+function getSelectedProjects(configFile = PROJECT_CONFIG_FILE) {
+  if (!fs.existsSync(configFile)) 
+    return [];
+
+  const contentYaml = fs.readFileSync(configFile, 'utf8');
+  const contentJson = yamlToJson(contentYaml);
+
+  if (!(
+    contentJson &&
+    contentJson.projects
+  )) {
+    return [];
+  }
+
+  return contentJson.projects.filter(({ name, id }) => name && id);
+}
+
+module.exports = getSelectedProjects;

package/lib/utils/projectsToText.js

@@ -0,0 +1,14 @@
+const output = require('../output');
+
+function projectsToText(projects) {
+  return projects.reduce((outputString, { name, id }) => 
+    outputString + (
+      "\n" +
+      "- " + output.info(name) +
+      " " +
+      output.subtle('https://beta.dittowords.com/doc/' + id)
+    ), ""
+  ) + "\n"
+}
+
+module.exports = projectsToText;

package/lib/utils/promptForProject.js

@@ -0,0 +1,50 @@
+const { AutoComplete } = require('enquirer');
+
+const output = require('../output');
+
+function formatProjectChoice(project) {
+  return project.name + " " + output.subtle(
+    project.url || `https://beta.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 };
+}
+
+async function promptForProject({ message, projects, limit = 10 }) {
+  output.nl();
+
+  const choices = projects.map(formatProjectChoice);
+  const prompt = new AutoComplete({
+    name: 'project',
+    message,
+    limit,
+    choices,
+  });
+
+  let response;
+
+  try {
+    response = await prompt.run();
+  }
+  // this catch handles the case where someone presses
+  // Ctrl + C to kill the AutoComplete process
+  catch (e) {
+    response = null;
+  }
+
+  return parseResponse(response);
+}
+
+module.exports = promptForProject;

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@dittowords/cli",
+  "version": "1.1.1-beta.0",
+  "description": "Command Line Interface for Ditto (dittowords.com).",
+  "main": "bin/index.js",
+  "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"
+  ],
+  "bin": {
+    "ditto-cli": "./bin/ditto.js"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.11.4",
+    "@babel/preset-env": "^7.11.0",
+    "@types/jest": "^26.0.9",
+    "babel-jest": "^26.3.0",
+    "eslint": "^7.6.0",
+    "eslint-config-airbnb-base": "^14.2.0",
+    "eslint-plugin-import": "^2.22.0",
+    "eslint-plugin-jest": "^23.20.0",
+    "jest": "^26.3.0",
+    "rewire": "^5.0.0",
+    "source-map": "^0.7.3",
+    "tempy": "^0.6.0",
+    "tsconfig-paths": "^3.9.0",
+    "typescript": "^4.0.2"
+  },
+  "dependencies": {
+    "axios": "^0.19.2",
+    "boxen": "^4.2.0",
+    "chalk": "^4.1.0",
+    "commander": "^6.1.0",
+    "enquirer": "^2.3.6",
+    "faker": "^5.1.0",
+    "js-yaml": "^3.14.0",
+    "ora": "^5.0.0",
+    "v8-compile-cache": "^2.1.1"
+  }
+}

package/pull_request_template.md

@@ -0,0 +1,15 @@
+## Overview
+<!--- What does this PR do? --->
+
+## Context
+<!--- Any context about why you are creating this PR? Notion doc, screenshot, conversation, etc. --->
+
+## Screenshots
+<!--- Include some screenshots of any visual changes you made to make it easier for the reviewer to understand what changes were made --->
+
+## Test Plan
+Testing successfully completed in <env> via:
+- [ ] test 1
+- [ ] test 2
+- [ ] test ...
+- [ ] test n

package/testfiles/en.json

@@ -0,0 +1,5 @@
+{
+  "header": "Hello World!",
+  "body": "This is an example that I'm creating - super nice to meet you!",
+  "footer": "Please contact us if you need any help"
+}

package/testfiles/es.json

@@ -0,0 +1,5 @@
+{
+  "header": "Hola mundo!",
+  "body": "Esto es un ejemplo que estoy criando - mucho gusto!",
+  "footer": "Por favor, contacte-nos si necesitas ayuda"
+}

package/testfiles/fr.json

@@ -0,0 +1,5 @@
+{
+  "header": "Bonjour le world!",
+  "body": "Le example I am le making - eet es noice tu meet yu",
+  "footer": "s'il te plait (??)"
+}

package/testing/fixtures/bad-yaml.yml

@@ -0,0 +1,6 @@
+dashboard "Variables example":
+  - h1 text: Variables Example
+  -       dropdown my_var=pie:
+    - {"value": pie, "text": "Pie chart"}
+    - {"value": bar, "text": "Bar chart"}
+   p text: "Selected chart type: ${my_var}"

package/testing/fixtures/ditto-config-no-token

@@ -0,0 +1,2 @@
+testing.dittowords.com:
+- notoken: lol

package/testing/fixtures/project-config-empty-projects.yml

@@ -0,0 +1 @@
+projects:

package/testing/fixtures/project-config-no-id.yml

@@ -0,0 +1,2 @@
+projects:
+- name: 123

package/testing/fixtures/project-config-no-name.yml

@@ -0,0 +1,2 @@
+projects:
+- id: 123

package/testing/fixtures/project-config-working.yml

@@ -0,0 +1,3 @@
+projects:
+  - id: 123
+    name: 'hi there!'