@vocab/phrase 1.1.0 → 1.2.0

package/src/pull-translations.test.ts

@@ -1,214 +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: {} })),
-}));
-
-const devLanguage = 'en';
-
-function runPhrase(options: {
-  languages: LanguageTarget[];
-  generatedLanguages: GeneratedLanguageTarget[];
-}) {
-  return pull(
-    { branch: 'tester' },
-    {
-      ...options,
-      devLanguage,
-      projectRoot: path.resolve(__dirname, '..', '..', '..', 'fixtures/phrase'),
-    },
-  );
-}
-
-describe('pull translations', () => {
-  describe('when pulling translations for languages that already have translations', () => {
-    beforeEach(() => {
-      jest.mocked(pullAllTranslations).mockClear();
-      jest.mocked(writeFile).mockClear();
-      jest.mocked(pullAllTranslations).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(jest.mocked(writeFile)).toHaveBeenCalledTimes(2);
-    });
-
-    it('should update keys', async () => {
-      await expect(runPhrase(options)).resolves.toBeUndefined();
-
-      expect(
-        jest
-          .mocked(writeFile)
-          .mock.calls.map(([_filePath, contents]) =>
-            JSON.parse(contents as string),
-          ),
-      ).toMatchInlineSnapshot(`
-        [
-          {
-            "hello": {
-              "message": "Hi there",
-            },
-            "world": {
-              "message": "world",
-            },
-          },
-          {
-            "hello": {
-              "message": "merci",
-            },
-            "world": {
-              "message": "monde",
-            },
-          },
-        ]
-      `);
-    });
-  });
-
-  describe('when pulling translations and some languages do not have any translations', () => {
-    beforeEach(() => {
-      jest.mocked(pullAllTranslations).mockClear();
-      jest.mocked(writeFile).mockClear();
-      jest.mocked(pullAllTranslations).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(jest.mocked(writeFile)).toHaveBeenCalledTimes(2);
-    });
-
-    it('should update keys', async () => {
-      await expect(runPhrase(options)).resolves.toBeUndefined();
-
-      expect(
-        jest
-          .mocked(writeFile)
-          .mock.calls.map(([_filePath, contents]) =>
-            JSON.parse(contents as string),
-          ),
-      ).toMatchInlineSnapshot(`
-        [
-          {
-            "hello": {
-              "message": "Hi there",
-            },
-            "world": {
-              "message": "world",
-            },
-          },
-          {
-            "hello": {
-              "message": "merci",
-            },
-            "world": {
-              "message": "monde",
-            },
-          },
-        ]
-      `);
-    });
-  });
-
-  describe('when pulling translations and the project has not configured translations for the dev language', () => {
-    beforeEach(() => {
-      jest.mocked(pullAllTranslations).mockClear();
-      jest.mocked(writeFile).mockClear();
-      jest.mocked(pullAllTranslations).mockImplementation(() =>
-        Promise.resolve({
-          fr: {
-            'hello.mytranslations': {
-              message: 'merci',
-            },
-          },
-        }),
-      );
-    });
-
-    const options = {
-      languages: [{ name: 'en' }, { name: 'fr' }],
-      generatedLanguages: [
-        {
-          name: 'generatedLanguage',
-          extends: 'en',
-          generator: {
-            transformMessage: (message: string) => `[${message}]`,
-          },
-        },
-      ],
-    };
-
-    it('should throw an error', async () => {
-      await expect(runPhrase(options)).rejects.toThrow(
-        new Error(
-          `Phrase did not return any translations for the configured development language "en".\nPlease ensure this language is present in your Phrase project's configuration.`,
-        ),
-      );
-
-      expect(jest.mocked(writeFile)).toHaveBeenCalledTimes(0);
-    });
-  });
-});

package/src/pull-translations.ts

@@ -1,114 +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 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 },
-    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,168 +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(() => {
-      jest.mocked(pushTranslationsByLocale).mockClear();
-      jest.mocked(writeFile).mockClear();
-      jest.mocked(deleteUnusedKeys).mockClear();
-
-      jest
-        .mocked(pushTranslationsByLocale)
-        .mockImplementation(() => Promise.resolve({ uploadId }));
-    });
-
-    it('should resolve', async () => {
-      await expect(runPhrase(config)).resolves.toBeUndefined();
-
-      expect(jest.mocked(pushTranslationsByLocale)).toHaveBeenCalledTimes(2);
-    });
-
-    it('should update keys', async () => {
-      await expect(runPhrase(config)).resolves.toBeUndefined();
-
-      expect(jest.mocked(pushTranslationsByLocale)).toHaveBeenCalledWith(
-        {
-          'hello.mytranslations': {
-            message: 'Hello',
-          },
-          'world.mytranslations': {
-            message: 'world',
-          },
-        },
-        'en',
-        'tester',
-      );
-
-      expect(jest.mocked(pushTranslationsByLocale)).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(() => {
-      jest.mocked(pushTranslationsByLocale).mockClear();
-      jest.mocked(writeFile).mockClear();
-      jest.mocked(deleteUnusedKeys).mockClear();
-    });
-
-    describe('and the upload succeeds', () => {
-      beforeEach(() => {
-        jest
-          .mocked(pushTranslationsByLocale)
-          .mockImplementation(() => Promise.resolve({ uploadId }));
-      });
-
-      it('should resolve', async () => {
-        await expect(runPhrase(config)).resolves.toBeUndefined();
-
-        expect(jest.mocked(pushTranslationsByLocale)).toHaveBeenCalledTimes(2);
-      });
-
-      it('should update keys', async () => {
-        await expect(runPhrase(config)).resolves.toBeUndefined();
-
-        expect(jest.mocked(pushTranslationsByLocale)).toHaveBeenCalledWith(
-          {
-            'hello.mytranslations': {
-              message: 'Hello',
-            },
-            'world.mytranslations': {
-              message: 'world',
-            },
-          },
-          'en',
-          'tester',
-        );
-
-        expect(jest.mocked(pushTranslationsByLocale)).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');
-      });
-    });
-
-    describe('and the upload fails', () => {
-      beforeEach(() => {
-        jest
-          .mocked(pushTranslationsByLocale)
-          .mockImplementation(() => Promise.reject('Upload failed'));
-      });
-
-      it('should not delete unused keys', async () => {
-        await expect(runPhrase(config)).rejects.toBe('Upload failed');
-
-        expect(deleteUnusedKeys).not.toHaveBeenCalled();
-      });
-    });
-  });
-});

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);
-      }
-    }
-  }
-}