signal-desktop/ts/scripts/remove-strings.ts

// Copyright 2023 Signal Messenger, LLC
// SPDX-License-Identifier: AGPL-3.0-only

import chalk from 'chalk';
import execa from 'execa';
import fs from 'node:fs/promises';
import pLimit from 'p-limit';
import path from 'node:path';

import { MONTH } from '../util/durations/index.js';
import { isOlderThan } from '../util/timestamp.js';
import { DELETED_REGEXP } from './constants.js';

const ROOT_DIR = path.join(__dirname, '..', '..');
const MESSAGES_FILE = path.join(ROOT_DIR, '_locales', 'en', 'messages.json');

const limitter = pLimit(10);

async function main() {
  const messages = JSON.parse(await fs.readFile(MESSAGES_FILE, 'utf-8'));

  const stillUsed = new Set<string>();

  await Promise.all(
    Object.keys(messages).map(key =>
      limitter(async () => {
        const value = messages[key];

        const match = (value as Record<string, string>).description?.match(
          DELETED_REGEXP
        );
        if (!match) {
          return;
        }

        const deletedAt = new Date(match[1]).getTime();
        if (!isOlderThan(deletedAt, MONTH)) {
          return;
        }

        // Find uses in either:
        // - `i18n('key')`
        // - `<I18n id="key"/>`

        try {
          const result = await execa(
            'git',
            // prettier-ignore
            [
              'grep',
              '--extended-regexp',
              `'${key}'|id="${key}"`,
              '--',
              '**',
              ':!\\_locales/**',
              ':!\\sticker-creator/**',
            ],
            {
              cwd: ROOT_DIR,
              stdin: 'ignore',
              stdout: 'pipe',
              stderr: 'inherit',
            }
          );

          // Match found
          console.error(
            chalk.red(
              `ERROR: String is still used: "${key}", deleted on ${match[1]}`
            )
          );
          console.error(result.stdout.trim());
          console.error('');
          stillUsed.add(key);
        } catch (error) {
          if (error.exitCode === 1) {
            console.log(
              chalk.dim(`Removing string: "${key}", deleted on ${match[1]}`)
            );
            delete messages[key];
          } else {
            throw error;
          }
        }
      })
    )
  );

  if (stillUsed.size !== 0) {
    console.error(
      `ERROR: Didn't remove ${stillUsed.size} strings because of errors above`,
      Array.from(stillUsed)
        .map(str => `- ${str}`)
        .join('\n')
    );
    console.error('ERROR: Not saving changes');
    process.exit(1);
  }
  await fs.writeFile(MESSAGES_FILE, `${JSON.stringify(messages, null, 2)}\n`);
}

main().catch(err => {
  console.error(err);
  process.exit(1);
});