@vocab/phrase 0.0.0-delete-unused-keys-20228144520 → 0.0.0-package-files-20231142931

package/CHANGELOG.md

@@ -1,10 +1,36 @@
 # @vocab/phrase
 
-## 0.0.0-delete-unused-keys-20228144520
+## 0.0.0-package-files-20231142931
+
+### Patch Changes
+
+- [`29c81d3`](https://github.com/seek-oss/vocab/commit/29c81d370799f631d97c45e727b8cf81453bd398) Thanks [@askoufis](https://github.com/askoufis)! - Exclude source files from package build
+
+- Updated dependencies [[`29c81d3`](https://github.com/seek-oss/vocab/commit/29c81d370799f631d97c45e727b8cf81453bd398)]:
+  - @vocab/types@0.0.0-package-files-20231142931
+
+## 1.1.0
 
 ### Minor Changes
 
-- [`fcd1482`](https://github.com/seek-oss/vocab/commit/fcd1482753e74274935f00ac0fc3afe1bf7f1989) Thanks [@askoufis](https://github.com/askoufis)! - Add an optional `deleteUnusedKeys` flag to the `push` function. If set to `true`, unused keys will be deleted from Phrase after translations are pushed.
+- [`66ed22c`](https://github.com/seek-oss/vocab/commit/66ed22cac6f89018d5fd69fd6f6408e090e1a382) [#93](https://github.com/seek-oss/vocab/pull/93) Thanks [@askoufis](https://github.com/askoufis)! - Add an optional `deleteUnusedKeys` flag to the `push` function. If set to `true`, unused keys will be deleted from Phrase after translations are pushed.
+
+  **EXAMPLE USAGE**:
+
+  ```js
+  import { push } from '@vocab/phrase';
+
+  const vocabConfig = {
+    devLanguage: 'en',
+    language: ['en', 'fr'],
+  };
+
+  await push({ branch: 'myBranch', deleteUnusedKeys: true }, vocabConfig);
+  ```
+
+### Patch Changes
+
+- [`159d559`](https://github.com/seek-oss/vocab/commit/159d559c87c66c3e91c707fb45a1f67ebec07b4d) [#91](https://github.com/seek-oss/vocab/pull/91) Thanks [@askoufis](https://github.com/askoufis)! - Improve error message when Phrase doesn't return any translations for the dev language
 
 ## 1.0.1
 

package/dist/vocab-phrase.cjs.dev.js

@@ -44,14 +44,14 @@ function _callPhrase(path, options = {}) {
   }).then(async response => {
     console.log(`${path}: ${response.status} - ${response.statusText}`);
     console.log(`Rate Limit: ${response.headers.get('X-Rate-Limit-Remaining')} of ${response.headers.get('X-Rate-Limit-Limit')} remaining. (${response.headers.get('X-Rate-Limit-Reset')} seconds remaining})`);
-    console.log('\nLink:', response.headers.get('Link'), '\n'); // Print All Headers:
+    trace('\nLink:', response.headers.get('Link'), '\n'); // Print All Headers:
     // console.log(Array.from(r.headers.entries()));
 
     try {
       var _response$headers$get;
 
       const result = await response.json();
-      console.log(`Internal Result (Length: ${result.length})\n`);
+      trace(`Internal Result (Length: ${result.length})\n`);
 
       if ((!options.method || options.method === 'GET') && (_response$headers$get = response.headers.get('Link')) !== null && _response$headers$get !== void 0 && _response$headers$get.includes('rel=next')) {
         var _response$headers$get2, _response$headers$get3;
@@ -59,10 +59,10 @@ function _callPhrase(path, options = {}) {
         const [, nextPageUrl] = (_response$headers$get2 = (_response$headers$get3 = response.headers.get('Link')) === null || _response$headers$get3 === void 0 ? void 0 : _response$headers$get3.match(/<([^>]*)>; rel=next/)) !== null && _response$headers$get2 !== void 0 ? _response$headers$get2 : [];
 
         if (!nextPageUrl) {
-          throw new Error('Cant parse next page URL');
+          throw new Error("Can't parse next page URL");
         }
 
-        console.log('Results recieved with next page: ', nextPageUrl);
+        console.log('Results received with next page: ', nextPageUrl);
         const nextPageResult = await _callPhrase(nextPageUrl, options);
         return [...result, ...nextPageResult];
       }
@@ -120,7 +120,7 @@ async function pushTranslationsByLocale(contents, locale, branch) {
   formData.append('locale_id', locale);
   formData.append('branch', branch);
   formData.append('update_translations', 'true');
-  trace('Starting to upload:', locale);
+  log('Starting to upload:', locale, '\n');
   const {
     id
   } = await callPhrase(`uploads`, {
@@ -135,7 +135,9 @@ async function pushTranslationsByLocale(contents, locale, branch) {
 }
 async function deleteUnusedKeys(uploadId, locale, branch) {
   const query = `unmentioned_in_upload:${uploadId}`;
-  const result = await callPhrase('keys', {
+  const {
+    records_affected
+  } = await callPhrase('keys', {
     method: 'DELETE',
     headers: {
       'Content-Type': 'application/json'
@@ -146,7 +148,7 @@ async function deleteUnusedKeys(uploadId, locale, branch) {
       q: query
     })
   });
-  log('Successfully deleted', result.records_affected, 'unused keys from branch', branch);
+  log('Successfully deleted', records_affected, 'unused keys from branch', branch);
 }
 async function ensureBranch(branch) {
   await callPhrase(`branches`, {
@@ -158,7 +160,7 @@ async function ensureBranch(branch) {
       name: branch
     })
   });
-  trace('Created branch:', branch);
+  log('Created branch:', branch);
 }
 
 async function pull({
@@ -169,6 +171,13 @@ async function pull({
   const alternativeLanguages = core.getAltLanguages(config);
   const allPhraseTranslations = await pullAllTranslations(branch);
   trace(`Pulling translations from Phrase for languages ${config.devLanguage} and ${alternativeLanguages.join(', ')}`);
+  const phraseLanguages = Object.keys(allPhraseTranslations);
+  trace(`Found Phrase translations for languages ${phraseLanguages.join(', ')}`);
+
+  if (!phraseLanguages.includes(config.devLanguage)) {
+    throw new Error(`Phrase did not return any translations for the configured development language "${config.devLanguage}".\nPlease ensure this language is present in your Phrase project's configuration.`);
+  }
+
   const allVocabTranslations = await core.loadAllTranslations({
     fallbacks: 'none',
     includeNodeModules: false

package/dist/vocab-phrase.cjs.prod.js

@@ -44,14 +44,14 @@ function _callPhrase(path, options = {}) {
   }).then(async response => {
     console.log(`${path}: ${response.status} - ${response.statusText}`);
     console.log(`Rate Limit: ${response.headers.get('X-Rate-Limit-Remaining')} of ${response.headers.get('X-Rate-Limit-Limit')} remaining. (${response.headers.get('X-Rate-Limit-Reset')} seconds remaining})`);
-    console.log('\nLink:', response.headers.get('Link'), '\n'); // Print All Headers:
+    trace('\nLink:', response.headers.get('Link'), '\n'); // Print All Headers:
     // console.log(Array.from(r.headers.entries()));
 
     try {
       var _response$headers$get;
 
       const result = await response.json();
-      console.log(`Internal Result (Length: ${result.length})\n`);
+      trace(`Internal Result (Length: ${result.length})\n`);
 
       if ((!options.method || options.method === 'GET') && (_response$headers$get = response.headers.get('Link')) !== null && _response$headers$get !== void 0 && _response$headers$get.includes('rel=next')) {
         var _response$headers$get2, _response$headers$get3;
@@ -59,10 +59,10 @@ function _callPhrase(path, options = {}) {
         const [, nextPageUrl] = (_response$headers$get2 = (_response$headers$get3 = response.headers.get('Link')) === null || _response$headers$get3 === void 0 ? void 0 : _response$headers$get3.match(/<([^>]*)>; rel=next/)) !== null && _response$headers$get2 !== void 0 ? _response$headers$get2 : [];
 
         if (!nextPageUrl) {
-          throw new Error('Cant parse next page URL');
+          throw new Error("Can't parse next page URL");
         }
 
-        console.log('Results recieved with next page: ', nextPageUrl);
+        console.log('Results received with next page: ', nextPageUrl);
         const nextPageResult = await _callPhrase(nextPageUrl, options);
         return [...result, ...nextPageResult];
       }
@@ -120,7 +120,7 @@ async function pushTranslationsByLocale(contents, locale, branch) {
   formData.append('locale_id', locale);
   formData.append('branch', branch);
   formData.append('update_translations', 'true');
-  trace('Starting to upload:', locale);
+  log('Starting to upload:', locale, '\n');
   const {
     id
   } = await callPhrase(`uploads`, {
@@ -135,7 +135,9 @@ async function pushTranslationsByLocale(contents, locale, branch) {
 }
 async function deleteUnusedKeys(uploadId, locale, branch) {
   const query = `unmentioned_in_upload:${uploadId}`;
-  const result = await callPhrase('keys', {
+  const {
+    records_affected
+  } = await callPhrase('keys', {
     method: 'DELETE',
     headers: {
       'Content-Type': 'application/json'
@@ -146,7 +148,7 @@ async function deleteUnusedKeys(uploadId, locale, branch) {
       q: query
     })
   });
-  log('Successfully deleted', result.records_affected, 'unused keys from branch', branch);
+  log('Successfully deleted', records_affected, 'unused keys from branch', branch);
 }
 async function ensureBranch(branch) {
   await callPhrase(`branches`, {
@@ -158,7 +160,7 @@ async function ensureBranch(branch) {
       name: branch
     })
   });
-  trace('Created branch:', branch);
+  log('Created branch:', branch);
 }
 
 async function pull({
@@ -169,6 +171,13 @@ async function pull({
   const alternativeLanguages = core.getAltLanguages(config);
   const allPhraseTranslations = await pullAllTranslations(branch);
   trace(`Pulling translations from Phrase for languages ${config.devLanguage} and ${alternativeLanguages.join(', ')}`);
+  const phraseLanguages = Object.keys(allPhraseTranslations);
+  trace(`Found Phrase translations for languages ${phraseLanguages.join(', ')}`);
+
+  if (!phraseLanguages.includes(config.devLanguage)) {
+    throw new Error(`Phrase did not return any translations for the configured development language "${config.devLanguage}".\nPlease ensure this language is present in your Phrase project's configuration.`);
+  }
+
   const allVocabTranslations = await core.loadAllTranslations({
     fallbacks: 'none',
     includeNodeModules: false

package/dist/vocab-phrase.esm.js

@@ -32,14 +32,14 @@ function _callPhrase(path, options = {}) {
   }).then(async response => {
     console.log(`${path}: ${response.status} - ${response.statusText}`);
     console.log(`Rate Limit: ${response.headers.get('X-Rate-Limit-Remaining')} of ${response.headers.get('X-Rate-Limit-Limit')} remaining. (${response.headers.get('X-Rate-Limit-Reset')} seconds remaining})`);
-    console.log('\nLink:', response.headers.get('Link'), '\n'); // Print All Headers:
+    trace('\nLink:', response.headers.get('Link'), '\n'); // Print All Headers:
     // console.log(Array.from(r.headers.entries()));
 
     try {
       var _response$headers$get;
 
       const result = await response.json();
-      console.log(`Internal Result (Length: ${result.length})\n`);
+      trace(`Internal Result (Length: ${result.length})\n`);
 
       if ((!options.method || options.method === 'GET') && (_response$headers$get = response.headers.get('Link')) !== null && _response$headers$get !== void 0 && _response$headers$get.includes('rel=next')) {
         var _response$headers$get2, _response$headers$get3;
@@ -47,10 +47,10 @@ function _callPhrase(path, options = {}) {
         const [, nextPageUrl] = (_response$headers$get2 = (_response$headers$get3 = response.headers.get('Link')) === null || _response$headers$get3 === void 0 ? void 0 : _response$headers$get3.match(/<([^>]*)>; rel=next/)) !== null && _response$headers$get2 !== void 0 ? _response$headers$get2 : [];
 
         if (!nextPageUrl) {
-          throw new Error('Cant parse next page URL');
+          throw new Error("Can't parse next page URL");
         }
 
-        console.log('Results recieved with next page: ', nextPageUrl);
+        console.log('Results received with next page: ', nextPageUrl);
         const nextPageResult = await _callPhrase(nextPageUrl, options);
         return [...result, ...nextPageResult];
       }
@@ -108,7 +108,7 @@ async function pushTranslationsByLocale(contents, locale, branch) {
   formData.append('locale_id', locale);
   formData.append('branch', branch);
   formData.append('update_translations', 'true');
-  trace('Starting to upload:', locale);
+  log('Starting to upload:', locale, '\n');
   const {
     id
   } = await callPhrase(`uploads`, {
@@ -123,7 +123,9 @@ async function pushTranslationsByLocale(contents, locale, branch) {
 }
 async function deleteUnusedKeys(uploadId, locale, branch) {
   const query = `unmentioned_in_upload:${uploadId}`;
-  const result = await callPhrase('keys', {
+  const {
+    records_affected
+  } = await callPhrase('keys', {
     method: 'DELETE',
     headers: {
       'Content-Type': 'application/json'
@@ -134,7 +136,7 @@ async function deleteUnusedKeys(uploadId, locale, branch) {
       q: query
     })
   });
-  log('Successfully deleted', result.records_affected, 'unused keys from branch', branch);
+  log('Successfully deleted', records_affected, 'unused keys from branch', branch);
 }
 async function ensureBranch(branch) {
   await callPhrase(`branches`, {
@@ -146,7 +148,7 @@ async function ensureBranch(branch) {
       name: branch
     })
   });
-  trace('Created branch:', branch);
+  log('Created branch:', branch);
 }
 
 async function pull({
@@ -157,6 +159,13 @@ async function pull({
   const alternativeLanguages = getAltLanguages(config);
   const allPhraseTranslations = await pullAllTranslations(branch);
   trace(`Pulling translations from Phrase for languages ${config.devLanguage} and ${alternativeLanguages.join(', ')}`);
+  const phraseLanguages = Object.keys(allPhraseTranslations);
+  trace(`Found Phrase translations for languages ${phraseLanguages.join(', ')}`);
+
+  if (!phraseLanguages.includes(config.devLanguage)) {
+    throw new Error(`Phrase did not return any translations for the configured development language "${config.devLanguage}".\nPlease ensure this language is present in your Phrase project's configuration.`);
+  }
+
   const allVocabTranslations = await loadAllTranslations({
     fallbacks: 'none',
     includeNodeModules: false

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "@vocab/phrase",
-  "version": "0.0.0-delete-unused-keys-20228144520",
+  "version": "0.0.0-package-files-20231142931",
   "main": "dist/vocab-phrase.cjs.js",
   "module": "dist/vocab-phrase.esm.js",
   "author": "SEEK",
   "license": "MIT",
   "dependencies": {
     "@vocab/core": "^1.0.0",
-    "@vocab/types": "^1.0.0",
+    "@vocab/types": "^0.0.0-package-files-20231142931",
     "chalk": "^4.1.0",
     "debug": "^4.3.1",
     "form-data": "^3.0.0",
     "node-fetch": "^2.6.1"
   },
+  "files": [
+    "dist"
+  ],
   "devDependencies": {
     "@types/node-fetch": "^2.5.7"
   }

package/src/file.ts

@@ -1,4 +0,0 @@
-import { promises as fs } from 'fs';
-
-export const mkdir = fs.mkdir;
-export const writeFile = fs.writeFile;

package/src/index.ts

@@ -1,2 +0,0 @@
-export { pull } from './pull-translations';
-export { push } from './push-translations';

package/src/logger.ts

@@ -1,9 +0,0 @@
-import chalk from 'chalk';
-import debug from 'debug';
-
-export const trace = debug(`vocab:phrase`);
-
-export const log = (...params: unknown[]) => {
-  // eslint-disable-next-line no-console
-  console.log(chalk.yellow('Vocab'), ...params);
-};

package/src/phrase-api.ts

@@ -1,173 +0,0 @@
-import FormData from 'form-data';
-import { TranslationsByKey } from './../../types/src/index';
-/* eslint-disable no-console */
-import type { TranslationsByLanguage } from '@vocab/types';
-import fetch from 'node-fetch';
-import { log, trace } from './logger';
-
-function _callPhrase(path: string, options: Parameters<typeof fetch>[1] = {}) {
-  const phraseApiToken = process.env.PHRASE_API_TOKEN;
-
-  if (!phraseApiToken) {
-    throw new Error('Missing PHRASE_API_TOKEN');
-  }
-
-  return fetch(path, {
-    ...options,
-    headers: {
-      Authorization: `token ${phraseApiToken}`,
-      // Provide identification via User Agent as requested in https://developers.phrase.com/api/#overview--identification-via-user-agent
-      'User-Agent': 'SEEK Demo Candidate App (jhope@seek.com.au)',
-      ...options.headers,
-    },
-  }).then(async (response) => {
-    console.log(`${path}: ${response.status} - ${response.statusText}`);
-    console.log(
-      `Rate Limit: ${response.headers.get(
-        'X-Rate-Limit-Remaining',
-      )} of ${response.headers.get(
-        'X-Rate-Limit-Limit',
-      )} remaining. (${response.headers.get(
-        'X-Rate-Limit-Reset',
-      )} seconds remaining})`,
-    );
-    console.log('\nLink:', response.headers.get('Link'), '\n');
-    // Print All Headers:
-    // console.log(Array.from(r.headers.entries()));
-
-    try {
-      const result = await response.json();
-
-      console.log(`Internal Result (Length: ${result.length})\n`);
-
-      if (
-        (!options.method || options.method === 'GET') &&
-        response.headers.get('Link')?.includes('rel=next')
-      ) {
-        const [, nextPageUrl] =
-          response.headers.get('Link')?.match(/<([^>]*)>; rel=next/) ?? [];
-
-        if (!nextPageUrl) {
-          throw new Error('Cant parse next page URL');
-        }
-
-        console.log('Results recieved with next page: ', nextPageUrl);
-
-        const nextPageResult = (await _callPhrase(nextPageUrl, options)) as any;
-
-        return [...result, ...nextPageResult];
-      }
-
-      return result;
-    } catch (e) {
-      console.error('Unable to parse response as JSON', e);
-      return response.text();
-    }
-  });
-}
-
-export async function callPhrase<T = any>(
-  relativePath: string,
-  options: Parameters<typeof fetch>[1] = {},
-): Promise<T> {
-  const projectId = process.env.PHRASE_PROJECT_ID;
-
-  if (!projectId) {
-    throw new Error('Missing PHRASE_PROJECT_ID');
-  }
-  return _callPhrase(
-    `https://api.phrase.com/v2/projects/${projectId}/${relativePath}`,
-    options,
-  )
-    .then((result) => {
-      if (Array.isArray(result)) {
-        console.log('Result length:', result.length);
-      }
-      return result;
-    })
-    .catch((error) => {
-      console.error(`Error calling phrase for ${relativePath}:`, error);
-      throw Error;
-    });
-}
-
-export async function pullAllTranslations(
-  branch: string,
-): Promise<TranslationsByLanguage> {
-  const phraseResult = await callPhrase<
-    Array<{
-      key: { name: string };
-      locale: { code: string };
-      content: string;
-    }>
-  >(`translations?branch=${branch}&per_page=100`);
-  const translations: TranslationsByLanguage = {};
-  for (const r of phraseResult) {
-    if (!translations[r.locale.code]) {
-      translations[r.locale.code] = {};
-    }
-    translations[r.locale.code][r.key.name] = { message: r.content };
-  }
-  return translations;
-}
-
-export async function pushTranslationsByLocale(
-  contents: TranslationsByKey,
-  locale: string,
-  branch: string,
-) {
-  const formData = new FormData();
-  const fileContents = Buffer.from(JSON.stringify(contents));
-  formData.append('file', fileContents, {
-    contentType: 'application/json',
-    filename: `${locale}.json`,
-  });
-
-  formData.append('file_format', 'json');
-  formData.append('locale_id', locale);
-  formData.append('branch', branch);
-  formData.append('update_translations', 'true');
-
-  trace('Starting to upload:', locale);
-
-  const { id } = await callPhrase<{ id: string }>(`uploads`, {
-    method: 'POST',
-    body: formData,
-  });
-  log('Upload ID:', id, '\n');
-  log('Successfully Uploaded:', locale, '\n');
-
-  return { uploadId: id };
-}
-
-export async function deleteUnusedKeys(
-  uploadId: string,
-  locale: string,
-  branch: string,
-) {
-  const query = `unmentioned_in_upload:${uploadId}`;
-  const result = await callPhrase<{ records_affected: number }>('keys', {
-    method: 'DELETE',
-    headers: {
-      'Content-Type': 'application/json',
-    },
-    body: JSON.stringify({ branch, locale_id: locale, q: query }),
-  });
-  log(
-    'Successfully deleted',
-    result.records_affected,
-    'unused keys from branch',
-    branch,
-  );
-}
-
-export async function ensureBranch(branch: string) {
-  await callPhrase(`branches`, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-    },
-    body: JSON.stringify({ name: branch }),
-  });
-  trace('Created branch:', branch);
-}

package/src/pull-translations.test.ts

@@ -1,169 +0,0 @@
-import path from 'path';
-import { pull } from './pull-translations';
-import { pullAllTranslations } from './phrase-api';
-import { writeFile } from './file';
-import { GeneratedLanguageTarget, LanguageTarget } from '@vocab/types';
-
-jest.mock('./file', () => ({
-  writeFile: jest.fn(() => Promise.resolve),
-  mkdir: jest.fn(() => Promise.resolve),
-}));
-
-jest.mock('./phrase-api', () => ({
-  ensureBranch: jest.fn(() => Promise.resolve()),
-  pullAllTranslations: jest.fn(() => Promise.resolve({ en: {}, fr: {} })),
-}));
-
-function runPhrase(options: {
-  languages: LanguageTarget[];
-  generatedLanguages: GeneratedLanguageTarget[];
-}) {
-  return pull(
-    { branch: 'tester' },
-    {
-      ...options,
-      devLanguage: 'en',
-      projectRoot: path.resolve(__dirname, '..', '..', '..', 'fixtures/phrase'),
-    },
-  );
-}
-
-describe('pull translations', () => {
-  describe('when pulling translations for languages that already have translations', () => {
-    beforeEach(() => {
-      (pullAllTranslations as jest.Mock).mockClear();
-      (writeFile as jest.Mock).mockClear();
-    });
-    (pullAllTranslations as jest.Mock).mockImplementation(() =>
-      Promise.resolve({
-        en: {
-          'hello.mytranslations': {
-            message: 'Hi there',
-          },
-        },
-        fr: {
-          'hello.mytranslations': {
-            message: 'merci',
-          },
-        },
-      }),
-    );
-
-    const options = {
-      languages: [{ name: 'en' }, { name: 'fr' }],
-      generatedLanguages: [
-        {
-          name: 'generatedLanguage',
-          extends: 'en',
-          generator: {
-            transformMessage: (message: string) => `[${message}]`,
-          },
-        },
-      ],
-    };
-
-    it('should resolve', async () => {
-      await expect(runPhrase(options)).resolves.toBeUndefined();
-
-      expect(writeFile as jest.Mock).toHaveBeenCalledTimes(2);
-    });
-
-    it('should update keys', async () => {
-      await expect(runPhrase(options)).resolves.toBeUndefined();
-
-      expect(
-        (writeFile as jest.Mock).mock.calls.map(
-          ([_filePath, contents]: [string, string]) => JSON.parse(contents),
-        ),
-      ).toMatchInlineSnapshot(`
-      Array [
-        Object {
-          "hello": Object {
-            "message": "Hi there",
-          },
-          "world": Object {
-            "message": "world",
-          },
-        },
-        Object {
-          "hello": Object {
-            "message": "merci",
-          },
-          "world": Object {
-            "message": "monde",
-          },
-        },
-      ]
-    `);
-    });
-  });
-
-  describe('when pulling translations and some languages do not have any translations', () => {
-    beforeEach(() => {
-      (pullAllTranslations as jest.Mock).mockClear();
-      (writeFile as jest.Mock).mockClear();
-    });
-    (pullAllTranslations as jest.Mock).mockImplementation(() =>
-      Promise.resolve({
-        en: {
-          'hello.mytranslations': {
-            message: 'Hi there',
-          },
-        },
-        fr: {
-          'hello.mytranslations': {
-            message: 'merci',
-          },
-        },
-      }),
-    );
-
-    const options = {
-      languages: [{ name: 'en' }, { name: 'fr' }, { name: 'ja' }],
-      generatedLanguages: [
-        {
-          name: 'generatedLanguage',
-          extends: 'en',
-          generator: {
-            transformMessage: (message: string) => `[${message}]`,
-          },
-        },
-      ],
-    };
-
-    it('should resolve', async () => {
-      await expect(runPhrase(options)).resolves.toBeUndefined();
-
-      expect(writeFile as jest.Mock).toHaveBeenCalledTimes(2);
-    });
-
-    it('should update keys', async () => {
-      await expect(runPhrase(options)).resolves.toBeUndefined();
-
-      expect(
-        (writeFile as jest.Mock).mock.calls.map(
-          ([_filePath, contents]: [string, string]) => JSON.parse(contents),
-        ),
-      ).toMatchInlineSnapshot(`
-      Array [
-        Object {
-          "hello": Object {
-            "message": "Hi there",
-          },
-          "world": Object {
-            "message": "world",
-          },
-        },
-        Object {
-          "hello": Object {
-            "message": "merci",
-          },
-          "world": Object {
-            "message": "monde",
-          },
-        },
-      ]
-    `);
-    });
-  });
-});

package/src/pull-translations.ts

@@ -1,103 +0,0 @@
-import { writeFile, mkdir } from './file';
-import path from 'path';
-
-import {
-  loadAllTranslations,
-  getAltLanguageFilePath,
-  getAltLanguages,
-  getUniqueKey,
-} from '@vocab/core';
-import type { UserConfig } from '@vocab/types';
-
-import { pullAllTranslations, ensureBranch } from './phrase-api';
-import { trace } from './logger';
-
-interface PullOptions {
-  branch?: string;
-  deleteUnusedKeys?: boolean;
-}
-
-export async function pull(
-  { branch = 'local-development' }: PullOptions,
-  config: UserConfig,
-) {
-  trace(`Pulling translations from branch ${branch}`);
-  await ensureBranch(branch);
-  const alternativeLanguages = getAltLanguages(config);
-  const allPhraseTranslations = await pullAllTranslations(branch);
-  trace(
-    `Pulling translations from Phrase for languages ${
-      config.devLanguage
-    } and ${alternativeLanguages.join(', ')}`,
-  );
-
-  const allVocabTranslations = await loadAllTranslations(
-    { fallbacks: 'none', includeNodeModules: false },
-    config,
-  );
-
-  for (const loadedTranslation of allVocabTranslations) {
-    const devTranslations = loadedTranslation.languages[config.devLanguage];
-
-    if (!devTranslations) {
-      throw new Error('No dev language translations loaded');
-    }
-
-    const defaultValues = { ...devTranslations };
-    const localKeys = Object.keys(defaultValues);
-
-    for (const key of localKeys) {
-      defaultValues[key] = {
-        ...defaultValues[key],
-        ...allPhraseTranslations[config.devLanguage][
-          getUniqueKey(key, loadedTranslation.namespace)
-        ],
-      };
-    }
-    await writeFile(
-      loadedTranslation.filePath,
-      `${JSON.stringify(defaultValues, null, 2)}\n`,
-    );
-
-    for (const alternativeLanguage of alternativeLanguages) {
-      if (alternativeLanguage in allPhraseTranslations) {
-        const altTranslations = {
-          ...loadedTranslation.languages[alternativeLanguage],
-        };
-        const phraseAltTranslations =
-          allPhraseTranslations[alternativeLanguage];
-
-        for (const key of localKeys) {
-          const phraseKey = getUniqueKey(key, loadedTranslation.namespace);
-          const phraseTranslationMessage =
-            phraseAltTranslations[phraseKey]?.message;
-
-          if (!phraseTranslationMessage) {
-            trace(
-              `Missing translation. No translation for key ${key} in phrase as ${phraseKey} in language ${alternativeLanguage}.`,
-            );
-            continue;
-          }
-
-          altTranslations[key] = {
-            ...altTranslations[key],
-            message: phraseTranslationMessage,
-          };
-        }
-
-        const altTranslationFilePath = getAltLanguageFilePath(
-          loadedTranslation.filePath,
-          alternativeLanguage,
-        );
-
-        await mkdir(path.dirname(altTranslationFilePath), {
-          recursive: true,
-        });
-        await writeFile(
-          altTranslationFilePath,
-          `${JSON.stringify(altTranslations, null, 2)}\n`,
-        );
-      }
-    }
-  }
-}

package/src/push-translations.test.ts

@@ -1,150 +0,0 @@
-import path from 'path';
-import { push } from './push-translations';
-import { pushTranslationsByLocale, deleteUnusedKeys } from './phrase-api';
-import { writeFile } from './file';
-
-jest.mock('./file', () => ({
-  writeFile: jest.fn(() => Promise.resolve),
-  mkdir: jest.fn(() => Promise.resolve),
-}));
-
-jest.mock('./phrase-api', () => ({
-  ensureBranch: jest.fn(() => Promise.resolve()),
-  pushTranslationsByLocale: jest.fn(() => Promise.resolve({ en: {}, fr: {} })),
-  deleteUnusedKeys: jest.fn(() => Promise.resolve()),
-}));
-
-const uploadId = '1234';
-
-function runPhrase(config: { deleteUnusedKeys: boolean }) {
-  return push(
-    { branch: 'tester', deleteUnusedKeys: config.deleteUnusedKeys },
-    {
-      devLanguage: 'en',
-      languages: [{ name: 'en' }, { name: 'fr' }],
-      generatedLanguages: [
-        {
-          name: 'generatedLanguage',
-          extends: 'en',
-          generator: {
-            transformMessage: (message: string) => `[${message}]`,
-          },
-        },
-      ],
-      projectRoot: path.resolve(__dirname, '..', '..', '..', 'fixtures/phrase'),
-    },
-  );
-}
-
-describe('push', () => {
-  describe('when deleteUnusedKeys is false', () => {
-    const config = { deleteUnusedKeys: false };
-
-    beforeEach(() => {
-      (pushTranslationsByLocale as jest.Mock).mockClear();
-      (writeFile as jest.Mock).mockClear();
-      (deleteUnusedKeys as jest.Mock).mockClear();
-
-      (pushTranslationsByLocale as jest.Mock).mockImplementation(() =>
-        Promise.resolve({ uploadId }),
-      );
-    });
-
-    it('should resolve', async () => {
-      await expect(runPhrase(config)).resolves.toBeUndefined();
-
-      expect(pushTranslationsByLocale as jest.Mock).toHaveBeenCalledTimes(2);
-    });
-
-    it('should update keys', async () => {
-      await expect(runPhrase(config)).resolves.toBeUndefined();
-
-      expect(pushTranslationsByLocale as jest.Mock).toHaveBeenCalledWith(
-        {
-          'hello.mytranslations': {
-            message: 'Hello',
-          },
-          'world.mytranslations': {
-            message: 'world',
-          },
-        },
-        'en',
-        'tester',
-      );
-
-      expect(pushTranslationsByLocale as jest.Mock).toHaveBeenCalledWith(
-        {
-          'hello.mytranslations': {
-            message: 'Bonjour',
-          },
-          'world.mytranslations': {
-            message: 'monde',
-          },
-        },
-        'fr',
-        'tester',
-      );
-    });
-
-    it('should not delete unused keys', () => {
-      expect(deleteUnusedKeys).not.toHaveBeenCalled();
-    });
-  });
-
-  describe('when deleteUnusedKeys is true', () => {
-    const config = { deleteUnusedKeys: true };
-
-    beforeEach(() => {
-      (pushTranslationsByLocale as jest.Mock).mockClear();
-      (writeFile as jest.Mock).mockClear();
-      (deleteUnusedKeys as jest.Mock).mockClear();
-
-      (pushTranslationsByLocale as jest.Mock).mockImplementation(() =>
-        Promise.resolve({ uploadId }),
-      );
-    });
-
-    it('should resolve', async () => {
-      await expect(runPhrase(config)).resolves.toBeUndefined();
-
-      expect(pushTranslationsByLocale as jest.Mock).toHaveBeenCalledTimes(2);
-    });
-
-    it('should update keys', async () => {
-      await expect(runPhrase(config)).resolves.toBeUndefined();
-
-      expect(pushTranslationsByLocale as jest.Mock).toHaveBeenCalledWith(
-        {
-          'hello.mytranslations': {
-            message: 'Hello',
-          },
-          'world.mytranslations': {
-            message: 'world',
-          },
-        },
-        'en',
-        'tester',
-      );
-
-      expect(pushTranslationsByLocale as jest.Mock).toHaveBeenCalledWith(
-        {
-          'hello.mytranslations': {
-            message: 'Bonjour',
-          },
-          'world.mytranslations': {
-            message: 'monde',
-          },
-        },
-        'fr',
-        'tester',
-      );
-    });
-
-    it('should delete unused keys', async () => {
-      await expect(runPhrase(config)).resolves.toBeUndefined();
-
-      expect(deleteUnusedKeys).toHaveBeenCalledWith(uploadId, 'en', 'tester');
-      expect(deleteUnusedKeys).toHaveBeenCalledWith(uploadId, 'fr', 'tester');
-    });
-  });
-});

package/src/push-translations.ts

@@ -1,67 +0,0 @@
-import { TranslationsByLanguage } from './../../types/src/index';
-
-import {
-  ensureBranch,
-  pushTranslationsByLocale,
-  deleteUnusedKeys as phraseDeleteUnusedKeys,
-} from './phrase-api';
-import { trace } from './logger';
-import { loadAllTranslations, getUniqueKey } from '@vocab/core';
-import { UserConfig } from '@vocab/types';
-
-interface PushOptions {
-  branch: string;
-  deleteUnusedKeys?: boolean;
-}
-
-/**
- * Uploading to the Phrase API for each language. Adding a unique namespace to each key using file path they key came from
- */
-export async function push(
-  { branch, deleteUnusedKeys }: PushOptions,
-  config: UserConfig,
-) {
-  const allLanguageTranslations = await loadAllTranslations(
-    { fallbacks: 'none', includeNodeModules: false },
-    config,
-  );
-  trace(`Pushing translations to branch ${branch}`);
-  const allLanguages = config.languages.map((v) => v.name);
-  await ensureBranch(branch);
-
-  trace(
-    `Pushing translations to phrase for languages ${allLanguages.join(', ')}`,
-  );
-
-  const phraseTranslations: TranslationsByLanguage = {};
-
-  for (const loadedTranslation of allLanguageTranslations) {
-    for (const language of allLanguages) {
-      const localTranslations = loadedTranslation.languages[language];
-      if (!localTranslations) {
-        continue;
-      }
-      if (!phraseTranslations[language]) {
-        phraseTranslations[language] = {};
-      }
-      for (const localKey of Object.keys(localTranslations)) {
-        const phraseKey = getUniqueKey(localKey, loadedTranslation.namespace);
-        phraseTranslations[language][phraseKey] = localTranslations[localKey];
-      }
-    }
-  }
-
-  for (const language of allLanguages) {
-    if (phraseTranslations[language]) {
-      const { uploadId } = await pushTranslationsByLocale(
-        phraseTranslations[language],
-        language,
-        branch,
-      );
-
-      if (deleteUnusedKeys) {
-        await phraseDeleteUnusedKeys(uploadId, language, branch);
-      }
-    }
-  }
-}